pxt-microbit 7.0.35 → 7.0.36

package/docs/reference/music/built-in-melody.md

@@ -0,0 +1,51 @@
+# built In Melody
+
+Get a melody string for a built-in melody.
+
+```sig
+music.builtInMelody(Melodies.Dadadadum)
+```
+
+A collection of built-in melodies are available. You choose one by selecting the name of the melody.
+
+## Parameters
+
+* **melody**: A melody name. The available melodies are:
+
+>* `dadadum`
+>* `entertainer`
+>* `prelude`
+>* `ode`
+>* `nyan`
+>* `ringtone`
+>* `funk`
+>* `blues`
+>* `birthday`
+>* `wedding`
+>* `funeral`
+>* `punchline`
+>* `baddy`
+>* `chase`
+>* `ba ding`
+>* `wawawawaa`
+>* `jump up`
+>* `jump down`
+>* `power up`
+>* `power down`
+
+## Returns
+
+* a [string](/types/string) that contains the melody.
+
+## Example
+
+Play the built-in melody for **blues**.
+
+```blocks
+music.startMelody(music.builtInMelody(Melodies.Blues), MelodyOptions.Once)
+```
+
+## See also
+
+[start melody](/reference/music/start-melody),
+[built-in sound effect](/reference/music/builtin-sound-effect)

package/docs/reference/music/built-in-playable-melody.md

@@ -0,0 +1,50 @@
+# built In Playable Melody
+
+Get a playable sound object for a built-in melody.
+
+```sig
+music.builtInPlayableMelody(Melodies.Dadadadum)
+```
+
+A collection of built-in melodies are available as [playable](/types/playable) sound objects. You choose one by selecting the name of the melody.
+
+## Parameters
+
+* **melody**: A melody name. The available melodies are:
+
+>* `dadadum`
+>* `entertainer`
+>* `prelude`
+>* `ode`
+>* `nyan`
+>* `ringtone`
+>* `funk`
+>* `blues`
+>* `birthday`
+>* `wedding`
+>* `funeral`
+>* `punchline`
+>* `baddy`
+>* `chase`
+>* `ba ding`
+>* `wawawawaa`
+>* `jump up`
+>* `jump down`
+>* `power up`
+>* `power down`
+
+## Returns
+
+* a [playable](/types/playable) object that contains the melody.
+
+## Example
+
+Play the built-in melody for **blues**.
+
+```blocks
+music.play(music.builtInPlayableMelody(Melodies.Blues), music.PlaybackMode.InBackground)
+```
+
+## See also
+
+[built-in sound effect](/reference/music/builtin-sound-effect)

package/docs/reference/pins/analog-pin.md

@@ -0,0 +1,32 @@
+# analog Pin
+
+Get an analog pin number for a pin identifier.
+
+```sig
+pins._analogPin(AnalogPin.P0)
+```
+
+## Parameters
+
+* **pin**: a pin identifier for an analog pin (`P0` through `P20`).
+
+## Returns
+
+* a pin [number](/types/number) for the pin identifier.
+
+## Example
+
+Set an analog pin variable for `P1`, read pin `P1`, and show the input value on the LED screen.
+
+```blocks
+let myPin = AnalogPin.P1
+basic.forever(function() {
+    let value = pins.analogReadPin(myPin)
+    basic.showNumber(value)
+})
+```
+
+## See also
+
+[analog read pin](/reference/pins/analog-read-pin),
+[analog write pin](/reference/pins/analog-write-pin)

package/docs/reference/pins/digital-pin.md

@@ -0,0 +1,43 @@
+# digital Pin
+
+Get an digital pin number for a pin identifier.
+
+```sig
+pins._digitalPin(DigitalPin.P3)
+```
+
+## Parameters
+
+* **pin**: a pin identifier for an digital pin (`P0` through `P20`).
+
+## Returns
+
+* a pin [number](/types/number) for the pin identifier.
+
+## Example: football score keeper
+
+This program reads pin `P0` to find when a goal is scored. When `P0`
+is `1`, the program makes the score bigger and plays a buzzer sound
+through `P2` with ``||pins:digital write pin||``. Use pin variables
+to set the read and write pin numbers.
+
+```blocks
+let score = 0
+let readPin = DigitalPin.P0
+let writePin = DigitalPin.P2
+basic.showNumber(score)
+basic.forever(() => {
+    if (pins.digitalReadPin(readPin) == 1) {
+        score++;
+        pins.digitalWritePin(writePin, 1)
+        basic.showNumber(score)
+        basic.pause(1000)
+        pins.digitalWritePin(writePin, 0)
+    }
+})
+```
+
+## See also
+
+[digital read pin](/reference/pins/digital-read-pin),
+[digital write pin](/reference/pins/digital-write-pin)

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "pxt-microbit",
-    "version": "7.0.35",
+    "version": "7.0.36",
     "description": "micro:bit target for Microsoft MakeCode (PXT)",
     "keywords": [
         "JavaScript",
@@ -46,6 +46,6 @@
     },
     "dependencies": {
         "pxt-common-packages": "12.0.4",
-        "pxt-core": "10.2.31"
+        "pxt-core": "10.2.33"
     }
 }