Renaming the string in onDataPacketReceived and updating docs (#292)

docs/reference/radio/on-data-packet-received.md

@@ -5,12 +5,23 @@ Run part of a program when the micro:bit receives a
 
 
 ```sig
-radio.onDataPacketReceived((packet: Packet) => { });
+radio.onDataPacketReceived(({receivedNumber, receivedString, time, serial, signal}) => { });
 ```
 
+### ~hint
+
+To add or remove the parts of the packet from the block, try clicking the blue gear in the corner!
+
+### ~
+
 ### Callback Parameters
 
-* ``packet`` - the [packet](/reference/radio/packet) that was received by the radio
+* ``packet`` - the [packet](/reference/radio/packet) that was received by the radio. The packet has the following properties:
+  * `receivedNumber` - The [number](/reference/types/number) that was sent in this packet or `0` if this packet did not contain a number. See [send number](/reference/radio/send-number) and [send value](/reference/radio/send-value)
+  * `receivedString` - The [string](/reference/types/string) that was sent in this packet or the empty string if this packet did not contain a string. See [send string](/reference/radio/send-string) and [send value](/reference/radio/send-value)
+  * `time` - The system time of the micro:bit that sent this packet at the time the packet was sent.
+  * `serial` - The serial number of the micro:bit that sent this packet or `0` if the micro:bit did not include its serial number.
+  * `signal` - How strong the radio signal is from `255` (weak) to `0` (strong).
 
 ### Example
 

docs/reference/radio/packet.md

@@ -4,8 +4,8 @@ A packet that was received by the radio.
 
 ## Properties
 
-* `receivedNumber` - The number that was sent in this packet or `0` if this packet did not contain a number. See [send number](/reference/radio/send-number) and [send value](/reference/radio/send-value)
-* `text` - The string that was sent in this packet or the empty string if this packet did not contain a string. See [send string](/reference/radio/send-string) and [send value](/reference/radio/send-value)
+* `receivedNumber` - The [number](/reference/types/number) that was sent in this packet or `0` if this packet did not contain a number. See [send number](/reference/radio/send-number) and [send value](/reference/radio/send-value)
+* `receivedString` - The [string](/reference/types/string) that was sent in this packet or the empty string if this packet did not contain a string. See [send string](/reference/radio/send-string) and [send value](/reference/radio/send-value)
 * `time` - The system time of the micro:bit that sent this packet at the time the packet was sent.
 * `serial` - The serial number of the micro:bit that sent this packet or `0` if the micro:bit did not include its serial number.
 * `signal` - How strong the radio signal is from `255` (weak) to `0` (strong).

docs/reference/radio/send-string.md

@@ -24,8 +24,8 @@ input.onButtonPressed(Button.A, () => {
     basic.showString("SENT");
 })
 
-radio.onDataPacketReceived(({ text }) => {
-    basic.showString(text);
+radio.onDataPacketReceived(({ receivedString }) => {
+    basic.showString(receivedString);
 });
 ```
 

docs/reference/radio/send-value.md

@@ -22,7 +22,7 @@ or model rocket.
 ```blocks
 radio.setGroup(99)
 input.onButtonPressed(Button.A, () => {
-    radio.sendValue("acc",input.acceleration(Dimension.X))
+    radio.sendValue("acc", input.acceleration(Dimension.X))
 })
 ```
 
@@ -31,8 +31,8 @@ Then it shows them on the LED screen.
 
 ```blocks
 radio.setGroup(99)
-radio.onDataPacketReceived(({ text, receivedNumber }) => {
-	basic.showString(text);
+radio.onDataPacketReceived(({ receivedString, receivedNumber }) => {
+	basic.showString(receivedString);
     basic.showNumber(receivedNumber);
 });
 ```

libs/radio/radio.ts

@@ -13,7 +13,7 @@ namespace radio {
          * The string payload if a string was sent in this packet (via ``sendString()`` or ``sendValue()``)
          * or the empty string if this packet did not contain a string.
          */
-        public text: string;
+        public receivedString: string;
         /**
          * The system time of the sender of the packet at the time the packet was sent.
          */
@@ -35,7 +35,7 @@ namespace radio {
     //% help=radio/on-data-packet-received
     //% mutate=true
     //% mutateText=Packet
-    //% mutateDefaults="receivedNumber;text,receivedNumber;text"
+    //% mutateDefaults="receivedNumber;receivedString,receivedNumber;receivedString"
     //% blockId=radio_on_packet block="on radio received" blockGap=8
     export function onDataPacketReceived(cb: (packet: Packet) => void) {
         onDataReceived(() => {
@@ -44,7 +44,7 @@ namespace radio {
             packet.receivedNumber = receivedNumber();
             packet.time = receivedTime();
             packet.serial = receivedSerial();
-            packet.text = receivedString();
+            packet.receivedString = receivedString();
             packet.signal = receivedSignalStrength();
             cb(packet)
         });