rt2800usb: Move ID out of unknown
[linux-2.6.git] / Documentation / isdn / INTERFACE
1 $Id: INTERFACE,v 1.15.8.2 2001/03/13 16:17:07 kai Exp $
2
3 Description of the Interface between Linklevel and Hardwarelevel
4   of isdn4linux:
5
6
7   The Communication between Linklevel (LL) and Hardwarelevel (HL)
8   is based on the struct isdn_if (defined in isdnif.h).
9
10   An HL-driver can register itself at LL by calling the function
11   register_isdn() with a pointer to that struct. Prior to that, it has
12   to preset some of the fields of isdn_if. The LL sets the rest of
13   the fields. All further communication is done via callbacks using
14   the function-pointers defined in isdn_if.
15
16   Changes/Version numbering:
17
18   During development of the ISDN subsystem, several changes have been
19   made to the interface. Before it went into kernel, the package
20   had a unique version number. The last version, distributed separately
21   was 0.7.4. When the subsystem went into kernel, every functional unit
22   got a separate version number. These numbers are shown at initialization,
23   separated by slashes:
24
25      c.c/t.t/n.n/p.p/a.a/v.v
26
27   where
28
29    c.c is the revision of the common code.
30    t.t is the revision of the tty related code.
31    n.n is the revision of the network related code.
32    p.p is the revision of the ppp related code.
33    a.a is the revision of the audio related code.
34    v.v is the revision of the V.110 related code.
35
36   Changes in this document are marked with '***CHANGEx' where x representing
37   the version number. If that number starts with 0, it refers to the old,
38   separately distributed package. If it starts with one of the letters
39   above, it refers to the revision of the corresponding module. 
40   ***CHANGEIx refers to the revision number of the isdnif.h  
41
42 1. Description of the fields of isdn_if:
43
44   int channels;
45
46     This field has to be set by the HL-driver to the number of channels
47     supported prior to calling register_isdn(). Upon return of the call,
48     the LL puts an id there, which has to be used by the HL-driver when
49     invoking the other callbacks.
50
51   int maxbufsize;
52
53     ***CHANGE0.6: New since this version.
54
55     Also to be preset by the HL-driver. With this value the HL-driver
56     tells the LL the maximum size of a data-packet it will accept. 
57
58   unsigned long features;
59
60     To be preset by the HL-driver. Using this field, the HL-driver
61     announces the features supported. At the moment this is limited to
62     report the supported layer2 and layer3-protocols. For setting this
63     field the constants ISDN_FEATURE..., declared in isdnif.h have to be
64     used.
65
66     ***CHANGE0.7.1: The line type (1TR6, EDSS1) has to be set.
67
68   unsigned short hl_hdrlen;
69
70     ***CHANGE0.7.4: New field.
71
72     To be preset by the HL-driver, if it supports sk_buff's. The driver
73     should put here the amount of additional space needed in sk_buff's for
74     its internal purposes. Drivers not supporting sk_buff's should 
75     initialize this field to 0.
76
77   void (*rcvcallb_skb)(int, int, struct sk_buff *)
78
79     ***CHANGE0.7.4: New field.
80
81     This field will be set by LL. The HL-driver delivers received data-
82     packets by calling this function. Upon calling, the HL-driver must
83     already have its private data pulled off the head of the sk_buff.
84
85     Parameter:
86       int              driver-Id
87       int              Channel-number locally to the driver. (starting with 0)
88       struct sk_buff * Pointer to sk_buff, containing received data.
89
90   int (*statcallb)(isdn_ctrl*);
91
92     This field will be set by LL. This function has to be called by the
93     HL-driver for signaling status-changes or other events to the LL.
94
95     Parameter:
96       isdn_ctrl*
97
98       The struct isdn_ctrl also defined in isdn_if. The exact meanings of its
99       fields are described together with the descriptions of the possible
100       events. Here is only a short description of the fields:
101
102         driver  = driver Id.
103         command = event-type. (one of the constants ISDN_STAT_...)
104         arg     = depends on event-type.
105         num     = depends on event-type.
106
107     Returnvalue:
108       0 on success, else -1
109
110   int (*command)(isdn_ctrl*);
111
112     This field has to be preset by the HL-driver. It points to a function,
113     to be called by LL to perform functions like dialing, B-channel
114     setup, etc. The exact meaning of the parameters is described with the
115     descriptions of the possible commands.
116
117     Parameter:
118       isdn_ctrl*
119         driver  = driver-Id
120         command = command to perform. (one of the constants ISDN_CMD_...)
121         arg     = depends on command.
122         num     = depends on command.
123     
124     Returnvalue:
125       >=0 on success, else error-code (-ENODEV etc.)
126
127   int (*writebuf_skb)(int, int, int, struct sk_buff *)
128
129     ***CHANGE0.7.4: New field.
130     ***CHANGEI.1.21: New field.
131
132     This field has to be preset by the HL-driver. The given function will
133     be called by the LL for delivering data to be send via B-Channel.
134
135  
136     Parameter:
137       int              driver-Id ***CHANGE0.7.4: New parameter.
138       int              channel-number locally to the HL-driver. (starts with 0)
139       int              ack ***ChangeI1.21: New parameter
140                        If this is !0, the driver has to signal the delivery
141                        by sending an ISDN_STAT_BSENT. If this is 0, the driver
142                        MUST NOT send an ISDN_STAT_BSENT.
143       struct sk_buff * Pointer to sk_buff containing data to be send via
144                        B-channel.
145
146     Returnvalue:
147       Length of data accepted on success, else error-code (-EINVAL on
148       oversized packets etc.)
149
150   int (*writecmd)(u_char*, int, int, int, int);
151
152     This field has to be preset by the HL-driver. The given function will be
153     called to perform write-requests on /dev/isdnctrl (i.e. sending commands
154     to the card) The data-format is hardware-specific. This function is
155     intended for debugging only. It is not necessary for normal operation
156     and never will be called by the tty-emulation- or network-code. If
157     this function is not supported, the driver has to set NULL here.
158
159     Parameter:
160       u_char* pointer to data.
161       int     length of data.
162       int     flag: 0 = call from within kernel-space. (HL-driver must use
163                         memcpy, may NOT use schedule())
164                     1 = call from user-space. (HL-driver must use
165                         memcpy_fromfs, use of schedule() allowed)
166       int     driver-Id.
167       int     channel-number locally to the HL-driver. (starts with 0)
168
169 ***CHANGEI1.14: The driver-Id and channel-number are new since this revision.
170
171     Returnvalue:
172       Length of data accepted on success, else error-code (-EINVAL etc.)
173
174   int (*readstat)(u_char*, int, int, int, int);
175
176     This field has to be preset by the HL-driver. The given function will be
177     called to perform read-requests on /dev/isdnctrl (i.e. reading replies
178     from the card) The data-format is hardware-specific. This function is
179     intended for debugging only. It is not necessary for normal operation
180     and never will be called by the tty-emulation- or network-code. If
181     this function is not supported, the driver has to set NULL here.
182
183     Parameter:
184       u_char* pointer to data.
185       int     length of data.
186       int     flag: 0 = call from within kernel-space. (HL-driver must use
187                         memcpy, may NOT use schedule())
188                     1 = call from user-space. (HL-driver must use
189                         memcpy_fromfs, use of schedule() allowed)
190       int     driver-Id.
191       int     channel-number locally to the HL-driver. (starts with 0)
192
193 ***CHANGEI1.14: The driver-Id and channel-number are new since this revision.
194
195     Returnvalue:
196       Length of data on success, else error-code (-EINVAL etc.)
197
198   char id[20];
199        ***CHANGE0.7: New since this version.
200
201    This string has to be preset by the HL-driver. Its purpose is for
202    identification of the driver by the user. Eg.: it is shown in the
203    status-info of /dev/isdninfo. Furthermore it is used as Id for binding
204    net-interfaces to a specific channel. If a string of length zero is
205    given, upon return, isdn4linux will replace it by a generic name. (line0,
206    line1 etc.) It is recommended to make this string configurable during
207    module-load-time. (copy a global variable to this string.) For doing that,
208    modules 1.2.8 or newer are necessary.
209
210 2. Description of the commands, a HL-driver has to support:
211
212    All commands will be performed by calling the function command() described
213    above from within the LL. The field command of the struct-parameter will
214    contain the desired command, the field driver is always set to the
215    appropriate driver-Id.
216
217    Until now, the following commands are defined:
218
219 ***CHANGEI1.34: The parameter "num" has been replaced by a union "parm" containing
220                 the old "num" and a new setup_type struct used for ISDN_CMD_DIAL
221                 and ISDN_STAT_ICALL callback.
222
223    ISDN_CMD_IOCTL:
224
225      This command is intended for performing ioctl-calls for configuring
226      hardware or similar purposes (setting port-addresses, loading firmware
227      etc.) For this purpose, in the LL all ioctl-calls with an argument
228      >= IIOCDRVCTL (0x100) will be handed transparently to this
229      function after subtracting 0x100 and placing the result in arg.
230      Example:
231        If a userlevel-program calls ioctl(0x101,...) the function gets
232        called with the field command set to 1.
233
234      Parameter:
235        driver   = driver-Id.
236        command  = ISDN_CMD_IOCTL
237        arg      = Original ioctl-cmd - IIOCDRVCTL
238        parm.num = first bytes filled with (unsigned long)arg
239    
240      Returnvalue:
241        Depending on driver.
242
243   
244   ISDN_CMD_DIAL:
245
246     This command is used to tell the HL-driver it should dial a given
247     number.
248
249     Parameter:
250       driver      = driver-Id.
251       command     = ISDN_CMD_DIAL
252       arg         = channel-number locally to the driver. (starting with 0)
253       
254       parm.setup.phone  = An ASCII-String containing the number to dial.
255       parm.setup.eazmsn = An ASCII-Sting containing the own EAZ or MSN.
256       parm.setup.si1    = The Service-Indicator.
257       parm.setup.si2    = Additional Service-Indicator.
258
259                     If the Line has been designed as SPV (a special german
260                     feature, meaning semi-leased-line) the phone has to
261                     start with an "S".
262       ***CHANGE0.6: In previous versions the EAZ has been given in the
263                     highbyte of arg.
264     ***CHANGE0.7.1: New since this version: ServiceIndicator and AddInfo.
265
266   ISDN_CMD_ACCEPTD:
267
268     With this command, the HL-driver is told to accept a D-Channel-setup.
269     (Response to an incoming call)
270
271     Parameter:
272       driver      = driver-Id.
273       command     = ISDN_CMD_ACCEPTD
274       arg         = channel-number locally to the driver. (starting with 0)
275       parm        = unused.
276
277   ISDN_CMD_ACCEPTB:
278
279     With this command, the HL-driver is told to perform a B-Channel-setup.
280     (after establishing D-Channel-Connection)
281
282     Parameter:
283       driver      = driver-Id.
284       command     = ISDN_CMD_ACCEPTB
285       arg         = channel-number locally to the driver. (starting with 0)
286       parm        = unused.
287
288   ISDN_CMD_HANGUP:
289
290     With this command, the HL-driver is told to hangup (B-Channel if
291     established first, then D-Channel). This command is also used for
292     actively rejecting an incoming call.
293
294     Parameter:
295       driver      = driver-Id.
296       command     = ISDN_CMD_HANGUP
297       arg         = channel-number locally to the driver. (starting with 0)
298       parm        = unused.
299
300   ISDN_CMD_CLREAZ:
301
302     With this command, the HL-driver is told not to signal incoming
303     calls to the LL.
304
305     Parameter:
306       driver      = driver-Id.
307       command     = ISDN_CMD_CLREAZ
308       arg         = channel-number locally to the driver. (starting with 0)
309       parm        = unused.
310
311   ISDN_CMD_SETEAZ:
312
313     With this command, the HL-driver is told to signal incoming calls for
314     the given EAZs/MSNs to the LL.
315
316     Parameter:
317       driver      = driver-Id.
318       command     = ISDN_CMD_SETEAZ
319       arg         = channel-number locally to the driver. (starting with 0)
320       parm.num    = ASCII-String, containing the desired EAZ's/MSN's
321                     (comma-separated). If an empty String is given, the
322                     HL-driver should respond to ALL incoming calls,
323                     regardless of the destination-address.
324       ***CHANGE0.6: New since this version the "empty-string"-feature.
325
326   ISDN_CMD_GETEAZ: (currently unused)
327
328     With this command, the HL-driver is told to report the current setting
329     given with ISDN_CMD_SETEAZ.
330
331     Parameter:
332       driver      = driver-Id.
333       command     = ISDN_CMD_GETEAZ
334       arg         = channel-number locally to the driver. (starting with 0)
335       parm.num    = ASCII-String, containing the current EAZ's/MSN's
336
337   ISDN_CMD_SETSIL: (currently unused)
338
339     With this command, the HL-driver is told to signal only incoming
340     calls with the given Service-Indicators.
341
342     Parameter:
343       driver      = driver-Id.
344       command     = ISDN_CMD_SETSIL
345       arg         = channel-number locally to the driver. (starting with 0)
346       parm.num    = ASCII-String, containing the desired Service-Indicators.
347
348   ISDN_CMD_GETSIL: (currently unused)
349
350     With this command, the HL-driver is told to return the current
351     Service-Indicators it will respond to.
352
353     Parameter:
354       driver      = driver-Id.
355       command     = ISDN_CMD_SETSIL
356       arg         = channel-number locally to the driver. (starting with 0)
357       parm.num    = ASCII-String, containing the current Service-Indicators.
358
359   ISDN_CMD_SETL2:
360
361     With this command, the HL-driver is told to select the given Layer-2-
362     protocol. This command is issued by the LL prior to ISDN_CMD_DIAL or
363     ISDN_CMD_ACCEPTD.
364
365
366     Parameter:
367       driver      = driver-Id.
368       command     = ISDN_CMD_SETL2
369       arg         = channel-number locally to the driver. (starting with 0)
370                     logical or'ed with (protocol-Id << 8)
371                     protocol-Id is one of the constants ISDN_PROTO_L2...
372       parm        = unused.
373
374   ISDN_CMD_GETL2: (currently unused)
375
376     With this command, the HL-driver is told to return the current
377     setting of the Layer-2-protocol.
378
379     Parameter:
380       driver      = driver-Id.
381       command     = ISDN_CMD_GETL2
382       arg         = channel-number locally to the driver. (starting with 0)
383       parm        = unused.
384     Returnvalue:
385       current protocol-Id (one of the constants ISDN_L2_PROTO)
386
387   ISDN_CMD_SETL3:
388
389     With this command, the HL-driver is told to select the given Layer-3-
390     protocol. This command is issued by the LL prior to ISDN_CMD_DIAL or
391     ISDN_CMD_ACCEPTD.
392
393
394     Parameter:
395       driver      = driver-Id.
396       command     = ISDN_CMD_SETL3
397       arg         = channel-number locally to the driver. (starting with 0)
398                     logical or'ed with (protocol-Id << 8)
399                     protocol-Id is one of the constants ISDN_PROTO_L3...
400       parm.fax    = Pointer to T30_s fax struct. (fax usage only)
401
402   ISDN_CMD_GETL2: (currently unused)
403
404     With this command, the HL-driver is told to return the current
405     setting of the Layer-3-protocol.
406
407     Parameter:
408       driver      = driver-Id.
409       command     = ISDN_CMD_GETL3
410       arg         = channel-number locally to the driver. (starting with 0)
411       parm        = unused.
412     Returnvalue:
413       current protocol-Id (one of the constants ISDN_L3_PROTO)
414
415   ISDN_CMD_PROCEED: 
416
417     With this command, the HL-driver is told to proceed with a incoming call.
418
419     Parameter:
420       driver      = driver-Id.
421       command     = ISDN_CMD_PROCEED
422       arg         = channel-number locally to the driver. (starting with 0)
423       setup.eazmsn= empty string or string send as uus1 in DSS1 with 
424                     PROCEED message
425
426   ISDN_CMD_ALERT: 
427
428     With this command, the HL-driver is told to alert a proceeding call.
429
430     Parameter:
431       driver      = driver-Id.
432       command     = ISDN_CMD_ALERT
433       arg         = channel-number locally to the driver. (starting with 0)
434       setup.eazmsn= empty string or string send as uus1 in DSS1 with 
435                     ALERT message
436
437   ISDN_CMD_REDIR: 
438
439     With this command, the HL-driver is told to redirect a call in proceeding
440     or alerting state.  
441
442     Parameter:
443       driver      = driver-Id.
444       command     = ISDN_CMD_REDIR
445       arg         = channel-number locally to the driver. (starting with 0)
446       setup.eazmsn= empty string or string send as uus1 in DSS1 protocol
447       setup.screen= screening indicator
448       setup.phone = redirected to party number
449
450   ISDN_CMD_PROT_IO:
451
452     With this call, the LL-driver invokes protocol specific features through
453     the LL.
454     The call is not implicitely bound to a connection.
455
456     Parameter:
457       driver      = driver-Id
458       command     = ISDN_CMD_PROT_IO
459       arg         = The lower 8 Bits define the addressed protocol as defined
460                     in ISDN_PTYPE..., the upper bits are used to differentiate
461                     the protocol specific CMD.  
462       
463       para        = protocol and function specific. See isdnif.h for detail.
464
465
466   ISDN_CMD_FAXCMD:
467
468     With this command the HL-driver receives a fax sub-command.
469     For details refer to INTERFACE.fax
470
471     Parameter:
472       driver      = driver-Id.
473       command     = ISDN_CMD_FAXCMD
474       arg         = channel-number locally to the driver. (starting with 0)
475       parm        = unused.
476
477
478 3. Description of the events to be signaled by the HL-driver to the LL.
479
480   All status-changes are signaled via calling the previously described
481   function statcallb(). The field command of the struct isdn_cmd has
482   to be set by the HL-driver with the appropriate Status-Id (event-number).
483   The field arg has to be set to the channel-number (locally to the driver,
484   starting with 0) to which this event applies. (Exception: STAVAIL-event)
485
486   Until now, the following Status-Ids are defined:
487
488   ISDN_STAT_AVAIL:
489
490     With this call, the HL-driver signals the availability of new data
491     for readstat(). Used only for debugging-purposes, see description
492     of readstat().
493
494     Parameter:
495       driver      = driver-Id
496       command     = ISDN_STAT_STAVAIL
497       arg         = length of available data.
498       parm        = unused.
499
500   ISDN_STAT_ICALL:
501   ISDN_STAT_ICALLW:
502
503     With this call, the HL-driver signals an incoming call to the LL.
504     If ICALLW is signalled the incoming call is a waiting call without
505     a available B-chan.
506
507     Parameter:
508       driver            = driver-Id
509       command           = ISDN_STAT_ICALL
510       arg               = channel-number, locally to the driver. (starting with 0)
511       para.setup.phone  = Callernumber.
512       para.setup.eazmsn = CalledNumber.
513       para.setup.si1    = Service Indicator.
514       para.setup.si2    = Additional Service Indicator.
515       para.setup.plan   = octet 3 from Calling party number Information Element.
516       para.setup.screen = octet 3a from Calling party number Information Element.
517
518     Return:
519       0           = No device matching this call.
520       1           = At least one device matching this call (RING on ttyI).
521                     HL-driver may send ALERTING on the D-channel in this case.
522       2           = Call will be rejected.
523       3           = Incoming called party number is currently incomplete.
524                     Additional digits are required. 
525                     Used for signalling with PtP connections.
526       4           = Call will be held in a proceeding state 
527                     (HL driver sends PROCEEDING)
528                     Used when a user space prog needs time to interpret a call
529                     para.setup.eazmsn may be filled with an uus1 message of
530                     30 octets maximum. Empty string if no uus. 
531       5           = Call will be actively deflected to another party
532                     Only available in DSS1/EURO protocol
533                     para.setup.phone must be set to destination party number
534                     para.setup.eazmsn may be filled with an uus1 message of
535                     30 octets maximum. Empty string if no uus. 
536       -1          = An error happened. (Invalid parameters for example.)
537   The keypad support now is included in the dial command.               
538
539
540   ISDN_STAT_RUN:
541
542     With this call, the HL-driver signals availability of the ISDN-card.
543     (after initializing, loading firmware)
544
545     Parameter:
546       driver      = driver-Id
547       command     = ISDN_STAT_RUN
548       arg         = unused.
549       parm        = unused.
550
551   ISDN_STAT_STOP:
552
553     With this call, the HL-driver signals unavailability of the ISDN-card.
554     (before unloading, while resetting/reconfiguring the card)
555
556     Parameter:
557       driver      = driver-Id
558       command     = ISDN_STAT_STOP
559       arg         = unused.
560       parm        = unused.
561
562   ISDN_STAT_DCONN:
563
564    With this call, the HL-driver signals the successful establishment of
565    a D-Channel-connection. (Response to ISDN_CMD_ACCEPTD or ISDN_CMD_DIAL)
566
567     Parameter:
568       driver      = driver-Id
569       command     = ISDN_STAT_DCONN
570       arg         = channel-number, locally to the driver. (starting with 0)
571       parm        = unused.
572
573   ISDN_STAT_BCONN:
574
575    With this call, the HL-driver signals the successful establishment of
576    a B-Channel-connection. (Response to ISDN_CMD_ACCEPTB or because the
577    remote-station has initiated establishment)
578
579    The HL driver should call this when the logical l2/l3 protocol 
580    connection on top of the physical B-channel is established.
581
582     Parameter:
583       driver      = driver-Id
584       command     = ISDN_STAT_BCONN
585       arg         = channel-number, locally to the driver. (starting with 0)
586       parm.num    = ASCII-String, containing type of connection (for analog
587                     modem only). This will be appended to the CONNECT message
588                     e.g. 14400/V.32bis
589
590   ISDN_STAT_DHUP:
591
592    With this call, the HL-driver signals the shutdown of a
593    D-Channel-connection. This could be a response to a prior ISDN_CMD_HANGUP,
594    or caused by a remote-hangup or if the remote-station has actively
595    rejected a call.
596
597     Parameter:
598       driver      = driver-Id
599       command     = ISDN_STAT_DHUP
600       arg         = channel-number, locally to the driver. (starting with 0)
601       parm        = unused.
602
603   ISDN_STAT_BHUP:
604
605    With this call, the HL-driver signals the shutdown of a
606    B-Channel-connection. This could be a response to a prior ISDN_CMD_HANGUP,
607    or caused by a remote-hangup.
608
609    The HL driver should call this as soon as the logical l2/l3 protocol 
610    connection on top of the physical B-channel is released.
611
612     Parameter:
613       driver      = driver-Id
614       command     = ISDN_STAT_BHUP
615       arg         = channel-number, locally to the driver. (starting with 0)
616       parm        = unused.
617
618   ISDN_STAT_CINF:
619
620    With this call, the HL-driver delivers charge-unit information to the
621    LL.
622
623     Parameter:
624       driver      = driver-Id
625       command     = ISDN_STAT_CINF
626       arg         = channel-number, locally to the driver. (starting with 0)
627       parm.num    = ASCII string containing charge-units (digits only).
628
629   ISDN_STAT_LOAD: (currently unused)
630
631   ISDN_STAT_UNLOAD:
632
633    With this call, the HL-driver signals that it will be unloaded now. This
634    tells the LL to release all corresponding data-structures.
635
636     Parameter:
637       driver      = driver-Id
638       command     = ISDN_STAT_UNLOAD
639       arg         = unused.
640       parm        = unused.
641
642   ISDN_STAT_BSENT:
643
644     With this call the HL-driver signals the delivery of a data-packet.
645     This callback is used by the network-interfaces only, tty-Emulation
646     does not need this call.
647
648     Parameter:
649       driver      = driver-Id
650       command     = ISDN_STAT_BSENT
651       arg         = channel-number, locally to the driver. (starting with 0)
652       parm.length = ***CHANGEI.1.21: New field.
653                     the driver has to set this to the original length
654                     of the skb at the time of receiving it from the linklevel.
655
656   ISDN_STAT_NODCH:
657
658     With this call, the driver has to respond to a prior ISDN_CMD_DIAL, if
659     no D-Channel is available.
660
661     Parameter:
662       driver      = driver-Id
663       command     = ISDN_STAT_NODCH
664       arg         = channel-number, locally to the driver. (starting with 0)
665       parm        = unused.
666
667   ISDN_STAT_ADDCH: 
668
669     This call is for HL-drivers, which are unable to check card-type
670     or numbers of supported channels before they have loaded any firmware
671     using ioctl. Those HL-driver simply set the channel-parameter to a
672     minimum channel-number when registering, and later if they know
673     the real amount, perform this call, allocating additional channels.
674
675     Parameter:
676       driver      = driver-Id
677       command     = ISDN_STAT_ADDCH
678       arg         = number of channels to be added.
679       parm        = unused.
680
681   ISDN_STAT_CAUSE:
682
683     With this call, the HL-driver delivers CAUSE-messages to the LL.
684     Currently the LL does not use this messages. Their contents is simply
685     logged via kernel-messages. Therefore, currently the format of the
686     messages is completely free. However they should be printable.
687
688     Parameter:
689       driver      = driver-Id
690       command     = ISDN_STAT_NODCH
691       arg         = channel-number, locally to the driver. (starting with 0)
692       parm.num    = ASCII string containing CAUSE-message.
693
694   ISDN_STAT_DISPLAY:
695
696     With this call, the HL-driver delivers DISPLAY-messages to the LL.
697     Currently the LL does not use this messages. 
698
699     Parameter:
700       driver      = driver-Id
701       command     = ISDN_STAT_DISPLAY
702       arg         = channel-number, locally to the driver. (starting with 0)
703       para.display= string containing DISPLAY-message.
704
705   ISDN_STAT_PROT:
706
707     With this call, the HL-driver delivers protocol specific infos to the LL.
708     The call is not implicitely bound to a connection.
709
710     Parameter:
711       driver      = driver-Id
712       command     = ISDN_STAT_PROT
713       arg         = The lower 8 Bits define the addressed protocol as defined
714                     in ISDN_PTYPE..., the upper bits are used to differentiate
715                     the protocol specific STAT.  
716       
717       para        = protocol and function specific. See isdnif.h for detail.
718
719   ISDN_STAT_DISCH:
720
721     With this call, the HL-driver signals the LL to disable or enable the
722     use of supplied channel and driver.
723     The call may be used to reduce the available number of B-channels after
724     loading the driver. The LL has to ignore a disabled channel when searching
725     for free channels. The HL driver itself never delivers STAT callbacks for
726     disabled channels.      
727     The LL returns a nonzero code if the operation was not successful or the
728     selected channel is actually regarded as busy.
729
730     Parameter:
731       driver      = driver-Id
732       command     = ISDN_STAT_DISCH
733       arg         = channel-number, locally to the driver. (starting with 0)
734       parm.num[0] = 0 if channel shall be disabled, else enabled.
735
736   ISDN_STAT_L1ERR:
737
738     ***CHANGEI1.21 new status message.
739     A signal can be sent to the linklevel if an Layer1-error results in
740     packet-loss on receive or send. The field errcode of the cmd.parm
741     union describes the error more precisely.
742
743     Parameter:
744       driver      = driver-Id
745       command     = ISDN_STAT_L1ERR
746       arg         = channel-number, locally to the driver. (starting with 0)
747       parm.errcode= ISDN_STAT_L1ERR_SEND:     Packet lost while sending.
748                     ISDN_STAT_L1ERR_RECV:     Packet lost while receiving.
749   ISDN_STAT_FAXIND:
750
751     With this call the HL-driver signals a fax sub-command to the LL.
752     For details refer to INTERFACE.fax
753
754     Parameter:
755       driver      = driver-Id.
756       command     = ISDN_STAT_FAXIND
757       arg         = channel-number, locally to the driver. (starting with 0)
758       parm        = unused.
759