pxt-calliope/docs/reference/radio/write-received-packet-to-serial.md

78 lines
2.1 KiB
Markdown
Raw Normal View History

# write Received Packet To Serial
2016-10-26 01:38:01 +02:00
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).
### ~ hint
#### Deprecated
This API has been deprecated! Use [serial write value](/reference/serial/write-value) instead.
### ~
## Data received format
2016-10-26 01:38:01 +02:00
The format for received data when these send functions are used:
2016-10-26 01:38:01 +02:00
- [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
#### Default serial number
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
2016-10-26 01:38:01 +02:00
When ```radio``` data is received (after pressing the ``A`` button on
the second @boardname@), this program sends temperature data to the
serial port.
2016-10-26 01:38:01 +02:00
```blocks
radio.setGroup(44)
input.onButtonEvent(Button.A, input.buttonEventClick(), 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()
})
2016-10-26 01:38:01 +02:00
```
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"}
2016-10-26 01:38:01 +02:00
```
## See also
2016-10-26 01:38:01 +02:00
[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)
2016-10-26 01:38:01 +02:00
```package
radio
```