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  initialisa­
              tion. See icn(4) for a description of the syntax to
              be used for modularised and monolithic driver  ver­
              sions.  This option must be used to identify the S0
              interface if more than one S0  interface  is  exis­
              tent.  If  a single ICN-2B is used, it may be omit­
              ted.  If using more than one card, support for  the
              other cards is enabled with the add action of icnc­
              trl. 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-con­
              flicts. Ports are checked later during first  acti­
              vation  while  downloading  the firmware and can be
              changed at runtime. Ids are  checked  against  con­
              flicts,  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 dif­
              ferent from the default settings  below.   If  both

              tings. 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  chan­
              nel 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 num­
                             ber  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 set­
              tings 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

              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).


Man(1) output converted with man2html