123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371 |
- SliceCOM adapter felhasznaloi dokumentacioja - 0.51 verziohoz
- Bartók István <bartoki@itc.hu>
- Utolso modositas: Wed Aug 29 17:26:58 CEST 2001
- -----------------------------------------------------------------
- Hasznalata:
- Forditas:
- Code maturity level options
- [*] Prompt for development and/or incomplete code/drivers
- Network device support
- Wan interfaces
- <M> MultiGate (COMX) synchronous
- <M> Support for MUNICH based boards: SliceCOM, PCICOM (NEW)
- <M> Support for HDLC and syncPPP...
- A modulok betoltese:
- modprobe comx
- modprobe comx-proto-ppp # a Cisco-HDLC es a SyncPPP protokollt is
- # ez a modul adja
- modprobe comx-hw-munich # a modul betoltodeskor azonnal jelent a
- # syslogba a detektalt kartyakrol
- Konfiguralas:
- # Ezen az interfeszen Cisco-HDLC vonali protokoll fog futni
- # Az interfeszhez rendelt idoszeletek: 1,2 (128 kbit/sec-es vonal)
- # (a G.703 keretben az elso adatot vivo idoszelet az 1-es)
- #
- mkdir /proc/comx/comx0.1/
- echo slicecom >/proc/comx/comx0.1/boardtype
- echo hdlc >/proc/comx/comx0.1/protocol
- echo 1 2 >/proc/comx/comx0.1/timeslots
- # Ezen az interfeszen SyncPPP vonali protokoll fog futni
- # Az interfeszhez rendelt idoszelet: 3 (64 kbit/sec-es vonal)
- #
- mkdir /proc/comx/comx0.2/
- echo slicecom >/proc/comx/comx0.2/boardtype
- echo ppp >/proc/comx/comx0.2/protocol
- echo 3 >/proc/comx/comx0.2/timeslots
- ...
- ifconfig comx0.1 up
- ifconfig comx0.2 up
- -----------------------------------------------------------------
- A COMX driverek default 20 csomagnyi transmit queue-t rendelnek a halozati
- interfeszekhez. WAN halozatokban ennel hosszabbat is szokas hasznalni
- (20 es 100 kozott), hogy a vonal kihasznaltsaga nagy terheles eseten jobb
- legyen (bar ezzel megno a varhato kesleltetes a csomagok sorban allasa miatt):
- # ifconfig comx0 txqueuelen 50
- Ezt a beallitasi lehetoseget csak az ujabb disztribuciok ifconfig parancsa
- tamogatja (amik mar a 2.2 kernelekhez keszultek, mint a RedHat 6.1 vagy a
- Debian 2.2).
- A 2.1-es Debian disztribuciohoz a http://www.debian.org/~rcw/2.2/netbase/
- cimrol toltheto le ujabb netbase csomag, ami mar ilyet tamogato ifconfig
- parancsot tartalmaz. Bovebben a 2.2 kernel hasznalatarol Debian 2.1 alatt:
- http://www.debian.org/releases/stable/running-kernel-2.2
- -----------------------------------------------------------------
- A kartya LED-jeinek jelentese:
- piros - eg, ha Remote Alarm-ot kuld a tuloldal
- zold - eg, ha a vett jelben megtalalja a keretszinkront
- Reszletesebben:
- piros: zold: jelentes:
- - - nincs keretszinkron (nincs jel, vagy rossz a jel)
- - eg "minden rendben"
- eg eg a vetel OK, de a tuloldal Remote Alarm-ot kuld
- eg - ez nincs ertelmezve, egyelore funkcio nelkul
- -----------------------------------------------------------------
- Reszletesebb leiras a hardver beallitasi lehetosegeirol:
- Az altalanos,- es a protokoll-retegek beallitasi lehetosegeirol a 'comx.txt'
- fajlban leirtak SliceCOM kartyanal is ervenyesek, itt csak a hardver-specifikus
- beallitasi lehetosegek vannak osszefoglalva:
- Konfiguralasi interfesz a /proc/comx/ alatt:
- Minden timeslot-csoportnak kulon comx* interfeszt kell letrehozni mkdir-rel:
- comx0, comx1, .. stb. Itt beallithato, hogy az adott interfesz hanyadik kartya
- melyik timeslotja(i)bol alljon ossze. A Cisco-fele serial3:1 elnevezesek
- (serial3:1 = a 3. kartyaban az 1-es idoszelet-csoport) Linuxon aliasing-ot
- jelentenenek, ezert mi nem tudunk ilyen elnevezest hasznalni.
- Tobb kartya eseten a comx0.1, comx0.2, ... vagy slice0.1, slice0.2 nevek
- hasznalhatoak.
- Tobb SliceCOM kartya is lehet egy gepben, de sajat interrupt kell mindegyiknek,
- nem tud meg megosztott interruptot kezelni.
- Az egesz kartyat erinto beallitasok:
- Az ioport es irq beallitas nincs: amit a PCI BIOS kioszt a rendszernek,
- azt hasznalja a driver.
- comx0/boardnum - hanyadik SliceCOM kartya a gepben (a 'termeszetes' PCI
- sorrendben ertve: ahogyan a /proc/pci-ban vagy az 'lspci'
- kimeneteben megjelenik, altalaban az alaplapi PCI meghajto
- aramkorokhoz kozelebb eso kartyak a kisebb sorszamuak)
- Default: 0 (0-tol kezdodik a szamolas)
- Bar a kovetkezoket csak egy-egy interfeszen allitjuk at, megis az egesz kartya
- mukodeset egyszerre allitjak. A megkotes hogy csak UP-ban levo interfeszen
- hasznalhatoak, azert van, mert kulonben nem vart eredmenyekre vezetne egy ilyen
- paranccsorozat:
- echo 0 >boardnum
- echo internal >clock_source
- echo 1 >boardnum
- - Ez a 0-s board clock_source-at allitana at.
- Ezek a beallitasok megmaradnak az osszes interfesz torlesekor, de torlodnek
- a driver modul ki/betoltesekor.
- comx0/clock_source - A Tx orajelforrasa, a Cisco-val hasonlatosra keszult.
- Hasznalata:
- papaya:# echo line >/proc/comx/comx0/clock_source
- papaya:# echo internal >/proc/comx/comx0/clock_source
- line - A Tx orajelet a vett adatfolyambol dekodolja, igyekszik
- igazodni hozza. Ha nem lat orajelet az inputon, akkor
- atall a sajat orajelgeneratorara.
- internal - A Tx orajelet a sajat orajelgeneratora szolgaltatja.
- Default: line
- Normal osszeallitas eseten a tavkozlesi szolgaltato eszkoze
- (pl. HDSL modem) adja az orajelet, ezert ez a default.
- comx0/framing - A CRC4 ki/be kapcsolasa
- A CRC4: 16 PCM keretet (A PCM keret az, amibe a 32 darab 64
- kilobites csatorna van bemultiplexalva. Nem osszetevesztendo a HDLC
- kerettel.) 2x8 -as csoportokra osztanak, es azokhoz 4-4 bites CRC-t
- szamolnak. Elsosorban a vonal minosegenek a monitorozasara szolgal.
- papaya:~# echo crc4 >/proc/comx/comx0/framing
- papaya:~# echo no-crc4 >/proc/comx/comx0/framing
- Default a 'crc4', a MATAV vonalak altalaban igy futnak. De ha nem
- egyforma is a beallitas a vonal ket vegen, attol a forgalom altalaban
- at tud menni.
- comx0/linecode - A vonali kodolas beallitasa
- papaya:~# echo hdb3 >/proc/comx/comx0/linecode
- papaya:~# echo ami >/proc/comx/comx0/linecode
- Default a 'hdb3', a MATAV vonalak igy futnak.
-
- (az AMI kodolas igen ritka E1-es vonalaknal). Ha ez a beallitas nem
- egyezik a vonal ket vegen, akkor elofordulhat hogy a keretszinkron
- osszejon, de CRC4-hibak es a vonalakon atvitt adatokban is hibak
- keletkeznek (amit a HDLC/SyncPPP szinten CRC-hibaval jelez)
- comx0/reg - a kartya aramkoreinek, a MUNICH (reg) es a FALC (lbireg)
- comx0/lbireg regisztereinek kozvetlen elerese. Hasznalata:
- echo >reg 0x04 0x0 - a 4-es regiszterbe 0-t ir
- echo >reg 0x104 - printk()-val kiirja a 4-es regiszter
- tartalmat a syslogba.
- WARNING: ezek csak a fejleszteshez keszultek, sok galibat
- lehet veluk okozni!
- comx0/loopback - A kartya G.703 jelenek a visszahurkolasara is van lehetoseg:
- papaya:# echo none >/proc/comx/comx0/loopback
- papaya:# echo local >/proc/comx/comx0/loopback
- papaya:# echo remote >/proc/comx/comx0/loopback
- none - nincs visszahurkolas, normal mukodes
- local - a kartya a sajat maga altal adott jelet kapja vissza
- remote - a kartya a kivulrol vett jelet adja kifele
- Default: none
- -----------------------------------------------------------------
- Az interfeszhez (Cisco terminologiaban 'channel-group') kapcsolodo beallitasok:
- comx0/timeslots - mely timeslotok (idoszeletek) tartoznak az adott interfeszhez.
- papaya:~# cat /proc/comx/comx0/timeslots
- 1 3 4 5 6
- papaya:~#
- Egy timeslot megkeresese (hanyas interfeszbe tartozik nalunk):
- papaya:~# grep ' 4' /proc/comx/comx*/timeslots
- /proc/comx/comx0/timeslots:1 3 4 5 6
- papaya:~#
- Beallitasa:
- papaya:~# echo '1 5 2 6 7 8' >/proc/comx/comx0/timeslots
-
- A timeslotok sorrendje nem szamit, '1 3 2' ugyanaz mint az '1 2 3'.
- Beallitashoz az adott interfesznek DOWN-ban kell lennie
- (ifconfig comx0 down), de ugyanannak a kartyanak a tobbi interfesze
- uzemelhet kozben.
- Beallitaskor leellenorzi, hogy az uj timeslotok nem utkoznek-e egy
- masik interfesz timeslotjaival. Ha utkoznek, akkor nem allitja at.
- Mindig 10-es szamrendszerben tortenik a timeslotok ertelmezese, nehogy
- a 08, 09 alaku felirast rosszul ertelmezze.
- -----------------------------------------------------------------
- Az interfeszek es a kartya allapotanak lekerdezese:
- - A ' '-szel kezdodo sorok az eredeti kimenetet, a //-rel kezdodo sorok a
- magyarazatot jelzik.
- papaya:~$ cat /proc/comx/comx1/status
- Interface administrative status is UP, modem status is UP, protocol is UP
- Modem status changes: 0, Transmitter status is IDLE, tbusy: 0
- Interface load (input): 978376 / 947808 / 951024 bits/s (5s/5m/15m)
- (output): 978376 / 947848 / 951024 bits/s (5s/5m/15m)
- Debug flags: none
- RX errors: len: 22, overrun: 1, crc: 0, aborts: 0
- buffer overrun: 0, pbuffer overrun: 0
- TX errors: underrun: 0
- Line keepalive (value: 10) status UP [0]
- // Itt kezdodik a hardver-specifikus resz:
- Controller status:
- No alarms
- // Alarm: hibajelzes:
- //
- // No alarms - minden rendben
- //
- // LOS - Loss Of Signal - nem erzekel jelet a bemeneten.
- // AIS - Alarm Indication Signal - csak egymas utani 1-esek jonnek
- // a bemeneten, a tuloldal igy is jelezheti hogy meghibasodott vagy
- // nincs inicializalva.
- // AUXP - Auxiliary Pattern Indication - 01010101.. sorozat jon a bemeneten.
- // LFA - Loss of Frame Alignment - nincs keretszinkron
- // RRA - Receive Remote Alarm - a tuloldal el, de hibat jelez.
- // LMFA - Loss of CRC4 Multiframe Alignment - nincs CRC4-multikeret-szinkron
- // NMF - No Multiframe alignment Found after 400 msec - ilyen alarm a no-crc4
- // es crc4 keretezesek eseten nincs, lasd lentebb
- //
- // Egyeb lehetseges hibajelzesek:
- //
- // Transmit Line Short - a kartya ugy erzi hogy az adasi kimenete rovidre
- // van zarva, ezert kikapcsolta az adast. (nem feltetlenul veszi eszre
- // a kulso rovidzarat)
- // A veteli oldal csomagjainak lancolt listai, debug celokra:
- Rx ring:
- rafutott: 0
- lastcheck: 50845731, jiffies: 51314281
- base: 017b1858
- rx_desc_ptr: 0
- rx_desc_ptr: 017b1858
- hw_curr_ptr: 017b1858
- 06040000 017b1868 017b1898 c016ff00
- 06040000 017b1878 017b1e9c c016ff00
- 46040000 017b1888 017b24a0 c016ff00
- 06040000 017b1858 017b2aa4 c016ff00
- // A kartyat hasznalo tobbi interfesz: a 0-s channel-group a comx1 interfesz,
- // es az 1,2,...,16 timeslotok tartoznak hozza:
- Interfaces using this board: (channel-group, interface, timeslots)
- 0 comx1: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
- 1 comx2: 17
- 2 comx3: 18
- 3 comx4: 19
- 4 comx5: 20
- 5 comx6: 21
- 6 comx7: 22
- 7 comx8: 23
- 8 comx9: 24
- 9 comx10: 25
- 10 comx11: 26
- 11 comx12: 27
- 12 comx13: 28
- 13 comx14: 29
- 14 comx15: 30
- 15 comx16: 31
- // Hany esemenyt kezelt le a driver egy-egy hardver-interrupt kiszolgalasanal:
- Interrupt work histogram:
- hist[ 0]: 0 hist[ 1]: 2 hist[ 2]: 18574 hist[ 3]: 79
- hist[ 4]: 14 hist[ 5]: 1 hist[ 6]: 0 hist[ 7]: 1
- hist[ 8]: 0 hist[ 9]: 7
- // Hany kikuldendo csomag volt mar a Tx-ringben amikor ujabb lett irva bele:
- Tx ring histogram:
- hist[ 0]: 2329 hist[ 1]: 0 hist[ 2]: 0 hist[ 3]: 0
- // Az E1-interfesz hiba-szamlaloi, az rfc2495-nek megfeleloen:
- // (kb. a Cisco routerek "show controllers e1" formatumaban: http://www.cisco.com/univercd/cc/td/doc/product/software/ios11/rbook/rinterfc.htm#xtocid25669126)
- Data in current interval (91 seconds elapsed):
- 9516 Line Code Violations, 65 Path Code Violations, 2 E-Bit Errors
- 0 Slip Secs, 2 Fr Loss Secs, 2 Line Err Secs, 0 Degraded Mins
- 0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 11 Unavail Secs
- Data in Interval 1 (15 minutes):
- 0 Line Code Violations, 0 Path Code Violations, 0 E-Bit Errors
- 0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
- 0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 0 Unavail Secs
- Data in last 4 intervals (1 hour):
- 0 Line Code Violations, 0 Path Code Violations, 0 E-Bit Errors
- 0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
- 0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 0 Unavail Secs
- Data in last 96 intervals (24 hours):
- 0 Line Code Violations, 0 Path Code Violations, 0 E-Bit Errors
- 0 Slip Secs, 0 Fr Loss Secs, 0 Line Err Secs, 0 Degraded Mins
- 0 Errored Secs, 0 Bursty Err Secs, 0 Severely Err Secs, 0 Unavail Secs
- -----------------------------------------------------------------
- Nehany kulonlegesebb beallitasi lehetoseg (idovel beepulhetnek majd a driverbe):
- Ezekkel sok galibat lehet okozni, nagyon ovatosan kell oket hasznalni!
- modified CRC-4, for improved interworking of CRC-4 and non-CRC-4
- devices: (lasd page 107 es g706 Annex B)
- lbireg[ 0x1b ] |= 0x08
- lbireg[ 0x1c ] |= 0xc0
- - ilyenkor ertelmezett az NMF - 'No Multiframe alignment Found after
- 400 msec' alarm.
- FALC - a vonali meghajto IC
- local loop - a sajat adasomat halljam vissza
- remote loop - a kivulrol jovo adast adom vissza
- Egy hibakeresesre hasznalhato dolog:
- - 1-es timeslot local loop a FALC-ban: echo >lbireg 0x1d 0x21
- - local loop kikapcsolasa: echo >lbireg 0x1d 0x00
|