Go to file
MelwareDE 5a96c01fd8 Set DNID correctly. 2005-07-12 20:15:50 +00:00
INSTALL cleanup 2005-06-07 04:26:12 +00:00
LICENSE Initial import of new chan_capi. 2005-06-02 18:47:35 +00:00
Makefile - fixed memory leak in ast_smoother use. 2005-06-19 10:01:35 +00:00
README gX in the dialstring may be a list of groups or a range. 2005-07-03 12:15:14 +00:00
app_capiCD.c Initial import of new chan_capi. 2005-06-02 18:47:35 +00:00
app_capiECT.c Initial import of new chan_capi. 2005-06-02 18:47:35 +00:00
app_capiFax.c indent issues 2005-06-06 16:10:54 +00:00
app_capiHOLD.c Initial import of new chan_capi. 2005-06-02 18:47:35 +00:00
app_capiMCID.c Initial import of new chan_capi. 2005-06-02 18:47:35 +00:00
app_capiNoES.c Initial import of new chan_capi. 2005-06-02 18:47:35 +00:00
app_capiRETRIEVE.c Initial import of new chan_capi. 2005-06-02 18:47:35 +00:00
capi.conf Initial import of new chan_capi. 2005-06-02 18:47:35 +00:00
chan_capi.c Set DNID correctly. 2005-07-12 20:15:50 +00:00
chan_capi_app.h - added capiFax feature by Frank Sautter 2005-06-04 14:28:52 +00:00
chan_capi_pvt.h - fixed memory leak in ast_smoother use. 2005-06-19 10:01:35 +00:00
create_config.sh Added compat to new ast_config* API of current Asterisk CVS HEAD. 2005-06-15 07:31:28 +00:00
xlaw.h Initial import of new chan_capi. 2005-06-02 18:47:35 +00:00


(CAPI*) chan_capi a Common ISDN API 2.0 implementation for Asterisk

 Copyright (C) 2005 Cytronics & Melware
 Armin Schindler <armin@melware.de>
 Reworked, but based on the work of
 Copyright (C) 2002-2005 Junghanns.NET GmbH
 Klaus-Peter Junghanns <kpj@junghanns.net>

This program is free software and may be modified and distributed under
the terms of the GNU Public License. There is _NO_ warranty for this!

Thanks go to the debuggers and bugfixers (listed in chronological order) :)
Lele Forzani <lele@windmill.it>
Florian Overkamp <florian@obsimref.com>
Gareth Watts <gareth@omnipotent.net>
Jeff Noxon <jeff@planetfall.com>
Petr Michalek <petr.michalek@aca.cz>
Jan Stocker
Frank Sautter, levigo group

(...and all the others that i forgot..) :-)

This chan_capi version includes:

- Multiple controller support
- CID,DNID (callling party, called party)
- Supplementary services, CD,HOLD,RETRIEVE,ECT
- DTMF (dependend on card) + software DTMF support
- Early B3 connects (always,success,never)
- Digital audio (what did you think?)
- Incoming/outgoing calls
- Overlap sending (dialtone)
- E(xplicit) C(all) T(ransfer) (...although it's done implicit-but don't tell!)
- Tuneable latency:  you can configure the size of B3 blocks at compile time
  (in chan_capi_pvt.h, AST_CAPI_MAX_B3_BLOCK_SIZE)
  The default is 160 samples, for non-VoIP use you can tune it down to 130
- Use asterisks internal DSP functions for DTMF
- Alaw support 
- Ulaw support! 
- Eicon CAPI echo cancelation (echocancel=1)
- Reject call waiting (ACO)
- DID for Point to Point mode (a.k.a overlap receiving)
- Call progress, no need to add ||r to your dialstring anymore
- Rx/Tx gains (rxgain=1.0)
- Call deflection on circuit busy (deflect=12345678)
- (Inter)national dialing prefix (for callerid) configurable in capi.conf
- CLI command "capi info" shows B channel status of chan_capi
- CapiECT will announce the callerID since it gets lost on most isdn pbxes
  The called party can press # to drop the call
- Audio syncing (timing outgoing dataB3 on incoming dataB3), supposed to fix
  the DATA_B3_REQ (error = 0x1103) problem
- Catch all MSN (incomingmsn=*)
- Some configuration enhancements (msn=123,124,125 and controller=1,2,3,4)
- Added accountcode= 
- Echo squelching (echosquelch=1)
- Callgroup support
- Fixed pipe leak
- Updated to support the new frame->delivery field
- Compiles with different Asterisk versions (automatic build configuration)
- Fixed channel name bug in PtP mode
- Added app_capiNoES for disabling the primitive echo suppressor, use this 
  before you start recording voicemail or your files may get choppy
