188 lines
		
	
	
	
		
			5.5 KiB
			
		
	
	
	
		
			Text
		
	
	
	
	
	
		
		
			
		
	
	
			188 lines
		
	
	
	
		
			5.5 KiB
			
		
	
	
	
		
			Text
		
	
	
	
	
	
| 
								 | 
							
								Driver for active AVM Controller.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								The driver provides a kernel capi2.0 Interface (kernelcapi) and
							 | 
						||
| 
								 | 
							
								on top of this a User-Level-CAPI2.0-interface (capi)
							 | 
						||
| 
								 | 
							
								and a driver to connect isdn4linux with CAPI2.0 (capidrv).
							 | 
						||
| 
								 | 
							
								The lowlevel interface can be used to implement a CAPI2.0
							 | 
						||
| 
								 | 
							
								also for passive cards since July 1999.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								The author can be reached at calle@calle.in-berlin.de.
							 | 
						||
| 
								 | 
							
								The command avmcapictrl is part of the isdn4k-utils.
							 | 
						||
| 
								 | 
							
								t4-files can be found at ftp://ftp.avm.de/cardware/b1/linux/firmware
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								Currently supported cards:
							 | 
						||
| 
								 | 
							
									B1 ISA (all versions)
							 | 
						||
| 
								 | 
							
									B1 PCI
							 | 
						||
| 
								 | 
							
									T1/T1B (HEMA card)
							 | 
						||
| 
								 | 
							
									M1
							 | 
						||
| 
								 | 
							
									M2
							 | 
						||
| 
								 | 
							
									B1 PCMCIA
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								Installing
							 | 
						||
| 
								 | 
							
								----------
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								You need at least /dev/capi20 to load the firmware.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								mknod /dev/capi20 c 68 0
							 | 
						||
| 
								 | 
							
								mknod /dev/capi20.00 c 68 1
							 | 
						||
| 
								 | 
							
								mknod /dev/capi20.01 c 68 2
							 | 
						||
| 
								 | 
							
								.
							 | 
						||
| 
								 | 
							
								.
							 | 
						||
| 
								 | 
							
								.
							 | 
						||
| 
								 | 
							
								mknod /dev/capi20.19 c 68 20
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								Running
							 | 
						||
| 
								 | 
							
								-------
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								To use the card you need the t4-files to download the firmware.
							 | 
						||
| 
								 | 
							
								AVM GmbH provides several t4-files for the different D-channel
							 | 
						||
| 
								 | 
							
								protocols (b1.t4 for Euro-ISDN). Install these file in /lib/isdn.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								if you configure as modules load the modules this way:
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								insmod /lib/modules/current/misc/capiutil.o
							 | 
						||
| 
								 | 
							
								insmod /lib/modules/current/misc/b1.o
							 | 
						||
| 
								 | 
							
								insmod /lib/modules/current/misc/kernelcapi.o
							 | 
						||
| 
								 | 
							
								insmod /lib/modules/current/misc/capidrv.o
							 | 
						||
| 
								 | 
							
								insmod /lib/modules/current/misc/capi.o
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								if you have an B1-PCI card load the module b1pci.o
							 | 
						||
| 
								 | 
							
								insmod /lib/modules/current/misc/b1pci.o
							 | 
						||
| 
								 | 
							
								and load the firmware with
							 | 
						||
| 
								 | 
							
								avmcapictrl load /lib/isdn/b1.t4 1
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								if you have an B1-ISA card load the module b1isa.o
							 | 
						||
| 
								 | 
							
								and add the card by calling
							 | 
						||
| 
								 | 
							
								avmcapictrl add 0x150 15
							 | 
						||
| 
								 | 
							
								and load the firmware by calling
							 | 
						||
| 
								 | 
							
								avmcapictrl load /lib/isdn/b1.t4 1
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								if you have an T1-ISA card load the module t1isa.o
							 | 
						||
| 
								 | 
							
								and add the card by calling
							 | 
						||
| 
								 | 
							
								avmcapictrl add 0x450 15 T1 0
							 | 
						||
| 
								 | 
							
								and load the firmware by calling
							 | 
						||
| 
								 | 
							
								avmcapictrl load /lib/isdn/t1.t4 1
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								if you have an PCMCIA card (B1/M1/M2) load the module b1pcmcia.o
							 | 
						||
| 
								 | 
							
								before you insert the card.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								Leased Lines with B1
							 | 
						||
