#pragma once #include #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: {: {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);