5f7a8e5301
* update yotta defaults for 16kb devices * refactor deprecated blocks * updates for button events * update button events * update refference * update docs * update docs * update button event blocks * update docs * update block id
78 lines
2.1 KiB
Markdown
78 lines
2.1 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).
|
|
|
|
### ~ hint
|
|
|
|
#### Deprecated
|
|
|
|
This API has been deprecated! Use [serial write value](/reference/serial/write-value) instead.
|
|
|
|
### ~
|
|
|
|
## 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
|
|
|
|
#### 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
|
|
|
|
When ```radio``` data is received (after pressing the ``A`` button on
|
|
the second @boardname@), this program sends temperature data to the
|
|
serial port.
|
|
|
|
```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()
|
|
})
|
|
```
|
|
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
|
|
```
|