Fairlight audio mixer

Some of the newer models of the ATEM switchers have Fairlight audio mixers in them instead of the more basic ATEM audio mixers of the previous models. These mostly use new datastructures to represent the mixer.

class pyatem.field.FairlightAudioInputField(raw)

Data from the FAIP. Describes the inputs to the fairlight mixer

Offset

Size

Type

Descriptions

0

2

u16

Audio source index

2

1

u8

Input type

3

2

?

unknown

5

1

u8

Index in group

10

1

u8

Changes when stereo is split into dual mono

12

1

u8

Analog audio input level [1=mic, 2=line]

Val

Input type

0

External video input

1

Media player audio

2

External audio input

After parsing: :ivar volume: Master volume for the mixer, signed int which maps [-10000 - 1000] to +10dB - -100dB (inf)

class pyatem.field.FairlightMasterPropertiesField(raw)

Data from the FAMP. Settings for the master bus on fairlight audio units.

Offset

Size

Type

Descriptions

0

1

?

unknown

1

1

bool

Enable master EQ

2

4

?

unknown

6

2

i16

EQ gain [-2000 - 2000]

8

2

?

unknown

10

2

u16

Dynamics make-up gain [0 - 2000]

12

4

i32

Master volume [-10000 - 1000]

16

1

bool

Audio follow video

17

3

?

unknown

After parsing: :ivar volume: Master volume for the mixer, signed int which maps [-10000 - 1000] to +10dB - -100dB (inf) :ivar eq_enable: Enabled/disabled state for the master EQ :ivar eq_gain: Gain applied after EQ, [-2000 - 2000] maps to -20dB - +20dB :ivar dynamics_gain: Make-up gain for the dynamics section, [0 - 2000] maps to 0dB - +20dB :ivar afv: Enable/disabled state for master audio-follow-video (for fade-to-black)

class pyatem.field.FairlightStripPropertiesField(raw)

Data from the FASP. Settings for a channel strip on fairlight audio units.

Offset

Size

Type

Descriptions

0

2

u16

Audio source index

14

1

u8

Split indicator? [01 for normal, FF for split]

15

1

u8

Subchannel index

18

1

u8

Delay in frames

22

2

i16

Gain [-10000 - 600]

29

1

bool

Enable EQ

34

2

i16

EQ Gain

38

2

u16

Dynamics gain

40

2

i16

Pan [-10000 - 10000]

46

2

i16

Volume [-10000 - 1000]

49

1

u8

AFV bitfield? 1=off 2=on 4=afv

The way byte 14 and 15 work is unclear at the moment, this need verification on a mixer with an video input that has more than 2 embedded channels, of of these bytes might be a channel count.

After parsing: :ivar volume: Master volume for the mixer, signed int which maps [-10000 - 1000] to +10dB - -100dB (inf) :ivar eq_enable: Enabled/disabled state for the master EQ :ivar eq_gain: Gain applied after EQ, [-2000 - 2000] maps to -20dB - +20dB :ivar dynamics_gain: Make-up gain for the dynamics section, [0 - 2000] maps to 0dB - +20dB :ivar afv: Enable/disabled state for master audio-follow-video (for fade-to-black)

class pyatem.field.FairlightStripDeleteField(raw)

Data from the FASD. Fairlight strip delete, received only when changing the source routing in fairlight to remove channels that have changed.

class pyatem.field.FairlightTallyField(raw)

Data from the FMTl. Encodes the state of tally lights on the audio mixer

Offset

Size

Type

Descriptions

0

2

u16

Number of tally lights

2

1

u8

Input type

3

2

?

unknown

5

1

u8

Index in group

10

1

u8

Changes when stereo is split into dual mono

12

1

u8

Analog audio input level [1=mic, 2=line]

Val

Input type

0

External video input

1

Media player audio

2

External audio input

After parsing: :ivar volume: Master volume for the mixer, signed int which maps [-10000 - 1000] to +10dB - -100dB (inf)

class pyatem.field.AtemEqBandPropertiesField(raw)

Data from the AEBP field. This encodes the EQ settings in the fairlight mixer. For every channel there will be 6 off these fields sent, one for every band of the EQ. The “possible band filters” differentiates the first and last band which have a different option list for the filter dropdown in the UI.

Offset

Size

Type

Descriptions

0

2

u16

Audio source index

