0.2.107

Docs

.travis.yml

@@ -13,4 +13,5 @@ notifications:
 cache:
   directories:
     - node_modules
+    - built/cache
 

.vscode/settings.json

@@ -0,0 +1,5 @@
+// Place your settings in this file to overwrite default and user settings.
+{
+    "tslint.enable": true,
+    "tslint.rulesDirectory": "node_modules/tslint-microsoft-contrib"
+}

README.md

@@ -12,7 +12,7 @@ Please follow instructions at https://github.com/Microsoft/pxt#running-a-target-
 ## Universal Windows App
 
 The Windows 10 app is a [Universal Windows Hosted Web App](https://microsoftedge.github.io/WebAppsDocs/en-US/win10/CreateHWA.htm)
-that wraps codemicrobit.com and provides additional features.
+that wraps m.pxt.io and provides additional features.
 
 ### Sideloading
 

docs/_locales/pl/_theme.json

@@ -0,0 +1,22 @@
+{
+    "name": "koduj z micro:bit",
+    "title": "koduj z micro:bit",
+    "docMenu": [
+        {
+            "name": "O nas",
+            "path": "/about"
+        },
+        {
+            "name": "Lekcje",
+            "path": "/lessons"
+        },
+        {
+            "name": "Instrukcja obsługi",
+            "path": "/reference"
+        },
+        {
+            "name": "Urządzenie",
+            "path": "/device"
+        }
+    ]
+}

docs/_locales/pl/docs.md

@@ -0,0 +1,7 @@
+# Dokumentacja
+
+Witamy na stronach dokumentacji!
+
+* Przeglądnij [instrukcje obsługi](/reference)
+* Dowiedz się więcej o [urządzeniu](/device)
+* Wystartuj z [lekcjami](/lessons)

docs/device/crocodile-clips.md

@@ -11,9 +11,7 @@ This example displays a random number every time the crocodile clip holds  `GND`
 
 ### Connecting Crocodile Clips
 
-![](/static/mb/crocodile-clips-1.jpg)
 
-![](/static/mb/crocodile-clips-2.jpg)
 
 ### Lessons
 

docs/docs.md

@@ -2,6 +2,7 @@
 
 Welcome to the documentation.
 
-* Browse the [reference](/reference)
+* Browse the [API reference](/reference)
 * Learn more about the [device](/device)
 * Get started with [lessons](/lessons)
+* Learn about [libraries](/libraries) (possibly using C++)

docs/lessons.md

@@ -57,8 +57,10 @@
 * [Telegraph](/lessons/telegraph), play the telegraph game between two BBC micro:bits
 * [Pogo](/lessons/pogo), create a pogo game to test your jumping abilities
 
+## Science
+* [Charting](/lessons/charting), measure and chart acceleration
+
 ## Advanced
-* [Charting](/lessons/charting), create a charting app between 2 BBC micro:bits
 * [Prank WiFi](/lessons/prank-wifi), create fake WiFi to trick your friends
 * [Speed Button](/lessons/speed-button), code a speed game with running time
 * [Headbands](/lessons/headbands), create a charades game with a collection of strings that hold the words
@@ -69,4 +71,3 @@
 ### @section full
 
 The lessons promote computational thinking and computer science literacy[ read more...](/lessons/teach)
-

docs/lessons/answering-machine/challenges.md

@@ -21,7 +21,6 @@ basic.showString("ASK ME A QUESTION")
 input.onButtonPressed(Button.A, () => {
     basic.showString("Yes")
 })
-
 ```
 
 * `Run` the code to see if it works as expected.
@@ -45,7 +44,6 @@ input.onButtonPressed(Button.B, () => {
 
 * `Run` the code to see if it works as expected.
 
-**Challenge 3**
+### Challenge 3
 
 When you are asked a yes or no question, do you always say yes or no? Add a condition for `on shake` that displays `MAYBE`.
-

docs/lessons/answering-machine/quiz-answers.md

@@ -12,7 +12,6 @@ Answers may vary. This is a function that will show a string on the LED screen o
 
 ```blocks
 basic.showString("Y")
-
 ```
 
 ![](/static/mb/lessons/answering-machine-0.png)
@@ -22,7 +21,6 @@ basic.showString("Y")
 
 ```blocks
 basic.showString("Hi")
-
 ```
 
 ![](/static/mb/lessons/answering-machine-1.png)
@@ -35,7 +33,6 @@ basic.showString("Hi")
 
 ```blocks
 basic.showString("Z")
-
 ```
 
 

docs/lessons/beautiful-image/challenges.md

@@ -39,9 +39,9 @@ basic.showLeds(`
     `)
 ```
 
-* *Run* your code to see if it works as expected.
+* Does your code work as expected?
 
 ### Challenge 2
 
-Nice job! Why don't we create a third image that will show after the other two? Remember to add a pause before you create and show the image.
+Nice job! Why don't we create a third image that will show after the other two?
 

docs/lessons/bop-it/quiz-answers.md

@@ -12,17 +12,14 @@ Answer the questions while completing the tutorial. Pay attention to the dialogu
 
 ## 1. Write the code that will store the global variable named 'action' and returns a random number between 0 and 2
 
-<br/>
-
-```
-action = Math.random(3)
+```blocks
+let action = Math.random(3)
 ```
 
 ## 2. Write the code that will display the string, "PUSH A" if the global variable called 'action' is equal to 0
 
-<br />
-
-```
+```blocks
+let action = Math.random(3)
 if (action == 0) {
     basic.showString("PUSH A", 150)
 }
@@ -30,10 +27,9 @@ if (action == 0) {
 
 ## 3. Write the code that increments the score if button A is pressed when the global variable called 'action' is equal to 1
 
-<br />
-
-```
+```blocks
 input.onButtonPressed(Button.A, () => {
+    let action = Math.random(3)
     if (action == 0) {
         game.addScore(1)
     }
@@ -42,9 +38,8 @@ input.onButtonPressed(Button.A, () => {
 
 ## 4. Write the code that will display the string "LOGO DOWN" if the global variable called 'action' is equal to 1
 
-<br />
-
-```
+```blocks
+let action = Math.random(3)
 if (action == 1) {
     basic.showString("LOGO DOWN", 150)
 }
@@ -52,10 +47,9 @@ if (action == 1) {
 
 ## 5. Write the code that increments the score if the BBC micro:bit logo is tilted down when the global variable called 'action' is equal to 1
 
-<br />
-
-```
+```blocks
 input.onLogoDown(() => {
+    let action = Math.random(3)
     if (action == 1) {
         game.addScore(1)
     }
@@ -64,9 +58,8 @@ input.onLogoDown(() => {
 
 ## 6. Write the code that will display the string "SHAKE" if the global variable called 'action' is equal to 2
 
-<br />
-
-```
+```blocks
+let action = Math.random(3)
 if (action == 2) {
     basic.showString("SHAKE", 150)
 }
@@ -74,13 +67,11 @@ if (action == 2) {
 
 ## 7. Write the code that increments the score if the BBC micro:bit is shaken when the global variable called 'action' is equal to 2
 
-<br/>
-
-```
+```blocks
 input.onLogoDown(() => {
+    let action = Math.random(3)
     if (action == 1) {
         game.addScore(1)
     }
 })
 ```
-

docs/lessons/catch-the-egg-game.md

@@ -11,6 +11,7 @@ Variables
 ## Quick Links
 
 * [activity](/lessons/catch-the-egg-game/activity)
+* [tutorial](/lessons/catch-the-egg-game/tutorial)
 * [quiz](/lessons/catch-the-egg-game/quiz)
 * [quiz answers](/lessons/catch-the-egg-game/quiz-answers)
 
@@ -20,18 +21,21 @@ Learn how to create a catch the egg game game with **plot**, `led->plot` , **unp
 
 ## Documentation
 
-* **variables** : [read more...](/reference/variables/var)
-* **forever** : [read more...](/reference/basic/forever)
-* **unplot** : [read more...](/reference/led/unplot)
-* **plot** : [read more...](/reference/led/plot)
-* **if** : [read more...](/reference/logic/if)
-* **acceleration** : [read more...](/reference/input/acceleration)
-* **math minimum number** : [read more...](/reference/math)
-* **math maximum number** : [read more...](/reference/math)
-* **math random number** : [read more...](/reference/math)
-* **math modulus** : [read more...](/reference/math)
-* **show number** : [read more...](/reference/basic/show-number)
-* **pause** : [read more...](/reference/basic/pause)
+```cards
+let x = 2;
+led.unplot(0, 0);
+basic.forever(() => {});
+x += 1;
+led.plot(0, 0);
+basic.pause(300);
+input.acceleration(Dimension.X);
+Math.min(0,0);
+Math.max(0,1);
+Math.random(5);
+game.addScore(1);
+game.score();
+game.removeLife(1);
+```
 
 ## Objectives
 

docs/lessons/catch-the-egg-game/activity.md

@@ -1,7 +1,5 @@
 # catch the egg game challenges
 
-Coding challenges for catch the egg game.
-
 ## Before we get started
 
 Your starting code should look like this:

docs/lessons/catch-the-egg-game/tutorial.md

@@ -0,0 +1,29 @@
+# catch the egg game tutorial
+
+### Rebuild the game!
+
+The blocks have been shuffled! Put them back together so that...
+* an egg LED  falls from the top of the screen, row by row.
+* a basket LED is on the bottom row and can be moved by using the accelerometer `X` data.
+* if the egg LED reaches the last row, reset the egg position to the first row.
+
+```shuffle
+let basketX = 2
+let eggX = 2
+let eggY = 0
+basic.forever(() => {
+    led.unplot(basketX, 4)
+    led.unplot(eggX, eggY)
+    eggY = eggY + 1
+    led.plot(eggX, eggY)
+    basic.pause(300)
+    let accX = input.acceleration(Dimension.X)
+    basketX = 2 + Math.min(2, Math.max(-2, accX / 200))
+    led.plot(basketX, 4)
+    if (eggY > 4) {
+        eggY = -1
+        eggX = Math.random(5)
+    }
+    basic.pause(300)
+})
+```

docs/lessons/charting.md

@@ -1,15 +1,16 @@
 # charting lesson
 
-Measure the acceleration on the micro:bit in the "z" direction.
+Create a charting app for simulating and measuring the acceleration applied to the micro:bit
 
 ## Topic
 
 Acceleration
 
 ## Quick Links
-
-* [activity](/lessons/charting/activity)
-
+* [activity](/lessons/charting/acceleration) 
+* [challenge](/lessons/charting/challenge) 
+* [quiz](/lessons/charting/quiz) 
+* [answers](/lessons/charting/quiz-answers)
 
 ## Prior learning/place of lesson in scheme of work
 
@@ -18,9 +19,9 @@ Learn the functions of **on data received**, **send number** and **receive numbe
 ## Documentation
 
 ```cards
-basic.showNumber(0)
 input.acceleration(Dimension.X)
 led.plotBarGraph(0, 1023)
+basic.showNumber(0)
 radio.onDataReceived(() => {})
 radio.sendNumber(0)
 radio.receiveNumber()

docs/lessons/charting/activity.md

@@ -1,53 +1,85 @@
-# charting activity
+# Activity 
 
-Measure the acceleration on the micro:bit in the "z" direction. 
+Measure the acceleration on the micro:bit in the "x" direction. 
 
 ### ~avatar avatar
 
+Welcome! This activity will teach how to use the micro:bit to chart the acceleration in the "x" direction. Let's get started!
+
+
+### ~
+Let's measure `acceleration (mg)` in the "x" direction. Get the acceleration value (milli g-force), in one of three specified dimensions.
+
+
+```blocks
+input.acceleration(Dimension.X)
+
+```
+
+### ~
+Use the plot bar chart to visualize the acceleration on the LED screen of the micro:bit in the specified range. You implement plot Bar Graph to display a vertical bar graph based on the "value" and "high" value. Then you must insert acceleration in the X dimension to measure the acceleration. 
+
+```blocks
+basic.forever(() => {
+    led.plotBarGraph(input.acceleration(Dimension.X), 0)
+})
+
+```
+
+### ~
+Notice that moving the micro:bit in the simulator from left to right (x direction) changes the values beneath the micro:bit in a range from 1023 to -1023 as measured in milli-gravities. By hovering over the micro:bit from left to right, you can observe changing values beneath the micro:bit simulator. Also, the LEDs shown on the Bar Graph fluctates based on the movement of the micro:bit simulator in the x direction. The line underneath the micro:bit simulator reflect the acceleration in the x direction. 
+
+NOTE: The colors of the charts reflect the color of the micro:bit simulator. In this instance, the micro:bit is yellow. So the color of the data line reflects the color of the micro:bit
+
+![](/static/mb/data4.png)
+
 ### ~
  
-Welcome! This activity will teach how to use the 1st micro:bit to chart the second micro:bit's acceleration in the "x" direction. Let's get started!
+Vigorously move the micro:bit in the micro:bit simulatator by moving the micro:bit image from side to side. Every time the micro:bit moves in the x direction in the simulator,  you are generating data points that can be reviewed in Excel. The more attempts to move the micro:bit from side to side, the more data being saved in Excel. After you have vigarously moved the micro:bit simulator from side to side for a sufficient amount of time, you are ready to graph or chart the accceleration of the micro:bit. We want a printout of our acceleration on Excel that can be graphed in Excel. 
 
-Let's measure `acceleration (mg)` and then `send number`. `Acceleration` is measured in **milli-gravities**, so a value of -1000 is equivalent to -1g or -9.81m/s^2. We will be able to get the acceleration value (g-force), in the specified "x" dimension. `Send number` will broadcast a number data packet to other micro:bits connected via radio.
+### ~
 
-```blocks
-radio.sendNumber(input.acceleration(Dimension.X));
-```
+We want to chart the data collected by using a tool in Excel. 
 
-We want to display the acceleration forever. In order to do so, we need a `forever` loop. A forever loop will repeat code in the background forever.
-
-```blocks
-basic.forever(() => {
-    radio.sendNumber(input.acceleration(Dimension.X));
-});
+The final part of this experiment is opening and reviewing the data in the Excel CSV file. Simply click on the line beneath the simulator. A CSV file will be generated to display the data points collected by moving the micro:bit in the X direction. Then click or tap on the data Excel file that was downloaded to your local Downloads Folder. 
 
 
-```
-
-We want to register code to run when a packet is received over radio. We can implement this code by adding `on data received`.
-
-```blocks
-basic.forever(() => {
-    radio.sendNumber(input.acceleration(Dimension.X))
-})
-radio.onDataReceived(() => {
-    
-})
-```
-
-Finally, we want to chart the acceleration. So we must first implement `plot bar graph`. `Plot Bar Graph` will display a vertical bar graph based on the value and high value. In order to transfer the receive the number from the 1st micro:bit, we must implement `receive number` to constantly display a vertical bar graph based on the value. Remember, the value will equal to the micro:bit's acceleration in the "x" direction.
-
-```blocks
-basic.forever(() => {
-    radio.sendNumber(input.acceleration(Dimension.X))
-})
-radio.onDataReceived(() => {
-    led.plotBarGraph(radio.receiveNumber(), 1023)
-})
-
-```
+### ~
 
 
-* Connect the first micro:bit to your computer using your USB cable and run the charting script on it.
-* Connect the second micro:bit to your computer using your USB cable and run the charting script on it.
-* The first person and second person take turns tilting the micro:bit in the "x" direction while the other player charts the data on the micro:bit!
+First, click or tap on the first two columns (A, B) to  include the time of the data being collected; b) the results of acceleration data on the micro:bit  
+
+![](/static/mb/data7.png)
+
+Use the Recommended Charts command on the Insert tab to quickly create a chart that’s just right for your data.
+
+* Select the data that you want to include in your chart.
+
+* Click Insert > Recommended Charts.
+
+![](/static/mb/chart1.png)
+
+* On the Recommended Charts tab, scroll through the list of chart types that Excel recommends for your data.
+
+Click any chart type to see how your data will look in that format. 
+
+When you find the chart type that you want, click it, and then click OK. We want to select the chart called Line. A line chart is used to display trends over time. We will use the line chart because there are many data points over time. 
+
+Tip: If you don’t see a chart type that you want, click the All Charts tab to see all of the available chart types.
+
+![](/static/mb/chart_title.png)
+
+* Use the Chart Elements, Chart Styles, and Chart Filters buttons next to the upper-right corner of the chart to add chart elements like axis titles or data labels, to customize the look of your chart
+
+![](/static/mb/elements_styles_filters.png)
+
+* Connect a micro:bit to your computer using your USB cable; compile; and repeat this experiment by moving the micro:bit in the "x" direction. Then collect and chart the data on Excel. 
+* Review and analyze the actual micro:bit device data on Excel
+* Display acceleration with y or z using plot bar graph by changing acceleration from "x" to "y" or "z" 
+
+### ~avatar avatar
+
+Excellent, you're ready to continue with the [challenges](/lessons/charting/acceleration-challenge)
+
+### ~
+

docs/lessons/charting/challenge.md

@@ -0,0 +1,94 @@
+# Challenge 
+
+### ~avatar avatar 
+
+Welcome! The activity will teach you how to use the acceleration of the 1st micro:bit and to visualize the acceleration on the 2nd micro:bit. Let's get started!
+
+### ~
+Let's measure `acceleration (mg)` and then `send number`. `Acceleration` is measured in **milli-gravities**, so a value of -1000 is equivalent to -1g or -9.81m/s^2. We will be able to get the acceleration value (g-force), in the specified "x" dimension. `Send number` will broadcast a number data packet to other micro:bits connected via radio.
+
+```blocks
+radio.sendNumber(input.acceleration(Dimension.X));
+```
+### ~
+We want to display the acceleration forever. In order to do so, we need a `forever` loop. A forever loop will repeat code in the background forever.
+
+```blocks
+basic.forever(() => {
+    radio.sendNumber(input.acceleration(Dimension.X));
+});
+
+
+```
+### ~
+We want to register code to run when a packet is received over radio. We can implement this code by adding `on data received`.
+
+```blocks
+basic.forever(() => {
+    radio.sendNumber(input.acceleration(Dimension.X))
+})
+radio.onDataReceived(() => {
+    
+})
+```
+### ~
+Finally, we want to chart the acceleration. So we must first implement `plot bar graph`. `Plot Bar Graph` will display a vertical bar graph based on the value and high value. In order to transfer the receive the number from the 1st micro:bit, we must implement `receive number` to constantly display a vertical bar graph based on the value. Remember, the value will equal to the micro:bit's acceleration in the "x" direction.
+
+```blocks
+basic.forever(() => {
+    radio.sendNumber(input.acceleration(Dimension.X))
+})
+radio.onDataReceived(() => {
+    led.plotBarGraph(radio.receiveNumber(), 1023)
+})
+
+```
+### ~
+Notice that moving the micro:bit the farthest direction in the x direction will be -1023 on the charting beneath the simulator. The second observation will be that the LEDs will be full brightness on the 2nd micro:bit. There is a single LED turned on with the 1st micro:bit. Additionally, the graphs will reflect 0 acceleation for the 1st micro:bit. In this scenario, if you are adjusting the acceleration in the simualator, you are also changing your chart that will be produced.  
+
+![](/static/mb/acc.png)
+
+### ~
+NOTE: The colors of the charts reflect the color of the micro:bit simulator. In this instance, the micro:bits are blue and green. So the colors of the line graphs reflect the colors of the micro:bit
+ 
+ ### ~
+After running this simulatation several seconds by moving the micro:bit side to side in the x direction, you are ready to graph or chart the accceleration of the micro:bit.  We want a printout of our acceleration on Excel. We will graph the fluctuating acceleration of the simulation experiment. 
+
+![](/static/mb/acc2.png)
+
+### ~
+Finally, you must open the Excel CSV file by clicking on the data.xls file that was downloaded to Downloads Folder. 
+
+![](/static/mb/data3.png)
+
+Use the Recommended Charts command on the Insert tab to quickly create a chart that’s just right for your data.
+
+* Select the data that you want to include in your chart.
+
+* Click Insert > Recommended Charts.
+
+![](/static/mb/chart1.png)
+
+* On the Recommended Charts tab, scroll through the list of chart types that Excel recommends for your data.
+
+Click any chart type to see how your data will look in that format. 
+
+When you find the chart type that you want, click it, and then click OK. We want to select the chart called Line. A line chart is used to display trends over time. We will use the line chart because there are many data points over time. 
+
+Tip: If you don’t see a chart type that you want, click the All Charts tab to see all of the available chart types.
+
+![](/static/mb/chart_title.png)
+
+* Use the Chart Elements, Chart Styles, and Chart Filters buttons next to the upper-right corner of the chart to add chart elements like axis titles or data labels, to customize the look of your chart
+
+![](/static/mb/elements_styles_filters.png)
+
+### ~
+Have fun reviewing your simulation and analyze the acceleration by chart the Excel data using Excel.
+
+* Connect the first micro:bit to your computer using your USB cable and run the charting script on it.
+* Connect the second micro:bit to your computer using your USB cable and run the charting script on it.
+* The first person and second person take turns tilting the micro:bit in the "x" direction while the other player charts the data on the micro:bit!
+* Review and analyze the actual micro:bit device acceleration data on Excel
+* Display acceleration with y or z using plot bar graph by changing acceleration from "x" to "y" or "z" 
+

docs/lessons/charting/quiz-answers.md

@@ -0,0 +1,33 @@
+# charting quiz answers
+
+Measure the acceleration on the micro:bit in the "x" direction. 
+
+
+## Name
+
+## Directions
+
+Use this activity document to guide your work in the [glowing pendulum activity](/lessons/charting/acceleration)
+
+Answer the questions while completing the tutorial. Pay attention to the dialogues!
+
+## 1. Why are you creating a 'forever' loop?
+
+<br/>
+
+We are creating a forever loop to constantly display the appropriate brightness on the LED display.
+
+## 2. Write the line of code to measure the acceleration with respect to the "x" axis and display this value in a bar graph.
+
+<br/>
+
+```blocks
+led.plotBarGraph(input.acceleration(Dimension.X), 0)
+```
+
+## 3. After vigarously moving the micro:bit from side to side along the "x" axis for a sufficient amount of time,insert the Excel graph for displaying a line chart used to display trends over time. 
+
+<br/>
+
+![](/static/mb/line_chart.png)
+

docs/lessons/charting/quiz.md

@@ -0,0 +1,23 @@
+# charting quiz
+
+Measure the acceleration on the micro:bit in the "x" direction. 
+
+## Name
+
+## Directions
+
+Use this activity document to guide your work in the [glowing pendulum tutorial](/lessons/glowing-pendulum/activity)
+
+Answer the questions while completing the tutorial. Pay attention to the dialogues!
+
+## 1. Why are you creating a 'forever' loop?
+
+<br/>
+
+## 2. Write the line of code to measure the acceleration with respect to the "y" axis and store this value in a local variable called 'acceleration'.
+
+<br/>
+
+## 3. After vigarously moving the micro:bit from side to side along the "x" axis for a sufficient amount of time,insert the Excel graph for displaying a line chart used to display trends over time. 
+
+

docs/lessons/classic-beatbox/challenges.md

@@ -17,7 +17,7 @@ input.onPinPressed(TouchPin.P1, () => {
 })
 ```
 
-**Challenge 1**
+### Challenge 1
 
 Let's include a second sound `on pin pressed` *P2*. To do this, you need to add the same blocks as the banana keyboard activity. However, you must change alter `on pin pressed` from P1 to P2. Additionally, you must *decrease* the frequency of the variable "sound" by 25. Modify your code so that your code looks like this
 
@@ -42,7 +42,7 @@ input.onPinPressed(TouchPin.P2, () => {
 
 * click *run* to see if the code works as expected.
 
-**Challenge 2**
+### Challenge 2
 
 Finally, we want images to be displayed with sounds `on pin pressed`. Add `show LEDs` blocks under `on pin pressed` P1 and P2.
 

docs/lessons/game-of-chance/challenges.md

@@ -42,7 +42,7 @@ input.onButtonPressed(Button.B, () => {
 
 * `Run` the code to see if it works as expected.
 
-**Challenge 3**
+### Challenge 3
 
 When you are asked a yes or no question, do you always say yes or no? Add a condition for `on shake` that displays `TRY AGAIN`.
 

docs/lessons/glowing-pendulum.md

@@ -9,6 +9,7 @@ Acceleration
 ## Quick Links
 
 * [activity](/lessons/glowing-pendulum/activity)
+* [tutorial](/lessons/glowing-pendulum/tutorial)
 * [challenges](/lessons/glowing-pendulum/challenges)
 * [quiz](/lessons/glowing-pendulum/quiz)
 * [quiz answers](/lessons/glowing-pendulum/quiz-answers)

docs/lessons/glowing-pendulum/activity.md

@@ -4,10 +4,29 @@ Construct a pendulum that glows using acceleration.
 
 Welcome! This activity will teach how to construct a pendulum that glows using acceleration. Let's get started!
 
+Turn on all the LEDs.
+
+```blocks
+basic.showLeds(`
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    `)
+```
+
 Create a **forever** loop that will constantly display the appropriate brightness on the LED display.
 
 
 ```blocks
+basic.showLeds(`
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    `)
 basic.forever(() => {
     
 })
@@ -15,9 +34,14 @@ basic.forever(() => {
 
 Now let's measure the acceleration on the `y` axis and store that value in a variable. The `acceleration(y)` function will provide the value.
 
-![](/static/mb/blocks/lessons/glowing-pendulum-1.png)
-
 ```blocks
+basic.showLeds(`
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    `)
 basic.forever(() => {
     let acceleration = input.acceleration(Dimension.Y);
 });
@@ -25,27 +49,56 @@ basic.forever(() => {
 
 Since the micro:bit will be swinging back and forth, the acceleration will only be positive half of the time. Thus, to always get a positive value, we want to take the absolute value of the acceleration.
 
-![](/static/mb/blocks/lessons/glowing-pendulum-2.png)
 
 ```blocks
-let acceleration = 0;
+basic.showLeds(`
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    `)
 basic.forever(() => {
-    acceleration = input.acceleration(Dimension.Y);
+    let acceleration = input.acceleration(Dimension.Y);
     acceleration = Math.abs(acceleration)
 });
 ```
 
 The function `acceleration(y)` returns a number between 0 and 1024. We want to use this value for the brightness of the micro:bit, but the `set brightness()` only accepts a value between 0 and 256. Thus, we need to divide the acceleration by 4 to ensure we will be in the appropriate range.
 
-![](/static/mb/blocks/lessons/glowing-pendulum-3.png)
+```blocks
+basic.showLeds(`
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    `)
+basic.forever(() => {
+    let acceleration = input.acceleration(Dimension.Y);
+    acceleration = Math.abs(acceleration);
+    acceleration = acceleration / 4;
+});
+
+```
 
 Now let's use our acceleration value to set the brightness on the micro:bit.
 
-![](/static/mb/blocks/lessons/glowing-pendulum-4.png)
-
-Let's show what the brightness of the micro:bit is by turning all the LEDs on!
-
-![](/static/mb/blocks/lessons/glowing-pendulum-5.png)
+```blocks
+basic.showLeds(`
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    `)
+basic.forever(() => {
+    let acceleration = input.acceleration(Dimension.Y);
+    acceleration = Math.abs(acceleration);
+    acceleration = acceleration / 4;
+    led.setBrightness(acceleration)
+});
+```
 
 ### ~avatar avatar
 

docs/lessons/glowing-pendulum/challenges.md

@@ -6,15 +6,31 @@ Coding challenges for the glowing pendulum tutorial.
 
 Complete the following [glowing pendulum activity](/lessons/glowing-pendulum/activity) and your code should look like this:
 
-![](/static/mb/blocks/lessons/glowing-pendulum-5.png)
+```blocks
+basic.forever(() => {
+    let acceleration = input.acceleration(Dimension.Y);
+    acceleration = Math.abs(acceleration);
+    acceleration = acceleration / 4;
+    led.setBrightness(acceleration)
+    basic.showLeds(`
+        # # # # #
+        # # # # #
+        # # # # #
+        # # # # #
+        # # # # #
+        `)
+});
 
-**Challenge 1**
+
+```
+
+### Challenge 1
 
 ![](/static/mb/lessons/glowing-pendulum-0.jpg)
 
 Hold the micro:bit in your hand in a dark room. Move the micro:bit like a pendulum and produce a slow image that captures the pattern of the micro:bit LEDs.
 
-**Challenge 2**
+### Challenge 2
 
 Replace "y" in `acceleration(y)` with "x" or "z". Changing the axis will cause the micro:bit to measure the force in a different direction. What differences in the resulting pattern does this replacement make?
 

docs/lessons/glowing-pendulum/quiz-answers.md

@@ -44,13 +44,3 @@ let accelerationDivided = accelerationX / 4
 led.setBrightness(accelerationX)
 ```
 
-## 5. Write the code that tuns all the LEDs on (as the image displays below)
-
-![](/static/mb/lessons/glowing-pendulum-1.png)
-
-<br/>
-
-```
-led.plotAll()
-```
-

docs/lessons/glowing-pendulum/quiz.md

@@ -24,11 +24,4 @@ Answer the questions while completing the tutorial. Pay attention to the dialogu
 
 ## 4. Write the code to include acceleration value question 3 to set the brightness on the BBC micro:bit.
 
-<br/>
-
-## 5. Write the code that tuns all the LEDs on (as the image displays below)
-
-![](/static/mb/lessons/glowing-pendulum-1.png)
-
-<br/>
 

docs/lessons/glowing-pendulum/tutorial.md

@@ -0,0 +1,29 @@
+# glowing pendulum block tutorial
+
+The glowing pendulum changes the screen brightness based on the acceleration measured on the BBC micro:bit.
+
+### Rebuild the game!
+
+The blocks have been shuffled! Put them back together so that...
+* all LEDs are turned on
+* the BBC micro:bit repeats code **forever** that
+  * reads the acceleration along the ``y`` axis,
+  * calculate the absolute value of the acceleration
+  * scales down the acceleration value by a factor of `4`
+  * uses the scaled value to set the screen **brightness**
+
+```blocks
+basic.showLeds(`
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    # # # # #
+    `)
+basic.forever(() => {
+    let acceleration = input.acceleration(Dimension.Y);
+    acceleration = Math.abs(acceleration);
+    acceleration = acceleration / 4;
+    led.setBrightness(acceleration)
+});
+```

docs/lessons/guess-the-number.md

@@ -11,6 +11,7 @@ Math - Pick Random
 ## Quick links
 
 * [activity](/lessons/guess-the-number/activity)
+* [tutorial](/lessons/guess-the-number/tutorial)
 * [challenges](/lessons/guess-the-number/challenges)
 * [quiz](/lessons/guess-the-number/quiz)
 * [quiz answers](/lessons/guess-the-number/quiz-answers)

docs/lessons/guess-the-number/activity.md

@@ -19,12 +19,11 @@ input.onButtonPressed(Button.A, () => {
 
 ```
 
-Create a local variable of type number `x` and set it to a random number using `pick random`. `pick random` 9 generates a random number between `0` and `09`.
-
+Create a local variable of type number `x` and set it to a random number using `pick random`. `pick random` 9 generates a random number between `0` and `9`.
 
 ```blocks
 input.onButtonPressed(Button.A, () => {
-    let x = Math.random(9)
+    let x = Math.random(10)
 })
 
 ```
@@ -34,7 +33,7 @@ Show the random number on the screen.
 
 ```blocks
 input.onButtonPressed(Button.A, () => {
-    let x = Math.random(9)
+    let x = Math.random(10)
     basic.showNumber(x)
 })
 

docs/lessons/guess-the-number/tutorial.md

@@ -0,0 +1,25 @@
+# guess the number tutorial
+
+### ~avatar avatar
+
+### @video td/videos/guess-the-number-0
+
+This tutorial will help you create a guess the number game! Let's get started!
+
+### ~
+
+### Rebuild the game!
+
+The blocks have been shuffled! Put them back together so that...
+* when the user presses button ``A``,
+  * generate a random number
+  * show the number on screen
+
+
+```shuffle
+input.onButtonPressed(Button.A, () => {
+    let x = Math.random(10)
+    basic.showNumber(x)
+})
+```
+

docs/lessons/lucky-7/challenges.md

@@ -35,5 +35,5 @@ basic.showNumber(14)
 
 ### Challenge 3
 
-Keep displaying multiples of 7 such as 21 and 28, but don't forget to add pauses between the numbers!
+Keep displaying multiples of 7 such as 21 and 28...
 

docs/lessons/magic-8.md

@@ -9,6 +9,7 @@ If (Conditionals)
 ## Quick Links
 
 * [activity](/lessons/magic-8/activity)
+* [tutorial](/lessons/magic-8/tutorial)
 * [challenges](/lessons/magic-8/challenges)
 * [quiz](/lessons/magic-8/quiz)
 * [quiz answers](/lessons/magic-8/quiz-answers)

docs/lessons/magic-8/activity.md

@@ -1,8 +1,6 @@
 # magic 8 activity
 
-A fortune teller game on the micro:bit 
-
-Welcome! This tutorial will help you create a magic 8 ball on the micro:bit. Let's get started!
+Welcome! This activity will help you create a magic 8 ball on the micro:bit. Let's get started!
 
 Show a string to instruct the user how to play Magic 8! The magic 8 ball can only answer true or false questions.
 
@@ -32,16 +30,13 @@ input.onGesture(Gesture.Shake, () => {
 Create a variable of type number called **randomNumber**. Set **randomNumber** to a random number with a limit of 2. Remember the random function in the math library, picks a random number from 0 to the limit, but not including the limit unless it is 0.
 
 ```blocks
-
 basic.showString("ASK A QUESTION")
 basic.showNumber(8)
 input.onGesture(Gesture.Shake, () => {
     basic.clearScreen()
-    let randomNumber = Math.random(2)
+    let randomNumber = Math.random(3)
 
 });
-
-
 ```
 
 Create an if statement for the condition `if randomNumber = 2`. If **randomNumber** is 2, display the string 'Yes'
@@ -52,7 +47,7 @@ basic.showString("ASK A QUESTION")
 basic.showNumber(8)
 input.onGesture(Gesture.Shake, () =>  {
     basic.clearScreen();
-    let randomNumber = Math.random(2);
+    let randomNumber = Math.random(3);
     if (randomNumber == 2) {
         basic.showString("YES");
     }
@@ -68,7 +63,7 @@ basic.showString("ASK A QUESTION")
 basic.showNumber(8)
 input.onGesture(Gesture.Shake, () => {
     basic.clearScreen()
-    let randomNumber = Math.random(2)
+    let randomNumber = Math.random(3)
     if (randomNumber == 2) {
         basic.showString("YES")
     } else if (randomNumber == 1) {
@@ -84,7 +79,7 @@ basic.showString("ASK A QUESTION")
 basic.showNumber(8)
 input.onGesture(Gesture.Shake, () =>  {
     basic.clearScreen()
-    let randomNumber = Math.random(2)
+    let randomNumber = Math.random(3)
     if (randomNumber == 2) {
         basic.showString("YES")
     } else if (randomNumber == 1) {
@@ -106,14 +101,13 @@ basic.showString("ASK A QUESTION")
 basic.showNumber(8)
 input.onGesture(Gesture.Shake, () =>  {
     basic.clearScreen()
-    let randomNumber = Math.random(2)
+    let randomNumber = Math.random(3)
     if (randomNumber == 2) {
         basic.showString("YES")
     } else if (randomNumber == 1) {
         basic.showString("NO")
     } else {
         basic.showString("I DON'T KNOW")
-
     }
     basic.showNumber(8)
 

docs/lessons/magic-8/challenges.md

@@ -26,7 +26,7 @@ input.onGesture(Gesture.Shake, () =>  {
 ```
 
 
-**Challenge 1**
+### Challenge 1
 
 Now let's increase the number of responses the magic 8 ball can give. How about 5 responses instead? Let's change the limit of `pick random` to  4.
 
@@ -49,7 +49,7 @@ input.onGesture(Gesture.Shake, () =>  {
 })
 ```
 
-**Challenge 2**
+### Challenge 2
 
 Now have the magic 8 ball respond "Try again" if **randomNumber** is 3.
 
@@ -73,7 +73,7 @@ input.onGesture(Gesture.Shake, () => {
 })
 ```
 
-**Challenge 3**
+### Challenge 3
 
 Now what about if **randomNumber** is 4? Let's have the magic 8 ball respond "Definitely!".
 

docs/lessons/magic-8/tutorial.md

@@ -0,0 +1,27 @@
+# Magic 8 tutorial
+
+Show a string to instruct the user how to play Magic 8! The magic 8 ball can only answer questions with "YES", "NO", or "MAYBE"...
+
+### Rebuild the game!
+
+The blocks have been shuffled! Put them back together so that...
+* show "ASK A QUESTION" on the screen
+* when the micro:bit is shaken,
+  * generate a random number between 0 and 2.
+  * if the number is `2`, show "YES"
+  * if the number is `1`, show "NO"
+  * otherwise show "MAYBE"...
+
+```shuffle
+basic.showString("ASK A QUESTION")
+input.onGesture(Gesture.Shake, () =>  {
+    let randomNumber = Math.random(3)
+    if (randomNumber == 2) {
+        basic.showString("YES")
+    } else if (randomNumber == 1) {
+        basic.showString("NO")
+    } else {
+        basic.showString("MAYBE")
+    }
+})
+```

docs/lessons/magic-logo/activity.md

@@ -30,8 +30,6 @@ input.onGesture(Gesture.LogoUp, () => {
         . . # . .
         `)
 })
-
-
 ```
 
 Run your code and try to turn around the micro:bit to see the **logo up** event in action!

docs/lessons/night-light/challenges.md

@@ -46,7 +46,7 @@ input.onButtonPressed(Button.B, () => {
 ```
 
 
-**Challenge 3**
+### Challenge 3
 
 Add an event handler with `on shake` to change the LED brightness back to a `255`.
 

docs/lessons/offset-image/activity.md

@@ -88,7 +88,7 @@ input.onButtonPressed(Button.B, () => {
 
 * Run the code to see if it works as expected.
 
-**Challenge 3**
+### Challenge 3
 
 Now make sure the image does not go off the left side and if it does, prompt the user to push button `A`.
 

docs/lessons/prank-wifi/activity.md

@@ -42,7 +42,7 @@ basic.forever(() => {
 
 ```
 
-**Challenge 1**
+### Challenge 1
 
 What if wanted to show the maximum connectivity of wifi instead of just 1, 3, or 4 bars?
 
@@ -86,7 +86,7 @@ basic.forever(() => {
 })
 ```
 
-**Challenge 2**
+### Challenge 2
 
 Let's add an **IF** at the bottom of your code that checks to see if `sum >= to 1200` **and** if `sum <1400`
 
@@ -135,7 +135,7 @@ basic.forever(() => {
 })
 ```
 
-**Challenge 3**
+### Challenge 3
 
 Now it's your turn! Be creative and change the Wifi meter images to your own wifi image you're sure will prank your friends by editing the lines that call `showLeds()`.
 

docs/lessons/screen-wipe/challenges.md

@@ -41,7 +41,7 @@ input.onButtonPressed(Button.A, () => {
 
 ```
 
-**Challenge 1**
+### Challenge 1
 
 Create an event handler for Button B.
 
@@ -83,7 +83,7 @@ input.onButtonPressed(Button.B, () => {
 
 ```
 
-**Challenge 2**
+### Challenge 2
 
 ### @video td/videos/screen-wipe-2
 
@@ -155,7 +155,7 @@ basic.showLeds(`
 ```
 
 
-**Challenge 3**
+### Challenge 3
 
 Show an animation that scrolls back up when you press button "B".
 

docs/lessons/seismograph.md

@@ -0,0 +1,34 @@
+# Seismograph Lesson 
+
+Build a seismograph with household materials
+
+## Topic 
+
+Acceleration & Analog Read Pin
+
+## Quick Links
+
+* [activity](/lessons/seismograph/activity)
+* [challenge](/lessons/seismograph/challenges)
+
+## Prior learning/place of lesson in scheme of work 
+
+Learn how to **show LEDs** to turn on a LED light pattern on the LED screen. We will be learning basic comments such as show LEDs and pause.
+
+## Documentation
+
+```cards
+basic.forever(() => {
+});
+led.plotBarGraph(input.acceleration(Dimension.Strength) - 1023, 0);
+led.plotBarGraph(pins.analogReadPin(AnalogPin.P0), 0);
+
+```
+
+## Objectives
+
+* learn how to repeat code forever in the background
+* learn how to display a vertical bar graph based on the value. 
+* learn how to return the sum of the two numbers
+* learn how to get acceleration value in milli-gravitys 
+* learn how to read the connector value as analog as a value comprised between 0 and 1023

docs/lessons/seismograph/activity.md

@@ -0,0 +1,150 @@
+# Seismograph Activity 
+
+### ~avatar avatar
+
+In this project, you will build your own seismograph. 
+
+## What you'll need: 
+
+* micro:bit 
+* USB cable
+* Scissors
+* Glue gun
+* String
+* Cup (Plastic or Paper)
+* Magnet
+
+Welcome! This activity will teach how to use the micro:bit to chart the strength of the acceleration. Let's get started!
+
+1. Setup Cup: Use scissors to cut a usable window on the cup, which will be a square sized hole at the lid side of the cup. Use scissors to create a small hole in the center of the base of the cup. 
+
+2. Fasten Magnet: Fasten end of the string to the magnet with glue
+
+3. Secure String: Fasten string to base of the cup and hang the remaining string outside the base of the cup. 
+
+### ~avatar avatar
+
+Seismograph built, let's code! 
+
+### ~
+
+4. Go to Codemicrobit.com
+
+    Click or tap Create Code
+    Click or tap Block Editor
+    
+### ~
+
+5. 
+
+We will measure `acceleration (mg)` in terms of strength. Get the acceleration value (milli g-force), as measured in strength.
+
+```blocks
+input.acceleration(Dimension.Strength);
+```
+
+### ~
+
+6. 
+
+Use the plot bar chart to visualize the acceleration on the LED screen of the micro:bit in the specified range. You implement plot Bar Graph to display a vertical bar graph based on the "value" and "high" value. Then you must insert acceleration in based on strength. 
+
+```blocks
+basic.forever(() => {
+    led.plotBarGraph(input.acceleration(Dimension.Strength), 0);
+});
+
+```
+
+### ~
+
+7. 
+
+Finally, we subtract the gravity from acceleration strength. 
+
+```blocks
+basic.forever(() => {
+    led.plotBarGraph(input.acceleration(Dimension.Strength) - 1023, 0);
+});
+
+```
+
+### ~
+
+8. 
+
+Notice that making vibrating the object below the micro:bit changes the values and the line appears as a wave to display the value of the strength as measured in milli-gravities. By making the object below the micro:bit vibrate, you will observe changing values of the micro:bit. Also, the LEDs shown on the Bar Graph fluctates based on the movement of the micro:bit strength. 
+
+NOTE: The black color reflects the micro:bit device. 
+
+![](/static/mb/data4.png)
+
+
+### ~
+
+9. 
+ 
+Vigorously move the micro:bit in the micro:bit simulatator by moving the micro:bit image from side to side. Every time the micro:bit moves in the x direction in the simulator,  you are generating data points that can be reviewed in Excel. The more attempts to move the micro:bit from side to side, the more data being saved in Excel. After you have vigarously moved the micro:bit simulator from side to side for a sufficient amount of time, you are ready to graph or chart the accceleration of the micro:bit. We want a printout of our acceleration on Excel that can be graphed in Excel. 
+
+
+### ~
+
+10. 
+
+We want to chart the data collected by using a tool in Excel. 
+
+The final part of this experiment is opening and reviewing the data in the Excel CSV file. Simply click on the line beneath the simulator. A CSV file will be generated to display the data points collected by moving the micro:bit in the X direction. Then click or tap on the data Excel file that was downloaded to your local Downloads Folder. 
+
+
+### ~
+
+10. 
+
+
+First, click or tap on the first two columns (A, B) to  include the time of the data being collected; b) the results of acceleration data on the micro:bit  
+
+![](/static/mb/data7.png)
+
+Use the Recommended Charts command on the Insert tab to quickly create a chart that’s just right for your data.
+
+* Select the data that you want to include in your chart.
+
+* Click Insert > Recommended Charts.
+
+### ~
+
+11. 
+
+
+![](/static/mb/chart1.png)
+
+* On the Recommended Charts tab, scroll through the list of chart types that Excel recommends for your data.
+
+Click any chart type to see how your data will look in that format. 
+
+When you find the chart type that you want, click it, and then click OK. We want to select the chart called Line. A line chart is used to display trends over time. We will use the line chart because there are many data points over time. 
+
+Tip: If you don’t see a chart type that you want, click the All Charts tab to see all of the available chart types.
+
+### ~
+
+12. 
+
+![](/static/mb/chart_title.png)
+
+* Use the Chart Elements, Chart Styles, and Chart Filters buttons next to the upper-right corner of the chart to add chart elements like axis titles or data labels, to customize the look of your chart
+
+### ~
+
+13. 
+
+![](/static/mb/elements_styles_filters.png)
+
+* Connect a micro:bit to your computer using your USB cable; compile; and repeat this experiment by vibrating the micro:bit. Then chart the data on Excel. 
+
+### ~avatar avatar
+
+Excellent, you're ready to continue with the [challenges](/lessons/seismograph/challenge)
+
+### ~
+

docs/lessons/seismograph/challenge.md

@@ -0,0 +1,94 @@
+# Challenge 
+
+### ~avatar avatar 
+
+Welcome! The activity will teach you how to use the acceleration of the 1st micro:bit and to visualize the acceleration on the 2nd micro:bit. Let's get started!
+
+### ~
+Let's measure `acceleration (mg)` and then `send number`. `Acceleration` is measured in **milli-gravities**, so a value of -1000 is equivalent to -1g or -9.81m/s^2. We will be able to get the acceleration value (g-force), in the specified "x" dimension. `Send number` will broadcast a number data packet to other micro:bits connected via radio.
+
+```blocks
+radio.sendNumber(input.acceleration(Dimension.X));
+```
+### ~
+We want to display the acceleration forever. In order to do so, we need a `forever` loop. A forever loop will repeat code in the background forever.
+
+```blocks
+basic.forever(() => {
+    radio.sendNumber(input.acceleration(Dimension.X));
+});
+
+
+```
+### ~
+We want to register code to run when a packet is received over radio. We can implement this code by adding `on data received`.
+
+```blocks
+basic.forever(() => {
+    radio.sendNumber(input.acceleration(Dimension.X))
+})
+radio.onDataReceived(() => {
+    
+})
+```
+### ~
+Finally, we want to chart the acceleration. So we must first implement `plot bar graph`. `Plot Bar Graph` will display a vertical bar graph based on the value and high value. In order to transfer the receive the number from the 1st micro:bit, we must implement `receive number` to constantly display a vertical bar graph based on the value. Remember, the value will equal to the micro:bit's acceleration in the "x" direction.
+
+```blocks
+basic.forever(() => {
+    radio.sendNumber(input.acceleration(Dimension.X))
+})
+radio.onDataReceived(() => {
+    led.plotBarGraph(radio.receiveNumber(), 1023)
+})
+
+```
+### ~
+Notice that moving the micro:bit the farthest direction in the x direction will be -1023 on the charting beneath the simulator. The second observation will be that the LEDs will be full brightness on the 2nd micro:bit. There is a single LED turned on with the 1st micro:bit. Additionally, the graphs will reflect 0 acceleation for the 1st micro:bit. In this scenario, if you are adjusting the acceleration in the simualator, you are also changing your chart that will be produced.  
+
+![](/static/mb/acc.png)
+
+### ~
+NOTE: The colors of the charts reflect the color of the micro:bit simulator. In this instance, the micro:bits are blue and green. So the colors of the line graphs reflect the colors of the micro:bit
+ 
+ ### ~
+After running this simulatation several seconds by moving the micro:bit side to side in the x direction, you are ready to graph or chart the accceleration of the micro:bit.  We want a printout of our acceleration on Excel. We will graph the fluctuating acceleration of the simulation experiment. 
+
+![](/static/mb/acc2.png)
+
+### ~
+Finally, you must open the Excel CSV file by clicking on the data.xls file that was downloaded to Downloads Folder. 
+
+![](/static/mb/data3.png)
+
+Use the Recommended Charts command on the Insert tab to quickly create a chart that’s just right for your data.
+
+* Select the data that you want to include in your chart.
+
+* Click Insert > Recommended Charts.
+
+![](/static/mb/chart1.png)
+
+* On the Recommended Charts tab, scroll through the list of chart types that Excel recommends for your data.
+
+Click any chart type to see how your data will look in that format. 
+
+When you find the chart type that you want, click it, and then click OK. We want to select the chart called Line. A line chart is used to display trends over time. We will use the line chart because there are many data points over time. 
+
+Tip: If you don’t see a chart type that you want, click the All Charts tab to see all of the available chart types.
+
+![](/static/mb/chart_title.png)
+
+* Use the Chart Elements, Chart Styles, and Chart Filters buttons next to the upper-right corner of the chart to add chart elements like axis titles or data labels, to customize the look of your chart
+
+![](/static/mb/elements_styles_filters.png)
+
+### ~
+Have fun reviewing your simulation and analyze the acceleration by chart the Excel data using Excel.
+
+* Connect the first micro:bit to your computer using your USB cable and run the charting script on it.
+* Connect the second micro:bit to your computer using your USB cable and run the charting script on it.
+* The first person and second person take turns tilting the micro:bit in the "x" direction while the other player charts the data on the micro:bit!
+* Review and analyze the actual micro:bit device acceleration data on Excel
+* Display acceleration with y or z using plot bar graph by changing acceleration from "x" to "y" or "z" 
+

docs/lessons/truth-or-dare.md

@@ -11,6 +11,7 @@ If (Conditionals)
 ## Quick Links
 
 * [activity](/lessons/truth-or-dare/activity)
+* [tutorial](/lessons/truth-or-dare/tutorial)
 * [challenges](/lessons/truth-or-dare/challenges)
 * [quiz](/lessons/truth-or-dare/quiz)
 * [quiz answers](/lessons/truth-or-dare/quiz-answers)

docs/lessons/truth-or-dare/tutorial.md

@@ -0,0 +1,63 @@
+# truth or dare tutorial
+
+### ~avatar avatar
+
+### @video td/videos/truth-or-dare-0
+
+The *Truth or dare!* game works as follows: a player spins the BBC micro:bit on the table. 
+When the micro:bit stops spinning, the player pointed by the arrow (displayed on screen) must press the button "A" 
+to see if she has to provide a *truth* or a *dare*.
+
+### ~
+
+### Rebuild the game!
+
+The blocks have been shuffled! Put them back together so that...
+* an up arrow is displayed when the micro:bit is powered on.
+* on button `A` is pressed,
+  * randomly display "TRUTH" or "DARE" on the screen
+  * show the up arrow again.
+
+```shuffle
+basic.showLeds(`
+    . . # . .
+    . # # # .
+    # # # # #
+    . . # . .
+    . . # . .
+    `)
+input.onButtonPressed(Button.A, () => {
+    let random = Math.random(2)
+    if (random == 0) {
+        basic.showString("TRUTH")
+    } else {
+        basic.showString("DARE")
+    }
+    basic.showLeds(`
+    . . # . .
+    . # # # .
+    # # # # #
+    . . # . .
+    . . # . .
+    `)
+})
+```
+### Hints and tips
+Cut out these documentation cards to help you!
+
+```cards
+basic.showLeds(`
+    . . # . .
+    . # # # .
+    # . # . #
+    . . # . .
+    . . # . .
+    `);
+Math.random(2);
+basic.showString("TRUTH");
+if (true) {} else {}
+"TRUTH";
+0;
+input.onButtonPressed(Button.A, () => {});
+```
+

docs/libraries.md

@@ -0,0 +1,14 @@
+# Extensions
+
+You can publish libraries (also known as packages or extensions)
+that users can then add to their scripts. These typically
+provide a driver for a particular hardware device you can connect
+to a microbit.
+
+* [Sample C++ extension](https://github.com/Microsoft/pxt-microbit-cppsample)
+* [Sample TypeScript extension](https://github.com/Microsoft/pxt-microbit/tree/master/libs/i2c-fram)
+
+## Finding libraries
+
+## Publishing libraries
+

docs/microbit-reference.md

@@ -0,0 +1,23 @@
+# microbit Reference
+
+```namespaces
+basic.showNumber(0);
+input.onButtonPressed(Button.A, () => {
+    
+});
+led.plot(0, 0);
+music.playTone(0, 0);
+game.addScore(1);
+images.createImage(`
+. . . . .
+. . . . .
+. . # . .
+. . . . .
+. . . . .
+`);
+pins.digitalReadPin(DigitalPin.P0);
+serial.writeValue(x, 0);
+control.inBackground(() => {
+    
+});
+```

docs/reference.md

@@ -1,17 +1,27 @@
 # Reference
 
 ```namespaces
-basic.showString("Hello!");
-input.onButtonPressed(Button.A, () => {});
 for (let i = 0;i<5;++i) {}
 if (true){}
 let x = 0;
 Math.random(5);
+basic.showNumber(0);
+input.onButtonPressed(Button.A, () => {
+    
+});
 led.plot(0, 0);
-radio.sendNumber(0);
-music.playTone(music.noteFrequency(Note.C), music.beat(BeatFraction.Whole));
-game.createSprite(2,2);
+music.playTone(0, 0);
+game.addScore(1);
+images.createImage(`
+. . . . .
+. . . . .
+. . # . .
+. . . . .
+. . . . .
+`);
 pins.digitalReadPin(DigitalPin.P0);
-serial.writeLine("Hello!");
-control.inBackground(() => {});
-```
+serial.writeValue(x, 0);
+control.inBackground(() => {
+    
+});
+

docs/reference/basic.md

@@ -2,7 +2,6 @@
 
 Provides access to basic micro:bit functionality.
 
-
 ```cards
 basic.showNumber(0);
 basic.showLeds(`

docs/reference/control.md

@@ -1,7 +1,6 @@
 # Control
 
-
-
+Runtime and event utilities.
 
 ```cards
 control.inBackground(() => {

docs/reference/game.md

@@ -1,7 +1,6 @@
 # Game
 
-
-
+A single-LED sprite game engine
 
 ```cards
 game.addScore(1);

docs/reference/images.md

@@ -1,7 +1,6 @@
 # Images
 
-
-
+Creation, manipulation and display of LED images.
 
 ```cards
 images.createImage(`

docs/reference/input.md

@@ -1,7 +1,6 @@
 # Input
 
-
-
+Events and data from sensors
 
 ```cards
 input.onButtonPressed(Button.A, () => {

docs/reference/led.md

@@ -1,7 +1,6 @@
 # Led
 
-
-
+Control of the LED screen.
 
 ```cards
 led.plot(0, 0);
@@ -10,7 +9,7 @@ led.point(0, 0);
 led.brightness();
 led.setBrightness(255);
 led.stopAnimation();
-led.plotBarGraph(0, 1023);
+led.plotBarGraph(0, 0);
 led.fadeIn();
 led.fadeOut();
 led.plotAll();

docs/reference/music.md

@@ -1,14 +1,13 @@
 # Music
 
-
-
+Generation of music tones through pin ``P0``.
 
 ```cards
 music.playTone(0, 0);
 music.ringTone(0);
 music.rest(0);
 music.noteFrequency(Note.C);
-music.beat();
+music.beat(BeatFraction.Whole);
 music.tempo();
 music.changeTempoBy(20);
 music.setTempo(120);

docs/reference/pins.md

@@ -1,7 +1,6 @@
 # Pins
 
-
-
+Control currents in Pins for analog/digital signals, servos, i2c, ...
 
 ```cards
 pins.digitalReadPin(DigitalPin.P0);

docs/reference/radio.md

@@ -1,7 +1,6 @@
 # Radio
 
-
-
+Communicate data using radio packets
 
 ```cards
 radio.sendNumber(0);

docs/reference/serial.md

@@ -1,8 +1,8 @@
 # Serial
 
-[Serial communication](/device/serial) between the BBC micro:bit and another computer.
+Reading and writing data over a serial connection.
 
 ```cards
+serial.writeValue(x, 0);
 serial.writeLine("");
-serial.writeValue("x", 0);
 ```

docs/static/docslogo.svg

@@ -1 +0,0 @@
-<svg xmlns:svg='http://www.w3.org/2000/svg' xmlns='http://www.w3.org/2000/svg' width='193.50101' height='32.755001' version='1.1'><g transform='translate(-1.3555,0.63251107)'><title>micro:bit logo</title><path d='m 38.7185,20.11349 c -1.677,0 -3.035,-1.364 -3.035,-3.042 0,-1.678 1.357,-3.038 3.035,-3.038 1.684,0 3.039,1.36 3.039,3.038 0,1.678 -1.355,3.042 -3.039,3.042 m -22.311,-6.077 c -1.677,0 -3.042,1.357 -3.042,3.035 0,1.678 1.363,3.042 3.042,3.042 1.674,0 3.036,-1.364 3.036,-3.042 0,-1.678 -1.363,-3.035 -3.036,-3.035 m -0.003,-5.99 22.576,0 c 4.979,0 9.027,4.047 9.027,9.027 0,4.979 -4.049,9.031 -9.027,9.031 l -22.576,0 c -4.977,0 -9.03,-4.053 -9.03,-9.031 -0.001,-4.98 4.053,-9.027 9.03,-9.027 m 22.576,24.076 c 8.299,0 15.047,-6.75 15.047,-15.049 0,-8.299 -6.748,-15.051 -15.047,-15.051 l -22.576,0 c -8.299,0 -15.049,6.752 -15.049,15.051 0,8.299 6.75,15.049 15.049,15.049 l 22.576,0 m 112.099,-21.953 c 0,-1.453 -1.195,-2.633 -2.662,-2.633 -1.455,0 -2.639,1.18 -2.639,2.633 0,1.471 1.184,2.672 2.639,2.672 1.466,0 2.662,-1.202 2.662,-2.672 z m -66.786,5.445 c 0,-4.764 -2.893,-8.093 -7.031,-8.093 -2.027,0 -3.814,0.851 -5.223,2.47 -1.467,-1.661 -3.152,-2.47 -5.127,-2.47 -4.162,0 -7.066,3.329 -7.066,8.093 l 0,10.466 3.812,0 0,-10.644 c 0,-2.416 1.336,-4.104 3.254,-4.104 1.617,0 3.25,1.409 3.25,4.104 l 0,10.645 3.848,0 0,-10.645 c 0,-2.416 1.338,-4.104 3.252,-4.104 1.863,0 3.217,1.727 3.217,4.104 l 0,10.645 3.814,0 0,-10.467 z m 6.953,-7.632 -3.846,0 0,18.099 3.846,0 0,-18.099 z m 0.569,-5.128 c 0,-1.377 -1.096,-2.454 -2.492,-2.454 -1.4,0 -2.453,1.054 -2.453,2.454 0,1.398 1.078,2.494 2.453,2.494 1.375,0 2.492,-1.117 2.492,-2.494 z m 18.328,20.914 0.576,-0.521 -2.828,-2.658 -0.488,0.455 c -1.252,1.149 -2.504,1.686 -3.945,1.686 -3.064,0 -5.557,-2.557 -5.557,-5.699 0,-3.121 2.492,-5.66 5.557,-5.66 1.432,0 2.646,0.521 3.949,1.693 l 0.512,0.46 2.748,-2.802 -0.49,-0.502 c -1.754,-1.793 -4.016,-2.696 -6.719,-2.696 -2.459,0 -4.869,1.022 -6.605,2.798 -1.738,1.734 -2.691,4.119 -2.691,6.709 0,2.596 0.953,4.979 2.684,6.705 1.771,1.811 4.117,2.811 6.615,2.811 2.401,-0.003 4.647,-0.937 6.682,-2.779 z m 7.25,-6.947 c 0,-3.322 1.145,-4.686 4.217,-5.029 l 0.641,-0.07 0,-3.797 -0.777,0.058 c -5.629,0.458 -8.143,3.247 -8.143,9.048 l 0,9.051 4.062,0 0,-9.261 0,0 z m 21.998,6.923 c 1.762,-1.756 2.729,-4.146 2.729,-6.715 0,-2.565 -0.967,-4.951 -2.723,-6.702 -1.77,-1.809 -4.105,-2.806 -6.576,-2.806 -2.492,0 -4.84,0.997 -6.613,2.806 -1.752,1.792 -2.721,4.174 -2.721,6.702 0,2.53 0.969,4.916 2.721,6.707 1.771,1.81 4.121,2.808 6.613,2.808 2.472,0 4.808,-0.998 6.57,-2.8 z m -1.229,-6.714 c 0,3.18 -2.361,5.665 -5.377,5.665 -2.945,0 -5.346,-2.541 -5.346,-5.665 0,-3.137 2.398,-5.695 5.346,-5.695 2.963,-0.002 5.377,2.558 5.377,5.695 z m 12.917,6.418 c 0,-1.468 -1.195,-2.667 -2.662,-2.667 -1.455,0 -2.639,1.199 -2.639,2.667 0,1.453 1.184,2.632 2.639,2.632 1.466,0 2.662,-1.179 2.662,-2.632 z m 19.507,0.296 c 1.76,-1.756 2.73,-4.146 2.73,-6.715 0,-2.528 -0.973,-4.911 -2.729,-6.702 -1.746,-1.787 -4.08,-2.77 -6.574,-2.77 -2.035,0 -3.84,0.572 -5.484,1.744 l 0,-9.934 -3.816,0 0.008,15.582 c -0.037,0.411 -0.037,0.821 -0.037,1.198 0,6.119 3.836,10.396 9.33,10.396 2.475,0.001 4.807,-0.997 6.572,-2.799 z m -1.013,-6.677 c 0,3.123 -2.494,5.66 -5.559,5.66 -3.115,0 -5.557,-2.484 -5.557,-5.66 0,-3.143 2.494,-5.698 5.557,-5.698 3.065,0 5.559,2.556 5.559,5.698 z m 10.881,-9.085 -3.846,0 0,18.099 3.846,0 0,-18.099 z m 0.572,-5.128 c 0,-1.377 -1.098,-2.454 -2.492,-2.454 -1.4,0 -2.457,1.054 -2.457,2.454 0,1.398 1.076,2.494 2.457,2.494 1.373,0 2.492,-1.117 2.492,-2.494 z m 13.83,19.759 -0.619,-0.089 c -2.855,-0.409 -4.133,-2.104 -4.133,-5.495 l 0,-5.126 4.752,0 0,-3.674 -4.752,0 0,-4.006 -3.887,0 0,4.006 -1.662,0 0,3.674 1.662,0 0,4.525 c 0,6.215 2.113,8.932 7.783,10.029 l 0.855,0.164 0,-4.008 0.001,0 z' style='fill:#ffffff' /></g></svg>

docs/static/footerlogo.svg

@@ -1 +0,0 @@
-<svg xmlns:svg='http://www.w3.org/2000/svg' xmlns='http://www.w3.org/2000/svg' width='193.50101' height='32.755001' version='1.1'><g transform='translate(-1.3555,0.63251107)'><title>micro:bit logo</title><path d='m 38.7185,20.11349 c -1.677,0 -3.035,-1.364 -3.035,-3.042 0,-1.678 1.357,-3.038 3.035,-3.038 1.684,0 3.039,1.36 3.039,3.038 0,1.678 -1.355,3.042 -3.039,3.042 m -22.311,-6.077 c -1.677,0 -3.042,1.357 -3.042,3.035 0,1.678 1.363,3.042 3.042,3.042 1.674,0 3.036,-1.364 3.036,-3.042 0,-1.678 -1.363,-3.035 -3.036,-3.035 m -0.003,-5.99 22.576,0 c 4.979,0 9.027,4.047 9.027,9.027 0,4.979 -4.049,9.031 -9.027,9.031 l -22.576,0 c -4.977,0 -9.03,-4.053 -9.03,-9.031 -0.001,-4.98 4.053,-9.027 9.03,-9.027 m 22.576,24.076 c 8.299,0 15.047,-6.75 15.047,-15.049 0,-8.299 -6.748,-15.051 -15.047,-15.051 l -22.576,0 c -8.299,0 -15.049,6.752 -15.049,15.051 0,8.299 6.75,15.049 15.049,15.049 l 22.576,0 m 112.099,-21.953 c 0,-1.453 -1.195,-2.633 -2.662,-2.633 -1.455,0 -2.639,1.18 -2.639,2.633 0,1.471 1.184,2.672 2.639,2.672 1.466,0 2.662,-1.202 2.662,-2.672 z m -66.786,5.445 c 0,-4.764 -2.893,-8.093 -7.031,-8.093 -2.027,0 -3.814,0.851 -5.223,2.47 -1.467,-1.661 -3.152,-2.47 -5.127,-2.47 -4.162,0 -7.066,3.329 -7.066,8.093 l 0,10.466 3.812,0 0,-10.644 c 0,-2.416 1.336,-4.104 3.254,-4.104 1.617,0 3.25,1.409 3.25,4.104 l 0,10.645 3.848,0 0,-10.645 c 0,-2.416 1.338,-4.104 3.252,-4.104 1.863,0 3.217,1.727 3.217,4.104 l 0,10.645 3.814,0 0,-10.467 z m 6.953,-7.632 -3.846,0 0,18.099 3.846,0 0,-18.099 z m 0.569,-5.128 c 0,-1.377 -1.096,-2.454 -2.492,-2.454 -1.4,0 -2.453,1.054 -2.453,2.454 0,1.398 1.078,2.494 2.453,2.494 1.375,0 2.492,-1.117 2.492,-2.494 z m 18.328,20.914 0.576,-0.521 -2.828,-2.658 -0.488,0.455 c -1.252,1.149 -2.504,1.686 -3.945,1.686 -3.064,0 -5.557,-2.557 -5.557,-5.699 0,-3.121 2.492,-5.66 5.557,-5.66 1.432,0 2.646,0.521 3.949,1.693 l 0.512,0.46 2.748,-2.802 -0.49,-0.502 c -1.754,-1.793 -4.016,-2.696 -6.719,-2.696 -2.459,0 -4.869,1.022 -6.605,2.798 -1.738,1.734 -2.691,4.119 -2.691,6.709 0,2.596 0.953,4.979 2.684,6.705 1.771,1.811 4.117,2.811 6.615,2.811 2.401,-0.003 4.647,-0.937 6.682,-2.779 z m 7.25,-6.947 c 0,-3.322 1.145,-4.686 4.217,-5.029 l 0.641,-0.07 0,-3.797 -0.777,0.058 c -5.629,0.458 -8.143,3.247 -8.143,9.048 l 0,9.051 4.062,0 0,-9.261 0,0 z m 21.998,6.923 c 1.762,-1.756 2.729,-4.146 2.729,-6.715 0,-2.565 -0.967,-4.951 -2.723,-6.702 -1.77,-1.809 -4.105,-2.806 -6.576,-2.806 -2.492,0 -4.84,0.997 -6.613,2.806 -1.752,1.792 -2.721,4.174 -2.721,6.702 0,2.53 0.969,4.916 2.721,6.707 1.771,1.81 4.121,2.808 6.613,2.808 2.472,0 4.808,-0.998 6.57,-2.8 z m -1.229,-6.714 c 0,3.18 -2.361,5.665 -5.377,5.665 -2.945,0 -5.346,-2.541 -5.346,-5.665 0,-3.137 2.398,-5.695 5.346,-5.695 2.963,-0.002 5.377,2.558 5.377,5.695 z m 12.917,6.418 c 0,-1.468 -1.195,-2.667 -2.662,-2.667 -1.455,0 -2.639,1.199 -2.639,2.667 0,1.453 1.184,2.632 2.639,2.632 1.466,0 2.662,-1.179 2.662,-2.632 z m 19.507,0.296 c 1.76,-1.756 2.73,-4.146 2.73,-6.715 0,-2.528 -0.973,-4.911 -2.729,-6.702 -1.746,-1.787 -4.08,-2.77 -6.574,-2.77 -2.035,0 -3.84,0.572 -5.484,1.744 l 0,-9.934 -3.816,0 0.008,15.582 c -0.037,0.411 -0.037,0.821 -0.037,1.198 0,6.119 3.836,10.396 9.33,10.396 2.475,0.001 4.807,-0.997 6.572,-2.799 z m -1.013,-6.677 c 0,3.123 -2.494,5.66 -5.559,5.66 -3.115,0 -5.557,-2.484 -5.557,-5.66 0,-3.143 2.494,-5.698 5.557,-5.698 3.065,0 5.559,2.556 5.559,5.698 z m 10.881,-9.085 -3.846,0 0,18.099 3.846,0 0,-18.099 z m 0.572,-5.128 c 0,-1.377 -1.098,-2.454 -2.492,-2.454 -1.4,0 -2.457,1.054 -2.457,2.454 0,1.398 1.076,2.494 2.457,2.494 1.373,0 2.492,-1.117 2.492,-2.494 z m 13.83,19.759 -0.619,-0.089 c -2.855,-0.409 -4.133,-2.104 -4.133,-5.495 l 0,-5.126 4.752,0 0,-3.674 -4.752,0 0,-4.006 -3.887,0 0,4.006 -1.662,0 0,3.674 1.662,0 0,4.525 c 0,6.215 2.113,8.932 7.783,10.029 l 0.855,0.164 0,-4.008 0.001,0 z' style='fill:#000000' /></g></svg>

docs/static/logo.svg

@@ -1 +0,0 @@
-<svg xmlns:svg='http://www.w3.org/2000/svg' xmlns='http://www.w3.org/2000/svg' width='193.50101' height='32.755001' version='1.1'><g transform='translate(-1.3555,0.63251107)'><title>micro:bit logo</title><path d='m 38.7185,20.11349 c -1.677,0 -3.035,-1.364 -3.035,-3.042 0,-1.678 1.357,-3.038 3.035,-3.038 1.684,0 3.039,1.36 3.039,3.038 0,1.678 -1.355,3.042 -3.039,3.042 m -22.311,-6.077 c -1.677,0 -3.042,1.357 -3.042,3.035 0,1.678 1.363,3.042 3.042,3.042 1.674,0 3.036,-1.364 3.036,-3.042 0,-1.678 -1.363,-3.035 -3.036,-3.035 m -0.003,-5.99 22.576,0 c 4.979,0 9.027,4.047 9.027,9.027 0,4.979 -4.049,9.031 -9.027,9.031 l -22.576,0 c -4.977,0 -9.03,-4.053 -9.03,-9.031 -0.001,-4.98 4.053,-9.027 9.03,-9.027 m 22.576,24.076 c 8.299,0 15.047,-6.75 15.047,-15.049 0,-8.299 -6.748,-15.051 -15.047,-15.051 l -22.576,0 c -8.299,0 -15.049,6.752 -15.049,15.051 0,8.299 6.75,15.049 15.049,15.049 l 22.576,0 m 112.099,-21.953 c 0,-1.453 -1.195,-2.633 -2.662,-2.633 -1.455,0 -2.639,1.18 -2.639,2.633 0,1.471 1.184,2.672 2.639,2.672 1.466,0 2.662,-1.202 2.662,-2.672 z m -66.786,5.445 c 0,-4.764 -2.893,-8.093 -7.031,-8.093 -2.027,0 -3.814,0.851 -5.223,2.47 -1.467,-1.661 -3.152,-2.47 -5.127,-2.47 -4.162,0 -7.066,3.329 -7.066,8.093 l 0,10.466 3.812,0 0,-10.644 c 0,-2.416 1.336,-4.104 3.254,-4.104 1.617,0 3.25,1.409 3.25,4.104 l 0,10.645 3.848,0 0,-10.645 c 0,-2.416 1.338,-4.104 3.252,-4.104 1.863,0 3.217,1.727 3.217,4.104 l 0,10.645 3.814,0 0,-10.467 z m 6.953,-7.632 -3.846,0 0,18.099 3.846,0 0,-18.099 z m 0.569,-5.128 c 0,-1.377 -1.096,-2.454 -2.492,-2.454 -1.4,0 -2.453,1.054 -2.453,2.454 0,1.398 1.078,2.494 2.453,2.494 1.375,0 2.492,-1.117 2.492,-2.494 z m 18.328,20.914 0.576,-0.521 -2.828,-2.658 -0.488,0.455 c -1.252,1.149 -2.504,1.686 -3.945,1.686 -3.064,0 -5.557,-2.557 -5.557,-5.699 0,-3.121 2.492,-5.66 5.557,-5.66 1.432,0 2.646,0.521 3.949,1.693 l 0.512,0.46 2.748,-2.802 -0.49,-0.502 c -1.754,-1.793 -4.016,-2.696 -6.719,-2.696 -2.459,0 -4.869,1.022 -6.605,2.798 -1.738,1.734 -2.691,4.119 -2.691,6.709 0,2.596 0.953,4.979 2.684,6.705 1.771,1.811 4.117,2.811 6.615,2.811 2.401,-0.003 4.647,-0.937 6.682,-2.779 z m 7.25,-6.947 c 0,-3.322 1.145,-4.686 4.217,-5.029 l 0.641,-0.07 0,-3.797 -0.777,0.058 c -5.629,0.458 -8.143,3.247 -8.143,9.048 l 0,9.051 4.062,0 0,-9.261 0,0 z m 21.998,6.923 c 1.762,-1.756 2.729,-4.146 2.729,-6.715 0,-2.565 -0.967,-4.951 -2.723,-6.702 -1.77,-1.809 -4.105,-2.806 -6.576,-2.806 -2.492,0 -4.84,0.997 -6.613,2.806 -1.752,1.792 -2.721,4.174 -2.721,6.702 0,2.53 0.969,4.916 2.721,6.707 1.771,1.81 4.121,2.808 6.613,2.808 2.472,0 4.808,-0.998 6.57,-2.8 z m -1.229,-6.714 c 0,3.18 -2.361,5.665 -5.377,5.665 -2.945,0 -5.346,-2.541 -5.346,-5.665 0,-3.137 2.398,-5.695 5.346,-5.695 2.963,-0.002 5.377,2.558 5.377,5.695 z m 12.917,6.418 c 0,-1.468 -1.195,-2.667 -2.662,-2.667 -1.455,0 -2.639,1.199 -2.639,2.667 0,1.453 1.184,2.632 2.639,2.632 1.466,0 2.662,-1.179 2.662,-2.632 z m 19.507,0.296 c 1.76,-1.756 2.73,-4.146 2.73,-6.715 0,-2.528 -0.973,-4.911 -2.729,-6.702 -1.746,-1.787 -4.08,-2.77 -6.574,-2.77 -2.035,0 -3.84,0.572 -5.484,1.744 l 0,-9.934 -3.816,0 0.008,15.582 c -0.037,0.411 -0.037,0.821 -0.037,1.198 0,6.119 3.836,10.396 9.33,10.396 2.475,0.001 4.807,-0.997 6.572,-2.799 z m -1.013,-6.677 c 0,3.123 -2.494,5.66 -5.559,5.66 -3.115,0 -5.557,-2.484 -5.557,-5.66 0,-3.143 2.494,-5.698 5.557,-5.698 3.065,0 5.559,2.556 5.559,5.698 z m 10.881,-9.085 -3.846,0 0,18.099 3.846,0 0,-18.099 z m 0.572,-5.128 c 0,-1.377 -1.098,-2.454 -2.492,-2.454 -1.4,0 -2.457,1.054 -2.457,2.454 0,1.398 1.076,2.494 2.457,2.494 1.373,0 2.492,-1.117 2.492,-2.494 z m 13.83,19.759 -0.619,-0.089 c -2.855,-0.409 -4.133,-2.104 -4.133,-5.495 l 0,-5.126 4.752,0 0,-3.674 -4.752,0 0,-4.006 -3.887,0 0,4.006 -1.662,0 0,3.674 1.662,0 0,4.525 c 0,6.215 2.113,8.932 7.783,10.029 l 0.855,0.164 0,-4.008 0.001,0 z' style='fill:#000000' /></g></svg>

docs/static/portraitlogo.svg

@@ -1 +0,0 @@
-<svg xmlns='http://www.w3.org/2000/svg' width='52.672' height='30.1' viewBox='0 0 52.672003 30.1'><g transform='translate(-1.355 -2.023)'><title>micro:bit logo</title><path d='M38.718 20.113c-1.677 0-3.035-1.364-3.035-3.042 0-1.677 1.357-3.037 3.035-3.037 1.684 0 3.04 1.36 3.04 3.038 0 1.68-1.356 3.043-3.04 3.043m-22.31-6.077c-1.678 0-3.043 1.357-3.043 3.035 0 1.68 1.363 3.043 3.042 3.043 1.674 0 3.036-1.364 3.036-3.042 0-1.677-1.363-3.034-3.036-3.034m-.003-5.99H38.98c4.98 0 9.027 4.047 9.027 9.027 0 4.98-4.05 9.03-9.027 9.03H16.404c-4.977 0-9.03-4.052-9.03-9.03 0-4.98 4.053-9.027 9.03-9.027M38.98 32.122c8.3 0 15.047-6.75 15.047-15.05 0-8.298-6.748-15.05-15.047-15.05H16.404c-8.3 0-15.05 6.752-15.05 15.05 0 8.3 6.75 15.05 15.05 15.05H38.98'/></g></svg>

docs/static/splashscreen.svg

@@ -1,64 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<svg
-   xmlns:dc="http://purl.org/dc/elements/1.1/"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
-   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
-   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
-   width="1240"
-   height="600"
-   viewBox="0 0 1240 599.99999"
-   id="svg2"
-   version="1.1"
-   inkscape:version="0.91 r13725"
-   sodipodi:docname="splashscreen.svg"
-   inkscape:export-filename="C:\gh\pxt-microbit\win10\app\images\Square44x44Logo.targetsize-24_altform-unplated.png"
-   inkscape:export-xdpi="41.008503"
-   inkscape:export-ydpi="41.008503">
-  <metadata
-     id="metadata14">
-    <rdf:RDF>
-      <cc:Work
-         rdf:about="">
-        <dc:format>image/svg+xml</dc:format>
-        <dc:type
-           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-        <dc:title></dc:title>
-      </cc:Work>
-    </rdf:RDF>
-  </metadata>
-  <defs
-     id="defs12" />
-  <sodipodi:namedview
-     pagecolor="#ffffff"
-     bordercolor="#666666"
-     borderopacity="1"
-     objecttolerance="10"
-     gridtolerance="10"
-     guidetolerance="10"
-     inkscape:pageopacity="0"
-     inkscape:pageshadow="2"
-     inkscape:window-width="1440"
-     inkscape:window-height="837"
-     id="namedview10"
-     showgrid="false"
-     inkscape:zoom="0.7546704"
-     inkscape:cx="528.17059"
-     inkscape:cy="263.58903"
-     inkscape:window-x="-8"
-     inkscape:window-y="-8"
-     inkscape:window-maximized="1"
-     inkscape:current-layer="svg2" />
-  <g
-     transform="matrix(15.144568,0,0,15.144568,200.63934,41.451935)"
-     id="g4">
-    <title
-       id="title6">micro:bit logo</title>
-    <path
-       d="m 38.718,20.113 c -1.677,0 -3.035,-1.364 -3.035,-3.042 0,-1.677 1.357,-3.037 3.035,-3.037 1.684,0 3.04,1.36 3.04,3.038 0,1.68 -1.356,3.043 -3.04,3.043 m -22.31,-6.077 c -1.678,0 -3.043,1.357 -3.043,3.035 0,1.68 1.363,3.043 3.042,3.043 1.674,0 3.036,-1.364 3.036,-3.042 0,-1.677 -1.363,-3.034 -3.036,-3.034 m -0.003,-5.99 22.576,0 c 4.98,0 9.027,4.047 9.027,9.027 0,4.98 -4.05,9.03 -9.027,9.03 l -22.576,0 c -4.977,0 -9.03,-4.052 -9.03,-9.03 0,-4.98 4.053,-9.027 9.03,-9.027 M 38.98,32.122 c 8.3,0 15.047,-6.75 15.047,-15.05 0,-8.298 -6.748,-15.05 -15.047,-15.05 l -22.576,0 c -8.3,0 -15.05,6.752 -15.05,15.05 0,8.3 6.75,15.05 15.05,15.05 l 22.576,0"
-       id="path8"
-       inkscape:connector-curvature="0" />
-  </g>
-</svg>

docs/static/squarelogo.svg

@@ -1,61 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<svg
-   xmlns:dc="http://purl.org/dc/elements/1.1/"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
-   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
-   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
-   width="52.672001"
-   height="52.672001"
-   viewBox="0 0 52.672003 52.672"
-   id="svg2"
-   version="1.1"
-   inkscape:version="0.91 r13725"
-   sodipodi:docname="squarelogo.svg">
-  <metadata
-     id="metadata14">
-    <rdf:RDF>
-      <cc:Work
-         rdf:about="">
-        <dc:format>image/svg+xml</dc:format>
-        <dc:type
-           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-        <dc:title></dc:title>
-      </cc:Work>
-    </rdf:RDF>
-  </metadata>
-  <defs
-     id="defs12" />
-  <sodipodi:namedview
-     pagecolor="#ffffff"
-     bordercolor="#666666"
-     borderopacity="1"
-     objecttolerance="10"
-     gridtolerance="10"
-     guidetolerance="10"
-     inkscape:pageopacity="0"
-     inkscape:pageshadow="2"
-     inkscape:window-width="640"
-     inkscape:window-height="480"
-     id="namedview10"
-     showgrid="false"
-     inkscape:zoom="6.0373632"
-     inkscape:cx="26.336"
-     inkscape:cy="21.675409"
-     inkscape:window-x="0"
-     inkscape:window-y="0"
-     inkscape:window-maximized="0"
-     inkscape:current-layer="svg2" />
-  <g
-     transform="translate(-1.355,9.2400005)"
-     id="g4">
-    <title
-       id="title6">micro:bit logo</title>
-    <path
-       d="m 38.718,20.113 c -1.677,0 -3.035,-1.364 -3.035,-3.042 0,-1.677 1.357,-3.037 3.035,-3.037 1.684,0 3.04,1.36 3.04,3.038 0,1.68 -1.356,3.043 -3.04,3.043 m -22.31,-6.077 c -1.678,0 -3.043,1.357 -3.043,3.035 0,1.68 1.363,3.043 3.042,3.043 1.674,0 3.036,-1.364 3.036,-3.042 0,-1.677 -1.363,-3.034 -3.036,-3.034 m -0.003,-5.99 22.576,0 c 4.98,0 9.027,4.047 9.027,9.027 0,4.98 -4.05,9.03 -9.027,9.03 l -22.576,0 c -4.977,0 -9.03,-4.052 -9.03,-9.03 0,-4.98 4.053,-9.027 9.03,-9.027 M 38.98,32.122 c 8.3,0 15.047,-6.75 15.047,-15.05 0,-8.298 -6.748,-15.05 -15.047,-15.05 l -22.576,0 c -8.3,0 -15.05,6.752 -15.05,15.05 0,8.3 6.75,15.05 15.05,15.05 l 22.576,0"
-       id="path8"
-       inkscape:connector-curvature="0" />
-  </g>
-</svg>

docs/thank-you.md

@@ -0,0 +1,9 @@
+# You completed the survey!
+
+```sim
+basic.forever(() => { basic.showString("THANK YOU") })
+```
+
+Thank you for participating in this survey.
+
+Please [contact us](mailto:microbitpilots@microsoft.com) with any information you think we might find useful.

libs/microbit-radio/radio.cpp

@@ -2,6 +2,8 @@
 
 using namespace pxt;
 
+#define RADIO_VALUE_PACKET_TYPE 24641622
+
 //% color=270 weight=34
 namespace radio {
 
@@ -47,6 +49,72 @@ namespace radio {
         uBit.radio.datagram.send((uint8_t*)buf, 4*sizeof(int));
     }
     
+    /**
+    * Broadcasts a name / value pair along with the device serial number
+    * and running time to any connected BBC micro:bit in the group.
+    * @param name the field name (max 12 characters), eg: "data"
+    * @param the numberic value
+    */
+    //% help=radio/stream-value
+    //% weight=4
+    //% blockId=radio_datagram_stream_value block="stream|value %name|= %value"
+    void streamValue(StringData* name, int number) {
+        if (radioEnable() != MICROBIT_OK) return;
+
+        ManagedString n(name);                
+        uint8_t buf[32];
+        uint32_t* buf32 = (uint32_t*)buf;
+        memset(buf, 32, 0);
+        buf32[0] = number;                      // 4 bytes: value
+        buf32[1] = microbit_serial_number();    // 4 bytes: serial number
+        buf32[2] = system_timer_current_time(); // 4 bytes: running time
+        memcpy(buf + 12, n.toCharArray(), min(12, n.length())); // 12-24: field name       
+        buf32[7] = RADIO_VALUE_PACKET_TYPE; // last 4 bytes: magic number of package type
+        uBit.radio.datagram.send(buf, 32);
+    }
+    
+    /**
+    * Reads a value sent with `stream value` and writes it
+    * to the serial stream as JSON
+    */
+    //% help=radio/read-value-to-serial
+    //% weight=3
+    void readValueToSerial() {
+        if (radioEnable() != MICROBIT_OK) return;
+        PacketBuffer p = uBit.radio.datagram.recv();
+        int length = p.length();
+        if (length < 32) {
+            return;
+        }
+        
+        uint8_t* bytes = p.getBytes();
+        //uint32_t* buf32 = (uint32_t*)bytes;        
+        //uint32_t type = buf32[7];
+        //if (type != RADIO_VALUE_PACKET_TYPE)
+        //{
+         //   uBit.serial.send("type: ");
+         //   uBit.serial.send(type);
+         //   uBit.serial.send("\r\n");
+          //  return;
+        //}
+        
+        int value;
+        int serial;
+        int time;
+        char name[12+1]; memset(name, 0, 13 * sizeof(char));
+        
+        memcpy(&value, bytes, 4);
+        memcpy(&serial, bytes + 4, 4);
+        memcpy(&time, bytes + 8, 4);
+        memcpy(&name, bytes + 12, 12);
+            
+        uBit.serial.send("{s:"); uBit.serial.send(serial);
+        uBit.serial.send(",t:"); uBit.serial.send(time);
+        uBit.serial.send(",v:"); uBit.serial.send(value);
+        uBit.serial.send(",n:\""); uBit.serial.send(name);
+        uBit.serial.send("\"}\r\n");
+    }
+
     /**
      * Registers code to run when a packet is received over radio.
      */

libs/microbit-radio/shims.d.ts

@@ -13,6 +13,25 @@ declare namespace radio {
     //% blockId=radio_datagram_send_numbers block="send numbers|0: %VALUE0|1: %VALUE1|2: %VALUE2|3: %VALUE3" shim=radio::sendNumbers
     function sendNumbers(value_0: number, value_1: number, value_2: number, value_3: number): void;
 
+    /**
+     * Broadcasts a name / value pair along with the device serial number
+     * and running time to any connected BBC micro:bit in the group.
+     * @param name the field name (max 12 characters), eg: "data"
+     * @param the numberic value
+     */
+    //% help=radio/stream-value
+    //% weight=4
+    //% blockId=radio_datagram_stream_value block="stream|value %name|= %value" shim=radio::streamValue
+    function streamValue(name: string, number: number): void;
+
+    /**
+     * Reads a value sent with `stream value` and writes it
+     * to the serial stream as JSON
+     */
+    //% help=radio/read-value-to-serial
+    //% weight=3 shim=radio::readValueToSerial
+    function readValueToSerial(): void;
+
     /**
      * Registers code to run when a packet is received over radio.
      */

libs/microbit/_locales/microbit-strings.json

@@ -0,0 +1,81 @@
+{
+  "basic": "Provides access to basic micro:bit functionality.",
+  "basic.clearScreen": "Turn off all LEDs",
+  "basic.forever": "Repeats the code forever in the background. On each iteration, allows other codes to run.",
+  "basic.pause": "Pause for the specified time in milliseconds",
+  "basic.plotLeds": "Draws an image on the LED screen.",
+  "basic.showAnimation": "Shows a sequence of LED screens as an animation.",
+  "basic.showLeds": "Draws an image on the LED screen.",
+  "basic.showNumber": "Scroll a number on the screen. If the number fits on the screen (i.e. is a single digit), do not scroll.",
+  "basic.showString": "Display text on the display, one character at a time. If the string fits on the screen (i.e. is one letter), does not scroll.",
+  "control": "Runtime and event utilities.",
+  "control.inBackground": "Schedules code that run in the background.",
+  "control.reset": "Resets the BBC micro:bit.",
+  "game": "A single-LED sprite game engine",
+  "game.addScore": "Adds points to the current score",
+  "game.gameOver": "Displays a game over animation.",
+  "game.score": "Gets the current score",
+  "game.setScore": "Sets the current score value",
+  "game.startCountdown": "Starts a game countdown timer",
+  "images": "Creation, manipulation and display of LED images.",
+  "images.createBigImage": "Creates an image with 2 frames.",
+  "images.createImage": "Creates an image that fits on the LED screen.",
+  "input": "Events and data from sensors",
+  "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.buttonIsPressed": "Get the button state (pressed or not) for ``A`` and ``B``.",
+  "input.calibrate": "Obsolete, compass calibration is automatic.",
+  "input.compassHeading": "Get the current compass 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.onButtonPressed": "Do something when a button (``A``, ``B`` or both ``A+B``) is pressed",
+  "input.onGesture": "Attaches code to run when the screen is facing up.",
+  "input.onLogoDown": "Attaches code to run when the logo is oriented downwards and the board is vertical.",
+  "input.onLogoUp": "Attaches code to run when the logo is oriented upwards and the board is vertical.",
+  "input.onPinPressed": "Do something when a pin(``P0``, ``P1`` or both ``P2``) is pressed.",
+  "input.onScreenDown": "Attaches code to run when the screen is facing down.",
+  "input.onScreenUp": "Attaches code to run when the screen is facing up.",
+  "input.onShake": "Attaches code to run when the device is shaken.",
+  "input.pinIsPressed": "Get the pin state (pressed or not). Requires to hold the ground to close the circuit.",
+  "input.rotation": "The pitch of the device, rotation along the ``x-axis``, in degrees.",
+  "input.runningTime": "Gets the number of milliseconds elapsed since power on.",
+  "input.setAccelerometerRange": "Sets the accelerometer sample range in gravities.",
+  "input.temperature": "Gets the temperature in Celsius degrees (°C).",
+  "led": "Control of the LED screen.",
+  "led.brightness": "Get the screen brightness from 0 (off) to 255 (full bright).",
+  "led.fadeIn": "Fades in the screen display.",
+  "led.fadeOut": "Fades out the screen brightness.",
+  "led.plot": "Turn on the specified LED using x, y coordinates (x is horizontal, y is vertical). (0,0) is upper left.",
+  "led.plotAll": "Turns all LEDS on",
+  "led.plotBarGraph": "Displays a vertical bar graph based on the `value` and `high` value.\nIf `high` is 0, the chart gets adjusted automatically.",
+  "led.point": "Get the on/off state of the specified LED using x, y coordinates. (0,0) is upper left.",
+  "led.screenshot": "Takes a screenshot of the LED screen and returns an image.",
+  "led.setBrightness": "Set the screen brightness from 0 (off) to 255 (full bright).",
+  "led.setDisplayMode": "Sets the display mode between black and white and greyscale for rendering LEDs.",
+  "led.stopAnimation": "Cancels the current animation and clears other pending animations.",
+  "led.toggle": "Toggles a particular pixel",
+  "led.toggleAll": "Inverts the current LED display",
+  "led.unplot": "Turn off the specified LED using x, y coordinates (x is horizontal, y is vertical). (0,0) is upper left.",
+  "music": "Generation of music tones through pin ``P0``.",
+  "music.beat": "Returns the duration of a beat in milli-seconds",
+  "music.changeTempoBy": "Change the tempo by the specified amount",
+  "music.noteFrequency": "Gets the frequency of a note.",
+  "music.playTone": "Plays a tone through pin ``P0`` for the given duration.",
+  "music.rest": "Rests (plays nothing) for a specified time through pin ``P0``.",
+  "music.ringTone": "Plays a tone through pin ``P0``.",
+  "music.setTempo": "Sets the tempo to the specified amount",
+  "music.tempo": "Returns the tempo in beats per minute. Tempo is the speed (bpm = beats per minute) at which notes play. The larger the tempo value, the faster the notes will play.",
+  "pins": "Control currents in Pins for analog/digital signals, servos, i2c, ...",
+  "pins.analogPitch": "Emits a Pulse-width modulation (PWM) signal to the current pitch pin. Use `analog set pitch pin` to define the pitch pin.",
+  "pins.analogReadPin": "Read the connector value as analog, that is, as a value comprised between 0 and 1023.",
+  "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.analogSetPitchPin": "Sets the pin used when using `pins->analog pitch`.",
+  "pins.analogWritePin": "Set the connector value as analog. Value must be comprised between 0 and 1023.",
+  "pins.digitalReadPin": "Read the specified pin or connector as either 0 or 1",
+  "pins.digitalWritePin": "Set a pin or connector value to either 0 or 1.",
+  "pins.map": "Re-maps a number from one range to another. That is, a value of ``from low`` would get mapped to ``to low``, a value of ``from high`` to ``to high``, values in-between to values in-between, etc.",
+  "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.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).",
+  "serial": "Reading and writing data over a serial connection.",
+  "serial.writeLine": "Prints a line of text to the serial",
+  "serial.writeValue": "Writes a ``name: value`` pair line to the serial."
+}

libs/microbit/control.cpp

@@ -155,4 +155,20 @@ namespace control {
     void onEvent(int src, int value, Action handler) { 
         registerWithDal(src, value, handler);
     }
+    
+    /**
+     * Gets a friendly name for the device derived from the its serial number
+     */
+    //% blockId="control_device_name" block="device name" weight=10 blockGap=8
+    StringData* deviceName() {
+        return ManagedString(microbit_friendly_name()).leakData();        
+    }
+    
+    /**
+    * Derive a unique, consistent serial number of this device from internal data.
+    */
+    //% blockId="control_device_serial_number" block="device serial number" weight=9
+    int deviceSerialNumber() {
+        return microbit_serial_number();
+    }
 }

libs/microbit/core.cpp

@@ -301,4 +301,18 @@ namespace pxtrt {
   {
     microbit_panic(code);
   }
+
+  //
+  // Debugger
+  //
+
+  //%
+  uint32_t getNumGlobals() {
+    return numGlobals;
+  }
+
+  //%
+  void* getGlobalsPtr() {
+    return globals;
+  }
 }

libs/microbit/led.ts

@@ -4,18 +4,33 @@
 //% color=3 weight=35
 namespace led {
 
+    // what's the current high value
+    let barGraphHigh = 0;
+    // when was the current high value recorded
+    let barGraphHighLast = 0;
+        
     /**
-     * Displays a vertical bar graph based on the ``value`` and ``high`` value.
+     * Displays a vertical bar graph based on the `value` and `high` value.
+     * If `high` is 0, the chart gets adjusted automatically.
      * @param value current value to plot
-     * @param high maximum value, eg: 1023, 255
+     * @param high maximum value. If 0, maximum value adjusted automatically, eg: 0
      */
     //% help=/led/plot-bar-graph weight=20
     //% blockId=device_plot_bar_graph block="plot bar graph of %value |up to %high" icon="\uf080" blockExternalInputs=true
     export function plotBarGraph(value: number, high: number): void {        
-        
+        let now = input.runningTime();
         serial.writeString(value.toString() + "\r\n");
+        value = Math.abs(value);
         
-        let v = Math.abs((value * 15) / high);
+        if (high != 0) barGraphHigh = high;
+        else if (value > barGraphHigh || now - barGraphHighLast > 5000) {
+            barGraphHigh = value;
+            barGraphHighLast = now;
+        }
+        
+        barGraphHigh = Math.max(barGraphHigh, 16);
+                    
+        let v = (value * 15) / barGraphHigh;
         let k = 0;
         for(let y = 4; y >= 0; --y) {
             for (let x = 0; x < 3; ++x) {

libs/microbit/messages.ts

@@ -0,0 +1,51 @@
+namespace messages {
+    var streamid: string;
+        
+    export function setStreamId(id: string) {
+        streamid = id;
+    }
+    
+    /**
+     * Creates a new message that includes the board serial number and the stream id if any
+     */
+    export function createMessage() : Message {
+        let m = new Message();
+        m.addNumber('board', control.deviceSerialNumber());
+        if (streamid != null && streamid.length > 0)
+            m.addString('stream', streamid);
+        return m;
+    }
+    
+    /**
+     * A message containig custom data
+     */
+    export class Message {
+        private buffer:string = '';
+        
+        /**
+         * Adds a string field to the message
+         */
+        //%
+        public addString(name:string, value:string) {
+            if (this.buffer.length > 0) this.buffer += ',';
+            this.buffer += name + ':"' + value + '"';
+        }
+        
+        /**
+         * Adds a number field to the message
+         */
+        //%
+        public addNumber(name:string, value: number) {
+            if (this.buffer.length > 0) this.buffer += ',';
+            this.buffer += name + ':' + value;            
+        }
+        
+        /**
+         * Converts the message to a JSON payload
+         */
+        //%
+        public toJSON() : string {
+            return '{' + this.buffer + '}';
+        }        
+    }
+}

libs/microbit/serial.cpp

@@ -15,7 +15,7 @@ namespace serial {
     /**
      * Sends a piece of text through Serial connection.
      */
-    //%
+    //% blockId=serial_writestring block="serial write %text"
     void writeString(StringData *text) { 
       uBit.serial.send(ManagedString(text));
     }

libs/microbit/serial.ts

@@ -7,8 +7,8 @@ namespace serial {
      * Prints a line of text to the serial
      * @param value to send over serial
      */
-    //% help=/serial/write-line
-    //% blockId=serial_writeline block="serial|write %text"
+    //% help=serial/write-line
+    //% blockId=serial_writeline block="serial|write line %text"
     export function writeLine(text: string): void {
         writeString(text);
         writeString("\r\n");
@@ -17,6 +17,7 @@ namespace serial {
     /**
      * Prints a numeric value to the serial
      */
+    //% blockId=serial_writenumber block="serial|write number %value"
     export function writeNumber(value: number): void {
         writeString(value.toString());
     }
@@ -27,8 +28,8 @@ namespace serial {
      * @param value to write
      */
     //% weight=80
-    //% help=/serial/write-value
-    //% blockId=serial_writevalue block="serial|write %name|= %value"
+    //% help=serial/write-value
+    //% blockId=serial_writevalue block="serial|write line %name|= %value"
     export function writeValue(name: string, value: number): void {
         writeString(name);
         writeString(": ");

libs/microbit/shims.d.ts

@@ -342,6 +342,18 @@ declare namespace control {
     //% weight=20 blockGap=8 blockId="control_on_event" block="on event|from %src=control_event_source|with value %value=control_event_value" 
     //% blockExternalInputs=1 shim=control::onEvent
     function onEvent(src: number, value: number, handler: () => void): void;
+
+    /**
+     * Gets a friendly name for the device derived from the its serial number
+     */
+    //% blockId="control_device_name" block="device name" weight=10 blockGap=8 shim=control::deviceName
+    function deviceName(): string;
+
+    /**
+     * Derive a unique, consistent serial number of this device from internal data.
+     */
+    //% blockId="control_device_serial_number" block="device serial number" weight=9 shim=control::deviceSerialNumber
+    function deviceSerialNumber(): number;
 }
 
 
@@ -528,7 +540,7 @@ declare namespace serial {
     /**
      * Sends a piece of text through Serial connection.
      */
-    //% shim=serial::writeString
+    //% blockId=serial_writestring block="serial write %text" shim=serial::writeString
     function writeString(text: string): void;
 }
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "pxt-microbit",
-  "version": "0.2.79",
+  "version": "0.2.107",
   "description": "BBC micro:bit target for PXT",
   "keywords": [
     "JavaScript",
@@ -29,6 +29,6 @@
     "typescript": "^1.8.7"
   },
   "dependencies": {
-    "pxt-core": "0.2.83"
+    "pxt-core": "0.2.121"
   }
 }