a93febb5b7
* add image and deprecated arrow functions * update locales * map basic.showArrow * map arrow blocks * map & remove arrow images * remove arrow blocks * update locales * remove & patch: rgbw -> rgb button/pin pressed -> button/pin event loudness -> soundLevel * update ts mappings for arrows * add wip ts patch rules * update .blocks files * use Click instead of Down as default in Documentation and tests * patch test.blocks * fix lowercase name tag * update test.blocks * update blocks test files * update blocks test files * format block files * pass blocks file tests * fix ts mapping * fix color.defl value closes https://github.com/microsoft/pxt-calliope/issues/136 * fix ts mappings - add optional spacing at the end of rgbw() - map up to v4.0.19 * add suggested changes * replace innerText by textContent Co-authored-by: JW <gitkraken@juriwolf.de> Co-authored-by: Juri <info@juriwolf.de>
67 lines
1.9 KiB
Markdown
67 lines
1.9 KiB
Markdown
# write Received Packet To Serial
|
|
|
|
Writes the last packet received by the ``radio`` to serial in JSON format.
|
|
|
|
```sig
|
|
radio.writeReceivedPacketToSerial();
|
|
```
|
|
|
|
This should be called within a callback to
|
|
[on data packet received](/reference/radio/on-data-packet-received).
|
|
|
|
## Data received format
|
|
|
|
The format for received data when these send functions are used:
|
|
|
|
- [send number](/reference/radio/send-number): ```{v:ValueSent,t:MicrobitTimeAlive,s:SerialNumber}```
|
|
- [send value](/reference/radio/send-value): ```{v:ValueSent,t:MicrobitTimeAlive,s:SerialNumber,n:"Name"}```
|
|
- [send string](/reference/radio/send-string): ```{t:MicrobitTimeAlive,s:SerialNumber,n:"Text"}```
|
|
|
|
### ~hint
|
|
|
|
The serial number value sent in the packet is set to `0` unless transmission of the serial number is enabled with ``||radio:radio set transmit serial number||``.
|
|
|
|
### ~
|
|
|
|
## Example
|
|
|
|
When ```radio``` data is received (after pressing the ``A`` button on
|
|
the second @boardname@), this program sends temperature data to the
|
|
serial port.
|
|
|
|
```blocks
|
|
input.onButtonEvent(Button.A, ButtonEvent.Click, function () {
|
|
radio.sendNumber(input.temperature())
|
|
radio.sendValue("temp", input.temperature())
|
|
radio.sendString("It's warm now")
|
|
})
|
|
radio.onReceivedNumber(function (receivedNumber) {
|
|
radio.writeReceivedPacketToSerial()
|
|
})
|
|
radio.onReceivedValue(function (name, value) {
|
|
radio.writeReceivedPacketToSerial()
|
|
})
|
|
radio.onReceivedString(function (receivedString) {
|
|
radio.writeReceivedPacketToSerial()
|
|
})
|
|
```
|
|
Sample output to serial when ``A`` button pressed:
|
|
|
|
```json
|
|
{"t":323,"s":0,"v":27}
|
|
{"t":325,"s":0,"n":"temp","v":27}
|
|
{"t":326,"s":0,"n":"It's warm now"}
|
|
```
|
|
|
|
## See also
|
|
|
|
[send number](/reference/radio/send-number),
|
|
[send value](/reference/radio/send-value),
|
|
[send string](/reference/radio/send-string),
|
|
[on data packet received](/reference/radio/on-data-packet-received),
|
|
[set transmit serial number](/reference/radio/set-transmit-serial-number)
|
|
|
|
```package
|
|
radio
|
|
```
|