POST /devices/ping broadcasts an ESP-NOW PING_REQ, collects the drivers' PING_RSP for timeout_s and registers or renames the ones that answer. A reply also counts as the driver being heard, so group updates go to it again. POST /devices/groups sends every ESP-NOW driver its groups and reports the acks. The devices modal gets the Ping drivers and Update groups buttons from main, with per-driver ping dots. UI files are now served with Cache-Control: no-cache and the firmware build hash as ETag, so a browser picks up a new UI right after an update instead of a day later. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
38 lines
1.6 KiB
C
38 lines
1.6 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);
|
|
// POST /devices/groups: send every ESP-NOW driver its groups, including silent ones, and wait for the
|
|
// acks. Call without the store lock held.
|
|
void engine_groups_push_all(int *total, int *sent, int *failed);
|