ICNCTRL(8) Linux System Administration ICNCTRL(8)
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, sup-
port 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 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 different from the default
settings below. If both parameters are omitted, prints out current set-
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 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 incre-
mented 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 com-
mand, 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 AT isdn4linux.de>
SEE ALSO
isdnctrl(8), icn(4), isdnctrl(4), ttyI(4).
isdn4k-utils-3.7 1999/09/06 ICNCTRL(8)
Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache/1.3.41 (Unix) PHP/5.2.5 mod_perl/1.30 mod_gzip/1.3.26.1a
Under GNU General Public License
2008-12-02 05:45 @38.103.63.58 CrawledBy CCBot/1.0 (+http://www.commoncrawl.org/bot.html)