flipperzero-firmware/wiki/fw/api/API:LED.md

LED state describes by struct:

typedef struct {
    uint8_t red;
    uint8_t green;
    uint8_t blue; 
} Rgb;

LED API provided by struct:

typedef struct {
    LayeredReducer* source; /// every app add its layer to set value, LayeredReducer<Rgb*>
    Subscriber* updates; /// LED value changes Supscriber<Rgb*>
    ValueMutex* state; /// LED state, ValueMutex<Rgb*>
} LedApi;

You can get API instance by calling open_led:

/// Add new layer to LED:
inline LedApi* open_led(const char* name) {
    return (LedApi*)furi_open(name);
}

Default system led is /dev/led.

Then add new layer to control LED by calling add_led_layer:

inline ValueManager* add_led_layer(Rgb* layer, uint8_t priority) {
    ValueManager* manager = register_valuemanager((void*)layer);
    if(manager == NULL) return NULL;

    if(!add_layered_reducer(manager, priority, layer_compose_default)) {
        unregister_valuemanager(manager);
        return NULL;
    }

    return manager;
}

For change led you can get display instance pointer by calling take_led, do something and commit your changes by calling commit_led. Or you can call write_led:

/// return pointer in case off success, NULL otherwise
inline Rgb* take_led(ValueManager* led, uint32_t timeout) {
    return (Rgb*)take_mutex(led->value, timeout);
}

inline void commit_led(ValueManager* led, Rgb* value) {
    commit_valuemanager(led, value);
}

/// return true if success, false otherwise
inline bool write_led(ValueManager* led, Rgb* value, uint32_t timeout) {
    return write_valuemanager(state, (void*)value, sizeof(Rgb), timeout);
}

To read current led state you should use read_led function:

/// return true if success, false otherwise
inline bool read_led(ValueManager* led, Rgb* value, uint32_t timeout) {
    return read_mutex(led->value, (void*)value, sizeof(Rgb), timeout);
}

Also you can subscribe to led state changes:

Use subscribe_led_changes to register your callback:

/// return true if success, false otherwise
inline bool subscribe_led_changes(Subscriber* updates, void(*cb)(Rgb*, void*), void* ctx) {
    return subscribe_pubsub(events, void(*)(void*, void*)(cb), ctx);
}

Usage example

void handle_led_state(Rgb* rgb, void* _ctx) {
    printf("led: #%02X%02X%02X\n", rgb->red, rgb->green, rgb->blue);
}

void led_example(void* p) {
    LedApi* led_api = open_display("/dev/led");
    if(led_api == NULL) return; // led not available, critical error

    // subscribe to led state updates
    subscribe_led_changes(led_api->updates, handle_led_state, NULL);

    Rgb current_state;
    if(read_led(led_api->state, &current_state, OsWaitForever)) {
        printf(
            "initial led: #%02X%02X%02X\n",
            current_state->red,
            current_state->green,
            current_state->blue
        );
    }

    // add layer to control led
    ValueManager* led_manager = add_led_layer(&current_state, UI_LAYER_APP);

    // write only blue by getting pointer
    Rgb* rgb = take_led(led_manager, OsWaitForever);
    if(rgb != NULL) {
        rgb->blue = 0;
    }
    commit_led(led_manager, rgb);

    // write RGB value
    write_led(led_manager, &(Rgb{.red = 0xFA, green = 0xCE, .blue = 0x8D}), OsWaitForever);
}