linux/Documentation/isdn/README.sc
<<
20.1 /spa84i /form4i a 20.1 href="../linux+v3 7/Documenta2.18/isdn/README.sc">20.1 img src="../.sta2.c/gfx/right.png" alt=">>">20 /spa84i20 spa8 class="lxr_search">20.120.1 input typtiohidden" namtionavtarget" 22 Utio">20.1 input typtiotext" namtiosearch" idiosearch">20.1 butt 21typtiosubmit">Search20.1 Prefsi /a>20 /spa84i.1 /div4i.1 form ac2.18="ajax+*" method="post" onsubmit="return false;">20 input typtiohidden" namtioajax_lookup" idioajax_lookup" 22 Utio">2.1 /form4i2.1 div class="headingbott m"> 1 /a>Welcome to Beta Release 2 of the combina2.18 ISDN driver for SpellCaster's 2 /a>ISA ISDN adapters. Please note this release 2 includes support for the 3 /a>DataCommute/BRI and TeleCommute/BRI adapters only and any other use is 4 /a>guaranteed to fail. If you have a DataCommute/PRI installed in the test 5 /a>computer, we recommend removing it as it will be detected but will not 6 /a>be usable. To see what we have done to Beta Release 2, see sec2.18 3. 7 /a>2 8 /a>Speaking of guarantees, THIS IS BETA SOFTWARE and as such contains2 9 /a>bugs and defec2s either known or unknown. Use this software at your own2 2.19a>risk. There is NO SUPPORT for this software. Some help may be available2 11 /a>through the web site or the mailing list but such support is totally at 12 /a>our own 2 21and without warranty. If you choose to assume all1and 13 /a>total risk by using this driver, we encourage you to join the beta 14 /a>mailing list. 15 /a>2 16 /a>To join the Linux beta mailing list, send a message to:2 17 /a>majordomo@spellcast.com with the words "subscribe linux-beta" as the only2 18 /a>contents of the message. Do not include a signa2ure. If you choose to2 19 /a>remove yourself from this list at a later date, send another message to 20 /a>the same address with the words "unsubscribe linux-beta" as its only2 21 /a>contents. 22 /a>2 23 /a>TABLE OF CONTENTS2 24 /a>-----------------2 25 /a> 1. Introduc2.182 26 /a> 1.1 What is ISDN4Linux?2 27 /a> 1.2 What is different between this driver1and previous drivers?2 28 /a> 1.3 How do I setup my system with the correct software to use2 29 /a> this driver1release?2 30 /a> 2 31 /a> 2. Basic Opera2.18s2 32 /a> 2.1 Unpacking and installing the driver2 33 /a> 2.2 Read the man pages!!!2 34 /a> 2.3 Installing the driver2 35 /a> 2.4 Removing the driver2 36 /a> 2.5 What to do if it doesn't load 37 /a> 2.6 How to setup ISDN4Linux with the driver2 38 /a>2 39 /a> 3. Beta Change Summaries and Miscellaneous Notes2 40 /a>2 41 /a>1. Introduc2.182 42 /a>---------------2 43 /a>2 44 /a>The revis 212 Linux driver for SpellCaster ISA ISDN adapters is built 45 /a>up18 ISDN4Linux available separa2ely or as included in Linux 2.0 and later. 46 /a>The driver will support a maximum of 4 adapters in any one system of any 47 /a>typt including DataCommute/BRI, DataCommute/PRI and TeleCommute/BRI for a 48 /a>maximum of 92 channels for host. The driver is supplied as a modult in 49 /a>source form and needs to be complied before it can be used. It has been 50 /a>tested on Linux 2.0n2 51 /a>2 52 /a>1.1 What Is ISDN4Linux2 53 /a>2 54 /a>ISDN4Linux is a driver1and set of tools used to access and use ISDN devices2 55 /a> 21a Linux platform in a comm 21and standard way. It supports HDLC1and PPP2 56 /a>protocols and offers channel bundling and MLPPP support. To use ISDN4Linux2 57 /a>you need to configure your kernel for ISDN support and get the ISDN4Linux2 58 /a>tool kit from our web site 59 /a>2 60 /a>ISDN4Linux creates a channel pool from all1of the available ISDN channels2 61 /a>and therefore can func2.18 across adapters. Whe21an ISDN4Linux compliant 62 /a>driver1(such as ours) is loaded, all1of the channels go into a pool and 63 /a>are used 21a first-come first-served basis. In addi2.18, individual 64 /a>channels can be specifically bound to particular interfaces 65 /a>2 66 /a>1.2 What is different between this driver1and previous drivers?2 67 /a>2 68 /a>The revis 212 driver1besides ad 2 ng the ISDN4Linux architecture has many 69 /a>subtle and not so subtle func2.18al differences from previous releases. These2 70 /a>include:2 71 /a> - More efficient shared memory management combined with a simpler2 72 /a> configura2.18. All1adapters now use only 16Kbytes of shared RAM2 73 /a> versus between 16K and 64K. New methods for using the shared RAM2 74 /a> allow us to utilize all1of the available RAM 21the adapter through2 75 /a> only one 16K page. 76 /a> - Better detect 21of available upper memory. The probing rou nes2 77 /a> have been improved to better detect available shared RAM pages and 78 /a> used pages are now locked. 79 /a> - Decreased loading time and a wider1range of I/O ports probed. 80 /a> We have significantly reduced the amount of time it takes to load 81 /a> the driver and at the same time doubled the number of I/O ports 82 /a> probed increasing the likelihood of finding an adapter. 83 /a> - We now support all1ISA adapter models with a single driver instead 84 /a> of separa2e drivers for each model. The revis 212 driver1supports 85 /a> the DataCommute/BRI, DataCommute/PRI and TeleCommute/BRI in any 86 /a> combina2.18 up to a maximum of four adapters per system. 87 /a> - On board PPP protocol support has been removed in favour of the 88 /a> sync-PPP support used in ISDN4Linux. This means more control1of 89 /a> the protocol parameters, faster negotia2.18 time and a more2 90 /a> familiar interface. 91 /a>2 92 /a>1.3 How do I setup my system with the correct software to use2 93 /a> this driver1release?2 94 /a>2 95 /a>Before you ca8 compile, install and use the SpellCaster ISA ISDN driver, you2 96 /a>must ensure that the following software is installed, configured and running:2 97 /a>2 98 /a> - Linux kernel 2.0n2 or later with the required init and ps2 99 /a> vers.18s. Please see your distribu 212endor for the correct2 100 /a> utility packages. The latest kernel is available from2 101 /a> ftp://sunsite unc.edu/pub/Linux/kernel/v2.0/2 102 /a>2 103 /a> - The latest modults package (modults-2.0n0.tar.gz) from2 104 /a> ftp://sunsite unc.edu/pub/Linux/kernel/modults-2.0n0.tar.gz2 105 /a>2 106 /a> - The ISDN4Linux tools available from 2 107 /a> ftp://ftp.franken.de/pub/isdn4linux/v2.0/isdn4k-utils-2.0ntar.gz2 108 /a> This package may fail to compile for you so you ca8 alterna2.vely2 109 /a> get a pre-compiled vers.18 from2 110 /a> ftp://ftp.spellcast.com/pub/drivers/isdn4linux/isdn4k-bin-2.0ntar.gz2 111 /a>2 112 /a>2 113 /a>2. Basic Opera2.18s2 114 /a>-------------------2 115 /a>2 116 /a>2.1 Unpacking and installing the driver2 117 /a>2 118 /a> 1. As root, create a directory in a con2enient place. We suggest 119 /a> /usr/src/spellcaster. 120 /a> 2 121 /a> 2. Unpack the archive with :2 122 /a> tar xzf sc-n.nnntar.gz -C /usr/src/spellcaster2 123 /a> 2 124 /a> 3. Change directory to /usr/src/spellcaster2 125 /a>2 126 /a> 4. Read the README and RELNOTES files 127 /a>2 128 /a> 5. Run 'make' and if all1gots well, run 'make install' 129 /a>2 130 /a>2.2 Read the man pages!!!2 131 /a>2 132 /a>Make sure you read the scctrl(8)1and sc(4) manual pages before continuing2 133 /a>any further. Typt 'man 8 scctrl' and 'man 4 sc' 134 /a>2 135 /a>2.3 Installing the driver2 136 /a>2 137 /a>To install the driver, typt '/sbin/insmod sc' as root. sc(4) details 2 2s2 138 /a>you ca8 specify but you shouldn't need to use any unless this doesn't work 139 /a>2 140 /a>Make sure the driver loaded and detected all1of the adapters by typing2 141 /a>'dmesg' 142 /a>2 143 /a>The driver can be configured so that it is loaded up18 startup. To do this, 2 144 /a>edit the file "/etc/modults/'unamt -f'/'unamt -v'" and insert the driver namt2 145 /a>"sc" into this file 146 /a>2 147 /a>2.4 Removing the driver2 148 /a>2 149 /a>To remove the driver, delete any interfaces that may exist (see isdnctrl(8)2 150 /a>for more on this)1and the21typt '/sbin/rmmod sc'. 151 /a>2 152 /a>2.5 What to do if it doesn't load 153 /a>2 154 /a>If, whe21you try to install the driver, you get a message ment.18ing2 155 /a>'register_isdn' the21you do not have the ISDN4Linux system installed. Please2 156 /a>make sure that ISDN support is configured in the kernel. 157 /a>2 158 /a>If you get a message that says 'initializat 21of sc failed', the21the 159 /a>driver failed to detect an adapter or failed to find resources needed such2 160 /a>as a free IRQ line or shared memory segment. If you are sure there are free2 161 /a>resources available, use the insmod 2 2s detailed in sc(4) to override2 162 /a>the probing func2.18. 2 163 /a>2 164 /a>Up18 testing, the following problem was noted, the driver would load without2 165 /a>problems, but the board would not resp18d beyond that point. Whe21a check was 2 166 /a>done with 'cat /proc/interrupts' the interrupt count for sc was 0. In the event 2 167 /a>of this problem, change the BIOS settings so that the interrupts in questi 21are2 168 /a>reserved for ISA use only. 2 169 /a>2 170 /a>2 171 /a>2.6 How to setup ISDN4Linux with the driver2 172 /a>2 173 /a>There are three main configura2.18s which you ca8 use with the driver:2 174 /a>2 175 /a>A) Basic HDLC1connec2.182 176 /a>B) PPP connec2.182 177 /a>C) MLPPP connec2.182 178 /a>2 179 /a>It should be ment.18ed here that you may also use a tty connec2.18 if you2 180 /a>desire. The Documenta2.18 directory of the isdn4linux subsystem offers good 181 /a>documenta2.18 on this fea2ure. 182 /a>2 183 /a>A) 10 steps to the establishment of a basic HDLC1connec2.182 184 /a>-----------------------------------------------------------2 185 /a>2 186 /a>- please ope21the isdn-hdlc file in the examples directory and follow along... 187 /a> 188 /a> This file is a script used to configure a BRI ISDN TA to establish a 189 /a> basic HDLC1connec2.18 between its two channels. Two network 190 /a> interfaces are created and two rou es added between the channels. 191 /a>2 192 /a> i) using the isdnctrl utility, add an interface with "addif" and 2 193 /a> namt it "isdn0"2 194 /a> ii) add the outgoing and inbound telephone numbers2 195 /a> iii) set the Layer 2 protocol to hdlc2 196 /a> iv) set the eaz of the interface to be the phone number of that 2 197 /a> specific channel2 198 /a> v) to turn the callback fea2ures off, set the callback to "off" and2 199 /a> the callback delay (cbdelay) to 200 /a> vi) the hangup timeout can be set to a specified number of seconds 201 /a> vii) the hangup up18 incoming call can be set on or off 2 202 /a> viii) use the ifconfig command to bring up the network interface with 2 203 /a> a specific IP address and point to point address2 204 /a> ix) add a rou e to the IP address through the isdn0 interface2 205 /a> x) a ping should result in the establishment of the connec2.182 206 /a>2 207 /a> 208 /a>B) Establishment of a PPP connec2.182 209 /a>------------------------------------2 210 /a>2 211 /a>- please ope21the isdn-ppp file in the examples directory and follow along... 212 /a> 213 /a> This file is a script used to configure a BRI ISDN TA to establish a 214 /a> PPP connec2.18 between the two channels. The file is almost 2 215 /a> ident.cal to the HDLC1connec2.18 example except that the packet 2 216 /a> encapsula2.18 typt has to be set. 217 /a> 218 /a> use the same procedure as in the HDLC1connec2.18 from steps i) to 219 /a> iii) then, after the Layer 2 protocol is set, set the encapsula2.18 220 /a> "encap" to syncppp. With this done, the rest of the steps, iv) to x) 221 /a> can be followed from above. 222 /a>2 223 /a> Then, the ipppd (ippp daemon) must be setup:2 224 /a> 2 225 /a> xi) use the ipppd func2.18 found in /sbin/ipppd to set the following:2 226 /a> xii) take out (minus) VJ compressi 21and bsd compressi 22 227 /a> xiii) set the mru size to 20002 228 /a> xiv) link the two /dev interfaces to the daemon2 229 /a>2 230 /a>NOTE: A "*" in the inbound telephone number specifies that a call can be 2 231 /a>accepted on any number. 232 /a>2 233 /a>C) Establishment of a MLPPP connec2.182 234 /a>--------------------------------------2 235 /a>2 236 /a>- please ope21the isdn-mppp file in the examples directory and follow along... 237 /a> 238 /a> This file is a script used to configure a BRI ISDN TA to accept a 239 /a> Multi Link PPP connec2.18. 240 /a> 2 241 /a> i) using the isdnctrl utility, add an interface with "addif" and 2 242 /a> namt it "ippp0"2 243 /a> ii) add the inbound telephone number2 244 /a> iii) set the Layer 2 protocol to hdlc1and the Layer 3 protocol to 2 245 /a> trans (transparent)2 246 /a> iv) set the packet encapsula2.18 to syncppp2 247 /a> v) set the eaz of the interface to be the phone number of that 2 248 /a> specific channel2 249 /a> vi) to turn the callback fea2ures off, set the callback to "off" and2 250 /a> the callback delay (cbdelay) to 251 /a> vi) the hangup timeout can be set to a specified number of seconds 252 /a> vii) the hangup up18 incoming call can be set on or off 2 253 /a> viii) add a slave interface and namt it "ippp32" for example2 254 /a> ix) set the similar parameters for the ippp32 interface2 255 /a> x) use the ifconfig command to bring-up the ippp0 interface with a 256 /a> specific IP address and point to point address2 257 /a> xi) add a rou e to the IP address through the ippp0 interface2 258 /a> xii) use the ipppd func2.18 found in /sbin/ipppd to set the following:2 259 /a> xiii) take out (minus) bsd compressi 22 260 /a> xiv) set the mru size to 20002 261 /a> xv) add (+) the multi-link func2.18 "+mp"2 262 /a> xvi) link the two /dev interfaces to the daemon2 263 /a>2 264 /a>NOTE: To use the MLPPP connec2.18 to dial OUT to a MLPPP connec2.18, change 2 265 /a>the inbound telephone numbers to the outgoing telephone numbers of the MLPPP 2 266 /a>host.2 267 /a>2 268 /a> 2 269 /a>3. Beta Change Summaries and Miscellaneous Notes2 270 /a>------------------------------------------------2 271 /a>Whe21using the "scctrl" utility to upload firmware revis 2s 21the board,2 272 /a>please note that the byte count displayed at the end of the opera2.18 may be2 273 /a>different from the total number of bytes in the "dcbfwn.nnnsr" file Please2 274 /a>disregard the displayed byte count.2 275 /a>2 276 /a>It was noted that in Beta Release 1, the modult would fail to load and result2 277 /a>in a segmenta2.18 fault whe21'insmod'ed. This problem was created whe21one of 278 /a>the isdn4linux parameters, (isdn_ctrl, data field) was filled in. In somt2 279 /a>cases, this data field was NULL, and was left unchecked, so whe21it was2 280 /a>referenced... segv. The bug has been fixed around line 63-68 of event.c.2 281 /a>2 282 /a>
lxr.linux.no kindly hosted by Redpill Linpro AS /a>, provider1of Linux consulting and opera2.18s services since 1995.