Chapter 1. Getting Started

Table of Contents

Requirements and installation of CapiSuite
Requirements
Installation
Updating from previous versions
How CapiSuite works, how it is configured and started
How does CapiSuite work?
Configuration of CapiSuite
Startup of CapiSuite
Features and configuration of the default scripts
Script features
How the scripts work
Script configuration
Deleting old files
Using CapiSuite together with the default scripts
Receiving calls
Doing a remote inquiry
Sending fax jobs

Requirements and installation of CapiSuite

Requirements

Hardware and drivers

As CapiSuite uses the CAPI (Common ISDN Application Programming Interface) for accessing your ISDN-hardware, 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. If you have one of the passive cards of AVM, you'll have to download and install their CAPI drivers.

There are also some distributions (e.g. current versions of SUSE) which include the Capi4Linux drivers from AVM already - you'll only have to activate them (use YaST2 in SUSE Linux). If you own an active card of AVM (e.g. the B1, C2 or C4), then you'll have everything you need already installed.

No, there's no way to get it working with the old ISDN4Linux interface. Perhaps there never will be one as the ISDN4Linux project meanwhile provides a CAPI compatible interface in the mISDN project - CapiSuite certainly also works with it.

CapiSuite has mainly been tested on AVM ISDN cards, esp. the Fritz!PCI, the Fritz!USB and the B1 on the i386 platform but there should be no problem with other CAPI-compatible drivers for other cards or on other platforms. Nevertheless, some features aren't mandatory for all CAPI-compatible cards, so perhaps you may not be able to fax or to switch from voice to fax mode with all cards.

Software

CapiSuite depends on some packages which must be installed before CapiSuite can be used.

I will list them here with a short information why this packages are needed and where to find further information on how to install them. It may be always a good idea to check the installation tool of your favourite distribution first and see if they're included with it before trying to download and install them from the net. Don't be afraid, because there are so many - most of them are included in nearly every distribution and perhaps are already installed on your system.

Python >= 2.2

CapiSuite uses an embedded Python interpreter to interpret the given scripts - so you'll need an installed and working version of Python. This should be included in mostly every up-to-date Linux distribution. For further infos on Python, a 3004 - B1 protocol parameter not supported

  • 3005 - B2 protocol parameter not supported

  • 3006 - B3 protocol parameter not supported

  • 3007 - B protocol combination not supported

  • 3008 - NCPI not supported

  • 3009 - CIP Value unknown

  • 300A - Flags not supported (reserved bits)

  • 300B - Facility not supported

  • 300C - Data length not supported by current protocol

  • 300D - Reset procedure not supported by current protocol

  • ./usr/share/doc/capisuite/manual/ch01.html0000644000000000000000000004701610517271745017276 0ustar rootroot Chapter 1. Getting Started

    Chapter 1. Getting Started

    Requirements and installation of CapiSuite

    Requirements

    Hardware and drivers

    As CapiSuite uses the CAPI (Common ISDN Application Programming Interface) for accessing your ISDN-hardware, 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. If you have one of the passive cards of AVM, you'll have to download and install their CAPI drivers.

    There are also some distributions (e.g. current versions of SUSE) which include the Capi4Linux drivers from AVM already - you'll only have to activate them (use YaST2 in SUSE Linux). If you own an active card of AVM (e.g. the B1, C2 or C4), then you'll have everything you need already installed.

    No, there's no way to get it working with the old ISDN4Linux interface. Perhaps there never will be one as the ISDN4Linux project meanwhile provides a CAPI compatible interface in the mISDN project - CapiSuite certainly also works with it.

    CapiSuite has mainly been tested on AVM ISDN cards, esp. the Fritz!PCI, the Fritz!USB and the B1 on the i386 platform but there should be no problem with other CAPI-compatible drivers for other cards or on other platforms. Nevertheless, some features aren't mandatory for all CAPI-compatible cards, so perhaps you may not be able to fax or to switch from voice to fax mode with all cards.

    Software

    CapiSuite depends on some packages which must be installed before CapiSuite can be used.

    I will list them here with a short information why this packages are needed and where to find further information on how to install them. It may be always a good idea to check the installation tool of your favourite distribution first and see if they're included with it before trying to download and install them from the net. Don't be afraid, because there are so many - most of them are included in nearly every distribution and perhaps are already installed on your system.

    Python >= 2.2

    CapiSuite uses an embedded Python interpreter to interpret the given scripts - so you'll need an installed and working version of Python. This should be included in mostly every up-to-date Linux distribution. For further infos on Python, a 3004 - B1 protocol parameter not supported

  • 3005 - B2 protocol parameter not supported

  • 3006 - B3 protocol parameter not supported

  • 3007 - B protocol combination not supported

  • 3008 - NCPI not supported

  • 3009 - CIP Value unknown

  • 300A - Flags not supported (reserved bits)

  • 300B - Facility not supported

  • 300C - Data length not supported by current protocol

  • 300D - Reset procedure not supported by current protocol

  • ./usr/share/doc/capisuite/manual/ch01.html0000644000000000000000000004701610517271745017276 0ustar rootroot Chapter 1. Getting Started