Difference between revisions of "Eth8x8 Control Interface"

From eMDeeWiki
Jump to navigationJump to search
Line 36: Line 36:
 
==Mixer Control Packet 8 input x 8 output==
 
==Mixer Control Packet 8 input x 8 output==
 
<ul>
 
<ul>
−
<li>Each element of the Mixer Control Packet is a 16 bit integer</li>
+
<li>Each element of the Mixer Control Packet is a 16 bit unsigned integer</li>
 
<li>The first 16 bit word of the packet represents the unique identifier and must be equal to 0x808</li>
 
<li>The first 16 bit word of the packet represents the unique identifier and must be equal to 0x808</li>
 
</ul>
 
</ul>
Line 115: Line 115:
  
 
<ul>
 
<ul>
−
<li>Each Mixer Control element is measured in tenths of decibels(dB)</li>
+
<li>Each Mixer Control element is a gain value represented by a fixed point integer in 2.14 format</li>
−
<li>The allowable range of each element is -1000 (-100.0dB) to 400 (+40dB)</li>
+
<li>For example:</li>
−
<li>To mute a channel, a value of -1000 should be set</li>
+
  <ul>
−
<li>A value of zero should be set when no attenuation or amplification is desired</li>
+
  <li>use 0x8000 to set the gain to 2.0 (+6dB)</li>
−
<li>Any value greater than zero will be considered amplification of the original signal - care must be taken when using positive values to avoid over-amplification resulting in clipping of the resultant signal</li>
+
  <li>use 0x4000 to set the gain to 1.0 (0dB)</li>
 +
  <li>use 0x2000 to set the gain to 0.5 (-6dB)</li>
 +
  <li>use 0 to mute</li>
 +
  </ul>
 +
<li>Care must be taken when using values greater than 1 to avoid over-amplification resulting in clipping of the resultant signal</li>
 
</ul>
 
</ul>

Revision as of 14:46, 7 March 2019

Data can be passed from a client to an Eth8x8 through the Eth8x8 Control Interface. Packets are sent from the client to the Eth8x8 through a TCP/IP port. The following rules apply:

  • The Eth8x8 shall listen for TCP/IP connections on IP port number 33001
  • A maximum of 3 clients can simultaneously connect to the Control Interface port
  • All elements of each packet shall be in network byte order

The following sections define the packets that can be sent to the Eth8x8


Data Request

  • Each element of the Data Request Packet is a 16 bit integer
  • The first 16 bit word of the packet represents the unique identifier and must be equal to 0x100
  • A Status Packet with the requested data will be sent back to the client in response to each Data Request


Byte Offset Element
0 0x100
2 Unique Identifier of Requested Data


Mixer Control Packet 8 input x 8 output

  • Each element of the Mixer Control Packet is a 16 bit unsigned integer
  • The first 16 bit word of the packet represents the unique identifier and must be equal to 0x808


Byte Offset Element
0 0x808
2 In 1 to Out 1
4 In 1 to Out 2
6 In 1 to Out 3
8 In 1 to Out 4
10 In 1 to Out 5
12 In 1 to Out 6
14 In 1 to Out 7
16 In 1 to Out 8
18 - 32 In 2 to Out 1
...
In 2 to Out 8
34 - 48 In 3 to Out 1
...
In 3 to Out 8
50 - 64 In 4 to Out 1
...
In 4 to Out 8
66 - 80 In 5 to Out 1
...
In 5 to Out 8
82 - 96 In 6 to Out 1
...
In 6 to Out 8
98 - 112 In 7 to Out 1
...
In 7 to Out 8
114 - 128 In 8 to Out 1
...
In 8 to Out 8


  • Each Mixer Control element is a gain value represented by a fixed point integer in 2.14 format
  • For example:
    • use 0x8000 to set the gain to 2.0 (+6dB)
    • use 0x4000 to set the gain to 1.0 (0dB)
    • use 0x2000 to set the gain to 0.5 (-6dB)
    • use 0 to mute
  • Care must be taken when using values greater than 1 to avoid over-amplification resulting in clipping of the resultant signal
Retrieved from "https://emdee.com/wiki/index.php?title=Eth8x8_Control_Interface&oldid=12922"