pxt-calliope/docs/reference/radio/write-received-packet-to-serial.md
Peli de Halleux 2b504d863d
Radiodocsupdate (#1430)
* a few updates

* more updates

* reorder radio blocks

* more shuffling of new radio apis

* fixing hot or ocold

* more doc fixes

* more updates

* fixing docs issues

* more doc fixes

* restore docs errors

* missing packate

* renamed argument of callback

* mssing radio

* more odcs fixes

* lock turtle

* ignore docs for now
2018-10-15 15:32:09 -07:00

1.7 KiB

Write Received Packet To Serial

Writes the last packet received by the radio to serial in JSON format. Should be called within a callback to on data packet received.

radio.writeReceivedPacketToSerial();

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, () => {
    radio.sendNumber(input.temperature());
    radio.sendValue("temperature", input.temperature());
    radio.sendString("It's warm now");


});
radio.onReceivedNumber(function (receivedNumber) {
    radio.writeReceivedPacketToSerial();
});

Sample output to serial when A button pressed:

{"t":323,"s":0,"v":27}
{"t":325,"s":0,"n":"temperature","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