| $Id: INTERFACE,v 1.15.8.2 2001/03/13 16:17:07 kai Exp $ | |
| Description of the Interface between Linklevel and Hardwarelevel | |
| of isdn4linux: | |
| The Communication between Linklevel (LL) and Hardwarelevel (HL) | |
| is based on the struct isdn_if (defined in isdnif.h). | |
| An HL-driver can register itself at LL by calling the function | |
| register_isdn() with a pointer to that struct. Prior to that, it has | |
| to preset some of the fields of isdn_if. The LL sets the rest of | |
| the fields. All further communication is done via callbacks using | |
| the function-pointers defined in isdn_if. | |
| Changes/Version numbering: | |
| During development of the ISDN subsystem, several changes have been | |
| made to the interface. Before it went into kernel, the package | |
| had a unique version number. The last version, distributed separately | |
| was 0.7.4. When the subsystem went into kernel, every functional unit | |
| got a separate version number. These numbers are shown at initialization, | |
| separated by slashes: | |
| c.c/t.t/n.n/p.p/a.a/v.v | |
| where | |
| c.c is the revision of the common code. | |
| t.t is the revision of the tty related code. | |
| n.n is the revision of the network related code. | |
| p.p is the revision of the ppp related code. | |
| a.a is the revision of the audio related code. | |
| v.v is the revision of the V.110 related code. | |
| Changes in this document are marked with '***CHANGEx' where x representing | |
| the version number. If that number starts with 0, it refers to the old, | |
| separately distributed package. If it starts with one of the letters | |
| above, it refers to the revision of the corresponding module. | |
| ***CHANGEIx refers to the revision number of the isdnif.h | |
| 1. Description of the fields of isdn_if: | |
| int channels; | |
| This field has to be set by the HL-driver to the number of channels | |
| supported prior to calling register_isdn(). Upon return of the call, | |
| the LL puts an id there, which has to be used by the HL-driver when | |
| invoking the other callbacks. | |
| int maxbufsize; | |
| ***CHANGE0.6: New since this version. | |
| Also to be preset by the HL-driver. With this value the HL-driver | |
| tells the LL the maximum size of a data-packet it will accept. | |
| unsigned long features; | |
| To be preset by the HL-driver. Using this field, the HL-driver | |
| announces the features supported. At the moment this is limited to | |
| report the supported layer2 and layer3-protocols. For setting this | |
| field the constants ISDN_FEATURE..., declared in isdnif.h have to be | |
| used. | |
| ***CHANGE0.7.1: The line type (1TR6, EDSS1) has to be set. | |
| unsigned short hl_hdrlen; | |
| ***CHANGE0.7.4: New field. | |
| To be preset by the HL-driver, if it supports sk_buff's. The driver | |
| should put here the amount of additional space needed in sk_buff's for | |
| its internal purposes. Drivers not supporting sk_buff's should | |
| initialize this field to 0. | |
| void (*rcvcallb_skb)(int, int, struct sk_buff *) | |
| ***CHANGE0.7.4: New field. | |
| This field will be set by LL. The HL-driver delivers received data- | |
| packets by calling this function. Upon calling, the HL-driver must | |
| already have its private data pulled off the head of the sk_buff. | |
| Parameter: | |
| int driver-Id | |
| int Channel-number locally to the driver. (starting with 0) | |
| struct sk_buff * Pointer to sk_buff, containing received data. | |
| int (*statcallb)(isdn_ctrl*); | |
| This field will be set by LL. This function has to be called by the | |
| HL-driver for signaling status-changes or other events to the LL. | |
| Parameter: | |
| isdn_ctrl* | |
| The struct isdn_ctrl also defined in isdn_if. The exact meanings of its | |
| fields are described together with the descriptions of the possible | |
| events. Here is only a short description of the fields: | |
| driver = driver Id. | |
| command = event-type. (one of the constants ISDN_STAT_...) | |
| arg = depends on event-type. | |
| num = depends on event-type. | |
| Returnvalue: | |
| 0 on success, else -1 | |
| int (*command)(isdn_ctrl*); | |
| This field has to be preset by the HL-driver. It points to a function, | |
| to be called by LL to perform functions like dialing, B-channel | |
| setup, etc. The exact meaning of the parameters is described with the | |
| descriptions of the possible commands. | |
| Parameter: | |
| isdn_ctrl* | |
| driver = driver-Id | |
| command = command to perform. (one of the constants ISDN_CMD_...) | |
| arg = depends on command. | |
| num = depends on command. | |
| Returnvalue: | |
| >=0 on success, else error-code (-ENODEV etc.) | |
| int (*writebuf_skb)(int, int, int, struct sk_buff *) | |
| ***CHANGE0.7.4: New field. | |
| ***CHANGEI.1.21: New field. | |
| This field has to be preset by the HL-driver. The given function will | |
| be called by the LL for delivering data to be send via B-Channel. | |
| Parameter: | |
| int driver-Id ***CHANGE0.7.4: New parameter. | |
| int channel-number locally to the HL-driver. (starts with 0) | |
| int ack ***ChangeI1.21: New parameter | |
| If this is !0, the driver has to signal the delivery | |
| by sending an ISDN_STAT_BSENT. If this is 0, the driver | |
| MUST NOT send an ISDN_STAT_BSENT. | |
| struct sk_buff * Pointer to sk_buff containing data to be send via | |
| B-channel. | |
| Returnvalue: | |
| Length of data accepted on success, else error-code (-EINVAL on | |
| oversized packets etc.) | |
| int (*writecmd)(u_char*, int, int, int, int); | |
| This field has to be preset by the HL-driver. The given function will be | |
| called to perform write-requests on /dev/isdnctrl (i.e. sending commands | |
| to the card) The data-format is hardware-specific. This function is | |
| intended for debugging only. It is not necessary for normal operation | |
| and never will be called by the tty-emulation- or network-code. If | |
| this function is not supported, the driver has to set NULL here. | |
| Parameter: | |
| u_char* pointer to data. | |
| int length of data. | |
| int flag: 0 = call from within kernel-space. (HL-driver must use | |
| memcpy, may NOT use schedule()) | |
| 1 = call from user-space. (HL-driver must use | |
| memcpy_fromfs, use of schedule() allowed) | |
| int driver-Id. | |
| int channel-number locally to the HL-driver. (starts with 0) | |
| ***CHANGEI1.14: The driver-Id and channel-number are new since this revision. | |
| Returnvalue: | |
| Length of data accepted on success, else error-code (-EINVAL etc.) | |
| int (*readstat)(u_char*, int, int, int, int); | |
| This field has to be preset by the HL-driver. The given function will be | |
| called to perform read-requests on /dev/isdnctrl (i.e. reading replies | |
| from the card) The data-format is hardware-specific. This function is | |
| intended for debugging only. It is not necessary for normal operation | |
| and never will be called by the tty-emulation- or network-code. If | |
| this function is not supported, the driver has to set NULL here. | |
| Parameter: | |
| u_char* pointer to data. | |
| int length of data. | |
| int flag: 0 = call from within kernel-space. (HL-driver must use | |
| memcpy, may NOT use schedule()) | |
| 1 = call from user-space. (HL-driver must use | |
| memcpy_fromfs, use of schedule() allowed) | |
| int driver-Id. | |
| int channel-number locally to the HL-driver. (starts with 0) | |
| ***CHANGEI1.14: The driver-Id and channel-number are new since this revision. | |
| Returnvalue: | |
| Length of data on success, else error-code (-EINVAL etc.) | |
| char id[20]; | |
| ***CHANGE0.7: New since this version. | |
| This string has to be preset by the HL-driver. Its purpose is for | |
| identification of the driver by the user. Eg.: it is shown in the | |
| status-info of /dev/isdninfo. Furthermore it is used as Id for binding | |
| net-interfaces to a specific channel. If a string of length zero is | |
| given, upon return, isdn4linux will replace it by a generic name. (line0, | |
| line1 etc.) It is recommended to make this string configurable during | |
| module-load-time. (copy a global variable to this string.) For doing that, | |
| modules 1.2.8 or newer are necessary. | |
| 2. Description of the commands, a HL-driver has to support: | |
| All commands will be performed by calling the function command() described | |
| above from within the LL. The field command of the struct-parameter will | |
| contain the desired command, the field driver is always set to the | |
| appropriate driver-Id. | |
| Until now, the following commands are defined: | |
| ***CHANGEI1.34: The parameter "num" has been replaced by a union "parm" containing | |
| the old "num" and a new setup_type struct used for ISDN_CMD_DIAL | |
| and ISDN_STAT_ICALL callback. | |
| ISDN_CMD_IOCTL: | |
| This command is intended for performing ioctl-calls for configuring | |
| hardware or similar purposes (setting port-addresses, loading firmware | |
| etc.) For this purpose, in the LL all ioctl-calls with an argument | |
| >= IIOCDRVCTL (0x100) will be handed transparently to this | |
| function after subtracting 0x100 and placing the result in arg. | |
| Example: | |
| If a userlevel-program calls ioctl(0x101,...) the function gets | |
| called with the field command set to 1. | |
| Parameter: | |
| driver = driver-Id. | |
| command = ISDN_CMD_IOCTL | |
| arg = Original ioctl-cmd - IIOCDRVCTL | |
| parm.num = first bytes filled with (unsigned long)arg | |
| Returnvalue: | |
| Depending on driver. | |
| ISDN_CMD_DIAL: | |
| This command is used to tell the HL-driver it should dial a given | |
| number. | |
| Parameter: | |
| driver = driver-Id. | |
| command = ISDN_CMD_DIAL | |
| arg = channel-number locally to the driver. (starting with 0) | |
| parm.setup.phone = An ASCII-String containing the number to dial. | |
| parm.setup.eazmsn = An ASCII-Sting containing the own EAZ or MSN. | |
| parm.setup.si1 = The Service-Indicator. | |
| parm.setup.si2 = Additional Service-Indicator. | |
| If the Line has been designed as SPV (a special german | |
| feature, meaning semi-leased-line) the phone has to | |
| start with an "S". | |
| ***CHANGE0.6: In previous versions the EAZ has been given in the | |
| highbyte of arg. | |
| ***CHANGE0.7.1: New since this version: ServiceIndicator and AddInfo. | |
| ISDN_CMD_ACCEPTD: | |
| With this command, the HL-driver is told to accept a D-Channel-setup. | |
| (Response to an incoming call) | |
| Parameter: | |
| driver = driver-Id. | |
| command = ISDN_CMD_ACCEPTD | |
| arg = channel-number locally to the driver. (starting with 0) | |
| parm = unused. | |
| ISDN_CMD_ACCEPTB: | |
| With this command, the HL-driver is told to perform a B-Channel-setup. | |
| (after establishing D-Channel-Connection) | |
| Parameter: | |
| driver = driver-Id. | |
| command = ISDN_CMD_ACCEPTB | |
| arg = channel-number locally to the driver. (starting with 0) | |
| parm = unused. | |
| ISDN_CMD_HANGUP: | |
| With this command, the HL-driver is told to hangup (B-Channel if | |
| established first, then D-Channel). This command is also used for | |
| actively rejecting an incoming call. | |
| Parameter: | |
| driver = driver-Id. | |
| command = ISDN_CMD_HANGUP | |
| arg = channel-number locally to the driver. (starting with 0) | |
| parm = unused. | |
| ISDN_CMD_CLREAZ: | |
| With this command, the HL-driver is told not to signal incoming | |
| calls to the LL. | |
| Parameter: | |
| driver = driver-Id. | |
| command = ISDN_CMD_CLREAZ | |
| arg = channel-number locally to the driver. (starting with 0) | |
| parm = unused. | |
| ISDN_CMD_SETEAZ: | |
| With this command, the HL-driver is told to signal incoming calls for | |
| the given EAZs/MSNs to the LL. | |
| Parameter: | |
| driver = driver-Id. | |
| command = ISDN_CMD_SETEAZ | |
| arg = channel-number locally to the driver. (starting with 0) | |
| parm.num = ASCII-String, containing the desired EAZ's/MSN's | |
| (comma-separated). If an empty String is given, the | |
| HL-driver should respond to ALL incoming calls, | |
| regardless of the destination-address. | |
| ***CHANGE0.6: New since this version the "empty-string"-feature. | |
| ISDN_CMD_GETEAZ: (currently unused) | |
| With this command, the HL-driver is told to report the current setting | |
| given with ISDN_CMD_SETEAZ. | |
| Parameter: | |
| driver = driver-Id. | |
| command = ISDN_CMD_GETEAZ | |
| arg = channel-number locally to the driver. (starting with 0) | |
| parm.num = ASCII-String, containing the current EAZ's/MSN's | |
| ISDN_CMD_SETSIL: (currently unused) | |
| With this command, the HL-driver is told to signal only incoming | |
| calls with the given Service-Indicators. | |
| Parameter: | |
| driver = driver-Id. | |
| command = ISDN_CMD_SETSIL | |
| arg = channel-number locally to the driver. (starting with 0) | |
| parm.num = ASCII-String, containing the desired Service-Indicators. | |
| ISDN_CMD_GETSIL: (currently unused) | |
| With this command, the HL-driver is told to return the current | |
| Service-Indicators it will respond to. | |
| Parameter: | |
| driver = driver-Id. | |
| command = ISDN_CMD_SETSIL | |
| arg = channel-number locally to the driver. (starting with 0) | |
| parm.num = ASCII-String, containing the current Service-Indicators. | |
| ISDN_CMD_SETL2: | |
| With this command, the HL-driver is told to select the given Layer-2- | |
| protocol. This command is issued by the LL prior to ISDN_CMD_DIAL or | |
| ISDN_CMD_ACCEPTD. | |
| Parameter: | |
| driver = driver-Id. | |
| command = ISDN_CMD_SETL2 | |
| arg = channel-number locally to the driver. (starting with 0) | |
| logical or'ed with (protocol-Id << 8) | |
| protocol-Id is one of the constants ISDN_PROTO_L2... | |
| parm = unused. | |
| ISDN_CMD_GETL2: (currently unused) | |
| With this command, the HL-driver is told to return the current | |
| setting of the Layer-2-protocol. | |
| Parameter: | |
| driver = driver-Id. | |
| command = ISDN_CMD_GETL2 | |
| arg = channel-number locally to the driver. (starting with 0) | |
| parm = unused. | |
| Returnvalue: | |
| current protocol-Id (one of the constants ISDN_L2_PROTO) | |
| ISDN_CMD_SETL3: | |
| With this command, the HL-driver is told to select the given Layer-3- | |
| protocol. This command is issued by the LL prior to ISDN_CMD_DIAL or | |
| ISDN_CMD_ACCEPTD. | |
| Parameter: | |
| driver = driver-Id. | |
| command = ISDN_CMD_SETL3 | |
| arg = channel-number locally to the driver. (starting with 0) | |
| logical or'ed with (protocol-Id << 8) | |
| protocol-Id is one of the constants ISDN_PROTO_L3... | |
| parm.fax = Pointer to T30_s fax struct. (fax usage only) | |
| ISDN_CMD_GETL2: (currently unused) | |
| With this command, the HL-driver is told to return the current | |
| setting of the Layer-3-protocol. | |
| Parameter: | |
| driver = driver-Id. | |
| command = ISDN_CMD_GETL3 | |
| arg = channel-number locally to the driver. (starting with 0) | |
| parm = unused. | |
| Returnvalue: | |
| current protocol-Id (one of the constants ISDN_L3_PROTO) | |
| ISDN_CMD_PROCEED: | |
| With this command, the HL-driver is told to proceed with a incoming call. | |
| Parameter: | |
| driver = driver-Id. | |
| command = ISDN_CMD_PROCEED | |
| arg = channel-number locally to the driver. (starting with 0) | |
| setup.eazmsn= empty string or string send as uus1 in DSS1 with | |
| PROCEED message | |
| ISDN_CMD_ALERT: | |
| With this command, the HL-driver is told to alert a proceeding call. | |
| Parameter: | |
| driver = driver-Id. | |
| command = ISDN_CMD_ALERT | |
| arg = channel-number locally to the driver. (starting with 0) | |
| setup.eazmsn= empty string or string send as uus1 in DSS1 with | |
| ALERT message | |
| ISDN_CMD_REDIR: | |
| With this command, the HL-driver is told to redirect a call in proceeding | |
| or alerting state. | |
| Parameter: | |
| driver = driver-Id. | |
| command = ISDN_CMD_REDIR | |
| arg = channel-number locally to the driver. (starting with 0) | |
| setup.eazmsn= empty string or string send as uus1 in DSS1 protocol | |
| setup.screen= screening indicator | |
| setup.phone = redirected to party number | |
| ISDN_CMD_PROT_IO: | |
| With this call, the LL-driver invokes protocol specific features through | |
| the LL. | |
| The call is not implicitely bound to a connection. | |
| Parameter: | |
| driver = driver-Id | |
| command = ISDN_CMD_PROT_IO | |
| arg = The lower 8 Bits define the addressed protocol as defined | |
| in ISDN_PTYPE..., the upper bits are used to differentiate | |
| the protocol specific CMD. | |
| para = protocol and function specific. See isdnif.h for detail. | |
| ISDN_CMD_FAXCMD: | |
| With this command the HL-driver receives a fax sub-command. | |
| For details refer to INTERFACE.fax | |
| Parameter: | |
| driver = driver-Id. | |
| command = ISDN_CMD_FAXCMD | |
| arg = channel-number locally to the driver. (starting with 0) | |
| parm = unused. | |
| 3. Description of the events to be signaled by the HL-driver to the LL. | |
| All status-changes are signaled via calling the previously described | |
| function statcallb(). The field command of the struct isdn_cmd has | |
| to be set by the HL-driver with the appropriate Status-Id (event-number). | |
| The field arg has to be set to the channel-number (locally to the driver, | |
| starting with 0) to which this event applies. (Exception: STAVAIL-event) | |
| Until now, the following Status-Ids are defined: | |
| ISDN_STAT_AVAIL: | |
| With this call, the HL-driver signals the availability of new data | |
| for readstat(). Used only for debugging-purposes, see description | |
| of readstat(). | |
| Parameter: | |
| driver = driver-Id | |
| command = ISDN_STAT_STAVAIL | |
| arg = length of available data. | |
| parm = unused. | |
| ISDN_STAT_ICALL: | |
| ISDN_STAT_ICALLW: | |
| With this call, the HL-driver signals an incoming call to the LL. | |
| If ICALLW is signalled the incoming call is a waiting call without | |
| a available B-chan. | |
| Parameter: | |
| driver = driver-Id | |
| command = ISDN_STAT_ICALL | |
| arg = channel-number, locally to the driver. (starting with 0) | |
| para.setup.phone = Callernumber. | |
| para.setup.eazmsn = CalledNumber. | |
| para.setup.si1 = Service Indicator. | |
| para.setup.si2 = Additional Service Indicator. | |
| para.setup.plan = octet 3 from Calling party number Information Element. | |
| para.setup.screen = octet 3a from Calling party number Information Element. | |
| Return: | |
| 0 = No device matching this call. | |
| 1 = At least one device matching this call (RING on ttyI). | |
| HL-driver may send ALERTING on the D-channel in this case. | |
| 2 = Call will be rejected. | |
| 3 = Incoming called party number is currently incomplete. | |
| Additional digits are required. | |
| Used for signalling with PtP connections. | |
| 4 = Call will be held in a proceeding state | |
| (HL driver sends PROCEEDING) | |
| Used when a user space prog needs time to interpret a call | |
| para.setup.eazmsn may be filled with an uus1 message of | |
| 30 octets maximum. Empty string if no uus. | |
| 5 = Call will be actively deflected to another party | |
| Only available in DSS1/EURO protocol | |
| para.setup.phone must be set to destination party number | |
| para.setup.eazmsn may be filled with an uus1 message of | |
| 30 octets maximum. Empty string if no uus. | |
| -1 = An error happened. (Invalid parameters for example.) | |
| The keypad support now is included in the dial command. | |
| ISDN_STAT_RUN: | |
| With this call, the HL-driver signals availability of the ISDN-card. | |
| (after initializing, loading firmware) | |
| Parameter: | |
| driver = driver-Id | |
| command = ISDN_STAT_RUN | |
| arg = unused. | |
| parm = unused. | |
| ISDN_STAT_STOP: | |
| With this call, the HL-driver signals unavailability of the ISDN-card. | |
| (before unloading, while resetting/reconfiguring the card) | |
| Parameter: | |
| driver = driver-Id | |
| command = ISDN_STAT_STOP | |
| arg = unused. | |
| parm = unused. | |
| ISDN_STAT_DCONN: | |
| With this call, the HL-driver signals the successful establishment of | |
| a D-Channel-connection. (Response to ISDN_CMD_ACCEPTD or ISDN_CMD_DIAL) | |
| Parameter: | |
| driver = driver-Id | |
| command = ISDN_STAT_DCONN | |
| arg = channel-number, locally to the driver. (starting with 0) | |
| parm = unused. | |
| ISDN_STAT_BCONN: | |
| With this call, the HL-driver signals the successful establishment of | |
| a B-Channel-connection. (Response to ISDN_CMD_ACCEPTB or because the | |
| remote-station has initiated establishment) | |
| The HL driver should call this when the logical l2/l3 protocol | |
| connection on top of the physical B-channel is established. | |
| Parameter: | |
| driver = driver-Id | |
| command = ISDN_STAT_BCONN | |
| arg = channel-number, locally to the driver. (starting with 0) | |
| parm.num = ASCII-String, containing type of connection (for analog | |
| modem only). This will be appended to the CONNECT message | |
| e.g. 14400/V.32bis | |
| ISDN_STAT_DHUP: | |
| With this call, the HL-driver signals the shutdown of a | |
| D-Channel-connection. This could be a response to a prior ISDN_CMD_HANGUP, | |
| or caused by a remote-hangup or if the remote-station has actively | |
| rejected a call. | |
| Parameter: | |
| driver = driver-Id | |
| command = ISDN_STAT_DHUP | |
| arg = channel-number, locally to the driver. (starting with 0) | |
| parm = unused. | |
| ISDN_STAT_BHUP: | |
| With this call, the HL-driver signals the shutdown of a | |
| B-Channel-connection. This could be a response to a prior ISDN_CMD_HANGUP, | |
| or caused by a remote-hangup. | |
| The HL driver should call this as soon as the logical l2/l3 protocol | |
| connection on top of the physical B-channel is released. | |
| Parameter: | |
| driver = driver-Id | |
| command = ISDN_STAT_BHUP | |
| arg = channel-number, locally to the driver. (starting with 0) | |
| parm = unused. | |
| ISDN_STAT_CINF: | |
| With this call, the HL-driver delivers charge-unit information to the | |
| LL. | |
| Parameter: | |
| driver = driver-Id | |
| command = ISDN_STAT_CINF | |
| arg = channel-number, locally to the driver. (starting with 0) | |
| parm.num = ASCII string containing charge-units (digits only). | |
| ISDN_STAT_LOAD: (currently unused) | |
| ISDN_STAT_UNLOAD: | |
| With this call, the HL-driver signals that it will be unloaded now. This | |
| tells the LL to release all corresponding data-structures. | |
| Parameter: | |
| driver = driver-Id | |
| command = ISDN_STAT_UNLOAD | |
| arg = unused. | |
| parm = unused. | |
| ISDN_STAT_BSENT: | |
| With this call the HL-driver signals the delivery of a data-packet. | |
| This callback is used by the network-interfaces only, tty-Emulation | |
| does not need this call. | |
| Parameter: | |
| driver = driver-Id | |
| command = ISDN_STAT_BSENT | |
| arg = channel-number, locally to the driver. (starting with 0) | |
| parm.length = ***CHANGEI.1.21: New field. | |
| the driver has to set this to the original length | |
| of the skb at the time of receiving it from the linklevel. | |
| ISDN_STAT_NODCH: | |
| With this call, the driver has to respond to a prior ISDN_CMD_DIAL, if | |
| no D-Channel is available. | |
| Parameter: | |
| driver = driver-Id | |
| command = ISDN_STAT_NODCH | |
| arg = channel-number, locally to the driver. (starting with 0) | |
| parm = unused. | |
| ISDN_STAT_ADDCH: | |
| This call is for HL-drivers, which are unable to check card-type | |
| or numbers of supported channels before they have loaded any firmware | |
| using ioctl. Those HL-driver simply set the channel-parameter to a | |
| minimum channel-number when registering, and later if they know | |
| the real amount, perform this call, allocating additional channels. | |
| Parameter: | |
| driver = driver-Id | |
| command = ISDN_STAT_ADDCH | |
| arg = number of channels to be added. | |
| parm = unused. | |
| ISDN_STAT_CAUSE: | |
| With this call, the HL-driver delivers CAUSE-messages to the LL. | |
| Currently the LL does not use this messages. Their contents is simply | |
| logged via kernel-messages. Therefore, currently the format of the | |
| messages is completely free. However they should be printable. | |
| Parameter: | |
| driver = driver-Id | |
| command = ISDN_STAT_NODCH | |
| arg = channel-number, locally to the driver. (starting with 0) | |
| parm.num = ASCII string containing CAUSE-message. | |
| ISDN_STAT_DISPLAY: | |
| With this call, the HL-driver delivers DISPLAY-messages to the LL. | |
| Currently the LL does not use this messages. | |
| Parameter: | |
| driver = driver-Id | |
| command = ISDN_STAT_DISPLAY | |
| arg = channel-number, locally to the driver. (starting with 0) | |
| para.display= string containing DISPLAY-message. | |
| ISDN_STAT_PROT: | |
| With this call, the HL-driver delivers protocol specific infos to the LL. | |
| The call is not implicitely bound to a connection. | |
| Parameter: | |
| driver = driver-Id | |
| command = ISDN_STAT_PROT | |
| arg = The lower 8 Bits define the addressed protocol as defined | |
| in ISDN_PTYPE..., the upper bits are used to differentiate | |
| the protocol specific STAT. | |
| para = protocol and function specific. See isdnif.h for detail. | |
| ISDN_STAT_DISCH: | |
| With this call, the HL-driver signals the LL to disable or enable the | |
| use of supplied channel and driver. | |
| The call may be used to reduce the available number of B-channels after | |
| loading the driver. The LL has to ignore a disabled channel when searching | |
| for free channels. The HL driver itself never delivers STAT callbacks for | |
| disabled channels. | |
| The LL returns a nonzero code if the operation was not successful or the | |
| selected channel is actually regarded as busy. | |
| Parameter: | |
| driver = driver-Id | |
| command = ISDN_STAT_DISCH | |
| arg = channel-number, locally to the driver. (starting with 0) | |
| parm.num[0] = 0 if channel shall be disabled, else enabled. | |
| ISDN_STAT_L1ERR: | |
| ***CHANGEI1.21 new status message. | |
| A signal can be sent to the linklevel if an Layer1-error results in | |
| packet-loss on receive or send. The field errcode of the cmd.parm | |
| union describes the error more precisely. | |
| Parameter: | |
| driver = driver-Id | |
| command = ISDN_STAT_L1ERR | |
| arg = channel-number, locally to the driver. (starting with 0) | |
| parm.errcode= ISDN_STAT_L1ERR_SEND: Packet lost while sending. | |
| ISDN_STAT_L1ERR_RECV: Packet lost while receiving. | |
| ISDN_STAT_FAXIND: | |
| With this call the HL-driver signals a fax sub-command to the LL. | |
| For details refer to INTERFACE.fax | |
| Parameter: | |
| driver = driver-Id. | |
| command = ISDN_STAT_FAXIND | |
| arg = channel-number, locally to the driver. (starting with 0) | |
| parm = unused. | |