bionic (8) icnctrl.8.gz

Provided by: isdnactivecards_3.12.2007-11-27-1_amd64 bug

NAME

       icnctrl - configure ICN ISDN adaptor

SYNOPSIS

       icnctrl [-d Driver-Id] action options ...

DESCRIPTION

       icnctrl is used to setup the ICN ISDN device driver and for downloading the firmware into the ISDN card.

       The use of icnctrl makes sense, if you are using an ICN card only.

OPTIONS

       -d Driver-Id
              selects the S0 interface named by Driver-Id.  Driver-Ids are defined during driver initialisation.
              See icn(4) for a description of the syntax to  be  used  for  modularised  and  monolithic  driver
              versions.   This option must be used to identify the S0 interface if more than one S0 interface is
              existent. If a single ICN-2B is used, it may be omitted.  If using more than one card, support for
              the  other cards is enabled with the add action of icnctrl. Ids may not start with digits or small
              x, because these values are misinterpreted as numeric  parameters  by  insmod.   For  loading  the
              module, always the newest modutils package should be used to avoid problems during load.

       The following actions may be given to icnctrl.

       add port [id1 [id2]]
              enables  support  for an additional card in the driver. If id1 and id2 are missing, adds an ICN-2B
              with an id given by the system. with id2 missing, adds an ICN-2B with an Id  given  by  the  user.
              With  both Ids given, adds an ICN-4B with both Ids given by the user. There is no checking against
              port-conflicts. Ports are checked later during first activation while downloading the firmware and
              can  be changed at runtime. Ids are checked against conflicts, and if a conflict happens, replaced
              by the system in the same manner as if no Id was supplied. It is not allowed, to add cards,  after
              a load was done.

       io [base-address port]
              sets  the  address of the memory-mapped IO-region and the port-base.  After loading the icn-module
              into kernel-space, this command should be used as the very first setup, if the  hardware  settings
              are different from the default settings below.  If both parameters are omitted, prints out current
              settings. The default memory address is 0xD0000, the default port-base is 0x320.  An ICN card uses
              4  port-addresses. The memory address is globally used for all cards (cards are mapped on demand),
              while each card has its own port range. Memory range is 16k.

       leased on|1|2|off
              switches between normal (dialup) and leased-line mode. Leased-line mode is intended for usage with
              S64K-lines  or  -  if  both  channels  are used - for S02. If the second parameter is 1 , only one
              channel is enabled.  If the second parameter is 2 or on both channels are enabled. Leased lines do
              not  have a D-channel. When leased-line mode is enabled, the driver simulates incoming calls using
              special "phone-numbers" for calling and called address which are generated as follows:

              Calling number:
                     LEASEDx
                            where x is the internal slot-number of the S0 interface. This number starts  with  0
                            for  the  first  S0  interface  and  is  incremented  by  one for every S0 interface
                            configured using the add action.

              Called number:
                     x
                            where x is equal to the channel number of the calling S0 interface starting with 1.

       load boot-code firmware [firmware2]
              downloads the firmware into the card and starts operation. Using this command, after  loading  the
              icn-module  into  kernel-space  the  first  real  access to the hardware is done. Therefore the io
              action above, should be used before, if the hardware  settings  are  different  from  the  default
              settings.   Usually  the images are located in @DATADIR@.  The boot-code is named loadpg.bin.  The
              firmware depends on the D-channel protocol of the ISDN line. For German 1TR6-lines,  the  firmware
              is  named  pc_1t_ca.bin.   For Euro-ISDN-lines, it is named pc_eu_ca.bin.  When loading an ICN-4B,
              two firmware parameters have to be  supplied.  The  first  firmware  is  used  for  the  upper  S0
              connector,  the  second  firmware  is  used  for  the  lower S0 connector (towards the card's slot
              connector).

       dump   is available if the program is configured using the --enable-dump option  only.  The  contents  of
              internal driver variables is dumped on stdout.

FILES

       @DATADIR@/loadpg.bin
              This is the image of the bootstrap loader, which is loaded first, then loads the firmware into the
              card's memory and starts execution.

       @DATADIR@/pc_1t_ca.bin
              This is the image of the firmware designed for the German 1TR6 protocol.

       @DATADIR@/pc_eu_ca.bin
              This is the image of the firmware, designed for Euro ISDN.

DIAGNOSTICS

       The following diagnostics may be issued on stderr:

       Read error on boot-code
              The file supplied as boot-code has less than 4096 bytes length or could not be read.

       Read error on firmware
              The file supplied as firmware has less than 65536 bytes length or could not be read.

BUGS

       No bugs so far.

AUTHOR

       © 1997 by Fritz Elfert <fritz@isdn4linux.de>

SEE ALSO

       isdnctrl(8), icn(4), isdnctrl(4), ttyI(4).