From 8751d2aaa1dd4bccaa194cf71641ab2fb9303293 Mon Sep 17 00:00:00 2001 From: Ron Hale-Evans Date: Fri, 8 Jul 2016 15:29:14 -0700 Subject: [PATCH] Rewrote one Serial topic; shifted some material --- docs/reference/serial/write-line.md | 3 ++- docs/reference/serial/write-number.md | 19 ++++++++++++++++--- docs/reference/serial/write-value.md | 25 ++++++++++++------------- 3 files changed, 30 insertions(+), 17 deletions(-) diff --git a/docs/reference/serial/write-line.md b/docs/reference/serial/write-line.md index d6c10912..804e1be7 100644 --- a/docs/reference/serial/write-line.md +++ b/docs/reference/serial/write-line.md @@ -11,7 +11,7 @@ serial.writeLine(""); * `line` is the [string](/reference/types/string) to write to the serial port -### Example +### Example: simple serial This program writes the word `BOFFO` to the serial port repeatedly. @@ -47,4 +47,5 @@ basic.forever(() => { ### See also [serial](/device/serial), +[serial write number](/reference/serial/write-number), [serial write value](/reference/serial/write-value) diff --git a/docs/reference/serial/write-number.md b/docs/reference/serial/write-number.md index 61ac3eee..1affa2f9 100644 --- a/docs/reference/serial/write-number.md +++ b/docs/reference/serial/write-number.md @@ -10,7 +10,7 @@ serial.writeNumber(0); * `number` is the [number](/reference/types/number) to write to the serial port -### Example +### Example: one through ten This program repeatedly writes a 10-digit number to the serial port. @@ -21,8 +21,21 @@ basic.forever(() => { }); ``` +### Example: plot bar graph does serial + +If you use the ``led.plotBarGraph`` function, it writes the number +being plotted to the serial port too. + +```blocks +basic.forever(() => { + led.plotBarGraph(input.lightLevel(), 255) + basic.pause(10000); +}) +``` + ### See also [serial](/device/serial), -[serial write value](/reference/serial/write-value), -[serial write line](/reference/serial/write-line) +[serial write line](/reference/serial/write-line), +[serial write value](/reference/serial/write-value) + diff --git a/docs/reference/serial/write-value.md b/docs/reference/serial/write-value.md index a764ae54..e9a3aaa3 100644 --- a/docs/reference/serial/write-value.md +++ b/docs/reference/serial/write-value.md @@ -1,6 +1,6 @@ # Write Value -Writes name/value pair and a new line character (`\r\n`) to [serial](/device/serial). +Write a name/value pair and a newline character (`\r\n`) to the [serial](/device/serial) port. ```sig serial.writeValue("x", 0); @@ -8,7 +8,8 @@ serial.writeValue("x", 0); ### Example: streaming data -The sample below sends the temperature and light level every 10 seconds. +Every 10 seconds, the example below sends the temperature and light level +to the serial port. ```blocks basic.forever(() => { @@ -18,19 +19,17 @@ basic.forever(() => { }) ``` -### Plot bar graph does serial! +#### ~hint -If you use the `led.plotBarGraph` function, it automatically writes the value to the serial as well. - -```blocks -basic.forever(() => { - led.plotBarGraph(input.lightLevel(), 255) - basic.pause(10000); -}) -``` +The [send value](/reference/radio/send-value) function broadcasts +string/number pairs. You can use a second micro:bit to receive them, +and then send them directly to the serial port with ``write value``. +#### ~ ### See also -[serial](/device/serial), [write line](/reference/serial/write-line) - +[serial](/device/serial), +[serial write line](/reference/serial/write-line), +[serial write number](/reference/serial/write-number), +[send value](/reference/radio/send-value)