Set Effect Name By Effect Id - Lexicon DC-2 Protocol Manual

Lexicon, Inc.
DC-2/MC-1 Serial Communications Protocol
7.3.16.1 Command Packet Description
Application Header:
Command DC_CMD_SET_EFFECT_PARAM_VALUES
Data Count EFFECT_COUNT[EffectId] + 1
Application Data:
Data[0] EffectId
Data[1] effect_param_value[0]
Data[...] effect_param_value[...]
Data[DataCount-1] effect_param_value[EFFECT_COUNT-1]
7.3.16.2 Data Description
EffectId:
Data Type:
Max:
effect_param_value:
Data Type:
Max:
7.3.16.3 DC-2/MC-1 Response
The DC-2/MC-1 will assign the values from the packet to the effect parameter values in Nonvolatile RAM.
If the effect is active the DC-2/MC-1 will reload the effect to activate all the parameter values.
7.3.16.4 Data Validation
If a value is passed that exceeds the maximum value of that parameter the DC-2/MC-1 will ignore the
command and transmit a DC_NAK command with an error code DC_ERR_INVALID_DATA.

7.3.17 Set Effect Name by Effect Id

Sets an effect name to the transmitted value for a given effect.
7.3.17.1 Command Packet Description
Application Header:
Command
Data Count
Application Data:
Data[0]
Data[1]-Data[DataCount-1]
7.3.17.2 Data Description
EffectId:
Data Type:
Max:
EffectName:
Data Type:
Max Length:
7.3.17.3 DC-2/MC-1 Response
The DC-2/MC-1 will copy the Effect Name to Nonvolatile RAM. If the effect being adjusted is active the
effect will be reloaded for the changes to be initialized.
7.3.17.4 Data Validation:
Unsigned 8 bit integer.
Set by the Effect Count in the "Unit Configuration Packet".
Unsigned 8 bit integer array.
Dependent on the parameter definition
DC_CMD_SET_EFFECT_NAME
strlen(EffectName) + 2
EffectId
EffectName
Unsigned 8 bit integer
Set by the Effect Count in the "Unit Configuration Packet".
Null(0x00) terminated ASCII character string.
EFFECT_NAME_LENGTH defined in Appendix E Protocol Constants.
Printed on: 10/19/00
0x1F
nn
nn
nn
nn
nn
0x20
nn
nn
ch ch ch ... 0x00
24 of 44