Skip to content
πŸŽ‰ Welcome to the new documentation site! See this annoucement for more info.

LED Functionality

Rondo includes optional status LED support to give you a physical indicator of what the application is doing. This is useful when a Pi is deployed headlessly and you need to confirm it’s running without SSH-ing in.

Enabling the LED

Set led_enabled to true in config.yml:

led_enabled: true
led_pin: 23     # optional, 23 is the default

Then redeploy using the Ansible playbook so the updated config is pushed to the Pi:

ansible-playbook -i inventory deploy-rondo.yml

LED states

StateMeaning
Solidmain.py is running and waiting for a button press
BlinkingButton has been pressed; button_handler.py is currently executing the API call

The LED returns to solid once the API call completes and Rondo is back to listening.

Wiring

Connect your LED between the GPIO pin defined by led_pin and a Ground pin, with a current-limiting resistor in series (typically 220–330Ξ© for a standard 3.3V GPIO output).

If you haven’t wired your LED yet, refer back to the Hardware Setup page for the default pin locations on the RPi 3.

GPIO cleanup

When the Rondo container shuts down, the GPIO pins are cleaned up automatically so the LED turns off and the pins are released. If you notice the LED staying on after stopping the container, ensure you’re running a recent version β€” this was fixed in v2.1.0.

Last updated on