From 126c236b14c150f205d01fc5b4a99e8714ffb19d Mon Sep 17 00:00:00 2001
From: Ron Hale-Evans <rwhe@ludism.org>
Date: Wed, 8 Jun 2016 11:21:58 -0700
Subject: [PATCH] New topic. Double-checked example.

---
 .../radio/received-signal-strength.md         | 36 +++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 docs/reference/radio/received-signal-strength.md

diff --git a/docs/reference/radio/received-signal-strength.md b/docs/reference/radio/received-signal-strength.md
new file mode 100644
index 00000000..d4d483e8
--- /dev/null
+++ b/docs/reference/radio/received-signal-strength.md
@@ -0,0 +1,36 @@
+# Received Signal Strength
+
+Find how strong the ``radio`` signal is, from `255` to `0`.
+(`255` means a weak signal and `0` means a strong one.)
+
+The micro:bit finds the signal strength by checking how strong it was
+the last time it ran the
+[receive number](/reference/radio/receive-number) function. That means
+it needs to run **receive number** first.
+
+### Returns
+
+* a [number](/reference/types/number) between `255` and `0` that means
+how strong the signal is.
+
+## Simulator
+
+This function only works on the micro:bit, not in browsers.
+
+### Example
+
+This example shows how strong the radio signal of the
+[light level sender example](/reference/input/send-number) is.
+
+```blocks
+let x = 0;
+radio.setGroup(99);
+basic.forever(() => {
+    x = radio.receiveNumber();
+    basic.showNumber(radio.receivedSignalStrength());
+});
+```
+
+### See also
+
+[receive number](/reference/radio/receive-number), [send number](/reference/radio/send-number), [on data received](/reference/radio/on-data-received)