cregit-Linux how code gets into the kernel

Release 4.7 include/linux/isdnif.h

Directory: include/linux
/* $Id: isdnif.h,v 1.43.2.2 2004/01/12 23:08:35 keil Exp $
 *
 * Linux ISDN subsystem
 * Definition of the interface between the subsystem and its low-level drivers.
 *
 * Copyright 1994,95,96 by Fritz Elfert (fritz@isdn4linux.de)
 * Copyright 1995,96    Thinking Objects Software GmbH Wuerzburg
 * 
 * This software may be used and distributed according to the terms
 * of the GNU General Public License, incorporated herein by reference.
 *
 */
#ifndef __ISDNIF_H__

#define __ISDNIF_H__


#include <linux/skbuff.h>
#include <uapi/linux/isdnif.h>

/***************************************************************************/
/* Extensions made by Werner Cornelius (werner@ikt.de)                     */
/*                                                                         */ 
/* The proceed command holds a incoming call in a state to leave processes */
/* enough time to check whether ist should be accepted.                    */
/* The PROT_IO Command extends the interface to make protocol dependent    */
/* features available (call diversion, call waiting...).                   */
/*                                                                         */ 
/* The PROT_IO Command is executed with the desired driver id and the arg  */
/* parameter coded as follows:                                             */
/* The lower 8 bits of arg contain the desired protocol from ISDN_PTYPE    */
/* definitions. The upper 24 bits represent the protocol specific cmd/stat.*/
/* Any additional data is protocol and command specific.                   */
/* This mechanism also applies to the statcallb callback STAT_PROT.        */    
/*                                                                         */
/* This suggested extension permits an easy expansion of protocol specific */
/* handling. Extensions may be added at any time without changing the HL   */
/* driver code and not getting conflicts without certifications.           */
/* The well known CAPI 2.0 interface handles such extensions in a similar  */
/* way. Perhaps a protocol specific module may be added and separately     */
/* loaded and linked to the basic isdn module for handling.                */                    
/***************************************************************************/

/*****************/
/* DSS1 commands */ 
/*****************/

#define DSS1_CMD_INVOKE       ((0x00 << 8) | ISDN_PTYPE_EURO)   
/* invoke a supplementary service */

#define DSS1_CMD_INVOKE_ABORT ((0x01 << 8) | ISDN_PTYPE_EURO)   
/* abort a invoke cmd */

/*******************************/
/* DSS1 Status callback values */
/*******************************/

#define DSS1_STAT_INVOKE_RES  ((0x80 << 8) | ISDN_PTYPE_EURO)   
/* Result for invocation */

#define DSS1_STAT_INVOKE_ERR  ((0x81 << 8) | ISDN_PTYPE_EURO)   
/* Error Return for invocation */

#define DSS1_STAT_INVOKE_BRD  ((0x82 << 8) | ISDN_PTYPE_EURO)   
/* Deliver invoke broadcast info */


/*********************************************************************/
/* structures for DSS1 commands and callback                         */
/*                                                                   */
/* An action is invoked by sending a DSS1_CMD_INVOKE. The ll_id, proc*/
/* timeout, datalen and data fields must be set before calling.      */
/*                                                                   */
/* The return value is a positive hl_id value also delivered in the  */
/* hl_id field. A value of zero signals no more left hl_id capacitys.*/
/* A negative return value signals errors in LL. So if the return    */
/* value is <= 0 no action in LL will be taken -> request ignored    */
/*                                                                   */
/* The timeout field must be filled with a positive value specifying */
/* the amount of time the INVOKED process waits for a reaction from  */
/* the network.                                                      */
/* If a response (either error or result) is received during this    */
/* intervall, a reporting callback is initiated and the process will */
/* be deleted, the hl identifier will be freed.                      */
/* If no response is received during the specified intervall, a error*/
/* callback is initiated with timeout set to -1 and a datalen set    */
/* to 0.                                                             */
/* If timeout is set to a value <= 0 during INVOCATION the process is*/
/* immediately deleted after sending the data. No callback occurs !  */
/*                                                                   */
/* A currently waiting process may be aborted with INVOKE_ABORT. No  */
/* callback will occur when a process has been aborted.              */
/*                                                                   */
/* Broadcast invoke frames from the network are reported via the     */
/* STAT_INVOKE_BRD callback. The ll_id is set to 0, the other fields */
/* are supplied by the network and not by the HL.                    */   
/*********************************************************************/

