dbxdriverack.pa2 package

Submodules

dbxdriverack.pa2.autoeq module

class dbxdriverack.pa2.autoeq.CmdBuilder(action: str, target: str, **kwargs: Any)

Bases: CmdBuilder

Subclass of the CmdBuilder network protocol factory for DriveRack PA2.

class dbxdriverack.pa2.autoeq.PA2AutoEq(enabled: bool = True)

Bases: object

Represents an Auto EQ (room EQ) block on a DriveRack PA2. This contains settings for the block as as well as the individual filters. None of the methods directly affect a live device.

filters

Dictionary of Auto EQ filters. Key is the filter number (1-8)

Type:

dict[int, PA2AutoEqFilter]

enabled

Whether the Auto EQ block is enabled

Type:

bool

addFilter(filter: PA2AutoEqFilter, filtNumber: int = -1) → None

Add a PA2AutoEqFilter to the Auto EQ block.

Parameters:

• filter (PA2AutoEqFilter) – The filter to add.

• filtNumber (int, optional) – Index number to assign to the filter. If not specified, the next available index will be used.

disable() → None

Disable the Auto EQ block.

enable() → None

Enable the Auto EQ block.

getFilter(filtNumber: int) → PA2AutoEqFilter

Get a filter from the Auto EQ block.

Parameters:

filtNumber (int) – The index number of the filter to retrieve.

Returns:

The PA2AutoEqFilter object with the specified index number.

Return type:

PA2AutoEqFilter

Raises:

ValueError – No filter with the specified index number exists.

isEnabled() → bool

Get the enabled state of the Auto EQ block.

Returns:

True if enabled, False if disabled

Return type:

bool

removeFilter(filtNumber: int) → None

Delete a filter from the Auto EQ block.

Parameters:

filtNumber (int) – The index number of the filter to remove.

Raises:

ValueError – No filter with the specified index number exists.

class dbxdriverack.pa2.autoeq.PA2AutoEqFilter(filtType: str, freq: float, gain: float, q: float)

Bases: object

Represents a single Auto EQ filter for the DriveRack PA2.

freq

Filter frequency in Hz

Type:

float

gain

Filter gain in dB

Type:

float

q

Filter Q value. For shelf filters, this holds the slope instead.

Type:

float

filtType

Filter type. One of autoeq.Bell, autoeq.LowShelf, autoeq.HighShelf.

Type:

str

Constants

---------

Enabled

On state for Auto EQ block

Type:

str

Disabled

Off state for Auto EQ block

Type:

str

ModeFlat

Flat mode for Auto EQ block

Type:

str

ModeManual

Manual mode for Auto EQ block

Type:

str

ModeAuto

Auto EQ mode for Auto EQ block

Type:

str

Bell

Bell filter type for Auto EQ filter

Type:

str

LowShelf

Low shelf filter type for Auto EQ filter

Type:

str

HighShelf

High shelf filter type for Auto EQ filter

Type:

str

FiltMinCount

Minimum number of filters in Auto EQ block

Type:

int

FiltMaxCount

Maximum number of filters in Auto EQ block

Type:

int

BellMinQ

Minimum Q value for Auto EQ bell filter

Type:

float

BellMaxQ

Maximum Q value for Auto EQ bell filter

Type:

float

ShelfMinSlope

Minimum slope for Auto EQ shelf filters

Type:

float

ShelfMaxSlope

Maximum slope for Auto EQ shelf filters

Type:

float

MinGain

Minimum gain in dB for an Auto EQ filter

Type:

int

MaxGain

Maximum gain in dB for an Auto EQ filter

Type:

int

dbxdriverack.pa2.compressor module

class dbxdriverack.pa2.compressor.CmdBuilder(action: str, target: str, **kwargs: Any)

Bases: CmdBuilder

Subclass of the CmdBuilder network protocol factory for DriveRack PA2.

class dbxdriverack.pa2.compressor.PA2Compressor(enabled: bool = True)

Bases: object

Represents the compressor block settings in the DriveRack PA2. None of the methods directly affect a live device.

enabled

Whether the compressor is enabled

Type:

bool

threshold

Threshold in dB

Type:

float

gain

Gain in dB

Type:

float

ratio

Ratio of compression (numerator only)

Type:

float

overEasy

OverEasy setting (0-10)

Type:

int

Constants

---------

Enabled

On state for Compressor block

Type:

str

Disabled

Off state for Compressor block

Type:

str

ThreshMin

Minimum threshold in dB

Type:

int

ThreshMax

Maximum threshold in dB

Type:

int

GainMin

Minimum gain in dB

Type:

int

GainMax

Maximum gain in dB

Type:

int

RatioMin

Minimum ratio value

Type:

int

RatioMax

Maximum ratio value

Type:

int

RatioBrickwall

Infinity ratio value

Type:

float

OverEasyMin

Minimum OverEasy value

Type:

int

OverEasyMax

Maximum

Type:

int

disable() → None

Disable the compressor block

enable() → None

Enable the compressor block

getGain() → float

Get the compressor gain in dB.

Returns:

Gain in dB

Return type:

float

getOverEasy() → int

Get the OverEasy value (0-10), 0 is off.

Returns:

OverEasy value

Return type:

int

getRatio() → float

Get the compressor ratio (numerator only). Value of -1 (equal to compressor.RatioBrickwall) indicates Infinity.

Returns:

Ratio (numerator only)

Return type:

float

getThreshold() → float

Get the compressor threshold in dB.

Returns:

Threshold in dB

Return type:

float

isEnabled() → bool

Whether the compressor block is enabled.

Returns:

True if enabled, False if disabled

Return type:

bool

setGain(gain: float) → None

Set compressor gain in dB.

Parameters:

gain (float) – Gain in dB

Raises:

ValueError – Gain is out of range

setOverEasy(overEasy: int) → None

Set the OverEasy setting (0-10), 0 is off.

Parameters:

overEasy (int) – OverEasy setting

Raises:

ValueError – OverEasy is out of range

setRatio(ratio: float) → None

Set the numerator of the ratio (denominator is always 1).

Parameters:

ratio (float) – Numerator of the ratio (<ratio>:1). Use compressor.RatioBrickwall for Infinity.

Raises:

ValueError – Ratio is out of range

setThreshold(threshold: float) → None

Set compressor threshold in dB.

Parameters:

threshold (float) – Threshold in dB

Raises:

ValueError – Threshold is out of range

dbxdriverack.pa2.crossover module

class dbxdriverack.pa2.crossover.CmdBuilder(action: str, target: str, **kwargs: Any)

Bases: CmdBuilder

Subclass of the CmdBuilder network protocol factory for DriveRack PA2.

class dbxdriverack.pa2.crossover.PA2Crossover

Bases: object

