pxt-microbit 4.0.12 → 4.0.13

package/built/targetlight.json

@@ -157,7 +157,7 @@
                 "codalTarget": {
                     "name": "codal-microbit-v2",
                     "url": "https://github.com/lancaster-university/codal-microbit-v2",
-                    "branch": "v0.2.33",
+                    "branch": "v0.2.32",
                     "type": "git"
                 },
                 "codalBinary": "MICROBIT",
@@ -355,10 +355,10 @@
     },
     "uploadDocs": true,
     "versions": {
-        "branch": "v4.0.12",
-        "tag": "v4.0.12",
-        "commits": "https://github.com/microsoft/pxt-microbit/commits/47d96faa65c0cceb96e8e37e6e83fcce4ef402c8",
-        "target": "4.0.12",
+        "branch": "v4.0.13",
+        "tag": "v4.0.13",
+        "commits": "https://github.com/microsoft/pxt-microbit/commits/4513d0b7072da874595e86f2f253829757a34997",
+        "target": "4.0.13",
         "pxt": "7.0.8"
     },
     "blocksprj": {

package/docs/blocks/comments.md

@@ -0,0 +1,131 @@
+# Comments
+
+For simple programs, is easy to understand the steps and the flow the program might take when it runs. If you have just a few steps in your program that run one after the other in a sequence, it's fairly easy to understand what's happening at each place in your program.
+
+The following program does 4 simple things:
+
+1. Show a "Hello" message
+2. Display a smiley face as part of a greeting
+2. Pause for a second so you can see the smiley
+3. Clear the screen
+
+```blocks
+basic.showString("Hello!")
+basic.showIcon(IconNames.Happy)
+basic.pause(1000)
+basic.clearScreen()
+```
+
+It's quite obvious what this program is doing. Each block does one thing, the next block runs after the previous one in a sequence, then the program ends. Let's say you want the user to show that they saw the greeting. You could add button press event that shows a check mark icon.
+
+```blocks
+basic.showString("Hello!")
+basic.showIcon(IconNames.Happy)
+basic.pause(1000)
+basic.clearScreen()
+input.onButtonPressed(Button.A, function () {
+    basic.showIcon(IconNames.Yes)
+})
+```
+
+You know, of course, that the button press event means that the user has acknowleged your greeting. If you shared your program with someone else though, they might not understand why you wanted to add the button press to the program. 
+
+## Block comments
+
+To let others know what certain parts of your program are supposed to do, you can add **comments**. Comments are a text description that says what that part of your program is doing. To put a comment on a block, open the block menu and select **Add comment**.
+
+![Block menu](/static/blocks/block-menu.jpg)
+
+A place for your comment will appear and you can type in your description of what that block is for and what it's supposed to do.
+
+![Insert the comment](/static/blocks/insert-comment.jpg)
+
+Once a comment is added to a block, a comment icon will show in the upper-left corner of the block. Here's our program with the comment on the ``||input:on button A press||``.
+
+```blocks
+// Signal that the greeting was seen
+input.onButtonPressed(Button.A, function () {
+    basic.showIcon(IconNames.Yes)
+})
+basic.showString("Hello!")
+basic.showIcon(IconNames.Happy)
+basic.pause(1000)
+basic.clearScreen()
+```
+
+In the Blocks editor, the comment is displayed when you click on the comment icon. If you view the JavaScript or Python code, you'll see a comment line directly above the button press code.
+
+```typescript
+// Signal that the greeting was seen
+input.onButtonPressed(Button.A, function () {
+    basic.showIcon(IconNames.Yes)
+})
+basic.showString("Hello!")
+basic.showIcon(IconNames.Happy)
+basic.pause(1000)
+basic.clearScreen()
+```
+
+When a program contains conditionals, loops, or functions, adding comments becomes important to help understand what's happening at those places in your program. The program can take a different path based on a condition, result from a function, or some other action.
+
+### ~ hint
+
+#### Workspace comments
+
+You can add comments an notes about your project with **Workspace Comments**. Just right-click on the Workspace background and choose **Add Comment** to insert your comments for the project.
+
+```block
+/**
+ * This is a workspace comment.
+ * 
+ * Use this space to make comments
+ * 
+ * and notes about your project.
+ */
+// Display a message
+function showMessage () {
+    basic.showString("Workspaces have comments!")
+}
+```
+
+### ~
+
+The following example has a conditional inside a loop to choose one of three different mood values. For each mood, a function will display an icon for it. Each block has a comment that describes what it will do. Take a look at the JavaScript or Python code to see the comments on the code text also.
+
+```blocks
+/**
+ * The mood icon project.
+ * 
+ * TODO: add more moods
+ * 
+ * 1. Sad
+ * 
+ * 2. Confused
+ */
+// Display an emotion of love
+function heart () {
+    basic.showIcon(IconNames.Heart)
+}
+// Show a surprised expression
+function surprised () {
+    basic.showIcon(IconNames.Surprised)
+}
+// Display a smiley mood
+function smiley () {
+    basic.showIcon(IconNames.Happy)
+}
+// My program that shows three mood icons
+// Run the loop to show 3 icons
+for (let index = 0; index <= 2; index++) {
+    // Select an icon based on the index
+    if (index == 0) {
+        smiley()
+    } else if (index == 1) {
+        heart()
+    } else {
+        surprised()
+    }
+    // Pause for a second between moods
+    basic.pause(1000)
+}
+```

package/docs/blocks/loops.md

@@ -1,3 +1,15 @@
 # @extends
 
 ## #specific
+
+```cards
+loops.everyInterval(500, function () {})
+```
+
+## #seealso
+
+[for](/blocks/loops/for), 
+[while](/blocks/loops/while), 
+[repeat](/blocks/loops/repeat), 
+[for of](/blocks/loops/for-of),
+[every](/reference/loops/every)

package/docs/extensions.md

@@ -62,6 +62,14 @@ Check out [the accessories pages on microbit.org](https://microbit.org/buy/acces
 
 ```codecard
 [{
+    "name": "Kitronik 128x64 Display",
+    "url": "/pkg/KitronikLtd/pxt-kitronik-128x64Display",
+    "cardType": "package"
+}, {
+    "name": "Monk Makes 7-Segment",
+    "url": "/pkg/monkmakes/monkmakes-7-segment",
+    "cardType": "package"
+}, {
     "name": "Pimoroni inky:bit",
     "url": "/pkg/pimoroni/pxt-inkybit",
     "cardType": "package"
@@ -156,6 +164,10 @@ Check out [the accessories pages on microbit.org](https://microbit.org/buy/acces
 
 ```codecard
 [{
+ "name": "TCS3200 Color sensor",
+  "url":"/pkg/joy-it/pxt-SEN-Color",
+  "cardType": "package"
+}, {
  "name": "MPU6050 Gyroscope",
   "url":"/pkg/joy-it/SEN-MPU6050",
   "cardType": "package"
@@ -316,9 +328,21 @@ Check out [the accessories pages on microbit.org](https://microbit.org/buy/acces
 
 ```codecard
 [{
+   "name": "KittenBot Powerbrick",
+   "url": "/pkg/KittenBot/pxt-powerbrick",
+   "cardType": "package"
+}, {
+   "name": "Kitronik LAB:bit",
+   "url": "/pkg/KitronikLtd/pxt-kitronik-lab-bit",
+   "cardType": "package"
+}, {
    "name": "PT-BOT PTKidsBIT",
    "url": "/pkg/iBuilds/pxt-PTKidsBIT",
    "cardType": "package"
+}, {
+   "name": "Stemhub City",
+   "url": "/pkg/stemhub/pxt-StemhubCity",
+   "cardType": "package"
 }, {
    "name": "Pi Supply tinker:kit",
    "url": "/pkg/PiSupply/pxt-tinker-kit",
@@ -388,6 +412,10 @@ Check out [the accessories pages on microbit.org](https://microbit.org/buy/acces
 
 ```codecard
 [{
+  "name": "Elecfreaks Smart AI Lens ",
+  "url":"/pkg/elecfreaks/pxt-PlanetX-AI",
+  "cardType": "package"
+}, {
   "name": "MU Vision camera",
   "url":"/pkg/mu-opensource/pxt-muvision",
   "cardType": "package"
@@ -401,6 +429,18 @@ Check out [the accessories pages on microbit.org](https://microbit.org/buy/acces
 
 ```codecard
 [{
+  "name": "MakeKit Hoverbit",
+  "url":"/pkg/gomakekit/Hoverbit_V2",
+  "cardType": "package"
+}, {
+  "name": "Stemhubbit car",
+  "url":"/pkg/stemhub/pxt-Stemhubbit",
+  "cardType": "package"
+}, {
+  "name": "MATRIX Micro",
+  "url":"/pkg/pxt-MatrixMicro",
+  "cardType": "package"
+}, {
   "name": "PTKidsBIT",
   "url":"/pkg/iBuilds/pxt-PTKidsBIT-Robot",
   "cardType": "package"

package/docs/projects/SUMMARY.md

@@ -7,6 +7,12 @@
   * [Dice](/projects/dice)
   * [Love Meter](/projects/love-meter)
   * [Micro Chat](/projects/micro-chat)
+* [Tutorials for the new micro:bit (V2)](/v2tutorials)
+  * [Pet Hamster](/projects/v2-pet-hamster)
+  * [Countdown](/projects/v2-countdown)
+  * [Morse Chat](/projects/v2-morse-chat)
+  * [Clap Lights](/projects/v2-clap-lights)
+  * [Blow Away](/projects/v2-blow-away)
 * [Live Coding](/live-coding)
   * [Flashing Heart](https://youtu.be/NvEOKZ8wh9s)
   * [Name Tag](https://youtu.be/xpRI5jjQ31E)
@@ -106,7 +112,7 @@
   * [Square](/projects/turtle-square)
   * [Spiral](/projects/turtle-spiral)
   * [Scanner](/projects/turtle-scanner)
-* [Blocks To JavaScript](/courses/blocks-to-javascript)
+* [Blocks to JavaScript](/courses/blocks-to-javascript)
   * [Hello JavaScript](/courses/blocks-to-javascript/hello-javascript)
   * [Starter Blocks](/courses/blocks-to-javascript/starter-blocks)
   * [Writing Code](/courses/blocks-to-javascript/writing-code)

package/docs/projects/micro-chat.md

@@ -6,6 +6,14 @@
 
 Use the **radio** to send and receive messages with other @boardname@.
 
+## Set a radio group
+
+The first thing you want to do is to put in a ``||radio:set group||``. This will make certain that you and another @boardname@ will receive just the messages assigned to that group and not the messages sent from some other @boardname@ that's not part of your conversation. This like tuning to a particular channel to talk on.
+
+```blocks
+radio.setGroup(1)
+```
+
 ## Sending a message
 
 Use ``||input:on button pressed||`` to send a text message over radio with ``||radio:send string||``.
@@ -53,14 +61,6 @@ radio.onReceivedString(function (receivedString) {
 
 If you have two @boardname@s, download the program to each one. Press button **A** on one and see if the other gets a message.
 
-## Groups
-
-Use the ``||radio:set group||`` block to assign a **group** number to your program. You will only receive messages from @boardname@s within the same group. Use this to avoid receiving messages from every @boardname@ that is transmitting.
-
-```blocks
-radio.setGroup(123)
-```
-
 ```package
 radio
 ```

package/docs/projects/mood-radio.md

@@ -15,6 +15,7 @@ between @boardname@s using the radio antenna, just like a phone can send text me
 Let's add blocks that send a number when button ``A`` is pressed. We assume that `0` is the "mood code" to send for **smiley**.
 
 ```blocks
+radio.setGroup(1)
 input.onButtonPressed(Button.A, () => {
     radio.sendNumber(0)
     basic.showIcon(IconNames.Happy)
@@ -65,9 +66,10 @@ That's it. Download your code to multiple @boardname@s and try it out!
 
 Try adding a new code and use the ``||input:on shake||`` event to send it.
 
-## Full sources
+## Complete program
 
 ```blocks
+radio.setGroup(1)
 input.onButtonPressed(Button.A, () => {
     radio.sendNumber(0)
     basic.showIcon(IconNames.Happy)

package/docs/projects/multi-dice.md

@@ -22,9 +22,9 @@ input.onGesture(Gesture.Shake, function () {
 
 We need to store the result of the dice cast in a variable. A **variable** is like a place in the memory of the @boardname@ where you save information, like numbers.
 
-* Go to the **Variables** toolbox and click ``||Make a Variable||`` to create a new variable. We will call it **dice**.
-* Add a ``||set dice to||`` block and drag the ``||pick random||`` into it.
-* Drag a ``||dice||`` from the **Variables** toolbox into the ``||basic:show number||`` block.
+* Go to the **Variables** toolbox and click ``Make a Variable`` to create a new variable. We will call it **dice**.
+* Add a ``||variables:set dice to||`` block and drag the ``||math:pick random||`` into it.
+* Drag a ``||variables:dice||`` variable from the **Variables** toolbox into the ``||basic:show number||`` block.
 
 ```blocks
 let dice = 0
@@ -36,9 +36,10 @@ input.onGesture(Gesture.Shake, function () {
 
 ## Send the dice
 
-Put in a ``||radio:send number||`` and a ``||dice||`` to send the value stored in the ``dice`` variable via radio.
+Put in a ``||radio:send number||`` and a ``||variables:dice||`` to send the value stored in the ``||variables:dice||`` variable via radio. Make sure to add a ``||radio:set group||`` to ``||basic:on start||`` with the group number set to the group you want to use.
 
 ```blocks
+radio.setGroup(1)
 let dice = 0
 input.onGesture(Gesture.Shake, function () {
     dice = randint(1, 6)
@@ -49,7 +50,7 @@ input.onGesture(Gesture.Shake, function () {
 
 ## Receive the dice
 
-Go get an ``||radio:on received number||`` event block. This event runs when a radio message from another @boardname@ arrives. The ``receivedNumber`` value is the value of the dice in this game.
+Go get an ``||radio:on received number||`` event block. This event runs when a radio message from another @boardname@ arrives. The ``||variables:receivedNumber||`` value is the value of the dice in this game.
 
 ```blocks
 radio.onReceivedNumber(function (receivedNumber) {
@@ -58,7 +59,7 @@ radio.onReceivedNumber(function (receivedNumber) {
 
 ## Check your cast
 
-Add a ``||logic:if||`` block to test if ``receivedNumber`` is greater or equal to ``dice``.
+Add a ``||logic:if||`` block to test if ``||variables:receivedNumber||`` is greater or equal to ``||variables:dice||``.
 If is, you lost so display a sad face on the screen.
 
 ```blocks
@@ -78,6 +79,7 @@ If you have more than one @boardname@, download your code onto each one and try
 
 ```blocks
 let dice = 0
+radio.setGroup(1)
 input.onGesture(Gesture.Shake, function () {
     dice = randint(1, 6)
     basic.showNumber(dice)

package/docs/projects/plot-acceleration.md

@@ -6,7 +6,7 @@ The ``||led:plot bar graph||`` uses the screen to display the _magnitude_ (how b
 
 ## Acceleration
 
-In a ``||loops:forever||`` loop, ``||led:plot||`` ``||input:acceleration||`` in the ``x`` dimension on the LEDs.
+In a ``||basic:forever||`` loop, ``||led:plot||`` ``||input:acceleration||`` in the ``x`` dimension on the LEDs.
 
 ```blocks
 basic.forever(function() {
@@ -50,4 +50,4 @@ basic.forever(function() {
 
 ## Download and try
 
-Download the code to your @boardname@ and test the sensors.
+Download the code to your @boardname@ and test the sensors.