Remove td, remove field matrix, update radio blocks. Revert image literal changes.

libs/radio/_locales/radio-jsdoc-strings.json

@@ -6,7 +6,9 @@
   "radio.Packet.serial": "The serial number of the sender of the packet or 0 if the sender did not sent their serial number.",
   "radio.Packet.signal": "The received signal strength indicator (RSSI) of the packet.",
   "radio.Packet.time": "The system time of the sender of the packet at the time the packet was sent.",
-  "radio.onDataPacketReceived": "Registers code to run when the radio receives a packet. Also takes the\nreceived packet from the radio queue.",
+  "radio.onReceivedNumber": "Registers code to run when the radio receives a packet. Also takes the\nreceived packet from the radio queue.",
+  "radio.onReceivedString": "Registers code to run when the radio receives a packet. Also takes the\nreceived packet from the radio queue.",
+  "radio.onReceivedValue": "Registers code to run when the radio receives a packet. Also takes the\nreceived packet from the radio queue.",
   "radio.receivedBuffer": "Returns the buffer payload from the last packet taken from the radio queue\n(via ``receiveNumber``, ``receiveString``, etc) or the empty string if that\npacket did not contain a string.",
   "radio.receivedNumber": "Returns the number payload from the last packet taken from the radio queue\n(via ``receiveNumber``, ``receiveString``, etc) or 0 if that packet did not\ncontain a number.",
   "radio.receivedSerial": "Returns the serial number of the sender micro:bit from the last packet taken\nfrom the radio queue (via ``receiveNumber``, ``receiveString``, etc) or 0 if\nthat packet did not send a serial number.",

libs/radio/_locales/radio-strings.json

@@ -1,5 +1,7 @@
 {
-  "radio.onDataPacketReceived|block": "on radio received",
+  "radio.onReceivedNumber|block": "on radio received number",
+  "radio.onReceivedString|block": "on radio received string",
+  "radio.onReceivedValue|block": "on radio received",
   "radio.sendNumber|block": "radio send number %value",
   "radio.sendString|block": "radio send string %msg",
   "radio.sendValue|block": "radio send|value %name|= %value",

libs/radio/radio.ts

@@ -37,7 +37,7 @@ namespace radio {
      * Registers code to run when the radio receives a packet. Also takes the
      * received packet from the radio queue.
      */
-    //% help=radio/on-data-packet-received
+    //% help=radio/on-data-packet-received deprecated=true
     //% mutate=objectdestructuring
     //% mutateText=Packet
     //% mutateDefaults="receivedNumber;receivedString:name,receivedNumber:value;receivedString"
@@ -55,4 +55,60 @@ namespace radio {
             cb(packet)
         });
     }
+
+    /**
+     * Registers code to run when the radio receives a packet. Also takes the
+     * received packet from the radio queue.
+     */
+    //% help=radio/on-radio-received-number
+    //% blockId=radio_on_number block="on radio received number" blockGap=8
+    export function onReceivedNumber(cb: (num: number, time?: number, serial?: number, signal?: number) => void) {
+        onDataReceived(() => {
+            receiveNumber();
+            const packet = new Packet();
+            packet.receivedNumber = receivedNumber();
+            packet.time = receivedTime();
+            packet.serial = receivedSerial();
+            packet.signal = receivedSignalStrength();
+            cb(packet.receivedNumber, packet.time, packet.serial, packet.signal);
+        });
+    }
+
+    /**
+     * Registers code to run when the radio receives a packet. Also takes the
+     * received packet from the radio queue.
+     */
+    //% help=radio/on-radio-received-string
+    //% blockId=radio_on_string block="on radio received string" blockGap=8
+    export function onReceivedString(cb: (received: string, time?: number, serial?: number, signal?: number) => void) {
+        onDataReceived(() => {
+            receiveNumber();
+            const packet = new Packet();
+            packet.time = receivedTime();
+            packet.serial = receivedSerial();
+            packet.signal = receivedSignalStrength();
+            packet.receivedString = receivedString();
+            cb(packet.receivedString, packet.time, packet.serial, packet.signal);
+        });
+    }
+
+    /**
+     * Registers code to run when the radio receives a packet. Also takes the
+     * received packet from the radio queue.
+     */
+    //% help=radio/on-radio-received-value
+    //% blockId=radio_on_value block="on radio received" blockGap=8
+    export function onReceivedValue(cb: (packet: Packet) => void) {
+        onDataReceived(() => {
+            receiveNumber();
+            const packet = new Packet();
+            packet.receivedNumber = receivedNumber();
+            packet.time = receivedTime();
+            packet.serial = receivedSerial();
+            packet.signal = receivedSignalStrength();
+            packet.receivedString = receivedString();
+            cb(packet)
+        });
+
+    }
 }