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
POST
request to/led/brightness
with a plain text integer between0
and255
in 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.ini
file in the root of the project. - Find
LED_BRIGHTNESS
: Locate thebuild_flags
section and find the-D LED_BRIGHTNESS
line. 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.