Analog Way LIVECORE PLATFORM TPP Current Programmer's Guide - Manual (Page 12)

12
PROGRAMMER'S GUIDE FOR v02.00.46
2.6 Command indexes and Command values
As explained in chapter §LiveCore_control_principle , LiveCore™ commands allow reading or writing
values in multidimensional registers. For these, indexes values must be supplied. If a register is not
multidimensional, its reading or writing commands does not need indexes values.
Indexes values : Depending on the command, you can have to specify from 0 to 3 indexes values. They
indicate on which the command relates. For example, the “OSCREEN_MAX_LAYERS” command which gives
the number of layers in a screen, requires an index value to indicate the desired device’s screen.
No wildcard exists; all required indexes values shall be supplied. Some indexes values have names
starting with “DIM_”, meaning dimension. For example, the ”VER_UPDATER” command giving the device
firmware version, always requires a “DIM_DEVICE” index value indicating the master or slave device (used
in an additive configuration), even there is only one device (in this case, the master index value shall
always be provided).
Indexes values are detailed in the “LiveCore_TPP_commands_for_v02-00-46.xls” document.
Command value : This is the register value. In a write command, it indicates the new value that you
want to be applied. In a read answer, it indicates the current state of the command (current register
value). A write command is only distinguished from a read command due to the presence of the numerical
command value just before the command letters.
A value written in a register remains until modified by a new write command or by the device itself.
This allows options to be written only once (see preset recall filter option example).
All registers have a default value, noted in the detailed tables.
You must be careful on value range, which depends on multiple factors, like device type, device
configuration or current situation. Value range have names starting with “ENUM_”, else, if no
enumeration name exist, value must be comprise between given “min value” and “max value”.
Commands values are detailed in the “LiveCore_TPP_commands_for_v02-00-46.xls” document.
2.7 Multiple controllers
Multiple controllers are allowed, limited to 5, with TCP protocol.
No priority exist, in case of simultaneous writing of the same command, the machine applies the last
received. In all cases, controllers must take in account the last answer received.
User must particularly be careful with compound commands. For example the “Preset recalling” action
requires sending at least 3 commands (origin memory number, destination screen number and destination
preset number) before launching the recall. This can cause intermixing commands with 2 simultaneously
sending controllers.
2.8 Multiple machines (Additive configuration)
In this configuration, the controller shall only control the “master” device. This means that index value
0 shall always be supplied when a “DIM_DEVICE” index is required.