RAM Audio DALIM Series Third Party Ethernet Control Instruction Manual
- August 29, 2024
- RAM Audio
Table of Contents
RAM Audio DALIM Series Third-Party Ethernet Control
Product Specifications
- Product Name: Third-Party Ethernet Control Manual
- Series: Pi / DENEB / DALIM
- API Version: 1.1
- Minimum Firmware Version: v3.1.13
- Document Version: v2.2
Product Usage Instructions
UDP Discovery Device Data
Description of how to retrieve UDP discovery device data.
Real-Time Values Monitor
Instructions on monitoring real-time values.
Monitoring Live Data
Steps to send a message for monitoring live data.
Select Snapshot Preset
How to select a snapshot preset and the associated steps.
Set Device Name
Instructions for setting the device name and related details.
Frequently Asked Questions
Q: What is the purpose of this document?
A: The purpose of this document is to guide third-party users in communicating with a RAM Audio amplifier via an Ethernet connection.
INTRODUCTION
The objective of this document is to be a guide to the “third-party” user when communicating with a RAM Audio amplifier via an Ethernet connection.
COMMUNICATION
TCP is the protocol used for communicating a controller device with the amplifiers on an Ethernet network. Each amplifier is assigned a unique IP address on the local network where they will be installed. All Ethernet- controllable amplifiers leave our factory configured to receive a dynamic IP through a DHCP server. If this server is not present, an auto IP will be assigned using the APIPA protocol. In any case, a manual IP can be configured. In order to be able to communicate with any of these amplifiers, it is necessary to send the data to the IP mentioned above on the TCP port 1001. In the same way, all amplifiers will respond to the preselected IP control (selected by means of a command that will be later referred to). On the other hand, the Controller must read the incoming TCP packet and extract the IP address that sends this data.
DATA TYPE
In the communication between a RAM Audio amplifier and a controller, two types of data are found: the Monitoring Parameters (with which we can obtain the value of parameters like the output tension, the temperature, etc.) and the Control Commands (with which we can modify the value of certain amplifier parameters like the output level or its power-on state). This communication is made by means of data packets, the structure of which will be explained later
Monitoring Parameters (UDP)
UDP Discovery Device Data
To obtain the device data we send a UDP frame with a single data value 0x58 (‘X’) to the IP: 255.255.255.255 and to port: 65535 The device will respond with an UDP frame with the following data
Byte | Code | Description |
---|---|---|
0 | 0x41 | Control value with the character ‘A’ |
The following bytes indicate the mac address of the device
1 ..| xx| Decimal value in ASCII code of the 6 digits of the mac
For a MAC FC:0F:E7:51:36:40 you receive: 32 35 32 2e 31 35 2e 32 33 31 2e
38 31 2e 35 34 2e 36 34 (252.15.231.81.54.64)
..| 0x2f| Data separation character ‘/’
The following 4 data indicate the data receiving port of the device (1001)
..| 0x31| ‘1’
..| 0x30| ‘0’
..| 0x30| ‘0’
..| 0x31| ‘1’
..| 0x2f| Data separation character ‘/’
The next 5 bytes indicate the status of the device
..| 0x4e| ‘N’: Programing mode
..| 0x2a| ‘’: No errors
..| 0x2a| ‘’: Still to be implemented
..| xx| ‘M’ : Static Mode ‘I’: DHCP Discovered ‘*’: DHCP Discovering
‘Y’: Static Mode ‘Y’: Auto-IP Mode
| xx| ‘C’: Connected with other client ‘*’: Not connected
..| 0x2f| Data separation character ‘/’
The next bytes indicate the IP address
..| xx| Decimal value in ASCII code of the IP address
For a IP: 169.254.206.21 you receive: 31 36 39 2e 32 35 34 2e 32 30 36 2e 32
31 34
..| 0x2f| Data separation character ‘/’
The next bytes indicate the hardware model
| xx| Characters in ASCII code
For “DSPBPi” you receive: 44 53 50 42 50 69
..| 0x2f| Data separation character ‘/’
Byte| Code| Description
---|---|---
The next bytes indicate the device name
| xx| Characters in ASCII code
For “NoName” you receive: 4e 6f 4e 61 6d 65
..| 0x2f| Data separation character ‘/’
The next bytes indicate the device model
..| xx| Characters in ASCII code
For “DALIM 14Q” you receive: 44 41 4c 49 4d 20 31 34 51
..| 0x2f| Data separation character ‘/’
The next bytes indicate the brand name
..| xx| Characters in ASCII code
For “RAM Audio” you receive: 52 41 4d 20 41 75 64 69 6f
..| 0x2f| Data separation character ‘/’
Real-Time values monitor
In parameter monitoring, different data are obtained continuously from the amplifier. This monitoring can be activated or deactivated at the user’s request. This is a UDP communication.
UDP receive header (when monitor communication is activated)
Byte | Code | Description |
---|---|---|
0 | 0x49 | |
1 | 0x50 | |
2 | 0x41 | |
3 | 0x44 | |
4 | 0x01 | API Version |
5 | 0x01 | API Version |
6 | 0x00 | Message ID Size LSB (0x000000FF) |
7 | 0x00 | Message ID (0x0000FF00) » 8 |
8 | 0x00 | Message ID (0x00FF0000) » 16 |
9 | 0x00 | Message ID MSB (0xFF0000) » 24 |
10 | 0x09 | Monitor |
11 | 0x00 | |
12 | 0x73 | Params Size LSB (0x000000FF) |
13 | 0x00 | Params Size MSB (0x0000FF00) » 8 |
14 | 0x00 | |
15 | 0x00 |
Data is received in the following order
Byte | Nº Bytes | Description |
---|---|---|
16 | 1 | Device input channels |
17 | 1 | Device output channels |
Input Vumeter
18| 2| Vumeter Correction
(LSB Value: 0x00FF + MSB Value: 0xFF00)
20| 2| CH1 vumeter value
(LSB Value: 0x00FF + MSB Value: 0xFF00)
22| 2| CH2 vumeter value
(LSB Value: 0x00FF + MSB Value: 0xFF00)
24| 2| CH3 vumeter value
(LSB Value: 0x00FF + MSB Value: 0xFF00)
26| 2| CH4 vumeter value
(LSB Value: 0x00FF + MSB Value: 0xFF00)
Byte | Nº Bytes | Description |
---|
Output Vumeter
28| 2| Vumeter Correction
(LSB Value: 0x00FF + MSB Value: 0xFF00)
30| 2| CH1 vumeter before dynamics value
(LSB Value: 0x00FF + MSB Value: 0xFF00)
32| 2| CH1 vumeter after dynamics value
(LSB Value: 0x00FF + MSB Value: 0xFF00)
34| 2| CH2 vumeter before dynamics value
(LSB Value: 0x00FF + MSB Value: 0xFF00)
36| 2| CH2 vumeter after dynamics value
(LSB Value: 0x00FF + MSB Value: 0xFF00)
38| 2| CH3 vumeter before dynamics value
(LSB Value: 0x00FF + MSB Value: 0xFF00)
40| 2| CH3 vumeter after dynamics value
(LSB Value: 0x00FF + MSB Value: 0xFF00)
42| 2| CH4 vumeter before dynamics value
(LSB Value: 0x00FF + MSB Value: 0xFF00)
44| 2| CH4 vumeter after dynamics value
(LSB Value: 0x00FF + MSB Value: 0xFF00)
*Analogue Levels (only DENEB / DALIM)
46| 1| CH1 Volts sensor calibration Value
47| 2| CH1 Volts Value
(LSB Value: 0x00FF + MSB Value: 0xFF00)
49| 1| CH2 Volts sensor calibration Value
50| 2| CH2 Volts Value
(LSB Value: 0x00FF + MSB Value: 0xFF00)
52| 1| CH3 Volts sensor calibration Value
53| 2| CH3Volts Value
(LSB Value: 0x00FF + MSB Value: 0xFF00)
55| 1| CH4 Volts sensor calibration Value
Byte| Nº Bytes| Description
---|---|---
56| 2| CH4 Volts Value
(LSB Value: 0x00FF + MSB Value: 0xFF00)
58| 2| CH1 Current sensor calibration Value (LSB Value: 0x00FF + MSB Value:
0xFF00)
60| 2| CH1 Current Value
(LSB Value: 0x00FF + MSB Value: 0xFF00)
62| 2| CH2 Current sensor calibration Value (LSB Value: 0x00FF + MSB Value:
0xFF00)
64| 2| CH2 Current Value
(LSB Value: 0x00FF + MSB Value: 0xFF00)
66| 2| CH3 Current sensor calibration Value (LSB Value: 0x00FF + MSB Value:
0xFF00)
68| 2| CH3 Current Value
(LSB Value: 0x00FF + MSB Value: 0xFF00)
70| 2| CH4 Current sensor calibration Value (LSB Value: 0x00FF + MSB Value:
0xFF00)
72| 2| CH4 Current Value
(LSB Value: 0x00FF + MSB Value: 0xFF00)
Temperature
74| 1| CH1 Temperature sensor calibration Value
75| 2| CH1 Temperature Value
(LSB Value: 0x00FF + MSB Value: 0xFF00)
77| 1| CH2 Temperature sensor calibration Value
78| 2| CH2 Temperature Value
(LSB Value: 0x00FF + MSB Value: 0xFF00)
80| 1| CH3 Temperature sensor calibration Value
81| 2| CH3 Temperature Value
(LSB Value: 0x00FF + MSB Value: 0xFF00)
83| 1| CH4 Temperature sensor calibration Value
84| 2| CH4 Temperature Value
(LSB Value: 0x00FF + MSB Value: 0xFF00)
Clip (1: Enabled / 0: Disabled)
86| 1| CH1 Clip
87| 1| CH2 Clip
88| 1| CH3 Clip
89| 1| CH4 Clip
Output Level Value
90
|
4
| CH1 Output Level
(LSB Value: 0x00FF + MSB Value: 0xFF00 + Polarity + Mute)
94| 4| CH2 Output Level
(LSB Value: 0x00FF + MSB Value: 0xFF00 + Polarity + Mute)
98| 4| CH3 Output Level
(LSB Value: 0x00FF + MSB Value: 0xFF00 + Polarity + Mute)
102| 4| CH3 Output Level
(LSB Value: 0x00FF + MSB Value: 0xFF00 + Polarity + Mute)
Fault State, 1 = correct operation (only DENEB / DALIM)
106| 1| CH1 Fault State
107| 1| CH2 Fault State
Byte| Nº Bytes| Description**
---|---|---
108| 1| CH3 Fault State
109| 1| CH4 Fault State
RMS Limit Threshold
110| 2| CH1 RMS Limit Threshold
(LSB Value: 0x00FF + MSB Value: 0xFF00)
112| 2| CH2 RMS Limit Threshold
(LSB Value: 0x00FF + MSB Value: 0xFF00)
114| 2| CH3 RMS Limit Threshold
(LSB Value: 0x00FF + MSB Value: 0xFF00)
116| 2| CH4 RMS Limit Threshold
(LSB Value: 0x00FF + MSB Value: 0xFF00)
PEAK Limit Threshold
118| 2| CH1 PEAK Limit Threshold
(LSB Value: 0x00FF + MSB Value: 0xFF00)
120| 2| CH2 PEAK Limit Threshold
(LSB Value: 0x00FF + MSB Value: 0xFF00)
122| 2| CH3 PEAK Limit Threshold
(LSB Value: 0x00FF + MSB Value: 0xFF00)
124| 2| CH4 PEAK Limit Threshold
(LSB Value: 0x00FF + MSB Value: 0xFF00)
***GPI MUTE Value (only DENEB / DALIM)
126| 1| GPI MUTE Value
Priority Active
127| 1| CH1 Priority Active
128| 1| CH2 Priority Active
129| 1| CH3 Priority Active
130| 1| CH4 Priority Active
- In Pi amplifiers this value corresponds to the DSP output level after the dynamics
- Pi amps do not have this sensor. The value will always be 1
- Pi amps do not have this feature. The value will always be 0
Monitoring live data. Message to send
Header
Byte | Code | Description |
---|---|---|
0 | 0x53 | |
1 | 0x43 | |
2 | 0x4f | |
3 | 0x4c | |
4 | 0x01 | API Version |
5 | 0x01 | API Version |
6 | 0x00 | Message ID Size LSB (0x000000FF) |
--- | --- | --- |
7 | 0x00 | Message ID (0x0000FF00) » 8 |
8 | 0x00 | Message ID (0x00FF0000) » 16 |
9 | 0x00 | Message ID MSB (0xFF0000) » 24 |
10 | 0x09 | Monitor |
11 | 0x00 | |
12 | 0x0e | Params Size LSB (0x000000FF) |
13 | 0x00 | Params Size MSB (0x0000FF00) » 8 |
14 | 0x00 | |
15 | 0x00 |
Enable / Disable Monitors
This is a 13 bytes data and includes the activated monitoring selection, received Port, received IP and received MAC.
- RT Header (16 Bytes) Data (13 Bytes)
Byte | Code | Description |
---|---|---|
0 | 0x00 |
0x01
| Monitor Disabled Monitor Enabled
1| 0x03| Monitor Port (MSB: 0xFF00)
2| 0xea| Monitor Port (LSB: 0x00FF)
3| 0xa9| Monitor Target IP
4| 0xfe| Monitor Target IP
5| 0x17| Monitor Target IP
6| 0x0b| Monitor Target IP
7| 0x00| Monitor Target MAC
8| 0x01| Monitor Target MAC
9| 0x02| Monitor Target MAC
10| 0x03| Monitor Target MAC
11| 0x04| Monitor Target MAC
12| 0x05| Monitor Target MAC
13| 0x00| —
Example:
To activate receive monitors in Port:1002 in device with IP: 192.168.23.11, MAC: 00:01:02:03:04:05 53 43 4f 4c 01 01 28 00 00 00 09 00 0d 00 00 00 01 03 ea a9 fe 17 0b 00 01 02 03 04 05 00
Buzz
We send the device identification request. The amplifier display will turn on and off repeatedly. To ask the amplifier to turn the screen on and off send a udp frame with a single data value 0x42 (‘B’) to the IP device and to port: 65535
Control Commands (TCP)
The general structure of data packets
The data packets consist of a series of bytes and their length will vary according to each case. In this manual, the bytes are represented in different ways, either in hexadecimal or decimal format.
Real-Time control message header
Byte | Code | Description |
---|---|---|
0 | 0x53 | |
1 | 0x43 | |
2 | 0x4f | |
3 | 0x4c | |
4 | 0x01 | API Version |
5 | 0x01 | API Version |
6 | 0x00 | Message ID LSB (0x000000FF) |
7 | 0x00 | Message ID (0x0000FF00) » 8 |
8 | 0x00 | Message ID (0x00FF0000) » 16 |
9 | 0x00 | Message ID MSB (0xFF0000) » 24 |
10 | 0xXX | Command |
11 | 0x00 | |
12 | 0x0a | Params Size LSB (0x000000FF) |
13 | 0x00 | Params Size MSB (0x0000FF00) » 8 |
14 | 0x00 | |
15 | 0x00 |
Header data
Header
For an amplifier to identify communication as correct, the first 4 bytes of the header always have to be these ones:
Byte | Code | Description |
---|---|---|
0 | 0x53 | ‘S’ |
1 | 0x43 | ‘C’ |
2 | 0x4f | ‘O’ |
3 | 0x4c | ‘L’ |
API Version
As of October 25th 2023, the communications API is version 1.1. If this information is not correct, the amplifier will reject the communication.
Message ID
These 4 bytes indicate the number of the instruction message sent by the control software. This number is generated by the control software and it is the decision of the control software designer to use it. The amplifier, in its response, will include this number. Even if it is not used, the communication structure must be maintained respecting these 4 bytes for the identification number.
Command
Byte 10 determines the Command requested from the device. Requested commands can be the following:
Command | Hex Value |
---|---|
Real Time | 0x08 |
Monitor | 0x09 |
Set Device Name | 0x0C |
Get Library List | 0x0F |
Set Power Status * | 0x10 |
Recall Snapshot Preset | 0x20 |
Get Device Basic Info | 0x23 |
Get Third Part Info | 0xC8 |
Set power Status is not available for Pi amps
Parameter Size
These two bytes indicate the size of the instruction sent, in number of bytes. This number corresponds to the bytes sent starting with byte 16.
Real-time structure of data packets
Real-time control message header
Byte | Code | Description |
---|---|---|
0 | 0x53 | |
1 | 0x43 | |
2 | 0x4f | |
3 | 0x4c | |
4 | 0x01 | API Version |
5 | 0x01 | API Version |
6 | 0x00 | Message ID LSB (0x000000FF) |
7 | 0x00 | Message ID (0x0000FF00) » 8 |
8 | 0x00 | Message ID (0x00FF0000) » 16 |
9 | 0x00 | Message ID MSB (0xFF0000) » 24 |
10 | 0x08 | Real Time Command |
11 | 0x00 | |
12 | 0x0a | Params Size LSB (0x000000FF) |
13 | 0x00 | Params Size MSB (0x0000FF00) » 8 |
14 | 0x00 | |
15 | 0x00 |
Within the real-time instructions, in byte 16, it is determined which device value we want to change
Byte 16 Hex Value | Value to change |
---|---|
0x03 | User Eq |
0x1F | User Gain |
0x20 | User Delay |
0x21 | Amplifier Volume Level |
0x27 | User HP |
0x28 | Route Input Select |
Route Input Select
It is a 7 bytes data and includes the selection of input routing and its value
- RT Header (16 Bytes) Data (7 Bytes)
Byte | Code | Description |
---|---|---|
0 | 0x28 | Route Input Select |
1 | xx | (The same as byte 5) |
2 | 0x00 | Matrix Type (Always 0) |
3 | 0x01 | Always this value |
--- | --- | --- |
4 | 0x04 | Always this value |
5 | 0x01 |
0x02
0x03
0x04
| Route CH A Route CH B Route CH C Route CH D
6| 0x00
0x01
0x02
0x03
0x04
0x05
0x06
| Select Input 1
Select Input 2
Select Input 3
Select Input 4
Select Input 1+2
Select Input 3+4 Select Matrix
7| 0xff| Always this value
Example:
To select input 1+2 in route C, send:
53 43 4f 4c 01 01 28 00 00 00 08 00 07 00 00 00 28 03 00 01 04 03 04 ff 2.1.2.2 Source Input Select
This data is 7 bytes and includes the selection of input routing and its value
- RT Header (16 Bytes) Data (7 Bytes)
Byte | Code | Description |
---|---|---|
0 | 0x29 | Source Input Select |
1 | 0x01 |
0x02
0x03
0x04
| Channel 1
Channel 2
Channel 3
Channel 4
2| 0x00
0x01
0x02
0x03
0x04
0x05
0x06
0x07
0x08
0x09
0x10
0x11
| Primary Input Analog 1 Primary Input Analog 2 Primary Input Analog 3 Primary
Input Analog 4 Primary Input AES3 1 Primary Input AES3 2 Primary Input AES3
3 Primary Input AES3 4 Primary Input Network 1* Primary Input Network* 2
Primary Input Network 3* Primary Input Network* 4
3| 0x00
0x01
| Secondary Input is disabled Secondary Input is enable
4| xx| Thershold (value x10). Lower part of the word (0x00FF)
5| xx| Thershold (value x10). Upper part of the word (0xFF00).
6| 0x00
0x01
| Secondary Input Analog 1 Secondary Input Analog 2
| 0x02| Secondary Input Analog 3
---|---|---
0x03| Secondary Input Analog 4
0x04| Secondary Input AES3 1
0x05| Secondary Input AES3 2
0x06| Secondary Input AES3 3
0x07| Secondary Input AES3 4
0x08| Secondary Input Network 1*
0x09| Secondary Input Network* 2
0x10| Secondary Input Network 3*
0x11| Secondary Input Network* 4
- It depens of the amplifier characteristics
- Refers to any AOIP signal
Example:
To select the AES3-2 input on the primary source and the Analog-1 input on the secondary with a threshold of -35 dB’s on channel 2, send: 53 43 4f 4c 01 01 28 00 00 00 08 00 07 00 00 00 29 01 05 01 DD FF 00
User Eq
This data is 10 bytes long.
- RT Header (16 Bytes) Data (6 Bytes)
Byte | Code | Description |
---|---|---|
0 | 0x03 | User Eq |
1 | 0x01 |
0x02
0x03
0x04
| Input 1
Input 2
Input 3
Input 4
2| 0x13
0x14
0x15
0x16
0x17
0x18
| EQ Band 1
EQ Band 2
EQ Band 3
EQ Band 4
EQ Band 5
EQ Band 6
3| xx| Filter Type (See table below)*
4| xx| Frequency. Lower part of the word (0x00FF)
5| xx| Frequency. Upper part of the word (0xFF00).
6| xx| Gain (value x10). Lower part of the word (0x00FF)
7| xx| Gain (value x10). Upper part of the word (0xFF00).
8| xx| Q (value x10)
9| 0x00
0x01
| Disable Band Enable Band
10| 0x00
0x01
| Disable Main Eq Enable Main Eq
Index| Filter Type Description
---|---
0x00| Bypass
0x01| Parametric with adapted Q
0x02| Parametric with constant Q
0x03| Low-pass shelving filter 6 dB’s
0x04| High-pass shelving filter 6 dB’s
0x05| Low-pass shelving filter 12 dB’s
0x06| High-pass shelving filter 12 dB’s
0x07| Low-pass shelving filter 12 dB’s with Q
0x08| High-pass shelving filter 12 dB’s with Q
0x09| Low-pass
0x0a| High-pass
0x0b| Low-pass with Q
0x0c| High-pass with Q
0x0d| Band pass
0x0e| Remove band
0x0f| Bypass with 180º offset
0x10| Bypass with 360º offset
Example:
To put in channel 1 input gain of +12dB with normal polarity and unmuted, send: 53 43 4f 4c 01 01 01 00 00 00 08 00 0a 00 00 00 1f 01 78 00 00 01
User Input Label
This data is 10 bytes and includes the selection of input label and its value.
- RT Header (16 Bytes) Data (10 Bytes)
Byte | Code | Description |
---|---|---|
1 | 0x1A | Change Label |
0 | 0x01 |
0x02
0x03
0x04
| Input Label 1
Input Label 2
Input Label 3
Input Label 4
2| 0x06| Label Size (Always this value)
3| 0x01| Input Label (Always this value)
4..9| xx| User Input Label in ASCII code
Example:
To change the Input label to “In A” in CH 1 send: 53 43 4f 4c 01 01 28 00 00 00 08 00 07 00 00 00 1A 01 06 01 49 4E 20 41 00 00
User Output Label
This data is 10 bytes and includes the selection of output label and its value.
- RT Header (16 Bytes) Data (10 Bytes)
Byte | Code | Description |
---|---|---|
1 | 0x1A | Change Label |
0 | 0x01 |
0x02
0x03
0x04
| Output Label 1
Output Label 2
Output Label 3
Output Label 4
2| 0x06| Label Size (Always this value)
3| 0x09| Output Label (Always this value)
4..9| xx| User Input Label in ASCII code
Example:
To change the Input label to “Out 1” in CH 1 send: 53 43 4f 4c 01 01 28 00 00 00 08 00 07 00 00 00 1A 01 06 09 4F 75 74 20 41 00
User input gain
This data is 6 bytes long and includes gain, mute and polarity control.
- RT Header (16 Bytes) Data (6 Bytes)
Byte | Code | Description |
---|---|---|
0 | 0x1f | User gain |
1 | 0x01 |
0x02
0x03
0x04
| Input Way 1
Input Way 2
Input Way 3
Input Way 4
2| xx| Gain in dB. Lower part of the word (0x00FF). +12.0 to -40.0 dB
3| xx| Gain in dB. Upper part of the word (0xFF00). +12.0 to -40.0 dB
4| 0x00
0x01
| Normal polarity Inverted polarity
5| 0x00
0x01
| Muted Unmuted
Example:
To put in channel 1 input gain of +12dB with normal polarity and unmuted, send: 53 43 4f 4c 01 01 01 00 00 00 08 00 0a 00 00 00 1f 01 78 00 00 01
User output gain
This data is 6 bytes long and includes gain, mute and polarity control
- RT Header (16 Bytes) Data (6 Bytes)
Byte | Code | Description |
---|---|---|
0 | 0x1f | User gain |
1 | 0x10 |
0x20
0x30
0x40
| Output Way 1
Output Way 2
Output Way 3
Output Way 4
2| xx| Gain in dB. Lower part of the word (0x00FF).
+120 to -400 (Real value +12.0 to -40.0 dB)
3| xx| Gain in dB. Upper part of the word (0xFF00).
+120 to -400 (Real value +12.0 to -40.0 dB)
4| 0x00
0x01
| Normal polarity Inverted polarity
5| 0x00
0x01
| Muted Unmuted
Example:
To put in channel 1 output gain of +12dB with normal polarity and unmuted, type: 53 43 4f 4c 01 01 01 00 00 00 08 00 0a 00 00 00 1f 10 78 00 00 01
User input delay
This data is 4 bytes long. For channel 1 maximum value is 300.0 ms., for the rest 90.0 ms.
- RT Header (16 Bytes) Data (6 Bytes)
Byte | Code | Description |
---|---|---|
0 | 0x20 | User Delay |
1 | 0x01 |
0x02
0x03
0x04
| Input Way 1
Input Way 2
Input Way 3
Input Way 4
2| xx| Delay value x10. Lower part of the word (0x00FF).
3| xx| Delay value x10. Upper part of the word (0xFF00).
Example:
To put in channel 1 input delay 12.6 ms., send: 53 43 4f 4c 01 01 01 00 00 00 08 00 03 00 00 00 20 01 7E 00
User output delay
This data is 4 bytes long. The maximum value is 90.0 ms.
- RT Header (16 Bytes) Data (6 Bytes)
Byte | Code | Description |
---|---|---|
0 | 0x20 | User Delay |
1 | 0x10 |
0x20
0x30
0x40
| Output Way 1
Output Way 2
Output Way 3
Output Way 4
2| xx| Delay value x10. Lower part of the word (0x00FF).
3| xx| Delay value x10. Upper part of the word (0xFF00).
Example:
To put in channel 1 output delay 12,6 ms., send: 53 43 4f 4c 01 01 01 00 00 00 08 00 03 00 00 00 20 10 7E 00
Amplifier Volume Level
This data is 6 bytes long and includes gain, mute and polarity control.
- RT Header (16 Bytes) Data (6 Bytes)
Byte | Code | Description |
---|---|---|
0 | 0x21 | Amplifier Volume Level |
1 | 0x10 |
0x20
0x30
0x40
| Output Way 1
Output Way 2
Output Way 3
Output Way 4
2| xx| Gain in dB. Lower part of the word (0x00FF).
+120 to -400 (Real value +12.0 to -40.0 dB)
3| xx| Gain in dB. Upper part of the word (0xFF00).
+120 to -400 (Real value +12.0 to -40.0 dB)
4| 0x00
0x01
| Normal polarity Inverted polarity
5| 0x00
0x01
| Muted Unmuted
Example:
To put in channel 1 level volume gain of +12dB with normal polarity and unmuted, type: 53 43 4f 4c 01 01 01 00 00 00 08 00 0a 00 00 00 21 10 78 00 00 01
User HP Filter
This data is 8 bytes long and includes gain, filter type, frequency cut, order and active control
- RT Header (16 Bytes) Data (8 Bytes)
Byte | Code | Description |
---|---|---|
0 | 0x27 | HP user filter gain |
1 | 0x01 |
0x02
0x03
0x04
| Input Way 1
Input Way 2
Input Way 3
Input Way 4
2| 0x00| 0: High Pass
3|
0x00
0x01
0x02
| Xover Type: Butterworth Linkwitz-Riley Bessel
4| xx| Frequency Cut [20..20000] LSB (0x00FF)
5| xx| Frequency Cut [20..20000] MSB (0xFF00)»8
6| 0x00..0x08| Order
7| 0x00
0x01
| Active Disabled Active Enabled
Example:
To activate the user HP Butterworth filter on channel 1 at a cut-off frequency of 50 Hz with order 4, send: 53 43 4f 4c 01 01 01 00 00 00 08 00 0a 00 00 00 27 01 00 00 32 00 04 01
Select Snapshot Preset
Select Snapshot Preset message header
Byte | Code | Description |
---|---|---|
0 | 0x53 | |
1 | 0x43 | |
2 | 0x4f | |
3 | 0x4c | |
4 | 0x01 | API Version |
5 | 0x01 | API Version |
6 | 0x00 | Message ID LSB (0x000000FF) |
7 | 0x00 | Message ID (0x0000FF00) » 8 |
8 | 0x00 | Message ID (0x00FF0000) » 16 |
9 | 0x00 | Message ID MSB (0xFF0000) » 24 |
--- | --- | --- |
10 | 0x20 | Snapshot Recall |
11 | 0x00 | |
12 | 0x0a | Params Size LSB (0x000000FF) |
13 | 0x00 | Params Size MSB (0x0000FF00) » 8 |
14 | 0x00 | |
15 | 0x00 |
Select number of Snapshot
This data is 1 byte long and includes the number of Snapshot to select.
- Snapshot Select Header (16 Bytes) Data (1 Bytes)
Byte | Code | Description |
---|---|---|
0 | xx | Snapshot preset number (1..20) |
Example:
To select the Snapshot number 2, send: 53 43 4f 4c 01 01 00 00 00 00 20 00 01 00 00 00 02
Set Device Name
Select Snapshot Preset message header
Byte | Code | Description |
---|---|---|
0 | 0x53 | |
1 | 0x43 | |
2 | 0x4f | |
3 | 0x4c | |
4 | 0x01 | API Version |
5 | 0x01 | API Version |
6 | 0x00 | Message ID LSB (0x000000FF) |
7 | 0x00 | Message ID (0x0000FF00) » 8 |
8 | 0x00 | Message ID (0x00FF0000) » 16 |
9 | 0x00 | Message ID MSB (0xFF0000) » 24 |
10 | 0x0C | Set Device Name |
11 | 0x00 | |
12 | 0x0e | Params Size LSB (0x000000FF) |
13 | 0x00 | Params Size MSB (0x0000FF00) » 8 |
--- | --- | --- |
14 | 0x00 | |
15 | 0x00 |
Device Name
The device name has a maximum length of 14 characters. Each character corresponds to the ASCII code
- Snapshot Select Header (16 Bytes) Data (1 Bytes)
Byte | Code | Description |
---|---|---|
0..14 | xx | Device Name in ASCII code |
Example:
To change the device name to “Amp2”, send: 53 43 4f 4c 01 01 00 00 00 00 0C 00 0E 00 00 00 41 6D 70 32
Select On/Off Standby
Select Snapshot Preset message header
Byte | Code | Description |
---|---|---|
0 | 0x53 | |
1 | 0x43 | |
2 | 0x4f | |
3 | 0x4c | |
4 | 0x01 | API Version |
5 | 0x01 | API Version |
6 | 0x00 | Message ID LSB (0x000000FF) |
7 | 0x00 | Message ID (0x0000FF00) » 8 |
8 | 0x00 | Message ID (0x00FF0000) » 16 |
9 | 0x00 | Message ID MSB (0xFF0000) » 24 |
10 | 0x10 | Standby |
11 | 0x00 | |
12 | 0x01 | Params Size LSB (0x000000FF) |
13 | 0x00 | Params Size MSB (0x0000FF00) » 8 |
14 | 0x00 | |
15 | 0x00 |
Select Standby
This data is 1 byte long and includes the number of Snapshot to select.
- Snapshot Select Header (16 Bytes) Data (1 Bytes)
Byte | Code | Description |
---|---|---|
0 | 0x00 |
0x01
| Standby Enabled Standby Disabled
Example:
To put the device in Standby, send: 53 43 4f 4c 01 01 00 00 00 00 10 00 01 00 00 00 00
Get Standby Status
Select Snapshot Preset message header
Byte | Code | Description |
---|---|---|
0 | 0x53 | |
1 | 0x43 | |
2 | 0x4f | |
3 | 0x4c | |
4 | 0x01 | API Version |
5 | 0x01 | API Version |
6 | 0x00 | Message ID LSB (0x000000FF) |
7 | 0x00 | Message ID (0x0000FF00) » 8 |
8 | 0x00 | Message ID (0x00FF0000) » 16 |
9 | 0x00 | Message ID MSB (0xFF0000) » 24 |
10 | 0x11 | Get Standby Status |
11 | 0x00 | |
12 | 0x01 | Params Size LSB (0x000000FF) |
13 | 0x00 | Params Size MSB (0x0000FF00) » 8 |
14 | 0x00 | |
15 | 0x00 |
Heather received when send “Get Standby Status”
Byte | Code | Description |
---|---|---|
0 | 0x49 | |
1 | 0x50 | |
2 | 0x41 | |
3 | 0x44 | |
4 | 0x01 | API Version |
5 | 0x01 | API Version |
6 | 0x00 | Message ID LSB (0x000000FF) |
7 | 0x00 | Message ID (0x0000FF00) » 8 |
8 | 0x00 | Message ID (0x00FF0000) » 16 |
9 | 0x00 | Message ID MSB (0xFF0000) » 24 |
10 | 0x11 | Get Standby Status |
11 | 0x00 | |
12 | 0x0a | Params Size LSB (0x000000FF) |
13 | 0x00 | Params Size MSB (0x0000FF00) » 8 |
14 | 0x00 | |
15 | 0x00 |
Data Received
Byte | Code | Description |
---|---|---|
16 | 0x00 |
0x01
0x02
| Standby On
Standby Off by Amplifier / Remote control software Standby Off by GPI
Get Device Basic Info
Select Snapshot Preset message header
Byte | Code | Description |
---|---|---|
0 | 0x53 | |
1 | 0x43 | |
2 | 0x4f | |
3 | 0x4c | |
4 | 0x01 | API Version |
5 | 0x01 | API Version |
6 | 0x00 | Message ID LSB (0x000000FF) |
7 | 0x00 | Message ID (0x0000FF00) » 8 |
--- | --- | --- |
8 | 0x00 | Message ID (0x00FF0000) » 16 |
9 | 0x00 | Message ID MSB (0xFF0000) » 24 |
10 | 0x23 | Get Device Basic Info |
11 | 0x00 | |
12 | 0x01 | Params Size LSB (0x000000FF) |
13 | 0x00 | Params Size MSB (0x0000FF00) » 8 |
14 | 0x00 | |
15 | 0x00 |
Example:
To get the device basic info, send: 53 43 4f 4c 01 01 00 00 00 00 23 00 01 00 00 00 00
Header received when send “Get Device Basic Info”
Byte | Code | Description |
---|---|---|
0 | 0x49 | |
1 | 0x50 | |
2 | 0x41 | |
3 | 0x44 | |
4 | 0x01 | API Version |
5 | 0x01 | API Version |
6 | 0x00 | Message ID LSB (0x000000FF) |
7 | 0x00 | Message ID (0x0000FF00) » 8 |
8 | 0x00 | Message ID (0x00FF0000) » 16 |
9 | 0x00 | Message ID MSB (0xFF0000) » 24 |
10 | 0x23 | Get Device Basic Info |
11 | 0x00 | |
12 | 0x0a | Params Size LSB (0x000000FF) |
13 | 0x00 | Params Size MSB (0x0000FF00) » 8 |
14 | 0x00 | |
15 | 0x00 |
Data Received
Byte | Code | Description |
---|---|---|
16 | xx | Hardware type |
17 | xx | Module hardware version |
18..33 | xx | Serial Number |
34..53 | xx | Manufacturer name |
--- | --- | --- |
54..73 | xx | Model name |
74 | 0x00 |
0x01
| without AES3 with AES3
75| 0x00
0x01
| without DANTE / AES67 with DANTE / AES67
76| 0x00
0x01
| without Voltage sensor with Voltage sensor
77| 0x00
0x01
| without Impedance sensor with Impedance sensor
78| 0x00
0x01
| without temperature sensor with temperature sensor
79| 0x00
0x01
| without standby with standby
80| 0x00
0x01
| 2 channels output
4 channels output
Byte | Code | Description |
---|---|---|
81 | xx | Operation Time in hours. Lower part of the word (0x00FF). |
+120 to -400 (Real value +12.0 to -40.0 dB)
82| xx| Operation Time in hours. Upper part of the word (0xFF00).
+120 to -400 (Real value +12.0 to -40.0 dB)
83| xx| Operation Time in 15 minutes block
84| 0x00
0x01
| without GPIO with GPIO
Select Get Third Part Info
Select Get Device Data message header
Byte | Code | Description |
---|---|---|
0 | 0x53 | |
1 | 0x43 | |
2 | 0x4f | |
3 | 0x4c | |
4 | 0x01 | API Version |
5 | 0x01 | API Version |
6 | 0x00 | Message ID LSB (0x000000FF) |
7 | 0x00 | Message ID (0x0000FF00) » 8 |
8 | 0x00 | Message ID (0x00FF0000) » 16 |
9 | 0x00 | Message ID MSB (0xFF0000) » 24 |
10 | 0xC8 | Get Third Part Info |
--- | --- | --- |
11 | 0x00 | |
12 | 0x0a | Params Size LSB (0x000000FF) |
13 | 0x00 | Params Size MSB (0x0000FF00) » 8 |
14 | 0x00 | |
15 | 0x00 |
Select Data
This data is 2 bytes long and includes the selected data and the channel to get information
- Get Device Data Header (16 Bytes) Data (2 Bytes)
Byte | Code | Description |
---|---|---|
16 | 0x00 | Preset Name |
0x01 | Use Name | |
0x02 | Way Name | |
0x03 | Snapshot Name | |
0x04 | Device Name | |
0x05 | User Input Gain | |
0x06 | User Output Gain | |
0x09 | Get Volume | |
0x0A | Get Join Select | |
0x0B | Get User Eq | |
0x0C | Get User Delay | |
0x0D | Get Limit Active | |
0x0E | User Input Label | |
0x0F | User Output Label | |
0x10 | Primary, Secondary and Routing Input | |
Byte | Code | Description |
--- | --- | --- |
17 | 0x01 |
0x02
0x03
0x04
| Channel 1
Channel 2
Channel 3
Channel 4
Example:
To get the input data gain from channel 2, send: 53 43 4f 4c 01 01 00 00 00 00 C8 00 01 00 00 00 05 01
Header received when send “Get Third Part Info”
Byte | Code | Description |
---|---|---|
0 | 0x49 | |
1 | 0x50 | |
2 | 0x41 | |
3 | 0x44 | |
4 | 0x01 | API Version |
5 | 0x01 | API Version |
6 | 0x00 | Message ID LSB (0x000000FF) |
7 | 0x00 | Message ID (0x0000FF00) » 8 |
8 | 0x00 | Message ID (0x00FF0000) » 16 |
9 | 0x00 | Message ID MSB (0xFF0000) » 24 |
10 | 0xC8 | Get Third Part Info |
11 | 0x00 | |
12 | 0x0a | Params Size LSB (0x000000FF) |
13 | 0x00 | Params Size MSB (0x0000FF00) » 8 |
14 | 0x00 | |
15 | 0x00 |
*If the communications header received by the amplifier is not correct, the amplifier will return a response header with byte 11 with value 0x01
Data Received
This data is of variable length and depends on the information requested
- Received message Header (16 Bytes) Data (variable length)
Preset Name
Byte | Code | Description |
---|---|---|
16…27 | xx | Character in Hex ASCII code |
Use Name
Byte | Code | Description |
---|---|---|
16…27 | xx | Character in Hex ASCII code |
Way Name
Byte | Code | Description |
---|---|---|
16…21 | xx | Character in Hex ASCII code |
Snapshot Name
Byte | Code | Description |
---|---|---|
16…37 | xx | Character in Hex ASCII code |
Device Name
Byte | Code | Description |
---|---|---|
16…23 | xx | Character in Hex ASCII code |
User Input Gain Data
Byte | Code | Description |
---|---|---|
16 | xx | Gain in dB. Lower part of the word (0x00FF). |
+120 to -400 (Real value +12.0 to -40.0 dB)
17| xx| Gain in dB. Upper part of the word (0xFF00).
+120 to -400 (Real value +12.0 to -40.0 dB)
18| 0x00
0x01
| Normal polarity Inverted polarity
19| 0x00
0x01
| Muted Unmuted
User Output Gain Data
Byte | Code | Description |
---|---|---|
16 | xx | Gain in dB. Lower part of the word (0x00FF). |
+120 to -400 (Real value +12.0 to -40.0 dB)
17| xx| Gain in dB. Upper part of the word (0xFF00).
+120 to -400 (Real value +12.0 to -40.0 dB)
18| 0x00
0x01
| Normal polarity Inverted polarity
19| 0x00
0x01
| Muted Unmuted
Get Volume
Byte | Code | Description |
---|---|---|
16 | xx | Gain in dB. Lower part of the word (0x00FF). |
+120 to -400 (Real value +12.0 to -40.0 dB)
17| xx| Gain in dB. Upper part of the word (0xFF00).
+120 to -400 (Real value +12.0 to -40.0 dB)
18| 0x00
0x01
| Normal polarity Inverted polarity
19| 0x00
0x01
| Muted Unmuted
Get Join Select
Byte | Code | Description |
---|---|---|
16 | 0x00 |
0x01
| Disable Join Enable Join
Get User Eq
Byte | Code | Description |
---|---|---|
16 | 0x00 |
0x01
| Main Eq disable Main Eq Enable
The equalizer has 6 equalization bands that are received sequentially
starting with 1 and ending with 6.
The data follows the next order and repeats sequentially for a full channel.
..| xx| Type (see table in page 13)
..| xx| Frequency. Lower part of the word (0x00FF).
..| xx| Frequency. Upper part of the word (0xFF00).
..| xx| Gain (x10). Lower part of the word (0x00FF).
..| xx| Gain (x10). Upper part of the word (0xFF00).
..| xx| Q value (x10)
..| 0x00
0x01
| Eq Band Disable Eq Band Enable
The frame, without the header, has a total length of 43 bytes
Get User Delay
Byte | Code | Description |
---|---|---|
16 | xx | Delay (x10). Lower part of the word (0x00FF). |
17 | xx | Delay (x10). Upper part of the word (0xFF00). |
Get Limit Active
Byte | Code | Description |
---|---|---|
16 | 0x00 |
0x01
| RMS Limit Disable RMS Limit Enable
17| 0x00
0x01
| PEAK Limit Disable PEAK Limit Enable
User Input Label
Byte | Code | Description |
---|---|---|
16…21 | xx | Character in Hex ASCII code |
User Output Label
Byte | Code | Description |
---|---|---|
16…21 | xx | Character in Hex ASCII code |
Primary, Secondary and Routing Input
Byte | Code | Description |
---|---|---|
16 | 0x00..0x03 |
0x04..0x07
0x08..0x11
| Analog Primary Input 1 to 4
AES3 Primary Input 1 to 4
Dante/AES67 Primary Input 1 to 4
17| 0x00..0x03
0x04..0x07
0x08..0x11
0xFF
| Analog Secondary Input 1 to 4
AES3 Secondary Input 1 to 4
Dante/AES67 Secondary Input 1 to 4 Priority Select Disable
18| 0x00| Input 1 Select
| 0x01| Input 2 Select
---|---|---
0x02| Input 3 Select
0x03| Input 4 Select
0x04| Input 1+2 Select
0x05| Input 3+4 Select
0x06| Matrix Select
19| xx| Priority threshold in dB´s (Value x10). Lower part of the word
(0x00FF).
20| xx| Priority threshold in dB´s (Value x10). Upper part of the word
(0xFF00).
Example:
If you send input data gain from channel 2: 53 43 4f 4c 01 01 00 00 00 00 C8 00 01 00 00 00 05 01 You receive, if Gain = +7 dB, Normal polarity and Unmuted: 49 50 41 44 01 01 00 00 00 00 C8 00 04 00 00 00 46 00 01 01
Select Get Library List
Select Get Device Data message header
Byte | Code | Description |
---|---|---|
0 | 0x53 | |
1 | 0x43 | |
2 | 0x4f | |
3 | 0x4c | |
4 | 0x01 | API Version |
5 | 0x01 | API Version |
6 | 0x00 | Message ID LSB (0x000000FF) |
7 | 0x00 | Message ID (0x0000FF00) » 8 |
8 | 0x00 | Message ID (0x00FF0000) » 16 |
9 | 0x00 | Message ID MSB (0xFF0000) » 24 |
10 | 0x0F | Get Library List |
11 | 0x00 | |
12 | 0x0a | Params Size LSB (0x000000FF) |
13 | 0x00 | Params Size MSB (0x0000FF00) » 8 |
14 | 0x00 | |
15 | 0x00 |
Example:
To get the different name presets, send: 53 43 4f 4c 01 01 00 00 00 00 0F 00 01 00 00 00 00
Header received when send “Get Library List”
In a first data transmission, the received header indicates the number of data that are going to be received (Params size)
Byte | Code | Description |
---|---|---|
0 | 0x49 | |
1 | 0x50 | |
2 | 0x41 | |
3 | 0x44 | |
4 | 0x01 | API Version |
5 | 0x01 | API Version |
6 | 0x00 | Message ID LSB (0x000000FF) |
7 | 0x00 | Message ID (0x0000FF00) » 8 |
8 | 0x00 | Message ID (0x00FF0000) » 16 |
9 | 0x00 | Message ID MSB (0xFF000000) » 24 |
10 | 0x0F | Get Library List |
11 | 0x00 | |
12 | 0x0a | Params Size LSB (0x000000FF) |
13 | 0x00 | Params Size MSB (0x0000FF00) » 8 |
14 | 0x00 | |
15 | 0x00 |
In the following communications, the names of the different presets are sent.
Data Received
You will receive a frame with the following characteristics
Byte | Data | Description |
---|---|---|
16 | ‘S’ | Indicates that the name of a snapshot has to be received |
17 | xx | Number of snapshot |
18… | xx | Name of Snapshot |
.. | ‘\0’ | At the end of the text a null character will be received |
This data structure continues until all the names of the snapshots present on the amplifier are complete. When a first data with the character ‘P’ is received, it will indicate that the next name is that of an amplifier system preset. The same data reception structure will continue as for Snapshots
Byte | Data | Description |
---|---|---|
.. | ‘P’ | Indicates that the name of a snapshot is to be received |
.. | xx | Number of snapshot |
.. | xx | Name of Snapshot |
--- | --- | --- |
.. | ‘\0’ | At the end of the text a null character will be received |
If you receive the following data frame:
49 50 41 44 01 01 00 00 00 00 0F 00 04 00 00 00 53 01 44 69 72 65 63 74 20 4f 75 74 00 53 02 42 61 73 69 63 20 4d 6f 6e 6f 20 28 31 20 69 6e 20 34 29 00
You receive names of Snapshots
- “Direct Out”
- “Basic Mono (1 in 4)” If you receive the following data frame: 49 50 41 44 01 01 00 00 00 00 0F 00 04 00 00 00 53 01 44 69 72 65 63 74 20 4f 75 74 00 53 02 42 61 73 69 63 20 4d 6f 6e 6f 20 28 31 20 69 6e 20 34 29 00
You receive names of Snapshots
- “Direct Out”
- “Basic Mono (1 in 4)”
Manufactured in the EU by C.E. Studio-2 s.l. Pol. Ind. La Figuera – C/ Rosa Luxemburgo nº34 46970 Alaquas – Valencia – SPAIN Phone: +34 96 127 30 54 Fax: +34 96 127 30 56 ramaudio.com, info@ramaudio.com
References
Read User Manual Online (PDF format)
Read User Manual Online (PDF format) >>