diff --git a/README.md b/README.md index 399a3464..575b0fc8 100644 --- a/README.md +++ b/README.md @@ -9,12 +9,19 @@ PXT ([Microsoft Programming Experience Toolkit](https://github.com/Microsoft/pxt ## Local server +The local server allows to run the editor and the documentation from your computer. + ### Setup The following commands are a 1-time setup after synching the repo on your machine. -* clone this repo to your computer -* install the PXT command line +* if not yet installed, install [Node.js 4.4.5 or higher](https://nodejs.org/en/download/) +* [clone this repo](https://help.github.com/articles/cloning-a-repository/) to your computer and go in the project folder +``` +git clone https://github.com/microsoft/pxt-microbit +cd pxt-microbit +``` +* install the PXT command line (add ``sudo`` for Mac/Linux shells). ``` npm install -g pxt ``` @@ -37,7 +44,9 @@ If you need modify the `.cpp` files, turn on yotta compilation with the ``-yt`` pxt serve -yt ``` -To make sure you're running the latest tools, run (add ``sudo`` for Mac/Linux shells) +## Updates + +To update your PXT version and make sure you're running the latest tools, run (add ``sudo`` for Mac/Linux shells) ``` pxt update ``` diff --git a/docs/blocks/logic/boolean.md b/docs/blocks/logic/boolean.md index c6873540..15df1b5f 100644 --- a/docs/blocks/logic/boolean.md +++ b/docs/blocks/logic/boolean.md @@ -86,7 +86,7 @@ if (led.point(1,1) && led.point(2,2)) { When you compare two Numbers, you get a Boolean value, such as the comparison `x < 5` in the code below: ```blocks -let x = math.random(5) +let x = Math.random(5) if(x < 5) { basic.showString("low"); } else { diff --git a/docs/lessons/headbands/activity.md b/docs/lessons/headbands/activity.md index a8c467bf..ea7c7618 100644 --- a/docs/lessons/headbands/activity.md +++ b/docs/lessons/headbands/activity.md @@ -5,7 +5,7 @@ Your beginning code should look like this: ```blocks -let coll = ([]) +let coll: string[] = [] coll.push("puppy") coll.push("clock") coll.push("night") @@ -27,7 +27,7 @@ game.startCountdown(30000) Let's add more words for the player to act out! But first, we need to increase the time in one round to give the player more time get through all the words. Let's change the `game->start countdown` statement. ```blocks -let coll = ([]) +let coll: string[] = [] coll.push("puppy") coll.push("clock") coll.push("night") @@ -52,7 +52,8 @@ game.startCountdown(60000) Now let's add 5 more words to our list of charade words. Right above the the line `word:=coll->at(index)` add 5 lines that say `coll->add("")`. In this example, we will add the words **bicycle, telephone, sun, car, and ant** but you can add whatever words you like. ```blocks -let coll.push("puppy") +let coll: string[] = [] +coll.push("puppy") coll.push("clock") coll.push("night") coll.push("cat") diff --git a/docs/lessons/headbands/quiz-answers.md b/docs/lessons/headbands/quiz-answers.md index d7c3c7b7..697cbec7 100644 --- a/docs/lessons/headbands/quiz-answers.md +++ b/docs/lessons/headbands/quiz-answers.md @@ -19,7 +19,7 @@ A 'collection' is a group of variables of the same type stored together. A 'coll ## 2. Consider the following lines of code. ```blocks -let coll = ([]) +let coll: string[] = [] coll.push("puppy") coll.push("clock") ``` @@ -35,7 +35,7 @@ basic.showString(coll[0], 150) ## 3. Consider the following lines of code. ```blocks -let coll = ([]) +let coll: string[] = [] coll.push("puppy") coll.push("clock") coll.push("cat") @@ -52,7 +52,7 @@ basic.showString(coll[2], 150) ## 4. Consider the following line of code. ```blocks -let coll = ([]) +let coll: string[] = [] ``` Write the five (5) lines of code that will add the following five words to `data->coll`: puppy, clock, night, cat, cow. @@ -60,7 +60,8 @@ Write the five (5) lines of code that will add the following five words to `data
```blocks -let coll.push("puppy") +let coll: string[] = [] +coll.push("puppy") coll.push("clock") coll.push("night") coll.push("cat") diff --git a/docs/lessons/hero/activity.md b/docs/lessons/hero/activity.md index 59fbbccb..fd6b1a8e 100644 --- a/docs/lessons/hero/activity.md +++ b/docs/lessons/hero/activity.md @@ -211,7 +211,7 @@ Let's setup the logic for the food and the ghost to be in different quadrants. F let hero = game.createSprite(2, 2); let food = game.createSprite(4, 4); let ghost = game.createSprite(0, 0); -let ghost.change(LedSpriteProperty.Blink, 100); +ghost.change(LedSpriteProperty.Blink, 100); food = led.brightness() == 8; while (true) { basic.pause(400); @@ -265,7 +265,7 @@ while (true) { } } -0.set(LedSpriteProperty.X, 4); +ghost.set(LedSpriteProperty.X, 4); ``` diff --git a/docs/reference/bluetooth.md b/docs/reference/bluetooth.md index 1961bbf5..086bbcc5 100644 --- a/docs/reference/bluetooth.md +++ b/docs/reference/bluetooth.md @@ -21,4 +21,4 @@ bluetooth.onBluetoothDisconnected(() => { ```package microbit-bluetooth -``` \ No newline at end of file +``` diff --git a/docs/reference/input.md b/docs/reference/input.md index bd045b28..7e63c4ad 100644 --- a/docs/reference/input.md +++ b/docs/reference/input.md @@ -14,6 +14,7 @@ input.onPinPressed(TouchPin.P0, () => { }); input.buttonIsPressed(Button.A); input.compassHeading(); +input.pinIsPressed(TouchPin.P0); input.temperature(); input.acceleration(Dimension.X); input.lightLevel(); @@ -21,7 +22,6 @@ input.rotation(Rotation.Pitch); input.magneticForce(Dimension.X); input.runningTime(); input.setAccelerometerRange(AcceleratorRange.OneG); -input.pinIsPressed(TouchPin.P0); input.calibrate(); input.onLogoDown(() => { diff --git a/docs/reference/led/plot-leds.md b/docs/reference/led/plot-leds.md index ca26dde1..dd796a45 100644 --- a/docs/reference/led/plot-leds.md +++ b/docs/reference/led/plot-leds.md @@ -3,11 +3,11 @@ Display an [Image](/reference/images/image) on the BBC micro:bit's [LED screen](/device/screen). NOTE: `basic -> plot image` has been replaced by `basic -> show leds`. ```sig -basic.plotLeds(` +basic.showLeds(` . . . . . . # . # . . . # . . -# ; . . # +# . . . # . # # # . `) ``` @@ -16,14 +16,14 @@ basic.plotLeds(` * leds - a series of LED on/off states that form an image (see steps below) -### Example: simley +### Example: smiley ```blocks -basic.plotLeds(` +basic.showLeds(` . . . . . . # . # . . . # . . -# ; . . # +# . . . # . # # # . `) ``` diff --git a/docs/reference/types/number.md b/docs/reference/types/number.md index 8d7cde64..ecddb249 100644 --- a/docs/reference/types/number.md +++ b/docs/reference/types/number.md @@ -61,7 +61,7 @@ The [math library](/blocks/math) includes math related functions. For example, the `absolute` function returns the returns the absolute value of input parameter `x`: ```blocks -let abs = math.absolute(-42); +let abs = Math.abs(-42); basic.showNumber(abs); ``` diff --git a/libs/microbit-bluetooth/_locales/microbit-bluetooth-strings.json b/libs/microbit-bluetooth/_locales/microbit-bluetooth-strings.json new file mode 100644 index 00000000..0ce310fb --- /dev/null +++ b/libs/microbit-bluetooth/_locales/microbit-bluetooth-strings.json @@ -0,0 +1,26 @@ +{ + "bluetooth": "Support for additional Bluetooth services.", + "bluetooth.onBluetoothConnected": "Register code to run when the micro:bit is connected to over Bluetooth", + "bluetooth.onBluetoothConnected|block": "on bluetooth connected", + "bluetooth.onBluetoothConnected|param|body": "Code to run when a Bluetooth connection is established", + "bluetooth.onBluetoothDisconnected": "Register code to run when a bluetooth connection to the micro:bit is lost", + "bluetooth.onBluetoothDisconnected|block": "on bluetooth disconnected", + "bluetooth.onBluetoothDisconnected|param|body": "Code to run when a Bluetooth connection is lost", + "bluetooth.startAccelerometerService": "Starts the Bluetooth accelerometer service", + "bluetooth.startAccelerometerService|block": "bluetooth accelerometer service", + "bluetooth.startButtonService": "Starts the Bluetooth button service", + "bluetooth.startButtonService|block": "bluetooth button service", + "bluetooth.startIOPinService": "Starts the Bluetooth IO pin service.", + "bluetooth.startIOPinService|block": "bluetooth io pin service", + "bluetooth.startLEDService": "Starts the Bluetooth LED service", + "bluetooth.startLEDService|block": "bluetooth led service", + "bluetooth.startMagnetometerService": "Starts the Bluetooth magnetometer service", + "bluetooth.startMagnetometerService|block": "bluetooth magnetometer service", + "bluetooth.startTemperatureService": "Starts the Bluetooth temperature service", + "bluetooth.startTemperatureService|block": "bluetooth temperature service", + "bluetooth.uartRead": "Reads from the Bluetooth UART service buffer, returning its contents when the specified delimiter character is encountered.", + "bluetooth.uartRead|block": "bluetooth uart read %del=bluetooth_uart_delimiter_conv", + "bluetooth.uartWrite": "Writes to the Bluetooth UART service buffer. From there the data is transmitted over Bluetooth to a connected device.", + "bluetooth.uartWrite|block": "bluetooth uart write %data", + "bluetooth|block": "bluetooth" +} \ No newline at end of file diff --git a/libs/microbit-devices/_locales/microbit-devices-strings.json b/libs/microbit-devices/_locales/microbit-devices-strings.json new file mode 100644 index 00000000..a3098eca --- /dev/null +++ b/libs/microbit-devices/_locales/microbit-devices-strings.json @@ -0,0 +1,26 @@ +{ + "devices": "Control a phone with the BBC micro:bit via Bluetooth.", + "devices.onGamepadButton": "Register code to run when the micro:bit receives a command from the paired gamepad.", + "devices.onGamepadButton|block": "on gamepad button|%NAME", + "devices.onGamepadButton|param|body": "code to run when button is pressed", + "devices.onGamepadButton|param|name": "button name", + "devices.onNotified": "Registers code to run when the device notifies about a particular event.", + "devices.onNotified|block": "on notified|%event", + "devices.onNotified|param|body": "code handler when event is triggered", + "devices.onNotified|param|event": "event description", + "devices.onSignalStrengthChanged": "Registers code to run when the device notifies about a change of signal strength.", + "devices.onSignalStrengthChanged|block": "on signal strength changed", + "devices.onSignalStrengthChanged|param|body": "Code run when the signal strength changes.", + "devices.raiseAlertTo": "Sends an ``alert`` command to the parent device.", + "devices.raiseAlertTo|block": "raise alert to|%property", + "devices.raiseAlertTo|param|event": "event description", + "devices.signalStrength": "Returns the last signal strength reported by the paired device.", + "devices.signalStrength|block": "signal strength", + "devices.tellCameraTo": "Sends a ``camera`` command to the parent device.", + "devices.tellCameraTo|block": "tell camera to|%property", + "devices.tellCameraTo|param|event": "event description", + "devices.tellRemoteControlTo": "Sends a ``remote control`` command to the parent device.", + "devices.tellRemoteControlTo|block": "tell remote control to|%property", + "devices.tellRemoteControlTo|param|event": "event description", + "devices|block": "devices" +} \ No newline at end of file diff --git a/libs/microbit/_locales/microbit-strings.json b/libs/microbit/_locales/microbit-strings.json index 73404cb4..6f719e74 100644 --- a/libs/microbit/_locales/microbit-strings.json +++ b/libs/microbit/_locales/microbit-strings.json @@ -92,7 +92,7 @@ "input.onShake": "Attaches code to run when the device is shaken.", "input.onShake|param|body": "TODO", "input.pinIsPressed": "Get the pin state (pressed or not). Requires to hold the ground to close the circuit.", - "input.pinIsPressed|block": "pin|%NAME|is pressed", + "input.pinIsPressed|block": "pin %NAME|is pressed", "input.pinIsPressed|param|name": "pin used to detect the touch", "input.rotation": "The pitch of the device, rotation along the ``x-axis``, in degrees.", "input.rotation|block": "rotation (°)|%NAME", diff --git a/package.json b/package.json index 74116eb2..23a8dbb3 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "pxt-microbit", - "version": "0.3.2", + "version": "0.3.3", "description": "BBC micro:bit target for PXT", "keywords": [ "JavaScript", @@ -29,6 +29,6 @@ "typescript": "^1.8.7" }, "dependencies": { - "pxt-core": "0.3.2" + "pxt-core": "0.3.5" } }