Profiles seed presets, a default zone and a palette, and clone with their own copies; deleting a profile removes what it owned. Zones get the v1 list shape, set-current, current, clone and content-fragment. Devices are keyed by MAC with v1 validation and identify. Patterns: definitions, OTA file and manifest, upload, driver, and send over ESP-NOW (the led-driver pattern sources are embedded in the firmware). Pixel outputs get v1 validation and a DDP/Art-Net/sACN test pattern. Sequences, palettes and settings follow v1 replies and validation, and /ws forwards browser messages to the drivers. The resource handlers move out of api.c into res_*.c, patterns.c and outputs.c. cJSON now allocates from PSRAM: the store had grown enough to starve internal RAM and abort the mic at boot. /status reports free_internal. The Wi-Fi AP and led-tool routes are left out. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
35 lines
1.4 KiB
C
35 lines
1.4 KiB
C
#pragma once
|
|
|
|
#include <stdbool.h>
|
|
#include "cJSON.h"
|
|
#include "esp_err.h"
|
|
|
|
// Zone play/stop, preset push/send and the sequencer. Drivers run the patterns
|
|
// themselves; this builds preset + select frames and hands them to ESP-NOW.
|
|
|
|
// Start the sequencer task; sequences marked active resume after a short delay
|
|
esp_err_t engine_init(void);
|
|
|
|
// Select a preset on every driver named in the zone (broadcast, sent twice)
|
|
esp_err_t engine_play(const char *zone_id, const char *preset_id);
|
|
// Turn the zone's drivers off and stop its sequence
|
|
esp_err_t engine_stop(const char *zone_id);
|
|
|
|
// POST /presets/push: v1 messages for targets (MAC strings), or broadcast when targets is NULL
|
|
esp_err_t engine_push(const cJSON *messages, const cJSON *targets);
|
|
// POST /presets/send: presets from the current profile by id
|
|
esp_err_t engine_send_presets(const cJSON *ids, bool save, const char *def, const cJSON *targets, int *sent);
|
|
|
|
esp_err_t engine_seq_play(const char *seq_id);
|
|
esp_err_t engine_seq_stop(const char *seq_id);
|
|
esp_err_t engine_scene_play(const char *scene_id);
|
|
esp_err_t engine_scene_stop(const char *scene_id);
|
|
|
|
// Caller owns the result
|
|
cJSON *engine_status(void);
|
|
// Running sequences: {<seq id>: {sequence_id, zone_id, step_index, pass, preset_id, running}}; caller owns it
|
|
cJSON *engine_seq_status(void);
|
|
|
|
// Zones or devices changed: re-send group membership to every registered ESP-NOW driver
|
|
void engine_groups_changed(void);
|