Eth8x8 Control Interface

From eMDeeWiki
Revision as of 14:52, 16 October 2019 by Mdees (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigationJump to search

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 gain values greater than 1.0 (0dB) to avoid over-amplification resulting in clipping of the resultant signal


Mixer Control Packet 4 input x 4 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 0x404


Byte Offset Element
0 0x404
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 - 16 In 2 to Out 1
...
In 2 to Out 4
18 - 24 In 3 to Out 1
...
In 3 to Out 4
26 - 32 In 4 to Out 1
...
In 4 to Out 4


  • 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 gain values greater than 1.0 (0dB) to avoid over-amplification resulting in clipping of the resultant signal