Manufactured under license from Dolby Laboratories. "Dolby," "Pro Logic," and the double-D
symbol are trademarks of Dolby Laboratories. "Surround EX" is a jointly developed technology of
THX and Dolby Laboratories, Inc., and is a trademark of Dolby. Used under authorization.
THX, Ultra and Ultra2 are trademarks of THX Ltd., which may be registered in some jurisdictions.
All rights reserved.
Manufactured under license from Lucasfilm Ltd. U.S. Patent Nos. 5,043,970; 5,189,703; and/or
5,222,059. European Patent No. 0323830. Other U.S. and foreign patents pending. Lucasfilm is
a trademark of Lucasfilm Ltd. Surround EX is a trademark of Dolby Laboratories. Used under
authorization.
"DTS," "DTS-ES," "Neo:6, " and “DTS 96/24” are trademarks of Digital Theater Systems, Inc.
"Lexicon," "LOGIC7," and the L7 logo are registered trademarks of Harman International
Industries, Inc. The information it contains is subject to change without notice. Harman
International Industries, Inc. assumes no responsibility for errors that may appear within this
document.
Lexicon, Inc.
Harman Specialty Group
3 Oak Park Drive
Bedford, MA 01730-1413 USA
Telephone: 781-280-0300
Fax: 781-280-0490
www.lexicon.com
Customer Support
Telephone: 781-280-0300
Sales Fax: 781-280-0495
Service Fax: 781-280-0499
Product Shipments
900 Middlesex Turnpike Bldg. #6
Billerica, MA 01821-5730 USA
Lexicon Part No. 070-16402 Rev 3
2
Page 3
Lexicon RV-8 Serial Communications Protocol
1 Documents
2 Definitions
2.1 Protocol Version Cross-reference
3 Abbreviations
4 General Description
5 Physical Layer
The following documents should also be used with this document to understand how this protocol
can be used with an RV8.
070-15838 User Guide, RV-8
2 Definitions
User Parameter: A user changeable variable that stores a specific value that describes an
operating condition for the RV8 system.
HOST: The device initiating or receiving the serial communication packets to/from
the RV8.
RV8: The Lexicon product receiving or transmitting the serial communication
packets to/from the HOST.
Nonvolatile FLASH: The area of memory in an RV8 that stores users adjustable parameters.
2.1 Protocol Version Cross-reference
All references to RV8 shall be valid unless specifically documented otherwise.
3 Abbreviations
SOP Start of Packet
EOP End of Packet
ACK Acknowledge
NAK No Acknowledge
FPD Front Panel Display
4 General Description
The intention of the RV8 serial port and protocol communication is for an external connected
HOST to control and obtain status from the RV8. The protocol has been designed to focus on
two specific goals. The first is HOST uploading and downloading of RV8 configuration, and
system/effect setups. The second is HOST control of basic user adjustable parameters.(i.e.
input, volume, balance…)
HOST
The RV8 uses simple notification, command, response and acknowledgment packets to have
communication transactions with a given HOST. This protocol is designed for point to point
communication between a HOST and RV8. The RV8 Protocol is a 3 layered system. The RV8
serial protocol allows for the RV8, or the HOST, to initiate a communication transaction. Most
transactions are initiated by the HOST. RV8 then responds to the HOST command with either a
response or acknowledgment packet. There are a few asynchronous notifications that RV8
Rs-232 Serial Link
Lexicon RV-8
CD VOL
5
Page 6
Lexicon RV-8 Serial Communications Protocol
initiates indicating system changes. Each transaction initiated must wait for a corresponding
response before initiating the next transmission.
The 3 protocol layers are: Physical, Data Link, and Application Layers.
Physical Layer (RS232)
Data Link Layer
Application Layer
5 Physical Layer
5.1 DB-9 RS232 Connector
RV8
COM1
Transmit Data
Receive Data
9 Pin D-Shell (female)
Note: The wiring requirements for a 9 pin to 9 pin serial connection, are a male to female straight
through cable.
Ground
2
2
3
3
5
5
9 Pin D-Shell (male)
9 Pin D-Shell (female)
Host
Receive Data
2
2
Transmit Data
3
3
Ground
5
5
9 Pin D-Shell (male)
5.2 Serial Port Driver
RV8 serial port has been setup to operate as follows:
The RV8 will detect parity, framing and data overrun errors. If any of the physical layer errors are
detected, the complete packet is corrupted and the RV8 will reset the transaction and begin to
look for a start of packet byte.
6
Page 7
Lexicon RV-8 Serial Communications Protocol
5.4 RV8 Receive Buffer
The RV8 has an internal receive buffer. The buffer is 256 Bytes and will transmit a NAK packet
with an error code of DC_ERR_BUFFER_FULL to the HOST if the buffer is full. If the buffer is
full, all data transmitted to the RV8 will be ignored. Therefore, making the currently transmitted
packet, if partially transmitted invalid.
5.5 RV8 Hardware Verification
This test verifies the RS232 ports are working by comparing the transmitted signal (at pin 2) to
the received signal (at pin 3). The RV8 transmits a known test signal just following a power up.
The RV8 monitors the serial port receivers while transmitting the test signal. If the signals are the
same, the test passes. In order to test this circuit, RS232 Wraparound plug(s) are needed and
must be installed at the female D9 connector(s) on the rear panel of the RV8 labeled “RS232”.
The wraparound plug shorts pins 2 to 3, allowing for the RV8 to receive the signal it is
transmitting. Once installed, power cycle the RV8 and verify the following message is displayed
on the FPD:
SERIAL PORT A PASSED
SERIAL PORT B PASSED
This message is displayed for about 2 seconds before entering normal operating mode. If no
messages are displayed, then both wrap tests failed.
6 Data Link Layer
The data link layer is used to define a transmission packet. The layer appends a header and tail
that encloses the transmitted application packet data. The data link header will contain the start
of packet byte and count of bytes to follow. The data link tail will contain the end of packet byte.
Data Link Header:
Byte Number Description Value
First Byte(0) Start of Packet (SOP) 0xF1
Byte(1) DLL Data Count nn
Application Header:
Byte(2) Command nn
Byte(3)
Application Data:
Byte(4) Data[0] nn
Byte(5) Data[1] nn
… Data[…] nn
Last Data Byte -1 Data[Data Count -1] nn
Data Link Tail:
Last Byte End of Packet (EOP) 0xF2
APP Data Count (number of application data bytes to
Follow) nn
6.1 Errors
If the number of DLL data bytes received is the same as the data count and an EOP has not
been received, the RV8 responds by transmitting a NAK packet with an error code
DC_ERR_INVALID_PACKET. The RV8 then continues to look for a SOP byte and will not
7
Page 8
Lexicon RV-8 Serial Communications Protocol
process the erroneous application packet. The HOST can use this as an indicator to retransmit
the corrupted packet.
In addition, each byte of a packet must be received sequentially and within the
INTER_PACKET_TIME. If any of the bytes within a packet transmission exceeds the
INTER_PACKET_TIME, the RV8 will respond by transmitting a NAK packet with an error code
DC_ERR_INVALID_PACKET. The RV8 then continues to look for a SOP byte and will not
process the erroneous application packet. The HOST can use this as an indicator to retransmit
the corrupted packet.
7 Application Layer
7.1 RV8 Asynchronous Notification Packets
RV8 has been designed to transmit the asynchronous notification packets following these system
changes:
1. Power On
2. Entering Standby
3. Front Panel Display update
4. Parameter Value Changes.
The notification packets are defined as follows:
7.1.1 Wakeup Notification
By transmitting the Wakeup Notification, RV8 indicates the unit has just “powered on” or reset
and is ready to receive host commands. This notification is primarily for the HOST to know the
status of the RV8.
7.1.1.1 Notification Packet Description
Application Header:
Command DC_WAKEUP 0x01
Data Count 0 0x00
Application Data:
N/A
7.1.1.2 Host Response
The RV8 does not expect any response from the HOST.
7.1.2 Sleep Notification
By transmitting the Sleep Notification, RV8 indicates the unit is shutting down into a standby
mode. Because the hard power switch could be activated independently of the RV8 system
software, hard power down will not be notified. Acknowledgment of the Sleep Notification is not
required. This notification is primarily for the HOST to know the operating status of the RV8.
7.1.2.1 Notification Packet Description
8
Application Header:
Command DC_SLEEP 0x02
Data Count 0 0x00
Application Data:
N/A
Page 9
Lexicon RV-8 Serial Communications Protocol
7.1.3 Front Panel Display
RV8 will transmit the front panel display buffer following the update to the RV8 front panel
display. The RV8 front panel display is 2 X 20 ASCII character display. The HOST can enable
transmission of this notification message by sending Host Wakeup (7.3.29). To disable
transmission the HOST can send Host Sleep (7.3.30). Transmission of the display buffer is
asynchronous to other host/RV8 communication and will only transmit following the completion of
any communication exchanges in progress or pending.
Data Type: Null (0x00) terminated ASCII character string.
Max Length: DISP_LINE_LENGTH defined in Appendix G Protocol Constants.
Line2
Data Type: Null (0x00) terminated ASCII character string.
Max Length: DISP_LINE_LENGTH defined in Appendix G Protocol Constants.
The RV8 includes 8 custom characters that are defined to display increments of a display block.
(i.e. Volume Bar) The custom characters are ASCII character codes 8E - 93(hex). The codes
are used as follows:
'8E' - empty cell
'8F' - left 1 bar
'90' - left 2 bars
'91' - left 3 bars
'92' - left 4 bars
'93' - full cell
7.1.3.3 HOST Response
The RV8 does not expect any response from the HOST.
9
Page 10
Lexicon RV-8 Serial Communications Protocol
7.1.4 RV-8 Parameter Change
RV8 will transmit predetermined parameter change notifications. If a parameter value is changed
due to any user action or system action the RV8 will transmit the current value of the parameter
that is changing.
The Supported System Parameters table listed below indicates which Parameters will
automatically transmit change notifications.
Note: These notifications will be transmitted even after the command 7.3.21 Clear All Parameter
Notifications has been sent.
7.1.4.1 Notification Packet Description
Application Header:
Command DC_PARAM_CHG_MSG 0x04
Data Count 2 0x02
Application Data:
Data[0] ParamId nn
Data[1] Value nn
7.1.4.2 Data Description
ParamId:
Data Type: Unsigned 8 bit integer
Max: 255.
Value:
The Current Value for this system parameter.
Data Type: Unsigned 8 bit integer
Max: Set by the Max Value per the Parameter Definition response
Packet for the Parameter Id of this packet.
7.1.4.3 HOST Response
The RV-8 does not expect any response from the HOST.
10
Page 11
Lexicon RV-8 Serial Communications Protocol
7.1.4.4 Supported System Parameters
The following parameters will be supported by this Parameter Change Notification:
(1) Returns legacy values which do not correspond to values in current software release.
(2) VOLUME = value -80.
(3) Zone 2 Mute notification does not respond to user muting, only when system responds to
other events, such as a Listening Mode change.
7.1.5 RV8 Parameter Notification by Id
RV-8 will transmit parameter change notifications if they are enabled using the command
described in 7.3.19 (MC12_Set_Parameter_Notification_By_Id). If a parameter value is changed
due to any user action or system action the RV8 will transmit the current value of the parameter
that is changing.
7.1.5.1 Command Packet Description
Application Header:
Command MC_PARAM_NOTIFICATION_BY_ID 0x05
Data Count 24 0x18
Application Data:
Data[0] ParamId(LSB) nn
Data[1] ParamId(MSB) nn
Data[2] ParamType nn
nn nn
Data[3-23] Value[0 -20]
nn…
7.1.5.2 Data Description
Same as Paragraph 7.3.37.2
7.1.5.3 HOST Response
The RV-8 does not expect any response from the HOST.
11
Page 12
Lexicon RV-8 Serial Communications Protocol
7.1.5.4 Defaults
The following Parameters Notifications are enabled in the RV-8 default state:
Note: These default notifications may not return the correct values. To ensure the return
of correct values for a particular Parameter, it is best to query that Parameter explicitly
using the commands described in 7.3.18 (Get Parameter Value by Id)
See also: 7.1.4 (RV-8 Parameter Change) for additional default parameter change
notifications.
Parameter RV8 Parameter Name
Current Mode PARAM.MAIN.EFFECT
Main Zone Mute PARAM.MAIN.MUTE
Main Zone Volume PARAM.MAIN.VOLUME
Main Zone Balance PARAM.MAIN.BALANCE
Main Zone Input Selection PARAM.MAIN.INPUT
Zone 2 Input PARAM.ZONE.INPUT
Zone 2 Volume PARAM.ZONE.VOLUME
Zone 2 Balance PARAM.ZONE.BALANCE
Zone 2 Mute PARAM.ZONE.MUTE
Bass PARAM.MAIN.BASS
Treble PARAM.MAIN.TREBLE
Loudness PARAM.MAIN.LOUDNESS
Tilt PARAM.MAIN.TILT
Menu Background On/Off PARAM.OSD.BACKGND
RV-8 V2.00 Parameter ID List for the Parameter ID definitions.
See
7.2 Acknowledgment Packets
Acknowledge and No Acknowledge packets are used to communicate transmission, packet and
data validation status. Both the HOST and RV8 can transmit and receive these packets.
7.2.1 Acknowledge
7.2.1.1 Packet Description
Application Header:
Command DC_ACK 0xE0
Data Count 1 0x01
Application Data:
Data[0] Command nn
12
Page 13
Lexicon RV-8 Serial Communications Protocol
7.2.1.2 Data Description
Command:
DataType: Valid RV8 command as defined in Appendix A Command Codes.
7.2.2 No Acknowledge
7.2.2.1 Packet Description
Application Header:
Command DC_NACK 0xE1
Data Count 2 0x02
Application Data:
Data[0] Command nn
Data[1] ErrorCode nn
7.2.2.2 Data Description
Command:
DataType: Valid RV8 command as defined in Appendix A Command Codes.
ErrorCode:
DataType: Error code as defined in Appendix B Error Codes.
7.3 Host Initiated Command Packets
The RV8 serial communication protocol has been designed to respond to the following
commands as described below. Each command is transmitted to the RV8 with the identified
parameters. If the command is successfully received and processed by the RV8, the unit will
respond with the described response packet or action.
7.3.1 Reset Unit
Commands the RV8 to soft reset.
7.3.1.1 Command Packet Description
Application Header:
Command DC_CMD_RESET 0x10
Data Count 0 0x00
Application Data:
N/A
7.3.1.2 RV-8 Response
The RV-8 will perform an internal reset. After reset the RV-8 will go through a soft power-up
initialization. This includes transmitting the “Wakeup Notification Packet”. A soft reset does not
reinitialize the RV-8. Nonvolatile RAM is maintained.
7.3.2 Get Custom Name
Request to RV-8 for an effect definition. RV-8 will respond with “Custom Name Packet”.
13
Page 14
Lexicon RV-8 Serial Communications Protocol
7.3.2.1 Command Packet Description
Application Header:
Command DC_CMD_GET_CUST_NAME 0x2B
Data Count 0 0x00
Data Type: Null (0x00) terminated ASCII character string.
Max Length: CUSTOM_NAME_LENGTH defined in Appendix G Protocol Constants.
7.3.3 Get ARRAY Definition(RV8)
This command will request the array definitions for the array. Currently only
PARAM.TUNER.PRESETS is an array.
7.3.3.1 Command Packet Description
Application Header:
Command MC_CMD_GET_ARRAY_DEFS 0x49
Data Count 3 0x03
Application Data:
Data[0] ParamID(LSB) 0xnn
Data[1] ParamID(MSB) 0xnn
Data[3] Param Type 0x0A
7.3.3.2 Data Description
Application Header:
Command MC_RESP_ARRAY_DEF 0x97
Data Count 4 0x04
Application Data:
Data[0] Number Elements in Array(LSB) 0xnn
Data[1] Number Elements in Array(MSB) 0xnn
Data[2] Number Bytes/ArrayItem(LSB) 0xnn
Data[3] Number Bytes/ArrayItem(MSB) 0xnn
14
Page 15
Lexicon RV-8 Serial Communications Protocol
7.3.4 Get ARRAYITEM(RV8)
This command will request the current state of the ARRAY ITEM.
7.3.4.1 Command Packet Description
Application Header:
Command MC_CMD_GET_ARRAYITEM 0x4A
Data Count 5 0x05
Application Data:
Data[0] Param ID for Array(LSB) 0xnn
Data[1] Param ID for Array(MSB) 0xnn
Data[2] Param Type 0x0B
Data[3] Index(LSB) 0xnn
Data[4] Index(MSB) 0xnn
7.3.4.2 Array Item Response Packet
Application Header:
Command MC_RESP_ARRAYITEM 0x98
Data Count Num Bytes/ArrayItem+5 0xnn
Data[5]..Data[
NumBytes/Arr
ayItem+5] The Data 0xnn
15
Page 16
Lexicon RV-8 Serial Communications Protocol
7.3.4.3 PARAM.TUNER.PRESETS Response Example
Application Header:
Command MC_RESP_ARRAYITEM 0x98
Data Count 18 0x13
Application Data:
Data[0] ParamID(LSB) 0xA2
Data[1] ParamID(MSB) 0x06
Data[2] Data Type 0x0B
Data[3] Index(LSB) 0x01
Data[4] Index(MSB) 0x00
Data[5]…Data
{13] Preset Name
ch ch ch
… 0x00
Data[14] Radio Band 0xnn
Data[15] Preset Frequency(MSB) 0xnn
Data[16] Preset Frequency(LSB) 0xnn
Data[17] Reserved 0x01
Data[17] Reserved 0x00
7.3.4.4 Data Description
Preset Name:
Data Type: Null (0x00) terminated ASCII character string.
Max Length: 8 Characters
Radio Band:
Data Type: Boolean.
TRUE: Zone3 Outputs are active.
FALSE: Zone 3 Outputs are not active.
Preset Frequency:
Data Type: Unsigned 16 bit Integer (MSB/LSB)
Min Value: 0
Max Value: 32767
Data Conversion: AM Band = None, FM Band = Value/100
Reserved
7.3.4.5 Data Validation
If the ParamID or the Index is invalid, the RV-8 will ignore the command and transmit a DC_NAK
command with an error code DC_INVALID_DATA.
16
Page 17
Lexicon RV-8 Serial Communications Protocol
7.3.5 Set ARRAYITEM(RV8)
This command will set the array item to the value supplied by the data.
7.3.5.1 Command Packet Description
Application Header:
Command MC_CMD_SET_ARRAYITEM 0x4B
Data Count Num Bytes/ArrayItem + 5 0xnn
Application Data:
Data[0] ParamID of Array(LSB) 0xnn
Data[1] ParamID of Array(MSB) 0xnn
Data[2] ParamType 0x0B
Data[3] Index(LSB) 0xnn
Data[4] Index(MSB) 0xnn
Data[5]..Dat
a[Num
Bytes/ArrayI
tem+5] ArrayItem Data 0xnn
7.3.5.2 Data Description
Value:
Data Type:
The data can be a simple type or an aggregate of several types. It the arrayitem contains
16 bit or 32 numeric data, the protocol assumes little-endian byte ordering.
7.3.5.3 RV-8 Response
RV-8 will set the Array Item to the values sent to it from this packet and transmit a DC_ACK
command.
7.3.5.4 Data Validation
If the ParamID is invalid, the RV8 will ignore the command and transmit a DC_NAK command
with an error code DC_INVALID_DATA.
If the index command is greater than or equal to the number of ArrayItems in the array, the RV-8
will ignore the command and transmit a DC_NAK command with an error code
DC_ERR_BAD_ARRAY_INDEX.
If the number of bytes per arrayitem in the packet is different from what RV-8 expects for the
number of bytes per arrayitem, RV8 will ignore the command and transmit a DC_NAK command
with an error code DC_ERR_ARRAYITEM_SIZE_MISMATCH.
17
Page 18
Lexicon RV-8 Serial Communications Protocol
7.3.6 Set Custom Name
Sets the Custom Name that can be displayed when the unit powers up.
7.3.6.1 Packet Description
Application Header:
Command DC_CMD_SET_CUST_NAME 0x2C
Number of characters in
Data Count
Application Data:
CustomName + 2 nn
Data[0] CustomNameEnable nn
Data[1]-Data[DataCount-1] CustomName ch ch ch … 0x00
7.3.6.2 Data Description
CustomNameEnable: Enables/Disables the Custom Name Display.
DataType: Boolean
TRUE: CustomName Enabled
FALSE: CustomName Disabled
CustomName:
Data Type: Null (0x00) terminated ASCII character string.
Max Length: CUSTOM_NAME_LENGTH defined in Appendix G Protocol Constants.
7.3.6.3 RV-8 Response
If the custom name enable is TRUE then the custom name banner is display on “power on”. If
the Custom Name Enable is FALSE the custom name is not displayed. The CustomName string
is copied to Nonvolatile RAM. The RV8 will ACK when completed with this command.
7.3.6.4 Data Validation
No data validation is done on the transmitted data.
7.3.7 Host Wakeup
By transmitting the Wakeup Notification, the Host indicates it has just “powered on” or reset and
is ready to receive RV-8 Notifications or Responses. The Host is assumed to be asleep upon
power up of the RV-8. Host status is maintained during standby.
7.3.7.1 Command Packet Description
Application Header:
Command HOST_WAKEUP 0x11
Data Count 0 0x00
Application Data:
N/A
7.3.7.2 Data Description
N/A
7.3.7.3 RV-8 Response
The RV-8 will respond to this command with an ACK. The unit also returns the input name, audio
status, and mode.
18
Page 19
Lexicon RV-8 Serial Communications Protocol
7.3.8 Host Sleep
By transmitting the Sleep command, the Host indicates it has just “powered down” and will no
longer respond to RV-8 Notifications. No Acknowledgment is expected. The Host is assumed to
be asleep upon power up of the RV-8. Host status is maintained during standby.
7.3.8.1 Packet Description
Application Header:
Command HOST_SLEEP 0x12
Data Count 0 0x00
Application Data:
N/A
7.3.8.2 Data Description
N/A
7.3.9 Get Communication Configuration
This command is a request to the RV-8 for the current communications configuration for the
serial port and protocol. The RV-8 responds to this command with a Communication
Configuration Packet.
7.3.9.1 Command Packet Description
Application Header:
Command DC_CMD_GET_COM_CONFIG 0x2F
Data Count 0 0x00
Application Data:
N/A
7.3.9.2 Communication Configuration Response Packet
Application Header:
Command DC_RESP_COM_CONFIG 0x8C
Data Count 1 0x01
Application Data:
Data[0] Configuration Register 0 nn
7.3.9.3 Data Description
Data Word Bit Definition
0 0 Acknowledge Enable
0 1 Parameter Change Enable
Acknowledge Enable:
TRUE Indicates the RV-8 will transmit Acknowledge Notification’s to the Host.
FALSE Indicates the RV-8 will not transmit any positive Acknowledge
Notification messages. The RV-8 will always transmit NAK error
notification messages.
Parameter Change Enable:
TRUE Indicates the RV-8 will transmit any parameter change Notification as
specified in the Parameter Change Notification Message.
FALSE Indicates the RV-8 will not transmit parameter change Notifications.
19
Page 20
Lexicon RV-8 Serial Communications Protocol
7.3.10 Set Communication Configuration
The Set Communication Configuration Command allows the serial port user to set up the various
serial port/ protocol configuration parameters.
7.3.10.1 Command Packet Description
Application Header:
Command DC_CMD_SET_COM_CONFIG 0x30
Data Count 1 0x01
Application Data:
Data[0] Configuration Register 0 nn
7.3.10.2 Data Description
Data Word Bit Definition
0 0 Acknowledge Enable
Acknowledge Enable:
TRUE Indicates the RV-8 will transmit Acknowledge Notification’s to the Host.
FALSE Indicates the RV-8 will not transmit any positive Acknowledge
Notification messages. The RV-8 will always transmit NAK error
notification messages.
7.3.10.3 RV-8 Response
The data values transmitted will be copied over to the registers stored in nonvolatile RAM. The
RV-8 will respond with an ACK Packet.
7.3.11 Set Mute
The Set Mute Command message allows the RS-232 users to set/clear the RV-8 mute state
directly.
7.3.11.1 Command Packet Description
Application Header:
Command DC_CMD_SET_MUTE 0x31
Data Count 1 0x01
Application Data:
Data[0] Mute State nn
7.3.11.2 Data Description
MUTE State:
Value Definition Description
0 UNMUTE The user mute state is set to unmuted. The RV-8
may still be muted for other internal reasons.
1 USER MUTE The system volume decrements by the specified
user amount as set in the OUTPUT LEVELS Menu.
2 FULL MUTE The system is fully muted.
7.3.11.3 RV-8 Response
20
Page 21
Lexicon RV-8 Serial Communications Protocol
The RV-8 will set the mute state according to the value transmitted. The RV-8 may still be full
muted if other conditions require the audio path to be muted. This is only a direct access to the
user mute state.
7.3.11.4 Data Validation
The data value transmitted to the RV-8 will be verified as a valid value. If it is valid the RV-8 will
set/clear the mute and respond with an ACK Packet. If the data value is invalid the RV-8 will
respond with a DC_INVALID_DATA error NAK.
7.3.12 Send Display String Command
This command allows the Host to send a 40-character string to the RV-8 for display on the OSD
and Front Panel Display. This can be configured such that the message will display only on the
FPD, if desired.
7.3.12.1 Packet Description
Application Header:
Command DC_CMD_SET_DISPLAY_STR 0x33
Data Count Number of characters in the
nn
DisplayStr + 2
Application Data:
Data[0] DisplayFlags nn
Data[1]-Data[DataCount-1] DisplayStr ch ch ch … 0x00
7.3.12.2 Data Description
Display Command Flags:
Word Bit Definition
0 0 FPD only: If set TRUE, the display string will only be sent to the FPD device for display.
0 1 Undefined.
0 2 Undefined.
0 3 Undefined.
0 4 Undefined.
0 5 Undefined.
0 6 Undefined.
0 7 Undefined.
Display String:
Data Type: Null (0x00) terminated ASCII character string.
Max Length: 40 characters.
7.3.12.3 RV-8 Response
The display string is sent to the OSD and Front Panel Display. The RV-8 will ACK when
completed with this command.
7.3.12.4 Data Validation
If a string length exceeds the 40 character maximum the string will be truncated before
displaying and the RV-8 transmit a DC_NAK command with an error code DC_INVALID_DATA.
21
Page 22
Lexicon RV-8 Serial Communications Protocol
7.3.13 Get Parameter Definition by Id
Request to RV-8 for a Parameter Definition by Parameter Id. RV-8 will respond with “RV8
Parameter Definition Packet”.
7.3.13.1 Command Packet Description
Application Header:
Command MC_GET_PARAM_BY_ID 0x35
Data Count 2 0x02
Application Data:
Data[0] ParamId(LSB) nn
Data[1] ParamId(MSB) nn
7.3.13.2 Data Description
ParamId:
Data Type: Unsigned 16 bit Integer
Max Value: Max Parameter Count as reported by the RV-8 Unit Configuration
Response Packet in
7.3.16.2
7.3.13.3 Data Validation
If the ParamId is not a valid Id the RV-8 will respond with a NAK packet and error code DC_
INVALID_PARAM_ID.
7.3.13.4 Parameter Definition Response Packet
The following Packet has been defined as follows for RV-8 V1.00. Future releases may modify
this definition.
Application Header:
Command MC_SYS_PARAM_DEF_PKT 0x8F
Data Count 110 0x6E
Application Data:
Data[0] ParamId(LSB) nn
Data[1] ParamId(MSB) nn
Data[2] ParamType nn
Data[3] MAX Value(LSB) nn
Data[4] MAX Value(MSB) nn
Data[5] MIN Value(LSB) nn
Data[6] MIN Value(MSB) nn
Data[7-27] CurrentValue[0 -20] nn nn nn…
ch ch ch …
Data[28]-Data[108] Parameter Path
0x00
Data[108] Read Only nn
7.3.13.5 Data Description
ParamId:
Data Type: Unsigned 16 bit Integer
Max Value: Max Parameter Count as reported by the RV-8 Unit Configuration
Response Packet in
22
7.3.16.2
Page 23
Lexicon RV-8 Serial Communications Protocol
ParamType:
Param Type Name ParamTy
pe ID
PARAM_TYPE_UINT8 0 Unsigned 8 bit integer(0 to
Type Description Data Size
(Bytes)
1
255)
PARAM_TYPE_UINT16 1 Unsigned 16 bit integer(0 to
2
65535)
PARAM_TYPE_CSTR8 2 Zero terminated string of 8
9
ascii characters
PARAM_TYPE_CSTR13 3 Zero terminated string of 13
14
ascii characters
PARAM_TYPE_UINT32 4 Unsigned 32 bit integer (0 to
4
4,294,967,295 )
PARAM_TYPE_BOOLEAN 5 Boolean( 0 to 1) 1
PARAM_TYPE_INT8 6 Signed 8 bit integer
1
(-127 to 128)
PARAM_TYPE_BRANCH 7 Parameter Branch N/A
PARAM_TYPE_INT16 8 Signed 16 bit integer
2
(-32,767 to 32,768)
PARAM_TYPE_CSTR20 9 Zero terminated string of 20
21
ascii characters
PARAM_TYPE_ARRAY 10 Unsigned 16 bit number
4
representing the number of
elements in the array,
another 16 bit number
representing the number of
bytes in an ArrayItem
PARAM_TYPE_ARRAYITEM 11 Unsigned 16 ParamId,
133
Unsigned 8 bit ParamType,
Unsigned 16 ArrayItem
Index,
Unsigned 8 Databytes 0 to
128
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:
All signed values are in the 2's compliment format.
23
Page 24
Lexicon RV-8 Serial Communications Protocol
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.
Read Only:
Data Type: Boolean
TRUE: Parameter is read only
FALSE: Parameter is writeable
7.3.14 Set Parameter Value by Id
RV8 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.
7.3.14.1 Command Packet Description
Application Header:
Command MC_CMD_SET_SYS_PARAM_VALUE_BY_ID 0x36
Data Count 24 0x18
Application Data:
Data[0] ParamId(LSB) nn
Data[1] ParamId(MSB) nn
Data[2] ParamType nn
Data[3-23] Value[0 -20] nn nn nn…
7.3.14.2 Data Description
ParamId:
Data Type: Unsigned 16-bit Integer
Max Value: Max Parameter Count as reported by the RV-8 Unit Configuration
Response Packet in
7.3.16.2
ParamType:
Param Type Name Param
Type
ID
PARAM_TYPE_UINT8 0 Unsigned 8 bit integer(0 to
Type Description Data
Size
(Bytes)
1
255)
PARAM_TYPE_UINT16 1 Unsigned 16 bit integer(0 to
2
65535)
PARAM_TYPE_CSTR8 2 Zero terminated string of 8
9
ascii characters
24
Page 25
Lexicon RV-8 Serial Communications Protocol
PARAM_TYPE_CSTR13 3 Zero terminated string of 13
14
ascii characters
PARAM_TYPE_UINT32 4 Unsigned 32 bit integer (0 to
4
4,294,967,295 )
PARAM_TYPE_BOOLEAN 5 Boolean (0 to 1) 1
PARAM_TYPE_INT8 6 Signed 8 bit integer
1
(-127 to 128)
PARAM_TYPE_BRANCH 7 Parameter Branch N/A
PARAM_TYPE_INT16 8 Signed 16 bit integer
2
(-32,767 to 32,768)
PARAM_TYPE_CSTR20 9 Zero terminated string of 20
21
ascii characters
PARAM_TYPE_ARRAY
10 Unsigned 16 bit number
representing the number of
4
elements in the array, another
16 bit number representing the
number of bytes in an
ArrayItem
PARAM_TYPE_ARRAYITEM
11 Unsigned 16 ParamId,
Unsigned 8 bit ParamType,
133
Unsigned 16 ArrayItem Index,
Unsigned 8 Databytes 0 to
128
Value:
The data value transmitted is dependent on the ParamType, as described above.
The Data Value is always packed starting at the Value[0] byte in the packet. For
multi-byte data, the values are packed LSB first(Value[0]) to MSB(Value[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:
Value[0] = 0xd4
Value[1] = 0xfe
Value[2 - 13] = don't care.
All signed values are in the 2's compliment format.
7.3.14.3 Data Validation
The ParamId must be a valid Parameter. The ParamType must be valid for the given ParamId. If
either of these condition is not true the RV-8 will respond with a NAK packet and error code DC _
INVALID_PARAM_ID. The data value size cannot exceed the size of a given data type. A value
that does exceed the size of a give data type will be truncated to the appropriate size. The
ParamType transmitted must match the ParamType for the Parameter being transmitted, as per
the Parameter Definition as transmitted by the MC_SYS_PARAM_DEF_PKT . If the types do not
match The RV-8 will transmit a NAK packet with a DC_INVALID_INPUT error code. The RV-8
will transmit a NAK packet with a DC_ERR_READ_ONLY error code for read only parameters.
7.3.15 Set Parameter Value by Id, No Run
RV-8 Set Parameter by Id command sets the parameter value equal to the value sent in the
command packet and does not run the appropriate functional changes associated with changing
the given parameter.
25
Page 26
Lexicon RV-8 Serial Communications Protocol
7.3.15.1 Command Packet Description
Application Header:
Command MC_CMD_SET_SYS_PARAM_VALUE_BY_ID_NO_RUN 0x37
Data Count 24 0x18
Application Data:
Data[0] ParamId(LSB) nn
Data[1] ParamId(MSB) nn
Data[2] ParamType nn
nn nn
Data[3-23] Value[0 -20]
nn…
7.3.15.2 Data Description
Same as Paragraph 7.3.37.2
7.3.16 Get Unit Configuration
Request to RV-8 for its current unit configuration. RV-8 will respond with “Unit Configuration
Packet”. The HOST should use this information to determine if any information saved by the
HOST is current.
7.3.16.1 Command Packet Description
Application Header:
Command MC_CMD_GET_CONFIG 0x38
Data Count 0 0x00
Application Data:
N/A
26
Page 27
Lexicon RV-8 Serial Communications Protocol
7.3.16.2 RV-8 Unit Configuration Response Packet
Application Header:
Command MC_RESP_UNIT_CONFIG 0x91
Data Count 30 0x1E
Application Data:
Data[0] ProductId nn
Data[1] Software Type nn
Data[2] Software Level nn
Data[3] Software Major Revision nn
Data[4] Software Minor Revision nn
Data[5] Protocol Major Revision nn
Data[6] Protocol Minor Revision nn
Data[7] Parameter Count Low(LSB) nn
Data[8] Parameter Count High(MSB) nn
Data[9] Effect Count nn
Data[10] TimeStamp[0] ch
Data[11] TimeStamp[1] ch
Data[12] TimeStamp[2] ch
Data[13] TimeStamp[3] ch
Data[14] TimeStamp[4] ch
Data[15] TimeStamp[5] ch
Data[16] TimeStamp[6] ch
Data[17] TimeStamp[7] ch
Data[18] TimeStamp[8] ch
Data[19] TimeStamp[9] ch
Data[20] TimeStamp[10] ch
Data[21] TimeStamp[11] ch
Data[22] TimeStamp[12] ch
Data[23] TimeStamp[13] ch
Data[24] TimeStamp[14] ch
Data[25] TimeStamp[15] 0x00
Data[26] Return0 nn
Data[27] Return0 nn
Data[28] Return0 nn
Data[29] Return0 nn
7.3.16.3 Data Description
ProductId: This unsigned 8 bit value describes the product.
*Note: SW level indicates the status of the RV-8 internal application software.
Software Major Revision: An unsigned 8 bit integer value indicating the unit’s major software
version. The host should use this information to determine if new effects,
effect parameters, or system parameters have been added or removed.
Software Minor Revision: An unsigned 8 bit integer value indicating this units minor software
version. Indicates the units software operation has changed but effects,
effect parameters, or system parameters have not changed.
Protocol Major Revision: An unsigned 8 bit integer value indicating the serial
communication protocol major version. The host should use this value to
determine if new commands, notifications, or response packets have
been added or deleted from this specification.
Protocol Minor Revision: An unsigned 8 bit integer value indicating the serial communication
protocol minor version. The host should use this value to determine if
the existing commands, notifications, or response packets have changed
in this specification
Parameter Count: An unsigned 16 bit integer value indicating the maximum number of
parameters for this version of software. All Parameters are sequential
ordered with in the unit so cycling from ParamId 0 to ParamId =
Parameter Count -1 allows for the host system to learn the Parameter
definitions for all Parameters defined for a given software version. The
16 bit value is packed LSB followed by the MSB.
Total Number of Effects: An unsigned 8 bit integer value indicating the maximum number of
effects available for this version of software.
28
Page 29
Lexicon RV-8 Serial Communications Protocol
TimeStamp: Is a null terminated ASCII text string describing the build date and time of
the current software build. The Format of this text string is:
“yy/mm/dd(sp)hh:mm”
yy- is the last two digits of the year (i.e. year 2001=01, year 2002 = 02)
mm - is the month
dd- is the day
(sp) - is an ASCII space character (0x20)
hh - is the hour
mm - is the minute
SerialNumber: The Serial Number is an unsigned 32 bit integer holding the unique value
of the current unit.
7.3.17 Send IR Command
This command allows the HOST to transmit IR command key codes to the RV-8.
7.3.17.1 Command Packet Description
Application Header:
Command MC_CMD_IR 0x39
Data Count 1 0x01
Application Data:
Data[0] KeyCode nn
7.3.17.2 Data Description
KeyCode:
Data Type: Unsigned 8 bit integer.
Valid Values: Appendix D RV8 IR-Codes
7.3.17.3 RV
-8 Response
The KeyCode is processed as a valid IR code. No acknowledgment will be sent from RV-8.
7.3.17.4 Data Validation
The KeyCode data will be verified as a legal IR code. If the Code is not valid the RV-8 will not
respond.
7.3.18 Get Parameter Value by Id
Request to RV-8 for the current value of a given parameter. The RV-8 will respond with a
“Parameter Value Packet”.
7.3.18.1 Command Packet Description
Application Header:
Command MC_CMD_GET_PARAM_VALUE_BY_ID 0x3A
Data Count 2 0x02
Application Data:
Data[0] ParamId (LSB) nn
Data[1] ParamId (MSB) nn
29
Page 30
Lexicon RV-8 Serial Communications Protocol
7.3.18.2 Data Description
ParamId:
Data Type: Unsigned 16 bit integer.
Max: Max Parameter Count as reported by the RV-8 Unit
Configuration
Response Packet in 7.3.39.2
7.3.18.3 Data Validation
If ParamId exceeds the its maximum value, the RV-8 will ignore the command and
transmit a DC_NAK command with an error code DC_INVALID_PARAM_ID.
7.3.18.4 RV-8 Value String Response Packet
Application Header:
Command MC_RESP_PARAM_VALUE 0x92
Data Count 24 0x18
Application Data:
Data[0] ParamId (LSB) nn
Data[1] ParamId (MSB) nn
Data[2] ParamType nn
nn nn
Data[3-23] Value[0 -20]
nn…
7.3.18.5 Data Description
Same as Paragraph 7.3.14.2
7.3.19 Set Parameter Notification by Id
Request to RV8 to enable or disable transmission of the RV-8 parameter change notification for a
given parameter.
7.3.19.1 Command Packet Description
Application Header:
Command MC_CMD_SET_PARAM_NOTIFICATION_BY_ID 0x3B
Data Count 3 0x03
Application Data:
Data[0] ParamId (LSB) nn
Data[1] ParamId (MSB) nn
Data[2] Enable/Disable nn
7.3.19.2 Data Description
ParamId:
Data Type: Unsigned 16 bit integer.
Max: Max Parameter Count as reported by the RV-8 Unit
Configuration
Response Packet in 7.3.39.2
Enable/Disable:
Data Type: Boolean
TRUE: Enable transmission of parameter notification
FALSE: Disable transmission of parameter notification
7.3.19.3 Data Validation
30
Page 31
Lexicon RV-8 Serial Communications Protocol
If ParamId exceeds the its maximum value, the RV-8 will ignore the command and
transmit a DC_NAK command with an error code DC_INVALID_PARAM_ID.
7.3.19.4 RV-8 Response
If a parameter has been enabled for notification the RV-8 will transmit its current value
whenever it has been changed due to any user or system action. For the details of the
RV-8 notification packet, see 7.1.5 (RV8_Parameter_Notification_By_Id).
7.3.20 Parameter Get Value String by Id
Request to RV-8 for the string representation of a given value for a given parameter. The RV-8
will respond with a “Value String Response Packet”.
This command is designed to be used for numeric parameters (PARAM_TYPE_UINT8,
PARAM_TYPE_INT16 etc.), in order to determine how a particular numeric value will be
displayed as a string.
7.3.20.1 Command Packet Description
Application Header:
Command MC_CMD_PARAM_GET_VALUE_STRING_BY_ID 0x3C
Data Count 23 0x17
Application Data:
Data[0] ParamId (LSB) nn
Data[1] ParamId (MSB) nn
nn nn
Data[2] - Data[5] Value[0] - Value[5]
nn ..
7.3.20.2 Data Description
ParamId:
Data Type: Unsigned 16 bit integer.
Max: Max Parameter Count as reported by the RV-8 Unit
Configuration
Response Packet in 7.3.39.2
Value:
See ParagraphParamSetDataDescription.
7.3.20.3 Data Validation
If ParamId exceeds the its maximum value, the RV-8 will ignore the command and
transmit a DC_NAK command with an error code DC_INVALID_PARAM_ID.
7.3.20.4 RV-8 Value String Response Packet
Application Header:
Command MC_RESP_VALUE_STRING 0x93
Number of Characters in Value
Data Count
Application Data:
String + 1 nn
ch ch ch
Data[0] - Data[20] Value String
… 0x00
31
Page 32
Lexicon RV-8 Serial Communications Protocol
7.3.20.5 Data Description
Value String:
Data Type: Null (0x00) terminated ASCII string.
Max Length: 21 (20 characters plus terminating Null)
7.3.21 Clear All Parameter Notifications
Request to the RV-8 to disable all RV-8 parameter notifications.
If you use this command, and then later wish to restore parameter notifications, you must
individually enable all desired notifications.
7.3.21.1 Command Packet Description
Application Header:
Command MC_CMD_CLEAR_ALL_PARAM_NOTIFICATIONS 0x3D
Data Count 0 0x00
Application Data:
N/A
7.3.22 Get System Status
Request to RV-8 for its current system status. RV-8 will respond with “System Status Packet”.
7.3.22.1 Command Packet Description
Application Header:
Command MC_CMD_GET_SYS_STATUS 0x3E
Data Count 0 0x00
Application Data:
N/A
7.3.22.2
System Status Response Packet
Application Header:
Command MC_RESP_SYS_STATUS 0x94
Data Count 10 0x0A
Application Data:
Data[0] System Volume nn
Data[1] Current Input nn
Data[2] Current Effect Id nn
Data[3] Current Input Sample Rate nn
Data[4] Current Input Format nn
Data[5] Mute Active nn
Data[6] Effect Bypass nn
Data[7] Left/Right Balance nn
Data[8] Front/Back Balance nn
Data[9] Video Sync nn
32
Page 33
Lexicon RV-8 Serial Communications Protocol
7.3.22.3 Data Description
System Volume:
Data Type: Signed 8-bit integer (2’s compliment)
Max: +12 (0x0C) (12 dB)
Min: -80 (0xB0) (-80 dB)
Current Input:
Data Type: Unsigned 8-bit integer
Definition/Conversion: Appendix F RV-8 Input Ids
Current Effect Id:
Data Type: Boolean.
TRUE: System Mute is Active
FALSE: System is unmuted.
Effect Bypass:
Data Type: Boolean
TRUE: Effect Bypass is Active
FALSE: Effect Bypass is Inactive
Left/Right Balance:
Data Type: Signed 8-bit integer (2’s compliment)
Max: 16 (0x10) (Full Right)
Min: -16 (0xF0) (Full Left)
Front/Back Balance:
Data Type: Signed 8-bit integer (2’s compliment)
Max: 16 (0x10) (Full Front)
33
Page 34
Lexicon RV-8 Serial Communications Protocol
Min: -16 (0xF0) (Full Back)
Video Sync:
Data Type: Boolean.
TRUE: RV-8 has detected Video Sync for current video input
FALSE: RV-8 can not detect Video Sync for the current video
input
7.3.23 Get Zone 3 Status
This command is a request to RV-8 for current Zone 3 Status. RV-8 will respond with “Zone3
Status Packet”.
7.3.23.1 Command Packet Description
Application Header:
Command MC_CMD_GET_ZONE3_STATUS 0x3F
Data Count 0 0x00
Application Data:
N/A
7.3.23.2 Zone 3 Status Response Packet
Application Header:
Command MC_RESP_ZON_STATUS 0x95
Data Count 5 0x05
Application Data:
Data[0] Zone3 Volume nn
Data[1] Assigned Zone 3 Input nn
Data[2] Zone3 Mute Active nn
Data[3] Reserved 0
Data[4] Zone3 Balance nn
7.3.23.3 Data Description
Zone 3 Volume:
Data Type: Signed 8-bit integer (2’s compliment)
Max: +12 (0x0C) (12 dB)
Min: -80 dB (0xB0) (-80 dB)
Assigned Zone 3 Input:
Indicates the Zone 3 input that is currently assigned for the Zone 3 outputs.
Data Type: Unsigned 8-bit integer.
Definition/Conversion: Appendix F RV-8 Input Ids
Zone3 Mute Active:
Data Type: Boolean.
TRUE: Zone 3 Outputs are active.
FALSE: Zone 3 Outputs are not active.
Reserved
34
Page 35
Lexicon RV-8 Serial Communications Protocol
Zone 3 Balance:
Data Type: Signed 8-bit integer (2’s compliment)
Max: 16 (0x10) (Full Right)
Min: -16 (0xF0) (Full Left)
7.3.24 Set System Volume
This command is a request to the RV-8 to set the system volume with the value in this packet.
7.3.24.1 Command Packet Description
Application Header:
Command MC_CMD_SET_SYS_VOLUME 0x40
Data Count 1 0x01
Application Data:
Data[0] Value nn
7.3.24.2 Data Description
Value:
Data Type: Signed 8-bit integer (2’s compliment)
Max: +12 (0x0C) (12 dB)
Min: -80 (0xB0) (-80 dB)
7.3.24.3 RV-8 Response
The RV-8 will assign the value from the packet to the system volume.
7.3.24.4 Data Validation
If a value is passed that exceeds the maximum value of that parameter the RV-8 will ignore the
command and transmit a DC_NAK command with an error code DC_INVALID_DATA.
7.3.25 Set Main Balance
Commands RV-8 to set the system balance to the value in this packet.
7.3.25.1 Command Packet Description
Application Header:
Command DC_CMD_SET_SYS_BALANCE 0x41
Data Count 1 0x01
Application Data:
Data[0] Value nn
7.3.25.2 Data Description
Value:
Data Type: Signed 8-bit integer (2’s compliment)
Max: +16 (0x10) (Full Right)
Min: -16 (0xF0) (Full Left)
7.3.25.3 RV-8 Response
35
Page 36
Lexicon RV-8 Serial Communications Protocol
The RV-8 will assign the value from the packet to the system balance.
7.3.25.4 Data Validation
If a value is passed that exceeds the maximum value of that parameter the RV-8 will ignore the
command and transmit a DC_NAK command with an error code DC_INVALID_DATA.
7.3.26 Set Front/Back Balance
Commands RV-8 to set the front/back balance to the value in this packet.
7.3.26.1 Packet Description
Application Header:
Command MC_CMD_SET_FRONT_BACK_BALANCE 0x42
Data Count 1 0x01
Application Data:
Data[0] Value nn
7.3.26.2 Data Description
Value:
Data Type: Signed 8-bit integer (2’s compliment)
Max: +16 (0x10) (Full Front)
Min: -16 (0xF0) (Full Back)
7.3.26.3 RV8 Response
The RV-8 will assign the value from the packet to the front/back balance.
7.3.26.4 Data Validation
If a value is passed that exceeds the maximum value of that parameter the RV-8 will ignore the
command and transmit a NAK command with an error code DC_INVALID_DATA.
7.3.27 Set Active Effect by Id
This command requests the RV-8 to set the active effect to the value in this packet.
7.3.27.1 Command Packet Description
Application Header:
Command MC_CMD_SET_EFFECT 0x43
Data Count 1 0x01
Application Data:
Data[0] EffectId nn
7.3.27.2 Data Description
EffectId:
Data Type: Unsigned 8-bit integer
Definition/Conversion: Appendix J RV-8 Mode Ids
7.3.27.3 RV
-8 Response
The RV-8 will load the desired effect.
36
Page 37
Lexicon RV-8 Serial Communications Protocol
7.3.27.4 Data Validation
If a value is passed that exceeds the maximum value of that parameter the RV-8 will ignore the
command and transmit a NAK command with an error code DC_INVALID_DATA.
7.3.28 Set Zone 2 Volume
Commands RV-8 to set the Zone 2 volume with the value in this packet.
7.3.28.1 Command Packet Description
Application Header:
Command MC_CMD_SET_ZONE2_VOLUME 0x45
Data Count 1 0x01
Application Data:
Data[0] Value nn
7.3.28.2 Data Description
Value:
Data Type: Signed 8-bit integer (2’s compliment)
Max: +12 (0x0C) (12dB)
Min: -80 (0xB0) (-80 dB)
7.3.28.3 RV-8 Response
The RV-8 will assign the value from the packet to the Zone 2 volume.
7.3.28.4 Data Validation
If a value is passed that exceeds the maximum value of that parameter the RV-8 will ignore the
command and transmit a NAK command with an error code DC_INVALID_DATA.
7.3.29 Set Zone 2 Left/Right Balance
Commands RV-8 to set the Zone 2 balance to the value in this packet.
7.3.29.1 Packet Description
Application Header:
Command MC_CMD_SET_ZONE2_BALANCE 0x46
Data Count 1 0x01
Application Data:
Data[0] Value nn
37
Page 38
Lexicon RV-8 Serial Communications Protocol
7.3.29.2 Data Description
Value:
Data Type: Signed 8-bit integer (2’s compliment)
Max: +16 (0x10) (Full Right)
Min: -16 (0xF0) (Full Left)
7.3.29.3 RV-8 Response
The RV-8 will assign the value from the packet to the Zone 2 balance.
7.3.29.4 Data Validation
If a value is passed that exceeds the maximum value of that parameter the RV-8 will ignore the
command and transmit a NAK command with an error code DC_INVALID_DATA.
7.3.30 Get Input Name by Id
This command is a request to R-8 for the custom input name. RV-8 will respond with “Input Name
Packet”.
7.3.30.1 Command Packet Description
Application Header:
Command MC_CMD_GET_INPUT_NAME 0x47
Data Count 1 0x01
Application Data:
Data[0] InputId nn
7.3.30.2 Data Description
InputId:
Data Type: Unsigned 8-bit Integer
Definition/Conversion: Appendix F RV-8 Input Ids
7.3.30.3 Data Validation
The InputId must be a valid Input number. If it is not the RV-8 will respond with a NAK packet
and error code DC_INVALID_INPUT.
The following examples show the byte’s transmitted for the Send RV-8 IR Commands . They are
shown as they should be transmitted from left to right.
1.1 Send RV-8 IR Command Example
1.2 SO
P
This example shows how to transmit the IR command for “
Byte 0: Start of Packet(F1 hex)
Byte 1: Data Link Layer(DLL) Data Count(DC); for an IR command this would be 4 bytes
Byte 2: The Application Layer Command, in this case it is 39 hex indicating this is an IR
Byte 3: The Application Layer Data Count(DC); for this packet it is 1 data byte to follow.
Byte 4: The Application Command Data: This IR Command Packet is transmitting Key
Byte 5: End of Packet (F2 hex)
DLL DC CMD AppDCDATA0EOP
IR Key
Code
F1 04 39 01 28 F2
MAIN_GAME”. This example command
will select the GAME input for the Main Zone. The bytes are transmitted from left
to right and they are defined as:
to follow
command packet.
Code “
MAIN_GAME”(28 hex). To transmit other IR Key Codes the user would
replace this byte with other IR key codes as found in Appendix D RV-8 IR Codes.
47
Page 48
Lexicon RV-8 Serial Communications Protocol
1.3 RV-8 V2.00 Parameter ID List
The following table is for V2.00 reference only. These Parameter Id Values will change with
S/W and Protocol version changes. The RV-8 can always be queried for the correct Parameter
Id numbers and Parameter Definition Packets.