pxt-microbit 8.1.6 → 8.1.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/built/block-tests.js +1 -1
- package/built/common-sim.d.ts +0 -6
- package/built/common-sim.js +0 -23
- package/built/hexcache/{1fef376fd80fe5abf80aaeecd226ab5254a9527b79aaa9d61820abd68f4cf4dc.hex → 11ac0c4d8c3fd283c3ea5f5d690b8d6f6404a0edf545829c2e796daebdd89f05.hex} +10968 -10962
- package/built/hexcache/{8e76592a9cb06b299cd74ce547ef7a0f701f2aacd15646ccbfa1ba0f22c726ad.hex → 1932ae1475581832143ed553232f94cc2bce090c8a06446600d2d8cc064e6fe2.hex} +7124 -7122
- package/built/hexcache/{e4cf606e7e47f9b0ff3c84c06447619f9b09b575e519961b19290e8fd72e4c29.hex → 2cf003fb93506133fe5218dcd96d49cdac3688045f63ee4d96c1d0c64b203f9e.hex} +10379 -10375
- package/built/hexcache/{6cfc55436909519e8685c5d459e64fa030227c849d10978cb274204ba487916d.hex → 8567317cf55ffbf34b708198ff32d21fde9fc316774e8315c8de7eba52e25959.hex} +7633 -7631
- package/built/sim.js +2 -1
- package/built/target.js +1 -1
- package/built/target.json +1 -1
- package/built/targetlight.js +1 -1
- package/built/targetlight.json +1 -1
- package/built/theme.json +1 -1
- package/built/web/blockly.css +1 -1
- package/built/web/react-common-authcode.css +1 -1
- package/built/web/react-common-multiplayer.css +1 -1
- package/built/web/react-common-skillmap.css +1 -1
- package/built/web/rtlblockly.css +1 -1
- package/built/web/rtlreact-common-authcode.css +1 -1
- package/built/web/rtlreact-common-multiplayer.css +1 -1
- package/built/web/rtlreact-common-skillmap.css +1 -1
- package/built/web/rtlsemantic.css +2 -2
- package/built/web/semantic.css +2 -2
- package/docs/device/serial.md +8 -5
- package/docs/device/v2.md +11 -2
- package/docs/extensions/extension-gallery.md +16 -0
- package/docs/projects/spy/tug-of-led.md +1 -1
- package/docs/projects/tug-of-led.md +1 -1
- package/docs/projects/turtle-square.md +1 -1
- package/docs/reference/radio/on-received-message.md +2 -1
- package/docs/reference/radio/send-message.md +2 -1
- package/docs/reference/serial/on-data-received.md +5 -7
- package/docs/reference/serial/read-buffer.md +1 -1
- package/docs/reference/serial/read-line.md +4 -5
- package/docs/reference/serial/read-string.md +3 -3
- package/docs/reference/serial/read-until.md +3 -3
- package/docs/reference/serial/set-rx-buffer-size.md +1 -1
- package/docs/reference/serial/set-tx-buffer-size.md +1 -1
- package/docs/reference/serial/write-line.md +4 -4
- package/docs/reference/serial/write-number.md +38 -8
- package/docs/reference/serial/write-numbers.md +3 -3
- package/docs/reference/serial/write-string.md +20 -4
- package/docs/reference/serial/write-value.md +5 -3
- package/docs/translate.md +14 -14
- package/package.json +3 -3
- package/pxtarget.json +2 -1
- package/targetconfig.json +5 -1
package/docs/device/serial.md
CHANGED
|
@@ -26,16 +26,19 @@ Unfortunately, using the serial library requires quite a bit of a setup.
|
|
|
26
26
|
|
|
27
27
|
### ~ hint
|
|
28
28
|
|
|
29
|
-
|
|
29
|
+
#### Windows earlier than 10
|
|
30
30
|
|
|
31
31
|
If you are running a Windows version earlier than 10, you must [install a device driver](https://os.mbed.com/docs/latest/tutorials/windows-serial-driver.html) (for the computer to recognize the serial interface of the micro:bit).
|
|
32
32
|
|
|
33
|
-
|
|
33
|
+
### ~
|
|
34
|
+
|
|
34
35
|
Also, if you don't see the serial port as one of your computer's devices, you might need to [update the firmware](/device/firmware) on the @boardname@. Find the device name for the attached serial port in the following instructions for your operating system.
|
|
35
36
|
|
|
36
|
-
|
|
37
|
+
## Windows
|
|
38
|
+
|
|
39
|
+
### Tera Term
|
|
37
40
|
|
|
38
|
-
* Install the terminal emulator [Tera Term](https://
|
|
41
|
+
* Install the terminal emulator [Tera Term](https://teratermproject.github.io/index-en.html). The the latest release and can be downloaded [from here](https://github.com/TeraTermProject/teraterm/releases). Scroll down to the "Assets" section and download the release package that is appropriate for your computer. For example, if you have an x64 based processor, click on the one that ends in "x64.exe".
|
|
39
42
|
|
|
40
43
|
Once both the driver and the terminal emulator are installed, plug in the micro:bit and wait until the device is fully setup. Then, open TeraTerm.
|
|
41
44
|
|
|
@@ -47,7 +50,7 @@ You should be good. Feel free to hit `Setup` > `Save Setup` in the menus to eras
|
|
|
47
50
|
|
|
48
51
|
Please note that Windows will assign you a different COM port if you plug in another micro:bit. If you're juggling between micro:bits, you'll have to change the COM port every time.
|
|
49
52
|
|
|
50
|
-
###
|
|
53
|
+
### Putty
|
|
51
54
|
|
|
52
55
|
If you prefer another terminal emulator (such as [PuTTY](https://www.chiark.greenend.org.uk/~sgtatham/putty/)), here are some instructions.
|
|
53
56
|
|
package/docs/device/v2.md
CHANGED
|
@@ -9,7 +9,7 @@ Let's learn how this works in MakeCode...
|
|
|
9
9
|

|
|
10
10
|
<br/>
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
Here are the standard blocks that **require** micro:bit v2 hardware to run.
|
|
13
13
|
|
|
14
14
|
```block
|
|
15
15
|
let pressed = input.logoIsPressed()
|
|
@@ -23,7 +23,7 @@ input.onSound(DetectedSound.Loud, function () {})
|
|
|
23
23
|
input.onLogoEvent(TouchButtonEvent.Pressed, function () {})
|
|
24
24
|
```
|
|
25
25
|
|
|
26
|
-
If your program tries to run any of these blocks on a micro:bit v1 board, you will see the
|
|
26
|
+
If your program tries to run any of these blocks on a micro:bit **v1** board, you will see the **927** error code scroll across your screen.
|
|
27
27
|
|
|
28
28
|
```sim
|
|
29
29
|
basic.forever(function() {
|
|
@@ -32,6 +32,15 @@ basic.forever(function() {
|
|
|
32
32
|
})
|
|
33
33
|
```
|
|
34
34
|
|
|
35
|
+
### ~ alert
|
|
36
|
+
|
|
37
|
+
#### v2 features in extension blocks
|
|
38
|
+
|
|
39
|
+
if you're using blocks from a loaded extension, such as [Datalogger](/reference/datalogger), that are using any newer **v2** features on a **v1** board, you will also see the **927** error when your program tries to run those blocks.
|
|
40
|
+
|
|
41
|
+
### ~
|
|
42
|
+
|
|
43
|
+
|
|
35
44
|
### New blocks reference
|
|
36
45
|
|
|
37
46
|
The reference information for the new blocks introduced for micro:bit v2:
|
|
@@ -70,6 +70,10 @@ Many extensions are available to work with interface kits, add-on hardware, or o
|
|
|
70
70
|
|
|
71
71
|
```codecard
|
|
72
72
|
[{
|
|
73
|
+
"name": "TM1638",
|
|
74
|
+
"url": "/pkg/NathanPervin/pxt-tm1638",
|
|
75
|
+
"cardType": "package"
|
|
76
|
+
}, {
|
|
73
77
|
"name": "Pythom1234 OLED Display SSD1306 128x64",
|
|
74
78
|
"url": "/pkg/Pythom1234/pxt-oled",
|
|
75
79
|
"cardType": "package"
|
|
@@ -388,6 +392,10 @@ Many extensions are available to work with interface kits, add-on hardware, or o
|
|
|
388
392
|
|
|
389
393
|
```codecard
|
|
390
394
|
[{
|
|
395
|
+
"name": "FWD Edu Coding For Good Kit",
|
|
396
|
+
"url": "/pkg/Forward-Education/pxt-coding-for-good",
|
|
397
|
+
"cardType": "package"
|
|
398
|
+
}, {
|
|
391
399
|
"name": "Smarthon Smart Home IoT Maker Kit",
|
|
392
400
|
"url": "/pkg/SMARTHON/pxt-smarthome",
|
|
393
401
|
"cardType": "package"
|
|
@@ -555,6 +563,10 @@ Many extensions are available to work with interface kits, add-on hardware, or o
|
|
|
555
563
|
"name": "DFRobot HuskyLens",
|
|
556
564
|
"url":"/pkg/DFRobot/pxt-DFRobot_HuskyLens",
|
|
557
565
|
"cardType": "package"
|
|
566
|
+
}, {
|
|
567
|
+
"name": "DFRobot HuskyLens 2",
|
|
568
|
+
"url":"/pkg/DFRobot/pxt-DFRobot_HuskyLensV2",
|
|
569
|
+
"cardType": "package"
|
|
558
570
|
}]
|
|
559
571
|
```
|
|
560
572
|
## Robotics
|
|
@@ -911,6 +923,10 @@ Many extensions are available to work with interface kits, add-on hardware, or o
|
|
|
911
923
|
|
|
912
924
|
```codecard
|
|
913
925
|
[{
|
|
926
|
+
"name": "BestModules BMduino",
|
|
927
|
+
"url": "/pkg/BestModules-Libraries/pxt-bmduino",
|
|
928
|
+
"cardType": "package"
|
|
929
|
+
}, {
|
|
914
930
|
"name": "Backyard Brains Spiker:Bit",
|
|
915
931
|
"url": "/pkg/BackyardBrains/pxt-spikerbit",
|
|
916
932
|
"cardType": "package"
|
|
@@ -20,7 +20,7 @@ let rope = 2
|
|
|
20
20
|
|
|
21
21
|
## {Step 2}
|
|
22
22
|
|
|
23
|
-
Add a ``||basic:forever||`` loop that
|
|
23
|
+
Add a ``||basic:forever||`` loop that will ``||basic:clear screen||`` and turn on the LED at the position set in ``||variables:rope||``.
|
|
24
24
|
|
|
25
25
|
```spy
|
|
26
26
|
let rope = 2
|
|
@@ -19,7 +19,7 @@ let rope = 2
|
|
|
19
19
|
|
|
20
20
|
## {Step 2}
|
|
21
21
|
|
|
22
|
-
|
|
22
|
+
In the ``||basic:forever||`` loop, put in a ``||basic:clear screen||`` and plot an LED at the ``||variables:rope||`` position.
|
|
23
23
|
|
|
24
24
|
```blocks
|
|
25
25
|
let rope = 2
|
|
@@ -43,7 +43,7 @@ input.onButtonPressed(Button.A, function() {
|
|
|
43
43
|
|
|
44
44
|
## "for" is for repetition
|
|
45
45
|
|
|
46
|
-
Did you notice the pattern of repeated blocks needed to draw a square? Try using a ``for`` loop to achieve the same effect.
|
|
46
|
+
Did you notice the pattern of repeated blocks needed to draw a square? Try using a ``for`` loop with an `index` limit of **3** to achieve the same effect.
|
|
47
47
|
|
|
48
48
|
```blocks
|
|
49
49
|
input.onButtonPressed(Button.A, function() {
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
## Example #example
|
|
4
4
|
|
|
5
|
-
Send a ``Hello`` message when button ``A`` is pressed, ``Goodbye`` when button ``B`` is pressed. If the messages are received, display either a ``heart`` or a ``scissor`` for the
|
|
5
|
+
Send a ``Hello`` message when button ``A`` is pressed, ``Goodbye`` when button ``B`` is pressed. If the messages are received, display either a ``heart`` for the ``Hello`` message or a ``scissor`` for the ``Goodbye`` message.
|
|
6
6
|
|
|
7
7
|
```blocks
|
|
8
8
|
enum RadioMessage {
|
|
@@ -10,6 +10,7 @@ enum RadioMessage {
|
|
|
10
10
|
Hello = 49337,
|
|
11
11
|
Goodbye = 16885
|
|
12
12
|
}
|
|
13
|
+
radio.setGroup(3)
|
|
13
14
|
input.onButtonPressed(Button.A, function () {
|
|
14
15
|
radio.sendMessage(RadioMessage.Hello)
|
|
15
16
|
})
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
## Example #example
|
|
4
4
|
|
|
5
|
-
Send a ``Hello`` message when button ``A`` is pressed, ``Goodbye`` when button ``B`` is pressed. If the messages are received, display either a ``heart`` or a ``scissor`` for the
|
|
5
|
+
Send a ``Hello`` message when button ``A`` is pressed, ``Goodbye`` when button ``B`` is pressed. If the messages are received, display either a ``heart`` for the ``Hello`` message or a ``scissor`` for the ``Goodbye`` message.
|
|
6
6
|
|
|
7
7
|
```blocks
|
|
8
8
|
enum RadioMessage {
|
|
@@ -10,6 +10,7 @@ enum RadioMessage {
|
|
|
10
10
|
Hello = 49337,
|
|
11
11
|
Goodbye = 16885
|
|
12
12
|
}
|
|
13
|
+
radio.setGroup(3)
|
|
13
14
|
input.onButtonPressed(Button.A, function () {
|
|
14
15
|
radio.sendMessage(RadioMessage.Hello)
|
|
15
16
|
})
|
|
@@ -1,8 +1,7 @@
|
|
|
1
|
-
#
|
|
1
|
+
# on Data Received
|
|
2
2
|
|
|
3
3
|
Registers an event to be fired when one of the delimiter is matched.
|
|
4
4
|
|
|
5
|
-
|
|
6
5
|
```sig
|
|
7
6
|
serial.onDataReceived(",", function() {})
|
|
8
7
|
```
|
|
@@ -13,10 +12,10 @@ serial.onDataReceived(",", function() {})
|
|
|
13
12
|
|
|
14
13
|
## Example
|
|
15
14
|
|
|
16
|
-
Read values separated by
|
|
15
|
+
Read values separated by a comma `,`.
|
|
17
16
|
|
|
18
17
|
```blocks
|
|
19
|
-
serial.onDataReceived(serial.delimiters(Delimiters.Comma), ()
|
|
18
|
+
serial.onDataReceived(serial.delimiters(Delimiters.Comma), function() {
|
|
20
19
|
basic.showString(serial.readUntil(serial.delimiters(Delimiters.Comma)))
|
|
21
20
|
})
|
|
22
21
|
```
|
|
@@ -24,6 +23,5 @@ serial.onDataReceived(serial.delimiters(Delimiters.Comma), () => {
|
|
|
24
23
|
## See also
|
|
25
24
|
|
|
26
25
|
[serial](/device/serial),
|
|
27
|
-
[
|
|
28
|
-
[
|
|
29
|
-
|
|
26
|
+
[write line](/reference/serial/write-line),
|
|
27
|
+
[write value](/reference/serial/write-value)
|
|
@@ -34,7 +34,7 @@ Read character data from the serial port one row at a time. Write the rows to an
|
|
|
34
34
|
serial.setRxBufferSize(10)
|
|
35
35
|
for (let i = 0; i < 24; i++) {
|
|
36
36
|
let rowData = serial.readBuffer(10)
|
|
37
|
-
pins.i2cWriteBuffer(65, rowData, false)
|
|
37
|
+
pins.i2cWriteBuffer(65, rowData, false)
|
|
38
38
|
}
|
|
39
39
|
```
|
|
40
40
|
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# read Line
|
|
2
2
|
|
|
3
3
|
Read a line of text from the serial port.
|
|
4
4
|
|
|
@@ -14,7 +14,6 @@ This function expects the line it reads to be terminated with the `\n`
|
|
|
14
14
|
character. If your terminal software does not terminate lines with
|
|
15
15
|
`\n`, this function will probably never return a value.
|
|
16
16
|
|
|
17
|
-
|
|
18
17
|
You can override the ``serial.NEW_LINE_DELIMITER`` field to change the newline delimiter.
|
|
19
18
|
|
|
20
19
|
### ~
|
|
@@ -30,7 +29,7 @@ The following example requests the user's name, then repeats it to greet the use
|
|
|
30
29
|
```blocks
|
|
31
30
|
basic.forever(() => {
|
|
32
31
|
serial.writeLine("What is your name?")
|
|
33
|
-
let answer = serial.readLine()
|
|
32
|
+
let answer = serial.readLine()
|
|
34
33
|
serial.writeString("Hello,")
|
|
35
34
|
serial.writeLine(answer)
|
|
36
35
|
})
|
|
@@ -39,5 +38,5 @@ basic.forever(() => {
|
|
|
39
38
|
## See also
|
|
40
39
|
|
|
41
40
|
[serial](/device/serial),
|
|
42
|
-
[
|
|
43
|
-
[
|
|
41
|
+
[write line](/reference/serial/write-line),
|
|
42
|
+
[write value](/reference/serial/write-value)
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# read String
|
|
2
2
|
|
|
3
3
|
Read the buffered serial data as a string.
|
|
4
4
|
|
|
@@ -23,5 +23,5 @@ basic.forever(function() {
|
|
|
23
23
|
## See also
|
|
24
24
|
|
|
25
25
|
[serial](/device/serial),
|
|
26
|
-
[
|
|
27
|
-
[
|
|
26
|
+
[write line](/reference/serial/write-line),
|
|
27
|
+
[write value](/reference/serial/write-value)
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# read Until
|
|
2
2
|
|
|
3
3
|
Read a text from the serial port until a delimiter is found.
|
|
4
4
|
|
|
@@ -24,5 +24,5 @@ basic.forever(() => {
|
|
|
24
24
|
## See also
|
|
25
25
|
|
|
26
26
|
[serial](/device/serial),
|
|
27
|
-
[
|
|
28
|
-
[
|
|
27
|
+
[write line](/reference/serial/write-line),
|
|
28
|
+
[write value](/reference/serial/write-value)
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# write Line
|
|
2
2
|
|
|
3
3
|
Write a string to the [serial](/device/serial) port and start a new line of text
|
|
4
4
|
by writing `\r\n`.
|
|
@@ -57,6 +57,6 @@ basic.forever(function() {
|
|
|
57
57
|
## See also
|
|
58
58
|
|
|
59
59
|
[serial](/device/serial),
|
|
60
|
-
[
|
|
61
|
-
[
|
|
62
|
-
[
|
|
60
|
+
[write number](/reference/serial/write-number),
|
|
61
|
+
[write string](/reference/serial/write-string),
|
|
62
|
+
[write value](/reference/serial/write-value)
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# write Number
|
|
2
2
|
|
|
3
3
|
Write a number to the [serial](/device/serial) port.
|
|
4
4
|
|
|
@@ -6,22 +6,53 @@ Write a number to the [serial](/device/serial) port.
|
|
|
6
6
|
serial.writeNumber(0)
|
|
7
7
|
```
|
|
8
8
|
|
|
9
|
+
A number value is written to the serial port as characters in a string representation. The number `876`, for example:
|
|
10
|
+
|
|
11
|
+
```block
|
|
12
|
+
serial.writeNumber(876)
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
The receiving serial port will see this number as the 3 characters:
|
|
16
|
+
|
|
17
|
+
```
|
|
18
|
+
876
|
|
19
|
+
```
|
|
20
|
+
|
|
9
21
|
## Parameters
|
|
10
22
|
|
|
11
23
|
* `value` is the [number](/types/number) to write to the serial port
|
|
12
24
|
|
|
13
|
-
|
|
25
|
+
### ~ reminder
|
|
26
|
+
|
|
27
|
+
#### Simulator data log
|
|
28
|
+
|
|
29
|
+
When a number is written to the serial port, it's sent immediately over the serial connection. However, when you code with ``||serial:write number||`` in the Editor, the simulator's data log may not display the output data right away. The characters that represent the number may get queued in the data log buffer and won't display until:
|
|
14
30
|
|
|
15
|
-
|
|
31
|
+
* a 'newline' line character is received (`\n`)
|
|
32
|
+
|
|
33
|
+
-- or --
|
|
34
|
+
|
|
35
|
+
* log data buffer limit is reached (currently set at `255` characters).
|
|
36
|
+
|
|
37
|
+
If you want to see the string displayed immediately, use a ``||serial:write line||`` with an empty string right after the ``||serial:write number||``.
|
|
38
|
+
|
|
39
|
+
### ~
|
|
40
|
+
|
|
41
|
+
## Examples
|
|
42
|
+
|
|
43
|
+
### One, Two, Three
|
|
44
|
+
|
|
45
|
+
This program repeatedly writes a 3-digit number as a line to the serial port.
|
|
16
46
|
|
|
17
47
|
```blocks
|
|
18
48
|
basic.forever(function() {
|
|
19
49
|
serial.writeNumber(123)
|
|
50
|
+
serial.writeLine("")
|
|
20
51
|
basic.pause(5000)
|
|
21
52
|
});
|
|
22
53
|
```
|
|
23
54
|
|
|
24
|
-
|
|
55
|
+
### Plot bar graph does serial
|
|
25
56
|
|
|
26
57
|
If you use the ``led.plotBarGraph`` function, it writes the number
|
|
27
58
|
being plotted to the serial port too.
|
|
@@ -36,7 +67,6 @@ basic.forever(function() {
|
|
|
36
67
|
## See also
|
|
37
68
|
|
|
38
69
|
[serial](/device/serial),
|
|
39
|
-
[
|
|
40
|
-
[
|
|
41
|
-
[
|
|
42
|
-
|
|
70
|
+
[write line](/reference/serial/write-line),
|
|
71
|
+
[write value](/reference/serial/write-value),
|
|
72
|
+
[write numbers](/reference/serial/write-numbers)
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# write Numbers
|
|
2
2
|
|
|
3
3
|
Write an array of numbers to the [serial](/device/serial) port.
|
|
4
4
|
|
|
@@ -41,5 +41,5 @@ basic.forever(function() {
|
|
|
41
41
|
## See also
|
|
42
42
|
|
|
43
43
|
[serial](/device/serial),
|
|
44
|
-
[
|
|
45
|
-
[
|
|
44
|
+
[write line](/reference/serial/write-line),
|
|
45
|
+
[write value](/reference/serial/write-value)
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# write String
|
|
2
2
|
|
|
3
3
|
Write a string to the [serial](/device/serial) port,
|
|
4
4
|
without starting a new line afterward.
|
|
@@ -7,6 +7,22 @@ without starting a new line afterward.
|
|
|
7
7
|
serial.writeString("")
|
|
8
8
|
```
|
|
9
9
|
|
|
10
|
+
### ~ reminder
|
|
11
|
+
|
|
12
|
+
#### Simulator data log
|
|
13
|
+
|
|
14
|
+
When a string is written to the serial port, it's sent immediately over the serial connection. However, when you code with ``||serial:write string||`` in the Editor, the simulator's data log may not display the output data right away. The characters that represent the string may get queued in the data log buffer and won't display until:
|
|
15
|
+
|
|
16
|
+
* a 'newline' line character is received (`\n`)
|
|
17
|
+
|
|
18
|
+
-- or --
|
|
19
|
+
|
|
20
|
+
* log data buffer limit is reached (currently set at `255` characters).
|
|
21
|
+
|
|
22
|
+
If you want to see the string displayed immediately, use a ``||serial:write line||`` with an empty string right after the ``||serial:write string||``.
|
|
23
|
+
|
|
24
|
+
### ~
|
|
25
|
+
|
|
10
26
|
## Parameters
|
|
11
27
|
|
|
12
28
|
* `text` is the [string](/types/string) to write to the serial port
|
|
@@ -26,6 +42,6 @@ basic.forever(function() {
|
|
|
26
42
|
## See also
|
|
27
43
|
|
|
28
44
|
[serial](/device/serial),
|
|
29
|
-
[
|
|
30
|
-
[
|
|
31
|
-
[
|
|
45
|
+
[write line](/reference/serial/write-line),
|
|
46
|
+
[write number](/reference/serial/write-number),
|
|
47
|
+
[write value](/reference/serial/write-value)
|
|
@@ -40,8 +40,10 @@ basic.forever(function() {
|
|
|
40
40
|
|
|
41
41
|
### ~hint
|
|
42
42
|
|
|
43
|
+
#### Radio-Serial gateway
|
|
44
|
+
|
|
43
45
|
The [send value](/reference/radio/send-value) function broadcasts
|
|
44
|
-
string/number pairs.
|
|
46
|
+
string/number pairs. You can use a second @boardname@ to receive them,
|
|
45
47
|
and then send them directly to the serial port with ``write value``.
|
|
46
48
|
|
|
47
49
|
### ~
|
|
@@ -49,6 +51,6 @@ and then send them directly to the serial port with ``write value``.
|
|
|
49
51
|
## See also
|
|
50
52
|
|
|
51
53
|
[serial](/device/serial),
|
|
52
|
-
[
|
|
53
|
-
[
|
|
54
|
+
[write line](/reference/serial/write-line),
|
|
55
|
+
[write number](/reference/serial/write-number),
|
|
54
56
|
[send value](/reference/radio/send-value)
|
package/docs/translate.md
CHANGED
|
@@ -6,13 +6,13 @@
|
|
|
6
6
|
|
|
7
7
|
#### Help translate
|
|
8
8
|
|
|
9
|
-
Looking to help translate the site for **[microbit.org](http://microbit.org)**? Try http://translate.microbit.org/ to help the
|
|
9
|
+
Looking to help translate the site for **[microbit.org](http://microbit.org)**? Try http://translate.microbit.org/ to help the Micro:bit Foundation!
|
|
10
10
|
|
|
11
11
|
### ~
|
|
12
12
|
|
|
13
13
|
## #target-files
|
|
14
14
|
|
|
15
|
-
When you select your language from the [MakeCode](https://crowdin.com/project/makecode) project
|
|
15
|
+
When you select your language from the [MakeCode](https://crowdin.com/project/makecode) project homepage, you'll find all of the localization files for MakeCode shown in a folder tree. The strings to translate for the @boardname@ are found in the files under the **microbit** folder for the current language.
|
|
16
16
|
|
|
17
17
|

|
|
18
18
|
|
|
@@ -22,34 +22,34 @@ The files listed in the following sections provide a guide to how each of the tr
|
|
|
22
22
|
|
|
23
23
|
### Editor
|
|
24
24
|
|
|
25
|
-
There
|
|
25
|
+
There are a few files that are specific to the MakeCode editor itself. These contain strings for the editor UI and the simulator. They are essential to translate and should be prioritized before the other files.
|
|
26
26
|
|
|
27
27
|
| File | Description |
|
|
28
28
|
| - | - |
|
|
29
|
-
| strings.json | Common strings that shared by all MakeCode editors. **Note**: This file is located at the MakeCode project's root folder rather than under **microbit** |
|
|
29
|
+
| strings.json | Common strings that are shared by all MakeCode editors. **Note**: This file is located at the MakeCode project's root folder rather than under **microbit** |
|
|
30
30
|
| target-strings.json | Strings custom to the @boardname@ editor interface |
|
|
31
31
|
| sim-strings.json | Strings for the @boardname@ simulator |
|
|
32
32
|
<br/>
|
|
33
33
|
|
|
34
|
-
This is an example of the editor with
|
|
34
|
+
This is an example of the editor with its interface elements localized:
|
|
35
35
|
|
|
36
36
|

|
|
37
37
|
|
|
38
38
|
### Blocks
|
|
39
39
|
|
|
40
|
-
The strings for the programming code blocks all have names in the form of '_name_-strings.json' and '_name_-jsdoc-strings.json'. The _name_ part of the filename often refers to which set of blocks or the extension
|
|
40
|
+
The strings for the programming code blocks all have names in the form of '_name_-strings.json' and '_name_-jsdoc-strings.json'. The _name_ part of the filename often refers to which set of blocks or the extension that the blocks come from.
|
|
41
41
|
|
|
42
42
|
| File | Description |
|
|
43
43
|
| - | - |
|
|
44
|
-
| core-jsdoc-strings.json |
|
|
44
|
+
| core-jsdoc-strings.json | Description text for code elements of the [basic](/reference/basic) and core [blocks](/blocks). **Note**: this file contains strings for the fundamental set of coding blocks and should be prioritized over the other strings files for blocks |
|
|
45
45
|
| core-strings.json | Display text for the [basic](/reference/basic) and core [blocks](/reference/blocks). **Note**: this file contains strings for the fundamental set of coding blocks and should be prioritized over the other strings files for blocks |
|
|
46
46
|
| radio-jsdoc-strings.json | Description text for code elements of the [radio](/reference/radio) blocks |
|
|
47
47
|
| radio-strings.json | Display text for the [radio](/reference/radio) blocks |
|
|
48
|
-
| radio-broadcast-jsdoc-strings.json |
|
|
48
|
+
| radio-broadcast-jsdoc-strings.json | Description text for code elements of the radio broadcast blocks |
|
|
49
49
|
| radio-broadcast-strings.json | Display text for the radio broadcast blocks |
|
|
50
50
|
| servo-jsdoc-strings.json | Description text for code elements of the [servo](/reference/servos) blocks |
|
|
51
51
|
| servo-strings.json | Display text for the [servo](/reference/servos) blocks |
|
|
52
|
-
| bluetooth-jsdoc-strings.json | Description text for code elements of the [bluetooth](/reference/bluetooth) blocks
|
|
52
|
+
| bluetooth-jsdoc-strings.json | Description text for code elements of the [bluetooth](/reference/bluetooth) blocks |
|
|
53
53
|
| bluetooth-strings.json | Display text for the [bluetooth](/reference/bluetooth) blocks |
|
|
54
54
|
| devices-jsdoc-strings.json | Description text for code elements of the _connected devices_ blocks |
|
|
55
55
|
| devices-strings.json | Display text for the _connected devices_ blocks |
|
|
@@ -57,13 +57,13 @@ The strings for the programming code blocks all have names in the form of '_name
|
|
|
57
57
|
| flashlog-strings.json | Display text for the _flashlog_ blocks |
|
|
58
58
|
| datalogger-jsdoc-strings.json | Description text for code elements of the [datalogger](/reference/datalogger) blocks |
|
|
59
59
|
| datalogger-strings.json | Display text for the [datalogger](/reference/datalogger) blocks |
|
|
60
|
-
| jacdac-jsdoc-strings.json | Description text for code elements of the _jacdac_ blocks
|
|
60
|
+
| jacdac-jsdoc-strings.json | Description text for code elements of the _jacdac_ blocks |
|
|
61
61
|
| jacdac-strings.json | Display text for the _jacdac_ blocks |
|
|
62
|
-
| color-jsdoc-strings.json | Description text for code elements of the _color_ blocks
|
|
62
|
+
| color-jsdoc-strings.json | Description text for code elements of the _color_ blocks |
|
|
63
63
|
| color-strings.json | Display text for the _color_ blocks |
|
|
64
|
-
| microphone-jsdoc-strings.json | Description text for code elements of the _microphone_ blocks
|
|
64
|
+
| microphone-jsdoc-strings.json | Description text for code elements of the _microphone_ blocks |
|
|
65
65
|
| microphone-strings.json | Display text for the _microphone_ blocks |
|
|
66
|
-
| settings-jsdoc-strings.json | Description text for code elements of the _settings_ blocks
|
|
66
|
+
| settings-jsdoc-strings.json | Description text for code elements of the _settings_ blocks |
|
|
67
67
|
| settings-strings.json | Display text for the _settings_ blocks |
|
|
68
68
|
<br/>
|
|
69
69
|
|
|
@@ -73,7 +73,7 @@ Here are some examples of translated blocks:
|
|
|
73
73
|
|
|
74
74
|
### Document pages
|
|
75
75
|
|
|
76
|
-
Document pages contain the text for any markdown page available on the MakeCode editor site. These include code block reference, projects, tutorials, how
|
|
76
|
+
Document pages contain the text for any markdown page available on the MakeCode editor site. These include code block reference, projects, tutorials, how-to information, etc.
|
|
77
77
|
|
|
78
78
|
| File | Description |
|
|
79
79
|
| - | - |
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "pxt-microbit",
|
|
3
|
-
"version": "8.1.
|
|
3
|
+
"version": "8.1.9",
|
|
4
4
|
"description": "micro:bit target for Microsoft MakeCode (PXT)",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"JavaScript",
|
|
@@ -45,8 +45,8 @@
|
|
|
45
45
|
"typescript": "4.8.3"
|
|
46
46
|
},
|
|
47
47
|
"dependencies": {
|
|
48
|
-
"pxt-common-packages": "13.
|
|
49
|
-
"pxt-core": "12.
|
|
48
|
+
"pxt-common-packages": "13.2.3",
|
|
49
|
+
"pxt-core": "12.3.3"
|
|
50
50
|
},
|
|
51
51
|
"overrides": {}
|
|
52
52
|
}
|
package/pxtarget.json
CHANGED
|
@@ -200,7 +200,7 @@
|
|
|
200
200
|
"codalTarget": {
|
|
201
201
|
"name": "codal-microbit-v2",
|
|
202
202
|
"url": "https://github.com/lancaster-university/codal-microbit-v2",
|
|
203
|
-
"branch": "v0.3.
|
|
203
|
+
"branch": "v0.3.5",
|
|
204
204
|
"type": "git"
|
|
205
205
|
},
|
|
206
206
|
"codalBinary": "MICROBIT",
|
|
@@ -519,6 +519,7 @@
|
|
|
519
519
|
"it",
|
|
520
520
|
"ja",
|
|
521
521
|
"ko",
|
|
522
|
+
"lo",
|
|
522
523
|
"nl",
|
|
523
524
|
"nb",
|
|
524
525
|
"nn-NO",
|
package/targetconfig.json
CHANGED
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
"tags": [ "Lights and Display" ],
|
|
10
10
|
"simx": {
|
|
11
11
|
"sha": "0825d56f78528c57af100a96abdfe2162f59945a",
|
|
12
|
-
"devUrl": "http://
|
|
12
|
+
"devUrl": "http://microbit-apps.github.io/display-shield/"
|
|
13
13
|
}
|
|
14
14
|
},
|
|
15
15
|
"microsoft/pxt-microturtle": {
|
|
@@ -434,6 +434,10 @@
|
|
|
434
434
|
"backyardbrains/pxt-spikerbit": { "tags": [ "Science" ] },
|
|
435
435
|
"siyeenove/pxt_mshield": { "tags": [ "Robotics" ] },
|
|
436
436
|
"siyeenove/pxt_pybit": { "tags": [ "Robotics" ] },
|
|
437
|
+
"nathanpervin/pxt-tm1638": { "tags": [ "Lights and Display" ] },
|
|
438
|
+
"bestmodules-libraries/pxt-bmduino": { "tags": [ "Science" ] },
|
|
439
|
+
"forward-education/pxt-coding-for-good": { "tags": [ "Science" ] },
|
|
440
|
+
"dfrobot/pxt-dfrobot_huskylensv2": { "tags": [ "Science" ] },
|
|
437
441
|
"microsoft/pxt-simx-sample": {
|
|
438
442
|
"simx": {
|
|
439
443
|
"sha": "7301f5900879b85127482d79bab48f03c25690a8",
|