patch-2.1.27 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: 347
- Date:
Tue Feb 25 17:12:49 1997
- Orig file:
v2.1.26/linux/Documentation/isdn/INTERFACE
- Orig date:
Sat Jun 29 10:36:22 1996
diff -u --recursive --new-file v2.1.26/linux/Documentation/isdn/INTERFACE linux/Documentation/isdn/INTERFACE
@@ -1,4 +1,4 @@
-$Id: INTERFACE,v 1.3 1996/06/25 17:52:41 fritz 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,29 @@
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).
+ HL-driver may send ALERTING on the D-channel in this case.
+ 2 = Call will be rejected.
+ -1 = An error happened. (Invalid parameters for example.)
ISDN_STAT_RUN:
@@ -507,7 +522,7 @@
driver = driver-Id
command = ISDN_STAT_RUN
arg = unused.
- num = unused.
+ para = unused.
ISDN_STAT_STOP:
@@ -518,7 +533,7 @@
driver = driver-Id
command = ISDN_STAT_STOP
arg = unused.
- num = unused.
+ para = unused.
ISDN_STAT_DCONN:
@@ -529,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:
@@ -541,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:
@@ -554,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:
@@ -566,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:
@@ -577,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)
@@ -590,7 +605,7 @@
driver = driver-Id
command = ISDN_STAT_UNLOAD
arg = unused.
- num = unused.
+ para = unused.
ISDN_STAT_BSENT:
@@ -602,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:
@@ -613,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)
@@ -627,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:
@@ -640,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