| 
								 | 
							
								--------------------
							 | 
						||
| 
								 | 
							
								Init card and load firmware.
							 | 
						||
| 
								 | 
							
								For an D64S use "FV: 1" as phone number
							 | 
						||
| 
								 | 
							
								For an D64S2 use "FV: 1" and "FV: 2" for multilink
							 | 
						||
| 
								 | 
							
								or "FV: 1,2" to use CAPI channel bundling.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								/proc-Interface
							 | 
						||
| 
								 | 
							
								-----------------
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								/proc/capi:
							 | 
						||
| 
								 | 
							
								  dr-xr-xr-x   2 root     root            0 Jul  1 14:03 .
							 | 
						||
| 
								 | 
							
								  dr-xr-xr-x  82 root     root            0 Jun 30 19:08 ..
							 | 
						||
| 
								 | 
							
								  -r--r--r--   1 root     root            0 Jul  1 14:03 applications
							 | 
						||
| 
								 | 
							
								  -r--r--r--   1 root     root            0 Jul  1 14:03 applstats
							 | 
						||
| 
								 | 
							
								  -r--r--r--   1 root     root            0 Jul  1 14:03 capi20
							 | 
						||
| 
								 | 
							
								  -r--r--r--   1 root     root            0 Jul  1 14:03 capidrv
							 | 
						||
| 
								 | 
							
								  -r--r--r--   1 root     root            0 Jul  1 14:03 controller
							 | 
						||
| 
								 | 
							
								  -r--r--r--   1 root     root            0 Jul  1 14:03 contrstats
							 | 
						||
| 
								 | 
							
								  -r--r--r--   1 root     root            0 Jul  1 14:03 driver
							 | 
						||
| 
								 | 
							
								  -r--r--r--   1 root     root            0 Jul  1 14:03 ncci
							 | 
						||
| 
								 | 
							
								  -r--r--r--   1 root     root            0 Jul  1 14:03 users
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								/proc/capi/applications:
							 | 
						||
| 
								 | 
							
								   applid level3cnt datablkcnt datablklen ncci-cnt recvqueuelen
							 | 
						||
| 
								 | 
							
									level3cnt: capi_register parameter
							 | 
						||
| 
								 | 
							
									datablkcnt: capi_register parameter
							 | 
						||
| 
								 | 
							
									ncci-cnt: current number of nccis (connections)
							 | 
						||
| 
								 | 
							
									recvqueuelen: number of messages on receive queue
							 | 
						||
| 
								 | 
							
								   for example:
							 | 
						||
| 
								 | 
							
								1 -2 16 2048 1 0
							 | 
						||
| 
								 | 
							
								2 2 7 2048 1 0
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								/proc/capi/applstats:
							 | 
						||
| 
								 | 
							
								   applid recvctlmsg nrecvdatamsg nsentctlmsg nsentdatamsg
							 | 
						||
| 
								 | 
							
									recvctlmsg: capi messages received without DATA_B3_IND
							 | 
						||
| 
								 | 
							
									recvdatamsg: capi DATA_B3_IND received
							 | 
						||
| 
								 | 
							
									sentctlmsg: capi messages sent without DATA_B3_REQ
							 | 
						||
| 
								 | 
							
									sentdatamsg: capi DATA_B3_REQ sent
							 | 
						||
| 
								 | 
							
								   for example:
							 | 
						||
| 
								 | 
							
								1 2057 1699 1721 1699
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								/proc/capi/capi20: statistics of capi.o (/dev/capi20)
							 | 
						||
| 
								 | 
							
								    minor nopen nrecvdropmsg nrecvctlmsg nrecvdatamsg sentctlmsg sentdatamsg
							 | 
						||
| 
								 | 
							
									minor: minor device number of capi device
							 | 
						||
| 
								 | 
							
									nopen: number of calls to devices open
							 | 
						||
| 
								 | 
							
									nrecvdropmsg: capi messages dropped (messages in recvqueue in close)
							 | 
						||
| 
								 | 
							
									nrecvctlmsg: capi messages received without DATA_B3_IND
							 | 
						||
| 
								 | 
							
									nrecvdatamsg: capi DATA_B3_IND received
							 | 
						||
| 
								 | 
							
									nsentctlmsg: capi messages sent without DATA_B3_REQ
							 | 
						||
