isdnif.h
上传用户:lgb322
上传日期:2013-02-24
资源大小:30529k
文件大小:22k
源码类别:

嵌入式Linux

开发平台:

Unix_Linux

  1. /* $Id: isdnif.h,v 1.1.4.1 2001/11/20 14:19:38 kai Exp $
  2.  *
  3.  * Linux ISDN subsystem
  4.  * Definition of the interface between the subsystem and its low-level drivers.
  5.  *
  6.  * Copyright 1994,95,96 by Fritz Elfert (fritz@isdn4linux.de)
  7.  * Copyright 1995,96    Thinking Objects Software GmbH Wuerzburg
  8.  * 
  9.  * This software may be used and distributed according to the terms
  10.  * of the GNU General Public License, incorporated herein by reference.
  11.  *
  12.  */
  13. #ifndef __ISDNIF_H__
  14. #define __ISDNIF_H__
  15. /*
  16.  * Values for general protocol-selection
  17.  */
  18. #define ISDN_PTYPE_UNKNOWN   0   /* Protocol undefined   */
  19. #define ISDN_PTYPE_1TR6      1   /* german 1TR6-protocol */
  20. #define ISDN_PTYPE_EURO      2   /* EDSS1-protocol       */
  21. #define ISDN_PTYPE_LEASED    3   /* for leased lines     */
  22. #define ISDN_PTYPE_NI1       4   /* US NI-1 protocol     */
  23. #define ISDN_PTYPE_MAX       7   /* Max. 8 Protocols     */
  24. /*
  25.  * Values for Layer-2-protocol-selection
  26.  */
  27. #define ISDN_PROTO_L2_X75I   0   /* X75/LAPB with I-Frames            */
  28. #define ISDN_PROTO_L2_X75UI  1   /* X75/LAPB with UI-Frames           */
  29. #define ISDN_PROTO_L2_X75BUI 2   /* X75/LAPB with UI-Frames           */
  30. #define ISDN_PROTO_L2_HDLC   3   /* HDLC                              */
  31. #define ISDN_PROTO_L2_TRANS  4   /* Transparent (Voice)               */
  32. #define ISDN_PROTO_L2_X25DTE 5   /* X25/LAPB DTE mode                 */
  33. #define ISDN_PROTO_L2_X25DCE 6   /* X25/LAPB DCE mode                 */
  34. #define ISDN_PROTO_L2_V11096 7   /* V.110 bitrate adaption 9600 Baud  */
  35. #define ISDN_PROTO_L2_V11019 8   /* V.110 bitrate adaption 19200 Baud */
  36. #define ISDN_PROTO_L2_V11038 9   /* V.110 bitrate adaption 38400 Baud */
  37. #define ISDN_PROTO_L2_MODEM  10  /* Analog Modem on Board */
  38. #define ISDN_PROTO_L2_FAX    11  /* Fax Group 2/3         */
  39. #define ISDN_PROTO_L2_HDLC_56K 12   /* HDLC 56k                          */
  40. #define ISDN_PROTO_L2_MAX    15  /* Max. 16 Protocols                 */
  41. /*
  42.  * Values for Layer-3-protocol-selection
  43.  */
  44. #define ISDN_PROTO_L3_TRANS 0 /* Transparent */
  45. #define ISDN_PROTO_L3_TRANSDSP 1 /* Transparent with DSP */
  46. #define ISDN_PROTO_L3_FCLASS2 2 /* Fax Group 2/3 CLASS 2 */
  47. #define ISDN_PROTO_L3_FCLASS1 3 /* Fax Group 2/3 CLASS 1 */
  48. #define ISDN_PROTO_L3_MAX 7 /* Max. 8 Protocols */
  49. #ifdef __KERNEL__
  50. #include <linux/config.h>
  51. #include <linux/skbuff.h>
  52. /***************************************************************************/
  53. /* Extensions made by Werner Cornelius (werner@ikt.de)                     */
  54. /*                                                                         */ 
  55. /* The proceed command holds a incoming call in a state to leave processes */
  56. /* enough time to check whether ist should be accepted.                    */
  57. /* The PROT_IO Command extends the interface to make protocol dependant    */
  58. /* features available (call diversion, call waiting...).                   */
  59. /*                                                                         */ 
  60. /* The PROT_IO Command is executed with the desired driver id and the arg  */
  61. /* parameter coded as follows:                                             */
  62. /* The lower 8 bits of arg contain the desired protocol from ISDN_PTYPE    */
  63. /* definitions. The upper 24 bits represent the protocol specific cmd/stat.*/
  64. /* Any additional data is protocol and command specific.                   */
  65. /* This mechanism also applies to the statcallb callback STAT_PROT.        */    
  66. /*                                                                         */
  67. /* This suggested extension permits an easy expansion of protocol specific */
  68. /* handling. Extensions may be added at any time without changing the HL   */
  69. /* driver code and not getting conflicts without certifications.           */
  70. /* The well known CAPI 2.0 interface handles such extensions in a similar  */
  71. /* way. Perhaps a protocol specific module may be added and separately     */
  72. /* loaded and linked to the basic isdn module for handling.                */                    
  73. /***************************************************************************/
  74. /*****************/
  75. /* DSS1 commands */ 
  76. /*****************/
  77. #define DSS1_CMD_INVOKE       ((0x00 << 8) | ISDN_PTYPE_EURO)   /* invoke a supplementary service */
  78. #define DSS1_CMD_INVOKE_ABORT ((0x01 << 8) | ISDN_PTYPE_EURO)   /* abort a invoke cmd */
  79. /*******************************/
  80. /* DSS1 Status callback values */
  81. /*******************************/
  82. #define DSS1_STAT_INVOKE_RES  ((0x80 << 8) | ISDN_PTYPE_EURO)   /* Result for invocation */
  83. #define DSS1_STAT_INVOKE_ERR  ((0x81 << 8) | ISDN_PTYPE_EURO)   /* Error Return for invocation */
  84. #define DSS1_STAT_INVOKE_BRD  ((0x82 << 8) | ISDN_PTYPE_EURO)   /* Deliver invoke broadcast info */
  85. /*********************************************************************/
  86. /* structures for DSS1 commands and callback                         */
  87. /*                                                                   */
  88. /* An action is invoked by sending a DSS1_CMD_INVOKE. The ll_id, proc*/
  89. /* timeout, datalen and data fields must be set before calling.      */
  90. /*                                                                   */
  91. /* The return value is a positive hl_id value also delivered in the  */
  92. /* hl_id field. A value of zero signals no more left hl_id capacitys.*/
  93. /* A negative return value signals errors in LL. So if the return    */
  94. /* value is <= 0 no action in LL will be taken -> request ignored    */
  95. /*                                                                   */
  96. /* The timeout field must be filled with a positive value specifying */
  97. /* the amount of time the INVOKED process waits for a reaction from  */
  98. /* the network.                                                      */
  99. /* If a response (either error or result) is received during this    */
  100. /* intervall, a reporting callback is initiated and the process will */
  101. /* be deleted, the hl identifier will be freed.                      */
  102. /* If no response is received during the specified intervall, a error*/
  103. /* callback is initiated with timeout set to -1 and a datalen set    */
  104. /* to 0.                                                             */
  105. /* If timeout is set to a value <= 0 during INVOCATION the process is*/
  106. /* immediately deleted after sending the data. No callback occurs !  */
  107. /*                                                                   */
  108. /* A currently waiting process may be aborted with INVOKE_ABORT. No  */
  109. /* callback will occur when a process has been aborted.              */
  110. /*                                                                   */
  111. /* Broadcast invoke frames from the network are reported via the     */
  112. /* STAT_INVOKE_BRD callback. The ll_id is set to 0, the other fields */
  113. /* are supplied by the network and not by the HL.                    */   
  114. /*********************************************************************/
  115. /*****************/
  116. /* NI1 commands */ 
  117. /*****************/
  118. #define NI1_CMD_INVOKE       ((0x00 << 8) | ISDN_PTYPE_NI1)   /* invoke a supplementary service */
  119. #define NI1_CMD_INVOKE_ABORT ((0x01 << 8) | ISDN_PTYPE_NI1)   /* abort a invoke cmd */
  120. /*******************************/
  121. /* NI1 Status callback values */
  122. /*******************************/
  123. #define NI1_STAT_INVOKE_RES  ((0x80 << 8) | ISDN_PTYPE_NI1)   /* Result for invocation */
  124. #define NI1_STAT_INVOKE_ERR  ((0x81 << 8) | ISDN_PTYPE_NI1)   /* Error Return for invocation */
  125. #define NI1_STAT_INVOKE_BRD  ((0x82 << 8) | ISDN_PTYPE_NI1)   /* Deliver invoke broadcast info */
  126. typedef struct
  127.   { ulong ll_id; /* ID supplied by LL when executing    */
  128.  /* a command and returned by HL for    */
  129.                  /* INVOKE_RES and INVOKE_ERR           */
  130.     int hl_id;   /* ID supplied by HL when called       */
  131.                  /* for executing a cmd and delivered   */
  132.                  /* for results and errors              */
  133.                  /* must be supplied by LL when aborting*/  
  134.     int proc;    /* invoke procedure used by CMD_INVOKE */
  135.                  /* returned by callback and broadcast  */ 
  136.     int timeout; /* timeout for INVOKE CMD in ms        */
  137.                  /* -1  in stat callback when timed out */
  138.                  /* error value when error callback     */
  139.     int datalen; /* length of cmd or stat data          */
  140.     u_char *data;/* pointer to data delivered or send   */
  141.   } isdn_cmd_stat;
  142. /*
  143.  * Commands from linklevel to lowlevel
  144.  *
  145.  */
  146. #define ISDN_CMD_IOCTL    0       /* Perform ioctl                         */
  147. #define ISDN_CMD_DIAL     1       /* Dial out                              */
  148. #define ISDN_CMD_ACCEPTD  2       /* Accept an incoming call on D-Chan.    */
  149. #define ISDN_CMD_ACCEPTB  3       /* Request B-Channel connect.            */
  150. #define ISDN_CMD_HANGUP   4       /* Hangup                                */
  151. #define ISDN_CMD_CLREAZ   5       /* Clear EAZ(s) of channel               */
  152. #define ISDN_CMD_SETEAZ   6       /* Set EAZ(s) of channel                 */
  153. #define ISDN_CMD_GETEAZ   7       /* Get EAZ(s) of channel                 */
  154. #define ISDN_CMD_SETSIL   8       /* Set Service-Indicator-List of channel */
  155. #define ISDN_CMD_GETSIL   9       /* Get Service-Indicator-List of channel */
  156. #define ISDN_CMD_SETL2   10       /* Set B-Chan. Layer2-Parameter          */
  157. #define ISDN_CMD_GETL2   11       /* Get B-Chan. Layer2-Parameter          */
  158. #define ISDN_CMD_SETL3   12       /* Set B-Chan. Layer3-Parameter          */
  159. #define ISDN_CMD_GETL3   13       /* Get B-Chan. Layer3-Parameter          */
  160. #define ISDN_CMD_LOCK    14       /* Signal usage by upper levels          */
  161. #define ISDN_CMD_UNLOCK  15       /* Release usage-lock                    */
  162. #define ISDN_CMD_SUSPEND 16       /* Suspend connection                    */
  163. #define ISDN_CMD_RESUME  17       /* Resume connection                     */
  164. #define ISDN_CMD_PROCEED 18       /* Proceed with call establishment       */
  165. #define ISDN_CMD_ALERT   19       /* Alert after Proceeding                */
  166. #define ISDN_CMD_REDIR   20       /* Redir a incoming call                 */
  167. #define ISDN_CMD_PROT_IO 21       /* Protocol specific commands            */
  168. #define CAPI_PUT_MESSAGE 22       /* CAPI message send down or up          */
  169. #define ISDN_CMD_FAXCMD  23       /* FAX commands to HL-driver             */
  170. #define ISDN_CMD_AUDIO   24       /* DSP, DTMF, ... settings               */
  171. /*
  172.  * Status-Values delivered from lowlevel to linklevel via
  173.  * statcallb().
  174.  *
  175.  */
  176. #define ISDN_STAT_STAVAIL 256    /* Raw status-data available             */
  177. #define ISDN_STAT_ICALL   257    /* Incoming call detected                */
  178. #define ISDN_STAT_RUN     258    /* Signal protocol-code is running       */
  179. #define ISDN_STAT_STOP    259    /* Signal halt of protocol-code          */
  180. #define ISDN_STAT_DCONN   260    /* Signal D-Channel connect              */
  181. #define ISDN_STAT_BCONN   261    /* Signal B-Channel connect              */
  182. #define ISDN_STAT_DHUP    262    /* Signal D-Channel disconnect           */
  183. #define ISDN_STAT_BHUP    263    /* Signal B-Channel disconnect           */
  184. #define ISDN_STAT_CINF    264    /* Charge-Info                           */
  185. #define ISDN_STAT_LOAD    265    /* Signal new lowlevel-driver is loaded  */
  186. #define ISDN_STAT_UNLOAD  266    /* Signal unload of lowlevel-driver      */
  187. #define ISDN_STAT_BSENT   267    /* Signal packet sent                    */
  188. #define ISDN_STAT_NODCH   268    /* Signal no D-Channel                   */
  189. #define ISDN_STAT_ADDCH   269    /* Add more Channels                     */
  190. #define ISDN_STAT_CAUSE   270    /* Cause-Message                         */
  191. #define ISDN_STAT_ICALLW  271    /* Incoming call without B-chan waiting  */
  192. #define ISDN_STAT_REDIR   272    /* Redir result                          */
  193. #define ISDN_STAT_PROT    273    /* protocol IO specific callback         */
  194. #define ISDN_STAT_DISPLAY 274    /* deliver a received display message    */
  195. #define ISDN_STAT_L1ERR   275    /* Signal Layer-1 Error                  */
  196. #define ISDN_STAT_FAXIND  276    /* FAX indications from HL-driver        */
  197. #define ISDN_STAT_AUDIO   277    /* DTMF, DSP indications                 */
  198. #define ISDN_STAT_DISCH   278    /* Disable/Enable channel usage          */
  199. /*
  200.  * Audio commands
  201.  */
  202. #define ISDN_AUDIO_SETDD 0 /* Set DTMF detection           */
  203. #define ISDN_AUDIO_DTMF 1 /* Rx/Tx DTMF                   */
  204. /*
  205.  * Values for errcode field
  206.  */
  207. #define ISDN_STAT_L1ERR_SEND 1
  208. #define ISDN_STAT_L1ERR_RECV 2
  209. /*
  210.  * Values for feature-field of interface-struct.
  211.  */
  212. /* Layer 2 */
  213. #define ISDN_FEATURE_L2_X75I    (0x0001 << ISDN_PROTO_L2_X75I)
  214. #define ISDN_FEATURE_L2_X75UI   (0x0001 << ISDN_PROTO_L2_X75UI)
  215. #define ISDN_FEATURE_L2_X75BUI  (0x0001 << ISDN_PROTO_L2_X75BUI)
  216. #define ISDN_FEATURE_L2_HDLC    (0x0001 << ISDN_PROTO_L2_HDLC)
  217. #define ISDN_FEATURE_L2_TRANS   (0x0001 << ISDN_PROTO_L2_TRANS)
  218. #define ISDN_FEATURE_L2_X25DTE  (0x0001 << ISDN_PROTO_L2_X25DTE)
  219. #define ISDN_FEATURE_L2_X25DCE  (0x0001 << ISDN_PROTO_L2_X25DCE)
  220. #define ISDN_FEATURE_L2_V11096  (0x0001 << ISDN_PROTO_L2_V11096)
  221. #define ISDN_FEATURE_L2_V11019  (0x0001 << ISDN_PROTO_L2_V11019)
  222. #define ISDN_FEATURE_L2_V11038  (0x0001 << ISDN_PROTO_L2_V11038)
  223. #define ISDN_FEATURE_L2_MODEM   (0x0001 << ISDN_PROTO_L2_MODEM)
  224. #define ISDN_FEATURE_L2_FAX (0x0001 << ISDN_PROTO_L2_FAX)
  225. #define ISDN_FEATURE_L2_HDLC_56K (0x0001 << ISDN_PROTO_L2_HDLC_56K)
  226. #define ISDN_FEATURE_L2_MASK    (0x0FFFF) /* Max. 16 protocols */
  227. #define ISDN_FEATURE_L2_SHIFT   (0)
  228. /* Layer 3 */
  229. #define ISDN_FEATURE_L3_TRANS   (0x10000 << ISDN_PROTO_L3_TRANS)
  230. #define ISDN_FEATURE_L3_TRANSDSP (0x10000 << ISDN_PROTO_L3_TRANSDSP)
  231. #define ISDN_FEATURE_L3_FCLASS2 (0x10000 << ISDN_PROTO_L3_FCLASS2)
  232. #define ISDN_FEATURE_L3_FCLASS1 (0x10000 << ISDN_PROTO_L3_FCLASS1)
  233. #define ISDN_FEATURE_L3_MASK    (0x0FF0000) /* Max. 8 Protocols */
  234. #define ISDN_FEATURE_L3_SHIFT   (16)
  235. /* Signaling */
  236. #define ISDN_FEATURE_P_UNKNOWN  (0x1000000 << ISDN_PTYPE_UNKNOWN)
  237. #define ISDN_FEATURE_P_1TR6     (0x1000000 << ISDN_PTYPE_1TR6)
  238. #define ISDN_FEATURE_P_EURO     (0x1000000 << ISDN_PTYPE_EURO)
  239. #define ISDN_FEATURE_P_NI1      (0x1000000 << ISDN_PTYPE_NI1)
  240. #define ISDN_FEATURE_P_MASK     (0x0FF000000) /* Max. 8 Protocols */
  241. #define ISDN_FEATURE_P_SHIFT    (24)
  242. typedef struct setup_parm {
  243.     unsigned char phone[32]; /* Remote Phone-Number */
  244.     unsigned char eazmsn[32]; /* Local EAZ or MSN    */
  245.     unsigned char si1;      /* Service Indicator 1 */
  246.     unsigned char si2;      /* Service Indicator 2 */
  247.     unsigned char plan;     /* Numbering plan      */
  248.     unsigned char screen;   /* Screening info      */
  249. } setup_parm;
  250. #ifdef CONFIG_ISDN_TTY_FAX
  251. /* T.30 Fax G3 */
  252. #define FAXIDLEN 21
  253. typedef struct T30_s {
  254. /* session parameters */
  255. __u8 resolution __attribute__ ((packed));
  256. __u8 rate __attribute__ ((packed));
  257. __u8 width __attribute__ ((packed));
  258. __u8 length __attribute__ ((packed));
  259. __u8 compression __attribute__ ((packed));
  260. __u8 ecm __attribute__ ((packed));
  261. __u8 binary __attribute__ ((packed));
  262. __u8 scantime __attribute__ ((packed));
  263. __u8 id[FAXIDLEN] __attribute__ ((packed));
  264. /* additional parameters */
  265. __u8 phase __attribute__ ((packed));
  266. __u8 direction __attribute__ ((packed));
  267. __u8 code __attribute__ ((packed));
  268. __u8 badlin __attribute__ ((packed));
  269. __u8 badmul __attribute__ ((packed));
  270. __u8 bor __attribute__ ((packed));
  271. __u8 fet __attribute__ ((packed));
  272. __u8 pollid[FAXIDLEN] __attribute__ ((packed));
  273. __u8 cq __attribute__ ((packed));
  274. __u8 cr __attribute__ ((packed));
  275. __u8 ctcrty __attribute__ ((packed));
  276. __u8 minsp __attribute__ ((packed));
  277. __u8 phcto __attribute__ ((packed));
  278. __u8 rel __attribute__ ((packed));
  279. __u8 nbc __attribute__ ((packed));
  280. /* remote station parameters */
  281. __u8 r_resolution __attribute__ ((packed));
  282. __u8 r_rate __attribute__ ((packed));
  283. __u8 r_width __attribute__ ((packed));
  284. __u8 r_length __attribute__ ((packed));
  285. __u8 r_compression __attribute__ ((packed));
  286. __u8 r_ecm __attribute__ ((packed));
  287. __u8 r_binary __attribute__ ((packed));
  288. __u8 r_scantime __attribute__ ((packed));
  289. __u8 r_id[FAXIDLEN] __attribute__ ((packed));
  290. __u8 r_code __attribute__ ((packed));
  291. } T30_s;
  292. #define ISDN_TTY_FAX_CONN_IN 0
  293. #define ISDN_TTY_FAX_CONN_OUT 1
  294. #define ISDN_TTY_FAX_FCON 0
  295. #define ISDN_TTY_FAX_DIS  1
  296. #define ISDN_TTY_FAX_FTT  2
  297. #define ISDN_TTY_FAX_MCF  3
  298. #define ISDN_TTY_FAX_DCS  4
  299. #define ISDN_TTY_FAX_TRAIN_OK 5
  300. #define ISDN_TTY_FAX_EOP  6
  301. #define ISDN_TTY_FAX_EOM  7
  302. #define ISDN_TTY_FAX_MPS  8
  303. #define ISDN_TTY_FAX_DTC  9
  304. #define ISDN_TTY_FAX_RID  10
  305. #define ISDN_TTY_FAX_HNG  11
  306. #define ISDN_TTY_FAX_DT   12
  307. #define ISDN_TTY_FAX_FCON_I 13
  308. #define ISDN_TTY_FAX_DR   14
  309. #define ISDN_TTY_FAX_ET   15
  310. #define ISDN_TTY_FAX_CFR  16
  311. #define ISDN_TTY_FAX_PTS  17
  312. #define ISDN_TTY_FAX_SENT 18
  313. #define ISDN_FAX_PHASE_IDLE 0
  314. #define ISDN_FAX_PHASE_A 1
  315. #define ISDN_FAX_PHASE_B    2
  316. #define ISDN_FAX_PHASE_C    3
  317. #define ISDN_FAX_PHASE_D    4
  318. #define ISDN_FAX_PHASE_E    5
  319. #endif /* TTY_FAX */
  320. #define ISDN_FAX_CLASS1_FAE 0
  321. #define ISDN_FAX_CLASS1_FTS 1
  322. #define ISDN_FAX_CLASS1_FRS 2
  323. #define ISDN_FAX_CLASS1_FTM 3
  324. #define ISDN_FAX_CLASS1_FRM 4
  325. #define ISDN_FAX_CLASS1_FTH 5
  326. #define ISDN_FAX_CLASS1_FRH 6
  327. #define ISDN_FAX_CLASS1_CTRL 7
  328. #define ISDN_FAX_CLASS1_OK 0
  329. #define ISDN_FAX_CLASS1_CONNECT 1
  330. #define ISDN_FAX_CLASS1_NOCARR 2
  331. #define ISDN_FAX_CLASS1_ERROR 3
  332. #define ISDN_FAX_CLASS1_FCERROR 4
  333. #define ISDN_FAX_CLASS1_QUERY 5
  334. typedef struct {
  335. __u8 cmd;
  336. __u8 subcmd;
  337. __u8 para[50];
  338. } aux_s;
  339. #define AT_COMMAND 0
  340. #define AT_EQ_VALUE 1
  341. #define AT_QUERY 2
  342. #define AT_EQ_QUERY 3
  343. /* CAPI structs */
  344. /* this is compatible to the old union size */
  345. #define MAX_CAPI_PARA_LEN 50
  346. typedef struct {
  347. /* Header */
  348. __u16 Length;
  349. __u16 ApplId;
  350. __u8 Command;
  351. __u8 Subcommand;
  352. __u16 Messagenumber;
  353. /* Parameter */
  354. union {
  355. __u32 Controller;
  356. __u32 PLCI;
  357. __u32 NCCI;
  358. } adr;
  359. __u8 para[MAX_CAPI_PARA_LEN];
  360. } capi_msg;
  361. /*
  362.  * Structure for exchanging above infos
  363.  *
  364.  */
  365. typedef struct {
  366. int   driver; /* Lowlevel-Driver-ID            */
  367. int   command; /* Command or Status (see above) */
  368. ulong arg; /* Additional Data               */
  369. union {
  370. ulong errcode; /* Type of error with STAT_L1ERR */
  371. int length; /* Amount of bytes sent with STAT_BSENT */
  372. u_char num[50]; /* Additional Data */
  373. setup_parm setup;/* For SETUP msg */
  374. capi_msg cmsg; /* For CAPI like messages */
  375. char display[85];/* display message data */ 
  376. isdn_cmd_stat isdn_io; /* ISDN IO-parameter/result */
  377. aux_s aux; /* for modem commands/indications */
  378. #ifdef CONFIG_ISDN_TTY_FAX
  379. T30_s *fax; /* Pointer to ttys fax struct */
  380. #endif
  381. ulong userdata; /* User Data */
  382. } parm;
  383. } isdn_ctrl;
  384. #define dss1_io    isdn_io
  385. #define ni1_io     isdn_io
  386. /*
  387.  * The interface-struct itself (initialized at load-time of lowlevel-driver)
  388.  *
  389.  * See Documentation/isdn/INTERFACE for a description, how the communication
  390.  * between the ISDN subsystem and its drivers is done.
  391.  *
  392.  */
  393. typedef struct {
  394.   /* Number of channels supported by this driver
  395.    */
  396.   int channels;
  397.   /* 
  398.    * Maximum Size of transmit/receive-buffer this driver supports.
  399.    */
  400.   int maxbufsize;
  401.   /* Feature-Flags for this driver.
  402.    * See defines ISDN_FEATURE_... for Values
  403.    */
  404.   unsigned long features;
  405.   /*
  406.    * Needed for calculating
  407.    * dev->hard_header_len = linklayer header + hl_hdrlen;
  408.    * Drivers, not supporting sk_buff's should set this to 0.
  409.    */
  410.   unsigned short hl_hdrlen;
  411.   /*
  412.    * Receive-Callback using sk_buff's
  413.    * Parameters:
  414.    *             int                    Driver-ID
  415.    *             int                    local channel-number (0 ...)
  416.    *             struct sk_buff *skb    received Data
  417.    */
  418.   void (*rcvcallb_skb)(int, int, struct sk_buff *);
  419.   /* Status-Callback
  420.    * Parameters:
  421.    *             isdn_ctrl*
  422.    *                   driver  = Driver ID.
  423.    *                   command = One of above ISDN_STAT_... constants.
  424.    *                   arg     = depending on status-type.
  425.    *                   num     = depending on status-type.
  426.    */
  427.   int (*statcallb)(isdn_ctrl*);
  428.   /* Send command
  429.    * Parameters:
  430.    *             isdn_ctrl*
  431.    *                   driver  = Driver ID.
  432.    *                   command = One of above ISDN_CMD_... constants.
  433.    *                   arg     = depending on command.
  434.    *                   num     = depending on command.
  435.    */
  436.   int (*command)(isdn_ctrl*);
  437.   /*
  438.    * Send data using sk_buff's
  439.    * Parameters:
  440.    *             int                    driverId
  441.    *             int                    local channel-number (0...)
  442.    *             int                    Flag: Need ACK for this packet.
  443.    *             struct sk_buff *skb    Data to send
  444.    */
  445.   int (*writebuf_skb) (int, int, int, struct sk_buff *);
  446.   /* Send raw D-Channel-Commands
  447.    * Parameters:
  448.    *             u_char pointer data
  449.    *             int    length of data
  450.    *             int    Flag: 0 = Call form Kernel-Space (use memcpy,
  451.    *                              no schedule allowed) 
  452.    *                          1 = Data is in User-Space (use memcpy_fromfs,
  453.    *                              may schedule)
  454.    *             int    driverId
  455.    *             int    local channel-number (0 ...)
  456.    */
  457.   int (*writecmd)(const u_char*, int, int, int, int);
  458.   /* Read raw Status replies
  459.    *             u_char pointer data (volatile)
  460.    *             int    length of buffer
  461.    *             int    Flag: 0 = Call form Kernel-Space (use memcpy,
  462.    *                              no schedule allowed) 
  463.    *                          1 = Data is in User-Space (use memcpy_fromfs,
  464.    *                              may schedule)
  465.    *             int    driverId
  466.    *             int    local channel-number (0 ...)
  467.    */
  468.   int (*readstat)(u_char*, int, int, int, int);
  469.   char id[20];
  470. } isdn_if;
  471. /*
  472.  * Function which must be called by lowlevel-driver at loadtime with
  473.  * the following fields of above struct set:
  474.  *
  475.  * channels     Number of channels that will be supported.
  476.  * hl_hdrlen    Space to preserve in sk_buff's when sending. Drivers, not
  477.  *              supporting sk_buff's should set this to 0.
  478.  * command      Address of Command-Handler.
  479.  * features     Bitwise coded Features of this driver. (use ISDN_FEATURE_...)
  480.  * writebuf_skb Address of Skbuff-Send-Handler.
  481.  * writecmd        "    "  D-Channel  " which accepts raw D-Ch-Commands.
  482.  * readstat        "    "  D-Channel  " which delivers raw Status-Data.
  483.  *
  484.  * The linklevel-driver fills the following fields:
  485.  *
  486.  * channels      Driver-ID assigned to this driver. (Must be used on all
  487.  *               subsequent callbacks.
  488.  * rcvcallb_skb  Address of handler for received Skbuff's.
  489.  * statcallb        "    "     "    for status-changes.
  490.  *
  491.  */
  492. extern int register_isdn(isdn_if*);
  493. #include <asm/uaccess.h>
  494. #endif /* __KERNEL__ */
  495. #endif /* __ISDNIF_H__ */