Zone Data [zones]
This request returns a
Zones Data
data structure. Use this response to determine what zones are defined
and their playbacks, join groups, and active presets.
URL:
/get.cgi?req=zones
Response:
The following variable-length structure is returned by this request:
typedef struct ZonesData {
uint16_t signature; // Signature = 'CS'
int16_t version; // Version = 0x0001 (or negative
error code)
uint8_t reserved[2]; // -
uint16_t zoneCount; // Number of zones
ZoneRecord zones[]; // Variable array of zone records
} ZonesData;
#define STACK_NAME_BUF_SIZE 16
typedef struct ZoneRecord {
char name[STACK_NAME_BUF_SIZE]; // Name of zone
uint8_t playbackIndex; // Playback index
uint8_t joinGroup; // Join group
uint16_t count; // Number of PresetID/Status
pairs
uint32_t data[]; // Array of PresetID/Status
pairs (32 pairs max)
} ZoneRecord;
The PresetID/Status pairs are included for any preset in the zone that is active. The PresetID denotes the
preset number and the Status value indicates the preset’s active state. The following table shows preset
states:
Please note that the actual number of bytes returned by this request only includes the actual number of
ZoneRecords, each of which only includes the actual number of pairs of
uint32_t
elements in the
data[]
array.
*
Interactive Technologies, Inc.
CueServer 2 User's Manual - 18.5.18
Page 327 of 429
