1ICNCTRL(8) Linux System Administration ICNCTRL(8)
2
3
4
6 icnctrl - configure ICN ISDN adaptor
7
9 icnctrl [-d Driver-Id] action options ...
10
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
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
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
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
122 No bugs so far.
123
125 © 1997 by Fritz Elfert <fritz@isdn4linux.de>
126
128 isdnctrl(8), icn(4), isdnctrl(4), ttyI(4).
129
130
131
132isdn4k-utils-3.27 1999/09/06 ICNCTRL(8)