1ICNCTRL(8)                Linux System Administration               ICNCTRL(8)
2
3
4

NAME

6       icnctrl - configure ICN ISDN adaptor
7

SYNOPSIS

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

DESCRIPTION

12       icnctrl is used to setup the ICN ISDN device driver and for downloading
13       the firmware into the ISDN card.
14
15       The use of icnctrl makes sense, if you are using an ICN card only.
16

OPTIONS

18       -d Driver-Id
19              selects the S0 interface named  by  Driver-Id.   Driver-Ids  are
20              defined  during driver initialisation. See icn(4) for a descrip‐
21              tion of the syntax to be used  for  modularised  and  monolithic
22              driver  versions.   This  option must be used to identify the S0
23              interface if more than one S0 interface is existent. If a single
24              ICN-2B is used, it may be omitted.  If using more than one card,
25              support for the other cards is enabled with the  add  action  of
26              icnctrl. Ids may not start with digits or small x, because these
27              values are misinterpreted as numeric parameters by insmod.   For
28              loading the module, always the newest modutils package should be
29              used to avoid problems during load.
30
31       The following actions may be given to icnctrl.
32
33       add port [id1 [id2]]
34              enables support for an additional card in the driver. If id1 and
35              id2  are missing, adds an ICN-2B with an id given by the system.
36              with id2 missing, adds an ICN-2B with an Id given by  the  user.
37              With  both  Ids given, adds an ICN-4B with both Ids given by the
38              user. There is no checking  against  port-conflicts.  Ports  are
39              checked  later  during  first  activation  while downloading the
40              firmware and can be changed at runtime. Ids are checked  against
41              conflicts,  and if a conflict happens, replaced by the system in
42              the same manner as if no Id was supplied. It is not allowed,  to
43              add cards, after a load was done.
44
45       io [base-address port]
46              sets  the  address  of the memory-mapped IO-region and the port-
47              base.  After loading the icn-module into kernel-space, this com‐
48              mand  should  be  used  as the very first setup, if the hardware
49              settings are different from the default settings below.  If both
50              parameters are omitted, prints out current settings. The default
51              memory address is 0xD0000, the default port-base is  0x320.   An
52              ICN  card  uses 4 port-addresses. The memory address is globally
53              used for all cards (cards are mapped on demand), while each card
54              has its own port range. Memory range is 16k.
55
56       leased on|1|2|off
57              switches  between  normal (dialup) and leased-line mode. Leased-
58              line mode is intended for usage with S64K-lines  or  -  if  both
59              channels are used - for S02. If the second parameter is 1 , only
60              one channel is enabled.  If the second parameter is 2 or on both
61              channels are enabled. Leased lines do not have a D-channel. When
62              leased-line mode is enabled, the driver simulates incoming calls
63              using  special  "phone-numbers"  for  calling and called address
64              which are generated as follows:
65
66              Calling number:
67                     LEASEDx
68                            where x is the  internal  slot-number  of  the  S0
69                            interface. This number starts with 0 for the first
70                            S0 interface and is incremented by one  for  every
71                            S0 interface configured using the add action.
72
73              Called number:
74                     x
75                            where  x  is  equal  to  the channel number of the
76                            calling S0 interface starting with 1.
77
78       load boot-code firmware [firmware2]
79              downloads the firmware into the card and starts operation. Using
80              this command, after loading the icn-module into kernel-space the
81              first real access to the hardware  is  done.  Therefore  the  io
82              action  above,  should  be used before, if the hardware settings
83              are different from the default settings.  Usually the images are
84              located  in  @DATADIR@.  The boot-code is named loadpg.bin.  The
85              firmware depends on the D-channel protocol of the ISDN line. For
86              German  1TR6-lines,  the  firmware  is  named pc_1t_ca.bin.  For
87              Euro-ISDN-lines, it is  named  pc_eu_ca.bin.   When  loading  an
88              ICN-4B,  two  firmware parameters have to be supplied. The first
89              firmware is used for the upper S0 connector, the second firmware
90              is used for the lower S0 connector (towards the card's slot con‐
91              nector).
92
93       dump   is available if the program is configured  using  the  --enable-
94              dump  option  only. The contents of internal driver variables is
95              dumped on stdout.
96

FILES

98       @DATADIR@/loadpg.bin
99              This is the image of  the  bootstrap  loader,  which  is  loaded
100              first, then loads the firmware into the card's memory and starts
101              execution.
102
103       @DATADIR@/pc_1t_ca.bin
104              This is the image of the firmware designed for the  German  1TR6
105              protocol.
106
107       @DATADIR@/pc_eu_ca.bin
108              This is the image of the firmware, designed for Euro ISDN.
109

DIAGNOSTICS

111       The following diagnostics may be issued on stderr:
112
113       Read error on boot-code
114              The  file  supplied as boot-code has less than 4096 bytes length
115              or could not be read.
116
117       Read error on firmware
118              The file supplied as firmware has less than 65536  bytes  length
119              or could not be read.
120

BUGS

122       No bugs so far.
123

AUTHOR

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

SEE ALSO

128       isdnctrl(8), icn(4), isdnctrl(4), ttyI(4).
129
130
131
132isdn4k-utils-3.27                 1999/09/06                        ICNCTRL(8)
Impressum