Represents the crossover block on a DriveRack PA2. This contains up to three bands (Low, Mid, High) of type PA2CrossoverBand. Whether or not these bands can be applied depends on the wizard configuration of the PA2. None of the methods directly affect a live device.

bandLow

Low band settings.

Type:

PA2CrossoverBand

bandMid

Mid band settings.

Type:

PA2CrossoverBand

bandHigh

High band settings.

Type:

PA2CrossoverBand

getHigh() → PA2CrossoverBand

Get the high band settings.

Returns:

High band object

Return type:

_type_

Raises:

ValueError – High band not set

getLow() → PA2CrossoverBand

Get the low band settings.

Returns:

Low band object

Return type:

_type_

Raises:

ValueError – Low band not set

getMid() → PA2CrossoverBand

Get the mid band settings.

Returns:

Mid band object

Return type:

_type_

Raises:

ValueError – Mid band not set

setHigh(band: PA2CrossoverBand) → None

Set the high band settings.

Parameters:

band (PA2CrossoverBand) – High band object

setLow(band: PA2CrossoverBand) → None

Set the low band settings.

Parameters:

band (PA2CrossoverBand) – Low band object

setMid(band: PA2CrossoverBand) → None

Set the mid band settings.

Parameters:

band (PA2CrossoverBand) – Mid band object

class dbxdriverack.pa2.crossover.PA2CrossoverBand

Bases: object

Represents a band (i.e. High, Mid, Low) in the DriveRack PA2 crossover. This contains high-pass & low-pass filters as well as gain and polarity settings. None of the methods directly affect a live device.

polarity

Polarity setting. One of dbxdriverack.PolarityNormal, dbxdriverack.PolarityInverted.

Type:

str

hpfType

High-pass filter type. One of the crossover filter constants.

Type:

str

lpfType

Low-pass filter type. One of the crossover filter constants.

Type:

str

hpfFreq

High-pass filter frequency in Hz.

Type:

float

lpfFreq

Low-pass filter frequency in Hz.

Type:

float

gain

Band gain in dB.

Type:

float

Constants

---------

MinGain

Minimum band gain in dB.

Type:

int

MaxGain

Maximum band gain in dB.

Type:

int

XoverFreqOut

Special “Out” value for crossover frequency indicating max/min

Type:

int

Crossover Frequency Constants

-----------------------------

XoverLR12

Linkwitz-Riley 12 dB/octave

Type:

str

XoverLR24

Linkwitz-Riley 24 dB/octave

Type:

str

XoverLR36

Linkwitz-Riley 36 dB/octave

Type:

str

XoverLR48

Linkwitz-Riley 48 dB/octave

Type:

str

XoverBW6

Butterworth 6 dB/octave

Type:

str

XoverBW12

Butterworth 12 dB/octave

Type:

str

XoverBW18

Butterworth 18 dB/octave

Type:

str

XoverBW24

Butterworth 24 dB/octave

Type:

str

XoverBW30

Butterworth 30 dB/octave

Type:

str

XoverBW36

Butterworth 36 dB/octave

Type:

str

XoverBW42

Butterworth 42 dB/octave

Type:

str

XoverBW48

Butterworth 48 dB/octave

Type:

str

getGain() → float

Get band gain in dB.

Returns:

Gain in dB.

Return type:

float

getHpfFreq() → float

Get high-pass filter frequency in Hz.

Returns:

High-pass filter frequency in Hz.

Return type:

float

getHpfType() → str

Get high-pass filter type.

Returns:

High-pass filter type. One of the crossover filter constants.

Return type:

str

getLpfFreq() → float

Get low-pass filter frequency in Hz.

Returns:

Low-pass filter frequency in Hz.

Return type:

float

getLpfType() → str

Get low-pass filter type.

Returns:

Low-pass filter type. One of the crossover filter constants.

Return type:

str

getPolarity() → str

Get band polarity.

Returns:

Band polarity. One of dbxdriverack.PolarityNormal, dbxdriverack.PolarityInerted.

Return type:

str

setGain(gain: float) → None

Set band gain in dB.

Parameters:

gain (float) – Gain in dB.

Raises:

ValueError – Gain is out of range.

setHpfFreq(hpfFreq: float) → None

Set high-pass filter frequency in Hz.

Parameters:

hpfFreq (float) – High-pass filter frequency in Hz.

Raises:

ValueError – Frequency is out of range.

setHpfType(hpfType: str) → None

Set high-pass filter type.

Parameters:

hpfType (str) – High-pass filter type. One of the crossover filter constants.

Raises:

ValueError – Invalid HPF type.

setLpfFreq(lpfFreq: float) → None

Set low-pass filter frequency in Hz.

Parameters:

lpfFreq (float) – Low-pass filter frequency in Hz.

Raises:

ValueError – Frequency is out of range.

setLpfType(lpfType: str) → None

Set low-pass filter type.

Parameters:

lpfType (str) – Low-pass filter type. One of the crossover filter constants.

Raises:

ValueError – Invalid LPF type.

setPolarity(polarity: str) → None

Set band polarity.

Parameters:

polarity (str) – Polarity setting. One of dbxdriverack.PolarityNormal, dbxdriverack.PolarityInerted.

Raises:

ValueError – Invalid polarity choice.

dbxdriverack.pa2.feedback module

class dbxdriverack.pa2.feedback.CmdBuilder(action: str, target: str, **kwargs: Any)

Bases: CmdBuilder

Subclass of the CmdBuilder network protocol factory for DriveRack PA2.

class dbxdriverack.pa2.feedback.PA2Feedback(enabled: bool = True)

Bases: object

Represents the Advanced Feedback Suppression block of a DriveRack PA2. None of the methods directly affect a live device.

enabled

Whether the feedback suppression is enabled

Type:

bool

liftTime

The lift time in seconds

Type:

float

fixedFilters

The number of fixed filters

Type:

int

mode

The operating mode. One of feedback.ModeLive, feedback.ModeFixed.

Type:

str

type

The program material type. One of feedback.TypeSpeech, feedback.TypeMusic, feedback.TypeSpeechMusic.

Type:

str

Constants

---------

Enabled

On state for AFS block

Type:

str

Disabled

Off state for AFS block

Type:

str

ModeLive

Live mode for AFS block

Type:

str

ModeFixed

Fixed mode for AFS block

Type:

str

TypeSpeech

Speech content type for AFS block

Type:

str

TypeMusic

Music content type for AFS block

Type:

str

TypeSpeechMusic

Speech and music content type for AFS block

Type:

str

LiftMin

Minimum lift time in seconds

Type:

int

LiftMax

Maximum lift time in seconds

Type:

int

FiltMin

Minimum number of filters

Type:

int

FiltMax

Maximum number of filters

Type:

int

disable() → None

