capisuite(8) [suse man page]
CAPISUITE(8) CAPISUITE(8) NAME
capisuite - Python-scriptable ISDN telecommunication suite DESCRIPTION
CapiSuite is a Python-scriptable ISDN telecommunication suite. It uses the new CAPI interface for accessing your ISDN-hardware - so you'll need a card for which a CAPI compatible driver is available. Currently these are all cards manufactured by AVM and some Eicon cards. This man page only gives a short introduction, for the real documentation please see the HTML or PDF manual distributed with CapiSuite. CapiSuite tries to give the user the ability to code his own ISDN applications without having to fiddle around with all the dirty program- ming details like callback functions, data buffers, protocol settings and so on. I took a scripting language which is (in my opinion) very easy to understand, to use and to learn - especially for beginners: Python. I extended it with some functions providing the basic ISDN "building blocks" for the users application. Behind these functions the heart of CapiSuite implements all the dirty details a user isn't interested in. My goal was to make script-coding as simple as possible but to also give you the flexibility to realize what you want. To give you an impression, coding a simple answering machine is as easy as:.IP .nf def callIncoming (call, service, call_from, call_to): connect_voice (call, 10) # answer call after 10 secs audio_send (call, "announcemnt.la") # play announcement audio_send (call, "beep.la") # play beep audio_receive (call, "call.la", 10) # record call .fi Of course some details are missing like creating a unique filename or storing the additional information (called and calling party numbers, time, ...) - but I assume you got my idea. And - don't be afraid - if you just want to have a normal answering machine or send and receive some fax documents, you can use the default scripts distributed with CapiSuite. They give you already some nice features - e.g. the answering machine is multi-user ready, supports automatic fax detection and remote inquiry functions. You'll only need to tell CapiSuite some details like your own number, record an own announcement and that's it. So CapiSuite is already equipped for your daily telecommunication needs - but if you don't like to do the things the way I do - just change it or completely do it on your own. And if you write nice scripts or have changes to my default scripts, I would love to get and perhaps make them available for all users if you don't mind. SEE ALSO
capisuite.conf(5), fax.conf(5), answering_machine.conf(5), capisuitefax(1) AUTHOR
Gernot Hillier <gernot@hillier.de>. CAPISUITE(8)
Check Out this Related Man Page
CAPISUITE.CONF(5) CAPISUITE.CONF(5) NAME
capisuite.conf - configuration of the CapiSuite daemon DESCRIPTION
The options for the CapiSuite daemon are configured here. They will be presented in brief here - for further details please refer to the comments in the configuration file itself. OPTIONS
incoming_script="/path/to/incoming.py" This option tells CapiSuite which script should be executed at incoming calls. Only change this if you want to use your own script. idle_script="/path/to/idle.py" This option reflects the path and name of the idle script. This script is called in regular intervalls to check if any outgoing call should be done. As above, the default should be ok if you don't use your own script. idle_script_interval="30" Here you can define how often the idle script should be executed. The number given is the interval between subsequent invocations in seconds. Lesser numbers give you quicker response to queued jobs but also a higher system load. The default should be ok in most cases. log_file="/path/to/capisuite.log" This file will be used for all "normal" messages printed byCapiSuite telling you what it does. Error messages are written to a spe- cial log (see below). log_level="1" You can define how detailled the log output of CapiSuite will be. The default will give you some informational messages for each incoming and outgoing call and should be enough for normal use. I would recommend to only increase it if you encounter some prob- lems. Logs of higher level are mainly intended for developers, so just use them if you want to report a problem or have some know-how of the CAPI interface and the internals of CapiSuite. log_error="/path/to/capisuite.error" All errors which CapiSuite detects internally and in your scripts will end up here. They are written to an extra file so that they don't get lost in the normal log. Please check this log regularly for any messages - especially when you encounter problems. Please report all messages you don't understand and which aren't caused by your own script-modifications to the CapiSuite team. DDI_length="0" When your ISDN card is connected to an ISDN interface in PtP mode, i.e. if you use DDI which, in understandable words mean you have only one ISDN phone number and can define your own extensions as you like, you have to set the length of your extension numbers here. In Germany, PtP mode is called "Anlagenanschluss". Let's say you use 1234-000 till 1234-999, then your DDI_length would be 3. If you set this to 0, DDI/PtP is disabled. If you're not sure what all this should mean, then chances are high you don't use DDI and can leave this option as it is. DDI_base_length="0" This option is only used when DDI_length is not 0. This is the length of your base number - in the example above it would be 4. DDI_stop_numbers="" If you usually use extension numbers of a specified length, but also want to use some shorter ones (e.g. the "-0" extension for you switchboard), then you can list these shorter extensions here, separated by commas. SEE ALSO
capisuite(8), fax.conf(5), answering_machine.conf(5), capisuitefax(1) AUTHOR
Gernot Hillier <gernot@hillier.de>. CAPISUITE.CONF(5)