LED Status Indicators¶
The onboard LED provides visual feedback on the device's status:
| Color | Meaning |
|---|---|
| Initializing on boot | |
| Connecting to Wi-Fi or in setup mode | |
| USB Mass Storage (MSC) mode active | |
| FTP mode active | |
| MQTT connected |
LED Brightness¶
You can adjust the brightness of the status LED in two ways:
-
Via Web API (Recommended):
- Send a
POSTrequest to/led/brightnesswith a plain text integer between0and255in the request body. - This setting is saved to the device's configuration and will persist across reboots.
- Send a
-
Via Firmware Build Flags:
- Open
platformio.ini: Open theplatformio.inifile in the root of the project. - Find
LED_BRIGHTNESS: Locate thebuild_flagssection and find the-D LED_BRIGHTNESSline. If it doesn't exist, you can add it. - Change the Value: Set the value to a number between
0(off) and255(maximum brightness). - Rebuild and Upload: Save the file, then rebuild and upload the firmware for the change to take effect.
- Open
Note
If the LED_BRIGHTNESS flag is not defined, the brightness will default to 13 (approximately 5%). The value set via the API will override the build flag value after the first API call.