Disable the feedback suppression block.

enable() → None

Enable the feedback suppression block.

getFixedFilters() → int

Get the number of fixed filters.

Returns:

Number of fixed filters

Return type:

int

getLiftTime() → float

Get the lift time in seconds.

Returns:

Lift time in seconds

Return type:

float

isEnabled() → bool

Get the enabled state of the feedback suppression block.

Returns:

True if enabled, False if disabled

Return type:

bool

setFixedFilters(filters: int) → None

Set the number of fixed filters. The remaining filters are live filters.

Parameters:

filters (int) – Number of fixed filters

Raises:

ValueError – Number of fixed filters is out of range (0-12)

setLiftTime(time: float) → None

Set the lift time in seconds.

Parameters:

time (float) – The lift time in seconds

Raises:

ValueError – Lift time is out of range (5-3600)

setMode(mode: str) → None

Set the operating mode of the feedback suppression block.

Parameters:

mode (str) – Mode of operation. One of feedback.ModeLive, feedback.ModeFixed.

Raises:

ValueError – Invalid mode selection

setType(type: str) → None

Set the program material type.

Parameters:

type (str) – Material type. One of feedback.TypeSpeech, feedback.TypeMusic, feedback.TypeSpeechMusic.

Raises:

ValueError – Invalid type selection

dbxdriverack.pa2.generator module

class dbxdriverack.pa2.generator.CmdBuilder(action: str, target: str, **kwargs: Any)

Bases: CmdBuilder

Subclass of the CmdBuilder network protocol factory for DriveRack PA2.

class dbxdriverack.pa2.generator.PA2Generator(mode: str = 'Off', level: int = -60)

Bases: object

Represents the signal generator of a DriveRack PA2. None of the methods directly affect a live device.

mode

The mode of the signal generator. One of generator.ModeOff, generator.ModePink, generator.ModeWhite.

Type:

str

level

The level of the signal generator in dB.

Type:

float

Constants

---------

ModeOff

Off state for Signal Generator block

Type:

str

ModePink

Pink noise mode for Signal Generator block

Type:

str

ModeWhite

White noise mode for Signal Generator block

Type:

str

MinLevel

Minimum level in dB

Type:

int

MaxLevel

Maximum level in dB

Type:

int

getLevel() → float

Get the level of the signal generator.

getMode() → str

Get the mode of the signal generator.

Returns:

Mode of the signal generator. One of generator.ModeOff, generator.ModePink, generator.ModeWhite.

Return type:

str

setLevel(level: float) → None

Set the level of the signal generator.

Parameters:

level (float) – Level in dB.

Raises:

ValueError – Level out of range (-60 to 0)

setMode(mode: str) → None

Set the operating mode of the signal generator.

Parameters:

mode (str) – Mode of the signal generator. One of generator.ModeOff, generator.ModePink, generator.ModeWhite.

Raises:

ValueError – Invalid mode specified

dbxdriverack.pa2.geq module

class dbxdriverack.pa2.geq.CmdBuilder(action: str, target: str, **kwargs: Any)

Bases: CmdBuilder

Subclass of the CmdBuilder network protocol factory for DriveRack PA2.

class dbxdriverack.pa2.geq.PA2Geq(enabled: bool = True)

Bases: object

Represents a 31-band graphic equalizer on the DriveRack PA2. The PA2 can have one stereo-linked or two independent mono GEQs, this object is agnostic to the configuration and these settings may be applied to one or the other. None of the methods directly affect a live device.

enabled

Whether the GEQ is enabled

Type:

bool

bands

Dictionary of band gains. Key is the band number (1-31), value is the gain in dB.

Type:

dict[int, float]

Constants

---------

Enabled

On state for Graphic EQ block

Type:

str

Disabled

Off state for Graphic EQ block

Type:

str

ModeFlat

Flat mode for Graphic EQ block

Type:

str

ModeMyBand

My Band mode for Graphic EQ block

Type:

str

ModeSpeech

Speech mode for Graphic EQ block

Type:

str

ModeVenue

Performance Venue mode for Graphic EQ block

Type:

str

ModeDJ

DJ mode for Graphic EQ block

Type:

str

ModeManual

Manual mode for Graphic EQ block This mode is implied after any adjustments are made

Type:

str

MinGain

Minimum gain in dB

Type:

int

MaxGain

Maximum gain in dB

Type:

int

disable() → None

Disable the GEQ block.

enable() → None

Enable the GEQ block.

isEnabled() → bool

Get the enabled state of the GEQ.

Returns:

True if enabled, False if disabled

Return type:

bool

setBand(band: int, gain: float) → None

Set the gain of a band in the GEQ.

Parameters:

• band (int) – Band number (1-31) Band 1 represents 20 Hz, Band 31 represents 20 kHz

• gain (float) – Gain setting in dB for the band

Raises:

ValueError – Invalid band number or gain out of range

dbxdriverack.pa2.indelay module

class dbxdriverack.pa2.indelay.CmdBuilder(action: str, target: str, **kwargs: Any)

Bases: CmdBuilder

Subclass of the CmdBuilder network protocol factory for DriveRack PA2.

class dbxdriverack.pa2.indelay.PA2InputDelay

Bases: object

Represents the input delay block settings in the DriveRack PA2. None of the methods directly affect a live device.

delay

Delay in milliseconds

Type:

float

enabled

Whether the input delay is enabled

Type:

bool

Constants

---------

Enabled

On state for Input Delay block

Type:

str

Disabled

Off state for Input Delay block

Type:

str

MinTime

Minimum delay in milliseconds

Type:

int

MaxTime

Maximum delay in milliseconds

Type:

int

disable() → None

Disable the input delay.

enable() → None

Enable the input delay.

getDelay() → float

Get the delay in milliseconds.

Returns:

Delay in milliseconds

Return type:

float

isEnabled() → bool

Get the enabled state of the input delay.

Returns:

True if enabled, False if disabled

Return type:

bool

setDelay(delay: float) → None

Set the delay in milliseconds.

Parameters:

delay (float) – Delay in milliseconds

Raises:

ValueError – Delay out of range (0-100ms)

dbxdriverack.pa2.limiter module

class dbxdriverack.pa2.limiter.CmdBuilder(action: str, target: str, **kwargs: Any)

Bases: CmdBuilder

Subclass of the CmdBuilder network protocol factory for DriveRack PA2.

class dbxdriverack.pa2.limiter.PA2Limiter

Bases: object

Represents a PA2 Limiter block The PA2 can have up to 3 limiters, one for each output band (Low, Mid, High) and this object represents one of those limiters, which can be applied to one of the available output bands of a PA2 device. None of the methods directly affect a live device.

enabled

Whether the limiter is enabled

Type:

bool

threshold

The threshold in dB

