pxt-microbit 8.1.9 → 8.1.11

package/docs/courses/ucp-science.md

@@ -33,7 +33,7 @@ The lesson series includes:
 * [Rocket Acceleration](/courses/ucp-science/rocket-acceleration)
 * [Egg Drop Experiment](/courses/ucp-science/egg-drop)
 * [Spoon Race](/courses/ucp-science/spoon-race)
- 
-The [Science Experiments](https://sites.google.com/view/utahcodingproject/csta/microbit-science-experiments) lesson series is generously provided by the [Utah Coding Project](https://sites.google.com/view/utahcodingproject/home) and is developed by [Carl Lyman](mailto:utahcoding@outlook.com).
+
+The [Science Experiments](https://sites.google.com/view/utahcodingproject/microbits/microbit-science-experiments) lesson series is generously provided by the [Utah Coding Project](https://sites.google.com/view/utahcodingproject/home) and is developed by [Carl Lyman](mailto:utahcoding@outlook.com).
  
 [![CC BY-NC-SA](https://licensebuttons.net/l/by-nc-sa/4.0/88x31.png)](https://creativecommons.org/licenses/by-nc-sa/4.0/)

package/docs/extensions/extension-gallery.md

@@ -192,6 +192,10 @@ Many extensions are available to work with interface kits, add-on hardware, or o
 
 ```codecard
 [{
+  "name": "KY-040 Rotary Encoder Plus",
+  "url":"/pkg/steveturbek/pxt-rotary-encoder-KY-040-plus",
+  "cardType": "package"
+}, {
  "name": "MonkMakes Plant Monitor",
   "url":"/pkg/monkmakes/plant-monitor-makecode",
   "cardType": "package"

package/docs/projects/plot-acceleration.md

@@ -19,7 +19,17 @@ basic.forever(function() {
 
 ## Console
 
-Click on the **Show Console** button by the simulator to see a chart of the values plotted by the block over a period of time. Hover over the board in the simulator to make a force in the ``x`` dimension.
+Click on the **(+)** in the ``||led:plot bar graph||`` block to expand it. The ``||led:serial write||`` parameter will appear and is set to **ON**. Now, after a moment, the **Show data Simulator** button will show up near the simulator. Click on it to see a chart of the values plotted by the block over a period of time. Hover over the board in the simulator to make a force in the ``x`` dimension.
+
+```blocks
+basic.forever(function() {
+    led.plotBarGraph(
+        input.acceleration(Dimension.X),
+        0,
+        true
+    )
+})
+```
 
 ## Maximum value
 
@@ -30,7 +40,8 @@ For example, we can tell the block that we don't expect values beyond ``1000`` m
 basic.forever(function() {
     led.plotBarGraph(
         input.acceleration(Dimension.X),
-        1000
+        1000,
+        true
     )
 })
 ```
@@ -43,7 +54,8 @@ You can use this block for pretty much any kind of data. Try it out! Plot the ``
 basic.forever(function() {
     led.plotBarGraph(
         input.lightLevel(),
-        0
+        0,
+        true
     )
 })
 ```

package/docs/projects/snap-the-dot.md

@@ -64,8 +64,8 @@ input.onButtonPressed(Button.A, function () {
 })
 basic.forever(function () {
     sprite.move(1)
-    basic.pause(100)
     sprite.ifOnEdgeBounce()
+    basic.pause(100)
 })
 ```
 
@@ -84,8 +84,8 @@ input.onButtonPressed(Button.A, function () {
 })
 basic.forever(function () {
     sprite.move(1)
-    basic.pause(100)
     sprite.ifOnEdgeBounce()
+    basic.pause(100)
 })
 ```
 

package/docs/projects/spy/snap-the-dot.md

@@ -69,8 +69,8 @@ input.onButtonPressed(Button.A, function () {
 })
 basic.forever(function () {
     sprite.move(1)
-    basic.pause(100)
     sprite.ifOnEdgeBounce()
+    basic.pause(100)
 })
 ```
 
@@ -90,8 +90,8 @@ input.onButtonPressed(Button.A, function () {
 })
 basic.forever(function () {
     sprite.move(1)
-    basic.pause(100)
     sprite.ifOnEdgeBounce()
+    basic.pause(100)
 })
 ```
 

package/docs/projects/turtle-square.md

@@ -68,6 +68,10 @@ input.onButtonPressed(Button.A, function() {
 })
 ```
 
+```blockconfig.global
+for(let index = 0; index <= 3; index++) {}
+```
+
 ```package
 microturtle=github:Microsoft/pxt-microturtle#v0.0.9
 ```

package/docs/projects/v2-clap-lights.md

@@ -133,7 +133,7 @@ Your @boardname@ might detect sounds when you don't want it to. Setting a [__*so
 
 ```blocks
 // @highlight
-input.setSoundThreshold(SoundThreshold.Loud, 150)
+input.setSoundThreshold(SoundThreshold.Loud, 128)
 ```
 
 ## {Testing, round 2}
@@ -158,7 +158,7 @@ input.onSound(DetectedSound.Loud, function () {
     	basic.clearScreen()
     }
 })
-input.setSoundThreshold(SoundThreshold.Loud, 150)
+input.setSoundThreshold(SoundThreshold.Loud, 128)
 ```
 
 ```validation.global

package/docs/projects/v2-morse-chat.md

@@ -21,10 +21,12 @@ Morse code is an alphabet composed of dots (short signals) and dashes (long sign
 
 hint~
 
+■ From the ``||radio:Radio||`` category, get a ``||radio:radio set group [1]||`` and drop it into your empty ``||basic:on start||`` container. You can leave the group ID at `1` or change it to something different (the radio group ID is like a channel number to talk on).  
 ■ From the ``||input:Input||`` category in the toolbox, drag an ``||input:on logo [pressed]||`` container into to your workspace.  
 ■ From the ``||radio:Radio||`` category, get ``||radio:radio send number [0]||`` and snap it into your empty ``||input:on logo [pressed]||`` container.
 
 ```blocks
+radio.setGroup(1)
 input.onLogoEvent(TouchButtonEvent.Pressed, function () {
     radio.sendNumber(0)
 })
@@ -37,6 +39,7 @@ input.onLogoEvent(TouchButtonEvent.Pressed, function () {
 ■ On the greyed-out ``||input(noclick):on logo [pressed]||`` container, click on the **``pressed``** dropdown and set it to ``||input(noclick):long pressed||``.
 
 ```blocks
+radio.setGroup(1)
 // @highlight
 input.onLogoEvent(TouchButtonEvent.LongPressed, function () {
 })
@@ -51,6 +54,7 @@ input.onLogoEvent(TouchButtonEvent.Pressed, function () {
 ■ Set the number to be ``1``.
 
 ```blocks
+radio.setGroup(1)
 input.onLogoEvent(TouchButtonEvent.LongPressed, function () {
     // @highlight
     radio.sendNumber(1)
@@ -236,6 +240,7 @@ Test what you've created. Remember to turn your sound on!
 💡 If your screen is too small, you might not be able to see it.
 
 ```blocks
+radio.setGroup(1)
 radio.onReceivedNumber(function (receivedNumber) {
     if (receivedNumber == 0) {
         basic.showLeds(`
@@ -276,6 +281,7 @@ input.onLogoEvent(TouchButtonEvent.Pressed, function () {
 ■ If you have multiple @boardname@s with sound (they have **shiny gold** logos at the top), download this code and try it out!
 
 ```blocks
+radio.setGroup(1)
 radio.onReceivedNumber(function (receivedNumber) {
     if (receivedNumber == 0) {
         basic.showLeds(`

package/docs/reference/input/compass-heading.md

@@ -1,42 +1,99 @@
-# Compass Heading
+# compass Heading
 
 Find which direction on a compass the @boardname@ is facing.
 
 The @boardname@ measures the **compass heading** from `0` to `359`
-degrees with its **magnetometer** chip. Different numbers mean north,
-east, south, and west.
+degrees with its **magnetometer** chip. Different numbers mean North,
+East, South, and West.
 
 ```sig
-input.compassHeading();
+input.compassHeading()
 ```
 
 ## Returns
 
 * a [number](/types/number) from `0` to `359` degrees, which means the compass heading. If the compass isn't ready, it returns `-1003`.
 
-## Example
+## Compass points
 
-This program finds the compass heading and stores it in the
-`degrees` variable.
+In history, a compass was a device that pointed in the direction of the magnetic North Pole. A needle or or a spot on a moving dial was magnetically attracted to the pole. Using a circular card or diagram arranged with direction indications you could align the indicator with the mark that meant "North" and see which direction the heading you wanted was in.
 
-```blocks
-let degrees = input.compassHeading()
-```
+![Modern plastic compass](/static/device/compass/plastic-compass.jpg)</br>
+**Magnetic compass**<br>
+_by Evan Amos, Public Domain_
+
+The compass pointer (needle) is always pointing to magnetic North. The compass dial might not have alignment with the needle. Once the needle is aligned with the dial, the compass will show what the direction is for a heading. The basic 4 compass points are **North (W), East (E), South (S),** and **West (W)**. These are also called the _Four Cardinal Directions_.
+
+In the compass examples below, the needle is pointing toward magnetic North. Next, the needle becomes aligned with the "N" symbol. If you wanted to walk East, you would take the compass and turn it so the "E" symbol is pointing directly ahead of you. While you walk East, keep the needle aligned with the "N" symbol.
+
+| Needle Heading | Compass Aligned |
+|-|-|
+| ![Unaligned compass](/static/device/compass/compass-needle.png) | ![Aligned compass](/static/device/compass/compass-align.png)
+
+## Directions and degrees
+
+Modern compasses also use degree markings along with direction symbols. The compass dial shows degree markings from `0°` to `360°`.
+
+![Compass with degree markings](/static/device/compass/compass-degrees.png)
+
+The degree markings map to directions. Below is a list of directions and their degree values.
+
+|Direction|Symbol|Degrees|
+|-|-|-|
+|North|N|0°|
+|Northeast|NE|45°|
+|East|E|90°|
+|Southeast|SE|135°|
+|South|S|180°|
+|Southwest|SE|225°|
+|West|W|270°|
+|Northwest|NW|315°|
+
+</br>
+
+Besides the 4 Cardinal Directions, there are *Intercardinal Directions* like Northeast (shown in the list above). Additionally, there are direction names between the Cardinal and Intercardinal ones. One of these is North-Northeast (NNE) whose degree value is 22.5° and another is West-Southwest (WSW) at 247.5°.
+
+### ~tip 
+
+#### Running compass programs on the @boardname@
 
-### ~hint 
+When testing and using your compass programs on the board, hold the @boardname@ face up (logo side up) and the top edge toward the direction to measure (bottom edge connector side is toward your body).
+
+### ~
+
+### ~hint
 
 #### Compass simulation
 
-When you run a program that in the simulator, click and drag
-the compass needle on the screen to change the compass heading.
+When you run a program in the simulator that uses ``||input:compassHeading||``, a compass direction needle appears on the screen. Click and rotate the direction needle to change the compass heading.
+
+```sim
+basic.forever(function () {
+    basic.showNumber(input.compassHeading())
+    basic.pause(5000)
+})
+```
 
 ### ~
 
-## Example: compass
+## Examples
+
+### Digital compass
+
+Display the current compass heading in degrees `0` - `359`.
+
+```blocks
+basic.forever(function () {
+    basic.showNumber(input.compassHeading())
+    basic.pause(1000)
+})
+```
+
+### Analog compass
 
-This program finds the compass heading and then shows a letter
-that means whether the @boardname@ is facing north (N), south (S),
-east (E), or west (W).
+Find the compass heading and then show an arrow
+that means whether the @boardname@ is facing north (🠉), south (🠋),
+east (🠊), or west (🠈).
 
 ```blocks
 let degrees = 0
@@ -71,7 +128,7 @@ confuse the @boardname@.
 
 #### Make a calibration tool
 
-Keep the calibration handy by running it when the user pressed **A+B**.
+Keep the calibration current by running it when the user pressed **A+B**.
 
 ```block
 input.onButtonPressed(Button.AB, () => {

package/docs/reference/radio/set-group.md

@@ -1,43 +1,50 @@
 # set Group
 
-Make a program have the group ID you tell it for sending and receiving
-with radio.
+Set the group ID for sending and receiving messages over radio.
 
 ```sig
-radio.setGroup(0);
+radio.setGroup(0)
 ```
 
 A group is like a cable channel (a @boardname@ can only
-send or receive in one group at a time). A group ID is like the cable
-channel number.
+send or receive date in one group at a time) and the group ID is like the channel number.
 
-If you do not tell your program which group ID to use with this
-function, it will figure out its own group ID by itself.  If you load
-the very same program onto two different @boardname@s, they will be able
+If you load the same program onto two different @boardname@s, they will be able
 to talk to each other because they will have the same group ID.
 
 ## Parameters
 
-* **id**: a [number](/types/number) from ``0`` to ``255``.
+* **id**: a radio group ID [number](/types/number) from ``0`` to ``255``.
 
 ### ~ reminder
 
 #### Default radio group
 
-If you haven't set a radio group for the @boardname@, it will use one selected randomly. If you are transmiting data to a @boardname@ that has a different hardware version from the sending @boardname@, it will select a random default group that is not the same as the other @boardname@. To be certain that your program will send or receive data using the same radio group, you will need to first choose and set a radio group for your program if you want it to work between different versions of the @boardname@.
+If you haven't set a radio group for the @boardname@, it will use the default group number of **0**.
 
 ### ~
 
-## Simulator
+### ~ alert
+
+#### Simulator
 
 This function only works on the @boardname@, not in browsers.
 
+### ~
+
 ## Example
 
-This program makes the group ID equal 128.
+Set a radio group to send and receive a [number](/types/number) between @boardname@s.
 
 ```blocks
-radio.setGroup(128)
+radio.setGroup(1)
+radio.onReceivedNumber(function (receivedNumber) {
+    basic.showNumber(0)
+    basic.clearScreen()
+})
+input.onButtonPressed(Button.A, function () {
+    radio.sendNumber(0)
+})
 ```
 
 ## See also
@@ -49,6 +56,7 @@ radio.setGroup(128)
 [send value](/reference/radio/send-value),
 [send string](/reference/radio/send-string)
 
+
 ```package
 radio
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "pxt-microbit",
-    "version": "8.1.9",
+    "version": "8.1.11",
     "description": "micro:bit target for Microsoft MakeCode (PXT)",
     "keywords": [
         "JavaScript",
@@ -46,7 +46,7 @@
     },
     "dependencies": {
         "pxt-common-packages": "13.2.3",
-        "pxt-core": "12.3.3"
+        "pxt-core": "12.3.6"
     },
     "overrides": {}
 }

package/targetconfig.json

@@ -438,6 +438,7 @@
             "bestmodules-libraries/pxt-bmduino": { "tags": [ "Science" ] },
             "forward-education/pxt-coding-for-good": { "tags": [ "Science" ] },
             "dfrobot/pxt-dfrobot_huskylensv2": { "tags": [ "Science" ] },
+            "steveturbek/pxt-rotary-encoder-ky-040-plus": { "tags": [ "Science" ] },
             "microsoft/pxt-simx-sample": {
                 "simx": {
                     "sha": "7301f5900879b85127482d79bab48f03c25690a8",
@@ -539,6 +540,6 @@
         ]
     },
     "electronManifest": {
-        "latest": "v8.0.14"
+        "latest": "v8.0.19"
     }
 }