/*****************/
/* NI1 commands */ 
/*****************/

#define NI1_CMD_INVOKE       ((0x00 << 8) | ISDN_PTYPE_NI1)   
/* invoke a supplementary service */

#define NI1_CMD_INVOKE_ABORT ((0x01 << 8) | ISDN_PTYPE_NI1)   
/* abort a invoke cmd */

/*******************************/
/* NI1 Status callback values */
/*******************************/

#define NI1_STAT_INVOKE_RES  ((0x80 << 8) | ISDN_PTYPE_NI1)   
/* Result for invocation */

#define NI1_STAT_INVOKE_ERR  ((0x81 << 8) | ISDN_PTYPE_NI1)   
/* Error Return for invocation */

#define NI1_STAT_INVOKE_BRD  ((0x82 << 8) | ISDN_PTYPE_NI1)   
/* Deliver invoke broadcast info */

typedef struct
  
{ ulong ll_id; /* ID supplied by LL when executing    */
		 /* a command and returned by HL for    */
                 /* INVOKE_RES and INVOKE_ERR           */
    
int hl_id;   /* ID supplied by HL when called       */
                 /* for executing a cmd and delivered   */
                 /* for results and errors              */
                 /* must be supplied by LL when aborting*/  
    
int proc;    /* invoke procedure used by CMD_INVOKE */
                 /* returned by callback and broadcast  */ 
    
int timeout; /* timeout for INVOKE CMD in ms        */
                 /* -1  in stat callback when timed out */
                 /* error value when error callback     */
    
int datalen; /* length of cmd or stat data          */
    
u_char *data;/* pointer to data delivered or send   */
  } 
isdn_cmd_stat;

/*
 * Commands from linklevel to lowlevel
 *
 */

#define ISDN_CMD_IOCTL    0       
/* Perform ioctl                         */

#define ISDN_CMD_DIAL     1       
/* Dial out                              */

#define ISDN_CMD_ACCEPTD  2       
/* Accept an incoming call on D-Chan.    */

#define ISDN_CMD_ACCEPTB  3       
/* Request B-Channel connect.            */

#define ISDN_CMD_HANGUP   4       
/* Hangup                                */

#define ISDN_CMD_CLREAZ   5       
/* Clear EAZ(s) of channel               */

#define ISDN_CMD_SETEAZ   6       
/* Set EAZ(s) of channel                 */

#define ISDN_CMD_GETEAZ   7       
/* Get EAZ(s) of channel                 */

#define ISDN_CMD_SETSIL   8       
/* Set Service-Indicator-List of channel */

#define ISDN_CMD_GETSIL   9       
/* Get Service-Indicator-List of channel */

#define ISDN_CMD_SETL2   10       
/* Set B-Chan. Layer2-Parameter          */

#define ISDN_CMD_GETL2   11       
/* Get B-Chan. Layer2-Parameter          */

#define ISDN_CMD_SETL3   12       
/* Set B-Chan. Layer3-Parameter          */

#define ISDN_CMD_GETL3   13       
/* Get B-Chan. Layer3-Parameter          */
// #define ISDN_CMD_LOCK    14       /* Signal usage by upper levels          */
// #define ISDN_CMD_UNLOCK  15       /* Release usage-lock                    */

#define ISDN_CMD_SUSPEND 16       
/* Suspend connection                    */

#define ISDN_CMD_RESUME  17       
/* Resume connection                     */

#define ISDN_CMD_PROCEED 18       
/* Proceed with call establishment       */

#define ISDN_CMD_ALERT   19       
/* Alert after Proceeding                */

#define ISDN_CMD_REDIR   20       
/* Redir a incoming call                 */

