Groups (registry of driver MACs, optionally scoped to a profile) become
the drivers' group membership, alongside z<zone id> for zones that still
name drivers. Zones play to their group_ids. Group and device routes for
driver config, brightness (global x groups x device x zone) and identify.
The push path takes main's message shape: select as a list, groups as a
filter (one GROUP_CMD per group, or JSON when a preset has a background),
short keys so JSON fits a frame.
Sequences follow main: lanes of {preset_id, beats} steps played to each
lane's groups, advanced by the mic's beats or a clock at
audio_simulated_bpm; a switch waits for the next beat or downbeat; sync-
phase, stop (clears the zone's drivers) and status. This replaces the
time-based per-zone sequencer and scene playback, as in main.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
37 lines
1.7 KiB
C
37 lines
1.7 KiB
C
#pragma once
|
|
|
|
#include <stdbool.h>
|
|
#include "cJSON.h"
|
|
#include "esp_err.h"
|
|
|
|
// Zone play/stop and preset push/send. Drivers run the patterns themselves; this builds preset +
|
|
// select frames and hands them to ESP-NOW. Sequences are played by seqplay.c.
|
|
|
|
// Hook driver announce and resync replies
|
|
esp_err_t engine_init(void);
|
|
|
|
#define GROUP_ID_MAX 20
|
|
#define ZONE_TARGETS_MAX 12
|
|
// Group ids a zone plays to: its group_ids, plus "z<zone id>" when it names drivers directly (zones
|
|
// from before groups). -1 when the zone does not exist. Call with the store locked.
|
|
int engine_zone_targets(const char *zone_id, char out[][GROUP_ID_MAX], int max);
|
|
// A preset ready to send: palette colours and background resolved, mode as n6. Caller owns it;
|
|
// NULL when there is no such preset. Call with the store locked.
|
|
cJSON *engine_preset_payload(const char *preset_id);
|
|
|
|
// Select a preset on every driver in the zone's groups (broadcast, sent twice)
|
|
esp_err_t engine_play(const char *zone_id, const char *preset_id);
|
|
// Turn the zone's drivers off
|
|
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);
|
|
|
|
// 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);
|