Analog Channels| Call Recording Reference

Analog channel configuration - Initial steps

For VSLogger configuration purposes, the term analog channel refers to recording ports of the analog voice boards such as AudioCodes SmartWorks analog boards or Synway analog voice boards. These boards can be used to record from different analog audio sources, such as:

analog phone lines
Microphone lines
Analog audio lines e.g. outputs from PC, Radio etc

The following steps assumed to be completed prior configuration described in this section:

AudioCodes SmartTab and/ or Synway drivers installed.
Audio codes and/or Synway boards installed in the recorder PC and recognized by the drivers
VSLogger server software installed
GUI or CLI Tool were used to enable smart (AudioCode SmartWorks) or shcti (Synway) hardware. refer to config hw- Hardware

CLI (Command Line Interface)
(How to use CLI Tool - refer to CLI Tool Overview)

GUI (Graphical User Interface)

AudioCodes SmartWorks analog boards (hw smart) channels

For this example, we assume that Administrator enabled only hw smart, and recorder has single 4 channel analog board (LDAXXXX) installed in the system. After the VSLogger software reload, Administrator can expect following channel list.

cli>(config)
->channel list
channels
----------------------------------------
ch# |type |hwch# |hw |enabled
----------------------------------------
1 SMART_LD 0 smart y
2 SMART_LD 1 smart y
3 SMART_LD 2 smart y
4 SMART_LD 3 smart y

cli>(config)

1) Click on the dropdown window near the gear icon on the top right
2) Click setup
3) Click Channels
4) Click on the dropdown near the hardware you have enabled

Gallery: AC-GUI-1

Open Individual channel in configuration mode.

cli>(config)
->channel 1
cli>(config-ch_1)

Click Edit on the channel to be configured

Display current channel setting.

->show
ch# 1
----------------------------------------
hwnum: 0
hw: smart
type: SMART_LD
name: 1 test from cli
enabled: y
licgroup: none
allowenbl: n
compression: gsm
dsp: n
agc: y
gain: 10 (dB)
highthrld: 0 (dBm*10)
lowthrld: 0 (dBm*10)
minactivity: 1 (secs)
maxsilence: 10 (secs)
events:
event [vox]
actions:
[1] start
[2] stop
beep on: n
beep period: 30 (secs)
beep frequency: 1400 (Hz)
beep length: 600 (msecs)
beep volume: -10 (Dbm)
voltage low: -16 (V)
voltage high: 10 (V)
de-bouncing time: 50 (msecs)
----------------------------------------
cli>(config-ch_1)

General settings:

Enable: enables/disables recording channel

Name: Channel label/description identifier

License Group: Dynamic License group, fixed licenses use “None”

Compression: Recording file compression (mlaw, adpcm, gsm)

Gain: Recording volume (db)

AGC: Automatic Gain Control

Source: Recording source (phone, radio, mic)

VOX Parameters:

Threshold High: VOX activity higher than this threshold for a duration longer than specified by “Min Activity” will activate recording with VOX start/stop events.

Threshold Low: VOX activity lower than this threshold for a duration longer than specified by “Max Silence” will stop recording with VOX start/stop events.

Max Silence: This parameter specifies how many seconds of silence before the recording ends. If VOX levels are less than "Low threshold" for this amount of time, stop recording will be triggered.

Min Activity: This parameter specifies how many seconds of activity before the recording begins. If VOX levels are greater than "High threshold" for this amount of time, recording will be triggered.

Display configuration commands available for this channel.

->?
agc [y|n] - enable/disable AGC
allowenbl [y|n] - allow enable/disable channel (only if dynamic license group set)
beep - beep configuration
compress [ulaw|adpcm|gsm] - set channel compression codec
dsp [y|n] - enable/disable channel hw compression
name [...] - channel description
enable [y|n] - enable/disable channel
event [id] - channel events configuration
exit - exit current configuration mode
gain [db] - set gain
help|? - embedded help
maxsilence [sec] - max silence timeout(sec)
minactivity [sec] - min activity timeout (sec)
highthrld [Dbx10] - high threshold (Dbx10)
lowthrld [Dbx10] - low threshold (Dbx10)
licgroup [none|1-n] - set channel license group
highvolt [] - voltage high (V)
lowvolt [] - voltage low (V)
debouncetm [] - de-bouncing time (msec)
copy [1-n] - copy channel settings to range of channels [range]
show - show current settings
test voxlevel [0-600] - start/stop vox level test (time in sec, default 60 sec)
verification - verification configuration
cli>(config-ch_1)

For details about parameters common to all types of channels - refer to config channel Common Parameters

Verification Settings:

Enabled: enable/disable verification mode

Play Prompt: Play “Welcome” verification prompt before recording

Check ID: Check Interactive Voice Recording (IVR) ID

Check PIN: Check Interactive Voice Recoding (IVR) pin code

ID1: Account reference number 1

ID2: Account reference number 2

Allow Resubmit: Allows reference number to be resubmitted

Get Offhook: Gets offhook recording channel

Generate Verification Number: Generates verification number after recording is done

