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