MAN page from RedHat Other isdn4k-utils-9803020842-1.i386.rpm

ICNCTRL

Section: Linux System Administration (8)
Updated: 1997/10/23
Index

NAME

icnctrl - configure ICN ISDN adaptor

SYNOPSIS

icnctrl [-dDriver-Id]action options...

DESCRIPTION

icnctrlis used to setup the ICNISDNdevice driver and for downloading the firmware into theISDNcard.

The use oficnctrlmakes sense, if you are using an ICN card only.

OPTIONS

-d Driver-Id: selects the S0 interface named byDriver-Id.Driver-Ids are defined during driver initialisation. Seeicn(4)for a description of the syntax to be used for modularised andmonolithic driver versions.This optionmustbe used to identify the S0 interface if more than one S0 interface isexistent. If a single ICN-2B is used, it may be omitted.If using more than one card, support for the other cards is enabledwith theaddaction of icnctrl. Ids maynotstart withdigitsor smallx,because these values are misinterpretedas numeric parameters byinsmod.For loading the module, always thenewestmodutilspackage should be used to avoid problems during load.

The following actionsmay be given toicnctrl.

add port [id1 [id2]]

enables support for an additional card in the driver. Ifid1 and id2are missing, adds an ICN-2B with an id given by the system. withid2missing, adds an ICN-2B with an Id given by the user. With both Idsgiven, adds an ICN-4B with both Ids given by the user. There isno checkingagainst port-conflicts. Ports are checked later during first activationwhile downloading the firmware and can be changed at runtime. Ids arechecked against conflicts, and if a conflict happens, replaced by thesystem in the same manner as if no Id was supplied. It isnot allowed,to add cards,after a loadwas 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 commandshould be used as the very first setup, if the hardware settings aredifferent from the default settings below.If both parameters are omitted, prints out current settings. Thedefault memory address is0xD0000,the default port-base is0x320.An ICN card uses 4 port-addresses. The memory address is globally usedfor all cards (cards are mapped on demand), while each card has itsown port range. Memory range is16k.

leased on|1|2|off

switches between normal (dialup) and leased-line mode. Leased-line modeis intended for usage with S64K-lines or - if both channels are used -for S02. If the second parameter is1, only one channel is enabled.If the second parameter is2 or onboth channels are enabled. Leased lines do not have a D-channel. Whenleased-line mode is enabled, the driver simulates incoming calls usingspecial "phone-numbers" for calling and called address which are generatedas follows:

Calling number:

LEASEDx

: wherexis the internal slot-number of the S0 interface. This number starts with0for the first S0 interface and is incremented by one for every S0 interfaceconfigured using theaddaction.

Called number:

: wherexis equal to the channel number of the calling S0 interface starting with1.

load boot-code firmware [firmware2]

downloads the firmware into the card and starts operation. Using thiscommand, after loading the icn-module into kernel-space the first realaccess to the hardware is done. Therefore theioaction above, should be used before, if the hardware settings are differentfrom the default settings.Usually the images are located in@DATADIR@.The boot-code is namedloadpg.bin.The firmware depends on the D-channel protocol of theISDNline. For German 1TR6-lines, thefirmware is namedpc_1t_ca.bin.For Euro-ISDN-lines, it is namedpc_eu_ca.bin.When loading an ICN-4B,twofirmware parameters have to be supplied. The first firmware is used for theupper 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-dumpoption 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, thenloads 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 asboot-codehas less than 4096 bytes length or could not be read.
Read error on firmware: The file supplied asfirmwarehas less than 65536 bytes length or could not be read.

BUGS

No bugs so far.

AUTHOR

This document was created byman2html,using the manual pages.