Type:

float

overEasy

The OverEasy value

Type:

int

Constants

---------

Enabled

On state for the Limiter block

Type:

str

Disabled

Off state for the Limiter block

Type:

str

MinThresh

Minimum threshold in dB

Type:

int

MaxThresh

Maximum threshold in dB

Type:

int

MinOverEasy

Minimum OverEasy value

Type:

int

MaxOverEasy

Maximum OverEasy value

Type:

int

disable() → None

Disable the limiter

enable() → None

Enable the limiter

getOverEasy() → int

Get the OverEasy value

Returns:

OverEasy value

Return type:

int

getThreshold() → float

Get the threshold value

Returns:

The threshold value in dB

Return type:

float

isEnabled() → bool

Enable state of the limiter

Returns:

True if enabled, False if disabled

Return type:

bool

setOverEasy(overEasy: int) → None

Set the OverEasy value

Parameters:

overEasy (int) – OverEasy value. 0 is Off.

Raises:

ValueError – OverEasy out of range (0-10)

setThreshold(threshold: float) → None

Set the threshold value

Parameters:

threshold (float) – The threshold value in dB

Raises:

ValueError – Threshold out of range (-60 to 0)

dbxdriverack.pa2.outputband module

class dbxdriverack.pa2.outputband.CmdBuilder(action: str, target: str, **kwargs: Any)

Bases: CmdBuilder

Subclass of the CmdBuilder network protocol factory for DriveRack PA2.

class dbxdriverack.pa2.outputband.PA2OutputBlock

Bases: object

Represents an output block in a PA2 device (i.e. Low, Mid, or High) An output block is a combination of a PEQ, Limiter and Alignment Delay blocks. This also is designated to handle output muting. None of the methods directly affect a live device.

peq

The PEQ block for this output

Type:

PA2Peq

limiter

The Limiter block for this output

Type:

PA2Limiter

delay

The Alignment Delay block for this output

Type:

PA2OutputDelay

Constants

---------

BandLow

Low output band

Type:

str

BandMid

Mid output band

Type:

str

BandHigh

High output band

Type:

str

MuteEnabled

On state for the an output channel mute

Type:

str

MuteDisabled

Off state for the an output channel mute

Type:

str

getDelay() → PA2OutputDelay

Get the Alignment Delay block for this output

Returns:

The Alignment Delay block for this output

Return type:

odly.PA2OutputDelay

Raises:

ValueError – Output Delay not set

getLimiter() → PA2Limiter

Get the Limiter block for this output

Returns:

The Limiter block for this output

Return type:

limiter.PA2Limiter

Raises:

ValueError – Limiter not set

getPeq() → PA2Peq

Get the PEQ block for this output

Returns:

The PEQ block for this output

Return type:

peq.PA2Peq

Raises:

ValueError – PEQ not set

setDelay(delay: PA2OutputDelay) → None

Set the Alignment Delay block for this output with a PA2OutputDelay object

Parameters:

delay (odly.PA2OutputDelay) – The Alignment Delay block to set

setLimiter(limiter: PA2Limiter) → None

Set the Limiter block for this output with a PA2Limiter object

Parameters:

limiter (limiter.PA2Limiter) – The Limiter block to set

setPeq(peq: PA2Peq) → None

Set the PEQ block for this output with a PA2Peq object

Parameters:

peq (peq.PA2Peq) – The PEQ block to set

dbxdriverack.pa2.outputdelay module

class dbxdriverack.pa2.outputdelay.CmdBuilder(action: str, target: str, **kwargs: Any)

Bases: CmdBuilder

Subclass of the CmdBuilder network protocol factory for DriveRack PA2.

class dbxdriverack.pa2.outputdelay.PA2OutputDelay

Bases: object

Represents a PA2 Output (Alignment) Delay block. The PA2 can have up to 3 output delays, one for each output band (Low, Mid, High) and this object represents one of those delays, which can be applied to one of the available output bands of a PA2 device. None of the methods directly affect a live device.

delay

The delay in milliseconds

Type:

float

enabled

Whether the delay is enabled

Type:

bool

Constants

---------

Enabled

On state for the Delay block

Type:

str

Disabled

Off state for the Delay block

Type:

str

MinDelay

Minimum delay in milliseconds

Type:

int

MaxDelay

Maximum delay in milliseconds

Type:

int

disable() → None

Disable the delay

enable() → None

Enable the delay

getDelay() → float

Get the delay in milliseconds

Returns:

Delay in milliseconds

Return type:

float

isEnabled() → bool

Enable state of the delay

Returns:

True if enabled, False if disabled

Return type:

bool

setDelay(delay: float) → None

Set the delay in milliseconds

Parameters:

delay (float) – Delay in milliseconds

Raises:

ValueError – Delay out of range (0-10000ms)

dbxdriverack.pa2.peq module

class dbxdriverack.pa2.peq.CmdBuilder(action: str, target: str, **kwargs: Any)

Bases: CmdBuilder

Subclass of the CmdBuilder network protocol factory for DriveRack PA2.

class dbxdriverack.pa2.peq.PA2Peq(enabled: bool = True)

Bases: object

Represents a PEQ block for the DriveRack PA2. The PA2 can have up to 3 PEQ blocks, one for each output band (Low, Mid, High) and this object represents one of those PEQs, which can be applied to one of the available output bands of a PA2 device. None of the methods directly affect a live device.

filters

Dictionary of PEQ filters. Key is the filter number (1-8)

Type:

dict[int, PA2PeqFilter]

enabled

Whether the PEQ block is enabled

Type:

bool

Constants

---------

Enabled

On state for the PEQ block

Type:

str

Disabled

Off state for the PEQ block

Type:

str

FiltMinCount

Minimum number of filters in PEQ block

Type:

int

FiltMaxCount

Maximum number of filters in PEQ block

Type:

int

addFilter(filter: PA2PeqFilter, filtNumber: int = -1) → None

Add a PEQ filter to the PEQ block.

Parameters:

• filter (PA2PeqFilter) – The filter to add

• filtNumber (int, optional) – Index number to assign to the filter. If not specified, the next available index will be used.

disable() → None

Disable the PEQ block

enable() → None

Enable the PEQ block

flatten() → None

Remove all filters from the PEQ block

getFilter(filtNumber: int) → PA2PeqFilter

Get a filter from the PEQ block.

Parameters:

filtNumber (int) – The index number of the filter to retrieve.

Returns:

The PA2PeqFilter object with the specified index number.

Return type:

PA2PeqFilter

Raises:

ValueError – No filter with the specified index number exists.

removeFilter(filtNumber: int) → None

Delete a filter from the PEQ block.

Parameters:

filtNumber (int) – The index number of the filter to remove.

