Use Python to set the state of LEDs

The following example uses an interactive Python session to set the state of all LEDs to flashing:

At the shell prompt, use the python command with no parameters to enter an interactive Python session:

# python
Python 3.10.1 (main, Mar 30 2023, 23:47:13) [GCC 11.2.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>>

Import the led submodule:
```
>>> from digidevice import led
```
Import the Led and State objects from the led submodule:
```
>>> from digidevice.led import Led, State
```
Use led.acquire() to gain control of the all LEDs:
```
>>> led.acquire(Led.ALL)
```
Use led.set() to set the state of the LEDs:
```
>>> led.set(Led.ALL, State.FLASH_FAST)
```
(Optional) Use led.release() to release the LEDs to system control:
```
>>> led.release(Led.ALL)
```
Use Ctrl-D to exit the Python session. You can also exit the session using exit() or quit().

The use(led) function

The use(led) function can be used to acquire control of LEDs and then release them back to system control.

To create a function that acquires control of the power LED, sets it to a state of fast flashing, and then releases control when the function has completed, use the following code in a python application:

with use(Led.POWER) as pwr:
    pwr(State.FLASH_FAST)

Releasing the LEDs to system control

During a Python interactive session, or from within a Python script, you can release control of the LED from Python to system control using the led.release() method.

If the Python script or session terminates prior to releasing control to the system, the LEDs will continue to have the state that Python set to them, until the device is rebooted. See Configure scripts to run automatically for information about configuring the device so that the LED state is controlled by the Python script even after reboot.

If any system processes attempt to take control of the LED while Python is in control of it, the state information from the system process is recorded but the LED state is not updated until Python releases control of the LED. When the LED is returned to system control, the state of the LED will reflect the correct, recorded state information.

Setting the state of multi-colored LEDs.