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, support 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
conflicts, 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 settings. 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 incremented 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 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 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@isdn4linux.de>
SEE ALSO
isdnctrl(8), icn(4), isdnctrl(4), ttyI(4).
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