class dbxdriverack.pa2.peq.PA2PeqFilter(filtType: str, freq: float, gain: float, q: float)

Bases: object

Represents a single PEQ filter for the DriveRack PA2.

freq

Filter frequency in Hz

Type:

float

gain

Filter gain in dB

Type:

float

q

Filter Q value. For shelf filters, this holds the slope instead.

Type:

float

filtType

Filter type. One of peq.Bell, peq.LowShelf, peq.HighShelf.

Type:

str

Constants

---------

Enabled

On state for PEQ block

Type:

str

Disabled

Off state for PEQ block

Type:

str

Bell

Bell filter type for PEQ filter

Type:

str

LowShelf

Low shelf filter type for PEQ filter

Type:

str

HighShelf

High shelf filter type for PEQ filter

Type:

str

FiltMinCount

Minimum number of filters in PEQ block

Type:

int

FiltMaxCount

Maximum number of filters in PEQ block

Type:

int

BellMinQ

Minimum Q value for Bell filter

Type:

float

BellMaxQ

Maximum Q value for Bell filter

Type:

float

ShelfMinSlope

Minimum slope value for shelf filters

Type:

float

ShelfMaxSlope

Maximum slope value for shelf filters

Type:

float

MinGain

Minimum gain value for PEQ filter

Type:

float

MaxGain

Maximum gain value for PEQ filter

Type:

float

dbxdriverack.pa2.rta module

class dbxdriverack.pa2.rta.CmdBuilder(action: str, target: str, **kwargs: Any)

Bases: CmdBuilder

Subclass of the CmdBuilder network protocol factory for DriveRack PA2.

class dbxdriverack.pa2.rta.PA2Rta

Bases: object

Represents the Real Time Analyzer (RTA) section of a PA2 device. None of the methods directly affect a live device.

rate

The rate of the RTA (Slow or Fast)

Type:

str

offset

The graph offset of the RTA in dB

Type:

float

Constants

---------

Slow

Slow rate for the RTA

Type:

str

Fast

Fast rate for the RTA

Type:

str

OffsetMin

Minimum offset in dB

Type:

int

OffsetMax

Maximum offset in dB

Type:

int

getOffset() → float

Get the graph offset of the RTA.

Returns:

Offset in dB

Return type:

float

getRate() → str

Get the rate of the RTA.

Returns:

Rate of the RTA. One of rta.Slow or rta.Fast.

Return type:

str

setOffset(offset: float) → None

Set the graph offset of the RTA.

Parameters:

offset (float) – Offset in dB

Raises:

ValueError – Offset out of range (0-40dB)

setRate(rate: str) → None

Set the rate of the RTA.

Parameters:

rate (str) – Rate of the RTA. One of rta.Slow or rta.Fast

Raises:

ValueError – Invalid rate

dbxdriverack.pa2.subharmonic module

class dbxdriverack.pa2.subharmonic.CmdBuilder(action: str, target: str, **kwargs: Any)

Bases: CmdBuilder

Subclass of the CmdBuilder network protocol factory for DriveRack PA2.

class dbxdriverack.pa2.subharmonic.PA2Subharmonic(enabled: bool = True)

Bases: object

Represents the Subharmonic Synthesis section of a PA2 device. None of the methods directly affect a live device.

enabled

Whether the subharmonic synthesis is enabled

Type:

bool

harmonics

Master percentage of subharmonics

Type:

float

lows

Percentage of subharmonics in the range 24-36Hz

Type:

float

highs

Percentage of subharmonics in the range 36-56Hz

Type:

float

Constants

---------

Enabled

On state for the Subharmonic Synthesis block

Type:

str

Disabled

Off state for the Subharmonic Synthesis block

Type:

str

disable() → None

Disable the subharmonic synthesis.

enable() → None

Enable the subharmonic synthesis.

getHarmonics() → float

Get the master percentage of subharmonics.

Returns:

Percentage of subharmonics (0-100)

Return type:

float

getHighs() → float

Get the percentage of subharmonics in the range 36-56Hz.

Returns:

Percentage of subharmonics (0-100)

Return type:

float

getLows() → float

Get the percentage of subharmonics in the range 24-36Hz.

Returns:

Percentage of subharmonics (0-100)

Return type:

float

isEnabled() → bool

Get the enable state of the subharmonic synthesis.

Returns:

True if enabled, False if disabled

Return type:

bool

setHarmonics(percentage: float) → None

Set the master percentage of subharmonics.

Parameters:

percentage (float) – Percentage of subharmonics (0-100)

Raises:

ValueError – Percentage out of range (0-100)

setHighs(percentage: float) → None

Set the percentage of subharmonics in the range 36-56Hz.

Parameters:

percentage (float) – Percentage of subharmonics (0-100)

Raises:

ValueError – Percentage out of range (0-100)

setLows(percentage: float) → None

Set the percentage of subharmonics in the range 24-36Hz.

Parameters:

percentage (float) – Percentage of subharmonics (0-100)

Raises:

ValueError – Percentage out of range (0-100)

Module contents

Provides functions and state tracking for discoveriung, connecting to, reading, and controlling aspects of a dbx DriveRack PA2 device.

class dbxdriverack.pa2.PA2(debug: bool = False)

Bases: object

Represents a dbx DriveRack PA2 device and provides methods for discovering, connecting to, and controlling the device.

aeqChangeMode(mode: str, block: bool = True) → None

Immediately set the live AutoEQ mode of the connected PA2.

Parameters:

• mode (str) –

  AutoEQ mode to set. Must be one of:

  aeq.ModeFlat, aeq.ModeManual, aeq.ModeAuto

• block (bool, optional) – Wait until device confirms completion before returning. Default True

Raises:

ValueError – Invalid mode

afsChangeMode(mode: str, block: bool = True) → None

Immediately set the live AFS mode of the connected PA2.

Parameters:

• mode (str) –

  AFS mode to set. Must be one of:

  afs.ModeLive, afs.ModeFixed

• block (bool, optional) – Wait until device confirms completion before returning. Default True

Raises:

ValueError – Invalid mode

afsChangeType(type: str, block: bool = True) → None

Immediately set the live AFS program type of the connected PA2.

Parameters:

• type (str) –

  AFS program type to set. Must be one of:

  afs.TypeSpeech, afs.TypeMusic, afs.TypeSpeechMusic

• block (bool, optional) – Wait until device confirms completion before returning. Default True

Raises:

ValueError – Invalid type

afsClearAll(block: bool = True) → None

Immediately clear all AFS filters of the connected PA2.

Parameters:

block (bool, optional) – Wait until device confirms completion before returning. Default True

afsClearLive(block: bool = True) → None

Immediately clear the live AFS filters of the connected PA2.

Parameters:

block (bool, optional) – Wait until device confirms completion before returning. Default True

