Howto:Adjusting the volume parameters on IP200A, IP110, IP230 and IP150 in Version 6 and later Firmware

From innovaphone wiki
Jump to navigation Jump to search

Summary

This Howto describes the configuration of the volume parameters for user of an IP110, IP200A, IP230 and IP240.

Applies To

This information applies to

  • Inca based IP phones (IP200A, IP110, IP230, IP240, IP150) version 6 and later.

More Information

Problem Details

In some cases the default parameters are not perfectly matching the customer requirements. To adapt to the customers needs, there are a number of volume parameters which can be tuned.

At the phone, there are two amplifiers, one analogue and one digital for each interface, separately adjustable. In total 14 different amplifters.

Amplifers overview.PNG

Handset: 1) analogue, 3) digital with eight levels Handset mic: 5) analogue, 7) digital Handset sidetone: 9) digital with eight levels

Headset: 1) analogue, 4) digital with eight levels Headset mic: 6) analogue, 8) digital Headset sidetone: 10) digital with eight levels

Handsfree loadspeaker: 12) analogue, 13) digital Handsfree mic: 14) analogue, 15) digital

Tip! Try to keep down the analogue amplification.

Configuration of Handset, Headset and Speakerphone Parameters

The acoustical parameters are specified separately for each component

config change INCA_DSP HANDSET ...
config change INCA_DSP HEADSET ...
config change INCA_DSP SPEAKER0 ...

All of the configurable parameters given here have separate values for each volume level (1..8, lowest level first), in case of an incomplete specification the last specified value is used for all remaining levels, e.g.:

/uatt_ATT f1,e4,d7,cb,bf is equivalent to /uatt_ATT f1,e4,d7,cb,bf,bf,bf,bf
/uatt_ATT bf is equivalent to /uatt_ATT bf,bf,bf,bf,bf,bf,bf,bf

All parameters for one component must be entered the usual way with one "config change" command, for example

  http://172.16.16.128/!config change INCA_DSP HANDSET /afe_arcr_HOC1 4 /afe_acr_atcr_MIC 4

  http://172.16.16.128/!config activate

  http://172.16.16.128/!config write

The "config activate" command applies the new parameters on the fly, even if the addressed component is currently in use. Thus the result of a change can be checked on an active connection.

A dump of the built-in parameter is written to trace buffer when the driver is told to do verbose traces by the command line

 config change INCA_DSP /mtrace ...


To remove mtrace:

config change INCA_DSP
config write
config activate

Look at examples under "Speakerphone Speaker" and "Digital Outbound Direction" for increasing volume at handset, headset and loadspeaker.


Side tone gain

The side tone gain (the volume of your own voice fed back into your speaker) is volume level dependant and available for the handset and the headset only. It is set by the following command flags:

 /uatt_ATT <gain1>,<gain2>,...<gain8>

The default for both handset and headsets ist

 /uatt_ATT f1,e4,d7,cb,bf,a1,8f,80

The gain settings can be taken from the following table

Gain dB -0.5 -1 -1.5 -2 -2.5 -3 -3.5
0 ff f1 e4 d7 cb bf b5 ab
-4 a1 98 8f 87 80 79 72 6b
-8 65 60 5a 55 50 4c 48 44
-12 40 3c 39 36 33 30 2d
-16 28 26 24 22 20 1e 1c 1b
-20 19 18 16 15 14 13 12 11
-24 10 0f 0e 0d 0c 0c 0b 0a
-28 0a 09 09 08 08 07 07 06
-32 06 06 05 05 05 04 04 04
-36 04 03 03 03 03 03 02 02
-40 02 02 02 02 02 01 01 01
-44 01 01 01 01 01 01 01 01
-48 01 00 00 00 00 00 00 00


Analogue to digital / digital to analogue gain

The external i/o devices (microphone and loudspeaker) are attached to the phones digital voice processor using an A/D converter. To normalize the signal levels (such as the different microphone levels from the handset and a headset), an analogue front end is used. This shall be used to make sure all I/O sources used have equivalent levels towards the A/D converter. The analogue front end is not meant to change the overall volume. This is done in the digital amplifier. So if the phone is e.g. too loud overall, then don’t tweak the analogue front end. However, if e.g. the headset is too loud compared to the handset, then adjust analogue front end parameters for the headset.


Analogue Amplification

As described above, the analogue settings are used to adapt a single I/O source to the overall signal level. Please note that this is normally not required anyway as the handset and speakerphone are already properly adjusted. However, when attaching headsets, some tweaking of the analogue gains may be useful.


Microphone

The microphone amplification is set by

/afe_acr_atcr_MIC <volume>

Where <volume> is in the range of 1..7.

Handset default is /afe_acr_atcr_MIC 5.

Headset default is /afe_acr_atcr_MIC 6.

Speakerphone default is /afe_acr_atcr_MIC 6.


Handset Speaker Volume

/afe_arcr_HOC1 <gain>

Where <gain> is in the range of 1..9 (1 == maximum volume)

Default is /afe_arcr_HOC1 3.


Headset Speaker

/afe_arcr_HOC2 <gain>

