0.7.18

Bump pxt-core to 0.8.6
remove begin
2017-01-05 22:39:36 -08:00 · 2017-01-05 22:39:34 -08:00 · 2017-01-05 13:35:28 -08:00 · 2017-01-05 13:33:41 -08:00 · 2017-01-05 13:31:30 -08:00 · 2017-01-05 13:31:05 -08:00
113 changed files with 1892 additions and 793 deletions
--- a/.gitignore
+++ b/.gitignore
@ -15,7 +15,7 @@ clients/win10/app/bld
 clients/win10/*.opendb
 clients/**/bin/**
 clients/**/obj/**
-clients/electron/projects
+electron-out
 hexcache
 *.user
--- a/README.md
+++ b/README.md
@ -7,6 +7,10 @@ PXT ([Microsoft Programming Experience Toolkit](https://github.com/Microsoft/pxt
 [![Build Status](https://travis-ci.org/Microsoft/pxt-microbit.svg?branch=master)](https://travis-ci.org/Microsoft/pxt-microbit)
 ## Issue tracking
 All issue tracking for this repo happens at https://github.com/Microsoft/pxt, see you there!
 ## Local server
 The local server allows to run the editor and the documentation from your computer.
--- a/clients/electron/.gitignore
+++ b/clients/electron/.gitignore
@ -1,2 +0,0 @@
 node_modules
 projects
--- a/clients/electron/README.md
+++ b/clients/electron/README.md
@ -1,5 +0,0 @@
 # PXT micro:bit Electron app
 A very basic wrapper around the web app. To install, copy the contents of this
 directory to somewhere outside the main `pxt-microbit` repository. Then run `npm
 install && npm start`.
--- a/clients/electron/index.html
+++ b/clients/electron/index.html
@ -1,15 +0,0 @@
 <!DOCTYPE html>
 <html>
  <head>
    <meta charset="UTF-8">
    <title>code the micro:bit</title>
  </head>
  <body>
    <webview id="webview" style="position:absolute; left:0; top:0; right:0; bottom:0"/>
    <script>
      const webview = document.getElementById("webview")
      const url = `http://localhost:3232/${window.location.hash}`
      webview.src = url
    </script>
  </body>
 </html>
--- a/clients/electron/main.js
+++ b/clients/electron/main.js
@ -1,39 +0,0 @@
 const {app, BrowserWindow, Menu} = require('electron')
 const pxt = require('pxt-core')
 const path = require('path')
 let win
 const cliPath = path.join(process.cwd(), "node_modules/pxt-microbit") 
 function startServerAndCreateWindow() {
  pxt.mainCli(cliPath, ["serve", "-no-browser"])
  createWindow()
 }
 function createWindow () {
  win = new BrowserWindow({
    width: 800,
    height: 600,
    title: "code the micro:bit"
  })
  Menu.setApplicationMenu(null)
  win.loadURL(`file://${__dirname}/index.html#local_token=${pxt.globalConfig.localToken}`)
  win.on('closed', () => {
    win = null
  })
 }
 app.on('ready', startServerAndCreateWindow)
 app.on('window-all-closed', () => {
  if (process.platform !== 'darwin') {
    app.quit()
  }
 })
 app.on('activate', () => {
  if (win === null) {
    createWindow()
  }
 })
--- a/clients/electron/package.json
+++ b/clients/electron/package.json
@ -1,14 +0,0 @@
 {
  "name"    : "code-the-microbit",
  "version" : "1.0.0",
  "description": "Blocks / Javascript editor",
  "author": "Microsoft",
  "main"    : "main.js",
  "scripts": {
      "start": "node_modules/.bin/electron ."
  },
  "devDependencies": {
      "electron": "*",
      "pxt-microbit": "*"
  }
 }
--- a/cmds/cmds.ts
+++ b/cmds/cmds.ts
@ -1,60 +0,0 @@
 /// <reference path="../node_modules/pxt-core/typings/node/node.d.ts"/>
 /// <reference path="../node_modules/pxt-core/built/pxtlib.d.ts" />
 import * as fs from "fs";
 import * as path from "path";
 import * as child_process from "child_process";
 let writeFileAsync: any = Promise.promisify(fs.writeFile)
 let execAsync: (cmd: string, options?: { cwd?: string }) => Promise<Buffer> = Promise.promisify(child_process.exec)
 let readDirAsync = Promise.promisify(fs.readdir)
 export function deployCoreAsync(res: ts.pxtc.CompileResult) {
    return getBitDrivesAsync()
        .then(drives => {
            if (drives.length == 0) {
                console.log("cannot find any drives to deploy to");
                return Promise.resolve(0);
            }
            console.log(`copy ${ts.pxtc.BINARY_HEX} to ` + drives.join(", "));
            let writeHexFile = (filename: string) => {
                return writeFileAsync(filename + ts.pxtc.BINARY_HEX, res.outfiles[ts.pxtc.BINARY_HEX])
                    .then(() => console.log("wrote hex file to " + filename));
            };
            return Promise.map(drives, d => writeHexFile(d))
                .then(() => drives.length);
        });
 }
 function getBitDrivesAsync(): Promise<string[]> {
    if (process.platform == "win32") {
        const rx = new RegExp("^([A-Z]:).* " + pxt.appTarget.compile.deployDrives)
        return execAsync("wmic PATH Win32_LogicalDisk get DeviceID, VolumeName, FileSystem")
            .then(buf => {
                let res: string[] = []
                buf.toString("utf8").split(/\n/).forEach(ln => {
                    let m = rx.exec(ln)
                    if (m) {
                        res.push(m[1] + "/")
                    }
                })
                return res
            })
    }
    else if (process.platform == "darwin") {
        const rx = new RegExp(pxt.appTarget.compile.deployDrives)
        return readDirAsync("/Volumes")
            .then(lst => lst.filter(s => rx.test(s)).map(s => "/Volumes/" + s + "/"))
    } else if (process.platform == "linux") {
        const rx = new RegExp(pxt.appTarget.compile.deployDrives)
        const user = process.env["USER"]
        return readDirAsync(`/media/${user}`)
            .then(lst => lst.filter(s => rx.test(s)).map(s => `/media/${user}/${s}/`))
    } else {
        return Promise.resolve([])
    }
 }
--- a/cmds/pxtrequire.ts
+++ b/cmds/pxtrequire.ts
@ -1,3 +1,6 @@
 /// <reference path="../node_modules/pxt-core/typings/globals/node/index.d.ts"/>
 /// <reference path="../node_modules/pxt-core/built/pxtlib.d.ts" />
 import * as path from "path";
 export let pxtCore = require("pxt-core");
 // require.resolve() gives path to [pxt dir]/built/pxt.js, so move up twice to get pxt root dir
--- a/docs/blocks.md
+++ b/docs/blocks.md
@ -11,4 +11,4 @@ Math.random(5);
 ## See Also
-[logic](/blocks/logic), [loops](/blocks/loops), [math](/blocks/math), [variables](/blocks/variables)
+[logic](/blocks/logic), [loops](/blocks/loops), [math](/blocks/math), [variables](/blocks/variables), [on-start](/blocks/on-start)
--- a/docs/blocks/logic/boolean.md
+++ b/docs/blocks/logic/boolean.md
@ -86,12 +86,14 @@ if (led.point(1,1) && led.point(2,2)) {
 When you compare two Numbers, you get a Boolean value, such as the comparison `x < 5` in the code below:
 ```blocks
 input.onButtonPressed(Button.A, () => {
    let x = Math.random(5)
    if(x < 5) {
    basic.showString("low");
    } else { 
    basic.showString("high");
    }
 })
 ```
 See the documentation on [Numbers](/reference/types/number) for more information on comparing two Numbers. You can also [compare strings](/reference/types/string-functions) using the `equals` function.
--- a/docs/blocks/logic/if.md
+++ b/docs/blocks/logic/if.md
@ -14,14 +14,16 @@ Click on the dark blue gear icon (see above) to add an *else* or *if* to the cur
 ### Example: adjusting screen brightness
 If the [light level](/reference/input/light-level) is `< 100`, this code sets the brightness to `255` when the button A is pressed:
 ```blocks
 input.onButtonPressed(Button.A, () => {
    if(input.lightLevel()<100){
        led.setBrightness(255);
    }
 })
 ```
 If the [light level](/reference/input/light-level) is `< 100`, this code sets the brightness to `255`:
 ### See also
 [while loop](/blocks/loops/while), [for](/blocks/loops/for), [boolean](/blocks/logic/boolean)
--- a/docs/blocks/loops/for.md
+++ b/docs/blocks/loops/for.md
@ -4,14 +4,21 @@
 Run part of the program the number of times you say.
 ```block
 for(let i = 0; i <= 4; ++i) {
 }
 ```
 ### Example: Count to 4
 This program will show the numbers 0, 1, 2, 3, and 4 one after another on the LED screen.
 ```blocks
 input.onButtonPressed(Button.A, () => {
    for(let i = 0; i < 5; ++i) {
        basic.showNumber(i)
    }
 })
 ```
 ### See also
--- a/docs/blocks/loops/while.md
+++ b/docs/blocks/loops/while.md
@ -2,7 +2,7 @@
 Repeat code while a [Boolean](/blocks/logic/boolean) `condition` is true.
-```blocks
+```block
 while(true) {
 }
 ```
@ -16,11 +16,13 @@ The condition is tested before any code runs. Which means that if the condition
 The following example uses a while loop to make a diagonal line on the LED screen (points `0, 0`, `1, 1`, `2, 2`, `3, 3`, `4, 4`).
 ```blocks
 input.onButtonPressed(Button.A, () => {
    let index = 4;
    while(index >= 0) {
        led.plot(index, index);
        index--;
    }
 })
 ```
 ### See also
--- a/docs/blocks/on-start.md
+++ b/docs/blocks/on-start.md
@ -0,0 +1,22 @@
 # On Start
 An event that runs when the program starts.
 The ``on start`` is a special event that runs when the program starts, before any other event. 
 Use this event to initialize your program.
 ## Example
 In this example, ``on start`` sets a dimmer brightness on the screen and the button handler shows a string.
 ```blocks
 input.onButtonPressed(Button.A, () => {
    basic.showString("Hello!")
 })
 led.setBrightness(50)
 ```
 ## What about JavaScript?
 ``on-start`` only exists in the block editor. In JavaScript, all code executes sequentially from the first line.
--- a/docs/getting-started.md
+++ b/docs/getting-started.md
@ -33,7 +33,7 @@ basic.forever(() => {
 When this program runs, you will see a smiley face, then a blank
 screen, then a smiley again -- it never stops! (That's because of the
-``forever`` block.)
+`[basic.forever(() => {})]` block.)
 Click **Download** to move your program to the @boardname@! 
 Make sure to follow the instructions.
--- a/docs/getting-started/buttons.md
+++ b/docs/getting-started/buttons.md
@ -17,7 +17,7 @@ input.onButtonPressed(Button.A, () => {
 #### ~hint
-The ``showString`` block can show letters, numbers, and punctuation
+The `[basic.showString("HI")]` block can show letters, numbers, and punctuation
 on the @boardname@ screen.
 #### ~
@ -33,7 +33,7 @@ input.onButtonPressed(Button.B, () => {
 #### ~hint
 You can find the letter `B` by clicking the letter `A` on the
-``onButtonPressed`` block.
+`[input.onButtonPressed(Button.A, () => {})]` block.
 #### ~
--- a/docs/getting-started/coin-flipper.md
+++ b/docs/getting-started/coin-flipper.md
@ -23,8 +23,8 @@ input.onButtonPressed(Button.B, () => {
 ```
 ### ~hint
-The ``pick random true or false`` block randomly tells the ``if``
+The `[Math.randomBoolean()]` block randomly tells the ``if``
-block `true` or `false`.  If the ``pick`` block picked `true`, the
+block `true` or `false`.  If value picked is `true`, the
 ``if`` block shows the letter `H`. Otherwise, it shows the letter `T`.
 That's it!
--- a/docs/getting-started/screen.md
+++ b/docs/getting-started/screen.md
@ -9,7 +9,7 @@ There are 25 bright LEDs on the @boardname@ screen. Let's use them to create som
 ### Happy unhappy face
 Draw an unhappy face instead of the blank screen.  Click on the dots
-in the second ``show leds`` block until it matches the blocks below.
+in the second `[basic.showLeds("")]` block until it matches the blocks below.
 Now you have an **animation** (cartoon) that shows a happy face,
 then an unhappy one, then a happy one again, forever (or until
 you turn off your @boardname@)!
@ -36,7 +36,7 @@ Click **Download** to move your program to the @boardname@!
 ### Your turn!
-Pile up more ``show leds`` blocks to create an animation! Create an
+Pile up more `[basic.showLeds("")]` blocks to create an animation! Create an
 animation with at least 5 pictures.  What does this animation show?
 ```blocks
@ -87,12 +87,6 @@ basic.forever(() => {
 ```
 Click **Download** to move your program to the @boardname@!
 #### ~hint
 You can find the ``show leds`` block in the **Basic** part of the editor.
 #### ~
 ### ~button /getting-started/buttons
 NEXT: BUTTONS
 ### ~
--- a/docs/index-ref.json
+++ b/docs/index-ref.json
@ -1,3 +1,3 @@
 {
-    "appref": "v0.6.13"
+    "appref": "v0.6.36"
 }
--- a/docs/projects.md
+++ b/docs/projects.md
@ -66,6 +66,10 @@ Fun games to build with your @boardname@.
 ```codecard
 [{
  "name": "Inchworm",
  "url":"/projects/inchworm",
  "imageUrl":"/static/mb/projects/inchworm.jpg"
 }, {
  "name": "Timing gates",
  "url":"/projects/timing-gates",
  "imageUrl":"/static/mb/projects/timing-gates.jpg"
--- a/docs/projects/compass.md
+++ b/docs/projects/compass.md
@ -10,12 +10,10 @@ Welcome! This guided tutorial will show you how to program a script that display
 ### ~
 ## Step 1
 Create a loop that will continuously update the reading of the compass.
 ```blocks
 basic.forever(() => {
--- a/docs/projects/flashing-heart.md
+++ b/docs/projects/flashing-heart.md
@ -2,8 +2,7 @@
 ### ~avatar avatar
-Use the LEDs to display a flashing heart, and then create
+Use the LEDs to display a flashing heart!
 an animation of a broken heart. :(
 ### ~
@ -38,7 +37,7 @@ basic.clearScreen();
 ## Step 3
-Put a [forever loop](/reference/basic/forever) around it.
+Put a [forever loop](/reference/basic/forever) around it to repeat the animation.
 ```blocks
 basic.forever(() => {
@ -73,32 +72,37 @@ basic.pause(500);
 })
 ```
-## Step 5
+## Send your heartbeats over radio!
-Add a second image of a broken heart. 
+Do you have a second @boardname@ at hand? You could use radio and send your heartbeats to other
@boardname@ and show a heart when you receive one.
 * move the code in the **forever** inside 
 a [on data packet received](/reference/radio/on-data-packet-received) handler. 
 The handler will run whenever a message is received from another @boardname@.
 * use [send number](/reference/radio/send-number) and [pause](/reference/basic/pause) 
 to broadcast a packet of data every second.
 ```blocks
 basic.forever(() => {
    radio.sendNumber(0)
    basic.pause(1000)
 })
 radio.onDataPacketReceived(({receivedNumber}) => {
    basic.showLeds(`
        . # . # .
        # # # # #
        # # # # #
        . # # # .
-    . . # . .`
+        . . # . .`);
-    );
+    basic.pause(500)
-basic.pause(500);
+    basic.clearScreen()
-basic.clearScreen();
+    basic.pause(500)
 basic.pause(500);
 basic.showLeds(`
    . # . # .
    # . # # #
    # . . . #
    . # # # .
    . . # . .`
    );
 basic.pause(500);
 basic.clearScreen();
 basic.pause(500);
 })
 ```
 Download the .hex file onto both @boardname@ and try it out!
 ```package
 radio
 ```
--- a/docs/projects/hack-your-headphones/music-of-light.md
+++ b/docs/projects/hack-your-headphones/music-of-light.md
@ -10,7 +10,9 @@ Let's start by adding a variable where you can store data. Then rename the varia
 ```blocks
 input.onButtonPressed(Button.A, () => {
    let light = input.lightLevel();
 });
 ```
 We want to play music on button pressed in order to register an event handler that will execute whenever when you run a script and click on button pressed on the simulator. We must start by opening the Input drawer and adding `on button pressed` A. Then add a block `rest` to plays nothing for a `1/16` beat. Modify your code so that your code looks like this.
--- a/docs/projects/inchworm.md
+++ b/docs/projects/inchworm.md
@ -0,0 +1,40 @@
 # Inchworm
 ### @description A inchworm like robot built with the micro:bit
 ### ~avatar avatar
 Make a funny inchworm robot!
 ### ~
 https://youtu.be/BiZLjugXMbM
 ## Duration
 3 Activities, approx 30-45 min each based on familiarity with the coding concepts
 ## Materials
 * Cardboard pieces (recycle!)
 * Glue gun or Tape (masking, duct tape, and/or packing tape)
 * Scissors that can cut cardboard
 * 1 @boardname@, battery holder and 2 AAA batteries
 * 3 Crocodile clips
 * 1 micro servo 9g SG90
 * 1 paper clip
 ![Materials](/static/mb/projects/inchworm/materials.jpg)
 ## Activities
 * [Servo](/projects/inchworm/servo)  
 * [Chassis](/projects/inchworm/chassis)  
 * [Code](/projects/inchworm/code)  
 ### ~button /projects/inchworm/servo
 Let's get started!
 ### ~
--- a/docs/projects/inchworm/chassis.md
+++ b/docs/projects/inchworm/chassis.md
@ -0,0 +1,88 @@
 # Chassis
 ### @description Building the cardboard inchworm
 ### ~avatar avatar
 Turn a piece of cardboard into an inchworm!
 ### ~
 ## Duration: ~45 minutes
 ## Materials
  * Cardboard
  * Scissors or cutters
  * glue gun or tape
  * 1 paper clip
 ## Step 1: cardboard
 Cutout a cardboard rectangle. You can use the @boardname@ as a ruler to figure out the size.
 ![](/static/mb/projects/inchworm/chassis1.jpg)
 ## Step 2: center fold
 Fold the cardboard in half over the short edge.
 ![](/static/mb/projects/inchworm/chassis2.jpg)
 ## Step 3: legs
 Fold each end so they rest flat on the ground.
 ![](/static/mb/projects/inchworm/chassis3.jpg)
 ## Step 4: front teeth
 Fold each corners on one end of the cardbard. This will be the front of the inchworm which is supposed to grip the ground.
 ![](/static/mb/projects/inchworm/chassis4.jpg)
 ## Step 5: back teeth
 Using a scissor or a cutter (watch the fingers!), cut out various strips in the other edge. Fold one after the other.
 ![](/static/mb/projects/inchworm/chassis5.jpg)
 ## Step 6: mounting the board
 Using tape or a glue gun, mount the @boardname@ on one side and the microservo on the cardobard.
 ![](/static/mb/projects/inchworm/chassis6.jpg)
 ## Step 7: mounting the servo
 Attach the servo on the **edge** of the other cardboard side.
 ![](/static/mb/projects/inchworm/chassis7.jpg)
 ## Step 8: Cable clean up (optional)
 Use tape to route the cables nicely on the inchworm.
 ![](/static/mb/projects/inchworm/chassis8.jpg)
 ## Step 9: attaching paper clip to servo
 Unfold a paper clip and attach it to the servo arm.
 ![](/static/mb/projects/inchworm/clip2.jpg)
 ## Step 10: attaching paper clip to cardboard
 Slide the folder paper clip into the cardboard, and use tape to secure it. 
 You might need to toy around with the size of the clip so that the servo rotation opens the inchworm sufficiently.
 ![](/static/mb/projects/inchworm/clip3.jpg)
 ## Step 11: it's ready!
 Your inchworm is ready!
 ![](/static/mb/projects/inchworm/ready.jpg)
 ### ~button /projects/inchworm/code
 NEXT: Code
 ### ~
--- a/docs/projects/inchworm/code.md
+++ b/docs/projects/inchworm/code.md
@ -0,0 +1,48 @@
 # Code
 ### @description code to make the inchworm alive
 ### ~avatar avatar
 Add code to make the inchworm move.
 ### ~
 ## Duration: ~30 minutes
 ## Step 1: walk forever
 In order for the inchworm to move, the @boardname@ needs to command the servo to go between ``0`` and ``180`` degrees
 at a certain pace. In the code below, the user pressed button ``A`` to launch the inchworm.
 ```blocks
 input.onButtonPressed(Button.A, () => {
    pins.servoWritePin(AnalogPin.P0, 0)
    basic.pause(500)
    pins.servoWritePin(AnalogPin.P0, 180)
    basic.pause(500)
 });
 ```
 ### ~ hint
 You may have noticed that the inchworm can be rather slow or simply won't move. Try to improve the design of your legs, teeth
 so that the inchworm goes as fast as possible. Trying it on carpet also great helps avoiding skidding.
 ### ~
 ## Step 2: radio controlled inchworm
 You will need 2 @boardname@ for this part. By using the radio, we can make the inchworm controlled by another @boardname@.
 Download the code below to the @boardname@ on the inchworm and another "controller" @boardname@. Whenere A is pressed, the inchworm will move once.
 ```blocks
 radio.onDataPacketReceived(({receivedNumber}) => {
    pins.servoWritePin(AnalogPin.P0, 0)
    basic.pause(500)
    pins.servoWritePin(AnalogPin.P0, 180)
    basic.pause(500)
 })
 input.onButtonPressed(Button.A, () => {
    radio.sendNumber(0)
 })
 ```
--- a/docs/projects/inchworm/servo.md
+++ b/docs/projects/inchworm/servo.md
@ -0,0 +1,130 @@
 # Preparing the servo
 ### @description Connecting the servo to crocodile clips
 ### ~avatar avatar
 Equip the microservo with crocodile clips.
 ### ~
 ## Duration: ~30 minutes
 ## Materials
  * Cutting pliers or wire cutter
  * Tape (masking, duct tape, and/or packing tape)
  * 3 crocodile clips, yellow, red and black.
  * 1 micro servo 9g (SG90)
 ## Using a microservo with the @boardname@
 The @boardname@ provides just enough current to operate the SG90 microservo. 
 The servo requires 3 connections: GND, 3V and a logic pin. 
 In this tutorial, we will equip the servo with crocodile clips to make it easier to use. 
 However, you could also use a shield or female to crocodile clips to acheive the same effect.
 If you are running a class or activity, you should consider preparing all servos before hand.
 ### ~ hint
 Kitronik wrote an excellent in-depth guide about using servos with the @boardname@. 
 Check it out at https://www.kitronik.co.uk/blog/using-bbc-microbit-control-servo/ .
 ### ~
 ## Step 1: cutout the connector
 Using the cutting pliers, cut out the dark plastic connector.
 ![](/static/mb/projects/inchworm/servo1.jpg)
 ## Step 2: strip out cables
 Using the plier or a wire stripper, strip the plastic from the cables.
 ![](/static/mb/projects/inchworm/servo2.jpg)
 ## Step 3: threading the servo cablers
 Thread the servo cables.
 ![](/static/mb/projects/inchworm/servo3.jpg)
 ## Step 4: crocobile clip claps
 Cut a crocodile cable in two and strip out the casing. 
 If possible try to use the same cable colors as the servo!
 ![](/static/mb/projects/inchworm/servo4.jpg)
 ## Step 5: thread cables together
 Place the cables next to each other
 ![](/static/mb/projects/inchworm/servo5.jpg)
 ... and thread them together.
 ![](/static/mb/projects/inchworm/servo6.jpg)
 ### ~ hint
 It is very **important** to ensure that there is a good connection between the 2 cables.
 If the connection is weak, the microservo will not receive enough current and it will not work.
 If you have access to a soldering iron, we strongly recommend to solver this connection.
 ### ~
 ## Step 4: protect the connection
 Protect the connection with electrical or duct tape.
 ![](/static/mb/projects/inchworm/servo7.jpg)
 ## Step 5: repeat for all cables
 Repeat the same process until all cables are connected.
 ![](/static/mb/projects/inchworm/servo8.jpg)
 ## Step 6: testing!
 It's time to test that your connection are all proper and that the servo will function **when the @boardname@ is powered by battery**.
 * Connect the microservo to the @boardname@. Black cable on ``GND``, red cable on ``3V`` and remaining cable on ``P0``.
 ![](/static/mb/projects/inchworm/circuit1.jpg)
 ### ~ hint
 When attaching the crocodile clips to the pins, don't hesitate to grab the side of the board with the jaws.
 ![](/static/mb/projects/inchworm/circuit2.jpg)
 ### ~
 * Download the following code to your @boardname@
 ```blocks
 let a = 0
 basic.forever(() => {
    a = input.acceleration(Dimension.X)
    pins.servoWritePin(AnalogPin.P0, pins.map(
        a,
        -512,
        512,
        0,
        180
    ))
 })
 ```
 * When powered by USB, make sure that the servo moves when you tilt the board.
 * When powered by batteries **only**, make sure that the servo moves when you tilt the board.
 If your servo seems to sutter and stay stuck at a particular position, it means that it is not receiving enough power.
 This is probably due to a weak connection or low battery level. Check each connection and check your batteries.
 ### ~button /projects/inchworm/chassis
 NEXT: Chassis
 ### ~
--- a/docs/projects/magic-button-trick.md
+++ b/docs/projects/magic-button-trick.md
@ -37,7 +37,7 @@ input.onButtonPressed(Button.B, () => {
 We will use the @boardname@'s compass to detect the magnet. Compass's tell us what direction we are pointing by detecting the Earth's magnetic field but they can also detect any other magnet nearby. We will use that to check if our magnet is next to the @boardname@ by using the [magnetic force](/reference/input/magnetic-force) block found in the input menu's 'more' section. As we only want to measure the strength we change the drop down to select 'strength':
-```blocks
+```block
 input.magneticForce(Dimension.Strength)
 ```
@ -50,16 +50,19 @@ If you have ever played with magnets you know they have two ends, often called a
 So in the code below we will check if the absolute value of our magnetic field strength reading is more than 100 and save the result of that check in a new variable called 'isSwitched':
 ```blocks
-let isSwitched = Math.abs(input.magneticForce(Dimension.Strength)) > 100
+let force = Math.abs(input.magneticForce(Dimension.Strength));
 let isSwitched = force > 100
 ```
 ## Step 4: running our 'magnet nearby' check all the time
 At the moment our code to detect the magnet being nearby will only run once so we need to put it into a [forever](/reference/basic/forever) block so that it keeps getting run again and again checking for the magnet to come near to the @boardname@. We should also make sure 'isSwitched' is false when our program starts.
 ```blocks
 let force = 0;
 let isSwitched = false;
 basic.forever(() => {
-	let isSwitched = Math.abs(input.magneticForce(Dimension.Strength)) > 100
+    force = Math.abs(input.magneticForce(Dimension.Strength));
    isSwitched = force > 100
 })
 ```
@ -68,10 +71,11 @@ basic.forever(() => {
 Now we can check the value of our variable 'isSwitched' whenever we want and we will know that the magnet is nearby if it's value is 'true'. Let's use that to change how the buttons work and complete the code for our trick. We will add an 'if, else' block to each button's code and check if we should swap over what each button displays because 'isSwitched' is equal to true:
 ```blocks
-
+let force = 0;
 let isSwitched = false;
 basic.forever(() => {
-    isSwitched = Math.abs(input.magneticForce(Dimension.Strength)) > 100
+    force = Math.abs(input.magneticForce(Dimension.Strength));
    isSwitched = force > 100
 })
 input.onButtonPressed(Button.A, () => {
--- a/docs/projects/smiley-buttons.md
+++ b/docs/projects/smiley-buttons.md
@ -12,8 +12,8 @@ Use [show leds](/reference/basic/show-leds) to make a smiley face:
 ```blocks
 basic.showLeds(`
-    . # . # .
+    # # . # #
-    . # . # .
+    # # . # #
    . . . . .
    # . . . #
    . # # # .`
@ -22,56 +22,93 @@ basic.showLeds(`
 ## Step 2
-Add an input block for when [button A is pressed](/reference/input/button-is-pressed), and put a
+Add an input block for when [button A is pressed](/reference/input/button-is-pressed), 
-frowny face inside it:
+and **move** the smiley face inside it:
 ```blocks
 input.onButtonPressed(Button.A, () => { 
    basic.showLeds(`
-    . # . # .
+        # # . # #
-    . # . # .
+        # # . # #
        . . . . .
        # . . . #
        . # # # .`
        );
 input.onButtonPressed(Button.A, () => { 
    basic.showLeds(`
        . # . # .
        . # . # .
        . . . . .
        . # # # .
        # . . . #`
        );
 });
 ```
 Try pressing button A!
 ## Step 3
-Now add blocks so that when [button B is pressed](/reference/input/button-is-pressed), a smiley appears:
+Now add blocks so that when [button B is pressed](/reference/input/on-button-pressed), 
 a frowney appears:
 ```blocks
 input.onButtonPressed(Button.A, () => { 
    basic.showLeds(`
-    . # . # .
+        # # . # #
-    . # . # .
+        # # . # #
        . . . . .
        # . . . #
        . # # # .`
        );
 input.onButtonPressed(Button.A, () => { 
    basic.showLeds(`
        . # . # .
        . # . # .
        . . . . .
        . # # # .
        # . . . #`
        );
 });
 input.onButtonPressed(Button.B, () => { 
    basic.showLeds(`
-        . # . # .
+        # # . # #
-        . # . # .
+        # # . # #
        . . . . .
-        # . . . #
+        . # # # .
-        . # # # .`
+        # . . . #`
        );
 });
 ```
 Try pressing ``A`` or ``B``!
 ## Send your smileys over radio
 Do you have a second @boardname@ at hand? You could use radio and send your smileys or frownies to other
@boardname@.
 Since radio can send numbers, we decide that ``0`` is the code for displaying a smiley 
 and ``1`` is the code for a frowney.
 Change your code as follows: 
 * [radio send number](/reference/radio/send-number) sends a number
 to any other @boardname@ in range
 * [radio on data packet received](/reference/radio/on-data-packet-received) runs code
 when data is received over radio
 ```blocks
 input.onButtonPressed(Button.A, () => {
    radio.sendNumber(0)
 })
 input.onButtonPressed(Button.B, () => {
    radio.sendNumber(1)
 })
 radio.onDataPacketReceived(({receivedNumber}) => {
    if (receivedNumber == 0) {
        basic.showLeds(`
            # # . # #
            # # . # #
            . . . . .
            # . . . #
            . # # # .
            `)
    } else {
        basic.showLeds(`
            # # . # #
            # # . # #
            . . . . .
            . # # # .
            # . . . #
            `)
    }
 })
 ```
 ```package
 radio
 ```
--- a/docs/reference/basic/forever.md
+++ b/docs/reference/basic/forever.md
@ -18,15 +18,15 @@ and updates the screen with the direction.
 basic.forever(() => {
    let heading = input.compassHeading()
    if (heading < 45) {
-        basic.showString("N", 100)
+        basic.showString("N")
    } else if (heading < 135) {
-        basic.showString("E", 100)
+        basic.showString("E")
    }
    else if (heading < 225) {
-        basic.showString("S", 100)
+        basic.showString("S")
    }
    else {
-        basic.showString("W", 100)
+        basic.showString("W")
    }
 })
 ```
@ -40,7 +40,7 @@ You can use a program like this to count things with your @boardname@.
 ```blocks
 let num = 0
 basic.forever(() => {
-    basic.showNumber(num, 150)
+    basic.showNumber(num)
 })
 input.onButtonPressed(Button.A, () => {
    num = num + 1
@ -56,10 +56,10 @@ Try this on your @boardname@:
 ```blocks
 basic.forever(() => {
-    basic.showNumber(6789, 150)
+    basic.showNumber(6789)
 })
 input.onButtonPressed(Button.A, () => {
-    basic.showNumber(2, 150)
+    basic.showNumber(2)
 })
 ```
--- a/docs/reference/bluetooth.md
+++ b/docs/reference/bluetooth.md
@ -19,6 +19,7 @@ bluetooth.startMagnetometerService();
 bluetooth.startTemperatureService();
 bluetooth.onBluetoothConnected(() => {});
 bluetooth.onBluetoothDisconnected(() => {});
 bluetooth.setTransmitPower(7);
 ```
 ## UART 
@ -34,7 +35,8 @@ bluetooth.uartWriteValue("", 0);
 ## Eddystone
 ```cards
-bluetooth.advertiseUrl("https://pxt.microbit.org/", 7);
+bluetooth.advertiseUid(42, 1, 7, true);
 bluetooth.advertiseUrl("https://pxt.microbit.org/", 7, true);
 bluetooth.stopAdvertising();
 ```
--- a/docs/reference/bluetooth/advertise-uid-buffer.md
+++ b/docs/reference/bluetooth/advertise-uid-buffer.md
@ -0,0 +1,37 @@
 # Avertise UID Buffer
 Advertises a UID via the Eddystone protocol over Bluetooth.
 ## ~hint
 ### Eddystone
 Bluetooth beacons are used to indicate proximity to a place or object of interest. 
 Beacons use Bluetooth advertising to broadcast a small amount of data, 
 which can be received and acted upon by anyone in range with a suitable device and software, typically a smartphone and application.
 There are various beacon message formats, which define the way Bluetooth advertising packets are used as containers for beacon data. 
 iBeacon is Apple's beacon message format. Eddystone comes from Google.
 Read more at https://lancaster-university.github.io/microbit-docs/ble/eddystone/ .
 ## ~
 ```sig
 bluetooth.advertiseUidBuffer(pins.createBuffer(16), 7, true);
 ```
 ### Parameters
 * ``buffer`` - a 16 bytes buffer containing the namespace (first 10 bytes) and instance (last 6 bytes).
 * ``power`` - a [number](/reference/types/number) representing the power level between 0 (short) and 7 (maximum range).
 * ``connectable`` - a [boolean](/reference/type/boolean) indicating whether or not the micro:bit should accept connections. 
 ## See Also
 [stop-advertising](/reference/bluetooth/stop-advertising), [advertise-uid](/reference/bluetooth/advertise-uid)
 ```package
 bluetooth
 ```
--- a/docs/reference/bluetooth/advertise-uid.md
+++ b/docs/reference/bluetooth/advertise-uid.md
@ -0,0 +1,46 @@
 # Avertise UID
 Advertises a UID via the Eddystone protocol over Bluetooth.
 ## ~hint
 ### Eddystone
 Bluetooth beacons are used to indicate proximity to a place or object of interest. 
 Beacons use Bluetooth advertising to broadcast a small amount of data, 
 which can be received and acted upon by anyone in range with a suitable device and software, typically a smartphone and application.
 There are various beacon message formats, which define the way Bluetooth advertising packets are used as containers for beacon data. 
 iBeacon is Apple's beacon message format. Eddystone comes from Google.
 Read more at https://lancaster-university.github.io/microbit-docs/ble/eddystone/ .
 ## ~
 ```sig
 bluetooth.advertiseUid(42, 1, 7, true);
 ```
 ### Parameters
 * ``namespace`` last 4 bytes of the namespace uid (6 to 9)
 * ``instance`` last 4 bytes of the instance (2 to 5)
 * ``power`` - a [number](/reference/types/number) representing the power level between 0 (short) and 7 (maximum range).
 * ``connectable`` - a [boolean](/reference/type/boolean) indicating whether or not the micro:bit should accept connections. 
 ## Encoding
 The bytes of ``namespace`` and ``instance`` are encoded to generate the 10 bytes UID namespace and 6 bytes UID instance.
 ```
 UID namespace: [0, ..., namespace]
 UID instance: [0, ..., instance]
 ```
 ## See Also
 [stop-advertising](/reference/bluetooth/stop-advertising), [advertise-uid-buffer](/reference/bluetooth/advertise-uid-buffer)
 ```package
 bluetooth
 ```
--- a/docs/reference/bluetooth/advertise-url.md
+++ b/docs/reference/bluetooth/advertise-url.md
@ -18,23 +18,24 @@ Read more at https://lancaster-university.github.io/microbit-docs/ble/eddystone/
 ## ~
 ```sig
-bluetooth.advertiseUrl("https://pxt.microbit.org/", 7);
+bluetooth.advertiseUrl("https://pxt.microbit.org/", 7, true);
 ```
 ### Parameters
-* ``url`` - a [string](/reference/types/string) containing the URL to broadcast, at most 18 characters long
+* ``url`` - a [string](/reference/types/string) containing the URL to broadcast, at most 17 characters long, excluding the protocol (eg: ``https://``) which gets encoded as 1 byte.
 * ``power`` - a [number](/reference/types/number) representing the power level between 0 (short) and 7 (maximum range).
 * ``connectable`` - a [boolean](/reference/type/boolean) indicating whether or not the micro:bit should accept connections. 
 ### Example: Broadcast a secret code
 ```blocks
-bluetooth.advertiseUrl("https://pxt.io?secret=42", 7);
+bluetooth.advertiseUrl("https://pxt.io?secret=42", 7, true);
 ```
 ## See Also
-[stop-advertising](/reference/bluetooth/stop-advertising)
+[stop-advertising](/reference/bluetooth/stop-advertising), [advertise-uid](/reference/bluetooth/advertise-uid)
 ```package
 bluetooth
--- a/docs/reference/bluetooth/set-transmit-power.md
+++ b/docs/reference/bluetooth/set-transmit-power.md
@ -0,0 +1,26 @@
 # Bluetooth Set Transmit Power
 ### ~hint
 ![](/static/bluetooth/Bluetooth_SIG.png)
 For another device like a smartphone to use any of the Bluetooth "services" which the @boardname@ has, it must first be [paired with the @boardname@](/reference/bluetooth/bluetooth-pairing). Once paired, the other device may connect to the @boardname@ and exchange data relating to many of the @boardname@'s features.
 ### ~
 Change the output power level of the transmitter to the given value.
 ```sig
 bluetooth.setTransmitPower(7);
 ```
 ### Parameters
 * `power`: a [number](/reference/types/number) in the range ``0..7``, where ``0`` is the lowest power and ``7`` is the highest.
 ### See also
 [About Bluetooth](/reference/bluetooth/about-bluetooth), [@boardname@ Bluetooth profile overview ](http://lancaster-university.github.io/microbit-docs/ble/profile/), [@boardname@ Bluetooth profile reference](http://lancaster-university.github.io/microbit-docs/resources/bluetooth/microbit-profile-V1.9-Level-2.pdf),  [Bluetooth on @boardname@ resources](http://bluetooth-mdw.blogspot.co.uk/p/bbc-microbit.html), [Bluetooth SIG](https://www.bluetooth.com)
 ```package
 bluetooth
 ```
--- a/docs/reference/serial/read-until.md
+++ b/docs/reference/serial/read-until.md
@ -0,0 +1,28 @@
 # Serial Read Until
 Read a text from the serial port until a delimiter is found.
 ```sig
 serial.readUntil(",");
 ```
 ### Returns
 * a [string](/reference/types/string) containing input from the serial port, such as a response typed by a user
 ### Example
 The following example reads strings separated by commands (``,``).
 ```blocks
 basic.forever(() => {
    let answer = serial.readUntil(",");
    serial.writeLine(answer);
 });
 ```
 ### See also
 [serial](/device/serial),
 [serial write line](/reference/serial/write-line),
 [serial write value](/reference/serial/write-value)
--- a/docs/static/Microsoft-logo_rgb_c-white.png
+++ b/docs/static/Microsoft-logo_rgb_c-white.png
--- a/docs/static/mb/projects/inchworm.jpg
+++ b/docs/static/mb/projects/inchworm.jpg
--- a/docs/static/mb/projects/inchworm/chassis1.jpg
+++ b/docs/static/mb/projects/inchworm/chassis1.jpg
--- a/docs/static/mb/projects/inchworm/chassis2.jpg
+++ b/docs/static/mb/projects/inchworm/chassis2.jpg
--- a/docs/static/mb/projects/inchworm/chassis3.jpg
+++ b/docs/static/mb/projects/inchworm/chassis3.jpg
--- a/docs/static/mb/projects/inchworm/chassis4.jpg
+++ b/docs/static/mb/projects/inchworm/chassis4.jpg
--- a/docs/static/mb/projects/inchworm/chassis5.jpg
+++ b/docs/static/mb/projects/inchworm/chassis5.jpg
--- a/docs/static/mb/projects/inchworm/chassis6.jpg
+++ b/docs/static/mb/projects/inchworm/chassis6.jpg
--- a/docs/static/mb/projects/inchworm/chassis7.jpg
+++ b/docs/static/mb/projects/inchworm/chassis7.jpg
--- a/docs/static/mb/projects/inchworm/chassis8.jpg
+++ b/docs/static/mb/projects/inchworm/chassis8.jpg
--- a/docs/static/mb/projects/inchworm/circuit1.jpg
+++ b/docs/static/mb/projects/inchworm/circuit1.jpg
--- a/docs/static/mb/projects/inchworm/circuit2.jpg
+++ b/docs/static/mb/projects/inchworm/circuit2.jpg
--- a/docs/static/mb/projects/inchworm/clip1.jpg
+++ b/docs/static/mb/projects/inchworm/clip1.jpg
--- a/docs/static/mb/projects/inchworm/clip2.jpg
+++ b/docs/static/mb/projects/inchworm/clip2.jpg
--- a/docs/static/mb/projects/inchworm/clip3.jpg
+++ b/docs/static/mb/projects/inchworm/clip3.jpg
--- a/docs/static/mb/projects/inchworm/materials.jpg
+++ b/docs/static/mb/projects/inchworm/materials.jpg
--- a/docs/static/mb/projects/inchworm/ready.jpg
+++ b/docs/static/mb/projects/inchworm/ready.jpg
--- a/docs/static/mb/projects/inchworm/servo1.jpg
+++ b/docs/static/mb/projects/inchworm/servo1.jpg
--- a/docs/static/mb/projects/inchworm/servo2.JPG
+++ b/docs/static/mb/projects/inchworm/servo2.JPG
--- a/docs/static/mb/projects/inchworm/servo3.jpg
+++ b/docs/static/mb/projects/inchworm/servo3.jpg
--- a/docs/static/mb/projects/inchworm/servo4.jpg
+++ b/docs/static/mb/projects/inchworm/servo4.jpg
--- a/docs/static/mb/projects/inchworm/servo5.jpg
+++ b/docs/static/mb/projects/inchworm/servo5.jpg
--- a/docs/static/mb/projects/inchworm/servo6.jpg
+++ b/docs/static/mb/projects/inchworm/servo6.jpg
--- a/docs/static/mb/projects/inchworm/servo7.jpg
+++ b/docs/static/mb/projects/inchworm/servo7.jpg
--- a/docs/static/mb/projects/inchworm/servo8.jpg
+++ b/docs/static/mb/projects/inchworm/servo8.jpg
--- a/docs/tutorials/getting-started.md
+++ b/docs/tutorials/getting-started.md
@ -0,0 +1,53 @@
 # Getting started
 ### Step 1
 Use the **Basic** drawer in the editor
 to drag out and arrange three blocks to create this program:
 ```block
 basic.showString("Hello world")
 ```
 ### Step 2
 Use the **Basic** drawer in the editor
 to drag out and arrange three blocks to create this program:
 ### Step 3
 Use the **Basic** drawer in the editor
 to drag out and arrange three blocks to create this program:
 ```block
 basic.forever(() => {
    basic.showNumber(0)
 })
 ```
 ### Step 4
 Use the **Basic** drawer in the editor
 to drag out and arrange three blocks to create this program:
 ```block
 input.onButtonPressed(Button.B, () => {
    basic.showLeds(`
    . . . . .
    . . . . .
    . . . . .
    . . . . .
    . . . . .
    `)
 })
 ```
 ### Step 5
 Use the **Basic** drawer in the editor
 to drag out and arrange three blocks to create this program:
 ```block
 input.onButtonPressed(Button.A, () => {
    basic.showString("Hello!")
 })
 ```
--- a/docs/uploader.md
+++ b/docs/uploader.md
@ -38,7 +38,7 @@ That's it!
 ### Installation Instructions
-* Download the [Microsoft.Uploader.Microbit.zip](https://pxt.microbit.org/microbit-uploader.zip) file to your local computer.
+* Download the [Microsoft.Uploader.Microbit.zip](https://www.touchdevelop.com/microbituploader.zip) file to your local computer.
 * Unzip the .zip file to your desktop.
 * Launch the Microsoft.Uploader.exe file before working on your @boardname@.
--- a/electron/product.json
+++ b/electron/product.json
@ -0,0 +1,14 @@
 {
    "applicationName": "pxt-microbit-oss",
    "dataFolderName": ".pxt-microbit-oss",
    "darwinBundleIdentifier": "com.microsoft.pxtmicrobitoss",
    "nameShort": "PXT microbit - OSS",
    "nameLong": "PXT micro:bit - OSS",
    "targetId": "pxt-microbit",
    "win32AppId": "{{92db071a-6f58-4938-8c97-13c873f4da13}",
    "win32AppUserModelId": "Microsoft.PXTmicrobitOss",
    "win32DirName": "Microsoft PXT microbit - OSS",
    "win32MutexName": "pxtmicrobitoss",
    "win32NameVersion": "Microsoft PXT microbit-OSS",
    "win32RegValueName": "PXTmicrobitOss"
 }
--- a/electron/release.json
+++ b/electron/release.json
@ -0,0 +1,9 @@
 {
    "versions": {
        "0": {
            "latest": "v0.6.45",
            "banned": [],
            "prompt": "v0.0.0"
        }
    }
 }
--- a/libs/blocksprj/main.blocks
+++ b/libs/blocksprj/main.blocks
@ -1,62 +1,3 @@
 <xml xmlns="http://www.w3.org/1999/xhtml">
-<block type="device_forever">
+  <block type="pxt-on-start"></block>
 <statement name="HANDLER">
 <block type="device_show_leds">
 <field name="LED00">FALSE</field>
 <field name="LED10">FALSE</field>
 <field name="LED20">FALSE</field>
 <field name="LED30">FALSE</field>
 <field name="LED40">FALSE</field>
 <field name="LED01">FALSE</field>
 <field name="LED11">TRUE</field>
 <field name="LED21">FALSE</field>
 <field name="LED31">TRUE</field>
 <field name="LED41">FALSE</field>
 <field name="LED02">FALSE</field>
 <field name="LED12">FALSE</field>
 <field name="LED22">FALSE</field>
 <field name="LED32">FALSE</field>
 <field name="LED42">FALSE</field>
 <field name="LED03">TRUE</field>
 <field name="LED13">FALSE</field>
 <field name="LED23">FALSE</field>
 <field name="LED33">FALSE</field>
 <field name="LED43">TRUE</field>
 <field name="LED04">FALSE</field>
 <field name="LED14">TRUE</field>
 <field name="LED24">TRUE</field>
 <field name="LED34">TRUE</field>
 <field name="LED44">FALSE</field>
 <next>
 <block type="device_show_leds">
 <field name="LED00">FALSE</field>
 <field name="LED10">FALSE</field>
 <field name="LED20">FALSE</field>
 <field name="LED30">FALSE</field>
 <field name="LED40">FALSE</field>
 <field name="LED01">FALSE</field>
 <field name="LED11">FALSE</field>
 <field name="LED21">FALSE</field>
 <field name="LED31">FALSE</field>
 <field name="LED41">FALSE</field>
 <field name="LED02">FALSE</field>
 <field name="LED12">FALSE</field>
 <field name="LED22">FALSE</field>
 <field name="LED32">FALSE</field>
 <field name="LED42">FALSE</field>
 <field name="LED03">FALSE</field>
 <field name="LED13">FALSE</field>
 <field name="LED23">FALSE</field>
 <field name="LED33">FALSE</field>
 <field name="LED43">FALSE</field>
 <field name="LED04">FALSE</field>
 <field name="LED14">FALSE</field>
 <field name="LED24">FALSE</field>
 <field name="LED34">FALSE</field>
 <field name="LED44">FALSE</field>
 </block>
 </next>
 </block>
 </statement>
 </block>
 </xml>
--- a/libs/blocksprj/main.ts
+++ b/libs/blocksprj/main.ts
@ -1,16 +1 @@
-basic.forever(() => {
+
    basic.showLeds(`
        . # . # .
        # . # . #
        # . . . #
        . # . # .
        . . # . .
        `)
    basic.showLeds(`
        . . . . .
        . . . . .
        . . . . .
        . . . . .
        . . . . .
        `)
 })
--- a/libs/bluetooth/_locales/bluetooth-jsdoc-strings.json
+++ b/libs/bluetooth/_locales/bluetooth-jsdoc-strings.json
@ -1,12 +1,24 @@
 {
-  "bluetooth": "Support for additional Bluetooth services.",
+  "bluetooth": "Support for additional Bluetooth services.\n\nSupport for additional Bluetooth services.",
  "bluetooth.advertiseUid": "Advertise an Eddystone UID",
  "bluetooth.advertiseUidBuffer": "Advertise an Eddystone UID",
  "bluetooth.advertiseUidBuffer|param|connectable": "true to keep bluetooth connectable for other services, false otherwise.",
  "bluetooth.advertiseUidBuffer|param|nsAndInstance": "16 bytes buffer of namespace (bytes 0-9) and instance (bytes 10-15)",
  "bluetooth.advertiseUidBuffer|param|power": "power level between 0 and 7, eg: 7",
  "bluetooth.advertiseUid|param|connectable": "true to keep bluetooth connectable for other services, false otherwise.",
  "bluetooth.advertiseUid|param|instance": "4 last bytes of the instance uid",
  "bluetooth.advertiseUid|param|ns": "4 last bytes of the namespace uid",
  "bluetooth.advertiseUid|param|power": "power level between 0 and 7, eg: 7",
  "bluetooth.advertiseUrl": "Advertise an Eddystone URL",
-  "bluetooth.advertiseUrl|param|power": "power level between 0 and 7, e.g.: 7",
+  "bluetooth.advertiseUrl|param|connectable": "true to keep bluetooth connectable for other services, false otherwise.",
-  "bluetooth.advertiseUrl|param|url": "the url to transmit. Must be no longer than the supported eddystone url length",
+  "bluetooth.advertiseUrl|param|power": "power level between 0 and 7, eg: 7",
  "bluetooth.advertiseUrl|param|url": "the url to transmit. Must be no longer than the supported eddystone url length, eg: \"https://pxt.io/\"",
  "bluetooth.onBluetoothConnected": "Register code to run when the micro:bit is connected to over Bluetooth",
  "bluetooth.onBluetoothConnected|param|body": "Code to run when a Bluetooth connection is established",
  "bluetooth.onBluetoothDisconnected": "Register code to run when a bluetooth connection to the micro:bit is lost",
  "bluetooth.onBluetoothDisconnected|param|body": "Code to run when a Bluetooth connection is lost",
  "bluetooth.setTransmitPower": "Sets the bluetooth transmit power between 0 (minimal) and 7 (maximum).",
  "bluetooth.setTransmitPower|param|power": "power level between 0 (minimal) and 7 (maximum), eg: 7.",
  "bluetooth.startAccelerometerService": "Starts the Bluetooth accelerometer service",
  "bluetooth.startButtonService": "Starts the Bluetooth button service",
  "bluetooth.startIOPinService": "Starts the Bluetooth IO pin service.",
--- a/libs/bluetooth/_locales/bluetooth-strings.json
+++ b/libs/bluetooth/_locales/bluetooth-strings.json
@ -1,7 +1,9 @@
 {
-  "bluetooth.advertiseUrl|block": "bluetooth advertise url %url|with power %power",
+  "bluetooth.advertiseUid|block": "bluetooth advertise UID|namespace (bytes 6-9)%ns|instance (bytes 2-6)%instance|with power %power|connectable %connectable",
  "bluetooth.advertiseUrl|block": "bluetooth advertise url %url|with power %power|connectable %connectable",
  "bluetooth.onBluetoothConnected|block": "on bluetooth connected",
  "bluetooth.onBluetoothDisconnected|block": "on bluetooth disconnected",
  "bluetooth.setTransmitPower|block": "bluetooth set transmit power %power",
  "bluetooth.startAccelerometerService|block": "bluetooth accelerometer service",
  "bluetooth.startButtonService|block": "bluetooth button service",
  "bluetooth.startIOPinService|block": "bluetooth io pin service",
--- a/libs/bluetooth/bluetooth.cpp
+++ b/libs/bluetooth/bluetooth.cpp
@ -7,7 +7,7 @@ using namespace pxt;
 /**
 * Support for additional Bluetooth services.
 */