#define ISDN_CMD_PROT_IO 21       
/* Protocol specific commands            */

#define CAPI_PUT_MESSAGE 22       
/* CAPI message send down or up          */

#define ISDN_CMD_FAXCMD  23       
/* FAX commands to HL-driver             */

#define ISDN_CMD_AUDIO   24       
/* DSP, DTMF, ... settings               */

/*
 * Status-Values delivered from lowlevel to linklevel via
 * statcallb().
 *
 */

#define ISDN_STAT_STAVAIL 256    
/* Raw status-data available             */

#define ISDN_STAT_ICALL   257    
/* Incoming call detected                */

#define ISDN_STAT_RUN     258    
/* Signal protocol-code is running       */

#define ISDN_STAT_STOP    259    
/* Signal halt of protocol-code          */

#define ISDN_STAT_DCONN   260    
/* Signal D-Channel connect              */

#define ISDN_STAT_BCONN   261    
/* Signal B-Channel connect              */

#define ISDN_STAT_DHUP    262    
/* Signal D-Channel disconnect           */

#define ISDN_STAT_BHUP    263    
/* Signal B-Channel disconnect           */

#define ISDN_STAT_CINF    264    
/* Charge-Info                           */

#define ISDN_STAT_LOAD    265    
/* Signal new lowlevel-driver is loaded  */

#define ISDN_STAT_UNLOAD  266    
/* Signal unload of lowlevel-driver      */

#define ISDN_STAT_BSENT   267    
/* Signal packet sent                    */

#define ISDN_STAT_NODCH   268    
/* Signal no D-Channel                   */

#define ISDN_STAT_ADDCH   269    
/* Add more Channels                     */

#define ISDN_STAT_CAUSE   270    
/* Cause-Message                         */

#define ISDN_STAT_ICALLW  271    
/* Incoming call without B-chan waiting  */

#define ISDN_STAT_REDIR   272    
/* Redir result                          */

#define ISDN_STAT_PROT    273    
/* protocol IO specific callback         */

#define ISDN_STAT_DISPLAY 274    
/* deliver a received display message    */

#define ISDN_STAT_L1ERR   275    
/* Signal Layer-1 Error                  */

#define ISDN_STAT_FAXIND  276    
/* FAX indications from HL-driver        */

#define ISDN_STAT_AUDIO   277    
/* DTMF, DSP indications                 */

#define ISDN_STAT_DISCH   278    
/* Disable/Enable channel usage          */

/*
 * Audio commands
 */

#define ISDN_AUDIO_SETDD	0	
/* Set DTMF detection           */

#define ISDN_AUDIO_DTMF		1	
/* Rx/Tx DTMF                   */

/*
 * Values for errcode field
 */

#define ISDN_STAT_L1ERR_SEND 1

#define ISDN_STAT_L1ERR_RECV 2

/*
 * Values for feature-field of interface-struct.
 */
/* Layer 2 */

#define ISDN_FEATURE_L2_X75I    (0x0001 << ISDN_PROTO_L2_X75I)

#define ISDN_FEATURE_L2_X75UI   (0x0001 << ISDN_PROTO_L2_X75UI)

#define ISDN_FEATURE_L2_X75BUI  (0x0001 << ISDN_PROTO_L2_X75BUI)

#define ISDN_FEATURE_L2_HDLC    (0x0001 << ISDN_PROTO_L2_HDLC)

#define ISDN_FEATURE_L2_TRANS   (0x0001 << ISDN_PROTO_L2_TRANS)

#define ISDN_FEATURE_L2_X25DTE  (0x0001 << ISDN_PROTO_L2_X25DTE)

#define ISDN_FEATURE_L2_X25DCE  (0x0001 << ISDN_PROTO_L2_X25DCE)

#define ISDN_FEATURE_L2_V11096  (0x0001 << ISDN_PROTO_L2_V11096)

#define ISDN_FEATURE_L2_V11019  (0x0001 << ISDN_PROTO_L2_V11019)