Where <gain> is in the range of 1..9 (1 == maximum volume)

Default is /afe_arcr_HOC2 3.


Speakerphone Speaker

/afe_arcr_LSC <gain>

Where <gain> is in the range of 1..12 (1 == maximum volume)

Default is /afe_arcr_LSC 4.

Example for lifting up the volume on speakerphone:

  http://172.16.16.128/!config change INCA_DSP SPEAKER0 /afe_arcr_LSC 1

  http://172.16.16.128/!config activate
  http://172.16.16.128/!config write


Digital Amplification

Digital gains are used to change the overall volume of a phone. This is somewhat cumbersome. Then again, it is rarely required.


Digital Inbound Direction Digital Inbound increase/decrease the volume from your own speach both to the remote party and the feedback to your own speaker.

/afe_IFG1  <gain>

Handset default is /afe_IFG1 32f5.

Headset default is /afe_IFG1 47fb.

Speakerphone default is /afe_IFG1 392d.


Digital Outbound Direction Digital Outbound increase/decrease the eight volume steps you use for manuel adjusting with arrow keys on the phone. One value is given for each step.

/afe_IFG2  <gain1>,<gain2>,...<gain8>

Handset default /afe_IFG2 036c,066c,096c,136c,166c,196c,1ca8,2027.

Headset default /afe_IFG2 036c,066c,096c,136c,166c,196c,1ca8,2027.

Speakerphone default /afe_IFG2 196C.

Example for lifting up the volume on handset and headset:

  http://172.16.16.128/!config change INCA_DSP HANDSET /afe_IFG2 0519,0814,0ccd,1449,1b0d,2027,3215,4027

  http://172.16.16.128/!config activate

  http://172.16.16.128/!config change INCA_DSP HEADSET /afe_IFG2 0519,0814,0ccd,1449,1b0d,2027,3215,4027

  http://172.16.16.128/!config activate
  http://172.16.16.128/!config write


The digital gain settings can be taken from the following table

Gain dB -0.5 -1 -1.5 -2 -2.5 -3 -3.5
12 7fff 78d7 7215 6bb3 65ad 5ffd 5a9e 558c
8 50c3 4c3f 47fb 43f4 4027 3c90 392d 35fa
4 32f5 301b 2d6b 2ae0 287a 2637 2413 220f
0 2027 1e5b 1ca8 1b0d 198a 181c 16c3 157d
-4 1449 1327 1215 1112 101d 0f36 0e5d 0d8f
-8 0ccd 0c15 0b68 0ac5 0a2b 0999 0910 088e
-12 0814 07a0 0733 06cc 066a 060e 05b8 0566
-16 0519 04d0 048b 044a 040c 03d2 039c 0368
-20 0337 0309 02de 02b5 028e 0269 0247 0226
-24 0207 01ea 01cf 01b5 019d 0185 0170 015b
-28 0148 0135 0124 0114 0104 00f6 00e8 00db
-32 00cf 00c3 00b8 00ae 00a4 009b 0092 008a
-36 0082 007b 0074 006e 0068 0062 005c 0057
-40 0052 004e 0049 0045 0041 003e 003a 0037



Configuration of Ring Tone and Notification Tone Parameters

NB: see Howto:Configure Loud Ringtone for noisy environments on IP150 for IP150 related ringing tone settings!

The ring and notification tone parameters are specified by

   config change INCA_DSP RINGER ...

All the parameters configure a single value and are given here with their default value.

Basic Ring tone gain

The default for the ring tone gain is

  /ring_afe_IFG2  2027

The gain settings can be taken from the following table

Gain dB -0.5 -1 -1.5 -2 -2.5 -3 -3.5
12 7fff 78d7 7215 6bb3 65ad 5ffd 5a9e 558c
8 50c3 4c3f 47fb 43f4 4027 3c90 392d 35fa
4 32f5 301b 2d6b 2ae0 287a 2637 2413 220f
0 2027 1e5b 1ca8 1b0d 198a 181c 16c3 157d
-4 1449 1327 1215 1112 101d 0f36 0e5d 0d8f
-8 0ccd 0c15 0b68 0ac5 0a2b 0999 0910 088e
-12 0814 07a0 0733 06cc 066a 060e 05b8 0566
-16 0519 04d0 048b 044a 040c 03d2 039c 0368
-20 0337 0309 02de 02b5 028e 0269 0247 0226
-24 0207 01ea 01cf 01b5 019d 0185 0170 015b
-28 0148 0135 0124 0114 0104 00f6 00e8 00db
-32 00cf 00c3 00b8 00ae 00a4 009b 0092 008a
-36 0082 007b 0074 006e 0068 0062 005c 0057
-40 0052 004e 0049 0045 0041 003e 003a 0037


Notification Tone Gains

- call waiting (non default)

   /notify_knock_tgen_coeff_G01 040c

- announcement call connected

   /notify_announce_tgen_coeff_G01 0814

- multicast call connected

   /notify_broadcast_tgen_coeff_G01 0814

- powerdialled call connected

   /notify_powerdial_tgen_coeff_G01 0814

- intrusion call connected when no other call was active already

   /notify_intrude_tgen_coeff_G01 040c