2

2

?

unknown

4

4

?

unknown

14

1

u8

Split indicator? [01 for normal, FF for split]

15

1

u8

subchannel index

16

1

u8

bond index

17

1

bool

band enabled

18

1

u8

possible band filters

19

1

u8

band filter

20

1

?

?

21

1

?

band frequency range

26

2

u16

band frequency

28

4

i32

band gain

32

2

u16

band Q

Val

Band filter

01

Low shelf

02

Low pass

04

Bell

08

Notch

10

High pass

20

High shelf

After parsing: :ivar volume: Master volume for the mixer, signed int which maps [-10000 - 1000] to +10dB - -100dB (inf)

Level meters

class pyatem.field.FairlightMeterLevelsField(raw)

Data from the FMLv. This contains the realtime audio levels for the fairlight audio mixer

Offset

Size

Type

Description

0

6

?

Unknown

6

1

u8

is_split, 255 when split or 0 when it isn’t

7

1

u8

subchannel index

8

2

u16

source index

10

2

i16

Input level left, -10000 to 0

12

2

i16

Input level right, -10000 to 0

14

2

i16

Input peak left, -10000 to 0

16

2

i16

Input peak right, -10000 to 0

18

2

i16

Expander gain reduction, -10000 to 0

20

2

i16

Compressor gain reduction, -10000 to 0

22

2

i16

Limiter gain reduction, -10000 to 0

24

2

i16

Output level left, -10000 to 0

26

2

i16

Output level right, -10000 to 0

28

2

i16

Output peak left, -10000 to 0

30

2

i16

Output peak right, -10000 to 0

32

2

i16

Fader level left, -10000 to 0

34

2

i16

Fader level right, -10000 to 0

36

2

i16

Fader peak left, -10000 to 0

38

2

i16

Fader peak right, -10000 to 0

After parsing:

Variables
  • index – Channel source index

  • is_split – Stereo channel is split into dual mono

  • subchannel – Channel index after splitting

  • strip_id – Strip identifier in {source}.{subchannel} format

  • input – Volume level before dynamics

  • output – Volume level after dynamics

  • level – Volume level after fader

  • expander_gr – Gain reduction by the expander

  • compressor_gr – Gain reduction by the compressor

  • limiter_gr – Gain reduction by the limiter

class pyatem.field.FairlightMasterLevelsField(raw)

Data from the FDLv. This contains the realtime audio levels for the master channel of the fairlight mixer

Offset

Size

Type

Description

0

2

i16

Input level left, -10000 to 0

2

2

i16

Input level right, -10000 to 0

4

2

i16

Input peak left, -10000 to 0

6

2

i16

Input peak right, -10000 to 0

8

2

i16

Compressor gain reduction, -10000 to 0

10

2

i16

Limiter gain reduction, -10000 to 0

12

2

i16

Output level left, -10000 to 0

14

2

i16

Output level right, -10000 to 0

16

2

i16

Output peak left, -10000 to 0

18

2

i16

Output peak right, -10000 to 0

20

2

i16

Fader level left, -10000 to 0

22

2

i16

Fader level right, -10000 to 0

24

2

i16

Fader peak left, -10000 to 0

26

2

i16

Fader peak right, -10000 to 0

After parsing: :ivar input: Volume level before dynamics :ivar output: Volume level after dynamics :ivar level: Volume level after fader :ivar compressor_gr: Gain reduction by the compressor :ivar limiter_gr: Gain reduction by the limiter

Monitoring

class pyatem.field.FairlightHeadphonesField(raw)

Data from the FMHP, phones output volume and mute

This doesn’t get triggered when soloing channels.

0 4 i32 Volume in 0.01 dB (-60.00 to +6.00 dB) 5 4 ? Unknown 8 1 bool Muted (0) / Umuted (1) 9 1 u8 Last soloed channel (just the main part) 10 22 ? Unknown

class pyatem.field.FairlightSoloField(raw)

Data from the FAMS, soloing channels to phones

0 1 bool Anything soloed? 1 7 ? Unknown 8 1 u8 Unknown: 0x00 for HDMI channels, 0x05 for 3.5mm jack 9 1 u8 Soloed channel (main) 10 12 ? Unknown 22 1 u8 No subchannels (0x01), split into L/R (0xff) 23 1 u8 Soloed channel (subchannel)