2.1.28, initiation update to PXT v5.28.24 (#54)

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

@@ -1,48 +1,66 @@
-# Write Received Packet To Serial
+# 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](/reference/radio/on-data-packet-received).
 
 ```sig
 radio.writeReceivedPacketToSerial();
 ```
 
-### Data received format
+This should be called within a callback to
+[on data packet received](/reference/radio/on-data-packet-received).
 
-The format for received data printed to serial is as follows:
+## 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"}```
 
-### Examples
+### ~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
-serial.
+the second @boardname@), this program sends temperature data to the 
+serial port.
 
 ```blocks
-input.onButtonPressed(Button.A, () => {
-    radio.sendNumber(input.temperature());
-});
-radio.onDataPacketReceived(() => {
-    radio.writeReceivedPacketToSerial();
-});
+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:
 
-```Text
-{v:27,t:323,s:0}
+```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
+## 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)
+[on data packet received](/reference/radio/on-data-packet-received),
+[set transmit serial number](/reference/radio/set-transmit-serial-number)
 
 ```package
 radio
-```
+```