Difference between revisions of "Distributed Automatic Volume Control (DAVC) (SIP)"

Latest revision as of 13:35, 27 June 2024

DAVC example

The Distributed Automatic Volume Control (DAVC) is an algorithm which is using one or more microphones ("AVC Source") to measure the ambient audio/noise level, and adjusts the loudspeaker output level of the PA amplifier ("AVC Receiver") according to the ambient audio level.

The AVC Source is the input device with the listening microphone used for measuring the ambient noise level. This is typically an EINS-1 microphone unit, but any Turbine Device with microphone can be used. The AVC Source sends its microphone measurements to the AVC Receiver.
The AVC Receiver is the output device that is used for playing audio, typically an ENA amplifier, or a PA Interface such as a TKIS-kit or TKIE-kit.

DAVC is not operating while audio is actively playing at the AVC Receiver. With the default configuration, it needs minimum 100ms of silence to be able to adjust the gain by 1dB. This should work just fine with normal speech, but AVC will not adjust while playing constant music.

Software requirements

The Distributed Automatic Volume Control (DAVC) is supported as from Turbine firmware v. 4.11.

Configuration

AVC Source

The AVC Source is the input device with the listening microphone used for measuring the ambient noise level. This is typically an EINS-1 microphone unit, but any Turbine Device with microphone can be used.

Log in to the web interface of the AVC Source, and enable Advanced Configuration. Select Sip Configuration > DAVC. Check the settings Enable DAVC and Device is AVC Source. Uncheck the other options.

Under AVC Receiver Configuration add the IP address and a descriptive name of the AVC Receiver(s):

Configuration of the AVC Source

On the AVC Source:

The checkbox "Enable DAVC Algorithm" must be unchecked
The local "AVC feature" on the AVC source MUST be disabled. See AVC feature
Host name is not supported, only IP Address. Due to this, the AVC Receiver should have static IP address
Reboot the device for all the DAVC settings to take effect

AVC Receiver

The AVC Receiver is the output device that is used for playing audio, typically an ENA amplifier, or a PA Interface such as a TKIS-kit or TKIE-kit.

Log in to the web interface of the AVC Receiver, and enable Advanced Configuration. Select Sip Configuration > DAVC. Check the settings Enable DAVC, Device is AVC Receiver and Enable DAVC Algorithm.

If the AVC Receiver is an ENA Amplifier, the Master Volume [-40 - 2] dB sets the base gain of the two output channels. Set a low base gain when using "Positive Mode", and a high base gain when using "Negative Mode" (see below explanation).

AVC Receiver configuration

The AVC Algorithm has a set of parameters for tuning the feature:

AVC Algorithm configuration

Adjustment Mode:
- Positive Mode: Gain adjustment is from zero at AVC threshold level and adjusted positive. AVC Receiver should have a low base gain.
- Negative Mode: Gain adjustment is from zero at AVC max level and adjusted with negative gain downwards. AVC Receiver should have a high base gain.
Lower Threshold: Threshold level for the AVC to start working. Valid range: 30-80 dBA. Default is 55 dBA.
Upper Threshold: Threshold level for the AVC to stop working. Valid range: 60-120 dBA. Default is 100 dBA.
Attack Rate: How quickly the AVC adjusts gain on raising ambient audio level. Range: 1..100 dBA/sec. Default is 10 dBA/sec.
Decay Rate: How quickly the AVC adjusts gain on falling ambient audio level. Range: 1..100 dBA/sec. Default is 10 dBA/sec.
Hysteresis: Hysteresis around previous set ambient audio level before doing adjustments. Range: 1..10 dBA/sec. Default is 3 dBA.
Far-End Lockout Time: When playing audio in AVC zone (far-end-signal) AVC adjustments are locked. When there is a pause in the far-end-signal, adjustment commences after this lockout-time. Range: 1..100. Resolution is 100 ms. Default is "1" (= 100 ms).

Under AVC Source Devices enter information about the remote microphone device(s):

Enter directory number of the AVC Source microphone

Source Number: The directory Number of the remote microphone device
Audio Channels: Which audio channel(s) on this device should be effected by signals from the remote AVC Source
Source Selection Strategy: The AVC Receiver will receive ambient audio levels or Gain adjust values from a number of AVC Sources. This configures the selection strategy for final gain adjusts on AVC Receiver.
- The different settings are: Highest, Average, Average Mid. "Average" requires two or more AVC Sources. "Average Mid" will remove high and low values if more than 4 AVC sources, and average rest.

