summaryrefslogtreecommitdiffstats
path: root/Documentation/isdn/avmb1.rst
blob: de3961e67553c299dce83012386c1d769b1cc316 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
================================
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)