patch-2.0.31 linux/Documentation/isdn/INTERFACE
Next file: linux/Documentation/isdn/README
Previous file: linux/Documentation/isdn/CREDITS
Back to the patch index
Back to the overall index
- Lines: 341
- Date:
Mon Aug 4 17:33:58 1997
- Orig file:
v2.0.30/linux/Documentation/isdn/INTERFACE
- Orig date:
Tue Nov 12 22:36:19 1996
diff -u --recursive --new-file v2.0.30/linux/Documentation/isdn/INTERFACE linux/Documentation/isdn/INTERFACE
@@ -1,4 +1,4 @@
-$Id: INTERFACE,v 1.5 1996/11/06 17:40:47 keil Exp $
+$Id: INTERFACE,v 1.6 1997/02/10 22:40:57 fritz Exp $
Description of the Interface between Linklevel and Hardwarelevel
of isdn4linux:
@@ -140,7 +140,7 @@
int (*writebuf)(int, int, u_char*, int, int);
- ***CHANGEc1.14: Declared obsolete. Do NOT use this field/function
+ ***CHANGED1.14: Declared obsolete. Do NOT use this field/function
anymore, since it will be removed when all current
LL drivers have been changed accordingly. Set this
field to NULL and use writebuf_skb instead.
@@ -199,7 +199,7 @@
int driver-Id.
int channel-number locally to the HL-driver. (starts with 0)
-***CHANGEc1.14: The driver-Id and channel-number are new since this revision.
+***CHANGED1.14: The driver-Id and channel-number are new since this revision.
Returnvalue:
Length of data accepted on success, else error-code (-EINVAL etc.)
@@ -223,7 +223,7 @@
int driver-Id.
int channel-number locally to the HL-driver. (starts with 0)
-***CHANGEc1.14: The driver-Id and channel-number are new since this revision.
+***CHANGED1.14: The driver-Id and channel-number are new since this revision.
Returnvalue:
Length of data on success, else error-code (-EINVAL etc.)
@@ -249,6 +249,9 @@
Until now, the following commands are defined:
+***CHANGED1.34: The parameter "num" has been replaced by a union "para" containing
+ the old "num" and a new setup_type struct used for ISDN_CMD_DIAL
+ and ISDN_STAT_ICALL callback.
ISDN_CMD_IOCTL:
@@ -262,10 +265,10 @@
called with the field command set to 1.
Parameter:
- driver = driver-Id.
- command = ISDN_CMD_IOCTL
- arg = Original ioctl-cmd - IIOCDRVCTL
- num = first bytes filled with (unsigned long)arg
+ driver = driver-Id.
+ command = ISDN_CMD_IOCTL
+ arg = Original ioctl-cmd - IIOCDRVCTL
+ para.num = first bytes filled with (unsigned long)arg
Returnvalue:
Depending on driver.
@@ -280,12 +283,14 @@
driver = driver-Id.
command = ISDN_CMD_DIAL
arg = channel-number locally to the driver. (starting with 0)
- num = An ASCII-String containing the number to dial, the own
- EAZ or MSN, the Service-Indicator and the Additional
- Info. Format:
- "%s,%s,%d,%d" RemotePhoneNumber,EazOrMsn,SI,AI
+
+ para.setup.phone = An ASCII-String containing the number to dial.
+ para.setup.eazmsn = An ASCII-Sting containing the own EAZ or MSN.
+ para.setup.si1 = The Service-Indicator.
+ para.setup.si2 = Additional Service-Indicator.
+
If the Line has been designed as SPV (a special german
- feature, meaning semi-leased-line) the number has to
+ 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.
@@ -300,7 +305,7 @@
driver = driver-Id.
command = ISDN_CMD_ACCEPTD
arg = channel-number locally to the driver. (starting with 0)
- num = unused.
+ para = unused.
ISDN_CMD_ACCEPTB:
@@ -311,7 +316,7 @@
driver = driver-Id.
command = ISDN_CMD_ACCEPTB
arg = channel-number locally to the driver. (starting with 0)
- num = unused.
+ para = unused.
ISDN_CMD_HANGUP:
@@ -323,7 +328,7 @@
driver = driver-Id.
command = ISDN_CMD_HANGUP
arg = channel-number locally to the driver. (starting with 0)
- num = unused.
+ para = unused.
ISDN_CMD_CLREAZ:
@@ -334,7 +339,7 @@
driver = driver-Id.
command = ISDN_CMD_CLREAZ
arg = channel-number locally to the driver. (starting with 0)
- num = unused.
+ para = unused.
ISDN_CMD_SETEAZ:
@@ -345,7 +350,7 @@
driver = driver-Id.
command = ISDN_CMD_SETEAZ
arg = channel-number locally to the driver. (starting with 0)
- num = ASCII-String, containing the desired EAZ's/MSN's
+ para.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.
@@ -360,7 +365,7 @@
driver = driver-Id.
command = ISDN_CMD_GETEAZ
arg = channel-number locally to the driver. (starting with 0)
- num = ASCII-String, containing the current EAZ's/MSN's
+ para.num = ASCII-String, containing the current EAZ's/MSN's
ISDN_CMD_SETSIL: (currently unused)
@@ -371,7 +376,7 @@
driver = driver-Id.
command = ISDN_CMD_SETSIL
arg = channel-number locally to the driver. (starting with 0)
- num = ASCII-String, containing the desired Service-Indicators.
+ para.num = ASCII-String, containing the desired Service-Indicators.
ISDN_CMD_GETSIL: (currently unused)
@@ -382,7 +387,7 @@
driver = driver-Id.
command = ISDN_CMD_SETSIL
arg = channel-number locally to the driver. (starting with 0)
- num = ASCII-String, containing the current Service-Indicators.
+ para.num = ASCII-String, containing the current Service-Indicators.
ISDN_CMD_SETL2:
@@ -397,7 +402,7 @@
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...
- num = unused.
+ para = unused.
ISDN_CMD_GETL2: (currently unused)
@@ -408,7 +413,7 @@
driver = driver-Id.
command = ISDN_CMD_GETL2
arg = channel-number locally to the driver. (starting with 0)
- num = unused.
+ para = unused.
Returnvalue:
current protocol-Id (one of the constants ISDN_L2_PROTO)
@@ -425,7 +430,7 @@
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...
- num = unused.
+ para = unused.
ISDN_CMD_GETL2: (currently unused)
@@ -436,7 +441,7 @@
driver = driver-Id.
command = ISDN_CMD_GETL3
arg = channel-number locally to the driver. (starting with 0)
- num = unused.
+ para = unused.
Returnvalue:
current protocol-Id (one of the constants ISDN_L3_PROTO)
@@ -450,7 +455,7 @@
driver = driver-Id.
command = ISDN_CMD_LOCK
arg = unused.
- num = unused.
+ para = unused.
ISDN_CMD_UNLOCK:
@@ -462,7 +467,7 @@
driver = driver-Id.
command = ISDN_CMD_UNLOCK
arg = unused.
- num = unused.
+ para = unused.
3. Description of the events to be signaled by the HL-driver to th LL.
@@ -484,19 +489,23 @@
driver = driver-Id
command = ISDN_STAT_STAVAIL
arg = length of available data.
- num = unused.
+ para = unused.
ISDN_STAT_ICALL:
With this call, the HL-driver signals an incoming call to the LL.
Parameter:
- driver = driver-Id
- command = ISDN_STAT_ICALL
- arg = channel-number, locally to the driver. (starting with 0)
- num = ASCII-String in the following format:
- "%s,%d,%d,%s",CallerNumber,ServiceIndicator,AddInfo,
- CalledNumber.
+ 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).
@@ -513,7 +522,7 @@
driver = driver-Id
command = ISDN_STAT_RUN
arg = unused.
- num = unused.
+ para = unused.
ISDN_STAT_STOP:
@@ -524,7 +533,7 @@
driver = driver-Id
command = ISDN_STAT_STOP
arg = unused.
- num = unused.
+ para = unused.
ISDN_STAT_DCONN:
@@ -535,7 +544,7 @@
driver = driver-Id
command = ISDN_STAT_DCONN
arg = channel-number, locally to the driver. (starting with 0)
- num = unused.
+ para = unused.
ISDN_STAT_BCONN:
@@ -547,7 +556,7 @@
driver = driver-Id
command = ISDN_STAT_BCONN
arg = channel-number, locally to the driver. (starting with 0)
- num = unused.
+ para = unused.
ISDN_STAT_DHUP:
@@ -560,7 +569,7 @@
driver = driver-Id
command = ISDN_STAT_DHUP
arg = channel-number, locally to the driver. (starting with 0)
- num = unused.
+ para = unused.
ISDN_STAT_BHUP:
@@ -572,7 +581,7 @@
driver = driver-Id
command = ISDN_STAT_BHUP
arg = channel-number, locally to the driver. (starting with 0)
- num = unused.
+ para = unused.
ISDN_STAT_CINF:
@@ -583,7 +592,7 @@
driver = driver-Id
command = ISDN_STAT_CINF
arg = channel-number, locally to the driver. (starting with 0)
- num = ASCII string containing charge-units (digits only).
+ para.num = ASCII string containing charge-units (digits only).
ISDN_STAT_LOAD: (currently unused)
@@ -596,7 +605,7 @@
driver = driver-Id
command = ISDN_STAT_UNLOAD
arg = unused.
- num = unused.
+ para = unused.
ISDN_STAT_BSENT:
@@ -608,7 +617,7 @@
driver = driver-Id
command = ISDN_STAT_BSENT
arg = channel-number, locally to the driver. (starting with 0)
- num = unused.
+ para = unused.
ISDN_STAT_NODCH:
@@ -619,7 +628,7 @@
driver = driver-Id
command = ISDN_STAT_NODCH
arg = channel-number, locally to the driver. (starting with 0)
- num = unused.
+ para = unused.
ISDN_STAT_ADDCH: (currently unused)
@@ -633,7 +642,7 @@
driver = driver-Id
command = ISDN_STAT_ADDCH
arg = to be defined.
- num = to be defined.
+ para = to be defined.
ISDN_STAT_CAUSE:
@@ -646,5 +655,5 @@
driver = driver-Id
command = ISDN_STAT_NODCH
arg = channel-number, locally to the driver. (starting with 0)
- num = ASCII string containing CAUSE-message.
+ para.num = ASCII string containing CAUSE-message.
FUNET's LINUX-ADM group, linux-adm@nic.funet.fi
TCL-scripts by Sam Shen, slshen@lbl.gov