Play Verification Number: Plays verification number after recording is done (never, once, twice)

Stop Key: Stop recording when key is pressed

Volume: Playback volume of verification prompts

Parameters specific to this channel type (LDAXXX) only

Command format	Description	Extra Notes
highvolt []	enable/disable AGC	Used for Loop On and Loop Off event detection. LV threshold high: 60V to –60V, default = +16V
lowvolt []	voltage low (V)	Used for Loop On and Loop Off event detection. LV threshold low: -60V to 60V, default = -16V
debouncetm []	de-bouncing time (msec)	Used for Loop On and Loop Off event detection. De-bouncing( deglitch) time in unit of 10ms, valid range is 10 ms to 2550 ms, default 50ms

LDAXXX boards provide the user the ability to set the thresholds of voltage high and voltage low. This allows the custom definition of the three loop voltage states ABOVE, BELOW, and MIDDLE (e.g. ONHOOK,
REVERSE, and OFFHOOK states are the common terms for ABOVE, BELOW, and MIDDLE states). Refer to Smart Tap Boards documentation and API.

Synway Voltage Parameters:

Line Voltage: Voltages detected above/below this threshold will cause a trigger start/stop events

Ignore Line Voltage: Ignore Voltage detection, useful for radio and microphone

AudioCodes has a slightly different set of parameters for Voltage:

AudioCodes Voltage Parameters:

High Voltage: High voltage threshold for on/off hook events

Low Voltage: Low voltage threshold for on/off hook events

Debounce Time: debounce time for ring and loop events

Synway analog boards (hw shcti) channels

For this example, we assume that Administrator enabled only hw shcti, and recorder has single 8 channel analog board (ATPXXXX) installed in the system. After reload, Administrator can expect following channel list.

cli>(config)
->channel list
channels
----------------------------------------
ch# |type |hwch# |hw |enabled
----------------------------------------
1 SYNWAY_ATP 0 shcti y
2 SYNWAY_ATP 1 shcti y
3 SYNWAY_ATP 2 shcti y
4 SYNWAY_ATP 3 shcti y
5 SYNWAY_ATP 4 shcti y
6 SYNWAY_ATP 5 shcti y
7 SYNWAY_ATP 6 shcti y
8 SYNWAY_ATP 7 shcti n

cli>(config)

Clicking on the Edit button will pop up an event configuration window.

Actions can be set for each of the following events:

Busytone: busy tone detected

Dialtone: dial tone detected

DTMF: DTMF sequence detected

External: external event detected

Loopdrop: loop drop event detected (analog channels only, POTS)

Looponoff: loop on/off event detected (analog channels only, POTS)

Ring: ring event detected

Vox: Vox/Radio event detected

Actions that can be set on any event occurence:

START: Begin recording

STOP: Stop recording

SET: input a parameter for “Key”, “Value”, or “Ref”

MUTEON: Begin muting current recording

MUTEOFF: Stop muting current recording

Action Parameters (optional):

Key: D-channel or DTMF, DTMF, button, led, or lookup value

Field: D-channel only, set recording field: Caller ID, Dialed Number, Note, Session ID, Extension, or Direction

Value: D-channel only, set recording field value

Ref: D-channel only, action reference, links “start” and “stop” actions

Gallery: AC-GUI-8

Beep Parameters:

Beep: enables/disables beeping

Period: Duration between Beeps (seconds)

Frequency: what the frequency of the beep is (MHz)

Length: How long the beep lasts (milliseconds)

Volume: how loud the beep is (db)

Display current channel setting.

->show
ch# 1
----------------------------------------
hwnum: 0
hw: shcti
type: SYNWAY_ATP
name:
enabled: y
licgroup: none
allowenbl: n
compression: mlaw
dsp: n
agc: y
gain: 0 (dB)
lowthrld: -400 (dBm*10)
highthrld: -350 (dBm*10)
minactivity: 1 (secs)
maxsilence: 10 (secs)
events:
event [loopdrop]
actions:
[1] stop
event [looponoff]
actions:
[1] start
[2] stop
----------------------------------------

cli>(config-ch_1)

Display configuration commands available for this channel.

cli>(config-ch_1)
->?
agc [y|n] - enable/disable AGC
allowenbl [y|n] - allow enable/disable channel (only if dynamic license group set)
compress [ulaw|adpcm|gsm] - set channel compression codec
dsp [y|n] - enable/disable channel hw compression
name [...] - channel description
enable [y|n] - enable/disable channel
event [id] - channel events configuration
exit - exit current configuration mode
gain [db] - set gain
help|? - embedded help
licgroup [none|1-n] - set channel license group
maxsilence [sec] - max silence timeout(sec)
minactivity [sec] - min activity timeout (sec)
highthrld [Dbx10] - high threshold (Dbx10)
lowthrld [Dbx10] - low threshold (Dbx10)
copy [1-n] - copy channel settings to range of channels [range]
show - show current settings
test voxlevel [0-600] - start/stop vox level test (time in sec, default 60 sec)

cli>(config-ch_1)

For details about parameters common to all types of channels - refer to config channel Common Parameters