Merge branch 'master' into origin/docs

This commit is contained in:
Peli de Halleux 2016-06-01 20:53:46 -07:00
commit 4cba801d78
231 changed files with 2183 additions and 907 deletions

4
.gitignore vendored
View File

@ -1,9 +1,11 @@
node_modules node_modules
yotta_modules
yotta_targets
built built
typings typings
tmp tmp
temp temp
projects projects/**
win10/app/bin win10/app/bin
win10/app/bld win10/app/bld
win10/*.opendb win10/*.opendb

View File

@ -1,26 +1,53 @@
# micro:bit target for PXT # micro:bit target for PXT
This target allow to program a [BBC micro:bit](https://www.microbit.co.uk/) using This target allow to program a [BBC micro:bit](https://www.microbit.co.uk/) using
[Microsoft Programming Experience Toolkit](https://github.com/Microsoft/pxt). PXT ([Microsoft Programming Experience Toolkit](https://github.com/Microsoft/pxt)).
* [Try it live](https://m.pxt.io) * [Try it live](https://m.pxt.io)
[![Build Status](https://travis-ci.org/Microsoft/pxt-microbit.svg?branch=master)](https://travis-ci.org/Microsoft/pxt-microbit) [![Build Status](https://travis-ci.org/Microsoft/pxt-microbit.svg?branch=master)](https://travis-ci.org/Microsoft/pxt-microbit)
# Getting started ## Local server
Please follow instructions at https://github.com/Microsoft/pxt#running-a-target-from-localhost ### Setup
The following commands are a 1-time setup after synching the repo on your machine.
* install the PXT command line
```
npm install -g pxt
```
* install the dependencies
```
npm install
```
### Running
Run this command to open a local web server:
```
pxt serve
```
If the local server opens in the wrong browser, make sure to copy the URL containing the local token.
Otherwise, the editor will not be able to load the projects.
If you need modify the `.cpp` files, turn on yotta compilation with the ``-yt`` flag:
```
pxt serve -yt
```
To make sure you're running the latest tools, run
```
npm update
```
More instructions at https://github.com/Microsoft/pxt#running-a-target-from-localhost
## Universal Windows App ## Universal Windows App
The Windows 10 app is a [Universal Windows Hosted Web App](https://microsoftedge.github.io/WebAppsDocs/en-US/win10/CreateHWA.htm) The Windows 10 app is a [Universal Windows Hosted Web App](https://microsoftedge.github.io/WebAppsDocs/en-US/win10/CreateHWA.htm)
that wraps m.pxt.io and provides additional features. that wraps ``m.pxt.io`` and provides additional features.
### Sideloading
* Open Windows **settings** and search for **Developer options**
* Enable the developer mode.
* Find the latest build under ``win10/app/AppPackages/latest`` and run the ``Add-AppDevPackage.ps1`` PowerShell script (mouse right-click, then `run with PowerShell`)
### Building ### Building

View File

@ -1,8 +1,8 @@
/// <reference path="../node_modules/pxt-core/built/pxt.d.ts"/> /// <reference path="../node_modules/pxt-core/built/pxt.d.ts"/>
import * as fs from 'fs'; import * as fs from "fs";
import * as path from 'path'; import * as path from "path";
import * as child_process from 'child_process'; import * as child_process from "child_process";
let writeFileAsync: any = Promise.promisify(fs.writeFile) let writeFileAsync: any = Promise.promisify(fs.writeFile)
let execAsync: (cmd: string, options?: { cwd?: string }) => Promise<Buffer> = Promise.promisify(child_process.exec) let execAsync: (cmd: string, options?: { cwd?: string }) => Promise<Buffer> = Promise.promisify(child_process.exec)
@ -13,10 +13,10 @@ export function deployCoreAsync(res: ts.pxt.CompileResult) {
if (drives.length == 0) { if (drives.length == 0) {
console.log("cannot find any drives to deploy to") console.log("cannot find any drives to deploy to")
} else { } else {
console.log("copy microbit.hex to " + drives.join(", ")) console.log(`copy ${ts.pxt.BINARY_HEX} to ` + drives.join(", "))
} }
return Promise.map(drives, d => return Promise.map(drives, d =>
writeFileAsync(d + "microbit.hex", res.outfiles["microbit.hex"]) writeFileAsync(d + ts.pxt.BINARY_HEX, res.outfiles[ts.pxt.BINARY_HEX])
.then(() => { .then(() => {
console.log("wrote hex file to " + d) console.log("wrote hex file to " + d)
})) }))

View File

@ -8,6 +8,6 @@
"module": "commonjs", "module": "commonjs",
"rootDir": ".", "rootDir": ".",
"newLine": "LF", "newLine": "LF",
"sourceMap": true "sourceMap": false
} }
} }

View File

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

View File

@ -1,8 +1,35 @@
# Documentation # Documentation
Welcome to the documentation. ```sim
basic.forever(() => {
basic.showString("DOCS ");
})
input.onButtonPressed(Button.A, () => {
led.stopAnimation();
basic.showLeds(`
. . . . .
. # . # .
. . . . .
# . . . #
. # # # .`);
});
input.onButtonPressed(Button.B, () => {
led.stopAnimation();
basic.showLeds(`
. # . # .
# . # . #
# . . . #
. # . # .
. . # . .`);
});
```
* **[getting started](/getting-started)**
* Browse the [API reference](/reference) * Browse the [API reference](/reference)
* Learn more about the [device](/device) * Learn more about the [device](/device)
* Get started with [lessons](/lessons) * Get started with [lessons](/lessons)
* Learn about [libraries](/libraries) (possibly using C++) * Follow up with the [release notes](/release-notes)
### Developers
* Learn about [packages](/packages) (possibly using C++ or ARM thumb)

204
docs/getting-started.md Normal file
View File

@ -0,0 +1,204 @@
# Getting started
Are you ready to build cool BBC micro:bit programs?
Here are some challenges for you. Unscramble the blocks in the editor
to make real programs that work!
### Show LEDs
Draw something in the editor with this block. You can draw another
smiley face, or try something else.
```shuffle
basic.showLeds(`
. . . . .
. # . # .
. . . . .
# . . . #
. # # # .
`)
```
To move your program from your computer to the BBC micro:bit:
* Connect your micro:bit to the computer with the USB cable.
* Click **Compile**.
* Drag and drop the new file whose name ends in **.hex** into the **MICROBIT** window.
* Wait until the yellow light stops blinking!
### Show animation forever
Show one picture after another by snapping blocks together to create an
animation (like a cartoon)!
```blocks
basic.showLeds(`
. . . . .
. # . # .
. . . . .
# . . . #
. # # # .
`)
basic.showLeds(`
. . . . .
. # . # .
. . . . .
. # # # .
# . . . #
`)
```
To move your program from your computer to the BBC micro:bit:
* Connect your micro:bit to the computer with the USB cable.
* Click **Compile**.
* Drag and drop the new file whose name ends in **.hex** into the **MICROBIT** window.
* Wait until the yellow light stops blinking!
### Repeat Forever
Make an animation that never stops with the ``forever`` block.
Unscramble these blocks in the editor to make an animation that first
shows a happy face, then an unhappy face, then a happy face, and never
stops.
```shuffle
basic.forever(() => {
basic.showLeds(`
. . . . .
. # . # .
. . . . .
# . . . #
. # # # .
`)
basic.showLeds(`
. . . . .
. # . # .
. . . . .
. # # # .
# . . . #
`)
});
```
### Your turn!
You can also change the pictures to make your own animation.
Make your own awesome animation with the ``show leds`` and ``forever``
blocks.
#### ~hint
You can make your animation longer if you use more than two pictures.
#### ~
### Button A and B
This program will show the word `banana` on the LED
screen when you press button `B`.
```blocks
input.onButtonPressed(Button.B, () => {
basic.showString("banana");
});
```
Now try to unscramble these blocks in the editor so that the micro:bit
shows **YES** when you press button `A` and **NO** when when you press
button `B`. All of the blocks under `on button A pressed` or
`on button B pressed` should run when you press that button.
```shuffle
input.onButtonPressed(Button.A, () => {
basic.showString("YES");
});
input.onButtonPressed(Button.B, () => {
basic.showString("NO");
});
```
### Shake
You can find when someone is shaking the BBC micro:bit by checking its
**accelerometer** (it finds whether the micro:bit is speeding up or
slowing down).
Unscramble these blocks in the editor to show a frownie when someone
shakes the micro:bit.
```shuffle
input.onGesture(Gesture.Shake, () => {
basic.showLeds(`
. . . . .
. # . # .
. . . . .
. # # # .
# . . . #`);
});
```
### Tilting with gestures
You can also find when someone is tilting the micro:bit left or right,
face up or face down, and logo up or logo down (the logo is the yellow
oval picture at the top of the board).
Try to build a Rock Paper Scissors game where you tilt the micro:bit
left to show paper, right to show scissors, and down to show rock.
Unscramble these blocks in the editor and try this program on the
micro:bit itself!
```shuffle
input.onGesture(Gesture.TiltLeft, () => {
basic.showLeds(`
# # # # #
# . . . #
# . . . #
# . . . #
# # # # #`);
});
input.onGesture(Gesture.LogoDown, () => {
basic.showLeds(`
. . . . .
. # # # .
. # # # .
. # # # .
. . . . .`);
});
input.onGesture(Gesture.TiltRight, () => {
basic.showLeds(`
# # . . #
# # . # .
. . # . .
# # . # .
# # . . #`);
});
```
### Pins
You can also use the pins as buttons. (The pins are the holes in the
metal bar at the bottom of the micro:bit board.) For example, hold
the ``GND`` button with one hand and touch the ``0`` pin (called
``P0``) with your other hand to tell the micro:bit you're pressing it.
Unscramble the blocks in the editor to show a smiley when you press
pin ``P0``.
```shuffle
input.onPinPressed(TouchPin.P0, () => {
basic.showLeds(`
. . . . .
. # . # .
. . . . .
# . . . #
. # # # .`);
});
```
### Your turn!
Use the screen, buttons, gestures, and pins to make your own fun game
with the BBC micro:bit!

View File

@ -34,7 +34,7 @@
* [Rock Paper Scissors](/lessons/rock-paper-scissors), create the classic game of rock paper scissors with if statement * [Rock Paper Scissors](/lessons/rock-paper-scissors), create the classic game of rock paper scissors with if statement
* [Truth or Dare](/lessons/truth-or-dare), a game that forces each player to reveal a secret or do something funny with if statement * [Truth or Dare](/lessons/truth-or-dare), a game that forces each player to reveal a secret or do something funny with if statement
* [Spinner](/lessons/spinner), spin the arrow with multiple if statements * [Spinner](/lessons/spinner), spin the arrow with multiple if statements
* [Die Roll](/lessons/die-roll), spin with more if statements * [Dice Roll](/lessons/dice-roll), spin with more if statements
* [Looper](/lessons/looper), display a series of numbers with a for loop index * [Looper](/lessons/looper), display a series of numbers with a for loop index
* [Strobe Light](/lessons/strobe-light), develop shapes with a nested for loops * [Strobe Light](/lessons/strobe-light), develop shapes with a nested for loops
* [Temperature](/lessons/temperature), get the ambient temperature (degree Celsius °C) * [Temperature](/lessons/temperature), get the ambient temperature (degree Celsius °C)

View File

@ -1,8 +1,6 @@
# answering machine blocks lesson # answering machine blocks lesson
create an answering machine on the BBC micro:bit #docs Create an answering machine on the BBC micro:bit
### @video td/videos/answering-machine-0
## Topic ## Topic
@ -25,12 +23,8 @@ Learn how to creating a message with a **string**, `show string` to write your m
```cards ```cards
basic.showString('Hi!') basic.showString('Hi!')
input.onButtonPressed(Button.A, () => {}) input.onButtonPressed(Button.A, () => {})
``` ```
* **on button pressed** : [read more...](/reference/input/on-button-pressed)
## Objectives ## Objectives
* learn how to show a string on the LED screen one character at a time * learn how to show a string on the LED screen one character at a time

View File

@ -4,7 +4,6 @@ Learn to create an answering machine on the micro:bit
### ~avatar avatar ### ~avatar avatar
### @video td/videos/answering-machine-0
Let's learn how to create an answering machine! Let's learn how to create an answering machine!

View File

@ -12,8 +12,6 @@ basic.showString("ASK ME A QUESTION")
### Challenge 1 ### Challenge 1
### @video td/videos/answering-machine-1
Now we need to reply after someone asks micro:bit a yes or no question. We want to respond `YES` when button `A` is pressed. Add a condition for button `A` and inside it show the string `YES`. Now we need to reply after someone asks micro:bit a yes or no question. We want to respond `YES` when button `A` is pressed. Add a condition for button `A` and inside it show the string `YES`.
```blocks ```blocks
@ -27,8 +25,6 @@ input.onButtonPressed(Button.A, () => {
### Challenge 2 ### Challenge 2
### @video td/videos/answering-machine-2
What if micro:bit's answer to the question is no? Let's have `NO` be displayed when button `B` is pressed. Add a condition for button `B` and inside it show the string `NO`. What if micro:bit's answer to the question is no? Let's have `NO` be displayed when button `B` is pressed. Add a condition for button `B` and inside it show the string `NO`.
```blocks ```blocks

View File

@ -1,8 +1,6 @@
# beautiful image lesson # beautiful image lesson
display beautiful images on the BBC micro:bit. Display beautiful images on the BBC micro:bit.
### @video td/videos/beautiful-image-0
## Topic ## Topic

View File

@ -4,8 +4,6 @@ Generate and show a beautiful image.
### ~avatar avatar ### ~avatar avatar
### @video td/videos/beautiful-image-0
Let's learn how to show an image on the LED screen. Let's learn how to show an image on the LED screen.
### ~ ### ~

View File

@ -18,8 +18,6 @@ basic.showLeds(`
### Challenge 1 ### Challenge 1
### @video td/videos/beautiful-image-1-2
Now show an new image that will display on the micro:bit. Now show an new image that will display on the micro:bit.
```blocks ```blocks

View File

@ -2,8 +2,6 @@
Learn how to create a blinking LED. Learn how to create a blinking LED.
### @video td/videos/blink-0
## Topic ## Topic
Plot Plot
@ -30,7 +28,6 @@ basic.pause(100)
basic.forever(() => {}) basic.forever(() => {})
``` ```
## Objectives ## Objectives
* learn how to turn on LED lights on the LED screen * learn how to turn on LED lights on the LED screen

View File

@ -4,7 +4,15 @@ Turn an LED on and off with forever
### ~avatar avatar ### ~avatar avatar
### @video td/videos/blink-0 ```sim
basic.forever(() => {
led.plot(2, 2)
basic.pause(500)
led.unplot(2, 2)
basic.pause(500)
})
```
Let's build a blinking light!
### ~ ### ~
@ -43,7 +51,6 @@ basic.forever(() => {
led.unplot(2, 2) led.unplot(2, 2)
basic.pause(500) basic.pause(500)
}) })
``` ```
### ~avatar boothing ### ~avatar boothing

View File

@ -17,8 +17,6 @@ basic.forever(() => {
### Challenge 1 ### Challenge 1
### @video td/videos/blink-1
Let's display a "smiley face" on the screen! We'll start by plotting the eyes. Let's display a "smiley face" on the screen! We'll start by plotting the eyes.
Add `plot(1,1)` and `plot(3,1)` under `plot(2,2)` ; then add `unplot(1,1)`, `unplot(3,1)` and `unplot(2,2)` after `pause`. When you're ready, don't forget to run your code to try it out! Add `plot(1,1)` and `plot(3,1)` under `plot(2,2)` ; then add `unplot(1,1)`, `unplot(3,1)` and `unplot(2,2)` after `pause`. When you're ready, don't forget to run your code to try it out!
@ -38,8 +36,6 @@ basic.forever(() => {
### Challenge 2 ### Challenge 2
### @video td/videos/blink-2
Let's add the code to plot the mouth by using `plot` and `unplot` to the following coordinates: (1,4), (2,4) and (3,4). When you're ready, don't forget to run your code to try it out! Let's add the code to plot the mouth by using `plot` and `unplot` to the following coordinates: (1,4), (2,4) and (3,4). When you're ready, don't forget to run your code to try it out!
```blocks ```blocks
@ -63,8 +59,6 @@ basic.forever(() => {
### Challenge 3 ### Challenge 3
### @video td/videos/blink-3
Let's keep using `plot` to convert the mouth into a smiley face. Let's keep using `plot` to convert the mouth into a smiley face.
```` bitmatrix ```` bitmatrix

View File

@ -2,8 +2,6 @@
A game to catch eggs in a basket. A game to catch eggs in a basket.
### @video td/videos/catch-the-egg-game-0
## Topic ## Topic
Variables Variables

View File

@ -108,8 +108,6 @@ basic.forever(() => {
### Challenge 3 ### Challenge 3
### @video td/videos/catch-the-egg-game-4
Let's make the egg fall faster by decreasing the amount of time it pauses in each position by decreasing **falling pause** by `25` every 5 catches. Now, instead of pausing for 300 milliseconds we can pause for the value of **falling pause**. Let's make the egg fall faster by decreasing the amount of time it pauses in each position by decreasing **falling pause** by `25` every 5 catches. Now, instead of pausing for 300 milliseconds we can pause for the value of **falling pause**.
```blocks ```blocks

View File

@ -2,8 +2,6 @@
create a die on the BBC micro:bit. create a die on the BBC micro:bit.
### @video td/videos/compass-0
## Topic ## Topic
If (Conditionals) If (Conditionals)

View File

@ -2,8 +2,6 @@
Learn how to create a counter with with on button pressed. Learn how to create a counter with with on button pressed.
### @video td/videos/counter-0
## Topic ## Topic
Variables Variables

View File

@ -4,8 +4,6 @@ Display a number with a variable.
### ~avatar avatar ### ~avatar avatar
### @video td/videos/counter-0
Welcome! This tutorial will teach you how to make a counter that increments when button A is pressed. Let's get started! Welcome! This tutorial will teach you how to make a counter that increments when button A is pressed. Let's get started!
### ~ ### ~

View File

@ -16,8 +16,6 @@ input.onButtonPressed(Button.A, () => {
### Challenge 1 ### Challenge 1
### @video td/videos/counter-1-2
Let's add the code to `count` when `B` is pressed. Add an event handler with `on button pressed(B)` then add the code to `count`. Let's add the code to `count` when `B` is pressed. Add an event handler with `on button pressed(B)` then add the code to `count`.
@ -33,7 +31,6 @@ input.onButtonPressed(Button.B, () => {
}) })
``` ```
### Challenge 3 ### Challenge 3
Now let's try to reset the counter when the micro:bit is shaken. You will need to register an event handler with `on shake`. Now let's try to reset the counter when the micro:bit is shaken. You will need to register an event handler with `on shake`.

View File

@ -1,8 +1,6 @@
# die roll lesson # dice roll lesson
create a die on the BBC micro:bit. Create a dice on the BBC micro:bit.
### @video td/videos/die-roll-0
## Topic ## Topic
@ -10,10 +8,10 @@ If (Conditionals)
## Quick Links ## Quick Links
* [activity](/lessons/die-roll/activity) * [activity](/lessons/dice-roll/activity)
* [challenges](/lessons/die-roll/challenges) * [challenges](/lessons/dice-roll/challenges)
* [quiz](/lessons/die-roll/quiz) * [quiz](/lessons/dice-roll/quiz)
* [quiz answers](/lessons/die-roll/quiz-answers) * [quiz answers](/lessons/dice-roll/quiz-answers)
## Prior learning/place of lesson in scheme of work ## Prior learning/place of lesson in scheme of work

View File

@ -1,12 +1,10 @@
# die roll activity # dice roll activity
Create a die on the micro:bit Create a dice on the micro:bit
### ~avatar avatar ### ~avatar avatar
### @video td/videos/die-roll-0 Welcome! This tutorial will help you create a dice. Let's get started!
Welcome! This tutorial will help you create a die. Let's get started!
### ~ ### ~
@ -19,7 +17,7 @@ input.onGesture(Gesture.Shake, () => {
}) })
``` ```
We need to show a random value from 1 to 6 on our die. So let's make a local variable called **roll**. We need to show a random value from 1 to 6 on our dice. So let's make a local variable called **roll**.
```blocks ```blocks
input.onGesture(Gesture.Shake, () => { input.onGesture(Gesture.Shake, () => {
@ -27,7 +25,7 @@ input.onGesture(Gesture.Shake, () => {
}) })
``` ```
We need a condition for if **roll** is 5. We will show a `6` if **roll** is 5 because **roll** has a range from 0 to 5. We can use `show LEDs` to display the side of a die that shows 6. We need a condition for if **roll** is 5. We will show a `6` if **roll** is 5 because **roll** has a range from 0 to 5. We can use `show LEDs` to display the side of a dice that shows 6.
```blocks ```blocks
@ -45,7 +43,7 @@ input.onGesture(Gesture.Shake, () => {
``` ```
Let's use an `else if` condition for if **roll** is 4. If **roll** is 4 we can show 5 dots on the die. Let's use an `else if` condition for if **roll** is 4. If **roll** is 4 we can show 5 dots on the dice.
```blocks ```blocks
@ -72,7 +70,7 @@ input.onGesture(Gesture.Shake, ()=> {
``` ```
Now we need to repeat the same steps for if **roll** is 3. If **roll** is 3 we will show `4` on the die. Now we need to repeat the same steps for if **roll** is 3. If **roll** is 3 we will show `4` on the dice.
```blocks ```blocks
@ -106,7 +104,7 @@ input.onGesture(Gesture.Shake, () => {
``` ```
Let's also repeat these steps to show the 3, 2, and 1 on the die. We are almost done with our die! Let's also repeat these steps to show the 3, 2, and 1 on the dice. We are almost done with our dice!
```blocks ```blocks
input.onGesture(Gesture.Shake, () => { input.onGesture(Gesture.Shake, () => {
@ -165,7 +163,7 @@ input.onGesture(Gesture.Shake, () => {
### ~avatar avatar ### ~avatar avatar
Excellent, you're ready to continue with the [challenges](/lessons/die-roll/challenges)! Excellent, you're ready to continue with the [challenges](/lessons/dice-roll/challenges)!
### ~ ### ~

View File

@ -1,10 +1,10 @@
# die roll challenges # dice roll challenges
Create a die on the micro:bit. Create a dice on the micro:bit.
## Before we get started ## Before we get started
Complete the following [guided tutorial](/lessons/die-roll/activity), your code should look like this: Complete the following [guided tutorial](/lessons/dice-roll/activity), your code should look like this:
```blocks ```blocks
input.onGesture(Gesture.Shake, () => { input.onGesture(Gesture.Shake, () => {
@ -62,7 +62,7 @@ input.onGesture(Gesture.Shake, () => {
### Challenge 1 ### Challenge 1
Modify the line of code with `pick random` so that only number 1-4 can appear on the die. Modify the line of code with `pick random` so that only number 1-4 can appear on the dice.
```blocks ```blocks
@ -121,7 +121,7 @@ input.onGesture(Gesture.Shake, () => {
### Challenge 2 ### Challenge 2
Let's make a trick die! Modify the line of code with `pick random` so that only numbers 3-6 can appear on the die. Also note that we need to ensure `roll = 0` when only 1 dot is shown on the BBC micro:bit. Let's make a trick dice! Modify the line of code with `pick random` so that only numbers 3-6 can appear on the dice. Also note that we need to ensure `roll = 0` when only 1 dot is shown on the BBC micro:bit.
```blocks ```blocks
input.onGesture(Gesture.Shake, () => { input.onGesture(Gesture.Shake, () => {

View File

@ -1,8 +1,8 @@
# die roll quiz answers # dice roll quiz answers
Create a die when the BBC micro:bit is shaken Create a dice when the BBC micro:bit is shaken
These are the answers to the [die roll quiz](/lessons/die-roll/quiz). These are the answers to the [dice roll quiz](/lessons/dice-roll/quiz).
## 1. Create a variable named 'roll' that will be randomly assigned to a number between 0 and 5. ## 1. Create a variable named 'roll' that will be randomly assigned to a number between 0 and 5.

View File

@ -1,12 +1,12 @@
# die roll quiz # dice roll quiz
Create a die when the BBC micro:bit is shaken Create a dice when the BBC micro:bit is shaken
## Name ## Name
## Directions ## Directions
Use this activity document to guide your work in the [die roll tutorial](/lessons/die-roll/activity). Use this activity document to guide your work in the [dice roll tutorial](/lessons/dice-roll/activity).
Answer the questions while completing the tutorial. Pay attention to the dialogues! Answer the questions while completing the tutorial. Pay attention to the dialogues!

View File

@ -1,8 +1,6 @@
# digi yoyo lesson # digi yoyo lesson
create a counter with a while loop. Create a counter with a while loop.
### @video td/videos/digi-yoyo-0
## Topic ## Topic

View File

@ -4,8 +4,6 @@ Create a counter with a while loop.
### ~avatar avatar ### ~avatar avatar
### @video td/videos/digi-yoyo-0
Welcome! This tutorial will teach how to create a counter with a while loop. Let's get started! Welcome! This tutorial will teach how to create a counter with a while loop. Let's get started!
### ~ ### ~

View File

@ -40,8 +40,6 @@ while (count > 0) {
### Challenge 2 ### Challenge 2
### @video td/videos/digi-yoyo-1-2
Inside of the while loop, let's add `pause->(1000)` so that we have a pause between each number as it's counting down. Also, let's show `count`! Inside of the while loop, let's add `pause->(1000)` so that we have a pause between each number as it's counting down. Also, let's show `count`!

View File

@ -2,8 +2,6 @@
Learn how to create LED images with a global variable. Learn how to create LED images with a global variable.
### @video td/videos/flashing-heart-0
## Topic ## Topic
Pause Pause

View File

@ -4,8 +4,6 @@ Control images with a variable.
### ~avatar avatar ### ~avatar avatar
### @video td/videos/flashing-heart-0
In this activity, you will learn how to blink an image on the LED screen. In this activity, you will learn how to blink an image on the LED screen.
### ~ ### ~

View File

@ -25,8 +25,6 @@ basic.forever(() => {
### Challenge 1 ### Challenge 1
### @video td/videos/flashing-heart-1
Let's plot a different image. Let's display a broken heart! Let's plot a different image. Let's display a broken heart!
To do this, you need to add a block between the last line and the end loop. Add a `show LEDs` block and then add a `pause` of 500 milliseconds. To do this, you need to add a block between the last line and the end loop. Add a `show LEDs` block and then add a `pause` of 500 milliseconds.
@ -60,8 +58,6 @@ basic.forever(() => {
### Challenge 2 ### Challenge 2
### @video td/videos/flashing-heart-2
Now let's alternate flashing the heart and the broken heart. To do this, we need to add a `clear screen` block and then add a `pause` block of 500 milliseconds under the new code we added in Challenge 1. Now let's alternate flashing the heart and the broken heart. To do this, we need to add a `clear screen` block and then add a `pause` block of 500 milliseconds under the new code we added in Challenge 1.

View File

@ -2,8 +2,6 @@
Learn how to create a counter with with on button pressed. Learn how to create a counter with with on button pressed.
### @video td/videos/counter-0
## Topic ## Topic
Game Library Game Library

View File

@ -1,13 +1,5 @@
# game counter activity # game counter activity
Turn an LED on and off with forever loop
### ~avatar avatar
### @video td/videos/counter-0
### ~
Have you ever tried to create a game counter? The concept is fairly simply: increase the game `score` with `on button pressed` . Have you ever tried to create a game counter? The concept is fairly simply: increase the game `score` with `on button pressed` .
Let's start by adding `on button (A) pressed` will run each time the user presses A. Let's add a line of code that increments `score` by `1`. Let's start by adding `on button (A) pressed` will run each time the user presses A. Let's add a line of code that increments `score` by `1`.

View File

@ -15,8 +15,6 @@ input.onButtonPressed(Button.A, () => {
### Challenge 1 ### Challenge 1
### @video td/videos/counter-1-2
Let's add the code to `score` when `B` is pressed. Add an event handler with `on button (B) pressed` then add the code to `score`. Let's add the code to `score` when `B` is pressed. Add an event handler with `on button (B) pressed` then add the code to `score`.

View File

@ -2,8 +2,6 @@
Learn to create a random number with input from button A. Learn to create a random number with input from button A.
### @video td/videos/guess-the-number-0
## Topic ## Topic
Math - Pick Random Math - Pick Random

View File

@ -4,8 +4,6 @@ Guess the number with math random.
### ~avatar avatar ### ~avatar avatar
### @video td/videos/guess-the-number-0
Welcome! This tutorial will help you create a guess the number game! Let's get started! Welcome! This tutorial will help you create a guess the number game! Let's get started!
### ~ ### ~

View File

@ -15,8 +15,6 @@ input.onButtonPressed(Button.A, () => {
### Challenge 1 ### Challenge 1
### @video td/videos/guess-the-number-2
When button `B` is pressed, we want to clear the screen. This will make it so users can play your game over and over again! Add an event handler to handle this case. When button `B` is pressed, we want to clear the screen. This will make it so users can play your game over and over again! Add an event handler to handle this case.
```blocks ```blocks

View File

@ -2,8 +2,6 @@
### ~avatar avatar ### ~avatar avatar
### @video td/videos/guess-the-number-0
This tutorial will help you create a guess the number game! Let's get started! This tutorial will help you create a guess the number game! Let's get started!
### ~ ### ~

View File

@ -2,8 +2,6 @@
Learn to control blinking LEDs. Learn to control blinking LEDs.
### @video td/videos/looper-0
## Topic ## Topic
For Loop For Loop

View File

@ -1,13 +1,5 @@
# looper blocks activity # looper blocks activity
Display a series of numbers with a for loop.
### ~avatar avatar
### @video td/videos/looper-0
### ~
Welcome! This activity will teach how to display a series of numbers for a for loop. Let's get started! Welcome! This activity will teach how to display a series of numbers for a for loop. Let's get started!
Let's create a for loop where `0` is the loop's starting value, `i` is the index variable, and `5` is the ending value. The index variable `i` starts at 0 and increases by 1 each time through the loop. The loop ends when `i = 5`. Let's create a for loop where `0` is the loop's starting value, `i` is the index variable, and `5` is the ending value. The index variable `i` starts at 0 and increases by 1 each time through the loop. The loop ends when `i = 5`.

View File

@ -20,8 +20,6 @@ for (let i = 0; i < 6; i++) {
### Challenge 1 ### Challenge 1
### @video td/videos/looper-1
What if we want to count up to lucky number 7 instead? Let's do that by changing the ending value to `7` instead of `5`. What if we want to count up to lucky number 7 instead? Let's do that by changing the ending value to `7` instead of `5`.
@ -37,8 +35,6 @@ for (let i = 0; i < 8; i++) {
### Challenge 2 ### Challenge 2
### @video td/videos/looper-2
What about 9? Let's do that by changing the ending value to `9`. What about 9? Let's do that by changing the ending value to `9`.
```blocks ```blocks
@ -55,8 +51,6 @@ for (let i = 0; i < 10; i++) {
### Challenge 3 ### Challenge 3
### @video td/videos/looper-3
Now let's start counting from `3` instead! Our for loop will always start at `0` so we simply add `3` to the `i` variable when passing it to `show number`. Now let's start counting from `3` instead! Our for loop will always start at `0` so we simply add `3` to the `i` variable when passing it to `show number`.
```blocks ```blocks
@ -72,8 +66,6 @@ Run it on the simulator!
### Challenge 4 ### Challenge 4
### @video td/videos/looper-4
Now, let's **count down from 9**. Change the line `show number(i + 2, 150)` to `show number(9 - i, 150)`. Now, let's **count down from 9**. Change the line `show number(i + 2, 150)` to `show number(9 - i, 150)`.
```blocks ```blocks

View File

@ -1,8 +1,6 @@
# love meter blocks lesson # love meter blocks lesson
create a love meter with the BBC micro:bit. Create a love meter with the BBC micro:bit.
### @video td/videos/love-meter-0
## Topic ## Topic

View File

@ -4,8 +4,6 @@ Create a love meter with the micro:bit
### ~avatar avatar ### ~avatar avatar
### @video td/videos/love-meter-0
Welcome! This activity will help you create a love meter with the micro:bit. Let's get started! Welcome! This activity will help you create a love meter with the micro:bit. Let's get started!
### ~ ### ~

View File

@ -45,8 +45,6 @@ input.onPinPressed(TouchPin.P0, () => {
### Challenge 3 ### Challenge 3
### @video td/videos/love-meter-3
**If** the rating is between 4 and 7, display the text "MEDIOCRE!" **else** display the text "MATCHED!" **If** the rating is between 4 and 7, display the text "MEDIOCRE!" **else** display the text "MATCHED!"
```blocks ```blocks

View File

@ -1,8 +1,6 @@
# lucky 7 blocks lesson # lucky 7 blocks lesson
show a number on the LED screen. Show a number on the LED screen.
### @video td/videos/lucky-7-0
## Topic ## Topic

View File

@ -4,8 +4,6 @@ Show a number on the LED screen.
### ~avatar avatar ### ~avatar avatar
### @video td/videos/lucky-7-0
Let's learn how to show the lucky number 7 on the LED screen. Let's learn how to show the lucky number 7 on the LED screen.
### ~ ### ~

View File

@ -21,8 +21,6 @@ basic.pause(500)
### Challenge 2 ### Challenge 2
### @video td/videos/lucky-7-1-2
What about other multiples of 7? Let's display the next multiple of 7 on the screen! What about other multiples of 7? Let's display the next multiple of 7 on the screen!
```blocks ```blocks

View File

@ -2,7 +2,7 @@
show an image that points up when the logo is up. show an image that points up when the logo is up.
### @video td/videos/magic-logo-0
## Topic ## Topic

View File

@ -4,8 +4,6 @@ Show an image that points up when the logo is up.
### ~avatar avatar ### ~avatar avatar
### @video td/videos/magic-logo-0
Welcome! This tutorial will help you display an arrow pointing toward the logo! Let's get started. Welcome! This tutorial will help you display an arrow pointing toward the logo! Let's get started.
### ~ ### ~

View File

@ -24,8 +24,6 @@ input.onLogoUp(() => {
How about when the logo is down? We should display an arrow pointing downward! How about when the logo is down? We should display an arrow pointing downward!
### @video td/videos/magic-logo-1-2
```blocks ```blocks
input.onLogoUp(() => { input.onLogoUp(() => {
basic.showLeds(` basic.showLeds(`

View File

@ -2,8 +2,6 @@
change the brightness of the BBC micro:bit. change the brightness of the BBC micro:bit.
### @video td/videos/night-light-0
## Topic ## Topic
Set Brightness Set Brightness

View File

@ -4,8 +4,6 @@ Change the brightness of the micro:bit.
### ~avatar avatar ### ~avatar avatar
### @video td/videos/night-light-0
Welcome! This tutorial will teach you how to change the brightness of the micro:bit. Let's get started! Welcome! This tutorial will teach you how to change the brightness of the micro:bit. Let's get started!
### ~ ### ~

View File

@ -23,7 +23,7 @@ input.onButtonPressed(Button.A, () => {
``` ```
### Challenge 1 ### Challenge 1
### @video td/videos/night-light-2
What if we want to turn off all the LEDs? Let's do this by setting the brightness to `0` when button `B` is pressed. Add an event handler with `on button pressed(B)` add `set brightness(0)` to turn off the LEDs. What if we want to turn off all the LEDs? Let's do this by setting the brightness to `0` when button `B` is pressed. Add an event handler with `on button pressed(B)` add `set brightness(0)` to turn off the LEDs.

View File

@ -55,7 +55,7 @@ input.onButtonPressed(Button.B, () => {
### Challenge 2 ### Challenge 2
### @video td/videos/offset-image-2
Now we want to make sure that the button does not go off the screen to the right. Add a new line that checks to see if offset = 5 after button `A` is pressed. Now we want to make sure that the button does not go off the screen to the right. Add a new line that checks to see if offset = 5 after button `A` is pressed.

View File

@ -2,7 +2,7 @@
a game against the BBC micro:bit. a game against the BBC micro:bit.
### @video td/videos/rock-paper-scissors-0
## Topic ## Topic

View File

@ -4,7 +4,7 @@ A classic game against the micro:bit.
### ~avatar avatar ### ~avatar avatar
### @video td/videos/rock-paper-scissors-0
Welcome! This tutorial will help you create a game of rock paper scissors with the micro:bit. Let's get started! Welcome! This tutorial will help you create a game of rock paper scissors with the micro:bit. Let's get started!

View File

@ -93,7 +93,7 @@ input.onButtonPressed(Button.A, () => {
### Challenge 2 ### Challenge 2
### @video td/videos/rotation-animation-1-and-2
Now that we have the on button pressed condition, let's make the animation stop rotating by setting the rotating global variable to false when button `A` is pressed. Now that we have the on button pressed condition, let's make the animation stop rotating by setting the rotating global variable to false when button `A` is pressed.

View File

@ -2,7 +2,7 @@
clear the screen by pressing button "A". clear the screen by pressing button "A".
### @video td/videos/screen-wipe-0
## Topic ## Topic

View File

@ -4,7 +4,7 @@ Clear the screen by pressing buttons on the micro:bit
### ~avatar avatar ### ~avatar avatar
### @video td/videos/screen-wipe-0
This activity will teach how to clear the screen by pressing button A on the micro:bit. This activity will teach how to clear the screen by pressing button A on the micro:bit.

View File

@ -85,7 +85,7 @@ input.onButtonPressed(Button.B, () => {
### Challenge 2 ### Challenge 2
### @video td/videos/screen-wipe-2
Replay the animation when the "B" button is pressed placing the `show LEDs` block on the canvas. Replay the animation when the "B" button is pressed placing the `show LEDs` block on the canvas.

View File

@ -2,7 +2,7 @@
design a blinking image lesson #docs design a blinking image lesson #docs
### @video td/videos/smiley-0
## Topic ## Topic

View File

@ -4,7 +4,7 @@ Learn to design a blinking image.
### ~avatar avatar ### ~avatar avatar
### @video td/videos/smiley-0
Welcome! This tutorial will help you make a smiley face blink. Let's get started! Welcome! This tutorial will help you make a smiley face blink. Let's get started!

View File

@ -54,7 +54,7 @@ input.onButtonPressed(Button.A, () => {
### Challenge 2 ### Challenge 2
### @video td/videos/smiley-2
Now, we want to show a frowny face when this button is pressed. Let's show the LEDs. Now, we want to show a frowny face when this button is pressed. Let's show the LEDs.

View File

@ -2,7 +2,7 @@
design a blinking rectangle animation. design a blinking rectangle animation.
### @video td/videos/snowflake-fall-0
## Topic ## Topic

View File

@ -4,7 +4,7 @@ design a blinking rectangle animation.
### ~avatar avatar ### ~avatar avatar
### @video td/videos/snowflake-fall-0
Welcome! This tutorial will teach how design a **snowfall animation**. Let's get started! Welcome! This tutorial will teach how design a **snowfall animation**. Let's get started!

View File

@ -27,7 +27,7 @@ basic.forever(() => {
### Challenge 1 ### Challenge 1
### @video td/videos/snowflake-fall-1
To finalize our snowflake fall, let's add a different snowflake pattern. To finalize our snowflake fall, let's add a different snowflake pattern.

View File

@ -2,7 +2,7 @@
code a speed game by declaring Booleans on the BBC micro:bit. code a speed game by declaring Booleans on the BBC micro:bit.
### @video td/videos/speed-button-3
## Topic ## Topic

View File

@ -63,7 +63,7 @@ input.onButtonPressed(Button.A, () => {
### Challenge 3 ### Challenge 3
### @video td/videos/speed-button-3
Now let's display if the user won or lost. To do so, we need to check the status of `fastPress` when the game is finished, and then show the correct message. Now let's display if the user won or lost. To do so, we need to check the status of `fastPress` when the game is finished, and then show the correct message.
@ -91,7 +91,7 @@ input.onButtonPressed(Button.A, () => {
### Challenge 4 ### Challenge 4
### @video td/videos/speed-button-4
Modify the code to change the difficulty level. Increasing the time will make it easier, while decreasing the time will make it harder. For example, changing the 5000 milliseconds to 6000 milliseconds will make the difficulty easier. Modify the code to change the difficulty level. Increasing the time will make it easier, while decreasing the time will make it harder. For example, changing the 5000 milliseconds to 6000 milliseconds will make the difficulty easier.

View File

@ -2,7 +2,7 @@
a spin the BBC micro:bit game with the input on shake. a spin the BBC micro:bit game with the input on shake.
### @video td/videos/spinner-0
## Topic ## Topic

View File

@ -4,7 +4,7 @@ Create an arrow that randomly points to a player.
### ~avatar avatar ### ~avatar avatar
### @video td/videos/spinner-0
### ~ ### ~

View File

@ -2,7 +2,7 @@
Learn how to create a blinking LED script. Learn how to create a blinking LED script.
### @video td/videos/strobe-light-0
## Topic ## Topic

View File

@ -4,7 +4,7 @@ Develop shapes with a for loop.
### ~avatar avatar ### ~avatar avatar
### @video td/videos/strobe-light-0
Welcome! This guided tutorial will teach how to develop shapes with a for loop. Let's get started! Welcome! This guided tutorial will teach how to develop shapes with a for loop. Let's get started!

View File

@ -19,7 +19,7 @@ for (let i = 0; i < 5; i++) {
### Challenge 1 ### Challenge 1
### @video td/videos/strobe-light-1
Make the LEDs light up faster by changing the **pause** from 200 to 100 milliseconds: Make the LEDs light up faster by changing the **pause** from 200 to 100 milliseconds:
@ -36,7 +36,7 @@ for (let i = 0; i < 5; i++) {
### Challenge 2 ### Challenge 2
### @video td/videos/strobe-light-2
Make the board light up by rows instead of by columns by swapping the `i` and `j` variables in `plot(i, j)`. Make the board light up by rows instead of by columns by swapping the `i` and `j` variables in `plot(i, j)`.
@ -53,7 +53,7 @@ for (let i = 0; i < 5; i++) {
### Challenge 3 ### Challenge 3
### @video td/videos/strobe-light-ultimate
Now that all the LEDs are lit up, let's make them turn off by reversing the strobe light pattern! You can use `unplot` to turn off a single LED. Now that all the LEDs are lit up, let's make them turn off by reversing the strobe light pattern! You can use `unplot` to turn off a single LED.

View File

@ -22,7 +22,7 @@ The lesson plan maps to the Progressions Pathways, Computing Curriculum, and Qui
Expand your knowledge of programming with lots of great step-by-step activities. All the lessons come with instructions that will drive the students to a complete, functional code. These activities are very directive to make sure that students keep progressing. When the activities are over, additional challenges are given to advance code through printed instructions. An activity contains supporting videos as shown with the [blink activity](/lessons/blink/activity). Expand your knowledge of programming with lots of great step-by-step activities. All the lessons come with instructions that will drive the students to a complete, functional code. These activities are very directive to make sure that students keep progressing. When the activities are over, additional challenges are given to advance code through printed instructions. An activity contains supporting videos as shown with the [blink activity](/lessons/blink/activity).
### @video td/videos/blink-0
3) Quiz 3) Quiz

View File

@ -2,7 +2,7 @@
create a love meter with the BBC micro:bit. create a love meter with the BBC micro:bit.
### @video td/videos/truth-or-dare-0
## Topic ## Topic

View File

@ -4,7 +4,7 @@ A multi-player game that forces each player to reveal a secret or something funn
### ~avatar avatar ### ~avatar avatar
### @video td/videos/truth-or-dare-0
Welcome! This tutorial will teach how to program a game of truth or dare on the micro:bit. Let's get started! Welcome! This tutorial will teach how to program a game of truth or dare on the micro:bit. Let's get started!

View File

@ -2,7 +2,7 @@
### ~avatar avatar ### ~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. 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" When the micro:bit stops spinning, the player pointed by the arrow (displayed on screen) must press the button "A"

View File

@ -2,7 +2,7 @@
measure the acceleration on the micro:bit in the "z" direction. measure the acceleration on the micro:bit in the "z" direction.
### @video td/videos/zoomer-0
## Topic ## Topic

View File

@ -4,7 +4,7 @@ Measure the acceleration on the micro:bit in the "z" direction.
### ~avatar avatar ### ~avatar avatar
### @video td/videos/zoomer-0
### ~ ### ~

View File

@ -14,7 +14,7 @@ basic.forever(() => {
``` ```
### Challenge 1 ### Challenge 1
### @video td/videos/zoomer-2
We'll modify the code to display the `x` acceleration if the `A` button is pressed. For that, we need to store `acceleration (x)` in a new variable `ax` and use a `button (A) is pressed` to detect if the button is pressed. We'll modify the code to display the `x` acceleration if the `A` button is pressed. For that, we need to store `acceleration (x)` in a new variable `ax` and use a `button (A) is pressed` to detect if the button is pressed.

View File

@ -1,14 +0,0 @@
# 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

View File

@ -1,23 +0,0 @@
# 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(() => {
});
```

9
docs/open-source.md Normal file
View File

@ -0,0 +1,9 @@
# Open Source
The editor is open source on GitHub under the MIT license. Contributions are welcome, please check our GitHub repos.
### Repos
* [microbit/pxt](https://github.com/Microsoft/pxt), programming experience toolkit (PXT)
* [microsoft/pxt-microbit](https://github.com/Microsoft/pxt-microbit), PXT target for BBC micro:bit
* [microsoft/pxt-microbit-core](https://github.com/Microsoft/pxt-microbit-core), Yotta module used to build the BBC micro:bit runtime

48
docs/packages.md Normal file
View File

@ -0,0 +1,48 @@
# 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
From the editor, the user clicks on **More** then **Add Package** and searches for the package.
To see the list of packages, click on **More** then **Show Files** to see the project file list.
To remove a package, click on the garbage button in the file list next to the package.
## Publishing libraries
Packages can be published from the pxt command line. We are still sorting out the details.
## Localizing libraries
It is possible to package localization strings for the **jsDoc** description associated to the API in the package.
When compiling a package, the PXT compiler generates a `strings.json` file under the `_locales/` folder.
This file contains a map from the symbol name to the en
```
{
...
"basic": "Provides access to basic micro:bit functionality.",
...
}
```
```
{
"basic.clearScreen": "Eteint toutes les diodes."
}
```
```
_locales/
_locales/fr/strings.json
_locales/pt-BR/strings.json
```

15
docs/projects.md Normal file
View File

@ -0,0 +1,15 @@
# Projects
### @short Projects
### ~column
## Beginner
* [Rock Paper Scissors](/projects/rock-paper-scissors)
### ~
### ~column

View File

@ -0,0 +1,34 @@
## Getting started
• Go to https://m.pxt.io/
• To create a new project, click new Project
Tap or click Blocks.
## Step 1
Use [show leds](/reference/basic/showLeds) and make your code look like this:
```blocks
basic.showLeds(`
. # . # .
# # # # #
# # # # #
. # # # .
. . # . .`);
```
Once you are done coding, don't forget to run your code with the Play button.
## Step 2
Add a [pause](/reference/basic/pause) to wait and [clear screen](/reference/basic/clearScreen) to turn off the LEDs.
```blocks
basic.showLeds(`
. # . # .
# # # # #
# # # # #
. # # # .
. . # . .`);
basic.pause(500);
basic.clearScreen();
```

View File

@ -0,0 +1,234 @@
# rock paper scissors
### ~avatar avatar
```sim
input.onGesture(Gesture.Shake, () => {
let img = Math.random(3)
if (img == 0) {
basic.showLeds(`
# # # # #
# . . . #
# . . . #
# . . . #
# # # # #
`)
} else if (img == 1) {
basic.showLeds(`
. . . . .
. # # # .
. # # # .
. # # # .
. . . . .
`)
} else {
basic.showLeds(`
# # . . #
# # . # .
. . # . .
# # . # .
# # . . #
`)
}
})
```
In this project, you will build a Rock Paper Scissors game with the BBC micro:bit.
You can play the game with a friend who has it on a micro:bit.
You can also play it with friends who are just using their hands.
### ~
## Materials needed
* Your BBC micro:bit -- that's it!
## Step 1: Getting started
We want the micro:bit to choose rock, paper, or scissors when you shake it.
Try creating an ``on shake`` block so when you shake the micro:bit, it will run part of a program.
```blocks
input.onGesture(Gesture.Shake, () => {
})
```
Next, when you shake the micro:bit, it should pick a random number from `0` to `2`
and store it in the variable `weapon`. (This variable is named `weapon` because
rock, paper, and scissors are the weapons you use to battle your friends!)
Add a ``set`` block with a variable. Then add a ``pick random`` block,
and store the random number in the variable,
like this:
```blocks
input.onGesture(Gesture.Shake, () => {
let weapon = Math.random(3)
})
```
### ~hint
No one can predict random numbers. That's what makes them great for Rock Paper Scissors!
### ~
Each possible number these blocks can make (`0`, `1`, or `2`) means a different picture.
We will show the right picture for that number on the LED screen.
## Step 2: Picking paper
Put an ``if`` block after the ``let`` block that checks whether
`weapon` is `0`. Make sure the ``if`` block has an ``else if`` part
and an ``else`` part.
Next, add a ``show leds`` block that shows a
picture of a piece of paper:
```blocks
input.onGesture(Gesture.Shake, () => {
let weapon = Math.random(3)
if (weapon == 0) {
basic.showLeds(`
# # # # #
# . . . #
# . . . #
# . . . #
# # # # #
`)
} else if (false) {
} else {
}
})
```
## Step 3: A random rock
Now we are going to add a new picture for the micro:bit to show
when another random number comes up.
Make the ``else if`` part check if the variable `weapon` is `1`.
Then add a ``show leds`` block with a picture of a rock.
```blocks
input.onGesture(Gesture.Shake, () => {
let weapon = Math.random(3)
if (weapon == 0) {
basic.showLeds(`
# # # # #
# . . . #
# . . . #
# . . . #
# # # # #
`)
} else if (weapon == 1) {
basic.showLeds(`
. . . . .
. # # # .
. # # # .
. # # # .
. . . . .
`)
} else {
}
})
```
## Step 4: Suddenly scissors
Add a ``show leds`` block with a picture of scissors to the ``else`` part:
```blocks
input.onGesture(Gesture.Shake, () => {
let weapon = Math.random(3)
if (weapon == 0) {
basic.showLeds(`
# # # # #
# . . . #
# . . . #
# . . . #
# # # # #
`)
} else if (weapon == 1) {
basic.showLeds(`
. . . . .
. # # # .
. # # # .
. # # # .
. . . . .
`)
} else {
basic.showLeds(`
# # . . #
# # . # .
. . # . .
# # . # .
# # . . #
`)
}
})
```
### ~hint
You don't need to check if `weapon` is `2` because `2` is the only number left out of `0`, `1`, and `2`.
That's why you can use an ``else`` instead of an ``else if``.
### ~
Your game is ready! Have fun!
## Step 5: Are you the greatest?
Here is a way you can make your Rock Paper Scissors game better.
When button ``A`` is pressed,
the micro:bit will add `1` to your score.
Open the ``Game`` drawer, and then add the block ``change score by 1`` to your program,
like this:
```blocks
input.onButtonPressed(Button.A, () => {
game.addScore(1)
})
```
## Step 6: Prove you're the greatest!
After your micro:bit can add `1` to the score, show how many wins you have.
```blocks
input.onButtonPressed(Button.A, () => {
game.addScore(1)
basic.showString("WINS:")
basic.showNumber(game.score())
})
```
## Step 7: Staying honest
Success! Your micro:bit can track wins!
But what about losses?
Use the ``Game`` drawer to subtract `1` from your score when you press button `B`.
Here are all the blocks you will need:
```shuffle
input.onButtonPressed(Button.B, () => {
game.addScore(-1)
basic.showString("LOSSES:")
basic.showNumber(game.score())
})
```
## Step 8: Hacking Rock Paper Scissors
How else can you make your game better?
Ever hear of [Rock Paper Scissors Spock Lizard](http://www.samkass.com/theories/RPSSL.html)?

View File

@ -9,8 +9,9 @@ basic.showNumber(0);
input.onButtonPressed(Button.A, () => { input.onButtonPressed(Button.A, () => {
}); });
led.plot(0, 0);
music.playTone(0, 0); music.playTone(0, 0);
led.plot(0, 0);
radio.sendNumber(0);
game.addScore(1); game.addScore(1);
images.createImage(` images.createImage(`
. . . . . . . . . .

5
docs/reference/String.md Normal file
View File

@ -0,0 +1,5 @@
# String
```cards
String.fromCharCode(0);
```

View File

@ -8,7 +8,7 @@ basic.clearScreen()
### Example: vanishing heart ### Example: vanishing heart
The following code displays a heart on the screen and then turns off all the LED lights using `clear screen`: The following code shows a heart on the screen and then turns off all the LED lights using `clear screen`:
```blocks ```blocks
basic.showLeds(` basic.showLeds(`

View File

@ -1,6 +1,7 @@
# Forever # Forever
Repeat code [in the background](/reference/control/in-background) forever. Keep running part of a program
[in the background](/reference/control/in-background).
```sig ```sig
basic.forever(() => { basic.forever(() => {
@ -9,7 +10,9 @@ basic.forever(() => {
### Example: compass ### Example: compass
The following example constantly checks the [compass heading](/reference/input/compass-heading) and updates the screen with the direction. The following example constantly checks the
[compass heading](/reference/input/compass-heading)
and updates the screen with the direction.
```blocks ```blocks
basic.forever(() => { basic.forever(() => {
@ -30,7 +33,9 @@ basic.forever(() => {
### Example: counter ### Example: counter
The following example continually shows the current value of a global variable: The following example keeps showing the [number](/reference/types/number) stored in a global variable.
When you press button `A`, the number gets bigger.
You can use a program like this to count things with your BBC micro:bit.
```blocks ```blocks
let num = 0 let num = 0
@ -42,9 +47,12 @@ input.onButtonPressed(Button.A, () => {
}) })
``` ```
### Contention for the LED display ### Competing for the LED screen
If you have multiple processes that each show something on the LED screen, you may get unexpected results. Try, for example: If different parts of a program are each trying
to show something on the LED screen at the same time,
you may get unexpected results.
Try this on your micro:bit:
```blocks ```blocks
basic.forever(() => { basic.forever(() => {

View File

@ -1,6 +1,7 @@
# Pause # Pause
Pause program execution for the specified number of milliseconds. This function is helpful when you need to slow down your program's execution. Pause the program for the number of milliseconds you say.
You can use this function to slow your program down.
```sig ```sig
basic.pause(400) basic.pause(400)
@ -8,11 +9,13 @@ basic.pause(400)
### Parameters ### Parameters
* ``ms`` - the number of milliseconds that you want to pause (100 = 1/10 second, 1000 milliseconds = 1 second) * ``ms`` is the number of milliseconds that you want to pause (100 milliseconds = 1/10 second, and 1000 milliseconds = 1 second).
### Example: diagonal line ### Example: diagonal line
The following example code turns on LED `0, 0` thru `4, 4`, pausing 500 milliseconds after each LED. Without `pause`, the code would run so fast that you wouldn't see each individual LED turning on. This example draws a diagonal line by turning on LED `0, 0` (top left) through LED `4, 4` (bottom right).
The program pauses 500 milliseconds after turning on each LED.
Without `pause`, the program would run so fast that you would not have time to see each LED turning on.
```blocks ```blocks
for (let i = 0; i < 5; i++) { for (let i = 0; i < 5; i++) {

View File

@ -1,6 +1,6 @@
# Show Animation # Show Animation
Show a series of image frames on the [LED screen](/device/screen), pausing the specified time after each frame. Show a group of image frames (pictures) one after another on the [LED screen](/device/screen). It pauses the amount of time you tell it after each frame.
```sig ```sig
basic.showAnimation(` basic.showAnimation(`
@ -14,10 +14,14 @@ basic.showAnimation(`
### Parameters ### Parameters
* `leds` - [String](/reference/types/string); a series of LED on/off states * `leds` is a [String](/reference/types/string) that shows which LEDs are on and off, in groups one after another.
* `interval` - [Number](/reference/types/number); the number of milliseconds to pause after each image frame * `interval` is an optional [Number](/reference/types/number). It means the number of milliseconds to pause after each image frame.
### Show a series of image frames ### Example: Animating a group of image frames
In this animation, each row is 15 spaces wide because
there are three frames in the animation, and each frame is
five spaces wide, just like the screen on the BBC micro:bit.
``` ```
basic.showAnimation(` basic.showAnimation(`
@ -31,13 +35,17 @@ basic.showAnimation(`
### ~hint ### ~hint
If the series of images appear too fast, increase the value of the *interval* parameter. If the animation is too fast, make `interval` bigger.
### ~ ### ~
### Example: animating frames ### Example: animating frames with a pause
The following example creates an image with six frames and then shows each frame o the screen, pausing 500 milliseconds after each frame: This example shows six frames on the screen, pausing 500 milliseconds after each frame.
In this animation, each row is 30 spaces wide because
there are six frames in the animation, and each frame is
five spaces wide, just like the screen.
``` ```
basic.showAnimation(` basic.showAnimation(`
@ -51,7 +59,7 @@ basic.showAnimation(`
### ~hint ### ~hint
Use [forever](/reference/basic/forever) to continually repeat an animation Use [forever](/reference/basic/forever) to show an animation over and over.
### ~ ### ~

View File

@ -15,12 +15,13 @@ basic.showLeds(`
### Parameters ### Parameters
* ``leds`` - a series of LED on/off states that form an image (see steps below) * `leds` is a [String](/reference/types/string) that shows which LEDs are on and off.
* (optional) ``ms`` - [Number](/reference/types/number) - time to wait after displaying image. In blocks, ``ms`` is 400 by default. * `ms` is an optional [Number](/reference/types/number) that shows how many milliseconds to wait after showing a picture.
If you are programming with blocks, `ms` starts out as 400 milliseconds.
### Example - Block Editor ### Example
1. Open the `basic` category and select the `show leds` blocks. Open the `basic` card in the Block Editor and select the `show leds` blocks.
```blocks ```blocks
basic.showLeds(` basic.showLeds(`
@ -33,7 +34,7 @@ basic.showLeds(`
) )
``` ```
In JavaScript, the led off is represented by a `.` and the led on by a `#` character. If you are programming in JavaScript, `#` means an LED that is turned on and `.` means an LED that is turned off.
### Lessons ### Lessons

View File

@ -1,6 +1,6 @@
# Show Number # Show Number
Show a number on the [LED screen](/device/screen), one digit at a time (scrolling from left to right) Show a number on the [LED screen](/device/screen). It will slide left if it has more than one digit.
~~~~sig ~~~~sig
basic.showNumber(2, 150) basic.showNumber(2, 150)
@ -8,18 +8,18 @@ basic.showNumber(2, 150)
### Parameters ### Parameters
* value - a [Number](/reference/types/number) * `value` is a [Number](/reference/types/number).
* (optional) interval (ms) - [Number](/reference/types/number); the time (in milliseconds) before scrolling by one LED; the larger the number, the slower the scroll * `interval` is an optional [Number](/reference/types/number). It means the number of milliseconds before sliding the `value` left by one LED each time. Bigger intervals make the sliding slower.
### ~ ### Examples:
To display the number 10: To show the number 10:
~~~~blocks ~~~~blocks
basic.showNumber(10) basic.showNumber(10)
~~~~ ~~~~
To display the number stored in the `x` variable: To show the number stored in a variable:
~~~~blocks ~~~~blocks
let x = 1 let x = 1
@ -28,19 +28,19 @@ basic.showNumber(x)
### Example: count to 5 ### Example: count to 5
This example uses a [for](/reference/loops/for) loop to show numbers ``1`` through ``5`` on the screen: This example uses a [for](/reference/loops/for) loop to show numbers ``0`` through ``5`` on the screen:
~~~~blocks ~~~~blocks
for (let i = 0; i < 5; i++) { for (let i = 0; i < 6; i++) {
basic.showNumber(i + 1) basic.showNumber(i)
basic.pause(200) basic.pause(200)
} }
~~~~ ~~~~
### Other show functions ### Other show functions
* use [show string](/reference/basic/show-string) to show a string on the screen * Use [show string](/reference/basic/show-string) to show a [String](/reference/types/string) with letters on the screen.
* use [show animation](/reference/basic/show-animation) to show a series of images on the screen * Use [show animation](/reference/basic/show-animation) to show a group of pictures on the screen, one after another.
### Lessons ### Lessons

View File

@ -1,6 +1,6 @@
# Show String # Show String
Show a string on the [LED screen](/device/screen) one character at a time (scrolling from left to right). Show a number on the [LED screen](/device/screen). It will slide left if it is bigger than the screen.
```sig ```sig
basic.showString("Hello!") basic.showString("Hello!")
@ -8,18 +8,18 @@ basic.showString("Hello!")
### Parameters ### Parameters
* `text` - a [String](/reference/types/string) * `text` is a [String](/reference/types/string). It can contain letters, numbers, and punctuation.
* (optional) `ms` - [Number](/reference/types/number); the time (in milliseconds) before scrolling left by one LED; the larger the number, the slower the scroll * `ms` is an optional [Number](/reference/types/number). It means the number of milliseconds before sliding the [String](/reference/types/string) left by one LED each time. Bigger intervals make the sliding slower.
### Examples: ### Examples:
To display Hello: To show the word **Hello**:
```blocks ```blocks
basic.showString("Hello") basic.showString("Hello")
``` ```
To display the content of a string variable: To show what is stored in a [String](/reference/types/string) variable:
```blocks ```blocks
let s = "Hi" let s = "Hi"
@ -28,8 +28,8 @@ basic.showString(s)
### Other show functions ### Other show functions
* use [show number](/reference/basic/show-number) to show a number on the screen * Use [show number](/reference/basic/show-number) to show a number on the [LED screen](/device/screen).
* use [show animation](/reference/basic/show-animation) to show a series of images on the screen * Use [show animation](/reference/basic/show-animation) to show a group of pictures on the screen, one after another.
### Lessons ### Lessons

View File

@ -1,6 +1,6 @@
# Button Is Pressed # Button Is Pressed
Get the state of an input button. The micro:bit has two input buttons: A and B. Check whether a button is pressed right now. The micro:bit has two buttons: button `A` and button `B`.
```sig ```sig
input.buttonIsPressed(Button.A); input.buttonIsPressed(Button.A);
@ -8,24 +8,26 @@ input.buttonIsPressed(Button.A);
### Parameters ### Parameters
* name - [String](/reference/types/string); input button "A", "B", or "A+B" (both input buttons) * ``name`` is a [String](/reference/types/string). You should store `A` in it to check the left button, `B` to check the right button, or `A+B` to check both at the same time.
### Returns ### Returns
* [Boolean](/reference/types/boolean) - `true` if pressed, `false` if not pressed * [Boolean](/reference/types/boolean) that is `true` if the button you are checking is pressed, `false` if it is not pressed.
### Example ### Example
The following code uses an [if](/reference/logic/if) statement to run code, depending on whether or not the A button is pressed: This program uses an [if](/reference/logic/if) to run
one part of the program if the `A` button is pressed, and
another part if it is not pressed.
```blocks ```blocks
basic.forever(() => { basic.forever(() => {
let pressed = input.buttonIsPressed(Button.A) let pressed = input.buttonIsPressed(Button.A)
if (pressed) { if (pressed) {
// this code runs if the A button is pressed // this part runs if the A button is pressed
basic.showNumber(1, 150) basic.showNumber(1, 150)
} else { } else {
// this code runs if the A button is *not* pressed // this part runs if the A button is *not* pressed
basic.showNumber(0, 150) basic.showNumber(0, 150)
} }
}) })

Some files were not shown because too many files have changed in this diff Show More