slicecom.hun 13 KB

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