#define ISDN_FEATURE_L2_V11038  (0x0001 << ISDN_PROTO_L2_V11038)

#define ISDN_FEATURE_L2_MODEM   (0x0001 << ISDN_PROTO_L2_MODEM)

#define ISDN_FEATURE_L2_FAX	(0x0001 << ISDN_PROTO_L2_FAX)

#define ISDN_FEATURE_L2_HDLC_56K (0x0001 << ISDN_PROTO_L2_HDLC_56K)


#define ISDN_FEATURE_L2_MASK    (0x0FFFF) 
/* Max. 16 protocols */

#define ISDN_FEATURE_L2_SHIFT   (0)

/* Layer 3 */

#define ISDN_FEATURE_L3_TRANS   (0x10000 << ISDN_PROTO_L3_TRANS)

#define ISDN_FEATURE_L3_TRANSDSP (0x10000 << ISDN_PROTO_L3_TRANSDSP)

#define ISDN_FEATURE_L3_FCLASS2	(0x10000 << ISDN_PROTO_L3_FCLASS2)

#define ISDN_FEATURE_L3_FCLASS1	(0x10000 << ISDN_PROTO_L3_FCLASS1)


#define ISDN_FEATURE_L3_MASK    (0x0FF0000) 
/* Max. 8 Protocols */

#define ISDN_FEATURE_L3_SHIFT   (16)

/* Signaling */

#define ISDN_FEATURE_P_UNKNOWN  (0x1000000 << ISDN_PTYPE_UNKNOWN)

#define ISDN_FEATURE_P_1TR6     (0x1000000 << ISDN_PTYPE_1TR6)

#define ISDN_FEATURE_P_EURO     (0x1000000 << ISDN_PTYPE_EURO)

#define ISDN_FEATURE_P_NI1      (0x1000000 << ISDN_PTYPE_NI1)


#define ISDN_FEATURE_P_MASK     (0x0FF000000) 
/* Max. 8 Protocols */

#define ISDN_FEATURE_P_SHIFT    (24)


typedef struct setup_parm {
    
unsigned char phone[32];	/* Remote Phone-Number */
    
unsigned char eazmsn[32];	/* Local EAZ or MSN    */
    
unsigned char si1;      /* Service Indicator 1 */
    
unsigned char si2;      /* Service Indicator 2 */
    
unsigned char plan;     /* Numbering plan      */
    
unsigned char screen;   /* Screening info      */
} 
setup_parm;


#ifdef CONFIG_ISDN_TTY_FAX
/* T.30 Fax G3 */


#define FAXIDLEN 21


typedef struct T30_s {
	/* session parameters */
	
__u8 resolution;
	
__u8 rate;
	
__u8 width;
	
__u8 length;
	
__u8 compression;
	
__u8 ecm;
	
__u8 binary;
	
__u8 scantime;
	
__u8 id[FAXIDLEN];
	/* additional parameters */
	
__u8 phase;
	
__u8 direction;
	
__u8 code;
	
__u8 badlin;
	
__u8 badmul;
	
__u8 bor;
	
__u8 fet;
	
__u8 pollid[FAXIDLEN];
	
__u8 cq;
	
__u8 cr;
	
__u8 ctcrty;
	
__u8 minsp;
	
__u8 phcto;
	
__u8 rel;
	
__u8 nbc;
	/* remote station parameters */
	
__u8 r_resolution;
	
__u8 r_rate;
	
__u8 r_width;
	
__u8 r_length;
	
__u8 r_compression;
	
__u8 r_ecm;
	
__u8 r_binary;
	
__u8 r_scantime;
	
__u8 r_id[FAXIDLEN];
	
__u8 r_code;
} 
__packed T30_s;


#define ISDN_TTY_FAX_CONN_IN	0

#define ISDN_TTY_FAX_CONN_OUT	1


#define ISDN_TTY_FAX_FCON	0

#define ISDN_TTY_FAX_DIS 	1

#define ISDN_TTY_FAX_FTT 	2

#define ISDN_TTY_FAX_MCF 	3

#define ISDN_TTY_FAX_DCS 	4