| 
								 | 
							
									nsentdatamsg: capi DATA_B3_REQ sent
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								   for example:
							 | 
						||
| 
								 | 
							
								1 2 18 0 16 2
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								/proc/capi/capidrv: statistics of capidrv.o (capi messages)
							 | 
						||
| 
								 | 
							
								    nrecvctlmsg nrecvdatamsg sentctlmsg sentdatamsg
							 | 
						||
| 
								 | 
							
									nrecvctlmsg: capi messages received without DATA_B3_IND
							 | 
						||
| 
								 | 
							
									nrecvdatamsg: capi DATA_B3_IND received
							 | 
						||
| 
								 | 
							
									nsentctlmsg: capi messages sent without DATA_B3_REQ
							 | 
						||
| 
								 | 
							
									nsentdatamsg: capi DATA_B3_REQ sent
							 | 
						||
| 
								 | 
							
								   for example:
							 | 
						||
| 
								 | 
							
								2780 2226 2256 2226
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								/proc/capi/controller:
							 | 
						||
| 
								 | 
							
								   controller drivername state cardname   controllerinfo
							 | 
						||
| 
								 | 
							
								   for example:
							 | 
						||
| 
								 | 
							
								1 b1pci      running  b1pci-e000       B1 3.07-01 0xe000 19
							 | 
						||
| 
								 | 
							
								2 t1isa      running  t1isa-450        B1 3.07-01 0x450 11 0
							 | 
						||
| 
								 | 
							
								3 b1pcmcia   running  m2-150           B1 3.07-01 0x150 5
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								/proc/capi/contrstats:
							 | 
						||
| 
								 | 
							
								    controller nrecvctlmsg nrecvdatamsg sentctlmsg sentdatamsg
							 | 
						||
| 
								 | 
							
									nrecvctlmsg: capi messages received without DATA_B3_IND
							 | 
						||
| 
								 | 
							
									nrecvdatamsg: capi DATA_B3_IND received
							 | 
						||
| 
								 | 
							
									nsentctlmsg: capi messages sent without DATA_B3_REQ
							 | 
						||
| 
								 | 
							
									nsentdatamsg: capi DATA_B3_REQ sent
							 | 
						||
| 
								 | 
							
								   for example:
							 | 
						||
| 
								 | 
							
								1 2845 2272 2310 2274
							 | 
						||
| 
								 | 
							
								2 2 0 2 0
							 | 
						||
| 
								 | 
							
								3 2 0 2 0
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								/proc/capi/driver:
							 | 
						||
| 
								 | 
							
								   drivername ncontroller
							 | 
						||
| 
								 | 
							
								   for example:
							 | 
						||
| 
								 | 
							
								b1pci                            1
							 | 
						||
| 
								 | 
							
								t1isa                            1
							 | 
						||
| 
								 | 
							
								b1pcmcia                         1
							 | 
						||
| 
								 | 
							
								b1isa                            0
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								/proc/capi/ncci:
							 | 
						||
| 
								 | 
							
								   apllid ncci winsize sendwindow
							 | 
						||
| 
								 | 
							
								   for example:
							 | 
						||
| 
								 | 
							
								1 0x10101 8 0
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								/proc/capi/users: kernelmodules that use the kernelcapi.
							 | 
						||
| 
								 | 
							
								   name
							 | 
						||
| 
								 | 
							
								   for example:
							 | 
						||
| 
								 | 
							
								capidrv
							 | 
						||
| 
								 | 
							
								capi20
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								Questions
							 | 
						||
| 
								 | 
							
								---------
							 | 
						||
| 
								 | 
							
								Check out the FAQ (ftp.isdn4linux.de) or subscribe to the
							 | 
						||
| 
								 | 
							
								linux-avmb1@calle.in-berlin.de mailing list by sending
							 | 
						||
| 
								 | 
							
								a mail to majordomo@calle.in-berlin.de with
							 | 
						||
| 
								 | 
							
								subscribe linux-avmb1
							 | 
						||
| 
								 | 
							
								in the body.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								German documentation and several scripts can be found at
							 | 
						||
| 
								 | 
							
								ftp://ftp.avm.de/cardware/b1/linux/
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								Bugs 
							 | 
						||
| 
								 | 
							
								----
							 | 
						||
| 
								 | 
							
								If you find any please let me know. 
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								Enjoy,
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								Carsten Paeth (calle@calle.in-berlin.de)
							 |