0.2.45

.travis.yml

@@ -2,9 +2,9 @@ language: node_js
 node_js:
   - "5.7.0"
 script:
-  - "node node_modules/kindscript/built/kind.js travis"  
-  - "(cd libs/lang-test0; node ../../node_modules/kindscript/built/kind.js run)"
-  - "node node_modules/kindscript/built/kind.js uploaddoc"
+  - "node node_modules/pxt-core/built/pxt.js travis"  
+  - "(cd libs/lang-test0; node ../../node_modules/pxt-core/built/pxt.js run)"
+  - "node node_modules/pxt-core/built/pxt.js uploaddoc"
 sudo: false
 notifications:
   email:

.vscode/tasks.json

@@ -1,7 +1,7 @@
 {
 	"version": "0.1.0",
 	// Task runner is jake
-	"command": "kind",
+	"command": "pxt",
 	// Need to be executed in shell / cmd
 	"isShellCommand": true,
 	"showOutput": "always",

README.md

@@ -1,48 +1,10 @@
 # micro:bit target for KindScript
 
-This target allow to program a [BBC micro:bit](https://www.microbit.co.uk/) using [KindScript](https://github.com/Microsoft/kindscript).
+This target allow to program a [BBC micro:bit](https://www.microbit.co.uk/) using 
+[Microsoft Programming Experience Toolkit](https://github.com/Microsoft/pxt).
 
-[![Build Status](https://travis-ci.org/Microsoft/kindscript-microbit.svg?branch=master)](https://travis-ci.org/Microsoft/kindscript-microbit)
+[![Build Status](https://travis-ci.org/Microsoft/pxt-microbit.svg?branch=master)](https://travis-ci.org/Microsoft/pxt-microbit)
 
 # Getting started
 
-> If you're making changes to kindscript repository itself, proceed to **Local installation** below.
-
-* Clone this repo and run
-
-```
-npm install
-```
-
-* Install the `KindScript` tool and launch the local server:
-
-```
-npm install -g kindscript-cli
-kind serve
-```
-To re-build the `built/target.json` file, re-run `kind serve`.
-
-
-## Local installation
-
-* Clone and build [KindScript](https://github.com/Microsoft/kindscript) in a `kindscript` folder.
-* Clone this repo  in a `kindscript-microbit` folder next to `kindscript`
-
-```
-npm install
-```
-* To build and deploy new changes
-
-```
-npm install -g kindscript-cli
-cd ../kindscript
-jake
-cd ../kindscript-microbit
-npm link ../kindscript
-```
-* run this command to build and launch a local editor
-
-```
-kind serve
-```
-* open `localhost:3232` to try your editor!
+Please follow instructions at https://github.com/Microsoft/pxt#running-a-target-from-localhost 

cmds/cmds.ts

@@ -1,4 +1,4 @@
-/// <reference path="../node_modules/kindscript/built/kind.d.ts"/>
+/// <reference path="../node_modules/pxt-core/built/pxt.d.ts"/>
 
 import * as fs from 'fs';
 import * as path from 'path';
@@ -7,7 +7,7 @@ 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)
 
-export function deployCoreAsync(res: ts.ks.CompileResult) {
+export function deployCoreAsync(res: ts.pxt.CompileResult) {
     return getBitDrivesAsync()
         .then(drives => {
             if (drives.length == 0) {
@@ -40,4 +40,4 @@ function getBitDrivesAsync(): Promise<string[]> {
     } else {
         return Promise.resolve([])
     }
-}
+}

docs/about.md

@@ -1,3 +1,8 @@
+```sim
+basic.forever(() => {
+  basic.showString("Hi!");
+})
+``` 
 # About
 
 The [BBC micro:bit](https://www.microbit.co.uk) is a [pocket-size computer](/device) with a 5x5 display of 25 LEDs, Bluetooth and sensors that can be programmed by anyone.

docs/lessons.md

@@ -1,5 +1,6 @@
 # Lessons 
 
+
 ### @short Lessons
 
 ### ~column 

docs/lessons/answering-machine.md

@@ -22,12 +22,9 @@ Learn how to creating a message with a **string**, `show string` to write your m
 
 ## Documentation
 
-```docs
+```cards
 basic.showString('Hi!')
-
-input.onButtonPressed(Button.A, () => {
-    
-})
+input.onButtonPressed(Button.A, () => {})
 
 ```
 

docs/lessons/beautiful-image.md

@@ -20,7 +20,7 @@ Learn how to **show LEDs**,  to show an image on the BBC micro:bit's LED screen.
 
 ## Documentation
 
-```docs
+```cards
 basic.showLeds(`
     . . . . .
     . . . . .
@@ -28,10 +28,7 @@ basic.showLeds(`
     . . . . .
     . . . . .
     `)
-
-
 basic.pause(100)
-
 ```
 
 ## Objectives

docs/lessons/blink.md

@@ -23,18 +23,11 @@ Learn how to control a blinking LED. We will be learning how to create a blinkin
 
 ## Documentation
 
-```docs
+```cards
 led.plot(0, 0)
-
 led.unplot(0, 0)
-
 basic.pause(100)
-
-basic.forever(() => {
-    
-})
-
-
+basic.forever(() => {})
 ```
 
 

docs/lessons/charting.md

@@ -17,23 +17,13 @@ Learn the functions of **on data received**, **send number** and **receive numbe
 
 ## Documentation
 
-```docs
-
+```cards
 basic.showNumber(0)
-
 input.acceleration(Dimension.X)
-
 led.plotBarGraph(0, 1023)
-
-radio.onDataReceived(() => {
-
-
-})
-
+radio.onDataReceived(() => {})
 radio.sendNumber(0)
-
 radio.receiveNumber()
-
 ```
 
 ## Objectives

docs/lessons/compass.md

@@ -21,17 +21,12 @@ Learn how to use an if statements to run code run code depending on whether a co
 
 ## Documentation
 
-```docs
+```cards
 input.compassHeading()
-
 basic.forever(() => {})
-
 let x = 0
-
 if (true) {}
-
 basic.showString("Hello!")
-
 basic.showLeds(`
     . . . . .
     . . . . .

docs/lessons/counter.md

@@ -21,22 +21,12 @@ Learn how to creating a **variable** to keep track of the current count. We will
 
 ## Documentation
 
-```docs
+```cards
 input.compassHeading()
-
-basic.forever(() => {
-
-
-})
-
+basic.forever(() => {})
 let x = 0
-
-if (true) {
-
-}
-
+if (true) {}
 basic.showString("Hello!")
-
 basic.showLeds(`
     . . . . .
     . . . . .
@@ -44,7 +34,6 @@ basic.showLeds(`
     . . . . .
     . . . . .
     `)
-
 ```
 
 * **variable**: [read more...](/microbit/reference/variables/var)

docs/lessons/die-roll.md

@@ -21,21 +21,11 @@ Learn how to use an if statements to run code run code depending on whether a co
 
 ## Documentation
 
-```docs
-
-input.onGesture(Gesture.Shake, () => {
-
-})
-
-
-
+```cards
+input.onGesture(Gesture.Shake, () => {})
 let x = 0
-x = Math.random(3)
-
-if (true) {
-
-}
-
+Math.random(3)
+if (true) {}
 basic.showLeds(`
     . . . . .
     . . . . .
@@ -43,10 +33,6 @@ basic.showLeds(`
     . . . . .
     . . . . .
     `)
-
-
-
-
 ```
 
 ## Objectives

docs/lessons/digi-yoyo.md

@@ -21,13 +21,11 @@ Learn how to creating a **while loop**, `while condition do` to repeat code whil
 
 ## Documentation
 
-```docs
+```cards
 let x = 0
 basic.showNumber(0)
-while (true) {
-
-    basic.pause(20)
-}
+while (true) {}
+basic.pause(20)
 ```
 
 ## Objectives

docs/lessons/flashing-heart.md

@@ -20,13 +20,8 @@ Learn how to `show LEDs` by showing an image on the LED screen. We will be learn
 
 ## Documentation
 
-```docs
-basic.forever(() => {
-
-
-})
-
-
+```cards
+basic.forever(() => {})
 basic.showLeds(`
     . . . . .
     . . . . .
@@ -34,11 +29,8 @@ basic.showLeds(`
     . . . . .
     . . . . .
     `)
-
 basic.pause(100)
-
 basic.clearScreen()
-
 ```
 
 ## Objectives

docs/lessons/game-counter.md

@@ -19,15 +19,10 @@ Learn how to create game blocks to keep track of the current score. We will be l
 
 ## Documentation
 
-```docs
+```cards
 game.addScore(1)
-
-input.onButtonPressed(Button.A, () => {
-
-})
-
+input.onButtonPressed(Button.A, () => {})
 basic.showNumber(0)
-
 ```
 
 ## Objectives

docs/lessons/game-of-chance.md

@@ -18,15 +18,10 @@ Learn how to creating a message with a **game over** to write your message. We w
 ## Documentation
 
 
-```docs
+```cards
 game.gameOver()
-
 basic.showString("Hello!")
-
-input.onButtonPressed(Button.A, () => {
-    
-})
-
+input.onButtonPressed(Button.A, () => {})
 ```
 
 ## Objectives

docs/lessons/glowing-pendulum.md

@@ -19,21 +19,12 @@ Learn how to get the acceleration **acceleration**, `acceleration` value (g-forc
 
 ## Documentation
 
-```docs
-
-basic.forever(() => {
-
-
-})
-
+```cards
+basic.forever(() => {})
 let x = 0
-
 input.acceleration(Dimension.X)
-
 Math.abs(0)
-
 led.setBrightness(255)
-
 basic.showLeds(`
     . . . . .
     . . . . .
@@ -41,7 +32,6 @@ basic.showLeds(`
     . . . . .
     . . . . .
     `)
-
 ```
 
 ## Objectives

docs/lessons/guess-the-number.md

@@ -21,22 +21,12 @@ Learn how to create numbers randomly by using the input of the BBC micro:bit. We
 
 ## Documentation
 
-```docs
-
-input.onButtonPressed(Button.A, () => {
-
-
-})
-
+```cards
+input.onButtonPressed(Button.A, () => {})
 let x = 0
-
 basic.showNumber(0)
-
 Math.random(3)
-
 basic.clearScreen()
-
-
 ```
 
 ## Objectives

docs/lessons/looper.md

@@ -26,10 +26,8 @@ Learn how to control a blinking LED. We will be learning how to create a blinkin
 
 ## Documentation
 
-```docs
-for (let i = 0; i < 5; i++) {
-
-}
+```cards
+for (let i = 0; i < 5; i++) {}
 basic.showNumber(0)
 basic.pause(100)
 

docs/lessons/love-meter.md

@@ -22,19 +22,11 @@ Learn how to use the **pin pressed**, `on pin pressed` to run code when the user
 
 ## Documentation
 
-```docs
-if (true) {
-
-}
-
-input.onPinPressed(TouchPin.P0, () => {
-
-})
+```cards
+if (true) {}
+input.onPinPressed(TouchPin.P0, () => {})
 let x = 0
 Math.random(3)
 basic.showNumber(0)
 basic.pause(100)
-
-
-
 ```

docs/lessons/magic-8.md

@@ -19,14 +19,10 @@ Learn how to creating **conditionals**, `if condition do` to conditionally run c
 
 ## Documentation
 
-```docs
-if (true) {
-
-}
+```cards
+if (true) {}
 Math.random(3)
-input.onGesture(Gesture.Shake, () => {
-
-})
+input.onGesture(Gesture.Shake, () => {})
 basic.showNumber(7)
 basic.clearScreen()
 basic.showString("Hello!")

docs/lessons/magic-logo.md

@@ -20,13 +20,9 @@ On Logo Up
 Learn how to plot image **on logo up**, `on logo up` to run code when the micro:bit screen is facing up and vertically orientated. We will be learning how to plot an image with the logo up, basic show LEDs, and logo down.
 
 ## Documentation
-```docs
-input.onLogoUp(() => {
-
-})
-input.onLogoDown(() => {
-    
-})
+```cards
+input.onLogoUp(() => {})
+input.onLogoDown(() => {})
 basic.showLeds(`
     . . . . .
     . . . . .
@@ -34,8 +30,6 @@ basic.showLeds(`
     . . . . .
     . . . . .
     `)
-
-
 ```
 
 ## Objectives

docs/lessons/night-light.md

@@ -21,11 +21,9 @@ Learn how to **set brightness** of an image `set brightness` to set the brightne
 
 ## Documentation
 
-```docs
+```cards
 led.setBrightness(255)
-input.onButtonPressed(Button.A, () => {
-
-})
+input.onButtonPressed(Button.A, () => {})
 basic.showLeds(`
     . . . . .
     . . . . .
@@ -33,7 +31,6 @@ basic.showLeds(`
     . . . . .
     . . . . .
     `)
-
 ```
 
 ## Objectives

docs/lessons/pogo.md

@@ -15,14 +15,13 @@ Running Time
 Learn how to use running time. We will be learning how to create a pogo game using variables, forever loop, conditionals, on button pressed, as well as simple commands, such as show LEDs and clear screen.
 
 ## Documentation
-```docs
+```cards
 let jumps = 0
 let acc = input.acceleration(Dimension.Y)
-basic.showNumber(jumps)
-basic.showNumber(radio.receiveNumber())
+basic.showNumber(0)
+radio.receiveNumber()
 led.stopAnimation()
-jumps = jumps + 1;
-radio.sendNumber(jumps)
+radio.sendNumber(0)
 basic.forever(() => { })
 basic.showLeds(`
     . . . . .
@@ -32,11 +31,8 @@ basic.showLeds(`
     . # # # .
     `)
 basic.clearScreen()
-if (acc > 2000) {
-
-}
+if (true) {}
 radio.onDataReceived(() => { })
-
 ```
 ## Objectives
 

docs/lessons/rock-paper-scissors.md

@@ -23,10 +23,8 @@ Learn how to create a **local variable**, `var t :=time` where you can store dat
 
 ## Documentation
 
-```docs
-input.onGesture(Gesture.Shake, () => {
-
-})
+```cards
+input.onGesture(Gesture.Shake, () => {})
 Math.random(3)
 let x = 0
 basic.showLeds(`

docs/lessons/rotation-animation.md

@@ -19,11 +19,9 @@ Learn how to create images that look like a rotating animation by using a while
 
 ## Documentation
 
-```docs
+```cards
 let x = 0
-input.onButtonPressed(Button.A, () => {
-
-})
+input.onButtonPressed(Button.A, () => {})
 basic.showLeds(`
     . . . . .
     . . . . .
@@ -32,10 +30,8 @@ basic.showLeds(`
     . . . . .
     `)
 basic.pause(100)
-while (true) {
-
-    basic.pause(20)
-}
+while (true) {}
+basic.pause(20)
 ```
 
 ## Objectives

docs/lessons/screen-wipe.md

@@ -23,7 +23,7 @@ Learn how to **clear screen**, `clear screen` to turn off all the LED lights on
 
 ## Documentation
 
-```docs
+```cards
 basic.clearScreen()
 basic.showLeds(`
     . . . . .
@@ -32,10 +32,7 @@ basic.showLeds(`
     . . . . .
     . . . . .
     `)
-input.onButtonPressed(Button.A, () => {
-    
-})
-
+input.onButtonPressed(Button.A, () => {})
 ```
 
 ## Objectives

docs/lessons/smiley.md

@@ -24,10 +24,8 @@ Learn how to **show LEDs** to turn on a LED light pattern on the LED screen. We
 * **show LEDs** : [read more...](/microbit/reference/basic/show-leds)
 * **on button pressed** : [read more...](/microbit/reference/input/on-button-pressed)
 
-```docs
-input.onButtonPressed(Button.A, () => {
-
-})
+```cards
+input.onButtonPressed(Button.A, () => {})
 basic.showLeds(`
     . . . . .
     . . . . .
@@ -35,7 +33,6 @@ basic.showLeds(`
     . . . . .
     . . . . .
     `)
-
 ```
 
 ## Objectives

docs/lessons/snowflake-fall.md

@@ -25,7 +25,7 @@ Learn how to show LEDs with a, `pause` to pause program execution for a specifie
 * **pause** : [read more...](/microbit/reference/basic/pause)
 * **forever** : [read more...](/microbit/reference/basic/forever)
 
-```docs
+```cards
 basic.showLeds(`
     . . . . .
     . . . . .
@@ -34,8 +34,5 @@ basic.showLeds(`
     . . . . .
     `)
 basic.pause(100)
-basic.forever(() => {
-    
-})
-
+basic.forever(() => {})
 ```

docs/lessons/spinner.md

@@ -22,14 +22,10 @@ Learn how to use an if statement to run code run code depending on whether a con
 ## Documentation
 
 
-```docs
-if (true) {
-
-}
+```cards
+if (true) {}
 let x = 0
-input.onGesture(Gesture.Shake, () => {
-
-})
+input.onGesture(Gesture.Shake, () => {})
 Math.random(3)
 basic.showLeds(`
     . . . . .

docs/lessons/strobe-light.md

@@ -17,14 +17,11 @@ For Loop
 
 ## Documentation
 
-```docs
+```cards
 led.plot(0, 0)
 led.unplot(0, 0)
-for (let i = 0; i < 5; i++) {
-
-}
+for (let i = 0; i < 5; i++) {}
 basic.pause(100)
-
 ```
 
 ## Objectives

docs/lessons/temperature.md

@@ -17,15 +17,12 @@ Learn how to get the ambient temperature (degree Celsius °C). The temperature i
 
 ## Documentation
 
-```docs
+```cards
 input.temperature()
 let x = 0
 basic.showNumber(7)
 basic.showString("Hello!")
-input.onGesture(Gesture.Shake, () => {
-    
-})
-
+input.onGesture(Gesture.Shake, () => {})
 ```
 
 ## Objectives

docs/lessons/truth-or-dare.md

@@ -21,7 +21,7 @@ Learn how to use an if statement to run code run code depending on whether a con
 
 ## Documentation
 
-```docs
+```cards
 basic.showLeds(`
     . . . . .
     . . . . .
@@ -29,16 +29,11 @@ basic.showLeds(`
     . . . . .
     . . . . .
     `)
-input.onButtonPressed(Button.A, () => {
-
-})
+input.onButtonPressed(Button.A, () => {})
 let x = 0
 Math.random(3)
-if (true) {
-
-}
+if (true) {}
 basic.showString("Hello!")
-
 ```
 
 ## Objectives

docs/lessons/zoomer.md

@@ -21,7 +21,7 @@ Learn how to get the **acceleration**, `acceleration` in one of three specified
 
 ## Documentation
 
-```docs
+```cards
 basic.forever(() => {
 })
 let x = 0

docs/reference.md

@@ -1,460 +1,17 @@
 # Reference
 
-### @section full
-
-### ~column 
-
-### Basic
-
-[show number](/microbit/reference/basic/show-number)
-
-~~~~block
-basic.showNumber(2)
-~~~~
-
-[show string](/microbit/reference/basic/show-string)
-
-~~~~block
-basic.showString('Hello!')
-~~~~
-
-[show LEDs](/microbit/reference/basic/show-leds)
-
-~~~~block
-basic.showLeds(`. . . . . 
-. # . # . 
-. . . . . 
-# . . . # 
-. # # # .`)
-~~~~
-
-[clear screen](/microbit/reference/basic/clear-screen)
-
-~~~~block
-basic.clearScreen()
-~~~~
-
-[forever](/microbit/reference/basic/forever)
-
-~~~~block
-basic.forever(() => { })
-~~~~
-
-[pause](/microbit/reference/basic/pause)
-
-```block
-basic.pause(200)
-```
-
-### Input
-
-[on button pressed](/microbit/reference/input/on-button-pressed)
-
-```block
-input.onButtonPressed(Button.A, () => {})
-```
-
-[on pin pressed](/microbit/reference/input/on-pin-pressed)
-
-```block
-input.onPinPressed(TouchPin.P0, () => {})
-```
-
-[on shake](/microbit/reference/input/on-shake)
-
-![](/static/mb/blocks/contents-22.jpg)
-
-[on logo up](/microbit/reference/on-logo-up)
-
-![](/static/mb/on-logo-up-0.jpg)
-
-[on logo down](/microbit/reference/on-logo-down)
-
-![](/static/mb/on-logo-down-0.jpg)
-
-[on screen up](/microbit/reference/on-screen-up)
-
-![](/static/mb/on-screen-up-0.jpg)
-
-[on screen down](/microbit/reference/on-screen-down)
-
-![](/static/mb/on-screen-down-0.jpg)
-
-[button is pressed](/microbit/reference/button-is-pressed)
-
-![](/static/mb/button-is-pressed-0.png)
-
-[compass heading](/microbit/reference/compass-heading)
-
-![](/static/mb/compass-heading-0.png)
-
-[temperature](/microbit/reference/temperature)
-
-![](/static/mb/temperature-0.png)
-
-[acceleration](/microbit/reference/input/acceleration)
-
-![](/static/mb/acceleration-0.png)
-
-[rotation](/microbit/reference/rotation)
-
-![](/static/mb/rotation-0.png)
-
-[magnetic force](/microbit/reference/magnetic-force)
-
-![](/static/mb/magnetic-force-0.png)
-
-[running time](/microbit/reference/running-time)
-
-![](/static/mb/running-time-0.png)
-
-### Loops
-
-[for](/microbit/reference/loops/for)
-
-```block
-for(let i = 0;i<5;i++) {}
-```
-
-[repeat](/microbit/reference/loops/repeat)
-
-![](/static/mb/blocks/contents-0.png)
-
-[while](/microbit/reference/loops/while)
-
-```block
-while(true) {}
-```
-
-[forever](/microbit/reference/basic/forever)
-
-```block
-basic.forever(() => {})
-```
-
-
-
-### ~
-
-### ~column 
-
-### Logic
-
-[if](/microbit/reference/logic/if)
-
-```block
-if(false) {
-}
-```
-
-[Boolean](/microbit/reference/types/boolean) values: *true*; *false*
-
-```block
-true
-false
-```
-
-Boolean binary operators: *and* (conjunction); *or* (disjunction)
-
-```block
-true && false;
-true || false;
-```
-
-Boolean negation operator
-
-```block
-!true
-```
-
-Comparison operators (=, !=, <, >, <=, >=)
-
-```block
-0 == 0;
-1 !- 0;
-0 < 1;
-1 > 0;
-0 <= 1;
-1 >= 0;
-```
-
-### Variables
-
-[Assign](/microbit/reference/variables/assign) (set) a variable's value
-
-```block
+```namespaces
+basic.showString("Hello!");
+input.onButtonPressed(Button.A, () => {});
+for (let i = 0;i<5;++i) {}
+if (true){}
 let x = 0;
-```
-
-Get a variable's value
-
-```block
-let x = 0;
-x;
-```
-
-[Change](/microbit/reference/variables/change-var) a variable's value
-
-```block
-let x = 0;
-x+=1;
-```
-
-### Math
-
-[Numeric](/microbit/reference/types/number) values: 0, 1, 2, ...
-
-```block
-0;
-1;
-2;
-```
-
-Arithmetic binary operation (+, -, *, /)
-
-```block
-0+1;
-0-1;
-1*2;
-3/4;
-```
-
-Absolute value
-
-```block
-Math.abs(-5);
-```
-
-Minimum/maximum of two values
-
-```block
-Math.min(0, 1);
-Math.max(0, 1);
-```
-
-Random value
-
-```block
 Math.random(5);
+led.plot(0,0);
+radio.sendNumber(0);
+music.playTone(music.noteFrequency(Note.C), music.beat(BeatFraction.Whole));
+game.createSprite(2,2);
+pins.digitalReadPin(DigitalPin.P0);
+serial.writeLine("Hello!");
+control.inBackground(() => {});
 ```
-
-### LED
-
-[plot](/microbit/reference/led/plot)
-
-```block
-led.plot(2,2)
-```
-
-[unplot](/microbit/reference/led/unplot)
-
-```block
-led.unplot(2,2)
-```
-
-[point](/microbit/reference/point)
-
-```block
-led.point(2,2)
-```
-
-[brightness](/microbit/reference/brightness)
-
-```block
-led.brightness()
-```
-
-[set brightness](/microbit/reference/set-brightness)
-
-```block
-led.setBrightness(255)
-```
-
-[stop animation](/microbit/reference/stop-animation)
-
-```block
-led.stopAnimation()
-```
-
-[plot bar graph](/microbit/reference/led/plot-bar-graph)
-
-```block
-led.plotBarGraph(0, 1023)
-```
-
-### Game
-
-[create sprite](/microbit/reference/game/create-sprite)
-
-![](/static/mb/create-sprite-0.png)
-
-[move](/microbit/reference/game/move)
-
-![](/static/mb/game-library/move-0.png)
-
-[turn](/microbit/reference/game/turn)
-
-![](/static/mb/game-library/turn-0.png)
-
-[change](/microbit/reference/game/change)
-
-![](/static/mb/change-0.png)
-
-[set](/microbit/reference/game/set)
-
-![](/static/mb/blocks/contents-21.png)
-
-[reports](/microbit/reference/reports)
-
-![](/static/mb/game-library/position-0.png)
-
-[touching](/microbit/reference/touching)
-
-![](/static/mb/game-library/touching-0.png)
-
-[touching edge](/microbit/reference/touching-edge)
-
-![](/static/mb/game-library/touching-edge-0.png)
-
-[if on edge, bounce](/microbit/reference/logic/if-on-edge-bounce)
-
-![](/static/mb/game-library/if-on-edge-bounce-0.png)
-
-[change score by](/microbit/reference/change-score-by)
-
-![](/static/mb/game-library/pic1.png)
-
-[score](/microbit/reference/score)
-
-![](/static/mb/game-library/pic2.png)
-
-[start countdown](/microbit/reference/start-countdown)
-
-![](/static/mb/game-library/pic3.png)
-
-[game over](/microbit/reference/game-over)
-
-![](/static/mb/game-library/pic0.png)
-
-### Music
-
-[play tone](/microbit/reference/play-tone)
-
-![](/static/mb/play-tone-0.jpg)
-
-[ring tone](/microbit/reference/ring-tone)
-
-![](/static/mb/ring-tone-0.jpg)
-
-[rest](/microbit/reference/rest)
-
-![](/static/mb/rest-0.jpg)
-
-[tempo](/microbit/reference/tempo)
-
-![](/static/mb/tempo-0.jpg)
-
-[set tempo](/microbit/reference/set-tempo)
-
-![](/static/mb/change-tempo-0.jpg)
-
-[change tempo](/microbit/reference/music/set-tempo)
-
-![](/static/mb/change-tempo-by-0.jpg)
-
-### Comments
-
-[comment](/microbit/reference/comment)
-
-### Images
-
-[show image](/microbit/reference/show-image)
-
-![](/static/mb/show-image-0.png)
-
-[scroll image](/microbit/reference/scroll-image)
-
-![](/static/mb/scroll-image-0.png)
-
-[create image](/microbit/reference/create-image)
-
-![](/static/mb/create-image-0.png)
-
-
-### ~
-
-### ~column 
-
-### Pins
-
-[digital read pin](/microbit/reference/pins/digital-read-pin)
-
-![](/static/mb/digital-read-pin-0.png)
-
-[digital write pin](/microbit/reference/pins/digital-write-pin)
-
-![](/static/mb/digital-write-pin-0.png)
-
-[analog read pin](/microbit/reference/pins/analog-read-pin)
-
-![](/static/mb/analog-read-pin-0.png)
-
-[analog write pin](/microbit/reference/pins/analog-write-pin)
-
-![](/static/mb/blocks/contents-23.png)
-
-[analog set period](/microbit/reference/pins/analog-set-period)
-
-![](/static/mb/analog-set-period-0.png)
-
-[servo write pin](/microbit/reference/pins/servo-write-pin)
-
-![](/static/mb/servo-write-pin-0.png)
-
-[servo set pulse](/microbit/reference/pins/servo-set-pulse)
-
-![](/static/mb/servo-set-pulse-0.png)
-
-[map](/microbit/reference/map)
-
-![](/static/mb/map-0.png)
-
-
-## Devices
-
-Functions in this category require to be connected to a remote device.
-
-[tell camera to](/microbit/reference/devices/tell-camera-to)
-
-![](/static/mb/tell-camera-to-0.png)
-
-[tell remote control to](/microbit/reference/devices/tell-remote-control-to)
-
-![](/static/mb/tell-remote-control-to-0.png)
-
-[raise alert to](/microbit/reference/devices/raise-alert-to)
-
-![](/static/mb/raise-alert-to-0.png)
-
-[on notified](/microbit/reference/on-notified)
-
-![](/static/mb/on-notified-0.png)
-
-[on gamepad button](/microbit/reference/on-gamepad-button)
-
-![](/static/mb/on-gamepad-button-0.png)
-
-[on notified](/microbit/reference/on-notified)
-
-![](/static/mb/on-notified-0.png)
-
-[signal strength](/microbit/reference/signal-strength)
-
-![](/static/mb/blocks/contents-24.png)
-
-[on signal strength changed](/microbit/reference/on-signal-strength-changed)
-
-![](/static/mb/blocks/contents-25.png)
-
-### ~
-

docs/reference/basic.md

@@ -0,0 +1,35 @@
+# Basic
+
+Provides access to basic micro:bit functionality.
+
+
+```cards
+basic.showNumber(0);
+basic.showLeds(`
+. . . . .
+. . . . .
+. . # . .
+. . . . .
+. . . . .
+`);
+basic.showString("Hello!");
+basic.clearScreen();
+basic.forever(() => {
+    
+});
+basic.pause(100);
+basic.plotLeds(`
+. . . . .
+. . . . .
+. . # . .
+. . . . .
+. . . . .
+`);
+basic.showAnimation(`
+. . . . .
+. . . . .
+. . # . .
+. . . . .
+. . . . .
+`);
+```

docs/reference/control.md

@@ -0,0 +1,11 @@
+# Control
+
+
+
+
+```cards
+control.inBackground(() => {
+    
+});
+control.reset();
+```

docs/reference/game.md

@@ -0,0 +1,12 @@
+# Game
+
+
+
+
+```cards
+game.addScore(1);
+game.score();
+game.startCountdown(10000);
+game.gameOver();
+game.setScore(0);
+```

docs/reference/images.md

@@ -0,0 +1,21 @@
+# Images
+
+
+
+
+```cards
+images.createImage(`
+. . . . .
+. . . . .
+. . # . .
+. . . . .
+. . . . .
+`);
+images.createBigImage(`
+. . . . .
+. . . . .
+. . # . .
+. . . . .
+. . . . .
+`);
+```

docs/reference/input.md

@@ -0,0 +1,42 @@
+# Input
+
+
+
+
+```cards
+input.onButtonPressed(Button.A, () => {
+    
+});
+input.onGesture(Gesture.Shake, () => {
+    
+});
+input.onPinPressed(TouchPin.P0, () => {
+    
+});
+input.buttonIsPressed(Button.A);
+input.compassHeading();
+input.temperature();
+input.acceleration(Dimension.X);
+input.lightLevel();
+input.rotation(Rotation.Pitch);
+input.magneticForce(Dimension.X);
+input.runningTime();
+input.setAccelerometerRange(AcceleratorRange.OneG);
+input.pinIsPressed(TouchPin.P0);
+input.calibrate();
+input.onLogoDown(() => {
+    
+});
+input.onLogoUp(() => {
+    
+});
+input.onScreenDown(() => {
+    
+});
+input.onScreenUp(() => {
+    
+});
+input.onShake(() => {
+    
+});
+```

docs/reference/js/serial-library.md

@@ -126,15 +126,3 @@ This is useful if you have something connected at the other end. As explained ab
 let msg = serial.readString()
 ```
 
-* reads an image
-
-```
-img = serial.readImage()
-```
-
-* reads the state of the screen from serial
-
-```
-serial.readScreen()
-```
-

docs/reference/led.md

@@ -0,0 +1,21 @@
+# Led
+
+
+
+
+```cards
+led.plot(0, 0);
+led.unplot(0, 0);
+led.point(0, 0);
+led.brightness();
+led.setBrightness(255);
+led.stopAnimation();
+led.plotBarGraph(0, 1023);
+led.fadeIn();
+led.fadeOut();
+led.plotAll();
+led.screenshot();
+led.toggle(0, 0);
+led.toggleAll();
+led.setDisplayMode(DisplayMode.BackAndWhite);
+```

docs/reference/logic.md

@@ -0,0 +1,39 @@
+# Logic
+
+[if](/microbit/reference/logic/if)
+
+```blocks
+if(true) {
+}
+```
+
+[Boolean](/microbit/reference/types/boolean) values: *true*; *false*
+
+```blocks
+true
+false
+```
+
+Boolean binary operators: *and* (conjunction); *or* (disjunction)
+
+```blocks
+true && false;
+true || false;
+```
+
+Boolean negation operator
+
+```blocks
+!true
+```
+
+Comparison operators (=, !=, <, >, <=, >=)
+
+```blocks
+0 == 0;
+1 !- 0;
+0 < 1;
+1 > 0;
+0 <= 1;
+1 >= 0;
+```

docs/reference/loops.md

@@ -0,0 +1,26 @@
+# Loops
+
+Repeat code.
+
+
+[for](/reference/loops/for)
+
+```blocks
+for(let i = 0;i<5;i++) {}
+```
+
+[repeat](/reference/loops/repeat)
+
+![](/static/mb/blocks/contents-0.png)
+
+[while](/reference/loops/while)
+
+```blocks
+while(true) {}
+```
+
+[forever](/reference/basic/forever)
+
+```blocks
+basic.forever(() => {})
+```

docs/reference/math.md

@@ -0,0 +1,37 @@
+# Math
+
+[Numeric](/reference/types/number) values: 0, 1, 2, ...
+
+```blocks
+0;
+1;
+2;
+```
+
+Arithmetic binary operation (+, -, *, /)
+
+```blocks
+0+1;
+0-1;
+1*2;
+3/4;
+```
+
+Absolute value
+
+```blocks
+Math.abs(-5);
+```
+
+Minimum/maximum of two values
+
+```blocks
+Math.min(0, 1);
+Math.max(0, 1);
+```
+
+Random value
+
+```blocks
+Math.random(5);
+```

docs/reference/music.md

@@ -0,0 +1,15 @@
+# Music
+
+
+
+
+```cards
+music.playTone(0, 0);
+music.ringTone(0);
+music.rest(0);
+music.noteFrequency(Note.C);
+music.beat();
+music.tempo();
+music.changeTempoBy(20);
+music.setTempo(120);
+```

docs/reference/pins.md

@@ -0,0 +1,17 @@
+# Pins
+
+
+
+
+```cards
+pins.digitalReadPin(DigitalPin.P0);
+pins.digitalWritePin(DigitalPin.P0, 0);
+pins.analogReadPin(AnalogPin.P0);
+pins.analogWritePin(AnalogPin.P0, 1023);
+pins.analogSetPeriod(AnalogPin.P0, 20000);
+pins.servoWritePin(AnalogPin.P0, 180);
+pins.servoSetPulse(AnalogPin.P0, 1500);
+pins.map(0, 0, 1023, 0, 4);
+pins.analogPitch(0, 0);
+pins.analogSetPitchPin(AnalogPin.P0);
+```

docs/reference/radio.md

@@ -0,0 +1,17 @@
+# Radio
+
+
+
+
+```cards
+radio.sendNumber(0);
+radio.sendNumbers(0, 0, 0, 0);
+radio.onDataReceived(() => {
+    
+});
+radio.receiveNumber();
+radio.receivedNumberAt(0);
+radio.receivedSignalStrength();
+radio.setGroup(0);
+radio.setTransmitPower(0);
+```

docs/reference/variables.md

@@ -0,0 +1,21 @@
+## Variables
+
+[Assign](/reference/variables/assign) (set) a variable's value
+
+```blocks
+let x = 0;
+```
+
+Get a variable's value
+
+```blocks
+let x = 0;
+x;
+```
+
+[Change](/reference/variables/change-var) a variable's value
+
+```blocks
+let x = 0;
+x+=1;
+```