#define ISDN_TTY_FAX_TRAIN_OK	5

#define ISDN_TTY_FAX_EOP 	6

#define ISDN_TTY_FAX_EOM 	7

#define ISDN_TTY_FAX_MPS 	8

#define ISDN_TTY_FAX_DTC 	9

#define ISDN_TTY_FAX_RID 	10

#define ISDN_TTY_FAX_HNG 	11

#define ISDN_TTY_FAX_DT  	12

#define ISDN_TTY_FAX_FCON_I	13

#define ISDN_TTY_FAX_DR  	14

#define ISDN_TTY_FAX_ET  	15

#define ISDN_TTY_FAX_CFR 	16

#define ISDN_TTY_FAX_PTS 	17

#define ISDN_TTY_FAX_SENT	18


#define ISDN_FAX_PHASE_IDLE	0

#define ISDN_FAX_PHASE_A	1

#define ISDN_FAX_PHASE_B   	2

#define ISDN_FAX_PHASE_C   	3

#define ISDN_FAX_PHASE_D   	4

#define ISDN_FAX_PHASE_E   	5

#endif /* TTY_FAX */


#define ISDN_FAX_CLASS1_FAE	0

#define ISDN_FAX_CLASS1_FTS	1

#define ISDN_FAX_CLASS1_FRS	2

#define ISDN_FAX_CLASS1_FTM	3

#define ISDN_FAX_CLASS1_FRM	4

#define ISDN_FAX_CLASS1_FTH	5

#define ISDN_FAX_CLASS1_FRH	6

#define ISDN_FAX_CLASS1_CTRL	7


#define ISDN_FAX_CLASS1_OK	0

#define ISDN_FAX_CLASS1_CONNECT	1

#define ISDN_FAX_CLASS1_NOCARR	2

#define ISDN_FAX_CLASS1_ERROR	3

#define ISDN_FAX_CLASS1_FCERROR	4

#define ISDN_FAX_CLASS1_QUERY	5

typedef struct {
	
__u8	cmd;
	
__u8	subcmd;
	
__u8	para[50];
} 
aux_s;


#define AT_COMMAND	0

#define AT_EQ_VALUE	1

#define AT_QUERY	2

#define AT_EQ_QUERY	3

/* CAPI structs */

/* this is compatible to the old union size */

#define MAX_CAPI_PARA_LEN 50

typedef struct {
	/* Header */
	
__u16 Length;
	
__u16 ApplId;
	
__u8 Command;
	
__u8 Subcommand;
	
__u16 Messagenumber;

	/* Parameter */
	union {
		
__u32 Controller;
		
__u32 PLCI;
		
__u32 NCCI;
	} 
adr;
	
__u8 para[MAX_CAPI_PARA_LEN];
} 
capi_msg;

/*
 * Structure for exchanging above infos
 *
 */
typedef struct {
	
int   driver;		/* Lowlevel-Driver-ID            */
	
int   command;		/* Command or Status (see above) */
	
ulong arg;		/* Additional Data               */
	union {
		
ulong errcode;	/* Type of error with STAT_L1ERR        */
		
int length;	/* Amount of bytes sent with STAT_BSENT */
		
u_char num[50];	/* Additional Data                      */
		
setup_parm setup;/* For SETUP msg                        */
		
capi_msg cmsg;	/* For CAPI like messages               */
		
char display[85];/* display message data         */ 
		
isdn_cmd_stat isdn_io; /* ISDN IO-parameter/result     */
		
aux_s aux;	/* for modem commands/indications       */
#ifdef CONFIG_ISDN_TTY_FAX
		
T30_s	*fax;	/* Pointer to ttys fax struct           */
#endif
		
ulong userdata;	/* User Data */
	} 
parm;
} 
isdn_ctrl;


#define dss1_io    isdn_io

#define ni1_io     isdn_io

/*
 * The interface-struct itself (initialized at load-time of lowlevel-driver)
 *
 * See Documentation/isdn/INTERFACE for a description, how the communication
 * between the ISDN subsystem and its drivers is done.
 *
 */
