User manual LEXICON MC-8 V2.0 SERIAL PROTOCOL DEFINITION REV 1-7

[. . . ] MC-8/MC-8B Serial Protocol Definition Software Version 2. 0 Protocol Version: Major Rev 1 Minor Rev 7 NOTE: The Parameter ID list in the rear pages of this document identifies specific commands to the version 2. 00 software. However, the descriptions and information in the rest of the document apply to all versions of the software currently released. Lexicon MC-8 Serial Communications Protocol "Lexicon" and the Lexicon logo are registered trademarks of Harman International Industries. This document should not be construed as a commitment on the part of Harman International Industries, Inc. assumes no responsibility for errors that may appear within this document. [. . . ] If the data value is invalid the MC-8 will respond with a DC_INVALID_DATA error NAK. 6. 3. 10 Send Display String Command This command allows the Host to send a 40 character string to the MC-8 for display on the OSD and Front Panel Display. 6. 3. 10. 1 Packet Description Application Header: Command Data Count Application Data: Data[0] Data[1]-Data[DataCount-1] 6. 3. 10. 2 Data Description Display Command Flags: Word 0 0 0 0 0 0 0 0 Bit 0 1 2 3 4 5 6 7 Definition FPD only: If set TRUE, the display string will only be sent to the FPD device for display. Undefined. DC_CMD_SET_DISPLAY_STR 0x33 Number of characters in the nn DisplayStr + 2 DisplayFlags DisplayStr nn ch ch ch . . . 0x00 16 Lexicon MC-8 Serial Communications Protocol Display String: Data Type: Max Length: Null (0x00) terminated ASCII character string. 40 Characters. 6. 3. 10. 3 MC-8 Response The display string is sent to the OSD and Front Panel Display. 6. 3. 10. 4 Data Validation: If a string length exceeds the 40 character maximum the string will be truncated before displaying and the MC-8 will transmit a DC_NAK command with an error code DC_INVALID_DATA. 6. 3. 11 MC-8 Get Parameter Definition by Id Request to MC-8 for a Parameter Definition by Parameter Id. 6. 3. 11. 1 Command Packet Description Application Header: Command MC_GET_PARAM_BY_ID Data 2 Count Application Data: Data[0] ParamId(LSB) Data[1] ParamId(MSB) 6. 3. 11. 2 Data Description ParamId: Data Type: Max Value: 0x35 0x02 nn nn Unsigned 16 bit Integer Max Parameter Count as reported by the MC-8 Unit Configuration Response Packet (6. 3. 14. 2 page 22) 6. 3. 11. 3 Data Validation: If the ParamId is not a valid Id the MC-8 will respond with a NAK packet and error code DC_ INVALID_PARAM_ID. 17 Lexicon MC-8 Serial Communications Protocol 6. 3. 11. 4 Parameter Definition Response Packet The following Packet has been defined as follows for MC-8 V1. 00. Application Header: Command Data Count Application Data: Data[0] Data[1] Data[2] Data[3] Data[4] Data[5] Data[6] Data[7-27] Data[28]-Data[108] Data[108] 6. 3. 11. 5 Data Description ParamId: Data Type: Max Value: MC_SYS_PARAM_DEF_PK T 110 ParamId(LSB) ParamId(MSB) ParamType MAX Value(LSB) MAX Value(MSB) MIN Value(LSB) MIN Value(MSB) CurrentValue[0 -20] Parameter Path Read Only 0x8F 0x6E nn nn nn nn nn nn nn nn nn nn. . . 0x00 nn Unsigned 16 bit Integer Max Parameter Count as reported by the MC-8 Unit Configuration Response Packet (6. 3. 14. 2 page 22) 18 Lexicon MC-8 Serial Communications Protocol ParamType: Param Type Name PARAM_TYPE_UINT8 PARAM_TYPE_UINT16 PARAM_TYPE_CSTR8 PARAM_TYPE_CSTR13 PARAM_TYPE_UINT32 PARAM_TYPE_BOOLEAN PARAM_TYPE_INT8 PARAM_TYPE_BRANCH PARAM_TYPE_INT16 PARAM_TYPE_CSTR20 Data: The data value transmitted is dependent on the ParamType, as described above. The CurrentValue is always packed starting at the CurrentValue [0] byte in the packet. For multi-byte data, the values are packed LSB first(CurrentValue [0]) to MSB(CurrentValue [0+(num bytes-1)]). For example: Setting a given signed 16 bit parameter to a value of 300 the data array would be packed as follows: Data[0] = 0xd4 Data[1] = 0xfe Data[2 - 13] = don't care. If a parameter's current value is a signed 16 bit parameter with a value of -3 the data array would be packed as follows: Data[0] = 0xfd Data[1] = 0xff Data[2 - 13] = don't care. Max Value: This is a 16 bit value representing the maximum value for a parameter. Parameter values exceeding the maximum will be limited to the maximum. This may be a signed or unsigned value depending on the Parameter Type. Min Value: This is a 16 bit value representing the minimum value for a parameter. Parameter values exceeding the minimum will be limited to the minimum. This may be a signed or unsigned value depending on the Parameter Type. Parameter Path: This is a zero terminated ASCII character string describing the parameter's name and path in the units parameter tree structure. ParamType ID 0 1 2 3 4 5 6 7 8 9 Type Description Unsigned 8 bit integer(0 to 255) Unsigned 16 bit integer(0 to 65535) Zero terminated string of 8 ascii characters Zero terminated string of 13 ascii characters Unsigned 32 bit integer (0 to 4, 294, 967, 295 ) Boolean( 0 to 1) Signed 8 bit integer (-127 to 128) Parameter Branch Signed 16 bit integer (-32, 767 to 32, 768) Zero terminated string of 20 ascii characters Data Size (Bytes) 1 2 9 14 4 1 1 N/A 2 21 19 Lexicon MC-8 Serial Communications Protocol Read Only: Data Type: TRUE: FALSE: Boolean Parameter is read only Parameter is writeable 6. 3. 12 MC-8 Set Parameter Value by Id MC-8 Set Parameter by Id command sets the parameter value equal to the value sent in the command packet and then runs the appropriate functional changes associated with changing the given parameter. 6. 3. 12. 1 Command Packet Description Application Header: Command MC_CMD_SET_SYS_PARAM_VALUE_BY_ID Data Count 24 Application Data: Data[0] ParamId(LSB) Data[1] ParamId(MSB) Data[2] ParamType Data[3-23] Value[0 -20] 6. 3. 12. 2 Data Description ParamId: Data Type: Max Value: 0x36 0x18 nn nn nn nn nn nn. . . Unsigned 16 bit Integer Max Parameter Count as reported by the MC-8 Unit Configuration Response Packet (6. 3. 14. 2 page 22) ParamType: Param Type Name PARAM_TYPE_UINT8 PARAM_TYPE_UINT16 PARAM_TYPE_CSTR8 PARAM_TYPE_CSTR13 PARAM_TYPE_UINT32 PARAM_TYPE_BOOLEAN PARAM_TYPE_INT8 PARAM_TYPE_BRANCH PARAM_TYPE_INT16 PARAM_TYPE_CSTR20 Value: The data value transmitted is dependent on the ParamType, as described above. [. . . ] 6. 3. 28. 1 Command Packet Description Application Header: Command MC_CMD_GET_INPUT_NAME Data Count 1 Application Data: Data[0] InputId 0x47 0x01 nn 6. 3. 28. 2 Data Description InputId: Data Type: Unsigned 8 bit Integer Definition/Conversion: MC-8 Input Ids (Appendix D page 39) 6. 3. 28. 3 Data Validation: The InputId must be a valid Input number. If it is not valid, the MC-8 will respond with a NAK packet and error code DC_INVALID_INPUT. 33 Lexicon MC-8 Serial Communications Protocol 6. 3. 28. 4 Input Name Response Packet Application Header: Command MC_RESP_INPUT_NAME Number of Characters in InputName + 2 0x96 nn nn ch ch ch . . . 0x00 Data Count Application Data: Data[0] InputId Data[1]- Data[DataCount-1] InputName 6. 3. 28. 5 Data Description InputId: Data Type: Unsigned 8 bit Integer Definition/Conversion: MC-8 Input Ids (Appendix D page 39) InputName: Data Type: Max Length: Null (0x00) terminated ASCII character string. INPUT_NAME_LENGTH defined in Protocol Constants (Appendix E page 39) 6. 3. 29 MC-8 Set Input Name by Id Sets an Input Name to the transmitted value for a given input. [. . . ]