1.0.10

* Call setOutputType with the right arguments

docs/SUMMARY.md

@@ -5,6 +5,7 @@
 * [Troubleshoot](/troubleshoot)
 * [EV3 Manager](https://ev3manager.education.lego.com/)
 * [LEGO Support](https://www.lego.com/service/)
+* [FIRST LEGO League](/fll)
 
 ## Projects #projects
 

docs/fll.md

@@ -0,0 +1,112 @@
+# MakeCode for _FIRST_ LEGO League
+
+![FIRST LEGO League logo](/static/fll/fll-logo.png)
+
+For teams participating in the Open Software Platform Pilot utilizing MakeCode, we’ve compiled a list of resources and information that we hope will be helpful for you.
+
+## FAQ
+
+### How do I use MakeCode with my EV3?
+
+* You will need to install the latest EV3 firmware on your brick. Instructions on how to do that are located here: https://makecode.mindstorms.com/troubleshoot.
+* You will need a computer with a USB port to connect to the EV3 in order to download your programs.
+* You will need internet access and a browser on your computer to get to https://makecode.mindstorms.com.
+
+### What’s the best way to get started with MakeCode?
+
+Watch some of the videos at https://makecode.mindstorms.com (at the bottom of the page).
+Try some of the provided tutorials:
+
+* [Wake Up!](@homeurl@#tutorial:tutorials/wake-up) – show your EV3 brick waking up
+* [Animation](@homeurl@#tutorial:tutorials/make-an-animation) – create a custom animation to show
+* [Music Brick](@homeurl@#tutorial:tutorials/music-brick) – transform your EV3 into a musical instrument
+* [Run Motors](@homeurl@#tutorial:tutorials/run-motors) – control the motors of your robot
+* [Red Light, Green Light](@homeurl@#tutorial:tutorials/redlight-greenlight) – play red light, green light with the color sensor
+* [Line Following](@homeurl@#tutorial:tutorials/line-following) – have your robot follow a line
+
+### Can I load both LEGO MINDSTORMS EV3 Software and MakeCode programs onto my EV3?
+
+Yes.
+
+### How do I figure out what a block does?
+
+You can right-click on any block and select “Help” in the context menu to open the documentation page describing what that block does.
+
+![Select help in context menu for block](/static/fll/context-help.jpg)
+
+### How do I program in JavaScript?
+
+Click the **JavaScript** button at the top of the page to get to the JavaScript editor. Students can drag and drop code snippets from the Toolbox on the left, or type directly in the editor. You can switch back and forth between **Blocks** and **JavaScript** as you program.
+
+![Coding in JavaScript](/static/fll/code-js.gif)
+
+Also, watch the [Text-based Coding](https://legoeducation.videomarketingplatform.co/v.ihtml/player.html?token=3513a83b87fe536b2dc512237465fd1b&source=embed&photo%5fid=35719471) video for more about coding using the JavaScript editor.
+
+### How do I use the Simulator?
+
+The Simulator will show the physical representation of your code blocks. For example, based on this code snippet, the Simulator will show the touch sensor on Port 1, and a large motor on Port D.
+
+```blocks
+sensors.touch1.onEvent(ButtonEvent.Pressed, function () {
+    motors.largeD.run(50)
+})
+```
+
+![Simulator demonstration](/static/fll/simulator.gif)
+
+Note that the Simulator is also interactive, so you can simulate inputs with any of the sensors.
+
+See the video [Block-based Coding and Simulation](https://legoeducation.videomarketingplatform.co/v.ihtml/player.html?token=629730c938e452f0fd7653fbc4708166&source=embed&photo%5fid=35719470) for more about using the simulator.
+
+### How do I save my programs?
+
+MakeCode will automatically save your recent projects in the browser. However, you can also save a copy of your project as a file on your computer:
+
+* From the **Settings** menu, select **Save Project**
+* This will download your program from the browser as a _lego-myproject.uf2_ file
+
+![Save project menu selection](/static/fll/save-project.jpg)
+
+* You can import your saved projects by clicking the Import button on the Home Page
+ 
+![Import button on home screen](/static/fll/import-button.jpg)
+
+### How do I share my programs?
+
+You can share your projects by clicking on the **share** button in the top left of the screen.  This will create a URL which you can send others to open and view your project.
+ 
+![Share button in editor](/static/fll/share-button.jpg)
+
+![Share button and dialogs demo](/static/fll/share-program.gif)
+
+Sharing programs is also shown in the [Tips and Tricks](https://legoeducation.videomarketingplatform.co/v.ihtml/player.html?token=5c594c2373367f7870196f519f3bfc7a&source=embed&photo%5fid=35719472) video.
+
+### Why can't I delete my program (*.uf2) files from the Brick?
+
+There's a bug in the firmware which prevents you from deleting the programs (``*.uf2`` files) from your EV3 Brick. There isn't a firmware update to fix this yet. As a workaround, you can temporarily downgrade your firmware version, delete the files, and then upgrade back to the version that works with MakeCode.
+
+Follow these steps to downgrade your firmware version, delete the files, and uprgade back again:
+
+1. Go into **EV3 LabVIEW** - if it's not installed get it [here](https://education.lego.com/en-us/downloads/mindstorms-ev3/software)
+2. Plug in your EV3 Brick and start a new project
+3. Go to the **Tools** menu in the upper right corner, select **Firmware Update**
+4. In the **Firmware Update** dialog box, click on the **Show Details** button
+5. From the **Available Firmware Files** list, select **EV3 Firmware V1.09E**
+6. Click the **Update Firmware** button and wait for the update to complete
+
+Now the firmware version on the EV3 Brick will be **V1.09E**. Also, in the process, the downgrade deleted all of the saved programs from the EV3 Brick. To continue to use MakeCode, the firmware version must be at **V1.10E** or above. So, the Brick firmware needs to be upgraded again. If you don't know or do remember how to do this, see the **Upgrade your @drivename@** section in the [troubleshooting](/troubleshoot) page.
+
+For other common questions, try the FAQ page https://makecode.mindstorms.com/faq.
+
+## Workarounds
+
+1. Deleting Programs from the EV3 brick
+
+>* Description: Unable to delete program files from the EV3 brick after downloading them
+>* Status: LEGO Education team is working on a fix, no estimated date yet
+
+## Community connection
+
+For questions, issues, feedback and community for the Open Software Platform Pilot:
+
+We are using a messaging service called **Slack**. Slack can be accessed via an app you download to your computer or mobile device, and via a web interface. For more information about Slack, click [here](https://slack.com/). Anyone in the pilot can participate by signing up with Slack first, and then clicking this [FIRST LEGO League Robot SW](https://fllrobotsw.slack.com/join/shared_invite/enQtNDgxOTQ5MDc2OTkyLTg2ZTRkYzQ4OGMyZTg1OTZmMDFhMWNlOTQ1OWRlNDdmNzNmMjlhMmZiM2M3OWUxYjU1ODEwY2FmODJkNjZkOTA) link to join the Slack workspace.

docs/getting-started.md

@@ -7,7 +7,7 @@
 {
     "name": "Prepare",
     "imageUrl": "/static/lessons/firmware.png",
-    "description": "To use Microsoft MakeCode with your EV3 Brick, you will need to install the latest LEGO® MINDSTORMS® Education EV3 firmware. Follow these steps to make sure you're up to date and install the latest firmware if you need to.",
+    "description": "To use Microsoft MakeCode with your EV3 Brick, you will need to install the latest LEGO® MINDSTORMS® Education EV3 firmware.",
     "label": "New? Start Here!",
     "labelClass": "red ribbon large",
     "url": "https://makecode.mindstorms.com/troubleshoot"

docs/index-ref.json

@@ -1,3 +1,3 @@
 {
-    "appref": "v0.4.2"
+    "appref": "v1.0.8"
 }

docs/offline-app.html

@@ -388,12 +388,12 @@
         }
         function downloadWin64() {
             // TODO: Keep this link up-to-date with the desired release version
-            window.open("https://makecode.com/api/release/ev3/v0.4.2/win64");
+            window.open("https://makecode.com/api/release/ev3/v1.0.8/win64");
             tickEvent("offlineapp.download", { "target": "ev3", "platform": "win64" });
         }
         function downloadMac64() {
             // TODO: Keep this link up-to-date with the desired release version
-            window.open("https://makecode.com/api/release/ev3/v0.4.2/mac64");
+            window.open("https://makecode.com/api/release/ev3/v1.0.8/mac64");
             tickEvent("offlineapp.download", { "target": "ev3", "platform": "mac64" });
         }
     </script>
@@ -461,25 +461,19 @@
                     <p class="c2">
                         <span class="c5 c1">3.</span>
                         <span class="c1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>
-                        <span class="c5 c1">Associated Online Services.</span>
-                        <span class="c1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Some features of the software may provide access
-                            to, or rely on, Azure online services, including an associated Azure online service to the software
-                            currently in development (the &ldquo;corresponding service&rdquo;). The use of those services
-                            (but not the software) is governed by the separate terms and privacy policies in the agreement
-                            under which you obtained the Azure services at</span>
-                        <span class="c1">
-                            <a class="c9" href="https://www.google.com/url?q=https://go.microsoft.com/fwLink/p/?LinkID%3D233178&amp;sa=D&amp;ust=1529596153826000">&nbsp;</a>
+                        <span class="c5 c1">ASSOCIATED ONLINE SERVICES.</span>
+                        <span class="c1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Some features of the software provide access 
+                            to, or rely on, online services to provide you information about updates to the software or extensions, 
+                            or to enable you to retrieve content, collaborate with others, or otherwise supplement your development 
+                            experience.  As used throughout these license terms, the term <q>software</q> includes these online 
+                            services and features. By using these online services and features you consent to the to the 
+                            transmission of information as described in Section 5, DATA.
                         </span>
-                        <span class="c1 c18">
-                            <a class="c9" href="https://www.google.com/url?q=https://go.microsoft.com/fwLink/p/?LinkID%3D233178&amp;sa=D&amp;ust=1529596153826000">https://go.microsoft.com/fwLink/p/?LinkID=233178</a>
-                        </span>
-                        <span class="c3 c1">&nbsp;(and, with respect to the corresponding service, the additional terms below). Please read them.
-                            The services may not be available in all regions.</span>
                     </p>
                     <p class="c2">
                         <span class="c5 c1">4.</span>
                         <span class="c1">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span>
-                        <span class="c5 c1">Licenses for other components.</span>
+                        <span class="c5 c1">LICENSES FOR OTHER COMPONENTS.</span>
                         <span class="c3 c1">&nbsp;The software may include third party components with separate legal notices or governed by
                             other agreements, as described in the ThirdPartyNotices file accompanying the software. Even
                             if such components are governed by other agreements, the disclaimers and the limitations on and
@@ -500,7 +494,7 @@
                             In using the software, you must comply with applicable law. You can learn more about data collection
                             and use in the help documentation and the privacy statement at </span>
                         <span class="c14 c1">
-                            <a class="c9" href="https://www.google.com/url?q=http://go.microsoft.com/fwlink/?LinkId%3D398505&amp;sa=D&amp;ust=1529596153827000">http://go.microsoft.com/fwlink/?LinkId=398505</a>
+                            <a class="c9" href="http://go.microsoft.com/fwlink/?LinkId=398505">http://go.microsoft.com/fwlink/?LinkId=398505</a>
                         </span>
                         <span class="c1">.</span>
                         <span class="c3 c1">&nbsp;Your use of the software operates as your consent to these practices.</span>
@@ -513,7 +507,7 @@
                             Microsoft makes the commitments in the European Union General Data Protection Regulation Terms
                             of the Online Services Terms to all customers effective May 25, 2018, at </span>
                         <span class="c1 c14">
-                            <a class="c9" href="https://www.google.com/url?q=http://go.microsoft.com/?linkid%3D9840733&amp;sa=D&amp;ust=1529596153828000">http://go.microsoft.com/?linkid=9840733</a>
+                            <a class="c9" href="http://go.microsoft.com/?linkid=9840733">http://go.microsoft.com/?linkid=9840733</a>
                         </span>
                         <span class="c3 c1">.</span>
                     </p>
@@ -794,4 +788,4 @@
 
 </body>
 
-</html>
+</html>

docs/videos.md

@@ -0,0 +1,33 @@
+# Videos
+
+## Tutorials
+
+```codecard
+[
+    {
+        "name": "",
+        "url": "https://legoeducation.videomarketingplatform.co/v.ihtml/player.html?token=5d009e5f93fbf479c2e5ed2bf87a7990&source=embed&photo%5fid=35719444",
+        "imageUrl": "https://legoeducation.videomarketingplatform.co/27288170/35719444/5d009e5f93fbf479c2e5ed2bf87a7990/thumbnail.png"
+    },
+    {
+        "name": "",
+        "url": "https://legoeducation.videomarketingplatform.co/v.ihtml/player.html?token=2008a566f1fb034d58d5ebe19ba8621f&source=embed&photo%5fid=35719467",
+        "imageUrl": "https://legoeducation.videomarketingplatform.co/27288175/35719467/2008a566f1fb034d58d5ebe19ba8621f/thumbnail.png"
+    },
+    {
+        "name": "",
+        "url": "https://legoeducation.videomarketingplatform.co/v.ihtml/player.html?token=629730c938e452f0fd7653fbc4708166&source=embed&photo%5fid=35719470",
+        "imageUrl": "https://legoeducation.videomarketingplatform.co/27288172/35719470/629730c938e452f0fd7653fbc4708166/thumbnail.png"
+    },
+    {
+        "name": "",
+        "url": "https://legoeducation.videomarketingplatform.co/v.ihtml/player.html?token=3513a83b87fe536b2dc512237465fd1b&source=embed&photo%5fid=35719471",
+        "imageUrl": "https://legoeducation.videomarketingplatform.co/27288172/35719471/3513a83b87fe536b2dc512237465fd1b/thumbnail.png"
+    },
+    {
+        "name": "",
+        "url": "https://legoeducation.videomarketingplatform.co/v.ihtml/player.html?token=5c594c2373367f7870196f519f3bfc7a&source=embed&photo%5fid=35719472",
+        "imageUrl": "https://legoeducation.videomarketingplatform.co/27288175/35719472/5c594c2373367f7870196f519f3bfc7a/thumbnail.png"
+    }
+]
+```

libs/color-sensor/color.ts

@@ -297,9 +297,22 @@ namespace sensors {
         calibrateLight(mode: LightIntensityMode, deviation: number = 8) {
             this.calibrating = true; // prevent events
 
-            this.light(mode); // trigger a read
-            pauseUntil(() => this.isActive()); // ensure sensor is live
+            const statusLight = brick.statusLight(); // save current status light
+            brick.setStatusLight(StatusLight.Orange);
 
+            this.light(mode); // trigger a read
+            pauseUntil(() => this.isActive(), 5000); // ensure sensor is live
+
+            // check sensor is ready
+            if (!this.isActive()) {
+                brick.setStatusLight(StatusLight.RedFlash); // didn't work
+                pause(2000);
+                brick.setStatusLight(statusLight); // restore previous light
+                return;
+            }
+
+            // calibrating
+            brick.setStatusLight(StatusLight.OrangePulse);
 
             let vold = 0;
             let vcount = 0;
@@ -331,6 +344,10 @@ namespace sensors {
             this.thresholdDetector.setLowThreshold(min);
             this.thresholdDetector.setHighThreshold(max);
 
+            brick.setStatusLight(StatusLight.Green); // success
+            pause(1000);
+            brick.setStatusLight(statusLight); // resture previous light
+
             this.calibrating = false;
         }
 

libs/color-sensor/docs/reference/sensors/color-sensor/calibrate-light.md

@@ -13,6 +13,15 @@ Sometimes when external lighting conditions change, the light sensor measures li
 * **mode**: the type of light threshold to calibrate. This is either ``ambient`` or ``reflected`` light.
 * **deviation**: a [number](/types/number) that is the amount of light level change to adjust in a measurement.
 
+## Calibration states
+
+Calibration happens in the following phases and each phase is tracked by the brick status light.
+
+* **orange**: sensor initialization. This phase ensures that the sensor is in the desired mode and ready to collect data.
+* **orange pulse**: data collection. Light information is being collected, move the sensor over the various light sources to detect.
+* **green**: calibration success. The calibration data has been saved.
+* **red flash**: sensor failure. We were unable to connect to the sensor.
+
 ## Example
 
 Calibrate the ``dark`` and ``light`` thresholds for the ``color 2`` sensor using reflected light.
@@ -23,4 +32,4 @@ sensors.color2.calibrateLight(LightIntensityMode.Reflected)
 
 ## See also
 
-[set threshold](/reference/sensors/color-sensor/set-threshold)
+[set threshold](/reference/sensors/color-sensor/set-threshold)

libs/core/buttons.ts

@@ -247,6 +247,15 @@ namespace brick {
     // the brick starts with the red color
     let currPattern: StatusLight = StatusLight.Off;
 
+    /**
+     * Gets the current light pattern.
+     */
+    //% weight=99 group="Buttons"
+    //% help=brick/status-light
+    export function statusLight() {
+        return currPattern;
+    }
+
     /**
      * Set lights.
      * @param pattern the lights pattern to use. eg: StatusLight.Orange

libs/core/output.ts

@@ -138,6 +138,8 @@ namespace motors {
         private _run: (speed: number) => void;
         private _move: (steps: boolean, stepsOrTime: number, speed: number) => void;
 
+        protected static output_types: number[] = [0x7, 0x7, 0x7, 0x7];
+
         constructor(port: Output, init: () => void, run: (speed: number) => void, move: (steps: boolean, stepsOrTime: number, speed: number) => void) {
             super();
             this._port = port;
@@ -321,20 +323,25 @@ namespace motors {
         }
 
         protected setOutputType(large: boolean) {
-            /*
-            Instruction opOutput_Set_Type (LAYER, NO, TYPE) 
-            Opcode 0xA1 Arguments (Data8) LAYER – Specify chain layer number [0 - 3]  
-            (Data8) NO – Port number [0 - 3]  
-            (Data8) TYPE – Output device type,  (0x07: Large motor, Medium motor = 0x08) Dispatch status Unchanged 
-            Description This function enables specifying the output device type
-            */
-            for (let i = 0; i < DAL.NUM_OUTPUTS; ++i) {
+           for (let i = 0; i < DAL.NUM_OUTPUTS; ++i) {
                 if (this._port & (1 << i)) {
-                    const b = mkCmd(i, DAL.opOutputSetType, 1)
-                    b.setNumber(NumberFormat.Int8LE, 2, large ? 0x07 : 0x08)
-                    writePWM(b)
+                    // (0x07: Large motor, Medium motor = 0x08)
+                    MotorBase.output_types[i] = large ? 0x07 : 0x08;
                 }
             }
+            MotorBase.setTypes();
+        }
+
+        // Note, we are having to create our own buffer here as mkCmd creates a buffer with a command
+        // In the case of opOutputSetType, it expects the arguments to be opOutputSetType [type0, type1, type2, type3]
+        static setTypes() {
+            const b = output.createBuffer(5)
+            b.setNumber(NumberFormat.UInt8LE, 0, DAL.opOutputSetType)
+            b.setNumber(NumberFormat.Int8LE, 1, MotorBase.output_types[0]);
+            b.setNumber(NumberFormat.Int8LE, 2, MotorBase.output_types[1]);
+            b.setNumber(NumberFormat.Int8LE, 3, MotorBase.output_types[2]);
+            b.setNumber(NumberFormat.Int8LE, 4, MotorBase.output_types[3]);
+            writePWM(b)
         }
     }
 
@@ -741,18 +748,6 @@ namespace motors {
         writePWM(b)
         control.dmesg('end step')
     }
-
-    const types = [0, 0, 0, 0]
-    export function setType(out: Output, type: OutputType) {
-        let b = mkCmd(out, DAL.opOutputSetType, 3)
-        for (let i = 0; i < 4; ++i) {
-            if (out & (1 << i)) {
-                types[i] = type
-            }
-            b.setNumber(NumberFormat.UInt8LE, i + 1, types[i])
-        }
-        writePWM(b)
-    }
 }
 
 

libs/gyro-sensor/docs/reference/sensors/gyro/reset.md

@@ -22,6 +22,15 @@ To properly reset the gyro, the brick must remain still (undistrurbed) while the
 
 ## ~
 
+## Calibration states
+
+Calibration happens in the following phases and each phase is tracked by the brick status light.
+
+* **orange**: sensor initialization. This phase ensures that the sensor is in the desired mode and ready to collect data.
+* **orange pulse**: data collection. Light information is being collected, move the sensor over the various light sources to detect.
+* **green**: calibration success. The calibration data has been saved.
+* **red flash**: sensor failure. We were unable to connect to the sensor.
+
 ## Example
 Set the brick on a flat surface. Reset `gyro 2` and tilt the brick slighly. Reset it again while it's still tilted. Lay the brick down flat again and display the angle measurement.
 
@@ -36,4 +45,4 @@ brick.buttonRight.onEvent(ButtonEvent.Pressed, function () {
 
 ## See also
 
-[angle](/reference/sensors/gyro/angle), [rate](/reference/sensors/gyro/rate)
+[angle](/reference/sensors/gyro/angle), [rate](/reference/sensors/gyro/rate)

libs/gyro-sensor/gyro.ts

@@ -92,6 +92,9 @@ namespace sensors {
         reset(): void {
             if (this.calibrating) return; // already in calibration mode
 
+            const statusLight = brick.statusLight(); // save current status light
+            brick.setStatusLight(StatusLight.Orange);
+
             this.calibrating = true;
             // may be triggered by a button click,
             // give time for robot to settle
@@ -101,9 +104,22 @@ namespace sensors {
             // switch back to the desired mode
             this.setMode(this.mode);
             // wait till sensor is live
-            pauseUntil(() => this.isActive());
+            pauseUntil(() => this.isActive(), 5000);
+
+            // check sensor is ready
+            if (!this.isActive()) {
+                brick.setStatusLight(StatusLight.RedFlash); // didn't work
+                pause(2000);
+                brick.setStatusLight(statusLight); // restore previous light
+                return;
+            }
+
             // give it a bit of time to init
             pause(1000)
+
+            // calibrating
+            brick.setStatusLight(StatusLight.OrangePulse);
+
             // compute drift
             this._drift = 0;
             if (this.mode == GyroSensorMode.Rate) {
@@ -113,6 +129,11 @@ namespace sensors {
                 }
                 this._drift /= 200;
             }
+
+            brick.setStatusLight(StatusLight.Green); // success
+            pause(1000);
+            brick.setStatusLight(statusLight); // resture previous light
+
             // and we're done
             this.calibrating = false;
         }

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "pxt-ev3",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "lockfileVersion": 1,
   "requires": true,
   "dependencies": {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "pxt-ev3",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "LEGO MINDSTORMS EV3 for Microsoft MakeCode",
   "private": true,
   "keywords": [

pxtarget.json

@@ -23,7 +23,6 @@
         "streams": true,
         "aspectRatio": 0.5,
         "parts": false,
-        "enableTrace": true,
         "boardDefinition": {
             "visual": "ev3"
         }
@@ -108,6 +107,7 @@
             "zh-CN"
         ],
         "highContrast": true,
+        "lightToc": true,
         "docMenu": [
             {
                 "name": "Support",
@@ -177,7 +177,8 @@
         "monacoColors": {
             "editor.background": "#f9f9f9"
         },
-        "fileNameExclusiveFilter": "[^a-zA-Z0-9]"
+        "fileNameExclusiveFilter": "[^a-zA-Z0-9]",
+        "enableTrace": true
     },
     "ignoreDocsErrors": true
 }

targetconfig.json

@@ -12,9 +12,10 @@
         "Tutorials": "tutorials",
         "Design Engineering": "design-engineering",
         "Coding": "coding",
-        "Maker": "maker"
+        "Maker": "maker",
+        "Videos": "videos"
     },
     "electronManifest": {
-        "latest": "v0.4.2"
+        "latest": "v1.0.8"
     }
 }