typedef struct {
  
struct module *owner;

  /* Number of channels supported by this driver
   */
  
int channels;

  /* 
   * Maximum Size of transmit/receive-buffer this driver supports.
   */
  
int maxbufsize;

  /* Feature-Flags for this driver.
   * See defines ISDN_FEATURE_... for Values
   */
  
unsigned long features;

  /*
   * Needed for calculating
   * dev->hard_header_len = linklayer header + hl_hdrlen;
   * Drivers, not supporting sk_buff's should set this to 0.
   */
  
unsigned short hl_hdrlen;

  /*
   * Receive-Callback using sk_buff's
   * Parameters:
   *             int                    Driver-ID
   *             int                    local channel-number (0 ...)
   *             struct sk_buff *skb    received Data
   */
  
void (*rcvcallb_skb)(int, int, struct sk_buff *);

  /* Status-Callback
   * Parameters:
   *             isdn_ctrl*
   *                   driver  = Driver ID.
   *                   command = One of above ISDN_STAT_... constants.
   *                   arg     = depending on status-type.
   *                   num     = depending on status-type.
   */
  
int (*statcallb)(isdn_ctrl*);

  /* Send command
   * Parameters:
   *             isdn_ctrl*
   *                   driver  = Driver ID.
   *                   command = One of above ISDN_CMD_... constants.
   *                   arg     = depending on command.
   *                   num     = depending on command.
   */
  
int (*command)(isdn_ctrl*);

  /*
   * Send data using sk_buff's
   * Parameters:
   *             int                    driverId
   *             int                    local channel-number (0...)
   *             int                    Flag: Need ACK for this packet.
   *             struct sk_buff *skb    Data to send
   */
  
int (*writebuf_skb) (int, int, int, struct sk_buff *);

  /* Send raw D-Channel-Commands
   * Parameters:
   *             u_char pointer data
   *             int    length of data
   *             int    driverId
   *             int    local channel-number (0 ...)
   */
  
int (*writecmd)(const u_char __user *, int, int, int);

  /* Read raw Status replies
   *             u_char pointer data (volatile)
   *             int    length of buffer
   *             int    driverId
   *             int    local channel-number (0 ...)
   */
  
int (*readstat)(u_char __user *, int, int, int);

  
char id[20];
} 
isdn_if;

/*
 * Function which must be called by lowlevel-driver at loadtime with
 * the following fields of above struct set:
 *
 * channels     Number of channels that will be supported.
 * hl_hdrlen    Space to preserve in sk_buff's when sending. Drivers, not
 *              supporting sk_buff's should set this to 0.
 * command      Address of Command-Handler.
 * features     Bitwise coded Features of this driver. (use ISDN_FEATURE_...)
 * writebuf_skb Address of Skbuff-Send-Handler.
 * writecmd        "    "  D-Channel  " which accepts raw D-Ch-Commands.
 * readstat        "    "  D-Channel  " which delivers raw Status-Data.
 *
 * The linklevel-driver fills the following fields:
 *
 * channels      Driver-ID assigned to this driver. (Must be used on all
 *               subsequent callbacks.
 * rcvcallb_skb  Address of handler for received Skbuff's.
 * statcallb        "    "     "    for status-changes.
 *
 */
extern int register_isdn(isdn_if*);
#include <asm/uaccess.h>

#endif /* __ISDNIF_H__ */

Overall Contributors

PersonTokensPropCommitsCommitProp
pre-gitpre-git109392.16%1155.00%
andrew mortonandrew morton685.73%15.00%
linus torvaldslinus torvalds70.59%210.00%
kai germaschewskikai germaschewski50.42%15.00%
jan blunckjan blunck40.34%15.00%
al viroal viro40.34%15.00%
david howellsdavid howells30.25%15.00%
steven colesteven cole10.08%15.00%
eric dumazeteric dumazet10.08%15.00%
Total1186100.00%20100.00%
Directory: include/linux
Information contained on this website is for historical information purposes only and does not indicate or represent copyright ownership.
{% endraw %}