- Added app_capiFax to receive faxes over CAPI (see below)

- ATTENTION! the dialstring syntax now uses the zaptel dialstring syntax 
  It used to be:  Dial(CAPI/[@]<outgoingMSN>:[b|B]<destination>)
  Now it is:      Dial(CAPI/g<group>/[b|B]<destination>)
  Or:             Dial(CAPI/contr<controller>/[b|B]<destination>)

  'group' can be a value, comma separated list of values or a range
  using '-'. The according interface is found by searching a match with
  the 'group' specified in the capi.conf for each interface.

  CLIP/CLIR now uses the calling presentation of the calling channel, which can
  be modified using the CallingPres() application. Use CallingPres(32) for CLIR.
  That is why the msn= param in capi.conf is now obsolete. The callerID is also
  taken from the calling channel.

- Fixes for BSD (Jan Stocker)

Helper applications
Kapejod says: "No No No, don't use those yet....!" (except maybe HOLD,ECT...)

	Forwards an unanswered call to another phone (does not rely on sservice CD)
		exten => s,1,Wait,1
		exten => s,2,capiCD,12345678
	Puts an answered call on hold, this has nothing to do with asterisk's onhold
	thingie (music et al)
	After putting a call onhold, never use the Wait application!

	Gets the holded call back

	Explicit call transfer of the call on hold (must put call on hold first!)
		exten => s,1,Answer
		exten => s,2,capiHOLD
		exten => s,3,capiECT,55:50
		Will ECT the call to 50 using 55 as the callerid/outgoing MSN

Using CLIR
Use the CallingPres() application before you dial:
	exten => _X.,1,CallingPres(32)
	exten => _X.,2,Dial(CAPI/contr1/${EXTEN})    

Enjoying early B3 connects (inband call progress, tones and announcements)
Early B3 is now configurable in the dialstring.
If you prefix the destination number with a 'b' early B3 will always be used, 
also if the call fails, because the number is unprovisioned, etc ...
If you prefix it with a 'B' early B3 will only be used on successful calls, 
giving you ring indication,etc...

Don't use indications in the Dial command, your local exchange will do that for 
	exten => _X.,1,Dial(CAPI/contr1/B${EXTEN},30)		
		(early B3 on success)
	exten => _X.,1,Dial(CAPI/contr1/b${EXTEN},30)	
		(always early B3)
	exten => _X.,1,Dial(CAPI/contr1/${EXTEN},30,r)		
		(no early B3, fake ring indication)

	exten => _X.,1,Dial(CAPI/contr1/b${EXTEN},30,r)		
		(always early B3, fake indicatons if the exchange does not give us 
	exten => _X.,1,Dial(CAPI/contr1/B${EXTEN},30,r)		
		(early B3 on success, fake indicatons if the exchange does not give us 
For normal PBX usage you would use the "b" option, always early B3.

Overlap sending (a.k.a. real dialtone)
When you dial an empty number, and have early B3 enabled, with:
The channel will come up at once and give you the dialtone it gets from the 
local exchange.
At this point the channel is like a legacy phone, now you can send DTMF digits 
to dial.    

Example context for incoming calls on MSN 12345678:

exten => 12345678,1,Dial(SIP/phone1)
exten => 12345678,2,Hangup

Short HOWTO of 'capiAnswerFax':
For those of you who have a CAPI card with an on-board DSP (like some Eicon and
DIVA Server), this patch allows you to receive faxes.
If you want to answer a channel in fax mode, use capiAnswerFax() instead of 
If you use Answer(), you will be in voice mode. If the hardware DSP detects 
fax tone, you can switch from voice to fax mode by calling capiAnswerFax().

Example of use :
line number 123, play something, if a fax tone is detected, handle it
line number 124, answer directly in fax mode

exten => 123,1,Answer()
exten => 123,2,BackGround(jpop)
exten => 124,1,Goto(handle_fax,s,1)
exten => fax,1,Goto(handle_fax,s,1)

exten => s,1,capiAnswerFax(/tmp/${UNIQUEID})
exten => s,2,Hangup()
exten => h,1,deadagi,fax.php // Run sfftobmp and mail it.

The output of capiAnswerFax is a SFF file. Use sfftobmp to convert it.
With a DIVA Server, following features are provided:
 - fax up to 33600
 - high resolution
 - Color Fax 
 - JPEG Compression is disabled (I can't test it)


More information/documentation and commercial support can be found at: