pxt-microbit 7.1.31 → 7.1.34

package/docs/projects/v2-pet-hamster.md

@@ -8,7 +8,7 @@
 
 Cyrus is a very sleepy hamster. In fact, Cyrus is almost always sleeping.
 
-► From the ``||basic:Basic||`` category, find ``||basic:show icon [ ]||`` and snap it into your ``||basic:on start||`` container. Set it to show the asleep ``-_-`` face.  
+■ From the ``||basic:Basic||`` category, find ``||basic:show icon [ ]||`` and snap it into your ``||basic:on start||`` container. Set it to show the asleep ``-_-`` face.  
 💡 In the ``show icon`` dropdown menu options, you can hover to see what each design is called!
 
 ```blocks
@@ -20,8 +20,8 @@ basic.showIcon(IconNames.Asleep)
 
 Pressing Cyrus's logo tickles them!
 
-► From ``||input:Input||``, find the ``||input:on logo [pressed]||`` container and drag it into your workspace.  
-► Go to ``||basic:Basic||`` and grab **another** ``||basic:show icon [ ]||``. Snap it into your **empty** ``||input:on logo [pressed]||`` container. Set the icon (Cyrus's face) to happy ``:)``.
+■ From ``||input:Input||``, find the ``||input:on logo [pressed]||`` container and drag it into your workspace.  
+■ Go to ``||basic:Basic||`` and grab **another** ``||basic:show icon [ ]||``. Snap it into your **empty** ``||input(noclick):on logo [pressed]||`` container. Set the icon (Cyrus's face) to happy ``:)``.
 
 ```blocks
 //@highlight
@@ -33,7 +33,7 @@ input.onLogoEvent(TouchButtonEvent.Pressed, function () {
 
 ## {Tickle sound}
 
-► From the ``||music:Music||`` category, get a ``||music:play [melody jump up] [in background]||`` and add it to the **bottom** of your ``||input:on logo [pressed]||`` container. Change the playback mode to ``||music:[until done]||``.
+■ From the ``||music:Music||`` category, get a ``||music:play [melody jump up] [in background]||`` and add it to the **bottom** of your ``||input(noclick):on logo [pressed]||`` container. Change the playback mode to ``||music(noclick):[until done]||``.
 
 ```blocks
 input.onLogoEvent(TouchButtonEvent.Pressed, function () {
@@ -47,8 +47,8 @@ input.onLogoEvent(TouchButtonEvent.Pressed, function () {
 
 Whenever Cyrus is shaken, they get sad 🙁
 
-► From ``||input:Input||``, find ``||input:on [shake]||`` and drag it into your workspace.  
-► From the ``||basic:Basic||`` category, grab ``||basic:show icon [ ]||`` and snap it into your **new** ``||input:on [shake]||`` container. Set the icon (Cyrus's face) to sad ``:(``.
+■ From ``||input:Input||``, find ``||input:on [shake]||`` and drag it into your workspace.  
+■ From the ``||basic:Basic||`` category, grab ``||basic:show icon [ ]||`` and snap it into your **new** ``||input(noclick):on [shake]||`` container. Set the icon (Cyrus's face) to sad ``:(``.
 
 ```blocks
 //@highlight
@@ -60,8 +60,8 @@ input.onGesture(Gesture.Shake, function () {
 
 ## {Dizzy sound}
 
-► From the ``||music:Music||`` category, find the ``||music:play [melody dadadum] [in background]||`` block and add it to the **bottom** of your ``||input:on [shake]||`` container. Change the playback mode to ``||music:[until done]||``.
-► Click on the **dropdown** and set it so Cyrus plays a sad sound until done.
+■ From the ``||music:Music||`` category, find the ``||music:play [melody dadadum] [in background]||`` block and add it to the **bottom** of your ``||input(noclick):on [shake]||`` container. Change the playback mode to ``||music(noclick):[until done]||``.
+■ Click on the **dropdown** and set it so Cyrus plays a sad sound until done.
 
 ```blocks
 input.onGesture(Gesture.Shake, function () {
@@ -75,8 +75,8 @@ input.onGesture(Gesture.Shake, function () {
 
 Let's ensure that Cyrus will always go back to sleep after being shaken or tickled.
 
-► Right click the ``||basic:show icon[-_-]||`` block in your workspace (inside the ``||basic:on start||`` container) and choose **Duplicate**.  
-► Snap your copied block in at the **very bottom** of your ``||input:on [shake]||`` container.
+■ Right click the ``||basic(noclick):show icon[-_-]||`` block in your workspace (inside the ``||basic(noclick):on start||`` container) and choose **Duplicate**.  
+■ Snap your copied block in at the **very bottom** of your ``||input(noclick):on [shake]||`` container.
 
 ```blocks
 input.onGesture(Gesture.Shake, function () {
@@ -94,7 +94,7 @@ basic.showIcon(IconNames.Asleep)
 
 ## {Cyrus's default face pt. 2}
 
-► Duplicate the ``||basic:show icon[-_-]||`` block again and this time snap it in at the **very bottom** of your ``||input:on logo [pressed]||`` container.
+■ Duplicate the ``||basic(noclick):show icon[-_-]||`` block again and this time snap it in at the **very bottom** of your ``||input(noclick):on logo [pressed]||`` container.
 
 ```blocks
 input.onGesture(Gesture.Shake, function () {

package/docs/projects/v2-play-sound-long.md

@@ -18,7 +18,7 @@ Let's find out what numbers the micro:bit produces when you move it around.
 ⇼ Open the ``||serial:^ Advanced||`` category to show the ``||serial:Serial||`` label.
 
 ⇼ From ``||serial:Serial||``, drag the ``||serial:serial write value ["x"] = [0]||``
-block into the ``||basic:forever||`` loop container.
+block into the ``||basic(noclick):forever||`` loop container.
 
 
 
@@ -52,7 +52,7 @@ with the micro:bit **acceleration** value.
 ---
 
 ⇼ Open the ``||input:Input||`` category and drag ``||input:acceleration (mg) [x]||``
-over to replace "0" in the ``||serial:serial write value ["x"] = [0]||``
+over to replace "0" in the ``||serial(noclick):serial write value ["x"] = [0]||``
 block.
 
 ⇼ Change "x" to "a" (for "acceleration".)
@@ -86,7 +86,7 @@ the micro:bit **acceleration** value.
 ---
 
 ⇼ Open the ``||input:Input||`` category and drag ``||input:acceleration (mg) [x]||``
-over to replace "0" in the ``||serial:serial write value ["x"] = [0]||``
+over to replace "0" in the ``||serial(noclick):serial write value ["x"] = [0]||``
 block.
 
 ⇼ Change "x" to "a" (for "acceleration".)

package/docs/projects/v2-play-sound.md

@@ -16,7 +16,7 @@ To start your electronic beat, you'll want to repeat a sound forever.
 ---
 
 ⇼ Open the ``||music:Music||`` category and drag the ``||music:play sound [♫ ∿∿∿∿ +] [until done]||``
-block into the empty ``||basic:forever||`` loop container.
+block into the empty ``||basic(noclick):forever||`` loop container.
 
 
 
@@ -48,7 +48,7 @@ micro:bit **acceleration** value in the sound block.
 
 ---
 
-⇼ On the ``||music:play sound [♫ ∿∿∿ +] [until done]||`` block, click the plus icon (**+**)
+⇼ On the ``||music(noclick):play sound [♫ ∿∿∿ +] [until done]||`` block, click the plus icon (**+**)
 to show the start frequency value of 5000.
 
 ⇼ From the ``||input:Input||`` category, drag the ``||input:acceleration (mg) [x]||``

package/docs/reference/basic/show-leds.md

@@ -19,11 +19,15 @@ basic.showLeds(`
 * `interval` is an optional [number](/types/number) that means how many milliseconds to wait after showing a picture.
 If you are programming with blocks, `interval` is set at 400 milliseconds.
 
-## ~ hint
+### ~ hint
 
-See how the @boardname@ shows numbers, text, and displays images by watching this video about [LEDs](https://www.youtube.com/watch?v=qqBmvHD5bCw).
+#### LED display
 
-## ~
+Watch this video to see how the @boardname@ shows numbers, text, and displays images with [LEDs](/reference/led).
+
+https://www.youtube.com/watch?v=qqBmvHD5bCw
+
+### ~
 
 ## Example
 

package/docs/reference/control/hardware-version.md

@@ -1,7 +1,15 @@
-# WaitMicros
+# hardware Version
 
-Returns the major version of the microbit.
+Returns a string containing the the major version and minor version of the @boardname@.
 
 ```sig
 control.hardwareVersion()
 ```
+
+## Returns
+
+* a [string](/types/string) that contains the major and minor versions of the @boardname@. The string has an `"x.y"` format like `"1.5"`, `"2.1"`, or `"2.2"`.
+
+## See also
+
+[device name](/reference/control/device-name), [device serial number](/reference/control/device-serial-number)

package/docs/reference/control.md

@@ -12,7 +12,6 @@ control.onEvent(0, 0, () => { });
 control.raiseEvent(0, 0);
 control.eventTimestamp();
 control.eventValue();
-control.hardwareVersion();
 ```
 
 ## See Also

package/docs/reference/input/running-time-micros.md

@@ -1,17 +1,35 @@
-# Running Time Micros
+# running Time Micros
 
-Find how long it has been since the program started in micro-seconds.
+Find how long a program has run since it was started, in microseconds.
 
 ```sig
-input.runningTimeMicros();
+input.runningTimeMicros()
+```
+
+### ~ alert
+
+#### Running time maximum count
+
+The program running time counter can only count up to approximately 17 minutes of time (1,073,741,823 microseconds). After that, the running time will reset to zero and start counting up again.
+
+Programs using the time counter should take this reset into account, even if they are only measuring short durations. The counter might reset while the program is running.
+
+### ~
+
+## Example
+
+Pause for one second and then show the program running time on the screen.
+
+```blocks
+basic.pause(1000)
+basic.showNumber(input.runningTimeMicros())
 ```
 
 ## Returns
 
-* the [Number](/types/number) of microseconds since the program started.
-(One second is 1000000 microseconds.)
+* the [number](/types/number) of microseconds since the program started.
+(One second is 1,000,000 microseconds.)
 
 ## See also
 
-[show number](/reference/basic/show-number), [pause](/reference/basic/pause)
-
+[show number](/reference/basic/show-number), [pause](/reference/basic/pause), [running time](/reference/input/running-time)

package/docs/reference/input/running-time.md

@@ -1,9 +1,9 @@
 # Running Time
 
-Find how long it has been since the program started in milli-seconds.
+Find how long a program has run since it was started, in milliseconds.
 
 ```sig
-input.runningTime();
+input.runningTime()
 ```
 
 ## Returns
@@ -13,12 +13,12 @@ input.runningTime();
 
 ## Example: elapsed time
 
-When you press button `B` on the microbit, this
+When you press button `B` on the @boardname@, this
 program finds the number of milliseconds since the program started
 and shows it on the [LED screen](/device/screen).
 
 ```blocks
-input.onButtonPressed(Button.B, () => {
+input.onButtonPressed(Button.B, function() {
     let now = input.runningTime()
     basic.showNumber(now)
 })
@@ -27,5 +27,5 @@ input.onButtonPressed(Button.B, () => {
 
 ## See also
 
-[show number](/reference/basic/show-number), [pause](/reference/basic/pause)
+[show number](/reference/basic/show-number), [pause](/reference/basic/pause), [running time micros](/reference/input/running-time-micros)
 

package/docs/reference/radio/on-data-received.md

@@ -7,13 +7,13 @@ Run part of a program when the @boardname@ receives a
 radio.onDataReceived(() => { });
 ```
 
-## ~ hint
+### ~ alert
 
-**Deprecated**
+#### Deprecated API
 
 This API has been deprecated! Use [on received number](/reference/radio/on-received-number) instead.
 
-## ~
+### ~
 
 ```sig
 radio.onDataReceived(() => { });

package/docs/reference/radio/on-received-buffer.md

@@ -46,11 +46,11 @@ radio.onReceivedBuffer(function (receivedBuffer) {
 ```
 
 
-## ~hint
+### ~hint
 
 A radio that can both transmit and receive is called a _transceiver_.
 
-## ~
+### ~
 
 ## See also
 

package/docs/reference/radio/on-received-number.md

@@ -11,13 +11,15 @@ radio.onReceivedNumber(function (receivedNumber) {})
 
 * **receivedNumber**: The [number](/types/number) that was sent in this packet or `0` if this packet did not contain a number. See [send number](/reference/radio/send-number) and [send value](/reference/radio/send-value)
 
-## ~ hint
+### ~ hint
+
+#### @boardname@ radio
 
 Watch this video to see how the radio hardware works on the @boardname@:
 
 https://www.youtube.com/watch?v=Re3H2ISfQE8
 
-## ~
+### ~
 
 ## Examples
 

package/docs/reference/radio/on-received-string.md

@@ -10,13 +10,15 @@ radio.onReceivedString(function (receivedString) {})
 
 * **receivedString**: The [string](/types/string) that was sent in this packet or the empty string if this packet did not contain a string. See [send string](/reference/radio/send-string) and [send value](/reference/radio/send-value)
 
-## ~ hint
+### ~ hint
+
+#### @boardname@ radio
 
 Watch this video to see how the radio hardware works on the @boardname@:
 
 https://www.youtube.com/watch?v=Re3H2ISfQE8
 
-## ~
+### ~
 
 ## Example
 

package/docs/reference/radio/on-received-value.md

@@ -11,13 +11,15 @@ radio.onReceivedValue(function (name, value) {})
 * **name**: a [string](/types/string) that is a name for the value received.
 * **value**: a [number](/types/number) that is the value received.
 
-## ~ hint
+### ~ hint
+
+#### @boardname@ radio
 
 Watch this video to see how the radio hardware works on the @boardname@:
 
 https://www.youtube.com/watch?v=Re3H2ISfQE8
 
-## ~
+### ~
 
 ## Example
 

package/docs/reference/radio/receive-number.md

@@ -6,13 +6,13 @@ Receive the next number sent by a @boardname@ in the same ``radio`` group.
 radio.receiveNumber();
 ```
 
-## ~ hint
+### ~ alert
 
-**Deprecated**
+#### Deprecated API
 
 This API has been deprecated! Use [on received number](/reference/radio/on-received-number) instead.
 
-## ~
+### ~
 
 ## Returns
 

package/docs/reference/radio/receive-string.md

@@ -5,13 +5,13 @@ Find the next string sent by radio from another @boardname@.
 ```sig
 radio.receiveString()
 ```
-## ~ hint
+### ~ alert
 
-**Deprecated**
+#### Deprecated
 
 This API has been deprecated! Use [on received string](/reference/radio/on-received-string) instead.
 
-## ~
+### ~
 
 ## Returns
 

package/docs/reference/text.md

@@ -1,18 +1 @@
-# Text
-
-Functions to combine, split, search, and convert text strings.
-
-```cards
-"".charAt(0);
-"".compare("");
-"".substr(0, 0);
-parseFloat("");
-parseInt("");
-convertToText(0);
-```
-
-## See also
-
-[char at](/reference/text/char-at), [compare](/reference/text/compare),
-[substr](/reference/text/substr), [parse int](/reference/text/parse-int), 
-[parse float](/reference/text/parse-float), [convert to text](/reference/text/convert-text)
+# @extends

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "pxt-microbit",
-    "version": "7.1.31",
+    "version": "7.1.34",
     "description": "micro:bit target for Microsoft MakeCode (PXT)",
     "keywords": [
         "JavaScript",
@@ -46,7 +46,7 @@
     },
     "dependencies": {
         "pxt-common-packages": "12.3.30",
-        "pxt-core": "11.4.17"
+        "pxt-core": "11.4.22"
     },
     "overrides": {
         "@blockly/field-colour": {

package/pxtarget.json

@@ -199,7 +199,7 @@
                 "codalTarget": {
                     "name": "codal-microbit-v2",
                     "url": "https://github.com/lancaster-university/codal-microbit-v2",
-                    "branch": "v0.2.69",
+                    "branch": "v0.3.0",
                     "type": "git"
                 },
                 "codalBinary": "MICROBIT",