afsLiveLift(block: bool = True) → None

Immediately lift the live AFS filters of the connected PA2.

Parameters:

block (bool, optional) – Wait until device confirms completion before returning. Default True

applyAeq(block: bool = True) → None

Apply the currently-set AutoEQ filters to the connected PA2. EQ will be flattened before applying the AutoEQ.

Parameters:

block (bool, optional) – Wait until the device confirms completion. Default True.

Raises:

ValueError – Auto EQ settings not set

applyAfs(block: bool = True) → None

Apply the currently-set Advanced Feedback Suppression settings to the connected PA2.

Parameters:

block (bool, optional) – Wait until the device confirms completion. Default True.

Raises:

ValueError – Auto Feedback settings not set

applyCompressor(block: bool = True) → None

Apply the currently-set Compressor settings to the connected PA2.

Parameters:

block (bool, optional) – Wait until the device confirms completion. Default True.

Raises:

ValueError – Compressor settings not set

applyCrossover(block: bool = True) → None

Apply the currently-set Crossover settings to the connected PA2.

Parameters:

block (bool, optional) – Wait until the device confirms completion. Default True.

Raises:

ValueError – Crossover settings not set or invalid band

applyGenerator(block: bool = True) → None

Apply the currently-set Signal Generator settings to the connected PA2.

Parameters:

block (bool, optional) – Wait until the device confirms completion. Default True.

Raises:

ValueError – Generator settings not set

applyGeq(channel: str = 'Stereo', block: bool = True) → None

Apply currently-set GEQ settings to the specified GEQ on the device.

Parameters:

• channel (str, optional) – Which GEQ to apply to, by default dbxdriverack.ChannelsStereo Must be one of dbxdriverack.ChannelsStereo, dbxdriverack.ChannelLeft, dbxdriverack.ChannelRight.

• block (bool, optional) – Wait until device confirms completion before returning, by default True

Raises:

ValueError – No GEQ settings have been set

applyInputDelay(block: bool = True) → None

Apply the currently-set Input Delay settings to the connected PA2.

Parameters:

block (bool, optional) – Wait until the device confirms completion. Default True.

Raises:

ValueError – Input Delay settings not set

applyLimiters(block: bool = True) → None

Apply any currently-set Limiter settings to the connected PA2.

Parameters:

block (bool, optional) – Wait until the device confirms completion. Default True.

Raises:

ValueError – Invalid band

applyOutputDelays(block: bool = True) → None

Apply any currently-set Output Delay settings to the connected PA2.

Parameters:

block (bool, optional) – Wait until the device confirms completion. Default True.

Raises:

ValueError – Invalid band

applyPeqs(block: bool = True) → None

Apply any currently-set PEQ settings to the connected PA2.

Parameters:

block (bool, optional) – Wait until the device confirms completion. Default True.

applyRta(block: bool = True) → None

Apply the currently-set RTA settings to the connected PA2.

Parameters:

block (bool, optional) – Wait until the device confirms completion. Default True.

Raises:

ValueError – RTA settings not set

applySubharmonic(block: bool = True) → None

Apply the currently-set Subharmonic Synth settings to the connected PA2.

Parameters:

block (bool, optional) – Wait until the device confirms completion. Default True.

Raises:

ValueError – Subharmonic settings not set

bulkMute(action: str, updateState: bool = True, block: bool = True) → None

Immediately set or poll the device for all mute states at once.

Parameters:

• action (str) –

  Which action to take. Must be one of:

  dbxdriverack.CmdMuteRefresh

  Refresh the mute states from the device

  dbxdriverack.CmdMuteRestore

  Restore the mute states to the last known values

  dbxdriverack.CmdMuteAll

  Mute all outputs

  dbxdriverack.CmdUnmuteAll

  Unmute all outputs

• updateState (bool, optional) – Whether to update the local state after setting. Default True.

• block (bool, optional) – Wait until the device confirms completion. Default True.

Raises:

ValueError – Invalid action or band

connect(host: str, password: str = 'administrator', port: int = 19272, timeout: int = 10) → None

Connect to a PA2 device. This also starts several threads that will handle sending and receiving messages to/from the device.

Parameters:

• host (str) – IP address or hostname of the PA2 device. Use discoverDevices() to find devices on the local network.

• password (str, optional) – Password of a protected PA2. When no password is set, PA2 uses the default (“administrator”)

• port (int, optional) – Port to connect to, by default 19272

• timeout (int, optional) – Seconds to wait for various network actions to complete. Default 10.

discoverDevices(srcPort: int = 0, dstPort: int = 19272, timeout: int = 5) → ItemsView[str, PA2Device]

Solict and receive responses from all PA2 devices on the local network subnet. Returns a dictionary of discovered devices.

Parameters:

• srcPort (int, optional) – UDP source port. By default the OS will pick a random port.

• dstPort (int, optional) – Destination UDP port to broadcast to. Defaults to 19272, used by PA2.

• timeout (int, optional) – Number of seconds to wait for DriveRacks to respond, by default 5.

Returns:

Returns a dictionary of discovered devices. The key is the device’s name and the value is a PA2Device object containing other details.

Return type:

ItemsView[str, PA2Device]

flattenPeq(band: str, apply: bool = True, block: bool = True) → None

Sets all PEQ filters to flat for the specified band. By default, also update the live device to reflect the change.

Parameters:

• band (str) –

  Which band’s PEQ to flatten. Must be one of:

  dbxdriverack.BandHigh, BandMid, BandLow

• apply (bool, optional) – Whether to apply the values to the connected device. Default True. If False, just update the local state only (not typical).

• block (bool, optional) – Wait until the device confirms completion. Default True.

geqChangeMode(mode: str, channel: str = 'Stereo', block: bool = True) → None

Immediately set the live GEQ mode of the connected PA2.

Parameters:

• mode (str) –

  GEQ mode to set. Must be one of:

  geq.ModeFlat, geq.ModeMyBand, geq.ModeSpeech, geq.ModeVenue, geq.ModeDJ, geq.ModeManual

• channel (str, optional) – Which GEQ to apply to, by default dbxdriverack.ChannelsStereo. Must be one of ChannelsStereo, ChannelLeft, ChannelRight.

• block (bool, optional) – Wait until device confirms completion before returning. Default True

Raises:

ValueError – Invalid mode

getAeq(update: bool = True, block: bool = True) → PA2AutoEq

Get the currently-connected PA2’s specified AutoEQ settings.

Parameters:

• update (bool, optional) – Query the device for the latest AutoEQ settings, by default True. If False, just return the last known settings (not typical).

• block (bool, optional) – Wait until values are received from the device. Default True.

Returns:

AutoEQ settings

Return type:

aeq.PA2AutoEq

getAfs(update: bool = True, block: bool = True) → PA2Feedback