-//% color=#0082FB weight=20
+//% color=#0082FB weight=20 icon="\uf294"
 namespace bluetooth {
    MicroBitUARTService *uart = NULL;
@ -121,18 +121,48 @@ namespace bluetooth {
    } 
    const int8_t CALIBRATED_POWERS[] = {-49, -37, -33, -28, -25, -20, -15, -10};
    /**
    * Advertise an Eddystone URL
-	* @param url the url to transmit. Must be no longer than the supported eddystone url length
+	* @param url the url to transmit. Must be no longer than the supported eddystone url length, eg: "https://pxt.io/"
-	* @param power power level between 0 and 7, e.g.: 7
+	* @param power power level between 0 and 7, eg: 7
    * @param connectable true to keep bluetooth connectable for other services, false otherwise.
    */
-    //% blockId=eddystone_advertise_url block="bluetooth advertise url %url|with power %power"
+    //% blockId=eddystone_advertise_url block="bluetooth advertise url %url|with power %power|connectable %connectable"
    //% parts=bluetooth weight=11 blockGap=8
-    //% help=bluetooth/advertise-url
+    //% help=bluetooth/advertise-url blockExternalInputs=1
-    void advertiseUrl(StringData* url, int power) {
+    void advertiseUrl(StringData* url, int power, bool connectable) {
-        int8_t level = CALIBRATED_POWERS[min(7, max(0, power))];
+        power = min(MICROBIT_BLE_POWER_LEVELS-1, max(0, power));
-        uBit.bleManager.advertiseEddystoneUrl(ManagedString(url), level);
+        int8_t level = CALIBRATED_POWERS[power];
        uBit.bleManager.advertiseEddystoneUrl(ManagedString(url), level, connectable);
        uBit.bleManager.setTransmitPower(power);
    }
    /**
    * Advertise an Eddystone UID
 	* @param nsAndInstance 16 bytes buffer of namespace (bytes 0-9) and instance (bytes 10-15)
 	* @param power power level between 0 and 7, eg: 7
    * @param connectable true to keep bluetooth connectable for other services, false otherwise.
    */
    //% parts=bluetooth weight=12 advanced=true
    void advertiseUidBuffer(Buffer nsAndInstance, int power, bool connectable) {
        ManagedBuffer buf(nsAndInstance);
        if (buf.length() != 16) return;
        power = min(MICROBIT_BLE_POWER_LEVELS-1, max(0, power));
        int8_t level = CALIBRATED_POWERS[power];
        uint8_t uidNs[10]; buf.readBytes(uidNs, 0, 10);
        uint8_t uidInst[6]; buf.readBytes(uidInst, 10, 6);
        uBit.bleManager.advertiseEddystoneUid((const char*)uidNs, (const char*)uidInst, level, connectable);
    }
    /**
    * Sets the bluetooth transmit power between 0 (minimal) and 7 (maximum).
    * @param power power level between 0 (minimal) and 7 (maximum), eg: 7.
    */
    //% parts=bluetooth weight=5 help=bluetooth/set-transmit-power advanced=true
    //% blockId=bluetooth_settransmitpower block="bluetooth set transmit power %power"
    void setTransmitPower(int power) {
        uBit.bleManager.setTransmitPower(min(MICROBIT_BLE_POWER_LEVELS-1, max(0, power)));
    }
    /**
@ -140,7 +170,7 @@ namespace bluetooth {
    */
    //% blockId=eddystone_stop_advertising block="bluetooth stop advertising"
    //% parts=bluetooth weight=10
-    //% help=bluetooth/stop-advertising
+    //% help=bluetooth/stop-advertising advanced=true
    void stopAdvertising() {
        uBit.bleManager.stopAdvertising();
    } 
--- a/libs/bluetooth/bluetooth.ts
+++ b/libs/bluetooth/bluetooth.ts
@ -1,7 +1,7 @@
 /**
 * Support for additional Bluetooth services.
 */
-//% color=#0082FB weight=20
+//% color=#0082FB weight=20 icon="\uf294"
 namespace bluetooth {
    /**
    *  Writes to the Bluetooth UART service buffer. From there the data is transmitted over Bluetooth to a connected device.
@ -46,4 +46,21 @@ namespace bluetooth {
        // dummy implementation for simulator
        return "???"
    }
    /**
    * Advertise an Eddystone UID
    * @param ns 4 last bytes of the namespace uid
    * @param instance 4 last bytes of the instance uid
    * @param power power level between 0 and 7, eg: 7
    * @param connectable true to keep bluetooth connectable for other services, false otherwise.
    */
    //% blockId=eddystone_advertise_uid block="bluetooth advertise UID|namespace (bytes 6-9)%ns|instance (bytes 2-6)%instance|with power %power|connectable %connectable"
    //% parts=bluetooth weight=12 blockGap=8
    //% help=bluetooth/advertise-uid blockExternalInputs=1
    export function advertiseUid(ns: number, instance: number, power: number, connectable: boolean) {
        const buf = pins.createBuffer(16);
        buf.setNumber(NumberFormat.Int32BE, 6, ns);
        buf.setNumber(NumberFormat.Int32BE, 12, instance);
        bluetooth.advertiseUidBuffer(buf, power, connectable);
    }
 }
--- a/libs/bluetooth/pxt.json
+++ b/libs/bluetooth/pxt.json
@ -24,41 +24,56 @@
            "microbit-dal": {
                "bluetooth": {
                    "private_addressing": 0,
                    "whitelist": 1,
                    "advertising_timeout": 0,
                    "tx_power": 6,
                    "dfu_service": 1,
                    "event_service": 1,
                    "device_info_service": 1,
                    "eddystone_url": 1,
-                    "eddystone_uid": 0,
+                    "eddystone_uid": 1,
                    "pairing_mode": 1,
                    "open": 0,
-                    "security_level": "SECURITY_MODE_ENCRYPTION_WITH_MITM"
+                    "pairing_mode": 1,
-                }
+                    "whitelist": 1,
                    "security_level": "SECURITY_MODE_ENCRYPTION_NO_MITM"
                },
                "gatt_table_size": "0x700"
            }
        },
        "userConfigs": [
            {
-                "description": "No pairing: Anyone can connect via Bluetooth.",
+                "description": "Unsecure: Anyone can connect via Bluetooth.",
                "config": {
                    "microbit-dal": {
                        "bluetooth": {
                            "open": 1,
-                            "pairing_mode": null,
+                            "pairing_mode": 0,                            
                            "whitelist": 0,
                            "security_level": null
                        }
                    }
                }
            },
            {
-                "description": "Passkey pairing: Button press and 6 digit key to pair via Bluetooth.",
+                "description": "JustWorks pairing (default): Button press to pair.",
                "config": {
                    "microbit-dal": {
                        "bluetooth": {
                            "open": null,
                            "pairing_mode": null,
                            "whitelist": null,
                            "security_level": null
                        }
                    }
                }
            },
            {
                "description": "Passkey pairing: Button press and 6 digit key to pair.",
                "config": {
                    "microbit-dal": {
                        "bluetooth": {
                            "open": 0,
                            "pairing_mode": 1,
                            "whitelist": 1,
                            "security_level": "SECURITY_MODE_ENCRYPTION_WITH_MITM"
                        }
                    }
--- a/libs/bluetooth/shims.d.ts
+++ b/libs/bluetooth/shims.d.ts
@ -4,7 +4,7 @@
    /**
     * Support for additional Bluetooth services.
     */
-    //% color=#0082FB weight=20
+    //% color=#0082FB weight=20 icon="\uf294"
 declare namespace bluetooth {
    /**
@ -83,20 +83,38 @@ declare namespace bluetooth {
    /**
     * Advertise an Eddystone URL
-     * @param url the url to transmit. Must be no longer than the supported eddystone url length
+     * @param url the url to transmit. Must be no longer than the supported eddystone url length, eg: "https://pxt.io/"
-     * @param power power level between 0 and 7, e.g.: 7
+     * @param power power level between 0 and 7, eg: 7
     * @param connectable true to keep bluetooth connectable for other services, false otherwise.
     */
-    //% blockId=eddystone_advertise_url block="bluetooth advertise url %url|with power %power"
+    //% blockId=eddystone_advertise_url block="bluetooth advertise url %url|with power %power|connectable %connectable"
    //% parts=bluetooth weight=11 blockGap=8
-    //% help=bluetooth/advertise-url shim=bluetooth::advertiseUrl
+    //% help=bluetooth/advertise-url blockExternalInputs=1 shim=bluetooth::advertiseUrl
-    function advertiseUrl(url: string, power: number): void;
+    function advertiseUrl(url: string, power: number, connectable: boolean): void;
    /**
     * Advertise an Eddystone UID
     * @param nsAndInstance 16 bytes buffer of namespace (bytes 0-9) and instance (bytes 10-15)
     * @param power power level between 0 and 7, eg: 7
     * @param connectable true to keep bluetooth connectable for other services, false otherwise.
     */
    //% parts=bluetooth weight=12 advanced=true shim=bluetooth::advertiseUidBuffer
    function advertiseUidBuffer(nsAndInstance: Buffer, power: number, connectable: boolean): void;
    /**
     * Sets the bluetooth transmit power between 0 (minimal) and 7 (maximum).
     * @param power power level between 0 (minimal) and 7 (maximum), eg: 7.
     */
    //% parts=bluetooth weight=5 help=bluetooth/set-transmit-power advanced=true
    //% blockId=bluetooth_settransmitpower block="bluetooth set transmit power %power" shim=bluetooth::setTransmitPower
    function setTransmitPower(power: number): void;
    /**
     * Stops advertising Eddystone end points
     */
    //% blockId=eddystone_stop_advertising block="bluetooth stop advertising"
    //% parts=bluetooth weight=10
-    //% help=bluetooth/stop-advertising shim=bluetooth::stopAdvertising
+    //% help=bluetooth/stop-advertising advanced=true shim=bluetooth::stopAdvertising
    function stopAdvertising(): void;
 }
--- a/libs/bluetoothprj/main.blocks
+++ b/libs/bluetoothprj/main.blocks
@ -1,62 +1,3 @@
 <xml xmlns="http://www.w3.org/1999/xhtml">
-<block type="device_forever">
+  <block type="pxt-on-start"></block>
 <statement name="HANDLER">
 <block type="device_show_leds">
 <field name="LED00">FALSE</field>
 <field name="LED10">FALSE</field>
 <field name="LED20">FALSE</field>
 <field name="LED30">FALSE</field>
 <field name="LED40">FALSE</field>
 <field name="LED01">FALSE</field>
 <field name="LED11">TRUE</field>
 <field name="LED21">FALSE</field>
 <field name="LED31">TRUE</field>
 <field name="LED41">FALSE</field>
 <field name="LED02">FALSE</field>
 <field name="LED12">FALSE</field>
 <field name="LED22">FALSE</field>
 <field name="LED32">FALSE</field>
 <field name="LED42">FALSE</field>
 <field name="LED03">TRUE</field>
 <field name="LED13">FALSE</field>
 <field name="LED23">FALSE</field>
 <field name="LED33">FALSE</field>
 <field name="LED43">TRUE</field>
 <field name="LED04">FALSE</field>
 <field name="LED14">TRUE</field>
 <field name="LED24">TRUE</field>
 <field name="LED34">TRUE</field>
 <field name="LED44">FALSE</field>
 <next>
 <block type="device_show_leds">
 <field name="LED00">FALSE</field>
 <field name="LED10">FALSE</field>
 <field name="LED20">FALSE</field>
 <field name="LED30">FALSE</field>
 <field name="LED40">FALSE</field>
 <field name="LED01">FALSE</field>
 <field name="LED11">FALSE</field>
 <field name="LED21">FALSE</field>
 <field name="LED31">FALSE</field>
 <field name="LED41">FALSE</field>
 <field name="LED02">FALSE</field>
 <field name="LED12">FALSE</field>
 <field name="LED22">FALSE</field>
 <field name="LED32">FALSE</field>
 <field name="LED42">FALSE</field>
 <field name="LED03">FALSE</field>
 <field name="LED13">FALSE</field>
 <field name="LED23">FALSE</field>
 <field name="LED33">FALSE</field>
 <field name="LED43">FALSE</field>
 <field name="LED04">FALSE</field>
 <field name="LED14">FALSE</field>
 <field name="LED24">FALSE</field>
 <field name="LED34">FALSE</field>
 <field name="LED44">FALSE</field>
 </block>
 </next>
 </block>
 </statement>
 </block>
 </xml>
--- a/libs/bluetoothprj/main.ts
+++ b/libs/bluetoothprj/main.ts
@ -1,16 +1 @@
-basic.forever(() => {
+
    basic.showLeds(`
        . # . # .
        # . # . #
        # . . . #
        . # . # .
        . . # . .
        `)
    basic.showLeds(`
        . . . . .
        . . . . .
        . . . . .
        . . . . .
        . . . . .
        `)
 })
--- a/libs/core/_locales/core-jsdoc-strings.json
+++ b/libs/core/_locales/core-jsdoc-strings.json
@ -85,7 +85,7 @@
  "game.setLife": "Sets the current life value",
  "game.setLife|param|value": "TODO",
  "game.setScore": "Sets the current score value",
-  "game.setScore|param|value": "TODO",
+  "game.setScore|param|value": "new score value.",
  "game.showScore": "Displays the score on the screen.",
  "game.startCountdown": "Starts a game countdown timer",
  "game.startCountdown|param|ms": "countdown duration in milliseconds, eg: 10000",
@ -97,26 +97,28 @@
  "input.acceleration": "Get the acceleration value in milli-gravitys (when the board is laying flat with the screen up, x=0, y=0 and z=-1024)",
  "input.acceleration|param|dimension": "TODO",
  "input.buttonIsPressed": "Get the button state (pressed or not) for ``A`` and ``B``.",
  "input.buttonIsPressed|param|button": "the button to query the request, eg: Button.A",
  "input.calibrate": "Obsolete, compass calibration is automatic.",
  "input.compassHeading": "Get the current compass heading in degrees.",
  "input.lightLevel": "Reads the light level applied to the LED screen in a range from ``0`` (dark) to ``255`` bright.",
  "input.magneticForce": "Get the magnetic force value in ``micro-Teslas`` (``µT``). This function is not supported in the simulator.",
  "input.magneticForce|param|dimension": "TODO",
  "input.onButtonPressed": "Do something when a button (``A``, ``B`` or both ``A+B``) is pressed",
-  "input.onButtonPressed|param|body": "TODO",
+  "input.onButtonPressed|param|body": "code to run when event is raised",
-  "input.onButtonPressed|param|button": "TODO",
+  "input.onButtonPressed|param|button": "the button that needs to be pressed",
  "input.onGesture": "Do something when when a gesture is done (like shaking the micro:bit).",
-  "input.onGesture|param|body": "TODO",
+  "input.onGesture|param|body": "code to run when gesture is raised",
  "input.onGesture|param|gesture": "the type of gesture to track, eg: Gesture.Shake",
  "input.onLogoDown": "Attaches code to run when the logo is oriented downwards and the board is vertical.",
  "input.onLogoDown|param|body": "TODO",
  "input.onLogoUp": "Attaches code to run when the logo is oriented upwards and the board is vertical.",
  "input.onLogoUp|param|body": "TODO",
  "input.onPinPressed": "Do something when a pin is pressed.",
  "input.onPinPressed|param|body": "the code to run when the pin is pressed",
-  "input.onPinPressed|param|name": "the pin that needs to be pressed",
+  "input.onPinPressed|param|name": "the pin that needs to be pressed, eg: TouchPin.P0",
  "input.onPinReleased": "Do something when a pin is released.",
  "input.onPinReleased|param|body": "the code to run when the pin is released",
-  "input.onPinReleased|param|name": "the pin that needs to be released",
+  "input.onPinReleased|param|name": "the pin that needs to be released, eg: TouchPin.P0",
  "input.onScreenDown": "Attaches code to run when the screen is facing down.",
  "input.onScreenDown|param|body": "TODO",
  "input.onScreenUp": "Attaches code to run when the screen is facing up.",
@ -124,7 +126,7 @@
  "input.onShake": "Attaches code to run when the device is shaken.",
  "input.onShake|param|body": "TODO",
  "input.pinIsPressed": "Get the pin state (pressed or not). Requires to hold the ground to close the circuit.",
-  "input.pinIsPressed|param|name": "pin used to detect the touch",
+  "input.pinIsPressed|param|name": "pin used to detect the touch, eg: TouchPin.P0",
  "input.rotation": "The pitch or roll of the device, rotation along the ``x-axis`` or ``y-axis``, in degrees.",
  "input.rotation|param|kind": "TODO",
  "input.runningTime": "Gets the number of milliseconds elapsed since power on.",
@ -166,7 +168,7 @@
  "music.changeTempoBy": "Change the tempo by the specified amount",
  "music.changeTempoBy|param|bpm": "The change in beats per minute to the tempo, eg: 20",
  "music.noteFrequency": "Gets the frequency of a note.",
-  "music.noteFrequency|param|name": "the note name",
+  "music.noteFrequency|param|name": "the note name, eg: Note.C",
  "music.playTone": "Plays a tone through pin ``P0`` for the given duration.",
  "music.playTone|param|frequency": "pitch of the tone to play in Hertz (Hz)",
  "music.playTone|param|ms": "tone duration in milliseconds (ms)",
@ -182,21 +184,21 @@
  "pins.analogPitch|param|frequency": "frequency to modulate in Hz.",
  "pins.analogPitch|param|ms": "duration of the pitch in milli seconds.",
  "pins.analogReadPin": "Read the connector value as analog, that is, as a value comprised between 0 and 1023.",
-  "pins.analogReadPin|param|name": "pin to write to",
+  "pins.analogReadPin|param|name": "pin to write to, eg: AnalogPin.P0",
  "pins.analogSetPeriod": "Configures the Pulse-width modulation (PWM) of the analog output to the given value in **microseconds** or `1/1000` milliseconds.\nIf this pin is not configured as an analog output (using `analog write pin`), the operation has no effect.",
  "pins.analogSetPeriod|param|micros": "period in micro seconds. eg:20000",
-  "pins.analogSetPeriod|param|name": "analog pin to set period to",
+  "pins.analogSetPeriod|param|name": "analog pin to set period to, eg: AnalogPin.P0",
  "pins.analogSetPitchPin": "Sets the pin used when using `analog pitch` or music.",
  "pins.analogSetPitchPin|param|name": "pin to modulate pitch from",
  "pins.analogWritePin": "Set the connector value as analog. Value must be comprised between 0 and 1023.",
-  "pins.analogWritePin|param|name": "pin name to write to",
+  "pins.analogWritePin|param|name": "pin name to write to, eg: AnalogPin.P0",
  "pins.analogWritePin|param|value": "value to write to the pin between ``0`` and ``1023``. eg:1023,0",
  "pins.createBuffer": "Create a new zero-initialized buffer.",
  "pins.createBuffer|param|size": "number of bytes in the buffer",
  "pins.digitalReadPin": "Read the specified pin or connector as either 0 or 1",
-  "pins.digitalReadPin|param|name": "pin to read from",
+  "pins.digitalReadPin|param|name": "pin to read from, eg: DigitalPin.P0",
  "pins.digitalWritePin": "Set a pin or connector value to either 0 or 1.",
-  "pins.digitalWritePin|param|name": "pin to write to",
+  "pins.digitalWritePin|param|name": "pin to write to, eg: DigitalPin.P0",
  "pins.digitalWritePin|param|value": "value to set on the pin, 1 eg,0",
  "pins.i2cReadBuffer": "Read `size` bytes from a 7-bit I2C `address`.",
  "pins.i2cReadNumber": "Read one number from 7-bit I2C address.",
@ -209,19 +211,21 @@
  "pins.map|param|toLow": "the lower bound of the value's target range",
  "pins.map|param|value": "value to map in ranges",
  "pins.onPulsed": "Configures this pin to a digital input, and generates events where the timestamp is the duration that this pin was either ``high`` or ``low``.",
  "pins.onPulsed|param|name": "digital pin to register to, eg: DigitalPin.P0",
  "pins.onPulsed|param|pulse": "the value of the pulse, eg: PulseValue.High",
  "pins.pulseDuration": "Gets the duration of the last pulse in micro-seconds. This function should be called from a ``onPulsed`` handler.",
  "pins.pulseIn": "Returns the duration of a pulse in microseconds",
-  "pins.pulseIn|param|name": "the pin which measures the pulse",
+  "pins.pulseIn|param|name": "the pin which measures the pulse, eg: DigitalPin.P0",
-  "pins.pulseIn|param|value": "the value of the pulse (default high)",
+  "pins.pulseIn|param|value": "the value of the pulse, eg: PulseValue.High",
  "pins.servoSetPulse": "Configures this IO pin as an analog/pwm output, configures the period to be 20 ms, and sets the pulse width, based on the value it is given **microseconds** or `1/1000` milliseconds.",
  "pins.servoSetPulse|param|micros": "pulse duration in micro seconds, eg:1500",
  "pins.servoSetPulse|param|name": "pin name",
  "pins.servoWritePin": "Writes a value to the servo, controlling the shaft accordingly. On a standard servo, this will set the angle of the shaft (in degrees), moving the shaft to that orientation. On a continuous rotation servo, this will set the speed of the servo (with ``0`` being full-speed in one direction, ``180`` being full speed in the other, and a value near ``90`` being no movement).",
-  "pins.servoWritePin|param|name": "pin to write to",
+  "pins.servoWritePin|param|name": "pin to write to, eg: AnalogPin.P0",
  "pins.servoWritePin|param|value": "angle or rotation speed, eg:180,90,0",
  "pins.setPull": "Configures the pull of this pin.",
-  "pins.setPull|param|name": "pin to set the pull mode on",
+  "pins.setPull|param|name": "pin to set the pull mode on, eg: DigitalPin.P0",
-  "pins.setPull|param|pull": "one of the mbed pull configurations: PullUp, PullDown, PullNone ",
+  "pins.setPull|param|pull": "one of the mbed pull configurations, eg: PinPullMode.PullUp",
  "pins.sizeOf": "Get the size in bytes of specified number format.",
  "pins.spiWrite": "Write to the SPI slave and return the response",
  "pins.spiWrite|param|value": "Data to be sent to the SPI slave",
@ -232,8 +236,9 @@
  "serial.readUntil": "Reads a line of text from the serial port and returns the buffer when the delimiter is met.",
  "serial.readUntil|param|delimiter": "text delimiter that separates each text chunk",
  "serial.redirect": "Dynamically configuring the serial instance to use pins other than USBTX and USBRX.",
-  "serial.redirect|param|rx": "the new reception pin",
+  "serial.redirect|param|rate": "the new baud rate. eg: 115200",
-  "serial.redirect|param|tx": "the new transmission pins",
+  "serial.redirect|param|rx": "the new reception pin, eg: SerialPin.P1",
  "serial.redirect|param|tx": "the new transmission pins, eg: SerialPin.P0",
  "serial.writeLine": "Prints a line of text to the serial",
  "serial.writeNumber": "Prints a numeric value to the serial",
  "serial.writeString": "Sends a piece of text through Serial connection.",
--- a/libs/core/_locales/core-strings.json
+++ b/libs/core/_locales/core-strings.json
@ -9,6 +9,8 @@
  "AcceleratorRange.TwoG|block": "2g",
  "BaudRate.BaudRate115200|block": "115200",
  "BaudRate.BaudRate9600|block": "9600",
  "BeatFraction.Breve|block": "4",
  "BeatFraction.Double|block": "2",
  "BeatFraction.Eighth|block": "1/8",
  "BeatFraction.Half|block": "1/2",
  "BeatFraction.Quarter|block": "1/4",
@ -31,6 +33,8 @@
  "DisplayMode.Greyscale|block": "greyscale",
  "EventCreationMode.CreateAndFire": "MicroBitEvent is initialised, and its event handlers are immediately fired (not suitable for use in interrupts!).",
  "EventCreationMode.CreateOnly": "MicroBitEvent is initialised, and no further processing takes place.",
  "Gesture.EightG": "Raised when a 8G shock is detected",
  "Gesture.EightG|block": "8g",
  "Gesture.FreeFall": "Raised when the board is falling!",
  "Gesture.FreeFall|block": "free fall",
  "Gesture.LogoDown": "Raised when the logo is downward and the screen is vertical",
@ -108,6 +112,7 @@
  "game.createSprite|block": "create sprite at|x: %x|y: %y",
  "game.gameOver|block": "game over",
  "game.score|block": "score",
  "game.setScore|block": "set score %points",
  "game.startCountdown|block": "start countdown|(ms) %duration",
  "game|block": "game",
  "images.createBigImage|block": "create big image",
@ -120,7 +125,7 @@
  "input.magneticForce|block": "magnetic force (µT)|%NAME",
  "input.onButtonPressed|block": "on button|%NAME|pressed",
  "input.onGesture|block": "on |%NAME",
-  "input.onPinPressed|block": "on pin %NAME|pressed",
+  "input.onPinPressed|block": "on pin %name|pressed",
  "input.onPinReleased|block": "on pin %NAME|released",
  "input.pinIsPressed|block": "pin %NAME|is pressed",
  "input.rotation|block": "rotation (°)|%NAME",
@ -129,6 +134,7 @@
  "input.temperature|block": "temperature (°C)",
  "input|block": "input",
  "led.brightness|block": "brightness",
  "led.enable|block": "led enable %on",
  "led.plotBarGraph|block": "plot bar graph of %value |up to %high",
  "led.plot|block": "plot|x %x|y %y",
  "led.point|block": "point|x %x|y %y",
--- a/libs/core/basic.cpp
+++ b/libs/core/basic.cpp
@ -4,7 +4,7 @@
 /**
 * Provides access to basic micro:bit functionality.
 */
-//% color=#0078D7 weight=100
+//% color=#0078D7 weight=100 icon="\uf00a"
 namespace basic {
    /**
@ -13,7 +13,7 @@ namespace basic {
     */
    //% help=basic/show-number
    //% weight=96
-    //% blockId=device_show_number block="show|number %number" blockGap=8 icon="\uf1ec"
+    //% blockId=device_show_number block="show|number %number" blockGap=8
    //% async
    //% parts="ledmatrix"
    void showNumber(int value, int interval = 150) { 
@ -50,7 +50,7 @@ namespace basic {
     */
    //% help=basic/show-string 
    //% weight=87 blockGap=8
-    //% block="show|string %text" icon="\uf031" 
+    //% block="show|string %text" 
    //% async
    //% blockId=device_print_message
    //% parts="ledmatrix"
@ -73,7 +73,7 @@ namespace basic {
     * Turn off all LEDs
     */
    //% help=basic/clear-screen weight=79
-    //% blockId=device_clear_display block="clear screen" icon="\uf12d"
+    //% blockId=device_clear_display block="clear screen"
    //% parts="ledmatrix"
    void clearScreen() {
      uBit.display.image.clear();
@ -112,7 +112,7 @@ namespace basic {
     * Repeats the code forever in the background. On each iteration, allows other codes to run.
     * @param body code to execute
     */
-    //% help=basic/forever weight=55 blockGap=8
+    //% help=basic/forever weight=55 blockGap=8 blockAllowMultiple=1
    //% blockId=device_forever block="forever" icon="\uf01e"
    void forever(Action a) {
      if (a != 0) {
--- a/libs/core/control.cpp
+++ b/libs/core/control.cpp
@ -121,7 +121,7 @@ namespace control {
    /**
     * Schedules code that run in the background.
     */
-    //% help=control/in-background
+    //% help=control/in-background blockAllowMultiple=1
    //% blockId="control_in_background" block="run in background" blockGap=8
    void inBackground(Action a) {
      runInBackground(a);
--- a/libs/core/control.ts
+++ b/libs/core/control.ts
@ -1,7 +1,7 @@
 /**
 * Runtime and event utilities.
 */
-//% weight=1 color="#333333"
+//% weight=1 color="#333333" icon="\uf233"
 //% advanced=true
 namespace control {
--- a/libs/core/core.cpp
+++ b/libs/core/core.cpp
@ -153,14 +153,20 @@ namespace Array_ {
    //%
    int length(RefCollection *c) { return c->length(); }
    //%
    void setLength(RefCollection *c, int newLength) { c->setLength(newLength); }    
    //%
    void push(RefCollection *c, uint32_t x) { c->push(x); }
    //%
    uint32_t pop(RefCollection *c) { return c->pop(); }    
    //%
    uint32_t getAt(RefCollection *c, int x) { return c->getAt(x); }
    //%
    void removeAt(RefCollection *c, int x) { c->removeAt(x); }
    //%
    void setAt(RefCollection *c, int x, uint32_t y) { c->setAt(x, y); }    
    //%
    uint32_t removeAt(RefCollection *c, int x) { return c->removeAt(x); }
    //%
    void insertAt(RefCollection *c, int x, uint32_t value) { c->insertAt(x, value); }    
    //%
    int indexOf(RefCollection *c, uint32_t x, int start) { return c->indexOf(x, start); }
    //%
    int removeElement(RefCollection *c, uint32_t x) { return c->removeElement(x); }
--- a/libs/core/enums.d.ts
+++ b/libs/core/enums.d.ts
@ -115,6 +115,11 @@ declare namespace basic {
     */
    //% block="6g"
    SixG = 9,  // MICROBIT_ACCELEROMETER_EVT_6G
    /**
     * Raised when a 8G shock is detected
     */
    //% block="8g"
    EightG = 10,  // MICROBIT_ACCELEROMETER_EVT_8G
    }
 declare namespace input {
 }
--- a/libs/core/game.ts
+++ b/libs/core/game.ts
@ -21,7 +21,7 @@ enum LedSpriteProperty {
 /**
 * A single-LED sprite game engine
 */
-//% color=#008272 weight=32
+//% color=#008272 weight=32 icon="\uf11b"
 //% advanced=true
 namespace game {
    let _score: number = 0;
@ -40,7 +40,7 @@ namespace game {
     * @param x sprite horizontal coordinate, eg: 2
     * @param y sprite vertical coordinate, eg: 2
     */
-    //% weight=60
+    //% weight=60 blockGap=8
    //% blockId=game_create_sprite block="create sprite at|x: %x|y: %y"
    //% parts="ledmatrix"
    export function createSprite(x: number, y: number): LedSprite {
@ -146,8 +146,9 @@ namespace game {
    /**
     * Sets the current score value
-     * @param value TODO
+     * @param value new score value.
     */
    //% blockId=game_set_score block="set score %points" blockGap=8
    //% weight=10 help=game/set-score
    export function setScore(value: number): void {
        _score = Math.max(0, value);
@ -589,7 +590,7 @@ namespace game {
        /**
         * Turns on the sprite (on by default)
-         * @param this TODO
+         * @param this the sprite
         */
        public on(): void {
            this.setBrightness(255);
@ -597,7 +598,7 @@ namespace game {
        /**
         * Turns off the sprite (on by default)
-         * @param this TODO
+         * @param this the sprite
         */
        public off(): void {
            this.setBrightness(0);
@ -605,8 +606,8 @@ namespace game {
        /**
         * Set the ``brightness`` of a sprite
-         * @param this TODO
+         * @param this the sprite
-         * @param brightness TODO
+         * @param brightness the brightness from 0 (off) to 255 (on), eg: 255.
         */
        //% parts="ledmatrix"
        public setBrightness(brightness: number): void {
@ -616,8 +617,9 @@ namespace game {
        /**
         * Reports the ``brightness` of a sprite on the LED screen
-         * @param this TODO
+         * @param this the sprite
         */
        //% parts="ledmatrix"
        public brightness(): number {
            let r: number;
            return this._brightness;
@ -625,8 +627,8 @@ namespace game {
        /**
         * Changes the ``y`` position by the given amount
-         * @param this TODO
+         * @param this the sprite
-         * @param value TODO
+         * @param value the value to change brightness
         */
        public changeBrightnessBy(value: number): void {
            this.setBrightness(this._brightness + value);
@ -643,10 +645,12 @@ namespace game {
        /**
         * Deletes the sprite from the game engine. All further operation of the sprite will not have any effect.
-         * @param sprite TODO
+         * @param this sprite to delete
         */
-        public delete(sprite: LedSprite): void {
+        //% weight=59
-            sprites.removeElement(sprite);
+        //% blockId="game_delete_sprite" block="delete %this"        
        public delete(): void {
            sprites.removeElement(this);
        }
        /**
--- a/libs/core/images.cpp
+++ b/libs/core/images.cpp
@ -3,7 +3,7 @@
 /**
 * Creation, manipulation and display of LED images.
 */
-//% color=#5C2D91 weight=31
+//% color=#5C2D91 weight=31 icon="\uf03e"
 //% advanced=true
 namespace images {
    /**
--- a/libs/core/input.cpp
+++ b/libs/core/input.cpp
@ -104,18 +104,23 @@ enum class Gesture {
    * Raised when a 6G shock is detected
    */
    //% block="6g"
-    SixG = MICROBIT_ACCELEROMETER_EVT_6G
+    SixG = MICROBIT_ACCELEROMETER_EVT_6G,
    /**
    * Raised when a 8G shock is detected
    */
    //% block="8g"
    EightG = MICROBIT_ACCELEROMETER_EVT_8G
 };
-//% color=300 weight=99
+//% color=300 weight=99 icon="\uf192"
 namespace input {
    /**
     * Do something when a button (``A``, ``B`` or both ``A+B``) is pressed
-     * @param button TODO
+     * @param button the button that needs to be pressed
-     * @param body TODO
+     * @param body code to run when event is raised
     */
    //% help=input/on-button-pressed weight=85 blockGap=8
-    //% blockId=device_button_event block="on button|%NAME|pressed" icon="\uf192"
+    //% blockId=device_button_event block="on button|%NAME|pressed"
    //% parts="buttonpair"
    void onButtonPressed(Button button, Action body) {
        registerWithDal((int)button, MICROBIT_BUTTON_EVT_CLICK, body);
@ -123,26 +128,28 @@ namespace input {
    /**
     * Do something when when a gesture is done (like shaking the micro:bit).
-     * @param body TODO
+     * @param gesture the type of gesture to track, eg: Gesture.Shake
     * @param body code to run when gesture is raised
     */
    //% help=input/on-gesture weight=84 blockGap=8
-    //% blockId=device_gesture_event block="on |%NAME" icon="\uf135"
+    //% blockId=device_gesture_event block="on |%NAME"
    //% parts="accelerometer"
    void onGesture(Gesture gesture, Action body) {
-        if ((int)gesture == MICROBIT_ACCELEROMETER_EVT_3G && uBit.accelerometer.getRange() < 3)
+        int gi = (int)gesture;
        if (gi == MICROBIT_ACCELEROMETER_EVT_3G && uBit.accelerometer.getRange() < 3)
            uBit.accelerometer.setRange(4);
-        else if ((int)gesture == MICROBIT_ACCELEROMETER_EVT_6G && uBit.accelerometer.getRange() < 6)
+        else if ((gi == MICROBIT_ACCELEROMETER_EVT_6G || gi == MICROBIT_ACCELEROMETER_EVT_8G) && uBit.accelerometer.getRange() < 6)
            uBit.accelerometer.setRange(8);
-        registerWithDal(MICROBIT_ID_GESTURE, (int)gesture, body);
+        registerWithDal(MICROBIT_ID_GESTURE, gi, body);
    }
     /**
     * Do something when a pin is pressed.
-     * @param name the pin that needs to be pressed
+     * @param name the pin that needs to be pressed, eg: TouchPin.P0
     * @param body the code to run when the pin is pressed
     */
    //% help=input/on-pin-pressed weight=83
-    //% blockId=device_pin_event block="on pin %NAME|pressed" icon="\uf094"
+    //% blockId=device_pin_event block="on pin %name|pressed"
    void onPinPressed(TouchPin name, Action body) {
        auto pin = getPin((int)name);
        if (!pin) return;
@ -154,11 +161,11 @@ namespace input {
    /**
     * Do something when a pin is released.
-     * @param name the pin that needs to be released
+     * @param name the pin that needs to be released, eg: TouchPin.P0
     * @param body the code to run when the pin is released
     */
    //% help=input/on-pin-released weight=6 blockGap=8
-    //% blockId=device_pin_released block="on pin %NAME|released" icon="\uf094"
+    //% blockId=device_pin_released block="on pin %NAME|released"
    //% advanced=true
    void onPinReleased(TouchPin name, Action body) {
        auto pin = getPin((int)name);
@ -171,6 +178,7 @@ namespace input {
    /**
     * Get the button state (pressed or not) for ``A`` and ``B``.
     * @param button the button to query the request, eg: Button.A
     */
    //% help=input/button-is-pressed weight=60
    //% block="button|%NAME|is pressed"
@ -189,10 +197,10 @@ namespace input {
    /**
     * Get the pin state (pressed or not). Requires to hold the ground to close the circuit.
-     * @param name pin used to detect the touch
+     * @param name pin used to detect the touch, eg: TouchPin.P0
     */
    //% help=input/pin-is-pressed weight=58
-    //% blockId="device_pin_is_pressed" block="pin %NAME|is pressed" icon="\uf094"
+    //% blockId="device_pin_is_pressed" block="pin %NAME|is pressed"
    //% blockGap=8
    bool pinIsPressed(TouchPin name) {
        auto pin = getPin((int)name);
@ -210,7 +218,7 @@ namespace input {
     * Get the acceleration value in milli-gravitys (when the board is laying flat with the screen up, x=0, y=0 and z=-1024)
     * @param dimension TODO
     */
-    //% help=input/acceleration weight=58 icon="\uf135"
+    //% help=input/acceleration weight=58
    //% blockId=device_acceleration block="acceleration (mg)|%NAME" blockGap=8
    //% parts="accelerometer"
    int acceleration(Dimension dimension) {
@ -227,7 +235,7 @@ namespace input {
     * Reads the light level applied to the LED screen in a range from ``0`` (dark) to ``255`` bright.
     */
    //% help=input/light-level weight=57
-    //% blockId=device_get_light_level block="light level" blockGap=8 icon="\uf185"
+    //% blockId=device_get_light_level block="light level" blockGap=8
    //% parts="ledmatrix"
    int lightLevel() {
        return uBit.display.readLightLevel();
@ -237,7 +245,7 @@ namespace input {
     * Get the current compass heading in degrees.
     */
    //% help=input/compass-heading
-    //% weight=56 icon="\uf14e"
+    //% weight=56
    //% blockId=device_heading block="compass heading (°)" blockGap=8
    //% parts="compass"
    int compassHeading() {
@ -248,7 +256,7 @@ namespace input {
    /**
     * Gets the temperature in Celsius degrees (°C).
     */
-    //% weight=55 icon="\uf06d"
+    //% weight=55
    //% help=input/temperature
    //% blockId=device_temperature block="temperature (°C)" blockGap=8
    //% parts="thermometer"
@ -261,7 +269,7 @@ namespace input {
     * @param kind TODO
     */
    //% help=input/rotation weight=52
-    //% blockId=device_get_rotation block="rotation (°)|%NAME" blockGap=8 icon="\uf197"
+    //% blockId=device_get_rotation block="rotation (°)|%NAME" blockGap=8
    //% parts="accelerometer" advanced=true
    int rotation(Rotation kind) {
      switch (kind) {
@ -276,7 +284,7 @@ namespace input {
     * @param dimension TODO
     */
    //% help=input/magnetic-force weight=51
-    //% blockId=device_get_magnetic_force block="magnetic force (µT)|%NAME" blockGap=8 icon="\uf076"
+    //% blockId=device_get_magnetic_force block="magnetic force (µT)|%NAME" blockGap=8
    //% parts="compass"
    //% advanced=true
    int magneticForce(Dimension dimension) {
@ -296,7 +304,7 @@ namespace input {
     * Gets the number of milliseconds elapsed since power on.
     */
    //% help=input/running-time weight=50
-    //% blockId=device_get_running_time block="running time (ms)" icon="\uf017"
+    //% blockId=device_get_running_time block="running time (ms)"
    //% advanced=true
    int runningTime() {
        return system_timer_current_time();
@ -313,7 +321,7 @@ namespace input {
     * @param range a value describe the maximum strengh of acceleration measured
     */
    //% help=input/set-accelerometer-range
-    //% blockId=device_set_accelerometer_range block="set accelerometer|range %range" icon="\uf135"
+    //% blockId=device_set_accelerometer_range block="set accelerometer|range %range"
    //% weight=5
    //% parts="accelerometer"
    //% advanced=true
--- a/libs/core/input.ts
+++ b/libs/core/input.ts
@ -1,7 +1,7 @@
 /**
 * Events and data from sensors
 */
-//% color=#B4009E weight=99
+//% color=#B4009E weight=99 icon="\uf192"
 namespace input {
    /**
     * Attaches code to run when the screen is facing up.
--- a/libs/core/led.cpp
+++ b/libs/core/led.cpp
@ -8,7 +8,7 @@ enum class DisplayMode_ {
    // TODO DISPLAY_MODE_BLACK_AND_WHITE_LIGHT_SENSE
 };
-//% color=3 weight=35
+//% color=3 weight=35 icon="\uf205"
 namespace led {
    /**
@ -17,7 +17,7 @@ namespace led {
     * @param y TODO
     */
    //% help=led/plot weight=78
-    //% blockId=device_plot block="plot|x %x|y %y" icon="\uf205" blockGap=8
+    //% blockId=device_plot block="plot|x %x|y %y" blockGap=8
    //% parts="ledmatrix"
    void plot(int x, int y) {
      uBit.display.image.setPixelValue(x, y, 1);
@ -29,7 +29,7 @@ namespace led {
     * @param y TODO
     */
    //% help=led/unplot weight=77
-    //% blockId=device_unplot block="unplot|x %x|y %y" icon="\uf204" blockGap=8
+    //% blockId=device_unplot block="unplot|x %x|y %y" blockGap=8
    //% parts="ledmatrix"
    void unplot(int x, int y) {
      uBit.display.image.setPixelValue(x, y, 0);
@ -41,7 +41,7 @@ namespace led {
     * @param y TODO
     */
    //% help=led/point weight=76
-    //% blockId=device_point block="point|x %x|y %y" icon="\uf10c"
+    //% blockId=device_point block="point|x %x|y %y"
    //% parts="ledmatrix"
    bool point(int x, int y) {
      int pix = uBit.display.image.getPixelValue(x, y);
@ -52,7 +52,7 @@ namespace led {
     * Get the screen brightness from 0 (off) to 255 (full bright).
     */
    //% help=led/brightness weight=60
-    //% blockId=device_get_brightness block="brightness" icon="\uf042" blockGap=8
+    //% blockId=device_get_brightness block="brightness" blockGap=8
    //% parts="ledmatrix"
    //% advanced=true
    int brightness() {
@ -64,7 +64,7 @@ namespace led {
     * @param value the brightness value, eg:255, 127, 0
     */
    //% help=led/set-brightness weight=59
-    //% blockId=device_set_brightness block="set brightness %value" icon="\uf042"
+    //% blockId=device_set_brightness block="set brightness %value"
    //% parts="ledmatrix"
    //% advanced=true
    void setBrightness(int value) {
@ -75,7 +75,7 @@ namespace led {
     * Cancels the current animation and clears other pending animations.
     */
    //% weight=50 help=led/stop-animation
-    //% blockId=device_stop_animation block="stop animation" icon="\uf04d"
+    //% blockId=device_stop_animation block="stop animation"
    //% parts="ledmatrix"
    //% advanced=true
    void stopAnimation() {
@ -95,7 +95,7 @@ namespace led {
    /**
    * Turns on or off the display    
    */
-    //% help=led/enable blockId=device_led_enable icon="\uf04d"
+    //% help=led/enable blockId=device_led_enable block="led enable %on"
    //% advanced=true parts="ledmatrix"
    void enable(bool on) {
        if (on) uBit.display.enable();
--- a/libs/core/led.ts
+++ b/libs/core/led.ts
@ -1,7 +1,7 @@
 /**
 * Control of the LED screen.
 */
-//% color=#5C2D91 weight=97
+//% color=#5C2D91 weight=97 icon="\uf205"
    namespace led {
    // what's the current high value
--- a/libs/core/music.ts
+++ b/libs/core/music.ts
@ -119,13 +119,17 @@ enum BeatFraction {
    //% block="1/8"
    Eighth = 8,
    //% block="1/16"
-    Sixteenth = 16
+    Sixteenth = 16,
    //% block="2"
    Double = 32,
    //% block="4",
    Breve = 64
 }
 /**
 * Generation of music tones through pin ``P0``.
 */
-//% color=#D83B01 weight=98
+//% color=#D83B01 weight=98 icon="\uf025"
 namespace music {
    let beatsPerMinute: number = 120;
@ -135,7 +139,7 @@ namespace music {
     * @param ms tone duration in milliseconds (ms)
     */
    //% help=music/play-tone weight=90
-    //% blockId=device_play_note block="play|tone %note=device_note|for %duration=device_beat" icon="\uf025" blockGap=8
+    //% blockId=device_play_note block="play|tone %note=device_note|for %duration=device_beat" blockGap=8
    //% parts="headphone"
    export function playTone(frequency: number, ms: number): void {
        pins.analogPitch(frequency, ms);
@ -146,7 +150,7 @@ namespace music {
     * @param frequency pitch of the tone to play in Hertz (Hz)
     */
    //% help=music/ring-tone weight=80
-    //% blockId=device_ring block="ring tone (Hz)|%note=device_note" icon="\uf025" blockGap=8
+    //% blockId=device_ring block="ring tone (Hz)|%note=device_note" blockGap=8
    //% parts="headphone"
    export function ringTone(frequency: number): void {
        pins.analogPitch(frequency, 0);
@ -166,7 +170,7 @@ namespace music {
    /**
     * Gets the frequency of a note.
-     * @param name the note name
+     * @param name the note name, eg: Note.C
     */
    //% weight=50 help=music/note-frequency
    //% blockId=device_note block="%note"
@ -188,11 +192,15 @@ namespace music {
        init();
        if (fraction == null) fraction = BeatFraction.Whole;
        let beat = 60000 / beatsPerMinute;
-        if (fraction == BeatFraction.Whole) return beat;
+        switch (fraction) {
-        else if (fraction == BeatFraction.Half) return beat / 2;
+            case BeatFraction.Half: return beat / 2;
-        else if (fraction == BeatFraction.Quarter) return beat / 4
+            case BeatFraction.Quarter: return beat / 4;
-        else if (fraction == BeatFraction.Eighth) return beat / 8;
+            case BeatFraction.Eighth: return beat / 8;
-        else return beat / 16;
+            case BeatFraction.Sixteenth: return beat / 16;
            case BeatFraction.Double: return beat * 2;
            case BeatFraction.Breve: return beat * 4;
            default: return beat;
        }
    }
    /**
--- a/libs/core/pins.cpp
+++ b/libs/core/pins.cpp
@ -92,7 +92,7 @@ namespace pins {
    /**
     * Read the specified pin or connector as either 0 or 1
-     * @param name pin to read from
+     * @param name pin to read from, eg: DigitalPin.P0
     */
    //% help=pins/digital-read-pin weight=30
    //% blockId=device_get_digital_pin block="digital read|pin %name" blockGap=8
@ -102,7 +102,7 @@ namespace pins {
    /**
      * Set a pin or connector value to either 0 or 1.
-      * @param name pin to write to
+      * @param name pin to write to, eg: DigitalPin.P0
      * @param value value to set on the pin, 1 eg,0
      */
    //% help=pins/digital-write-pin weight=29
@ -113,7 +113,7 @@ namespace pins {
    /**
     * Read the connector value as analog, that is, as a value comprised between 0 and 1023.
-     * @param name pin to write to
+     * @param name pin to write to, eg: AnalogPin.P0
     */
    //% help=pins/analog-read-pin weight=25
    //% blockId=device_get_analog_pin block="analog read|pin %name" blockGap="8" 
@ -123,7 +123,7 @@ namespace pins {
    /**
     * Set the connector value as analog. Value must be comprised between 0 and 1023.
-     * @param name pin name to write to
+     * @param name pin name to write to, eg: AnalogPin.P0
     * @param value value to write to the pin between ``0`` and ``1023``. eg:1023,0
     */
    //% help=pins/analog-write-pin weight=24
@ -135,7 +135,7 @@ namespace pins {
    /**
     * Configures the Pulse-width modulation (PWM) of the analog output to the given value in **microseconds** or `1/1000` milliseconds.
     * If this pin is not configured as an analog output (using `analog write pin`), the operation has no effect.
-     * @param name analog pin to set period to
+     * @param name analog pin to set period to, eg: AnalogPin.P0
     * @param micros period in micro seconds. eg:20000
     */
    //% help=pins/analog-set-period weight=23 blockGap=8
@ -146,6 +146,8 @@ namespace pins {
    /**
    * Configures this pin to a digital input, and generates events where the timestamp is the duration that this pin was either ``high`` or ``low``.
    * @param name digital pin to register to, eg: DigitalPin.P0
    * @param pulse the value of the pulse, eg: PulseValue.High
    */
    //% help=pins/on-pulsed weight=22 blockGap=8 advanced=true
    //% blockId=pins_on_pulsed block="on|pin %pin|pulsed %pulse"
@ -169,8 +171,8 @@ namespace pins {
    /**
    * Returns the duration of a pulse in microseconds
-    * @param name the pin which measures the pulse
+    * @param name the pin which measures the pulse, eg: DigitalPin.P0
-    * @param value the value of the pulse (default high)
+    * @param value the value of the pulse, eg: PulseValue.High
    * @param maximum duration in micro-seconds
    */    
    //% blockId="pins_pulse_in" block="pulse in (µs)|pin %name|pulsed %value"
@ -198,7 +200,7 @@ namespace pins {
    /**
     * Writes a value to the servo, controlling the shaft accordingly. On a standard servo, this will set the angle of the shaft (in degrees), moving the shaft to that orientation. On a continuous rotation servo, this will set the speed of the servo (with ``0`` being full-speed in one direction, ``180`` being full speed in the other, and a value near ``90`` being no movement).
-     * @param name pin to write to
+     * @param name pin to write to, eg: AnalogPin.P0
     * @param value angle or rotation speed, eg:180,90,0
     */
    //% help=pins/servo-write-pin weight=20
@ -260,8 +262,8 @@ namespace pins {
    /**
    * Configures the pull of this pin.
-    * @param name pin to set the pull mode on
+    * @param name pin to set the pull mode on, eg: DigitalPin.P0
-    * @param pull one of the mbed pull configurations: PullUp, PullDown, PullNone 
+    * @param pull one of the mbed pull configurations, eg: PinPullMode.PullUp
    */
    //% help=pins/set-pull weight=3 advanced=true
    //% blockId=device_set_pull block="set pull|pin %pin|to %pull"
--- a/libs/core/pins.ts
+++ b/libs/core/pins.ts
@ -1,7 +1,7 @@
 /**
 * Control currents in Pins for analog/digital signals, servos, i2c, ...
 */
-//% color=#A80000 weight=30
+//% color=#A80000 weight=30 icon="\uf140"
 //% advanced=true
 namespace pins {
    /**
--- a/libs/core/pxt.cpp
+++ b/libs/core/pxt.cpp
@ -117,7 +117,6 @@ namespace pxt {
    void RefObject::destroy() {
      ((RefObjectMethod)getVTable()->methods[0])(this);
      delete this;
    }
    void RefObject::print() {
@ -132,6 +131,9 @@ namespace pxt {
          if (refmask[i]) decr(r->fields[i]);
          r->fields[i] = 0;
        }
        //RefRecord is allocated using placement new
        r->~RefRecord();
        ::operator delete(r);
    }
    void RefRecord_print(RefRecord *r)
@ -139,63 +141,373 @@ namespace pxt {
      printf("RefRecord %p r=%d size=%d bytes\n", r, r->refcnt, r->getVTable()->numbytes);
    }
-    void RefCollection::push(uint32_t x) {
+    uint32_t Segment::get(uint32_t i)
-      if (isRef()) incr(x);
+    {
-      data.push_back(x);
+#ifdef DEBUG_BUILD
      printf("In Segment::get index:%u\n", i);
      this->print();
 #endif            
      if (i < length)
      {
        if (data[i] != Segment::MissingValue)
        {
          return data[i];          
        }
        error(ERR_MISSING_VALUE);
        return 0;
      }
      error(ERR_OUT_OF_BOUNDS);
      return 0;
    }
-    uint32_t RefCollection::getAt(int x) {
+    void Segment::set(uint32_t i, uint32_t value) 
-      if (in_range(x)) {
+    {
-        uint32_t tmp = data.at(x);
+        if (i < size)
-        if (isRef()) incr(tmp);
+        {
          data[i] = value;
        }
        else if (i < Segment::MaxSize)
        {
          growByMin(i + 1);
          data[i] = value;
        }
        if (length <= i)
        {
           length = i + 1; 
        }        
 #ifdef DEBUG_BUILD
        printf("In Segment::set\n");
        this->print();
 #endif            
        return;
    }      
    uint16_t Segment::growthFactor(uint16_t size)
    {
      if (size == 0)
      {
        return 4;
      }
      if (size < 64)
      {
        return size * 2; // Double
      }
      if (size < 512)
      {
        return size * 5/3; //Grow by 1.66 rate
      }
      return size + 256; //Grow by constant rate
    }
    void Segment::growByMin(uint16_t minSize)
    {
      growBy(max(minSize, growthFactor(size)));
    }
    void Segment::growBy(uint16_t newSize) 
    {
 #ifdef DEBUG_BUILD
         printf("growBy: %d\n", newSize);
         this->print();
 #endif      
      if (size < newSize)
      {
         //this will throw if unable to allocate
         uint32_t *tmp = (uint32_t*)(::operator new(newSize * sizeof(uint32_t)));
         //Copy existing data
         if (size)
         {
           memcpy(tmp, data, size * sizeof(uint32_t));
         }
         //fill the rest with missing values;
         for(uint16_t i = size; i < newSize; i++)
         {
           tmp[i] = Segment::MissingValue;
         }
         //free older segment;
         ::operator delete(data); 
         data = tmp; 
         size = newSize;
 #ifdef DEBUG_BUILD
         printf("growBy - after reallocation\n");
         this->print();
 #endif         
      }
      //else { no shrinking yet; }
      return;
    }
    void Segment::ensure(uint16_t newSize)
    {
      if (newSize < size)
      {
        return;
      }
      growByMin(newSize);
    }
    void Segment::setLength(uint32_t newLength)
    {
      if (newLength > size)
      {
        ensure(length);        
      }
      length = newLength;
      return;
    }
    void Segment::push(uint32_t value) 
    { 
      this->set(length, value);
    }
    uint32_t Segment::pop() 
    {
 #ifdef DEBUG_BUILD
      printf("In Segment::pop\n");
      this->print();
 #endif            
      if (length > 0)
      {
        uint32_t value = data[length];
        data[length] = Segment::MissingValue;
        --length;
        return value;
      }
      error(ERR_OUT_OF_BOUNDS);      
      return 0;
    }
    //this function removes an element at index i and shifts the rest of the elements to
    //left to fill the gap   
    uint32_t Segment::remove(uint32_t i) 
    {
 #ifdef DEBUG_BUILD
      printf("In Segment::remove index:%u\n", i);
      this->print();
 #endif                  
      if (i < length)
      {
        //value to return
        uint32_t ret = data[i];
        if (i + 1 < length)
        {
          //Move the rest of the elements to fill in the gap.
          memmove(data + i, data + i + 1, (length - i - 1) * sizeof(uint32_t));
        }
        length--;        
        data[length] = Segment::MissingValue;        
 #ifdef DEBUG_BUILD
        printf("After Segment::remove index:%u\n", i);
        this->print();
 #endif  
        return ret;
      }
      error(ERR_OUT_OF_BOUNDS);
      return 0;
    }
    //this function inserts element value at index i by shifting the rest of the elements right.     
    void Segment::insert(uint32_t i, uint32_t value) 
    {
 #ifdef DEBUG_BUILD
      printf("In Segment::insert index:%u value:%u\n", i, value);
      this->print();
 #endif                  
      if (i < length)
      {
        ensure(length + 1);
        if (i + 1 < length)
        {
          //Move the rest of the elements to fill in the gap.
          memmove(data + i + 1, data + i, (length - i) * sizeof(uint32_t));
        }
        data[i] = value;        
        length++;
      }
      else
      {
        //This is insert beyond the length, just call set which will adjust the length
        set(i, value);
      }
 #ifdef DEBUG_BUILD
      printf("After Segment::insert index:%u\n", i);
      this->print();
 #endif                   
    }
    void Segment::print()
    {
      printf("Segment: %x, length: %u, size: %u\n", data, (uint)length, (uint)size);
      for(uint i = 0; i < size; i++)
      {
        printf("%d ",(uint)data[i]);
      }
      printf("\n");
    }
    bool Segment::isValidIndex(uint32_t i)
    {
      if (i > length || data[i] == Segment::MissingValue)
      {
        return false;
      }
      return true;
    }
    bool Segment::getNextValidIndex(uint32_t i, uint32_t *result)
    {
      while (i < length)
      {
        if (data[i] != Segment::MissingValue)
        {
           *result = i;
 #ifdef DEBUG_BUILD
           printf("In Segment::getNextValidIndex result=%u\n",i);
           this->print();
 #endif                  
           return true;
        }
        i++;
      }
      return false;
    }
    void Segment::destroy()
    {
 #ifdef DEBUG_BUILD
      printf("In Segment::destroy\n");
      this->print();
 #endif          
      length = size = 0;
      ::operator delete(data);
      data = nullptr;
    }
    void RefCollection::push(uint32_t x) 
    {
      if (isRef()) incr(x);
      head.push(x);
    }
    uint32_t RefCollection::pop() 
    {
      uint32_t ret = head.pop();
      if (isRef())
      {
        incr(ret);  
      } 
      return ret;
    }
    uint32_t RefCollection::getAt(int i) 
    {
      if (head.isValidIndex(i)) 
      {
        uint32_t tmp = head.get(i);
        if (isRef())
        {
          incr(tmp);
        }
        return tmp;
      }
-      else {
+      else 
      {
        error(ERR_OUT_OF_BOUNDS);
        return 0;
      }
    }
-    void RefCollection::removeAt(int x) {
+    uint32_t RefCollection::removeAt(int i) 
-      if (!in_range(x))
+    {
-        return;
+      if (!head.isValidIndex((uint32_t)i))
-
+      {
-      if (isRef()) decr(data.at(x));
+        error(ERR_OUT_OF_BOUNDS);
-      data.erase(data.begin()+x);
+        return 0;
      }
      if (isRef())
      {
        decr(head.get(i));
      } 
      return head.remove(i);
    }
-    void RefCollection::setAt(int x, uint32_t y) {
+    void RefCollection::insertAt(int i, uint32_t value) 
-      if (!in_range(x))
+    {
-        return;
+      if (i < length())
-
+      {
-      if (isRef()) {
+        head.insert(i, value);
-        decr(data.at(x));
+        if (isRef())
-        incr(y);
+        {
          incr(value);
        } 
      }
      else
      {
        error(ERR_OUT_OF_BOUNDS);
      }
      data.at(x) = y;
    }
-    int RefCollection::indexOf(uint32_t x, int start) {
+    void RefCollection::setAt(int i, uint32_t value) 
-      if (!in_range(start))
+    {
-        return -1;
+      if (isRef()) 
      {
        if (head.isValidIndex((uint32_t)i))
        {
          decr(head.get(i));
        }
        incr(value);
      }
      head.set(i, value);
    }
-      if (isString()) {
+    int RefCollection::indexOf(uint32_t x, int start) 
    {
      if (isString()) 
      {
        StringData *xx = (StringData*)x;
-        for (uint32_t i = start; i < data.size(); ++i) {
+        uint32_t i = start;
-          StringData *ee = (StringData*)data.at(i);
+        while(head.getNextValidIndex(start, &i))
        {
          StringData *ee = (StringData*)head.get(i);
          if (xx->len == ee->len && memcmp(xx->data, ee->data, xx->len) == 0)
          {
            return (int)i;
          }
-      } else {
+          start = i;
-        for (uint32_t i = start; i < data.size(); ++i)
+        }
-          if (data.at(i) == x)
+      } 
      else 
      {
        uint32_t i = start;
        while(head.getNextValidIndex(start, &i))
        {
          if (head.get(i) == x)
          {
            return (int)i;
          }
          start = i;
        }
      }
      return -1;
    }
-    int RefCollection::removeElement(uint32_t x) {
+    int RefCollection::removeElement(uint32_t x) 
    {
      int idx = indexOf(x, 0);
      if (idx >= 0) {
        removeAt(idx);
@ -237,16 +549,23 @@ namespace pxt {
    void RefCollection::destroy()
    {
      if (this->isRef())
-        for (uint32_t i = 0; i < this->data.size(); ++i) {
+      {
-          decr(this->data[i]);
+        uint32_t start = 0;
-          this->data[i] = 0;
+        uint32_t i = 0;
        while(head.getNextValidIndex(start, &i))
        {
          decr(this->head.get(i));
          start = i;
        }
-      this->data.resize(0);
+      }
      this->head.destroy();
      delete this;
    }
    void RefCollection::print()
    {
-      printf("RefCollection %p r=%d flags=%d size=%d [%p, ...]\n", this, refcnt, getFlags(), data.size(), data.size() > 0 ? data[0] : 0);
+      printf("RefCollection %p r=%d flags=%d size=%d\n", this, refcnt, getFlags(), head.getLength());
      head.print();
    }
    PXT_VTABLE_CTOR(RefAction) {}
@ -258,6 +577,9 @@ namespace pxt {
        decr(fields[i]);
        fields[i] = 0;
      }
      //RefAction is allocated using placement new
      this->~RefAction();
      ::operator delete(this);
    }
    void RefAction::print()
@ -272,6 +594,7 @@ namespace pxt {
    void RefLocal::destroy()
    {
      delete this;
    }
    PXT_VTABLE_CTOR(RefLocal) {
@ -290,6 +613,7 @@ namespace pxt {
    void RefRefLocal::destroy()
    {
      decr(v);
      delete this;
    }
    PXT_VTABLE_BEGIN(RefMap, 0, RefMapMarker)
@ -304,6 +628,7 @@ namespace pxt {
        data[i].val = 0;
      }
      data.resize(0);
      delete this;
    }
    int RefMap::findIdx(uint32_t key) {
--- a/libs/core/pxt.h
+++ b/libs/core/pxt.h
@ -38,6 +38,7 @@ namespace pxt {
    ERR_OUT_OF_BOUNDS = 8,
    ERR_REF_DELETED = 7,
    ERR_SIZE = 9,
    ERR_MISSING_VALUE = 10,
  } ERROR;
  extern const uint32_t functionsAndBytecode[];
@ -167,11 +168,53 @@ namespace pxt {
    }
  };
  class Segment {
  private:    
      uint32_t* data;
      uint16_t length;
      uint16_t size;
      static const uint16_t MaxSize = 0xFFFF;
      static const uint32_t MissingValue = 0x80000000;
      static uint16_t growthFactor(uint16_t size);      
      void growByMin(uint16_t minSize);
      void growBy(uint16_t newSize);
      void ensure(uint16_t newSize);
  public:
      Segment() : data (nullptr), length(0), size(0) {};
      uint32_t get(uint32_t i);
      void set(uint32_t i, uint32_t value);      
      uint32_t getLength() { return length;};
      void setLength(uint32_t newLength);
      void push(uint32_t value);
      uint32_t pop();
      uint32_t remove(uint32_t i);
      void insert(uint32_t i, uint32_t value);
      //Returns true if there is a valid index greater than or equal to 'i', returns false otherwise
      //If 'i' is valid returns it in 'result', if not tries to find the next valid
      //index < length which is valid.
      bool getNextValidIndex(uint32_t i, uint32_t *result);
      bool isValidIndex(uint32_t i);
      void destroy();
      void print();
  };
  // A ref-counted collection of either primitive or ref-counted objects (String, Image,
  // user-defined record, another collection)
  class RefCollection
    : public RefObject
  {
  private:
    Segment head;
  public:
    // 1 - collection of refs (need decr)
    // 2 - collection of strings (in fact we always have 3, never 2 alone)
@ -179,23 +222,23 @@ namespace pxt {
    inline bool isRef() { return getFlags() & 1; }
    inline bool isString() { return getFlags() & 2; }
    std::vector<uint32_t> data;
    RefCollection(uint16_t f);
    inline bool in_range(int x) {
      return (0 <= x && x < (int)data.size());
    }
    inline int length() { return data.size(); }
    void destroy();
    void print();
    uint32_t length() { return head.getLength();}
    void setLength(uint32_t newLength) { head.setLength(newLength); }
    void push(uint32_t x);
-    uint32_t getAt(int x);
+    uint32_t pop();
-    void removeAt(int x);
+    uint32_t getAt(int i);
-    void setAt(int x, uint32_t y);
+    void setAt(int i, uint32_t x);
    //removes the element at index i and shifts the other elements left
    uint32_t removeAt(int i);
    //inserts the element at index i and moves the other elements right.
    void insertAt(int i, uint32_t x); 
    int indexOf(uint32_t x, int start);
    int removeElement(uint32_t x);
  };
--- a/libs/core/serial.cpp
+++ b/libs/core/serial.cpp
@ -34,7 +34,7 @@ enum Delimiters {
    Hash = 6,
 };
-//% weight=2 color=30
+//% weight=2 color=30 icon="\uf287"
 //% advanced=true
 namespace serial {
    // note that at least one // followed by % is needed per declaration!
@ -83,16 +83,19 @@ namespace serial {
    /**
    * Dynamically configuring the serial instance to use pins other than USBTX and USBRX.
-    * @param tx the new transmission pins
+    * @param tx the new transmission pins, eg: SerialPin.P0
-    * @param rx the new reception pin
+    * @param rx the new reception pin, eg: SerialPin.P1
-    * @param baud the new baud rate. eg: 115200
+    * @param rate the new baud rate. eg: 115200
    */
    //% weight=10
    //% help=serial/redirect-to
    //% blockId=serial_redirect block="serial|redirect to|TX %tx|RX %rx|at baud rate %rate"
    //% blockExternalInputs=1
    void redirect(SerialPin tx, SerialPin rx, BaudRate rate) {
-      uBit.serial.redirect((PinName)tx, (PinName)rx);
+      MicroBitPin* txp = getPin(tx); if (!tx) return;
      MicroBitPin* rxp = getPin(rx); if (!rx) return;
      uBit.serial.redirect(txp->name, rxp->name);
      uBit.serial.baud((int)rate);
    }
 }
--- a/libs/core/serial.ts
+++ b/libs/core/serial.ts
@ -1,7 +1,7 @@
 /**
 * Reading and writing data over a serial connection.
 */
-//% weight=2 color=#002050
+//% weight=2 color=#002050 icon="\uf287"
 //% advanced=true
 namespace serial {
    /**
--- a/libs/core/shims.d.ts
+++ b/libs/core/shims.d.ts
@ -4,7 +4,7 @@
    /**
     * Creation, manipulation and display of LED images.
     */
-    //% color=#5C2D91 weight=31
+    //% color=#5C2D91 weight=31 icon="\uf03e"
    //% advanced=true
 declare namespace images {
@ -126,7 +126,7 @@ declare interface Image {
    /**
     * Provides access to basic micro:bit functionality.
     */
-    //% color=#0078D7 weight=100
+    //% color=#0078D7 weight=100 icon="\uf00a"
 declare namespace basic {
    /**
@ -135,7 +135,7 @@ declare namespace basic {
     */
    //% help=basic/show-number
    //% weight=96
-    //% blockId=device_show_number block="show|number %number" blockGap=8 icon="\uf1ec"
+    //% blockId=device_show_number block="show|number %number" blockGap=8
    //% async
    //% parts="ledmatrix" interval.defl=150 shim=basic::showNumber
    function showNumber(value: number, interval?: number): void;
@ -160,7 +160,7 @@ declare namespace basic {
     */
    //% help=basic/show-string 
    //% weight=87 blockGap=8
-    //% block="show|string %text" icon="\uf031" 
+    //% block="show|string %text" 
    //% async
    //% blockId=device_print_message
    //% parts="ledmatrix" interval.defl=150 shim=basic::showString
@ -170,7 +170,7 @@ declare namespace basic {
     * Turn off all LEDs
     */
    //% help=basic/clear-screen weight=79
-    //% blockId=device_clear_display block="clear screen" icon="\uf12d"
+    //% blockId=device_clear_display block="clear screen"
    //% parts="ledmatrix" shim=basic::clearScreen
    function clearScreen(): void;
@ -195,7 +195,7 @@ declare namespace basic {
     * Repeats the code forever in the background. On each iteration, allows other codes to run.
     * @param body code to execute
     */
-    //% help=basic/forever weight=55 blockGap=8
+    //% help=basic/forever weight=55 blockGap=8 blockAllowMultiple=1
    //% blockId=device_forever block="forever" icon="\uf01e" shim=basic::forever
    function forever(a: () => void): void;
@ -211,49 +211,51 @@ declare namespace basic {
-    //% color=300 weight=99
+    //% color=300 weight=99 icon="\uf192"
 declare namespace input {
    /**
     * Do something when a button (``A``, ``B`` or both ``A+B``) is pressed
-     * @param button TODO
+     * @param button the button that needs to be pressed
-     * @param body TODO
+     * @param body code to run when event is raised
     */
    //% help=input/on-button-pressed weight=85 blockGap=8
-    //% blockId=device_button_event block="on button|%NAME|pressed" icon="\uf192"
+    //% blockId=device_button_event block="on button|%NAME|pressed"
    //% parts="buttonpair" shim=input::onButtonPressed
    function onButtonPressed(button: Button, body: () => void): void;
    /**
     * Do something when when a gesture is done (like shaking the micro:bit).
-     * @param body TODO
+     * @param gesture the type of gesture to track, eg: Gesture.Shake
     * @param body code to run when gesture is raised
     */
    //% help=input/on-gesture weight=84 blockGap=8
-    //% blockId=device_gesture_event block="on |%NAME" icon="\uf135"
+    //% blockId=device_gesture_event block="on |%NAME"
    //% parts="accelerometer" shim=input::onGesture
    function onGesture(gesture: Gesture, body: () => void): void;
    /**
     * Do something when a pin is pressed.
-     * @param name the pin that needs to be pressed
+     * @param name the pin that needs to be pressed, eg: TouchPin.P0
     * @param body the code to run when the pin is pressed
     */
    //% help=input/on-pin-pressed weight=83
-    //% blockId=device_pin_event block="on pin %NAME|pressed" icon="\uf094" shim=input::onPinPressed
+    //% blockId=device_pin_event block="on pin %name|pressed" shim=input::onPinPressed
    function onPinPressed(name: TouchPin, body: () => void): void;
    /**
     * Do something when a pin is released.
-     * @param name the pin that needs to be released
+     * @param name the pin that needs to be released, eg: TouchPin.P0
     * @param body the code to run when the pin is released
     */
    //% help=input/on-pin-released weight=6 blockGap=8
-    //% blockId=device_pin_released block="on pin %NAME|released" icon="\uf094"
+    //% blockId=device_pin_released block="on pin %NAME|released"
    //% advanced=true shim=input::onPinReleased
    function onPinReleased(name: TouchPin, body: () => void): void;
    /**
     * Get the button state (pressed or not) for ``A`` and ``B``.
     * @param button the button to query the request, eg: Button.A
     */
    //% help=input/button-is-pressed weight=60
    //% block="button|%NAME|is pressed"
@ -264,10 +266,10 @@ declare namespace input {
    /**
     * Get the pin state (pressed or not). Requires to hold the ground to close the circuit.
-     * @param name pin used to detect the touch
+     * @param name pin used to detect the touch, eg: TouchPin.P0
     */
    //% help=input/pin-is-pressed weight=58
-    //% blockId="device_pin_is_pressed" block="pin %NAME|is pressed" icon="\uf094"
+    //% blockId="device_pin_is_pressed" block="pin %NAME|is pressed"
    //% blockGap=8 shim=input::pinIsPressed
    function pinIsPressed(name: TouchPin): boolean;
@ -275,7 +277,7 @@ declare namespace input {
     * Get the acceleration value in milli-gravitys (when the board is laying flat with the screen up, x=0, y=0 and z=-1024)
     * @param dimension TODO
     */
-    //% help=input/acceleration weight=58 icon="\uf135"
+    //% help=input/acceleration weight=58
    //% blockId=device_acceleration block="acceleration (mg)|%NAME" blockGap=8
    //% parts="accelerometer" shim=input::acceleration
    function acceleration(dimension: Dimension): number;
@ -284,7 +286,7 @@ declare namespace input {
     * Reads the light level applied to the LED screen in a range from ``0`` (dark) to ``255`` bright.
     */
    //% help=input/light-level weight=57
-    //% blockId=device_get_light_level block="light level" blockGap=8 icon="\uf185"
+    //% blockId=device_get_light_level block="light level" blockGap=8
    //% parts="ledmatrix" shim=input::lightLevel
    function lightLevel(): number;
@ -292,7 +294,7 @@ declare namespace input {
     * Get the current compass heading in degrees.
     */
    //% help=input/compass-heading
-    //% weight=56 icon="\uf14e"
+    //% weight=56
    //% blockId=device_heading block="compass heading (°)" blockGap=8
    //% parts="compass" shim=input::compassHeading
    function compassHeading(): number;
@ -300,7 +302,7 @@ declare namespace input {
    /**
     * Gets the temperature in Celsius degrees (°C).
     */
-    //% weight=55 icon="\uf06d"
+    //% weight=55
    //% help=input/temperature
    //% blockId=device_temperature block="temperature (°C)" blockGap=8
    //% parts="thermometer" shim=input::temperature
@ -311,7 +313,7 @@ declare namespace input {
     * @param kind TODO
     */
    //% help=input/rotation weight=52
-    //% blockId=device_get_rotation block="rotation (°)|%NAME" blockGap=8 icon="\uf197"
+    //% blockId=device_get_rotation block="rotation (°)|%NAME" blockGap=8
    //% parts="accelerometer" advanced=true shim=input::rotation
    function rotation(kind: Rotation): number;
@ -320,7 +322,7 @@ declare namespace input {
     * @param dimension TODO
     */
    //% help=input/magnetic-force weight=51
-    //% blockId=device_get_magnetic_force block="magnetic force (µT)|%NAME" blockGap=8 icon="\uf076"
+    //% blockId=device_get_magnetic_force block="magnetic force (µT)|%NAME" blockGap=8
    //% parts="compass"
    //% advanced=true shim=input::magneticForce
    function magneticForce(dimension: Dimension): number;
@ -329,7 +331,7 @@ declare namespace input {
     * Gets the number of milliseconds elapsed since power on.
     */
    //% help=input/running-time weight=50
-    //% blockId=device_get_running_time block="running time (ms)" icon="\uf017"
+    //% blockId=device_get_running_time block="running time (ms)"
    //% advanced=true shim=input::runningTime
    function runningTime(): number;
@ -344,7 +346,7 @@ declare namespace input {
     * @param range a value describe the maximum strengh of acceleration measured
     */
    //% help=input/set-accelerometer-range
-    //% blockId=device_set_accelerometer_range block="set accelerometer|range %range" icon="\uf135"
+    //% blockId=device_set_accelerometer_range block="set accelerometer|range %range"
    //% weight=5
    //% parts="accelerometer"
    //% advanced=true shim=input::setAccelerometerRange
@ -360,7 +362,7 @@ declare namespace control {
    /**
     * Schedules code that run in the background.
     */
-    //% help=control/in-background
+    //% help=control/in-background blockAllowMultiple=1
    //% blockId="control_in_background" block="run in background" blockGap=8 shim=control::inBackground
    function inBackground(a: () => void): void;
@ -425,7 +427,7 @@ declare namespace control {
-    //% color=3 weight=35
+    //% color=3 weight=35 icon="\uf205"
 declare namespace led {
    /**
@ -434,7 +436,7 @@ declare namespace led {
     * @param y TODO
     */
    //% help=led/plot weight=78
-    //% blockId=device_plot block="plot|x %x|y %y" icon="\uf205" blockGap=8
+    //% blockId=device_plot block="plot|x %x|y %y" blockGap=8
    //% parts="ledmatrix" shim=led::plot
    function plot(x: number, y: number): void;
@ -444,7 +446,7 @@ declare namespace led {
     * @param y TODO
     */
    //% help=led/unplot weight=77
-    //% blockId=device_unplot block="unplot|x %x|y %y" icon="\uf204" blockGap=8
+    //% blockId=device_unplot block="unplot|x %x|y %y" blockGap=8
    //% parts="ledmatrix" shim=led::unplot
    function unplot(x: number, y: number): void;
@ -454,7 +456,7 @@ declare namespace led {
     * @param y TODO
     */
    //% help=led/point weight=76
-    //% blockId=device_point block="point|x %x|y %y" icon="\uf10c"
+    //% blockId=device_point block="point|x %x|y %y"
    //% parts="ledmatrix" shim=led::point
    function point(x: number, y: number): boolean;
@ -462,7 +464,7 @@ declare namespace led {
     * Get the screen brightness from 0 (off) to 255 (full bright).
     */
    //% help=led/brightness weight=60
-    //% blockId=device_get_brightness block="brightness" icon="\uf042" blockGap=8
+    //% blockId=device_get_brightness block="brightness" blockGap=8
    //% parts="ledmatrix"
    //% advanced=true shim=led::brightness
    function brightness(): number;
@ -472,7 +474,7 @@ declare namespace led {
     * @param value the brightness value, eg:255, 127, 0
     */
    //% help=led/set-brightness weight=59
-    //% blockId=device_set_brightness block="set brightness %value" icon="\uf042"
+    //% blockId=device_set_brightness block="set brightness %value"
    //% parts="ledmatrix"
    //% advanced=true shim=led::setBrightness
    function setBrightness(value: number): void;
@ -481,7 +483,7 @@ declare namespace led {
     * Cancels the current animation and clears other pending animations.
     */
    //% weight=50 help=led/stop-animation
-    //% blockId=device_stop_animation block="stop animation" icon="\uf04d"
+    //% blockId=device_stop_animation block="stop animation"
    //% parts="ledmatrix"
    //% advanced=true shim=led::stopAnimation
    function stopAnimation(): void;
@ -497,7 +499,7 @@ declare namespace led {
    /**
     * Turns on or off the display    
     */
-    //% help=led/enable blockId=device_led_enable icon="\uf04d"
+    //% help=led/enable blockId=device_led_enable block="led enable %on"
    //% advanced=true parts="ledmatrix" shim=led::enable
    function enable(on: boolean): void;
@ -512,7 +514,7 @@ declare namespace pins {
    /**
     * Read the specified pin or connector as either 0 or 1
-     * @param name pin to read from
+     * @param name pin to read from, eg: DigitalPin.P0
     */
    //% help=pins/digital-read-pin weight=30
    //% blockId=device_get_digital_pin block="digital read|pin %name" blockGap=8 shim=pins::digitalReadPin
@ -520,7 +522,7 @@ declare namespace pins {
    /**
     * Set a pin or connector value to either 0 or 1.
-     * @param name pin to write to
+     * @param name pin to write to, eg: DigitalPin.P0
     * @param value value to set on the pin, 1 eg,0
     */
    //% help=pins/digital-write-pin weight=29
@ -529,7 +531,7 @@ declare namespace pins {
    /**
     * Read the connector value as analog, that is, as a value comprised between 0 and 1023.
-     * @param name pin to write to
+     * @param name pin to write to, eg: AnalogPin.P0
     */
    //% help=pins/analog-read-pin weight=25
    //% blockId=device_get_analog_pin block="analog read|pin %name" blockGap="8" shim=pins::analogReadPin
@ -537,7 +539,7 @@ declare namespace pins {
    /**
     * Set the connector value as analog. Value must be comprised between 0 and 1023.
-     * @param name pin name to write to
+     * @param name pin name to write to, eg: AnalogPin.P0
     * @param value value to write to the pin between ``0`` and ``1023``. eg:1023,0
     */
    //% help=pins/analog-write-pin weight=24
@ -547,7 +549,7 @@ declare namespace pins {
    /**
     * Configures the Pulse-width modulation (PWM) of the analog output to the given value in **microseconds** or `1/1000` milliseconds.
     * If this pin is not configured as an analog output (using `analog write pin`), the operation has no effect.
-     * @param name analog pin to set period to
+     * @param name analog pin to set period to, eg: AnalogPin.P0
     * @param micros period in micro seconds. eg:20000
     */
    //% help=pins/analog-set-period weight=23 blockGap=8
@ -556,6 +558,8 @@ declare namespace pins {
    /**
     * Configures this pin to a digital input, and generates events where the timestamp is the duration that this pin was either ``high`` or ``low``.
     * @param name digital pin to register to, eg: DigitalPin.P0
     * @param pulse the value of the pulse, eg: PulseValue.High
     */
    //% help=pins/on-pulsed weight=22 blockGap=8 advanced=true
    //% blockId=pins_on_pulsed block="on|pin %pin|pulsed %pulse" shim=pins::onPulsed
@ -571,8 +575,8 @@ declare namespace pins {
    /**
     * Returns the duration of a pulse in microseconds
-     * @param name the pin which measures the pulse
+     * @param name the pin which measures the pulse, eg: DigitalPin.P0
-     * @param value the value of the pulse (default high)
+     * @param value the value of the pulse, eg: PulseValue.High
     * @param maximum duration in micro-seconds
     */
    //% blockId="pins_pulse_in" block="pulse in (µs)|pin %name|pulsed %value"
@ -581,7 +585,7 @@ declare namespace pins {
    /**
     * Writes a value to the servo, controlling the shaft accordingly. On a standard servo, this will set the angle of the shaft (in degrees), moving the shaft to that orientation. On a continuous rotation servo, this will set the speed of the servo (with ``0`` being full-speed in one direction, ``180`` being full speed in the other, and a value near ``90`` being no movement).
-     * @param name pin to write to
+     * @param name pin to write to, eg: AnalogPin.P0
     * @param value angle or rotation speed, eg:180,90,0
     */
    //% help=pins/servo-write-pin weight=20
@ -617,8 +621,8 @@ declare namespace pins {
    /**
     * Configures the pull of this pin.
-     * @param name pin to set the pull mode on
+     * @param name pin to set the pull mode on, eg: DigitalPin.P0
-     * @param pull one of the mbed pull configurations: PullUp, PullDown, PullNone 
+     * @param pull one of the mbed pull configurations, eg: PinPullMode.PullUp
     */
    //% help=pins/set-pull weight=3 advanced=true
    //% blockId=device_set_pull block="set pull|pin %pin|to %pull" shim=pins::setPull
@ -654,7 +658,7 @@ declare namespace pins {
-    //% weight=2 color=30
+    //% weight=2 color=30 icon="\uf287"
    //% advanced=true
 declare namespace serial {
@ -685,9 +689,9 @@ declare namespace serial {
    /**
     * Dynamically configuring the serial instance to use pins other than USBTX and USBRX.
-     * @param tx the new transmission pins
+     * @param tx the new transmission pins, eg: SerialPin.P0
-     * @param rx the new reception pin
+     * @param rx the new reception pin, eg: SerialPin.P1
-     * @param baud the new baud rate. eg: 115200
+     * @param rate the new baud rate. eg: 115200
     */
    //% weight=10
    //% help=serial/redirect-to
--- a/libs/devices/pxt.json
+++ b/libs/devices/pxt.json
@ -1,6 +1,6 @@
 {
    "name": "devices",
-    "description": "The BLE specific services",
+    "description": "Camera, remote control and other Bluetooth services",
    "files": [
        "README.md",
        "enums.d.ts",
@ -9,16 +9,8 @@
    ],
    "public": true,
    "dependencies": {
-        "core": "file:../core"
+        "core": "file:../core",
-    },
+        "bluetooth": "file:../bluetooth"
    "yotta": {
        "config": {
            "microbit-dal": {
                "bluetooth": {
                    "enabled": 1
                }
            }
        }
    },
    "installedVersion": "ljipgq"
 }
--- a/libs/radio/radio.cpp
+++ b/libs/radio/radio.cpp
@ -24,7 +24,7 @@ using namespace pxt;
 // payload: string length (9), string (10 ... 28)
 #define PACKET_TYPE_STRING 2
-//% color=270 weight=34
+//% color=270 weight=34 icon="\uf012"
 namespace radio {
    // -------------------------------------------------------------------------
--- a/libs/radio/radio.ts
+++ b/libs/radio/radio.ts
@ -1,7 +1,7 @@
 /**
 * Communicate data using radio packets
 */
-//% color=#E3008C weight=34
+//% color=#E3008C weight=34 icon="\uf012"
 namespace radio {
    export class Packet {
        /**
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
Peli de Halleux	7fe8dad1f6	0.7.18	2017-01-05 22:39:36 -08:00
Peli de Halleux	858766ea3e	Bump pxt-core to 0.8.6	2017-01-05 22:39:34 -08:00
Sam El-Husseini	81fe9afbb7	remove begin	2017-01-05 13:35:28 -08:00
Sam El-Husseini	65c615f256	Merge branch 'master' into tutorialmode	2017-01-05 13:33:41 -08:00
Peli de Halleux	9c5c699fe7	0.7.17	2017-01-05 13:31:30 -08:00
Peli de Halleux	dcede1703a	fixing link	2017-01-05 13:31:05 -08:00
Peli de Halleux	5d33ab019d	0.7.16	2017-01-05 13:30:30 -08:00
Peli de Halleux	f7ec452ea0	updated steps	2017-01-05 13:30:14 -08:00
Peli de Halleux	20260e8933	fixes to docs	2017-01-05 13:28:06 -08:00
Peli de Halleux	d7704934e8	0.7.15	2017-01-05 13:17:24 -08:00
Peli de Halleux	f1eafb0a6e	Bump pxt-core to 0.8.5	2017-01-05 13:17:21 -08:00
Peli de Halleux	27d6a8281a	Inchworm (#331 ) * images for inchworm project * binding pictures * updated inchworm lesson	2017-01-05 10:00:36 -08:00
Sam El-Husseini	c5128aa497	Merge branch 'master' into tutorialmode	2017-01-05 08:19:39 -08:00
Peli de Halleux	a59394646c	fixed docs	2017-01-05 07:37:46 -08:00
Peli de Halleux	6851169dbe	0.7.14	2017-01-05 07:10:13 -08:00
Peli de Halleux	36b3486194	Bump pxt-core to 0.8.3	2017-01-05 07:10:12 -08:00
Peli de Halleux	5d8ccd1d6d	adding namespace to api categories (#330 ) * adding namespace to api categories * add icon for led * adding icons for control, game, images, pins and serial.	2017-01-05 07:01:50 -08:00
Abhijith Chatra	c713fe9bf4	0.7.13	2017-01-04 13:08:54 -08:00
Abhijith Chatra	f682e5e694	insertAt support for array (#328 ) * Adding insertAt and setLength to array * implemented review comments * Bump pxt-core to 0.8.2	2017-01-04 13:07:58 -08:00
Sam El-Husseini	d2d776fd01	Updating getting started tutorial	2017-01-04 10:06:47 -08:00
Sam El-Husseini	641a5e9673	Merge branch 'master' into tutorialmode	2017-01-03 12:14:34 -08:00
Sam El-Husseini	93d90a2bde	Few extra typing fixes.	2017-01-03 12:14:25 -08:00
Sam El-Husseini	a54504f31c	Updating bluebird typings path	2017-01-03 11:38:21 -08:00
Sam El-Husseini	03111368e0	add more blocks	2017-01-02 22:14:40 -08:00
Sam El-Husseini	a973b2aec6	Merge branch 'master' into tutorialmode	2017-01-02 15:10:11 -08:00
Sam El-Husseini	a7adf0e6c6	minor ui fixes	2017-01-02 15:09:49 -08:00
Sam El-Husseini	c10761128e	Tutorial mode changes	2017-01-01 18:52:22 -08:00
Peli de Halleux	9965f169b2	0.7.12	2016-12-31 07:28:12 -08:00
Peli de Halleux	8bf755c15c	fixing eddystone uid encoding	2016-12-31 07:25:27 -08:00
Peli de Halleux	d0b2a7db62	0.7.11	2016-12-31 06:49:30 -08:00
Peli de Halleux	780192da3b	Bump pxt-core to 0.7.13	2016-12-31 06:49:28 -08:00
Peli de Halleux	07c1f08d18	fix for Microsoft/pxt#1014	2016-12-31 06:36:05 -08:00
Sam El-Husseini	25ac847266	converging with other targets on blockly toolbox width	2016-12-31 02:51:24 -08:00
Sam El-Husseini	63c8342b86	ui changes accompanying pxt mobile ui fixes	2016-12-31 01:43:45 -08:00
Abhijith Chatra	ea2bd7ba10	Merge pull request #326 from Microsoft/array Array enhancements	2016-12-30 15:09:16 -08:00
Peli de Halleux	cec2d1e8af	0.7.10	2016-12-30 15:05:31 -08:00
Peli de Halleux	1b289b688b	Bump pxt-core to 0.7.12	2016-12-30 15:05:28 -08:00
Sam El-Husseini	0cf91580cb	Merge pull request #327 from Microsoft/pr/toggletheming Blocks / JS menu toggle theming	2016-12-30 15:00:32 -08:00
Peli de Halleux	392ebc8d07	0.7.9	2016-12-30 14:18:06 -08:00
Peli de Halleux	9068aab12b	Bump pxt-core to 0.7.11	2016-12-30 14:18:03 -08:00
Peli de Halleux	85327a4e69	0.7.8	2016-12-30 13:50:03 -08:00
Peli de Halleux	021260b3a4	Bump pxt-core to 0.7.10	2016-12-30 13:50:00 -08:00
Sam El-Husseini	4def93d7c5	Blocks / JS menu toggle theming	2016-12-30 13:07:16 -08:00
Abhijith Chatra	9aca0c19fc	Merge branch 'master' into array	2016-12-23 19:53:06 -08:00
Abhijith Chatra	3fcbdbdd82	Array reimplementation as single segment with support for missing values	2016-12-23 19:49:15 -08:00
Peli de Halleux	4b7b6eebca	0.7.7	2016-12-23 08:59:08 -08:00
Peli de Halleux	2da0cf1178	support for buffer signature (#325 )	2016-12-23 08:58:38 -08:00
Peli de Halleux	141cb24e3d	0.7.6	2016-12-22 23:18:35 -08:00
Peli de Halleux	35483487af	Bump pxt-core to 0.7.9	2016-12-22 23:18:32 -08:00
Peli de Halleux	ec3a805326	0.7.5	2016-12-22 11:35:58 -08:00
Peli de Halleux	780d8bcf8d	Bump pxt-core to 0.7.6	2016-12-22 11:35:56 -08:00
Peli de Halleux	f9a12cac64	Merge branch 'master' of https://github.com/Microsoft/pxt-microbit	2016-12-22 11:32:01 -08:00
Peli de Halleux	03c2df3277	fixed default projects	2016-12-22 11:31:50 -08:00
guillaumejenkins	a7e98ccb3d	Change default product names for Electron app; Add release manifest	2016-12-21 12:31:00 -08:00
Peli de Halleux	1014d2f361	0.7.4	2016-12-20 16:30:14 -08:00
Peli de Halleux	89f20a64d5	Bump pxt-core to 0.7.5	2016-12-20 16:30:12 -08:00
Peli de Halleux	fae36a74af	0.7.3	2016-12-20 13:06:13 -08:00
Peli de Halleux	7e57c59b6f	Bump pxt-core to 0.7.4	2016-12-20 13:06:09 -08:00
Peli de Halleux	3141e12f4c	support for 8G gestures	2016-12-20 13:05:06 -08:00
Peli de Halleux	4ebe9f595a	fix for Microsoft/pxt#961	2016-12-20 12:38:00 -08:00
Peli de Halleux	50f0e85884	docs updates	2016-12-20 12:31:25 -08:00
Peli de Halleux	e28b5d48d4	0.7.2	2016-12-19 16:08:31 -08:00
Peli de Halleux	562e96e09e	Bump pxt-core to 0.7.2	2016-12-19 16:08:21 -08:00
Peli de Halleux	6c5088f811	update LESS variables	2016-12-19 16:08:01 -08:00
Peli de Halleux	d5ccb7ad02	0.7.1	2016-12-19 14:11:17 -08:00
Peli de Halleux	ade5176d21	upgraded to 0.7	2016-12-19 14:10:57 -08:00
Peli de Halleux	d2f6d51c19	0.6.46	2016-12-19 14:10:12 -08:00
Peli de Halleux	92b60a251d	On start support (#324 ) * annotating APIs to support onstart * missed file * updated templates * adding new lines in main.ts * fixing docs * removing onstart * updated docs * updated various docs * more docs * adding upgrade policies for blocks * updated pxt reference * placing on start under "basic"	2016-12-19 14:09:35 -08:00
guillaumejenkins	de9f2d7e67	More appropriate Electron app bundle ID on Mac OS	2016-12-19 07:59:52 -08:00
Peli de Halleux	4de5e3bd11	0.6.45	2016-12-18 20:57:52 -08:00
Peli de Halleux	86a33e8f65	Bump pxt-core to 0.6.7	2016-12-18 20:57:50 -08:00
Peli de Halleux	89010b6a8a	0.6.44	2016-12-16 20:26:41 -08:00
Peli de Halleux	48d4668a7a	Bump pxt-core to 0.6.6	2016-12-16 20:26:39 -08:00
Peli de Halleux	a2755dc4d2	annotate apis to support multiple forever blocks	2016-12-16 16:47:36 -08:00
Peli de Halleux	52e67c6bfc	0.6.43	2016-12-16 15:29:33 -08:00
Peli de Halleux	5a6f23a7d0	Bump pxt-core to 0.6.5	2016-12-16 15:29:26 -08:00
Peli de Halleux	d1b36f2022	0.6.42	2016-12-16 14:57:24 -08:00
Peli de Halleux	284579181b	Bump pxt-core to 0.6.4	2016-12-16 14:57:09 -08:00
Peli de Halleux	20fcb05538	0.6.41	2016-12-16 14:40:12 -08:00
Peli de Halleux	e1a2074ef5	Bump pxt-core to 0.6.3	2016-12-16 14:39:58 -08:00
Guillaume Jenkins	fa3e33dab9	Default product.json for enabling Electron builds (#323 )	2016-12-16 12:16:06 -08:00
Peli de Halleux	300a98b858	0.6.40	2016-12-13 21:58:35 -08:00
Peli de Halleux	5986671bcb	Bump pxt-core to 0.6.1	2016-12-13 21:58:29 -08:00
Sam El-Husseini	efd5c46143	0.6.39	2016-12-14 09:16:58 +11:00
Sam El-Husseini	62c1a1da35	Bump pxt-core to 0.5.102	2016-12-14 09:16:57 +11:00
Peli de Halleux	ebbc7c983d	0.6.38	2016-12-13 12:49:06 -08:00
Peli de Halleux	173fc4bf7b	Bump pxt-core to 0.5.101	2016-12-13 12:49:04 -08:00
Peli de Halleux	47f1eadd27	0.6.37	2016-12-13 12:33:39 -08:00
Peli de Halleux	8c06277a92	Bump pxt-core to 0.5.100	2016-12-13 12:33:37 -08:00
Peli de Halleux	395f482f11	Merge pull request #322 from Microsoft/pr/monacotoolbox Pr/monacotoolbox	2016-12-13 12:29:42 -08:00
Peli de Halleux	bbd21a84d6	annotating apis to support toolbox	2016-12-13 12:14:32 -08:00
Peli de Halleux	fcf680e9bd	automatically detect/add missing package references in project	2016-12-12 10:42:02 -08:00
Sam El-Husseini	8ac848c812	Merge branch 'master' into pr/monacotoolbox	2016-12-12 08:39:45 +11:00
Sam El-Husseini	dd591af224	Turning flag for monaco toolbox on	2016-12-11 09:01:08 +13:00
Sam El-Husseini	e5a7a81198	Better monaco flyout contrast	2016-12-11 08:52:02 +13:00
Sam El-Husseini	7a5228a5d0	Reverting toolbox color	2016-12-11 06:52:08 +13:00
Sam El-Husseini	fe5c8e520a	monaco draggable block	2016-12-11 06:34:11 +13:00
Peli de Halleux	96d354a8a8	Merge pull request #316 from OwenBrotherwood/patch-1 Correction for max. length of advertised url to 17	2016-12-09 15:13:12 -08:00
Peli de Halleux	02480b1c54	updated master to 0.6.36	2016-12-09 13:51:23 -08:00
Peli de Halleux	4fd321cccf	0.6.36	2016-12-09 13:43:41 -08:00
Peli de Halleux	4641c9456f	Bump pxt-core to 0.5.99	2016-12-09 13:43:37 -08:00
Peli de Halleux	498b5ec095	0.6.35	2016-12-09 11:57:34 -08:00
Peli de Halleux	912be2ddfd	Bump pxt-core to 0.5.98	2016-12-09 11:57:32 -08:00
Peli de Halleux	6d7f8c5841	0.6.34	2016-12-09 11:15:51 -08:00
Peli de Halleux	a782f4731a	Bump pxt-core to 0.5.97	2016-12-09 11:15:48 -08:00
Peli de Halleux	6e067bffd5	using built-deploy deployment features deploy to drives has been migrated to PXT	2016-12-08 21:10:46 -08:00
Peli de Halleux	4a4007ba41	fixing uploader link	2016-12-08 12:33:31 -08:00
Peli de Halleux	c9db08a2c6	0.6.33	2016-12-08 12:18:56 -08:00
Peli de Halleux	5ec303b95c	Bump pxt-core to 0.5.96	2016-12-08 12:18:53 -08:00
Peli de Halleux	3d0523a298	fix for roll/pitch in simulator. fix for https://github.com/Microsoft/pxt/issues/893	2016-12-08 12:14:34 -08:00
Peli de Halleux	3469ad6f8d	Added note about protocol encoding.	2016-12-08 12:01:35 -08:00
Peli de Halleux	d791738d84	fixing y values in accelerometer simulator fix for https://github.com/Microsoft/pxt/issues/893	2016-12-08 11:57:17 -08:00
Peli de Halleux	355c341d36	0.6.32	2016-12-08 10:56:49 -08:00
Peli de Halleux	1adb4a2bac	Bump pxt-core to 0.5.95	2016-12-08 10:56:46 -08:00
Peli de Halleux	03c0339e9a	fixing docs snippets	2016-12-08 09:16:27 -08:00
Peli de Halleux	1649811015	expose "delete" in blocks. fix for https://github.com/Microsoft/pxt/issues/870	2016-12-08 08:54:05 -08:00
Peli de Halleux	14f16f9b2c	expose game.setScore in blocks fix for https://github.com/Microsoft/pxt/issues/881	2016-12-08 08:51:18 -08:00
Peli de Halleux	66d3c6c7e8	fix for https://github.com/Microsoft/pxt/issues/549	2016-12-08 08:28:28 -08:00
Peli de Halleux	7f27432222	Merge branch 'master' of https://github.com/Microsoft/pxt-microbit	2016-12-08 00:12:49 -08:00
Peli de Halleux	870b26a85a	updated lessons to use radio	2016-12-08 00:10:00 -08:00
Abhijith Chatra	aa6cb58dca	Merge pull request #320 from Microsoft/delete Placement new occurances need explicit delete	2016-12-07 18:09:35 -08:00
Abhijith	6398a42dad	Placement new occurances need explicit delete	2016-12-07 18:00:03 -08:00
Sam El-Husseini	cfc3eae77c	adding monacotoolboxbuttons margin	2016-12-07 17:03:28 -08:00
Sam El-Husseini	438b745d32	Merge branch 'master' into pr/monacotoolbox	2016-12-07 17:02:07 -08:00
Richard Knoll	21473f5b9b	Fixing array deallocation leak (#317 ) * Fixing array deallocation leak * Moving delete down to the individual destroy methods	2016-12-07 15:44:35 -08:00
Peli de Halleux	c85b6f9507	using calibrated powers for Eddystone	2016-12-07 11:37:33 -08:00
Peli de Halleux	019b00209e	moving blocks to advanced	2016-12-07 09:49:19 -08:00
Peli de Halleux	6c11dbcdf4	added setTransmitPower in BLE	2016-12-07 09:05:03 -08:00
Peli de Halleux	91197c5cec	updated BLE settings	2016-12-07 08:07:08 -08:00
Peli de Halleux	9e5d9787c7	linking to pxt issue tracker	2016-12-06 21:51:51 -08:00
Sam El-Husseini	1c11a4823b	adjusting the blockly flyout opacity.	2016-12-06 21:48:21 -08:00
Peli de Halleux	d457c3e8d0	exposing delete in blocks	2016-12-06 16:19:35 -08:00
Sam El-Husseini	2ae21efb7b	Moving blockly toolbox button margins to target.	2016-12-06 15:06:16 -08:00
Owen Brotherwood	30211aa006	Correction for max. length of advertised url to 17 https://github.com/google/eddystone/tree/master/eddystone-url#frame-specification states 1-17 When one makes a general google for the max length, some have written 18 and some 17 :( The difference could lie in the https://github.com/google/eddystone/tree/master/eddystone-url#url-scheme-prefix which adds an extra byte but it's use is to in someway allow for more bytes in the 1-17. The implementation in the micro:bit Lancaster is unknown as to how the url-scheme-prefix is or is not used: there does not seem to be a scheme for "Just take the 1-17" for the url. At the moment, "play it safe" and write 17 ?	2016-12-06 20:51:44 +01:00
Peli de Halleux	485a42758c	0.6.31	2016-12-06 11:32:24 -08:00
Peli de Halleux	0da5a5a349	Bump pxt-core to 0.5.91	2016-12-06 11:32:22 -08:00
Sam El-Husseini	efca68672a	Support for monaco toolbox	2016-12-06 00:34:42 -08:00
Sam El-Husseini	41ce2f66fa	removing add package less variable	2016-12-05 23:55:46 -08:00
Sam El-Husseini	9393fc166e	Styling add package and undo blockly buttons	2016-12-05 21:24:57 -08:00
Sam El-Husseini	cfb4382941	support for monaco toolbox	2016-12-05 19:01:14 -08:00
Sam El-Husseini	aaca24ff5b	using add package color less variable	2016-12-05 18:09:23 -08:00
Sam El-Husseini	0ce9be1a2b	removing toolbox right border.	2016-12-05 17:59:20 -08:00
Sam El-Husseini	a88eb7fe02	Changing main menu color, primary color and adding tiny borders around blockly toolbox	2016-12-05 17:30:04 -08:00
Peli de Halleux	06e4f7fb5c	Updated BLE project settings	2016-12-05 15:33:40 -08:00
Peli de Halleux	1b36485208	0.6.30	2016-12-05 15:10:13 -08:00
Peli de Halleux	3b54cefa95	Merge branch 'master' of https://github.com/Microsoft/pxt-microbit	2016-12-05 15:02:51 -08:00
Peli de Halleux	52857c9541	added beacon configuration	2016-12-05 15:02:39 -08:00
Sam El-Husseini	d10c2a20bd	More IE fixes. Using important to override blocky related CSS.	2016-12-05 13:43:57 -08:00
Peli de Halleux	e2482cdf91	0.6.29	2016-12-05 13:22:06 -08:00
Peli de Halleux	c045d87e4c	Bump pxt-core to 0.5.90	2016-12-05 13:22:03 -08:00
Peli de Halleux	34e23934b0	better bluetooth settings	2016-12-05 13:02:11 -08:00
Peli de Halleux	354196e01e	missing block annotation on led.enable	2016-12-05 09:17:42 -08:00
Peli de Halleux	bb2e8d0aef	'devices' depends on 'bluetooth'	2016-12-05 09:05:54 -08:00
Peli de Halleux	90f4e895d4	0.6.28	2016-12-03 23:22:42 -08:00
Peli de Halleux	58c554caa6	Bump pxt-core to 0.5.88	2016-12-03 23:22:40 -08:00
Sam El-Husseini	6c688a7e59	Fix Edge / IE issue where the blockly toolbox background isn't respected.	2016-12-02 18:33:42 -08:00
Abhijith	71244065bb	0.6.27	2016-12-02 13:20:00 -08:00
Abhijith Chatra	bbb1bc3dd7	Merge pull request #314 from Microsoft/pr/theming Theming the microbit target	2016-12-02 13:18:10 -08:00
Peli de Halleux	806d0e2cff	0.6.26	2016-12-02 12:58:15 -08:00
Peli de Halleux	e0c4af1cae	Bump pxt-core to 0.5.87	2016-12-02 12:58:13 -08:00
Peli de Halleux	475821564e	fixing justworks support	2016-12-02 09:45:59 -08:00
Sam El-Husseini	9d65dd605b	Monaco editor theming.	2016-12-01 22:05:37 -08:00
Sam El-Husseini	67eec44411	Minor fixes.	2016-12-01 21:58:16 -08:00
Sam El-Husseini	280b555f86	Theming the microbit target	2016-12-01 18:35:10 -08:00
Peli de Halleux	2fcd32de0d	0.6.25	2016-11-30 23:36:40 -08:00
Peli de Halleux	78694e86a2	0.6.24	2016-11-30 16:07:34 -08:00
Peli de Halleux	aeaa3d7bc1	updated localization files	2016-11-30 16:07:04 -08:00
Peli de Halleux	af8ce3fccf	allow for double, breve note durations	2016-11-30 16:06:17 -08:00
`@ -11,4 +11,4 @@ Math.random(5);`

	`## See Also`	`## See Also`

	`[logic](/blocks/logic), [loops](/blocks/loops), [math](/blocks/math), [variables](/blocks/variables)`	`[logic](/blocks/logic), [loops](/blocks/loops), [math](/blocks/math), [variables](/blocks/variables), [on-start](/blocks/on-start)`