1 2SliceCOM adapter felhasznaloi dokumentacioja - 0.51 verziohoz 3 4Bart��k Istv��n <bartoki@itc.hu> 5Utolso modositas: Wed Aug 29 17:26:58 CEST 2001 6 7----------------------------------------------------------------- 8 9Hasznalata: 10 11Forditas: 12 13Code maturity level options 14 [*] Prompt for development and/or incomplete code/drivers 15 16Network device support 17 Wan interfaces 18 <M> MultiGate (COMX) synchronous 19 <M> Support for MUNICH based boards: SliceCOM, PCICOM (NEW) 20 <M> Support for HDLC and syncPPP... 21 22 23A modulok betoltese: 24 25modprobe comx 26 27modprobe comx-proto-ppp # a Cisco-HDLC es a SyncPPP protokollt is 28 # ez a modul adja 29 30modprobe comx-hw-munich # a modul betoltodeskor azonnal jelent a 31 # syslogba a detektalt kartyakrol 32 33 34Konfiguralas: 35 36# Ezen az interfeszen Cisco-HDLC vonali protokoll fog futni 37# Az interfeszhez rendelt idoszeletek: 1,2 (128 kbit/sec-es vonal) 38# (a G.703 keretben az elso adatot vivo idoszelet az 1-es) 39# 40mkdir /proc/comx/comx0.1/ 41echo slicecom >/proc/comx/comx0.1/boardtype 42echo hdlc >/proc/comx/comx0.1/protocol 43echo 1 2 >/proc/comx/comx0.1/timeslots 44 45 46# Ezen az interfeszen SyncPPP vonali protokoll fog futni 47# Az interfeszhez rendelt idoszelet: 3 (64 kbit/sec-es vonal) 48# 49mkdir /proc/comx/comx0.2/ 50echo slicecom >/proc/comx/comx0.2/boardtype 51echo ppp >/proc/comx/comx0.2/protocol 52echo 3 >/proc/comx/comx0.2/timeslots 53 54... 55 56ifconfig comx0.1 up 57ifconfig comx0.2 up 58 59----------------------------------------------------------------- 60 61A COMX driverek default 20 csomagnyi transmit queue-t rendelnek a halozati 62interfeszekhez. WAN halozatokban ennel hosszabbat is szokas hasznalni 63(20 es 100 kozott), hogy a vonal kihasznaltsaga nagy terheles eseten jobb 64legyen (bar ezzel megno a varhato kesleltetes a csomagok sorban allasa miatt): 65 66# ifconfig comx0 txqueuelen 50 67 68Ezt a beallitasi lehetoseget csak az ujabb disztribuciok ifconfig parancsa 69tamogatja (amik mar a 2.2 kernelekhez keszultek, mint a RedHat 6.1 vagy a 70Debian 2.2). 71 72A 2.1-es Debian disztribuciohoz a http://www.debian.org/~rcw/2.2/netbase/ 73cimrol toltheto le ujabb netbase csomag, ami mar ilyet tamogato ifconfig 74parancsot tartalmaz. Bovebben a 2.2 kernel hasznalatarol Debian 2.1 alatt: 75http://www.debian.org/releases/stable/running-kernel-2.2 76 77----------------------------------------------------------------- 78 79A kartya LED-jeinek jelentese: 80 81piros - eg, ha Remote Alarm-ot kuld a tuloldal 82zold - eg, ha a vett jelben megtalalja a keretszinkront 83 84Reszletesebben: 85 86piros: zold: jelentes: 87 88- - nincs keretszinkron (nincs jel, vagy rossz a jel) 89- eg "minden rendben" 90eg eg a vetel OK, de a tuloldal Remote Alarm-ot kuld 91eg - ez nincs ertelmezve, egyelore funkcio nelkul 92 93----------------------------------------------------------------- 94 95Reszletesebb leiras a hardver beallitasi lehetosegeirol: 96 97Az altalanos,- es a protokoll-retegek beallitasi lehetosegeirol a 'comx.txt' 98fajlban leirtak SliceCOM kartyanal is ervenyesek, itt csak a hardver-specifikus 99beallitasi lehetosegek vannak osszefoglalva: 100 101Konfiguralasi interfesz a /proc/comx/ alatt: 102 103Minden timeslot-csoportnak kulon comx* interfeszt kell letrehozni mkdir-rel: 104comx0, comx1, .. stb. Itt beallithato, hogy az adott interfesz hanyadik kartya 105melyik timeslotja(i)bol alljon ossze. A Cisco-fele serial3:1 elnevezesek 106(serial3:1 = a 3. kartyaban az 1-es idoszelet-csoport) Linuxon aliasing-ot 107jelentenenek, ezert mi nem tudunk ilyen elnevezest hasznalni. 108 109Tobb kartya eseten a comx0.1, comx0.2, ... vagy slice0.1, slice0.2 nevek 110hasznalhatoak. 111 112Tobb SliceCOM kartya is lehet egy gepben, de sajat interrupt kell mindegyiknek, 113nem tud meg megosztott interruptot kezelni. 114 115Az egesz kartyat erinto beallitasok: 116 117Az ioport es irq beallitas nincs: amit a PCI BIOS kioszt a rendszernek, 118azt hasznalja a driver. 119 120 121comx0/boardnum - hanyadik SliceCOM kartya a gepben (a 'termeszetes' PCI 122 sorrendben ertve: ahogyan a /proc/pci-ban vagy az 'lspci' 123 kimeneteben megjelenik, altalaban az alaplapi PCI meghajto 124 aramkorokhoz kozelebb eso kartyak a kisebb sorszamuak) 125 126 Default: 0 (0-tol kezdodik a szamolas) 127 128 129Bar a kovetkezoket csak egy-egy interfeszen allitjuk at, megis az egesz kartya 130mukodeset egyszerre allitjak. A megkotes hogy csak UP-ban levo interfeszen 131hasznalhatoak, azert van, mert kulonben nem vart eredmenyekre vezetne egy ilyen 132paranccsorozat: 133 134 echo 0 >boardnum 135 echo internal >clock_source 136 echo 1 >boardnum 137 138- Ez a 0-s board clock_source-at allitana at. 139 140Ezek a beallitasok megmaradnak az osszes interfesz torlesekor, de torlodnek 141a driver modul ki/betoltesekor. 142 143 144comx0/clock_source - A Tx orajelforrasa, a Cisco-val hasonlatosra keszult. 145 Hasznalata: 146 147 papaya:# echo line >/proc/comx/comx0/clock_source 148 papaya:# echo internal >/proc/comx/comx0/clock_source 149 150 line - A Tx orajelet a vett adatfolyambol dekodolja, igyekszik 151 igazodni hozza. Ha nem lat orajelet az inputon, akkor 152 atall a sajat orajelgeneratorara. 153 internal - A Tx orajelet a sajat orajelgeneratora szolgaltatja. 154 155 Default: line 156 157 Normal osszeallitas eseten a tavkozlesi szolgaltato eszkoze 158 (pl. HDSL modem) adja az orajelet, ezert ez a default. 159 160 161comx0/framing - A CRC4 ki/be kapcsolasa 162 163 A CRC4: 16 PCM keretet (A PCM keret az, amibe a 32 darab 64 164 kilobites csatorna van bemultiplexalva. Nem osszetevesztendo a HDLC 165 kerettel.) 2x8 -as csoportokra osztanak, es azokhoz 4-4 bites CRC-t 166 szamolnak. Elsosorban a vonal minosegenek a monitorozasara szolgal. 167 168 papaya:~# echo crc4 >/proc/comx/comx0/framing 169 papaya:~# echo no-crc4 >/proc/comx/comx0/framing 170 171 Default a 'crc4', a MATAV vonalak altalaban igy futnak. De ha nem 172 egyforma is a beallitas a vonal ket vegen, attol a forgalom altalaban 173 at tud menni. 174 175 176comx0/linecode - A vonali kodolas beallitasa 177 178 papaya:~# echo hdb3 >/proc/comx/comx0/linecode 179 papaya:~# echo ami >/proc/comx/comx0/linecode 180 181 Default a 'hdb3', a MATAV vonalak igy futnak. 182 183 (az AMI kodolas igen ritka E1-es vonalaknal). Ha ez a beallitas nem 184 egyezik a vonal ket vegen, akkor elofordulhat hogy a keretszinkron 185 osszejon, de CRC4-hibak es a vonalakon atvitt adatokban is hibak 186 keletkeznek (amit a HDLC/SyncPPP szinten CRC-hibaval jelez) 187 188 189comx0/reg - a kartya aramkoreinek, a MUNICH (reg) es a FALC (lbireg) 190comx0/lbireg regisztereinek kozvetlen elerese. Hasznalata: 191 192 echo >reg 0x04 0x0 - a 4-es regiszterbe 0-t ir 193 echo >reg 0x104 - printk()-val kiirja a 4-es regiszter 194 tartalmat a syslogba. 195 196 WARNING: ezek csak a fejleszteshez keszultek, sok galibat 197 lehet veluk okozni! 198 199 200comx0/loopback - A kartya G.703 jelenek a visszahurkolasara is van lehetoseg: 201 202 papaya:# echo none >/proc/comx/comx0/loopback 203 papaya:# echo local >/proc/comx/comx0/loopback 204 papaya:# echo remote >/proc/comx/comx0/loopback 205 206 none - nincs visszahurkolas, normal mukodes 207 local - a kartya a sajat maga altal adott jelet kapja vissza 208 remote - a kartya a kivulrol vett jelet adja kifele 209 210 Default: none 211 212----------------------------------------------------------------- 213 214Az interfeszhez (Cisco terminologiaban 'channel-group') kapcsolodo beallitasok: 215 216comx0/timeslots - mely timeslotok (idoszeletek) tartoznak az adott interfeszhez. 217 218 papaya:~# cat /proc/comx/comx0/timeslots 219 1 3 4 5 6 220 papaya:~# 221 222 Egy timeslot megkeresese (hanyas interfeszbe tartozik nalunk): 223 224 papaya:~# grep ' 4' /proc/comx/comx*/timeslots 225 /proc/comx/comx0/timeslots:1 3 4 5 6 226 papaya:~# 227 228 Beallitasa: 229 papaya:~# echo '1 5 2 6 7 8' >/proc/comx/comx0/timeslots 230 231 A timeslotok sorrendje nem szamit, '1 3 2' ugyanaz mint az '1 2 3'. 232 233 Beallitashoz az adott interfesznek DOWN-ban kell lennie 234 (ifconfig comx0 down), de ugyanannak a kartyanak a tobbi interfesze 235 uzemelhet kozben. 236 237 Beallitaskor leellenorzi, hogy az uj timeslotok nem utkoznek-e egy 238 masik interfesz timeslotjaival. Ha utkoznek, akkor nem allitja at. 239 240 Mindig 10-es szamrendszerben tortenik a timeslotok ertelmezese, nehogy 241 a 08, 09 alaku felirast rosszul ertelmezze. 242 243----------------------------------------------------------------- 244 245Az interfeszek es a kartya allapotanak lekerdezese: 246 247- A ' '-szel kezdodo sorok az eredeti kimenetet, a //-rel kezdodo sorok a 248magyarazatot jelzik. 249 250 papaya:~$ cat /proc/comx/comx1/status 251 Interface administrative status is UP, modem status is UP, protocol is UP 252 Modem status changes: 0, Transmitter status is IDLE, tbusy: 0 253 Interface load (input): 978376 / 947808 / 951024 bits/s (5s/5m/15m) 254 (output): 978376 / 947848 / 951024 bits/s (5s/5m/15m) 255 Debug flags: none 256 RX errors: len: 22, overrun: 1, crc: 0, aborts: 0 257 buffer overrun: 0, pbuffer overrun: 0 258 TX errors: underrun: 0 259 Line keepalive (value: 10) status UP [0] 260 261// Itt kezdodik a hardver-specifikus resz: 262 Controller status: 263 No alarms 264 265// Alarm: hibajelzes: 266// 267// No alarms - minden rendben 268// 269// LOS - Loss Of Signal - nem erzekel jelet a bemeneten. 270// AIS - Alarm Indication Signal - csak egymas utani 1-esek jonnek 271// a bemeneten, a tuloldal igy is jelezheti hogy meghibasodott vagy 272// nincs inicializalva. 273// AUXP - Auxiliary Pattern Indication - 01010101.. sorozat jon a bemeneten. 274// LFA - Loss of Frame Alignment - nincs keretszinkron 275// RRA - Receive Remote Alarm - a tuloldal el, de hibat jelez. 276// LMFA - Loss of CRC4 Multiframe Alignment - nincs CRC4-multikeret-szinkron 277// NMF - No Multiframe alignment Found after 400 msec - ilyen alarm a no-crc4 278// es crc4 keretezesek eseten nincs, lasd lentebb 279// 280// Egyeb lehetseges hibajelzesek: 281// 282// Transmit Line Short - a kartya ugy erzi hogy az adasi kimenete rovidre 283// van zarva, ezert kikapcsolta az adast. (nem feltetlenul veszi eszre 284// a kulso rovidzarat) 285 286// A veteli oldal csomagjainak lancolt listai, debug celokra: 287 288 Rx ring: 289 rafutott: 0 290 lastcheck: 50845731, jiffies: 51314281 291 base: 017b1858 292 rx_desc_ptr: 0 293 rx_desc_ptr: 017b1858 294 hw_curr_ptr: 017b1858 295 06040000 017b1868 017b1898 c016ff00 296 06040000 017b1878 017b1e9c c016ff00 297 46040000 017b1888 017b24a0 c016ff00 298 06040000 017b1858 017b2aa4 c016ff00 299 300// A kartyat hasznalo tobbi interfesz: a 0-s channel-group a comx1 interfesz, 301// es az 1,2,...,16 timeslotok tartoznak hozza: 302 303 Interfaces using this board: (channel-group, interface, timeslots) 304 0 comx1: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 305 1 comx2: 17 306 2 comx3: 18 307 3 comx4: 19 308 4 comx5: 20 309 5 comx6: 21 310 6 comx7: 22 311 7 comx8: 23 312 8 comx9: 24 313 9 comx10: 25 314 10 comx11: 26 315 11 comx12: 27 316 12 comx13: 28 317 13 comx14: 29 318 14 comx15: 30 319 15 comx16: 31 320 321// Hany esemenyt kezelt le a driver egy-egy hardver-interrupt kiszolgalasanal: 322 323 Interrupt work histogram: 324 hist[ 0]: 0 hist[ 1]: 2 hist[ 2]: 18574 hist[ 3]: 79 325 hist[ 4]: 14 hist[ 5]: 1 hist[ 6]: 0 hist[ 7]: 1 326 hist[ 8]: 0 hist[ 9]: 7 327 328// Hany kikuldendo csomag volt mar a Tx-ringben amikor ujabb lett irva bele: 329 330 Tx ring histogram: 331 hist[ 0]: 2329 hist[ 1]: 0 hist[ 2]: 0 hist[ 3]: 0 332 333// Az E1-interfesz hiba-szamlaloi, az rfc2495-nek megfeleloen: 334// (kb. a Cisco routerek "show controllers e1" formatumaban: http://www.cisco.com/univercd/cc/td/doc/product/software/ios11/rbook/rinterfc.htm#xtocid25669126) 335 336Data in current interval (91 seconds elapsed): 337 9516 Line Code Violations, 65 Path Code Violations, 2 E-Bit Errors 338 0 Slip Secs, 2 Fr Loss Secs, 2 Line Err Secs, 0 Degraded Mins 339 0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 11 Unavail Secs 340Data in Interval 1 (15 minutes): 341 0 Line Code Violations, 0 Path Code Violations, 0 E-Bit Errors 342 0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins 343 0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 0 Unavail Secs 344Data in last 4 intervals (1 hour): 345 0 Line Code Violations, 0 Path Code Violations, 0 E-Bit Errors 346 0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins 347 0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 0 Unavail Secs 348Data in last 96 intervals (24 hours): 349 0 Line Code Violations, 0 Path Code Violations, 0 E-Bit Errors 350 0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins 351 0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 0 Unavail Secs 352 353----------------------------------------------------------------- 354 355Nehany kulonlegesebb beallitasi lehetoseg (idovel beepulhetnek majd a driverbe): 356Ezekkel sok galibat lehet okozni, nagyon ovatosan kell oket hasznalni! 357 358 modified CRC-4, for improved interworking of CRC-4 and non-CRC-4 359 devices: (lasd page 107 es g706 Annex B) 360 lbireg[ 0x1b ] |= 0x08 361 lbireg[ 0x1c ] |= 0xc0 362 - ilyenkor ertelmezett az NMF - 'No Multiframe alignment Found after 363 400 msec' alarm. 364 365 FALC - a vonali meghajto IC 366 local loop - a sajat adasomat halljam vissza 367 remote loop - a kivulrol jovo adast adom vissza 368 369 Egy hibakeresesre hasznalhato dolog: 370 - 1-es timeslot local loop a FALC-ban: echo >lbireg 0x1d 0x21 371 - local loop kikapcsolasa: echo >lbireg 0x1d 0x00 372