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

51 lines
1.3 KiB
Markdown
Raw Normal View History

# Write Value To Serial
2016-07-28 19:56:37 +02:00
Writes the data received by ``radio`` to serial in JSON format.
2016-07-18 23:04:15 +02:00
```sig
radio.writeValueToSerial();
```
2016-07-28 19:56:37 +02:00
### ~hint
This method only works for [send number](/reference/radio/send-number)
and [send value](/reference/radio/send-value). It does not work for
[send string](/reference/radio/send-string), although you can send a
string as part of [send value](/reference/radio/send-value).
### ~
### Data received format
The format for received data printed to serial is as follows:
- [send number](/reference/radio/send-number): ```{v:ValueSent,t:MicrobitTimeAlive,s:Unused}```
- [send value](/reference/radio/send-value): ```{v:ValueSent,t:MicrobitTimeAlive,s:Unused,n:"Name"}```
2016-06-10 00:30:47 +02:00
### Simulator
2016-06-10 00:30:47 +02:00
This function only works on the micro:bit, not in browsers.
### Examples
2016-07-28 19:56:37 +02:00
When ```radio``` data is received (after pressing the ``A`` button on
the second micro:bit), this program sends temperature data to
serial.
```blocks
input.onButtonPressed(Button.A, () => {
radio.sendNumber(input.temperature());
});
radio.onDataReceived(() => {
radio.writeValueToSerial();
});
```
2016-07-28 19:56:37 +02:00
Sample output to serial when ``A`` button pressed:
```{v:27,t:323,s:0}```
### See also
2016-07-28 19:56:37 +02:00
[send number](/reference/radio/send-number),
[send value](/reference/radio/send-value),
[on data received](/reference/radio/on-data-received)