[linux-block.git] / Documentation / networking / slicecom.hun


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
Commit	Line	Data
1da177e4 LT	1
	2	SliceCOM adapter felhasznaloi dokumentacioja - 0.51 verziohoz
	3
be2a608b	4	Bartók István <bartoki@itc.hu>
1da177e4 LT	5	Utolso modositas: Wed Aug 29 17:26:58 CEST 2001
	6
	7	-----------------------------------------------------------------
	8
	9	Hasznalata:
	10
	11	Forditas:
	12
	13	Code maturity level options
	14	[*] Prompt for development and/or incomplete code/drivers
	15
	16	Network 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
	23	A modulok betoltese:
	24
	25	modprobe comx
	26
	27	modprobe comx-proto-ppp # a Cisco-HDLC es a SyncPPP protokollt is
	28	# ez a modul adja
	29
	30	modprobe comx-hw-munich # a modul betoltodeskor azonnal jelent a
	31	# syslogba a detektalt kartyakrol
	32
	33
	34	Konfiguralas:
	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	#
	40	mkdir /proc/comx/comx0.1/
	41	echo slicecom >/proc/comx/comx0.1/boardtype
	42	echo hdlc >/proc/comx/comx0.1/protocol
	43	echo 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	#
	49	mkdir /proc/comx/comx0.2/
	50	echo slicecom >/proc/comx/comx0.2/boardtype
	51	echo ppp >/proc/comx/comx0.2/protocol
	52	echo 3 >/proc/comx/comx0.2/timeslots
	53
	54	...
	55
	56	ifconfig comx0.1 up
	57	ifconfig comx0.2 up
	58
	59	-----------------------------------------------------------------
	60
	61	A COMX driverek default 20 csomagnyi transmit queue-t rendelnek a halozati
	62	interfeszekhez. WAN halozatokban ennel hosszabbat is szokas hasznalni
	63	(20 es 100 kozott), hogy a vonal kihasznaltsaga nagy terheles eseten jobb
	64	legyen (bar ezzel megno a varhato kesleltetes a csomagok sorban allasa miatt):
	65
	66	# ifconfig comx0 txqueuelen 50
	67
	68	Ezt a beallitasi lehetoseget csak az ujabb disztribuciok ifconfig parancsa
69	tamogatja (amik mar a 2.2 kernelekhez keszultek, mint a RedHat 6.1 vagy a
70	Debian 2.2).
71
72	A 2.1-es Debian disztribuciohoz a http://www.debian.org/~rcw/2.2/netbase/
73	cimrol toltheto le ujabb netbase csomag, ami mar ilyet tamogato ifconfig
74	parancsot tartalmaz. Bovebben a 2.2 kernel hasznalatarol Debian 2.1 alatt:
75	http://www.debian.org/releases/stable/running-kernel-2.2
76
77	-----------------------------------------------------------------
78
79	A kartya LED-jeinek jelentese:
80
81	piros - eg, ha Remote Alarm-ot kuld a tuloldal
82	zold - eg, ha a vett jelben megtalalja a keretszinkront
83
84	Reszletesebben:
85
86	piros: zold: jelentes:
87
88	- - nincs keretszinkron (nincs jel, vagy rossz a jel)
89	- eg "minden rendben"
90	eg eg a vetel OK, de a tuloldal Remote Alarm-ot kuld
91	eg - ez nincs ertelmezve, egyelore funkcio nelkul
92
93	-----------------------------------------------------------------
94
95	Reszletesebb leiras a hardver beallitasi lehetosegeirol:
96
97	Az altalanos,- es a protokoll-retegek beallitasi lehetosegeirol a 'comx.txt'
98	fajlban leirtak SliceCOM kartyanal is ervenyesek, itt csak a hardver-specifikus
99	beallitasi lehetosegek vannak osszefoglalva:
100
101	Konfiguralasi interfesz a /proc/comx/ alatt:
102
103	Minden timeslot-csoportnak kulon comx* interfeszt kell letrehozni mkdir-rel:
104	comx0, comx1, .. stb. Itt beallithato, hogy az adott interfesz hanyadik kartya
105	melyik 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
107	jelentenenek, ezert mi nem tudunk ilyen elnevezest hasznalni.
108
109	Tobb kartya eseten a comx0.1, comx0.2, ... vagy slice0.1, slice0.2 nevek
110	hasznalhatoak.
111
112	Tobb SliceCOM kartya is lehet egy gepben, de sajat interrupt kell mindegyiknek,
113	nem tud meg megosztott interruptot kezelni.
114
115	Az egesz kartyat erinto beallitasok:
116
117	Az ioport es irq beallitas nincs: amit a PCI BIOS kioszt a rendszernek,
118	azt hasznalja a driver.
119
120
121	comx0/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
129	Bar a kovetkezoket csak egy-egy interfeszen allitjuk at, megis az egesz kartya
130	mukodeset egyszerre allitjak. A megkotes hogy csak UP-ban levo interfeszen
131	hasznalhatoak, azert van, mert kulonben nem vart eredmenyekre vezetne egy ilyen
132	paranccsorozat:
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
140	Ezek a beallitasok megmaradnak az osszes interfesz torlesekor, de torlodnek
141	a driver modul ki/betoltesekor.
142
143
144	comx0/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
161	comx0/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
176	comx0/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
189	comx0/reg - a kartya aramkoreinek, a MUNICH (reg) es a FALC (lbireg)
190	comx0/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
200	comx0/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
214	Az interfeszhez (Cisco terminologiaban 'channel-group') kapcsolodo beallitasok:
215
216	comx0/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
245	Az interfeszek es a kartya allapotanak lekerdezese:
246
247	- A ' '-szel kezdodo sorok az eredeti kimenetet, a //-rel kezdodo sorok a
248	magyarazatot 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
336	Data 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
340	Data 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
344	Data 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
348	Data 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
355	Nehany kulonlegesebb beallitasi lehetoseg (idovel beepulhetnek majd a driverbe):
356	Ezekkel 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