0.2.124

README.md

@@ -7,21 +7,39 @@ This target allow to program a [BBC micro:bit](https://www.microbit.co.uk/) usin
 
 [![Build Status](https://travis-ci.org/Microsoft/pxt-microbit.svg?branch=master)](https://travis-ci.org/Microsoft/pxt-microbit)
 
-# Getting started
+## Local server
 
-Please follow instructions at https://github.com/Microsoft/pxt#running-a-target-from-localhost 
+### Setup
+
+The following commands are a 1-time setup after synching the repo on your machine.
+
+* install the PXT command line
+```
+npm install -g pxt
+```
+* install the dependencies
+```
+npm install
+```
+
+### Running
+
+Run this command to open a local web server:
+```
+pxt serve
+```
+To make sure you're running the latest tools, run
+```
+npm update
+```
+
+More instructions at https://github.com/Microsoft/pxt#running-a-target-from-localhost 
 
 ## Universal Windows App
 
 The Windows 10 app is a [Universal Windows Hosted Web App](https://microsoftedge.github.io/WebAppsDocs/en-US/win10/CreateHWA.htm)
 that wraps m.pxt.io and provides additional features.
 
-### Sideloading
-
-* Open Windows **settings** and search for **Developer options**
-* Enable the developer mode.
-* Find the latest build under ``win10/app/AppPackages/latest`` and run the ``Add-AppDevPackage.ps1`` PowerShell script (mouse right-click, then `run with PowerShell`)
-
 ### Building
 
 * Install Visual Studio 2015 Update 2 or higher. Make sure the Windows 10 templates are installed.

docs/about.md

@@ -26,7 +26,7 @@ input.onButtonPressed(Button.B, () => {
 The [BBC micro:bit](https://www.microbit.co.uk) is a [pocket-size computer](/device) with a 5x5 display of 25 LEDs, Bluetooth and sensors that can be programmed by anyone.
 The BBC micro:bit was made possible by many [partners](https://www.microbit.co.uk/partners).
 
-The micro:bit provides a fun introduction to programming and making – switch on, program it to do something fun – wear it, customize it.
+The micro:bit provides an easy and fun introduction to programming and making – switch on, program it to do something fun – wear it, customize it.
 Just like Arduino, the micro:bit can be connected to and interact with sensors, displays, and other devices. 
 
 ## Blocks or JavaScript

docs/reference/toc.md

@@ -0,0 +1,197 @@
+acceleration
+
+analog-pitch
+
+analog-read-pin
+
+analog-set-period
+
+analog-set-pitch-pin
+
+analog-write-pin
+
+assign
+
+boolean
+
+brightness
+
+button-is-pressed
+
+change
+
+change-score-by
+
+change-tempo
+
+change-var
+
+clear
+
+clear-screen
+
+compass-heading
+
+create-image
+
+digital-read-pin
+
+digital-write-pin
+
+fade-in
+
+fade-out
+
+for
+
+forever
+
+game-library
+
+game-over
+
+if
+
+image
+
+in-background
+
+light-level
+
+magnetic-force
+
+map
+
+math
+
+move
+
+number
+
+[on button pressed](/reference/input/on-button-pressed)
+
+on-data-received
+
+on-gamepad-button
+
+on-gesture
+
+on-pin-pressed
+
+on-signal-strength-changed
+
+pause
+
+pin-is-pressed
+
+pixel
+
+play-tone
+
+plot
+
+plot-all
+
+plot-bar-graph
+
+plot-frame
+
+plot-image
+
+plot-leds
+
+point
+
+position
+
+raise-alert-to
+
+receive-number
+
+receive-number
+
+repeat
+
+reports
+
+reset
+
+rest
+
+ring-tone
+
+rotation
+
+running-time
+
+score
+
+screenshot
+
+scroll-image
+
+send-number
+
+servo-set-pulse
+
+servo-write-pin
+
+set-brightness
+
+set-display-mode
+
+set-group
+
+set-pixel
+
+set-tempo
+
+show-animation
+
+show-frame
+
+show-image
+
+show-leds
+
+show-number
+
+show-string
+
+signal-strength
+
+start-countdown
+
+stop-animation
+
+string
+
+tell-camera-to
+
+tell-microphone-to
+
+tell-remote-control-to
+
+temperature
+
+tempo
+
+toggle
+
+toggle-all
+
+touching
+
+turn
+
+unplot
+
+var
+
+while
+
+width
+
+write-line
+
+write-value

libs/microbit-radio/radio.ts

@@ -1,6 +1,6 @@
 /**
  * Communicate data using radio packets
  */
-//% color=270 weight=34
+//% color=#E3008C weight=34
 namespace radio {
 }

libs/microbit/basic.cpp

@@ -4,7 +4,7 @@
 /**
  * Provides access to basic micro:bit functionality.
  */
-//% color=190 weight=100
+//% color=#0078D7 weight=100
 namespace basic {
 
     /**

libs/microbit/game.ts

@@ -21,19 +21,19 @@ enum LedSpriteProperty {
 /**
  * A single-LED sprite game engine
  */
-//% color=176 weight=32
+//% color=#008272 weight=32
 namespace game {
-    var _score: number = 0;
+    let _score: number = 0;
-    var _life: number = 3;
+    let _life: number = 3;
-    var _startTime: number = 0;
+    let _startTime: number = 0;
-    var _endTime: number = 0;
+    let _endTime: number = 0;
-    var _isGameOver: boolean = false;
+    let _isGameOver: boolean = false;
-    var _countdownPause: number = 0;
+    let _countdownPause: number = 0;
-    var _level: number = 1;
+    let _level: number = 1;
-    var _gameId: number = 0;
+    let _gameId: number = 0;
-    var img: Image;
+    let img: Image;
-    var sprites: LedSprite[];
+    let sprites: LedSprite[];
-    
+
     /**
      * Creates a new LED sprite pointing to the right.
      * @param x sprite horizontal coordinate, eg: 2
@@ -47,7 +47,7 @@ namespace game {
         sprites.push(p);
         plot();
         return p;
-    }    
+    }
 
     /**
      * Gets the current score
@@ -394,7 +394,7 @@ namespace game {
             }
             plot();
         }
-        
+
         /**
          * Turn the sprite
          * @param this TODO
@@ -403,7 +403,7 @@ namespace game {
          */
         //% weight=49
         //% blockId=game_turn_sprite block="%sprite|turn %direction|by (°) %degrees"
-        public turn(direction : Direction, degrees: number) {
+        public turn(direction: Direction, degrees: number) {
             if (direction == Direction.Right)
                 this.setDirection(this._dir + degrees);
             else
@@ -435,8 +435,8 @@ namespace game {
          */
         //% weight=29
         //% blockId=game_sprite_set_property block="%sprite|set %property|to %value" blockGap=8
-        public set(property : LedSpriteProperty, value:number) {
+        public set(property: LedSpriteProperty, value: number) {
-            switch(property) {
+            switch (property) {
                 case LedSpriteProperty.X: this.setX(value); break;
                 case LedSpriteProperty.Y: this.setY(value); break;
                 case LedSpriteProperty.Direction: this.setDirection(value); break;
@@ -452,8 +452,8 @@ namespace game {
          */
         //% weight=30
         //% blockId=game_sprite_change_xy block="%sprite|change %property|by %value" blockGap=8
-        public change(property : LedSpriteProperty, value:number) {
+        public change(property: LedSpriteProperty, value: number) {
-            switch(property) {
+            switch (property) {
                 case LedSpriteProperty.X: this.changeXBy(value); break;
                 case LedSpriteProperty.Y: this.changeYBy(value); break;
                 case LedSpriteProperty.Direction: this.changeDirectionBy(value); break;
@@ -461,15 +461,15 @@ namespace game {
                 case LedSpriteProperty.Blink: this.changeBlinkBy(value); break;
             }
         }
-                
+
         /**
          * Gets a property of the sprite
          * @param property the name of the property to change
          */
         //% weight=28
         //% blockId=game_sprite_property block="%sprite|%property"
-        public get(property : LedSpriteProperty) {
+        public get(property: LedSpriteProperty) {
-            switch(property) {
+            switch (property) {
                 case LedSpriteProperty.X: return this.x();
                 case LedSpriteProperty.Y: return this.y();
                 case LedSpriteProperty.Direction: return this.direction()
@@ -681,7 +681,7 @@ namespace game {
     function init(): void {
         if (img == null) {
             img = images.createImage(
-`0 0 0 0 0
+                `0 0 0 0 0
 0 0 0 0 0
 0 0 0 0 0
 0 0 0 0 0

libs/microbit/images.cpp

@@ -3,7 +3,7 @@
 /**
 * Creation, manipulation and display of LED images.
 */
-//% color=45 weight=31
+//% color=#5C2D91 weight=31
 namespace images {
     /**
      * Creates an image that fits on the LED screen.

libs/microbit/input.ts

@@ -1,7 +1,7 @@
 /**
  * Events and data from sensors
  */
-//% color=300 weight=99
+//% color=#B4009E weight=99
 namespace input {
     /**
      * Attaches code to run when the screen is facing up.

libs/microbit/led.ts

@@ -1,8 +1,8 @@
 /**
  * Control of the LED screen.
  */
-//% color=3 weight=35
+//% color=#5C2D91 weight=35
-namespace led {
+    namespace led {
 
     // what's the current high value
     let barGraphHigh = 0;

libs/microbit/music.ts

@@ -77,7 +77,7 @@ enum BeatFraction {
 /**
  * Generation of music tones through pin ``P0``.
  */
-//% color=52 weight=98
+//% color=#D83B01 weight=98
 namespace music {
     let beatsPerMinute: number = 120;
 

libs/microbit/pins.ts

@@ -1,7 +1,7 @@
 /**
  * Control currents in Pins for analog/digital signals, servos, i2c, ...
  */
-//% color=351 weight=30
+//% color=#A80000 weight=30
 namespace pins {
     /**
      * Re-maps a number from one range to another. That is, a value of ``from low`` would get mapped to ``to low``, a value of ``from high`` to ``to high``, values in-between to values in-between, etc.

libs/microbit/serial.ts

@@ -1,7 +1,7 @@
 /**
  * Reading and writing data over a serial connection.
  */
-//% weight=2 color=30
+//% weight=2 color=#002050
 namespace serial {
     /**
      * Prints a line of text to the serial
@@ -11,8 +11,7 @@ namespace serial {
     //% help=serial/write-line blockGap=8
     //% blockId=serial_writeline block="serial|write line %text"
     export function writeLine(text: string): void {
-        writeString(text);
+        writeString(text + "\r\n");
-        writeString("\r\n");
     }
 
     /**
@@ -34,10 +33,7 @@ namespace serial {
     //% help=serial/write-value
     //% blockId=serial_writevalue block="serial|write value %name|= %value"
     export function writeValue(name: string, value: number): void {
-        writeString(name);
+        writeString(name + ":" + value + "\r\n");
-        writeString(":");
-        writeNumber(value);
-        writeLine("");
     }
 
     /**

libs/microbit/shims.d.ts

@@ -4,7 +4,7 @@
     /**
      * Creation, manipulation and display of LED images.
      */
-    //% color=45 weight=31
+    //% color=#5C2D91 weight=31
 declare namespace images {
 
     /**
@@ -113,7 +113,7 @@ declare interface Image {
     /**
      * Provides access to basic micro:bit functionality.
      */
-    //% color=190 weight=100
+    //% color=#0078D7 weight=100
 declare namespace basic {
 
     /**

libs/test-snippets/README.md

@@ -0,0 +1 @@
+run ``pxt testdir ../../buit/docs/blocks`` from this folder

libs/test-snippets/pxt.json

@@ -0,0 +1,13 @@
+{
+    "name": "test-snippets",
+    "description": "A test project for doc snippets",
+    "installedVersion": "file:.",
+    "files": [
+        "main.ts"
+    ],
+    "public": true,
+    "dependencies": {
+        "microbit": "file:../microbit",
+        "microbit-radio": "file:../microbit-radio"
+    }
+}

package.json

@@ -1,6 +1,6 @@
 {
   "name": "pxt-microbit",
-  "version": "0.2.122",
+  "version": "0.2.124",
   "description": "BBC micro:bit target for PXT",
   "keywords": [
     "JavaScript",
@@ -29,6 +29,6 @@
     "typescript": "^1.8.7"
   },
   "dependencies": {
-    "pxt-core": "0.2.129"
+    "pxt-core": "0.2.130"
   }
 }

pxtarget.json

@@ -72,7 +72,7 @@
         "log": true
     },
     "appTheme": {
-        "accentColor": "#5C2D91",
+        "accentColor": "#5C005C",
         "logoUrl": "https://m.pxt.io/about",
         "logo": "./static/microbit.simplified.svg",
         "docsLogo": "./static/microbit.simplified.svg",
@@ -102,6 +102,7 @@
                 "name": "Device",
                 "path": "/device"
             }
-        ]
+        ],
+        "sideDoc": "getting-started"
     }
 }

testconv.json

@@ -527,7 +527,6 @@
         "tnvnko",
         "toqcgf",
         "tpdiyw",
-        "tpxxzl",
         "tqeddl",
         "tqhpqp",
         "tqwach",
@@ -550,12 +549,10 @@
         "vbcdot",
         "vbtmwf",
         "vcijrw",
-        "vcmhms",
         "vcoevo",
         "vcrvjm",
         "vcudrv",
         "vczceh",
-        "vezrot",
         "vfcwwr",
         "vftxlg",
         "vfusfw",