1 files changed, 36 insertions, 0 deletions
diff --git a/docs/library/pyb.LED.rst b/docs/library/pyb.LED.rst
new file mode 100644
index 0000000000..7bd98092ae
--- /dev/null
+++ b/docs/library/pyb.LED.rst
@@ -0,0 +1,36 @@
+class LED --- LED object
+========================
+
+The LED object controls an individual LED (Light Emitting Diode).
+
+
+Constructors
+------------
+
+.. class:: pyb.LED(id)
+
+   Create an LED object associated with the given LED:
+   
+     - ``id`` is the LED number, 1-4.
+
+
+Methods
+-------
+
+.. method:: led.intensity([value])
+
+   Get or set the LED intensity.  Intensity ranges between 0 (off) and 255 (full on).
+   If no argument is given, return the LED intensity.
+   If an argument is given, set the LED intensity and return ``None``.
+
+.. method:: led.off()
+
+   Turn the LED off.
+
+.. method:: led.on()
+
+   Turn the LED on.
+
+.. method:: led.toggle()
+
+   Toggle the LED between on and off.