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

1.9 KiB

write Received Packet To Serial

Writes the last packet received by the radio to serial in JSON format.

radio.writeReceivedPacketToSerial();

This should be called within a callback to on data packet received.

Data received format

The format for received data when these send functions are used:

  • send number: {v:ValueSent,t:MicrobitTimeAlive,s:SerialNumber}
  • send value: {v:ValueSent,t:MicrobitTimeAlive,s:SerialNumber,n:"Name"}
  • 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.

input.onButtonPressed(Button.A, 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:

{"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, send value, send string, on data packet received, set transmit serial number

radio