Get the currently-connected PA2’s specified AFS settings.

Parameters:

• update (bool, optional) – Query the device for the latest AFS settings, by default True. If False, just return the last known settings (not typical).

• block (bool, optional) – Wait until values are received from the device. Default True.

Returns:

AFS settings

Return type:

afs.PA2Feedback

getCompressor(update: bool = True, block: bool = True) → PA2Compressor

Get the currently-connected PA2’s specified Compressor settings.

Parameters:

• update (bool, optional) – Query the device for the latest Compressor settings. Default True. If False, just return the last known settings (not typical).

• block (bool, optional) – Wait until values are received from the device. Default True.

Returns:

Compressor settings

Return type:

comp.PA2Compressor

getCrossover(update: bool = True, block: bool = True) → PA2Crossover

Get the currently-connected PA2’s specified Crossover settings.

Parameters:

• update (bool, optional) – Query the device for the latest Crossover settings. Default True. If False, just return the last known settings (not typical).

• block (bool, optional) – Wait until values are received from the device. Default True.

Returns:

Crossover settings

Return type:

xo.PA2Crossover

getGenerator(update: bool = True, block: bool = True) → PA2Generator

Get the currently-connected PA2’s specified Generator settings.

Parameters:

• update (bool, optional) – Query the device for the latest Generator settings. Default True. If False, just return the last known settings (not typical).

• block (bool, optional) – Wait until values are received from the device. Default True.

Returns:

Generator settings

Return type:

gen.PA2Generator

getGeq(channel: str = 'Stereo', update: bool = True, block: bool = True) → PA2Geq

Get the currently-connected PA2’s specified GEQ settings.

Parameters:

• channel (str, optional) – Which GEQ to get, by default dbxdriverack.ChannelsStereo. Must be one of ChannelsStereo, ChannelLeft, ChannelRight.

• update (bool, optional) – Query the device for the latest GEQ settings, by default True. If False, just return the last known settings (not typical).

• block (bool, optional) – Wait until values are received from the device before returning.

Returns:

_description_

Return type:

geq.PA2Geq

getHost() → str

Get the IP address of the connected PA2.

Returns:

IP address

Return type:

str

getInputDelay(update: bool = True, block: bool = True) → PA2InputDelay

Get the currently-connected PA2’s specified Input Delay settings.

Parameters:

• update (bool, optional) – Query the device for the latest Input Delay settings. Default True. If False, just return the last known settings (not typical).

• block (bool, optional) – _description_, by default True

Returns:

Input Delay settings

Return type:

idly.PA2InputDelay

getLimiter(band: str, update: bool = True, block: bool = True) → PA2Limiter

Get the currently-connected PA2’s specified Limiter settings.

Parameters:

• band (str) –

  Which band’s Limiter to get. Must be one of:

  dbxdriverack.BandHigh, BandMid, BandLow

• update (bool, optional) – Query the device for the latest Limiter settings. Default True. If False, just return the last known settings (not typical).

• block (bool, optional) – Wait until values are received from the device. Default True.

Returns:

Limiter settings

Return type:

lim.PA2Limiter

Raises:

ValueError – Invalid band

getModel() → str

Get the device model of the connected PA2.

Returns:

Device model

Return type:

str

getName() → str

Get the device name of the connected PA2.

Returns:

Device name

Return type:

str

getOutputDelay(band: str, update: bool = True, block: bool = True) → PA2OutputDelay

Get the currently-connected PA2’s specified Output Delay settings.

Parameters:

• band (str) –

  Which band’s Output Delay to get. Must be one of:

  dbxdriverack.BandHigh, BandMid, BandLow

• update (bool, optional) – Query the device for the latest Output Delay settings. Default True. If False, just return the last known settings (not typical).

• block (bool, optional) – Wait until values are received from the device. Default True.

Returns:

Output Delay settings

Return type:

odly.PA2OutputDelay

Raises:

ValueError – Invalid band

getPeq(band: str, update: bool = True, block: bool = True) → PA2Peq

Get the currently-connected PA2’s specified PEQ settings.

Parameters:

• band (str) –

  Which band’s PEQ to get. Must be one of:

  dbxdriverack.BandHigh, BandMid, BandLow

• update (bool, optional) – Query the device for the latest PEQ settings. Default True. If False, just return the last known settings (not typical).

• block (bool, optional) – Wait until values are received from the device. Default True.

Returns:

PEQ settings

Return type:

peq.PA2Peq

Raises:

ValueError – Invalid band

getPort() → int

Get the TCP port of the connected PA2.

Returns:

Port number

Return type:

int

getRta(update: bool = True, block: bool = True) → PA2Rta

Get the currently-connected PA2’s specified RTA settings.

Parameters:

• update (bool, optional) – Query the device for the latest RTA settings. Default True. If False, just return the last known settings (not typical).

• block (bool, optional) – Wait until values are received from the device. Default True.

Returns:

RTA settings

Return type:

rta.PA2Rta

getSubharmonic(update: bool = True, block: bool = True) → PA2Subharmonic

Get the currently-connected PA2’s specified Subharmonic Synth settings.

Parameters:

• update (bool, optional) – Query the device for the latest Subharmonic settings. Default True. If False, just return the last known settings (not typical).

• block (bool, optional) – Wait until values are received from the device. Default True.

Returns:

Subharmonic Synth settings

Return type:

sub.PA2Subharmonic

getVersion() → str

Get the firmware version of the connected PA2.

Returns:

Firmware version

Return type:

str

hasMids() → bool

Indicates whether the connected PA2 has Mid enabled by the setup wizard. This information is automatically queried during just following the authentication process.

Returns:

True if the Mid band is enabled, False otherwise.

Return type:

bool

hasSubs() → bool

Indicates whether the connected PA2 has Low band enabled by the setup wizard. This information is automatically queried during just following the authentication process.

Returns:

True if the Low band is enabled, False otherwise.

Return type:

bool

isGeqStereo() → bool

Indicates if the connected PA2 is set to use a stereo-linked GEQ or dual-mono GEQ. This information is automatically queried during just following the authentication process.

Returns:

True if stereo-linked GEQ, False if dual-mono GEQ.

Return type:

bool

isLowMono() → bool

Indicates whether the connected PA2 has mono or stereo subwoofers set by the setup wizard. This information is automatically queried during just following the authentication process.

Returns:

True if the Low band is mono, False if stereo.

Return type:

bool

isMuted(band: str, channel: str, update: bool = True, block: bool = True) → bool

Indicate whether the specified output band+channel is currently muted.

Parameters:

• band (str) –

  Which band to check. Must be one of:

  dbxdriverack.BandHigh, BandMid, BandLow

• channel (str) –

  Which channel to check. Must be one of:

  dbxdriverack.ChannelLeft, ChannelRight

