Lexicon, Inc.

 

DC-2/MC-1 Serial Communications Protocol

Printed on: 10/19/00

7.3.16.1 Command Packet Description

Application Header:

Command

DC_CMD_SET_EFFECT_PARAM_VALUES

0x1F

Data Count

EFFECT_COUNT[EffectId] + 1

nn

Application Data:

 

 

Data[0]

EffectId

nn

Data[1]

effect_param_value[0]

nn

Data[…]

effect_param_value[…]

nn

Data[DataCount-1]

effect_param_value[EFFECT_COUNT-1]

nn

7.3.16.2 Data Description

EffectId:

 

Data Type:

Unsigned 8 bit integer.

Max:

Set by the Effect Count in the “Unit Configuration Packet”.

effect_param_value:

 

Data Type:

Unsigned 8 bit integer array.

Max:

Dependent on the parameter definition

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

DC_CMD_SET_EFFECT_NAME

0x20

Data Count

strlen(EffectName) + 2

nn

Application Data:

 

 

Data[0]

EffectId

nn

Data[1]-Data[DataCount-1]

EffectName

ch ch ch … 0x00

7.3.17.2 Data Description

EffectId:

 

Data Type:

Unsigned 8 bit integer

Max:

Set by the Effect Count in the “Unit Configuration Packet”.

EffectName:

 

Data Type:

Null(0x00) terminated ASCII character string.

Max Length:

EFFECT_NAME_LENGTH defined in Appendix E Protocol Constants.

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:

24 of 44

Page 24
Image 24
ABC Office Set Effect Name by Effect Id, 16.3 DC-2/MC-1 Response, 17.3 DC-2/MC-1 Response, Dccmdseteffectparamvalues