retronetworking
/
chan-capi
mirror of https://github.com/MelwareDE/chan-capi.git
13
0
Fork 0
Code Issues Projects Releases Wiki Activity

Processed by doc control

This commit is contained in:
MelwareDE 2009-05-04 21:30:08 +00:00
parent 1a786b1f16
commit c81c4dd211
2 changed files with 163 additions and 163 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

114
README.Diva.fax
View File

@ -55,13 +55,13 @@ Automatic T.30 protocol parameter adjustment
The chan_capi can ignore low-level T.30 protocol settings. The T.30 protocol stack that runs on the RISC CPU The chan_capi can ignore low-level T.30 protocol settings. The T.30 protocol stack that runs on the RISC CPU
of the Dialogic(R) Diva(R) Media Board is able to perform the required adjustment of transmission parameters of the Dialogic(R) Diva(R) Media Board is able to perform the required adjustment of transmission parameters
to provide reliable and fast document transmission without requiring application intervention. to provide reliable and fast document transmission without requiring application intervention.
You can overrule the automatic T.30 protocol parameter adjustment with Global Dialogic(R) Diva(R) fax You can overrule the automatic T.30 protocol parameter adjustment with global fax
configuration options to overrule the automatic parameter adjustment. configuration options in the Dialogic(R) Diva(R) WEB configuration interface.
ECM (Error Correction Mode) support ECM (Error Correction Mode) support
----------------------------------- -----------------------------------
You can control ECM support via Global Dialogic(R) Diva(R) fax configuration options. You can control ECM support via global fax configuration options in the Dialogic(R) Diva(R) WEB configuration interface.
If you use global Diva configuration options to enable ECM support, the Dialogic(R) Diva(R) Media Board will use If you use global Diva configuration options to enable ECM support, the Dialogic(R) Diva(R) Media Board will use
ECM mode for document transfer, if supported by the opposite side. ECM mode for document transfer, if supported by the opposite side.
Diva Media Boards use their internal memory to store document data. They retrieve data for ECM re-transmissions Diva Media Boards use their internal memory to store document data. They retrieve data for ECM re-transmissions
@ -92,9 +92,9 @@ Diva supports media stream consisting from pages with different media types.
V.34 (33600 bps) fax support V.34 (33600 bps) fax support
---------------------------- ----------------------------
The V.34 fax support can be controlled via Global Dialogic(R) Diva(R) fax configuration options. The V.34 fax support can be controlled via global fax configuration options in the Dialogic(R) Diva(R) Configuration
If the Dialogic(R) Diva(R) Media Board is able to establish a connection with a transmission speed higher web interface. If the Dialogic(R) Diva(R) Media Board is able to establish a connection with a transmission speed
than 14400 bps (V.34), it handles this transparent to the application. higher than 14400 bps (V.34), it handles this transparent to the application.
You can use the "divalogd" accounting utility that uses the Diva Media Board Management interface to get You can use the "divalogd" accounting utility that uses the Diva Media Board Management interface to get
information on the transmission speed and the used compression algorithm. information on the transmission speed and the used compression algorithm.
@ -103,56 +103,56 @@ information on the transmission speed and the used compression algorithm.
| FoIP/VoIP (Fax/Voice over IP) T.38 FAX SUPPORT | | FoIP/VoIP (Fax/Voice over IP) T.38 FAX SUPPORT |
+-------------------------------------------------------------------+ +-------------------------------------------------------------------+
You can use Dialogic(R) Diva(R) softIP to access T.38 functionality. You can use the Dialogic(R) Diva(R) softIP software to access T.38 functionality.
This is no need to change your chan_capi configuration. Dialogic(R) Diva(R) softIP exposes There is no need to change your chan_capi configuration. The Dialogic(R) Diva(R) softIP software exposes the
CAPI interface towards chan_capi and SIP interface towards IP network. CAPI interface towards chan_capi and the SIP interface towards the IP network.
All T.38 and SIP related configuration is handled using Diva WEB configuration interface. All T.38 and SIP-related configurations are handled using Diva WEB configuration interface.
This is no limitation of the voice and supplementary services functionality of chan_capi. This is no limitation of the voice and supplementary services functionality of chan_capi.
You can change the call flow between voice and fax or invoke the supplementary services at CAPI interface You can change the call flow between voice and fax or invoke the supplementary services at the CAPI interface
and Diva softIP handles all necessary media and SIP negotiation. and the Diva softIP software handles all necessary media and SIP negotiation.
You can use Diva hardware and Diva softIP parallel on the one system. You can use the Diva hardware and the Diva softIP software in parallel on one system.
This is possible to use line interconnect (conferencing) features between Diva hardware and It is possible to use line interconnect (conferencing) features between the Diva hardware and
softIP without any limitations. The Diva softIP software without any limitations.
You can use softIP in virtual environment (VMWare, XEN, ...). You can use the Diva softIP software in virtual environments (VMWare, XEN, ...).
+-------------------------------------------------------------------+ +-------------------------------------------------------------------+
| FoIP/VoIP CLEAR CHANNEL FAX SUPPORT | | FoIP/VoIP CLEAR CHANNEL FAX SUPPORT |
+-------------------------------------------------------------------+ +-------------------------------------------------------------------+
Together with Diva(R) Dialogic(R) hardware you can use Dialogic(R) Diva(R) softIP or chan_capi to Together with the Diva(R) Dialogic(R) hardware you can use the Dialogic(R) Diva(R) softIP software or chan_capi to
access T.38 (softIP only) and Clear Channel Fax functionality. access T.38 (only Diva softIP software) and Clear Channel Fax functionality.
If you using softIP this is no need to change your chan_capi configuration. If you use the Diva softIP software there is no need to change your chan_capi configuration.
Dialogic(R) Diva(R) softIP exposes CAPI interface towards chan_capi and SIP interface towards The Dialogic(R) Diva(R) softIP software exposes the CAPI interface towards chan_capi and the SIP interface towards
IP network. All T.38 and SIP related configuration is handled using Diva WEB configuration interface. the IP network. All T.38 and SIP related configurations are handled using the Diva WEB configuration interface.
To activate Clear Channel Fax support Diva hardware should be switched in Resource Board mode. To activate Clear Channel Fax support, the Diva hardware should be switched in Resource Board mode.
This is no limitation of the voice and supplementory services functionality of chan_capi. This is no limitation of the voice and supplementory services functionality of chan_capi.
You can change the call flow between voice and fax or invoke the supplementary services at CAPI interface You can change the call flow between voice and fax or invoke the supplementary services at the CAPI interface
and Diva softIP will handle all necessary media and SIP negotiation. and the Diva softIP software will handle all necessary media and SIP negotiation.
You can use Diva hardware in TDM (E.1/T.1/S0), in Resource Board moda and Diva softIP You can use the Diva hardware in TDM (E.1/T.1/S0), in Resource Board mode and the Diva softIP software in
parallel on the one system. This is possible to use line interconnect (conferencing) features between Diva hardware and parallel on one system. It is possible to use the line interconnect (conferencing) features between the Diva hardware and
softIP without any limitations. the Diva softIP software without any limitations.
If you use chan_capi then you can use 'resource' command to assign DSP resources to connected If you use chan_capi, then you can use 'resource' command to assign DSP resources to connected
by IP users. Resource PLCI allows to send and to receive fax documents over IP using by IP users. Resource PLCI allows to send and to receive fax documents over IP using
clear channel fax and to use DSP resources for processing of IP media and for conferencing. Clear Channel fax and to use the DSP resources for processing of IP media and for conferencing.
This is possible to use line interconnect (conferencing) features between E.1/T.1/S0/PSTN and It is possible to use the line interconnect (conferencing) features between E.1/T.1/S0/PSTN and
IP peers without any limitations. IP peers without any limitations.
Both softIP and chan_capi allow to use G.729, G.723, iLBC, GSM and other Both the Diva softIP software and chan_capi allow to use G.729, G.723, iLBC, GSM, and other codecs
supported by Diva hardware vocoders. supported by the Diva hardware.
You cann use Diva hardware, chan_capi and softIP in virtual environment if access by software is supported (XEN). You can use the Diva hardware, chan_capi, and Diva softIP software in virtual environments if access by software is supported (XEN).
+-------------------------------------------------------------------+ +-------------------------------------------------------------------+
| COLOR FAX | | COLOR FAX |
+-------------------------------------------------------------------+ +-------------------------------------------------------------------+
Dialogic (R) Diva(R) hardware and softIP supports color fax and allows to send/receive The Dialogic (R) Diva(R) hardware and the Dialogic (R) Diva(R) softIP software support color fax and allow to send/receive
fax document using fax document using
Continuous tone color and gray-scale mode according to T.4 Annex E using JPEG coding Continuous tone color and gray-scale mode according to T.4 Annex E using JPEG coding
Lossless color and gray-scale mode according to T.43 using JBIG coding Lossless color and gray-scale mode according to T.43 using JBIG coding
@ -174,15 +174,15 @@ provides information about the image format.
| High resolution fax, non standard paper size | | High resolution fax, non standard paper size |
+-------------------------------------------------------------------+ +-------------------------------------------------------------------+
Dialogic (R) Diva(R) hardware and ssoftIP provides access to following T.30 features: The Dialogic (R) Diva(R) hardware and the Dialogic (R) Diva(R) softIP software provide access to following T.30 features:
Ultra/Super fine resolution Ultra/Super fine resolution
Non standard paper formats Non standard paper formats
The current COMMON-ISDN-API specification defines paper formats ISO A4, ISO B4 and ISO A3 The current COMMON-ISDN-API specification defines paper formats ISO A4, ISO B4, and ISO A3
at standard resolution (R8 x 3.85) and high resolution (R8 x 7.7). at standard resolution (R8 x 3.85) and high resolution (R8 x 7.7).
Support for B4 and A3 is even optional. Support for B4 and A3 is optional.
Diva supports a COMMON-ISDN-API extension that enables FAX document transmission and The Dialogic (R) Diva(R) software supports a COMMON-ISDN-API extension that enables FAX document transmission and
reception with paper formats ISO A4, ISO B4 and ISO A3 and these resolutions as specified in T.30: reception with paper formats ISO A4, ISO B4, and ISO A3 and the following resolutions as specified in T.30:
R8 x 3.85 R8 x 3.85
R8 x 7.7 R8 x 7.7
R8 x 15.4 R8 x 15.4
@ -197,7 +197,7 @@ Dialogic (R) Diva(R) hardware and ssoftIP provides access to following T.30 feat
1200 x 1200 dpi 1200 x 1200 dpi
The page format and resolution information is passed via appropriate fields in the SFF page header. The page format and resolution information is passed via appropriate fields in the SFF page header.
Dialogic(R) Diva(R) SFF2TIFF utility provides conversion from SFF to TIFF format for all basic and The Dialogic(R) Diva(R) SFF2TIFF utility provides conversion from SFF to TIFF format for all basic and
extended resolutions and paper formats. extended resolutions and paper formats.
+-------------------------------------------------------------------+ +-------------------------------------------------------------------+
@ -209,7 +209,7 @@ Based on information from README
Reception of fax documents Reception of fax documents
-------------------------- --------------------------
You can use Diva chan_capi configuration to activate fax support ("Fax detection" and "Fax detection time") options. You can use the Dialogic (R) Diva(R) chan_capi configuration to activate fax support ("Fax detection" and "Fax detection time").
The reception of the fax message is started using 'receivefax' capi command: The reception of the fax message is started using 'receivefax' capi command:
capicommand(receivefax|<filename>[|<stationid>|<headline>|<options>]) capicommand(receivefax|<filename>[|<stationid>|<headline>|<options>])
@ -230,22 +230,22 @@ The reception of the fax message is started using 'receivefax' capi command:
'm' - do not use MMR (T.6) coding 'm' - do not use MMR (T.6) coding
'd' - do not use MR (2D) coding 'd' - do not use MR (2D) coding
This is possible to answer the incomming call using 'receivefax' command and start reception of It is possible to answer the incomming call using 'receivefax' command and start reception of
the fax document directly. the fax document directly.
This is possible to answer call using 'Answer' in voice mode and change to reception (transmission) of the fax by It is possible to answer a call using 'Answer' in voice mode and change to reception (transmission) of the fax by
'receivefax' later, for example after detection of the fax calling tone or after user entered password 'receivefax' later, for example after the detection of the fax calling tone or after the user entered a password
using DTMF digits. using DTMF digits.
Use of resource ('resource' command) PLCI allows to receive fax documents over IP using clear channel fax. Using resource ('resource' command) PLCI allows to receive fax documents over IP using Clear Channel fax.
'resource' command allocates one resource PLCI for IP connections only and does not performs any actions for The 'resource' command allocates one resource PLCI for IP connections only and does not perform any actions for
E.1/T.1/S0/PSTN connectiosn. This allows safe use of 'resource' command in any context. E.1/T.1/S0/PSTN connections. This allows for safe use of 'resource' command in any context.
Example: Example:
[isdn-in] [isdn-in]
exten => _X.,1,Answer() ; Answer in voice mode exten => _X.,1,Answer() ; Answer in voice mode
exten => _X.,n,Set(TIMEOUT(digit)=5) ; Set Digit Timeout to 5 seconds exten => _X.,n,Set(TIMEOUT(digit)=5) ; Set Digit Timeout to 5 seconds
exten => _X.,n,Set(TIMEOUT(response)=10) ; Set Response Timeout to 10 seconds exten => _X.,n,Set(TIMEOUT(response)=10) ; Set Response Timeout to 10 seconds
exten => _X.,n,BackGround(jpop) ; play message and wait until detection of fax calling tone exten => _X.,n,BackGround(jpop) ; Play message and wait until detection of fax calling tone
exten => 124,1,Goto(handle_fax,s,1) ; Extension 124 is dedicated to fax, answer in fax mode exten => 124,1,Goto(handle_fax,s,1) ; Extension 124 is dedicated to fax, answer in fax mode
@ -257,7 +257,7 @@ exten => s,1,capicommand(receivefax|/tmp/${UNIQUEID}[|<stationid>|<headline>|<op
exten => s,2,Hangup() exten => s,2,Hangup()
exten => h,1,deadagi,fax.php ; Run sfftobmp and mail it exten => h,1,deadagi,fax.php ; Run sfftobmp and mail it
Example with clear channel fax support: Example with Clear Channel fax support:
[handle_fax] [handle_fax]
exten => s,1,capicommand(resource|1-4) ; Assign resource PLCI exten => s,1,capicommand(resource|1-4) ; Assign resource PLCI
@ -269,7 +269,7 @@ exten => h,1,deadagi,fax.php ; Run sfftobmp and mail it
Transmission of fax documents Transmission of fax documents
----------------------------- -----------------------------
The transmission of fax message is started using 'sendfax' capi command: The transmission of the fax message is started using 'sendfax' capi command:
capicommand(sendfax|<filename>[|<stationid>|<headline>|<options>]) capicommand(sendfax|<filename>[|<stationid>|<headline>|<options>])
@ -291,12 +291,12 @@ The transmission of fax message is started using 'sendfax' capi command:
'm' - do not use MMR (T.6) coding 'm' - do not use MMR (T.6) coding
'd' - do not use MR (2D) coding 'd' - do not use MR (2D) coding
You need to start call using 'Dial' command in voice mode and change to transmission (reception) You need to start the call using the 'Dial' command in voice mode and change to transmission (reception)
of the fax by 'sendfax'. Optionally you can wait until user entered password using DTMF digits. of the fax by 'sendfax'. Optionally, you can wait until the user entered a password using DTMF digits.
Use of resource ('resource' command) PLCI allows to transmit fax documents over IP using clear channel fax. Using resource ('resource' command) PLCI allows to transmit fax documents over IP using Clear Channel fax.
'resource' command allocates one resource PLCI for IP connections only and does not performs any actions for The 'resource' command allocates one resource PLCI for IP connections only and does not perform any actions for
E.1/T.1/S0/PSTN connectiosn. This allows safe use of 'resource' command in any context. E.1/T.1/S0/PSTN connections. This allows for safe use of 'resource' command in any context.
Example: Example:
@ -309,7 +309,7 @@ exten => s,n,deadagi,faxlog.php ; Log result and schedule restart if necessary
exten => s,n,Hangup exten => s,n,Hangup
Example with clear channel fax support: Example with Clear Channel fax support:
[handle_sendfax] [handle_sendfax]
exten => s,1,capicommand(resource|1-4) ; Assign resource PLCI exten => s,1,capicommand(resource|1-4) ; Assign resource PLCI
@ -320,7 +320,7 @@ exten => s,n,Hangup
Results of fax transmission Results of fax transmission
--------------------------- ---------------------------
After chan_capi completed the processing of 'receivefax' or 'sendfax' command following variables are set: After chan_capi completed the processing of the 'receivefax' or 'sendfax' commands, following variables are set:
FAXSTATUS - Status of fax transmission FAXSTATUS - Status of fax transmission
0 - OK 0 - OK
1 - Error 1 - Error

212
README.media
View File

@ -9,7 +9,7 @@
Description: Description:
Noise Suppressor is used to activate or to deactivate suppression of ambient noise, Noise Suppressor is used to activate or to deactivate suppression of ambient noise,
which can be used to remove noise from speech caused by fans, air cooling systems, which can be used to remove noise from speech caused by fans, air cooling systems,
cars, trains and other sources of ambient noises from speech. cars, trains, and other sources of ambient noises from speech.
Direction: Direction:
Applies to Rx path only. Applies to Rx path only.
@ -17,7 +17,7 @@ Direction:
Supported hardware: Supported hardware:
Dialogic(R) Diva(R) 4PRI PCI, 2PRI PCI, 4PRI PCIe HS Media Board Dialogic(R) Diva(R) 4PRI PCI, 2PRI PCI, 4PRI PCIe HS Media Board
Other Dialogic(R) Diva(R) Media Boards equipped with DSP Diva hardware can use this Other Dialogic(R) Diva(R) Media Boards equipped with DSPs can use this
feature only together with RTP. feature only together with RTP.
Syntax: Syntax:
@ -76,11 +76,11 @@ Direction:
In case of line interconnect, it can be activated for multiple parties. In case of line interconnect, it can be activated for multiple parties.
Supported hardware: Supported hardware:
Requires one Dialogic(R) Diva(R) Media Board equipped with DSPs Requires one Dialogic(R) Diva(R) Media Board equipped with DSPs.
Syntax: Syntax:
clamping|N clamping|N
N - estimated duration of DTMF tones to be suppressed in mSec N - estimated duration of DTMF tones to be suppressed in ms
0 - deactivate clamping 0 - deactivate clamping
1 ... 250 - activate clamping 1 ... 250 - activate clamping
@ -134,10 +134,10 @@ Description:
Direction: Direction:
Applies to Rx path only. Applies to Rx path only.
In case of line interconnect can be activated for multiple parties. In case of line interconnect, it can be activated for multiple parties.
Supported hardware: Supported hardware:
Requires one equipped with DSP Diva hardware. Requires one Diva Media Board equipped with DSPs.
Syntax: Syntax:
rxagc|yes,no rxagc|yes,no
@ -191,11 +191,11 @@ Description:
for Tx direction. AGC level is -6 dBm. for Tx direction. AGC level is -6 dBm.
Path: Path:
Applies to Tx path only. In case of line interconnect can be activated Applies to Tx path only. In case of line interconnect, it can be activated
for multiple parties. for multiple parties.
Supported hardware: Supported hardware:
Requires one equipped with DSP Diva hardware Requires one Diva Media Board equipped with DSPs.
Syntax: Syntax:
txagc|yes,no txagc|yes,no
@ -390,7 +390,7 @@ Description:
Used to set recording (Rx direction) and playback (Tx direction) Used to set recording (Rx direction) and playback (Tx direction)
rate in the range between 1250 ... 51200 Hz. rate in the range between 1250 ... 51200 Hz.
Using pitch control, it is possible to play (record) voice message faster Using pitch control, it is possible to play (record) a voice message faster
(rate > 8000 Hz) or slower (rate < 8000 Hz). (rate > 8000 Hz) or slower (rate < 8000 Hz).
This is useful if the playback speed of voice mail messages needs to be decreased This is useful if the playback speed of voice mail messages needs to be decreased
to achieve better understanding or to increase playback speed to to achieve better understanding or to increase playback speed to
@ -398,7 +398,7 @@ Description:
Diection: Diection:
Applies to Rx and to Tx path. Can be used only for playback and for Applies to Rx and to Tx path. Can be used only for playback and for
recoring of voice data. Not available with line interconnect and RTP. recording of voice data. Not available with line interconnect and RTP.
Supported hardware: Supported hardware:
Requires one Diva Media Board equipped with DSPs. Requires one Diva Media Board equipped with DSPs.
@ -441,7 +441,7 @@ Description:
Used to change the recording (Rx direction) and playback (Tx direction) Used to change the recording (Rx direction) and playback (Tx direction)
rate in the range from 1250 ... 51200 Hz. rate in the range from 1250 ... 51200 Hz.
With pitch control it is possible to play (record) voice message faster With pitch control it is possible to play (record) a voice message faster
(rate > 8000 Hz) or slower (rate < 8000 Hz). (rate > 8000 Hz) or slower (rate < 8000 Hz).
This is useful if the playback speed of voice mail messages needs to be decreased This is useful if the playback speed of voice mail messages needs to be decreased
to achieve better understanding or to increase playback speed to to achieve better understanding or to increase playback speed to
@ -729,8 +729,8 @@ stoptonedetection
0xCB - Tone Alerting Signal detected (for Caller ID in PSTN) 0xCB - Tone Alerting Signal detected (for Caller ID in PSTN)
Syntax example: Syntax example:
s,n,capicommand(starttonedetection|98) ; Change to extension 98 after the detection of the tone s,n,capicommand(starttonedetection|98) ; Change to extension 98 after detection of tone
s,n,capicommand(stoptonedetection) ; Disable detection of the tones s,n,capicommand(stoptonedetection) ; Disable detection of tones
IVR example: IVR example:
@ -768,26 +768,26 @@ exten => h,1,Hangup
+-------------------------------------------------------------------+ +-------------------------------------------------------------------+
Description: Description:
While a voice message is played back it is useful to be able to apply While a voice message is played back, it is useful to be able to apply
media control commands to voice stream without interrupting the playback media control commands to the voice stream without interrupting the playback
of the voice stream. of the voice stream.
The same is true for the conference and for connection between two parties. The same is true for conference and for connection between two parties.
The "vc" command allows to provide this functionality. With this command The "vc" command allows to provide this functionality. With this command
it is possible to bind arbitrary chan_capi commands to sequences of it is possible to bind arbitrary chan_capi commands to sequences of
events (DTMF digits, ...). Once the events are detected, the appropriate command events (DTMF digits, ...). Once the events are detected, the appropriate command
is executed without interruption of the voice stream. is executed without interrupting the voice stream.
"vc" allows to create a menu that is executed in the background and allows to "vc" allows to create a menu that is executed in the background and allows to
control voice stream by activation or deactivation of AGC, noise suppression, control the voice stream by activation or deactivation of AGC, noise suppression,
control the level of the signal, and playback speed. control the level of the signal, and playback speed.
"vc" allows to use any supported by channel driver command, but please note "vc" allows to use any command supported by the channel driver, but please note
that commands are not executed in the context of the dial plan. The commands that commands are not executed in the context of the dial plan. The commands
are executed using the context of the detected events parallel to the dialplan and are executed using the context of the detected events parallel to the dialplan and
independent from the dialplan. independent from the dialplan.
Syntax: Syntax:
vc|command|key|param|param1|...|paranN vc|command|key|param|param1|...|paranN
Add to menu: on detection of key Execute command using parameters param1|...|paramN Add to menu: on detection of key execute command using parameters param1|...|paramN
vc|command|key vc|command|key
Add to menu: on detection of key execute command without parameters Add to menu: on detection of key execute command without parameters
@ -798,7 +798,7 @@ vc|command
vc vc
Cleanup menu Cleanup menu
In case one command will use a key that is already in use then a new command will overwrite In case one command will use a key that is already in use, then a new command will overwrite
the existing command: the existing command:
exten => s,n,capicommand(vc|txagc|3|yes) exten => s,n,capicommand(vc|txagc|3|yes)
exten => s,n,capicommand(vc|inctxdgain|3|1.5) exten => s,n,capicommand(vc|inctxdgain|3|1.5)
@ -810,8 +810,8 @@ exten => s,n,capicommand(vc|inctxdgain|3|1.5)
It is better to use only one digit as key for commands in menu if using the menu for IVR and It is better to use only one digit as key for commands in menu if using the menu for IVR and
voice mailbox. This provides short response time. voice mailbox. This provides short response time.
In case, the menu is used for conference or for connection between two parties it may be useful to use In case the menu is used for conference or for connection between two parties, it may be useful to use
two or three digits for the key. This will prevent an activation by accidentally pressing of keys. two or three digits for the key. This will prevent an activation by accidentally pressing a key.
Syntax example: Syntax example:
exten => s,n,capicommand(vc|inctxdgain|5|1.5) ; Execute inctxdgain|1.5 if received DTMF digit 5 exten => s,n,capicommand(vc|inctxdgain|5|1.5) ; Execute inctxdgain|1.5 if received DTMF digit 5
@ -841,30 +841,30 @@ exten => s,n,Hangup
+-------------------------------------------------------------------+ +-------------------------------------------------------------------+
Description: Description:
Used to enter (create) chat (conference room). New conference room is created Used to enter (create) chat (conference room). A new conference room is created
if necessary. if necessary.
This is three types of conference members: There are three types of conference members:
Regular users Regular users
Operators Operators
Listeners Listeners
Regular users can receive voice stream from conference and send voice stream to conference. Regular users can receive the voice stream from the conference and send the voice stream to the conference.
Outgoing (from user to conference) voice stream from regular users can be muted (deactivated) The outgoing (from user to conference) voice stream from regular users can be muted (deactivated)
and unmuted (activated) if necessary by 'chat_mute' command. and unmuted (activated) if necessary by 'chat_mute' command.
Operators can receive voice stream from conference and send voice stream to conference. Operators can receive the voice stream from the conference and send the voice stream to the conference.
Outgoing (from user to conference) voice stream from operators can not be muted (deactivated) The outgoing (from user to conference) voice stream from operators cannot be muted (deactivated)
by 'chat_mute' command. by 'chat_mute' command.
Listeners can only receive voice stream from conference. Listeners can only receive the voice stream from the conference.
Outgoing (from user to conference) voice stream is muted (decativated) and can not be unmuted (activated) The outgoing (from user to conference) voice stream is muted (decativated) and cannot be unmuted (activated)
by 'chat_mute' command. by the 'chat_mute' command.
Direction: Direction:
Creates one Any-to-Any conference room. Conference AGC (evaluation of active talker) receives active as Creates one Any-to-Any conference room. Conference AGC (evaluation of active talker) receives active as
soon as more then two members are added to conference. soon as more then two members are added to the conference.
Supported hardware: Supported hardware:
Diva Diva
@ -873,9 +873,9 @@ Syntax:
capicommand(chat|<roomname>|<options>|controller) capicommand(chat|<roomname>|<options>|controller)
roomname - conference room name roomname - conference room name
options options
m - The first caller will get music-on-hold until second caller arrives m - The first caller will get music-on-hold until the second caller arrives
l - The caller is listener (passive) conference member, can not be unmuted by 'chat_mute' command l - The caller is listener (passive) conference member and cannot be unmuted by 'chat_mute' command
o - The caller is conference operator, can not be muted by 'chat_mute' command o - The caller is conference operator and cannot be muted by 'chat_mute' command
controller - CAPI controller controller - CAPI controller
Syntax example: Syntax example:
@ -918,73 +918,73 @@ exten => h,1,Hangup
///////////////////////////////////////////////////////////////////// /////////////////////////////////////////////////////////////////////
+-------------------------------------------------------------------+ +-------------------------------------------------------------------+
| IP clear channel fax and chat (MeetMe/Conference) | | IP Clear Channel fax and chat (MeetMe/Conference) |
| with access to DSP resources | | with access to DSP resources |
+-------------------------------------------------------------------+ +-------------------------------------------------------------------+
Description: Description:
Used to assign DSP resources to connected by IP user. Used to assign DSP resources to connected IP users.
Assigned DSP resources can be used for: Assigned DSP resources can be used for:
Transmission of clear channel fax with up to 33600Bps (V.34), please read 'sendfax' in README.Diva.fax for details Transmission of Clear Channel fax with up to 33600Bps (V.34), please read 'sendfax' in README.Diva.fax for details.
Reception of clear channel fax with up to 33600Bps (V.34), please read 'receivefax' in README.Diva.fax for details Reception of Clear Channel fax with up to 33600Bps (V.34), please read 'receivefax' in README.Diva.fax for details.
Create conference member with media processing capabilities Create conference member with media processing capabilities.
If conference member is connected by IP network using 'chat' chan_capi command If the conference member is connected to the IP network using 'chat' chan_capi command,
then this peer can not allocate and use required for media processing DSP resources. then this peer cannot allocate and use the DSP resources required for media processing.
This results in processing of IP partipiants as simple conferencing member without This results in processing of IP partipiants as simple conferencing member without
any media processing capabilities except line interconnect (conferencing) and any media processing capabilities except line interconnect (conferencing) and
conferencing AGC (active talker evaluation). conferencing AGC (active talker evaluation).
Using 'resource' chan_capi command this is possible to assign DSP resources to With the 'resource' chan_capi command it is possible to assign DSP resources to
by IP network connection before proceeding with 'chat' chan_capi command. This the IP network connection before proceeding with 'chat' chan_capi command. This
allows use of provided by DSP resources media processing for connected by IP allows for using the provided DSP resources for media processing for the connected IP
network conference members. network conference members.
This is three types of conference members: There are three types of conference members:
Regular users Regular users
Operators Operators
Listeners Listeners
Regular users can receive voice stream from conference and send voice stream to conference. Regular users can receive voice streams from the conference and send voice streams to the conference.
Outgoing (from user to conference) voice stream from regular users can be muted (deactivated) The outgoing (from user to conference) voice stream from regular users can be muted (deactivated)
and unmuted (activated) if necessary by 'chat_mute' command. and unmuted (activated) if necessary by 'chat_mute' command.
Operators can receive voice stream from conference and send voice stream to conference. Operators can receive voice streams from the conference and send voice streams to the conference.
Outgoing (from user to conference) voice stream from operators can not be muted (deactivated) The outgoing (from user to conference) voice stream from operators cannot be muted (deactivated)
by 'chat_mute' command. by 'chat_mute' command.
Listeners can only receive voice stream from conference. Listeners can only receive the voice stream from the conference.
Outgoing (from user to conference) voice stream is muted (decativated) and can not be unmuted (activated) The outgoing (from user to conference) voice stream is muted (decativated) and cannot be unmuted (activated)
by 'chat_mute' command. by 'chat_mute' command.
Note: Note:
Certain problems arrive if processing send in band DTMF events for Certain problems may occur if processing sent in-band DTMF events for
IP connections. IP connections.
chan_diva can use sent in band DTMF events to control media chan_diva can use sent in-band DTMF events to control media
processing (chan_capi 'vc' command). This works without problems for processing (chan_capi 'vc' command). This works without problems for
E.1/T.1/S0/Analog connections. But in case of IP connections media E.1/T.1/S0/Analog connections. But in case of IP connections, the media
stream is processed by gateway or is originated by IP device. stream is processed by the gateway or is originated by the IP device.
Most of gateways will remove in band DTMF events from media stream and Most of the gateways will remove in-band DTMF events from the media stream and
forward detected DTMF events as RTP payloads. IP devices will not use forward detected DTMF events as RTP payloads. IP devices will not use
in band DTMF signaling and send DTMF events as RTP payloads. in-band DTMF signaling and send DTMF events as RTP payloads.
In both cases DTMF events are not sent in band and processed by signaling In both cases, DTMF events are not sent in-band and processed by signaling
before reaching the chan_capi. before reaching the chan_capi.
The solution is to configure gateways and IP devices to send DTMF events The solution is to configure gateways and IP devices to send DTMF events
in band in addition to sending as RTP payloads or use in band MF signaling. in-band in addition to sending them as RTP payloads or use in-band MF signaling.
Supported hardware: Supported hardware:
Assign DSP resources to connected by IP network conference member. This feature is available Assign DSP resources to connected IP network conference members. This feature is available
for equipped with DSP Diva hardware only. only for Diva hardware equipped with DSPs.
For Diva 2PRI PCI, Diva 4PRI PCI, Diva 1PRI PCIe HS, Diva 2PRI PCIe HS and Diva 4PRI PCIe HS no For Diva 2PRI PCI, Diva 4PRI PCI, Diva 1PRI PCIe HS, Diva 2PRI PCIe HS, and Diva 4PRI PCIe HS no
restrictions apply for this feature and this is possible to access N x 30 DSP resources restrictions apply for this feature and it is possible to access N x 30 DSP resources
(N - amount of interfaces, 1 - 1PRI, 2 - 2PRI, 4 - 4PRI) in addition to used for E.1/T.1 (N - amount of interfaces, 1 - 1PRI, 2 - 2PRI, 4 - 4PRI) in addition to used for E.1/T.1
DSP resources. DSP resources.
For Diva PRI Rev.3 PCI and Diva PRI Rev.3 PCIe this is possible to reserve two DSPs for processing For Diva PRI Rev.3 PCI and Diva PRI Rev.3 PCIe, it is possible to reserve two DSPs for processing
of E.1/T.1 without media processing features and share remainding DSPs between E.1/T.1 and IP of E.1/T.1 without media processing features and share remaining DSPs between E.1/T.1 and IP
for connections with media processing features. for connections with media processing features.
Using hardware with 30 DSPs and E.1 this is possible to create: Using hardware with 30 DSPs and E.1 it is possible to create:
From: 2 x E.1 without media processing + 28 x E.1 with media processing From: 2 x E.1 without media processing + 28 x E.1 with media processing
To: 30 x E.1 without media processing + 28 x IP with media processing To: 30 x E.1 without media processing + 28 x IP with media processing
Using hardware with 30 DSPs and T.1 this is possible to create: Using hardware with 30 DSPs and T.1 this is possible to create:
@ -992,14 +992,14 @@ Supported hardware:
To: 23 x T.1 without media processing + 28 x IP with media processing To: 23 x T.1 without media processing + 28 x IP with media processing
For Diva BRI-2M Rev.2 PCI, Diva BRI-2M PCIe, Diva 4BRI Rev.2 PCI and for Diva 4BRI PCIe For Diva BRI-2M Rev.2 PCI, Diva BRI-2M PCIe, Diva 4BRI Rev.2 PCI and for Diva 4BRI PCIe
this is not possible to reserve DSPs for processing of ISDN connections and to share it is not possible to reserve DSPs for processing of ISDN connections and to share
DSPs between ISDN and IP connection. In case DSP resources are assigned to connected DSPs between ISDN and IP connection. If DSP resources are assigned to connected
by IP conference member then appropriate DSP resources receive not available IP conference members, then the appropriate DSP resources receive not available
for processing of ISDN connections. As result ISDN connections can not be processed. for processing of ISDN connections. As result ISDN connections cannot be processed.
To resolve this problem please use Diva configuration to change the configuration To resolve this problem please use the Diva configuration to change the configuration
of Diva board to resourceboardmode. In resourceboard mode ISDN interface is deactivated of Diva board to resource board mode. In resource board mode, the ISDN interface is deactivated
and all available DSP resources (two DSPs for Diva BRI-2M and eight DSPs for Diva 4BRI) and all available DSP resources (two DSPs for Diva BRI-2M and eight DSPs for Diva 4BRI)
can be used for connected by IP conference members (two members for Diva BRI-2M and can be used for connected IP conference members (two members for Diva BRI-2M and
eight members for Diva 4BRI). eight members for Diva 4BRI).
@ -1040,37 +1040,37 @@ exten => s,n,capicommand(chat|test1|m|1-4) ; Craete/enter conference toom 't
+-------------------------------------------------------------------+ +-------------------------------------------------------------------+
Description: Description:
Used to manage chat (conference room). This is three types of conference members: Used to manage chat (conference room). There are three types of conference members:
Regular users Regular users
Operators Operators
Listeners Listeners
Regular users can receive voice stream from conference and send voice stream to conference. Regular users can receive the voice stream from the conference and send the voice stream to the conference.
Outgoing (from user to conference) voice stream from regular users can be muted (deactivated) The outgoing (from user to conference) voice stream from regular users can be muted (deactivated)
and unmuted (activated) if necessary by 'chat_mute' command. and unmuted (activated) if necessary by 'chat_mute' command.
Operators can receive voice stream from conference and send voice stream to conference. Operators can receive the voice stream from the conference and send the voice stream to the conference.
Outgoing (from user to conference) voice stream from operators can not be muted (deactivated) The outgoing (from user to conference) voice stream from operators cannot be muted (deactivated)
by 'chat_mute' command. by 'chat_mute' command.
Listeners can only receive voice stream from conference. Listeners can only receive the voice stream from the conference.
Outgoing (from user to conference) voice stream is muted (decativated) and can not be unmuted (activated) The outgoing (from user to conference) voice stream is muted (decativated) and cannot be unmuted (activated)
by 'chat_mute' command. by 'chat_mute' command.
'chat_mute' command allows to manage conference switching regular users between active (voice stream from 'chat_mute' command allows to manage conference switching of regular users between active (voice stream from
user to conference is active and used in conference) and passive (voice stream from user to conference user to conference is active and used in conference) and passive (voice stream from user to conference
is deactivated and not used in conference) mode. 'chat_mute' command apply to regular users only. is deactivated and not used in conference) mode. 'chat_mute' command applies to regular users only.
The state of operators and listeners is not changed by this commmand. Independent from changed by this The state of operators and listeners is not changed by this commmand. Independent from changes to this
command state of conference operators will remain active members and listeners will remain passive members command state, conference operators will remain active members and listeners will remain passive members
of conference. of the conference.
Direction: Direction:
Used to control (deactivate and activate) voice stream from regular users to conference. Used to control (deactivate and activate) the voice stream from regular users to the conference.
Note: Note:
Voice stream of regular users is active by default. If conference mode was changed to half duplex The voice stream of regular users is active by default. If the conference mode was changed to half duplex
('chat_mute|yes') then new regular users are created with voice stream deactivated until conference ('chat_mute|yes'), then new regular users are created with a deactivated voice stream until the conference
mode is not changed back to full duplex ('chat_mute|no') mode is changed back to full duplex ('chat_mute|no')
Supported hardware: Supported hardware:
Diva Diva
@ -1078,14 +1078,14 @@ Supported hardware:
Syntax: Syntax:
capicommand(chat_mute|<action>[|<roomname>]) capicommand(chat_mute|<action>[|<roomname>])
action - mandatory action - mandatory
yes - change conference mode to half duplex, deactivate voice stream from regular yes - Change conference mode to half duplex, deactivate voice stream from regular
users to conference users to conference.
no - change conference mode back to full duplex, activate voice stream from regular no - Change conference mode back to full duplex, activate voice stream from regular
users to conference users to conference.
roomname - conference room name. This parameter is necessary if caller is not a member of conference. roomname - Conference room name. This parameter is necessary if a caller is not a member of the conference.
It allows the control of conference by one user which not member of conference. Using It allows the control of the conference by one user, who not member of conference. Using
this parameter one user can control multiple conferences. This allows to implement this parameter, one user can control multiple conferences. This allows to implement the
functionality of common conference operator. functionality of a common conference operator.
Syntax example: Syntax example:
exten => s,n,capicommand(chat_mute|yes) exten => s,n,capicommand(chat_mute|yes)
@ -1130,7 +1130,7 @@ exten => s,n,Hangup
+-------------------------------------------------------------------+ +-------------------------------------------------------------------+
Description: Description:
Used to activate or to deactivate echo cancellation in accordance with G.168 Used to activate or to deactivate echo cancellation in accordance with G.168.
The vast majority of the public telephone system local loop wiring is done using The vast majority of the public telephone system local loop wiring is done using
two-wire connections whereby the same pair of wires carries voice signals in both two-wire connections whereby the same pair of wires carries voice signals in both
directions. In the telephone company's central office or in an office PBX, directions. In the telephone company's central office or in an office PBX,
@ -1143,22 +1143,22 @@ Description:
the echo canceller must not cause detriment to signaling tones (DTMF etc.) or fax and the echo canceller must not cause detriment to signaling tones (DTMF etc.) or fax and
modem transmissions. modem transmissions.
Diva supports echo cancellation (in accordance G.168 with NLP) with tail length up to 256 mSec. Diva supports echo cancellation (in accordance G.168 with NLP) with tail length up to 256 ms.
256 mSec tail length is required to ensure the operation in the environments where the signal 256 ms tail length is required to ensure the operation in the environments where the signal
is carried over the packet network. This is not always the case at customer site and can be done is carried over the packet network. This is not always the case at customer site and can be done
by transit network which does not provides own echo cancellation capabilities. by the transit network, wich does not provide own echo cancellation capabilities.
'echocancelnlp' configuration parameter (capi.conf) is used to activate (deactivate) NLP 'echocancelnlp' configuration parameter (capi.conf) is used to activate (deactivate) NLP
(Non Linear Processor which removes the residual echo at the output of the echo cancellation unit). (Non Linear Processor which removes the residual echo at the output of the echo cancellation unit).
You can use Diva chan_capi configuration to change this capi.conf configuration parameter. You can use Diva chan_capi configuration to change this capi.conf configuration parameter.
Diva automatically deactivates echo cancellation upon detection of fax ro modem transmission. The Diva software automatically deactivates echo cancellation upon the detection of fax or modem transmission.
Direction: Direction:
Aplies on TDM interface (E.1/T.1/S0) only Aplies to TDM interface (E.1/T.1/S0) only
Supported hardware: Supported hardware:
Equipped with DSP Diva hardware Diva Media Boards equipped with DSPs.
Syntax: Syntax:
echocancel|yes,no echocancel|yes,no