- pickup/partner pending

   /notify_pickup_tgen_coeff_G01 040c

Since V9hotfix28 the final volume of the "pickup/partner pending" notification tone is bound to the volume configured for the internal ring tone. The coefficient default has changed to 0814 and defines the basic gain only. The final volume is set in the speaker amplifier according to the ring tone volume.

The gain settings can be taken from the following table

Gain dB -0.5 -1 -1.5 -2 -2.5 -3 -3.5
0 7fff 78d7 7215 6bb3 65ad 5ffd 5a9e 558c
-4 50c3 4c3f 47fb 43f4 4027 3c90 392d 35fa
-8 32f5 301b 2d6b 2ae0 287a 2637 2413 220f
-12 2027 1e5b 1ca8 1b0d 198a 181c 16c3 157d
-16 1449 1327 1215 1112 101d 0f36 0e5d 0d8f
-20 0ccd 0c15 0b68 0ac5 0a2b 0999 0910 088e
-24 0814 07a0 0733 06cc 066a 060e 05b8 0566
-28 0519 04d0 048b 044a 040c 03d2 039c 0368
-32 0337 0309 02de 02b5 028e 0269 0247 0226
-36 0207 01ea 01cf 01b5 019d 0185 0170 015b
-40 0148 0135 0124 0114 0104 00f6 00e8 00db
-44 00cf 00c3 00b8 00ae 00a4 009b 0092 008a
-48 0082 007b 0074 006e 0068 0062 005c 0057
-52 0052 004e 0049 0045 0041 003e 003a 0037


- experimental: gain for the single frequencies of the compound tone

   /notify_tgen_coeff_G_123 287a

- experimental: saturation gain of the compound tone

   /notify_tgen_coeff_GS 287a
   the maximum saturation gain is 24 dB (7fff),
   in the coefficient table above 0 dB must be read
   as 24 dB, -4 as 20 dB and so on.


Transparent tones merged into conversation

- conference, intrusion, default call waiting ...

   /transtone_tgen_coeff_G01 040c

The gain settings can be taken from the following table

Gain dB -0.5 -1 -1.5 -2 -2.5 -3 -3.5
0 7fff 78d7 7215 6bb3 65ad 5ffd 5a9e 558c
-4 50c3 4c3f 47fb 43f4 4027 3c90 392d 35fa
-8 32f5 301b 2d6b 2ae0 287a 2637 2413 220f
-12 2027 1e5b 1ca8 1b0d 198a 181c 16c3 157d
-16 1449 1327 1215 1112 101d 0f36 0e5d 0d8f
-20 0ccd 0c15 0b68 0ac5 0a2b 0999 0910 088e
-24 0814 07a0 0733 06cc 066a 060e 05b8 0566
-28 0519 04d0 048b 044a 040c 03d2 039c 0368
-32 0337 0309 02de 02b5 028e 0269 0247 0226
-36 0207 01ea 01cf 01b5 019d 0185 0170 015b
-40 0148 0135 0124 0114 0104 00f6 00e8 00db
-44 00cf 00c3 00b8 00ae 00a4 009b 0092 008a
-48 0082 007b 0074 006e 0068 0062 005c 0057
-52 0052 004e 0049 0045 0041 003e 003a 0037


Locally Generated Calling Tones

- calling, ringback, busy ...

   /calltone_dtmf_tx_coeff_ATT12 7f

The coefficients for the output attenuation can be taken from the following table

Attenuation dB +0.5 +1 +1.5 +2 +2.5 +3 +3.5
0 7f 79 72 6c 66 60 5b 56
4 51 4c 48 44 40 3d 39 36
8 33 30 2d 2b 28 26 24 22
12 20 1e 1d 1b 1a 18 17 15
16 14 13 12 11 10


Local Playback of DTMF Tones

- levels for the single frequencies of the DTMF tone and output attenuation

   /playback_dtmf_tx_coeff_LEV12 28
   /playback_dtmf_tx_coeff_ATT12 c0

The coefficients for the tone levels and the output attenuation can be taken from the following tables

Level dB -0.5 -1 -1.5 -2 -2.5 -3 -3.5
0 7f 79 72 6c 66 60 5b 56
-4 51 4c 48 44 40 3d 39 36
-8 33 30 2d 2b 28 26 24 22
-12 20 1e 1d 1b 1a 18 17 15
-16 14 13 12 11 10 0f 0e 0e
-20 0d 0c 0b 0b 0a 0a 09 09
-24 08 08 07 07 06 06 06 05
-28 05 05 05 04 04 04 04 03
-32 03 03 03 03 03 02 02 02
-36 02 02 02 02 02 02 01 01
-40 01 01 01 01 01 01 01 01
-44 01 01 01 01 01 01 01 01
-48 01 00


Attenuation dB +0.5 +1 +1.5 +2 +2.5 +3 +3.5
0 7f 79 72 6c 66 60 5b 56
4 51 4c 48 44 40 3d 39 36
8 33 30 2d 2b 28 26 24 22
12 20 1e 1d 1b 1a 18 17 15
16 14 13 12 11 10

Related Articles