If the AVC receiver is a TKIS-2 or TKIS-2 based device (e.g. IP Loudspeaker), make sure the inbuilt AVC is disabled.

Reboot the device for all the DAVC settings to take effect.

Firewall settings

On the AVC Receiver, AudioData (UDP port 5035) must be enabled in the Firewall.

Monitoring and Tuning the DAVC feature

Play test signals from the ENA amplifier for tuning volume/gain adjustments
The Test & Demo Tool can be used to monitor the performance of the DAVC feature, and as a tool during the commissioning of the DAVC.

@@ Line 1: / Line 1: @@
 {{S|cons=}}
+[[file:DAVC_Block_SIP.png|thumb|700px|DAVC example ]]
 The '''Distributed Automatic Volume Control (DAVC)''' is an algorithm which is using one or more microphones ("AVC Source") to measure the ambient audio/noise level, and adjusts the loudspeaker output level of the PA amplifier ("AVC Receiver") according to the ambient audio level.
-The '''AVC Source''' is the input device with the listening microphone used for measuring the ambient noise level. This is typically an EINS-1, but any [[:Category:Stations#Turbine_stations|Turbine Device]] with microphone can be used.
+*The '''AVC Source''' is the input device with the listening microphone used for measuring the ambient noise level. This is typically an EINS-1  microphone unit, but any [[:Category:Stations#Turbine_stations|Turbine Device]] with microphone can be used. The AVC Source sends its microphone measurements to the AVC Receiver.
+*The  '''AVC Receiver''' is the output device that is used for playing audio, typically an [[:category:Public Address - Network amplifiers|ENA amplifier]], or a PA Interface such as a [[TKIS-2|TKIS-kit]] or [[TKIE-2|TKIE-kit]].
-The  '''AVC Receiver''' is the output device that is used for playing audio, typically an [[:category:Public Address - Network amplifiers|ENA amplifier]], or a PA Interface such as a [[TKIS-2|TKIS-kit]] or [[TKIE-2|TKIE-kit]].
+DAVC is not operating while audio is actively playing at the AVC Receiver. With the default configuration, it needs minimum 100ms of silence to be able to adjust the gain by 1dB. This should work just fine with normal speech, but ''AVC will not adjust while playing constant music''.
-DAVC is not operating while audio is active on the AVC Receiver. With the default configuration, it needs minimum 100ms of silence to be able to adjust the gain by 1dB. This should work just fine with normal speech, but AVC will not adjust while playing constant music.
+==Software requirements==
+The '''Distributed Automatic Volume Control (DAVC)''' is supported as from Turbine firmware v. 4.11.
-==Software requirements==
+== Configuration ==
+===AVC Source ===
+The '''AVC Source''' is the input device with the listening microphone used for measuring the ambient noise level. This is typically an EINS-1 microphone unit, but any [[:Category:Stations#Turbine_stations|Turbine Device]] with microphone can be used.
-*The '''Distributed Automatic Volume Control (DAVC)''' is supported as from:
+[[Logging into an IP Station|Log in to the web interface]] of the AVC Source, and enable [[Advanced Configuration Mode (SIP)|Advanced Configuration]]. Select '''Sip Configuration''' > '''DAVC'''.
-**Turbine firmware v. 4.11
+Check the settings '''Enable DAVC''' and '''Device is AVC Source'''. Uncheck the other options.
-==Web Configuration==
+Under '''AVC Receiver Configuration''' add the IP address and a descriptive name of the AVC Receiver(s):
-To configure the DAVC, [[Logging into an IP Station|log in to the web interface]] of the AVC Source or AVC Receiver, and select '''Sip Configuration''' > '''DAVC Settings''':
-[[File:SIP_DAVC.png|thumb|left|622x622px]]
+[[File:DAVC Source2.PNG|thumb|left|700px|Configuration of the AVC Source]]
 <br style="clear:both;" />
-'''Distributed Automatic Volume Control (AVC) Configuration''':
+{{note|On the AVC Source:
+* The checkbox "'''Enable DAVC Algorithm'''" must be unchecked
+*The local "'''AVC feature'''" on the AVC source MUST be disabled. See [[Automatic Volume Control (AVC)|AVC feature]]
+*Host name is not supported, only IP Address. Due to this, the AVC Receiver should have static IP address
+* '''Reboot''' the device for all the DAVC settings to take effect }}
-*'''Enable Distributed AVC''': Activated DAVC when checked
+===AVC Receiver ===
-*'''Device is AVC Receiver''': This device is a "AVC Receiver"
+The  '''AVC Receiver''' is the output device that is used for playing audio, typically an [[:category:Public Address - Network amplifiers|ENA amplifier]], or a PA Interface such as a [[TKIS-2|TKIS-kit]] or [[TKIE-2|TKIE-kit]].
-*'''Device is AVC Source''': This device is a "AVC Source" (listening microphone)
-*'''Master Volume [-40 - 2] dB''': Sets the base gain when the "AVC Receiver" is an ENA Amplifier. Set a low base gain when using "Positive Mode", and a high base gain when using "Negative Mode".
-*'''Enable AVC Algorithm''': The AVC Algorithm must be enabled either on all AVC Sources or on all AVC Receivers
+[[Logging into an IP Station|Log in to the web interface]] of the AVC Receiver, and enable [[Advanced Configuration Mode (SIP)|Advanced Configuration]]. Select '''Sip Configuration''' > '''DAVC'''.
+Check the settings '''Enable DAVC''', '''Device is AVC Receiver''' and '''Enable DAVC Algorithm'''.
-'''AVC Algorithm''' (visible only when '''Enable AVC Algorithm''' is checked):
+If the AVC Receiver is an ENA Amplifier, the '''Master Volume [-40 - 2] dB''' sets the base gain of the two output channels. Set a low base gain when using "Positive Mode", and a high base gain when using "Negative Mode" (see below explanation).
+[[File:DAVC Receiver2.PNG|thumb|left|700px|AVC Receiver configuration]]
+<br style="clear:both;" />
+The '''AVC Algorithm''' has a set of parameters for tuning the feature:
+[[File:DAVC Algorithm.PNG|thumb|left|700px|AVC Algorithm configuration]]
+<br style="clear:both;" />
 *'''Adjustment Mode''':
 **'''Positive Mode''': Gain adjustment is from zero at AVC threshold level and adjusted positive. AVC Receiver should have a low base gain.
 **'''Negative Mode''': Gain adjustment is from zero at AVC max level and adjusted with negative gain downwards. AVC Receiver should have a high base gain.
-*'''Lower Threshold [-95 - 0 dB]''': The microphone signal level where AVC starts to work. Below this level no adjustment is done, and Audio Receivers should work on default base gain
+* '''Lower Threshold''': Threshold level for the AVC to start working. Valid range: 30-80 dBA. Default is 55 dBA.
-*'''Upper Threshold [-95 - 0 dB]''': The microphone signal level where AVC stops to work. Above this level, no adjustment is done. The difference between upper and lower threshold also defines the working range for AVC gain adjustments. In negative AVC mode this also defined the ambient level where configured base output gain is reached (offset adjustment is zero)
+* '''Upper Threshold''': Threshold level for the AVC to stop working. Valid range: 60-120 dBA. Default is 100 dBA.
-*'''Attack Rate [0.1 - 200 dB/sec]''': This determines how quickly the AVC adjusts gain on raising ambient audio level
+* '''Attack Rate''': How quickly the AVC adjusts gain on raising ambient audio level. Range: 1..100 dBA/sec. Default is 10 dBA/sec.
-*'''Decay Rate [0.1 - 200 dB/sec]''': This determines how quickly the AVC adjusts gain on falling ambient audio level
+* '''Decay Rate''': How quickly the AVC adjusts gain on falling ambient audio level. Range: 1..100 dBA/sec. Default is 10 dBA/sec.
-*'''Hysteresis [0.00 - 6.00 dB]''': Hysteresis around previous set ambient audio level before doing adjustments
+* '''Hysteresis''': Hysteresis around previous set ambient audio level before doing adjustments. Range: 1..10 dBA/sec. Default is 3 dBA.
-*'''Far-End Lockout Time [0.0 - 1.0 sec]''': When playing audio in AVC Zone (far-end-signal) all AVC adjustments are locked. When there is a pause in far-end-signal, adjustment commences after this lockout-time
+* '''Far-End Lockout Time''': When playing audio in AVC zone (far-end-signal) AVC adjustments are locked. When there is a pause in the far-end-signal, adjustment commences after this lockout-time. Range: 1..100. Resolution is 100 ms. Default is "1" (= 100 ms).
-'''AVC Source Devices''' (available only when '''Device is AVC Receiver''' is checked):
+Under '''AVC Source Devices''' enter information about the remote microphone device(s):
+[[File:DAVC SourceDevice.PNG|thumb|left|700px|Enter directory number of the AVC Source microphone]]
+<br style="clear:both;" />
+*'''Source Number''': The directory Number of the remote microphone device
+*'''Audio Channels''': Which audio channel(s) on this device should be effected by signals from the remote AVC Source
 *'''Source Selection Strategy''': The AVC Receiver will receive ambient audio levels or Gain adjust values from a number of AVC Sources. This configures the selection strategy for final gain adjusts on AVC Receiver.
 **The different settings are: '''Highest, Average, Average Mid'''. "Average" requires two or more AVC Sources. "Average Mid" will remove high and low values if more than 4 AVC sources, and average rest.
-*'''Source Directory Number''': The directory Number of the remote microphone devices
+{{Note|If the AVC receiver is a [[TKIS-2]] or TKIS-2 based device (e.g. [[:Category:Intercoms_and_Devices|IP Loudspeaker]]), make sure the inbuilt [[Automatic Volume Control (AVC)|AVC is disabled]].}}
-*'''Audio Channels''': Which audio channel(s) on this device should be effected by signals from the remote AVC Source
-'''AVC Receiver Configuration''' (available only when '''Device is AVC Source''' is checked):
-*Enter the IP Address of the "AVC Receiver" and a descriptive name. Press "+" to add, then Save.
-{{Note|Host name is not supported, only IP Address. Due to this, the AVC Receiver should have static IP address }}<br />{{Note|On the AVC Receiver, AudioData UDP port 5035 must be enabled in the [[Turbine Firewall|Firewall]]}}
+{{Note|'''Reboot''' the device for all the DAVC settings to take effect.}}
-<br />
-{{Note|If your AVC receiver is a TKIS-2 or TKIS-2 based device (IP Loudspeaker), you must disable the inbuilt AVC from the Audio Settings tab}}
-==Example Configuration==
+==== Firewall settings ====
-In this example one channel of an ENA Amplifier is used in one zone, and the other channel is used in another zone. There is one EINS-1 in each zone, measuring the ambient noise level in the zone. The EINS-1 with directory number 123 must be configured to adjust the channel 1 output of the ENA Amplifier, while the EINS-1 with directory number 124 must adjust channel 2.
+On the AVC Receiver, '''AudioData''' (UDP port 5035) must be enabled in the [[Firewall (IP Stations)|Firewall]].
-[[File:1200px-SIP_DAVC_Block_example.png|frameless|585x585px]]<br />
-===ENA Amplifier configuration===
-The ENA Amplifier is configured to be the Audio Receiver. Adjustment Mode is set to "Negative", and the two TKIS units are configured to adjust the associated channel of the ENA Amplifier.
-[[File:SIP_Amplifier_DAVC.png|thumb|left|693x693px]]
+=== Monitoring and Tuning the DAVC feature ===
+* [[ENA_Amplifier_Configuration_(SIP)#Play_Media|Play test signals from the ENA amplifier]] for tuning volume/gain adjustments
+* The [[Turbine_Test_and_Demo_Application#AVC_Gain_adjustment_data|Test & Demo Tool]] can be used to monitor the performance of the DAVC feature, and as a tool during the commissioning of the DAVC.
-<br style="clear:both;" />
+<br>
-===EINS-1 configuration===
+== Related articles ==
-Both EINS-1 units must be configured to report ambient noise level to the ENA Amplifier at IP 10.9.8.117:
+* DAVC in ICX-AlphaCom based systems: [[Distributed Automatic Volume Control (DAVC)]]
-[[File:SIP DAVC Source.png|thumb|left|570x570px]]
-<br style="clear:both;" />
 [[Category:SIP intercom - Configuration]]