2016-06-07 17:57:41 -04:00
|
|
|
.. currentmodule:: pyb
|
2014-11-04 13:25:20 -05:00
|
|
|
.. _pyb.LED:
|
|
|
|
|
|
2014-10-31 18:21:37 -04:00
|
|
|
class LED -- LED object
|
|
|
|
|
=======================
|
2014-10-30 21:37:19 -04:00
|
|
|
|
|
|
|
|
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``.
|
|
|
|
|
|
2016-01-29 18:06:13 -05:00
|
|
|
*Note:* Only LED(3) and LED(4) can have a smoothly varying intensity, and
|
|
|
|
|
they use timer PWM to implement it. LED(3) uses Timer(2) and LED(4) uses
|
|
|
|
|
Timer(3). These timers are only configured for PWM if the intensity of the
|
|
|
|
|
relevant LED is set to a value between 1 and 254. Otherwise the timers are
|
|
|
|
|
free for general purpose use.
|
|
|
|
|
|
2014-10-30 21:37:19 -04:00
|
|
|
.. method:: led.off()
|
|
|
|
|
|
|
|
|
|
Turn the LED off.
|
|
|
|
|
|
|
|
|
|
.. method:: led.on()
|
|
|
|
|
|
2014-12-16 06:55:46 -05:00
|
|
|
Turn the LED on, to maximum intensity.
|
2014-10-30 21:37:19 -04:00
|
|
|
|
|
|
|
|
.. method:: led.toggle()
|
|
|
|
|
|
2014-12-16 06:55:46 -05:00
|
|
|
Toggle the LED between on (maximum intensity) and off. If the LED is at
|
|
|
|
|
non-zero intensity then it is considered "on" and toggle will turn it off.
|