• update (bool, optional) – Query the device for the latest mute state. Default True. If False, just return the last known state (not typical).

• block (bool, optional) – Wait until values are received from the device. Default True.

Returns:

True if muted, False if unmuted

Return type:

bool

Raises:

ValueError – Invalid band or channel

listRegex = re.compile('^\\s*([^:\\s]+)\\s*:\\s*(.*)\\s*$')

muteOutput(band: str, channel: str, mute: bool, block: bool = True) → None

Immediately mute or unmute the specified output band and channel.

Parameters:

• band (str) –

  Which band to mute. Must be one of:

  dbxdriverack.BandHigh, BandMid, BandLow

• channel (str) –

  Which channel to mute. Must be one of:

  dbxdriverack.ChannelLeft, ChannelRight

• mute (bool) – Whether to mute (True) or unmute (False)

• block (bool, optional) – Wait until the device confirms completion. Default True.

Raises:

ValueError – Invalid band, channel, or mute value

setAeq(aeq: PA2AutoEq, apply: bool = True) → None

Sets a PA2’s specified AutoEQ settings to match the provided PA2AutoEq object.

Parameters:

• aeq (aeq.PA2AutoEq) – The AutoEQ settings to apply

• apply (bool, optional) – Whether to apply the values to the connected device. Default True. If False, just update the local state only (not typical).

setAfs(afsObj: PA2Feedback, apply: bool = True) → None

Sets a PA2’s AFS settings to match the provided PA2Feedback object.

Parameters:

• afsObj (afs.PA2Feedback) – The AFS settings to apply

• apply (bool, optional) – Whether to apply the values to the connected device. Default True. If False, just update the local state only (not typical).

setCompressor(compressor: PA2Compressor, apply: bool = True) → None

Sets a PA2’s Compressor settings to match the provided PA2Compressor object.

Parameters:

• compressor (comp.PA2Compressor) – The Compressor settings to apply

• apply (bool, optional) – Whether to apply the values to the connected device. Default True. If False, just update the local state only (not typical).

setCrossover(crossover: PA2Crossover, apply: bool = True) → None

Sets a PA2’s Crossover settings to match the provided PA2Crossover object.

Parameters:

• crossover (xo.PA2Crossover) – The Crossover settings to apply

• apply (bool, optional) – Whether to apply the values to the connected device. Default True. If False, just update the local state only (not typical).

setGenerator(generator: PA2Generator, apply: bool = True) → None

Sets a PA2’s Signal Generator settings to match the provided PA2Generator object.

Parameters:

• generator (gen.PA2Generator) – The Signal Generator settings to apply

• apply (bool, optional) – Whether to apply the values to the connected device. Default True. If False, just update the local state only (not typical).

setGeq(geqObj: PA2Geq, channel: str = 'Stereo', apply: bool = True) → None

Sets a PA2’s specified graphic EQ settings to match the provided PA2Geq object.

Parameters:

• geqObj (geq.PA2Geq) – The GEQ settings to apply

• channel (str, optional) – Which GEQ to apply to, by default dbxdriverack.ChannelsStereo. Must be one of ChannelsStereo, ChannelLeft, ChannelRight.

• apply (bool, optional) – Whether to apply the values to the connected device. Default True. If False, just update the local state only (not typical).

setInputDelay(delay: PA2InputDelay, apply: bool = True) → None

Sets a PA2’s Input Delay settings to match the provided PA2InputDelay object.

Parameters:

• delay (idly.PA2InputDelay) – The Input Delay settings to apply

• apply (bool, optional) – Whether to apply the values to the connected device. Default True. If False, just update the local state only (not typical).

setLimiter(band: str, limiter: PA2Limiter, apply: bool = True) → None

Sets a PA2’s Limiter settings to match the provided PA2Limiter object.

Parameters:

• band (str) –

  Which band to apply the Limiter to. Must be one of:

  dbxdriverack.BandHigh, BandMid, BandLow

• limiter (lim.PA2Limiter) – The Limiter settings to apply

• apply (bool, optional) – Whether to apply the values to the connected device. Default True. If False, just update the local state only (not typical).

setOutputDelay(band: str, delay: PA2OutputDelay, apply: bool = True) → None

Sets a PA2’s Output Delay settings to match the provided PA2OutputDelay object.

Parameters:

• band (str) –

  Which band to apply the Output Delay to. Must be one of:

  dbxdriverack.BandHigh, BandMid, BandLow

• delay (odly.PA2OutputDelay) – The Output Delay settings to apply

• apply (bool, optional) – Whether to apply the values to the connected device. Default True. If False, just update the local state only (not typical).

setPeq(band: str, eq: PA2Peq, apply: bool = True) → None

Sets a PA2’s PEQ settings to match the provided PA2Peq object.

Parameters:

• band (str) –

  Which band to apply the PEQ to. Must be one of:

  dbxdriverack.BandHigh, BandMid, BandLow

• eq (peq.PA2Peq) – The PEQ settings to apply

• apply (bool, optional) – Whether to apply the values to the connected device. Default True. If False, just update the local state only (not typical).

setRta(rtaObj: PA2Rta, apply: bool = True) → None

Sets a PA2’s RTA settings to match the provided PA2Rta object.

Parameters:

• rtaObj (rta.PA2Rta) – The RTA settings to apply

• apply (bool, optional) – Whether to apply the values to the connected device. Default True. If False, just update the local state only (not typical).

setSubharmonic(subharmonic: PA2Subharmonic, apply: bool = True) → None

Sets a PA2’s Subharmonic Synth settings to match the provided PA2Subharmonic object.

Parameters:

• subharmonic (sub.PA2Subharmonic) – The Subharmonic Synth settings to apply

• apply (bool, optional) – Whether to apply the values to the connected device. Default True. If False, just update the local state only (not typical).

unflattenPeq(band: str, block: bool = True) → None

Immediately restore the PEQ to the previous state, before flattened. This uses a device-internal state to operate, so it depends on having no alterations since the last flattening to work.

This command does not update the local state of the PEQ after restoring.

Parameters:

• band (str) –

  Which band’s PEQ to unflatten. Must be one of:

  dbxdriverack.BandHigh, BandMid, BandLow

• block (bool, optional) – Wait until the device confirms completion. Default True.

waitingForUser(isWaiting: bool = False) → None

Allow calling code to indicate that it is waiting for user input and to prevent the timeout from being triggered.

class dbxdriverack.pa2.PA2Device(addr: str)

Bases: object

Represents a DriveRack PA2 device’s model, name, and other characteristics.

addr

The IP address or hostname of the device

Type:

str

name

The name of the device

Type:

str

model

The model of the device

Type:

str

version

The software version of the device

Type:

str