include/linux/sdla_asy.h

   1 /*****************************************************************************
   2 * sdla_asy.h    Header file for the Sangoma S508/S514 asynchronous code API
   3 *
   4 * Author:       Gideon Hack
   5 *
   6 * Copyright:    (c) 2000 Sangoma Technologies Inc.
   7 *
   8 *               This program is free software; you can redistribute it and/or
   9 *               modify it under the terms of the GNU General Public License
  10 *               as published by the Free Software Foundation; either version
  11 *               2 of the License, or (at your option) any later version.
  12 * ============================================================================
  13 *
  14 * Jan 28, 2000  Gideon Hack     Initial Version
  15 *
  16 *****************************************************************************/
  17
  18
  19 #ifndef _WANPIPE_ASYNC_H
  20 #define _WANPIPE_ASYNC_H
  21
  22 /* ----------------------------------------------------------------------------
  23  *                        Interface commands
  24  * --------------------------------------------------------------------------*/
  25
  26 #define SET_ASY_CONFIGURATION           0xE2    /* set the asychronous operational configuration */
  27 #define READ_ASY_CONFIGURATION          0xE3    /* read the current asychronous operational configuration */
  28 #define ENABLE_ASY_COMMUNICATIONS       0xE4    /* enable asychronous communications */
  29 #define DISABLE_ASY_COMMUNICATIONS      0xE5    /* disable asychronous communications */
  30 #define READ_ASY_OPERATIONAL_STATS      0xE7    /* retrieve the asychronous operational statistics */
  31 #define FLUSH_ASY_OPERATIONAL_STATS     0xE8    /* flush the asychronous operational statistics */
  32 #define TRANSMIT_ASY_BREAK_SIGNAL       0xEC    /* transmit an asychronous break signal */
  33
  34
  35
  36 /* ----------------------------------------------------------------------------
  37  *                     Return codes from interface commands
  38  * --------------------------------------------------------------------------*/
  39
  40 #define COMMAND_INVALID_FOR_PORT        0x50    /* the command is invalid for the selected port */
  41 #define DISABLE_ASY_COMMS_BEFORE_CFG    0xE1    /* communications must be disabled before setting the configuration */
  42 #define ASY_COMMS_ENABLED               0xE1    /* communications are currently enabled */
  43 #define ASY_COMMS_DISABLED              0xE1    /* communications are currently disabled */
  44 #define ASY_CFG_BEFORE_COMMS_ENABLED    0xE2    /* perform a SET_ASY_CONFIGURATION before enabling comms */
  45 #define LGTH_ASY_CFG_DATA_INVALID       0xE2    /* the length of the passed configuration data is invalid */
  46 #define INVALID_ASY_CFG_DATA            0xE3    /* the passed configuration data is invalid */
  47 #define ASY_BREAK_SIGNAL_BUSY           0xEC    /* a break signal is being transmitted */
  48
  49
  50
  51 /* ----------------------------------------------------------------------------
  52  *   Constants for the SET_ASY_CONFIGURATION/READ_ASY_CONFIGURATION command
  53  * --------------------------------------------------------------------------*/
  54
  55 /* the asynchronous configuration structure */
  56 typedef struct {
  57         unsigned long baud_rate                 PACKED;                                                 /* the baud rate */
  58         unsigned short line_config_options      PACKED; /* line configuration options */
  59         unsigned short modem_config_options     PACKED; /* modem configuration options */
  60         unsigned short asy_API_options          PACKED; /* asynchronous API options */
  61         unsigned short asy_protocol_options     PACKED; /* asynchronous protocol options */
  62         unsigned short Tx_bits_per_char         PACKED; /* number of bits per tx character */
  63         unsigned short Rx_bits_per_char         PACKED; /* number of bits per received character */
  64         unsigned short stop_bits                PACKED; /* number of stop bits per character */
  65         unsigned short parity                   PACKED; /* parity definition */
  66         unsigned short break_timer              PACKED; /* the break signal timer */
  67         unsigned short asy_Rx_inter_char_timer  PACKED; /* the receive inter-character timer */
  68         unsigned short asy_Rx_complete_length   PACKED; /* the receive 'buffer complete' length */
  69         unsigned short XON_char                 PACKED; /* the XON character */
  70         unsigned short XOFF_char                PACKED; /* the XOFF character */
  71         unsigned short asy_statistics_options   PACKED; /* async operational stat options */
  72         unsigned long ptr_shared_mem_info_struct    PACKED;/* ptr to the shared memory area information structure */
  73         unsigned long ptr_asy_Tx_stat_el_cfg_struct PACKED;/* ptr to the transmit status element configuration structure */
  74         unsigned long ptr_asy_Rx_stat_el_cfg_struct PACKED;/* ptr to the receive status element configuration structure */
  75 } ASY_CONFIGURATION_STRUCT;
  76
  77 /* permitted minimum and maximum values for setting the asynchronous configuration */
  78 #define MIN_ASY_BAUD_RATE               50      /* maximum baud rate */
  79 #define MAX_ASY_BAUD_RATE               250000  /* minimum baud rate */
  80 #define MIN_ASY_BITS_PER_CHAR           5       /* minimum number of bits per character */
  81 #define MAX_ASY_BITS_PER_CHAR           8       /* maximum number of bits per character */
  82 #define MIN_BREAK_TMR_VAL               0       /* minimum break signal timer */
  83 #define MAX_BREAK_TMR_VAL               5000    /* maximum break signal timer */
  84 #define MIN_ASY_RX_INTER_CHAR_TMR       0       /* minimum receive inter-character timer */
  85 #define MAX_ASY_RX_INTER_CHAR_TMR       30000   /* maximum receive inter-character timer */
  86 #define MIN_ASY_RX_CPLT_LENGTH          0       /* minimum receive 'length complete' value */
  87 #define MAX_ASY_RX_CPLT_LENGTH          2000    /* maximum receive 'length complete' value */
  88
  89 /* bit settings for the 'asy_API_options' */
  90 #define ASY_RX_DATA_TRANSPARENT         0x0001  /* do not strip parity and unused bits from received characters */
  91
  92 /* bit settings for the 'asy_protocol_options' */
  93 #define ASY_RTS_HS_FOR_RX               0x0001  /* RTS handshaking is used for reception control */
  94 #define ASY_XON_XOFF_HS_FOR_RX          0x0002  /* XON/XOFF handshaking is used for reception control */
  95 #define ASY_XON_XOFF_HS_FOR_TX          0x0004  /* XON/XOFF handshaking is used for transmission control */
  96 #define ASY_DCD_HS_FOR_TX               0x0008  /* DCD handshaking is used for transmission control */
  97 #define ASY_CTS_HS_FOR_TX               0x0020  /* CTS handshaking is used for transmission control */
  98
  99 /* bit settings for the 'stop_bits' definition */
 100 #define ONE_STOP_BIT                    1                       /* representation for 1 stop bit */
 101 #define TWO_STOP_BITS                   2                       /* representation for 2 stop bits */
 102 #define ONE_AND_A_HALF_STOP_BITS        3                       /* representation for 1.5 stop bits */
 103
 104 /* bit settings for the 'parity' definition */
 105 #define NO_PARITY                       0                       /* representation for no parity */
 106 #define ODD_PARITY                      1                       /* representation for odd parity */
 107 #define EVEN_PARITY                     2                       /* representation for even parity */
 108
 109
 110
 111 /* ----------------------------------------------------------------------------
 112  *    Constants for the READ_COMMS_ERROR_STATS command (asynchronous mode)
 113  * --------------------------------------------------------------------------*/
 114
 115 /* the communications error statistics structure */
 116 typedef struct {
 117         unsigned short Rx_overrun_err_count     PACKED; /* receiver overrun error count */
 118         unsigned short Rx_parity_err_count      PACKED; /* parity errors received count */
 119         unsigned short Rx_framing_err_count     PACKED; /* framing errors received count */
 120         unsigned short comms_err_stat_reserved_1 PACKED;/* reserved for later use */
 121         unsigned short comms_err_stat_reserved_2 PACKED;/* reserved for later use */
 122         unsigned short comms_err_stat_reserved_3 PACKED;/* reserved for later use */
 123         unsigned short comms_err_stat_reserved_4 PACKED;/* reserved for later use */
 124         unsigned short comms_err_stat_reserved_5 PACKED;/* reserved for later use */
 125         unsigned short DCD_state_change_count   PACKED; /* DCD state change count */
 126         unsigned short CTS_state_change_count   PACKED; /* CTS state change count */
 127 } ASY_COMMS_ERROR_STATS_STRUCT;
 128
 129
 130
 131 /* ----------------------------------------------------------------------------
 132  *         Constants for the READ_ASY_OPERATIONAL_STATS command
 133  * --------------------------------------------------------------------------*/
 134
 135 /* the asynchronous operational statistics structure */
 136 typedef struct {
 137
 138         /* Data transmission statistics */
 139         unsigned long Data_blocks_Tx_count PACKED;/* number of blocks transmitted */
 140         unsigned long Data_bytes_Tx_count  PACKED;/* number of bytes transmitted */
 141         unsigned long Data_Tx_throughput   PACKED;/* transmit throughput */
 142         unsigned long no_ms_for_Data_Tx_thruput_comp PACKED;/* millisecond time used for the Tx throughput computation */
 143         unsigned long Tx_Data_discard_lgth_err_count PACKED;/* number of Data blocks discarded (length error) */
 144         unsigned long reserved_Data_frm_Tx_stat1 PACKED;/* reserved for later use */
 145         unsigned long reserved_Data_frm_Tx_stat2 PACKED;/* reserved for later use */
 146         unsigned long reserved_Data_frm_Tx_stat3 PACKED;/* reserved for later use */
 147
 148         /* Data reception statistics */
 149         unsigned long Data_blocks_Rx_count PACKED;/* number of blocks received */
 150         unsigned long Data_bytes_Rx_count  PACKED;/* number of bytes received */
 151         unsigned long Data_Rx_throughput   PACKED;/* receive throughput */
 152         unsigned long no_ms_for_Data_Rx_thruput_comp PACKED;/* millisecond time used for the Rx throughput computation */
 153         unsigned long Rx_Data_bytes_discard_count    PACKED;/* received Data bytes discarded */
 154         unsigned long reserved_Data_frm_Rx_stat1     PACKED;/* reserved for later use */
 155
 156         /* handshaking protocol statistics */
 157         unsigned short XON_chars_Tx_count       PACKED; /* number of XON characters transmitted */
 158         unsigned short XOFF_chars_Tx_count      PACKED; /* number of XOFF characters transmitted */
 159         unsigned short XON_chars_Rx_count       PACKED; /* number of XON characters received */
 160         unsigned short XOFF_chars_Rx_count      PACKED; /* number of XOFF characters received */
 161         unsigned short Tx_halt_modem_low_count  PACKED; /* number of times Tx halted (modem line low) */
 162         unsigned short Rx_halt_RTS_low_count    PACKED; /* number of times Rx halted by setting RTS low */
 163         unsigned long reserved_handshaking_stat1 PACKED;/* reserved for later use */
 164
 165         /* break statistics */
 166         unsigned short break_Tx_count   PACKED; /* number of break sequences transmitted */
 167         unsigned short break_Rx_count   PACKED; /* number of break sequences received */
 168         unsigned long reserved_break_stat1 PACKED;/* reserved for later use */
 169
 170         /* miscellaneous statistics */
 171         unsigned long reserved_misc_stat1       PACKED; /* reserved for later use */
 172         unsigned long reserved_misc_stat2       PACKED; /* reserved for later use */
 173
 174 } ASY_OPERATIONAL_STATS_STRUCT;
 175
 176
 177
 178 /* ----------------------------------------------------------------------------
 179  *                      Constants for Data transmission
 180  * --------------------------------------------------------------------------*/
 181
 182 /* the Data block transmit status element configuration structure */
 183 typedef struct {
 184         unsigned short number_Tx_status_elements PACKED;                /* number of transmit status elements */
 185         unsigned long base_addr_Tx_status_elements PACKED;      /* base address of the transmit element list */
 186         unsigned long next_Tx_status_element_to_use PACKED;     /* pointer to the next transmit element to be used */
 187 } ASY_TX_STATUS_EL_CFG_STRUCT;
 188
 189
 190 /* the Data block transmit status element structure */
 191 typedef struct {
 192         unsigned char opp_flag PACKED;                                                          /* opp flag */
 193         unsigned short data_length PACKED;                                              /* length of the block to be transmitted */
 194         unsigned char reserved_1 PACKED;                                                        /* reserved for internal use */
 195         unsigned long reserved_2 PACKED;                                                        /* reserved for internal use */
 196         unsigned long reserved_3 PACKED;                                                        /* reserved for internal use */
 197         unsigned long ptr_data_bfr PACKED;                                              /* pointer to the data area */
 198 } ASY_DATA_TX_STATUS_EL_STRUCT;
 199
 200
 201
 202 /* ----------------------------------------------------------------------------
 203  *                      Constants for Data reception
 204  * --------------------------------------------------------------------------*/
 205
 206 /* the Data block receive status element configuration structure */
 207 typedef struct {
 208         unsigned short number_Rx_status_elements    PACKED;/* number of receive status elements */
 209         unsigned long base_addr_Rx_status_elements  PACKED;/* base address of the receive element list */
 210         unsigned long next_Rx_status_element_to_use PACKED;/* pointer to the next receive element to be used */
 211         unsigned long base_addr_Rx_buffer       PACKED;/* base address of the receive data buffer */
 212         unsigned long end_addr_Rx_buffer        PACKED;/* end address of the receive data buffer */
 213 } ASY_RX_STATUS_EL_CFG_STRUCT;
 214
 215 /* the Data block receive status element structure */
 216 typedef struct {
 217         unsigned char opp_flag          PACKED; /* opp flag */
 218         unsigned short data_length      PACKED; /* length of the received data block */
 219         unsigned char reserved_1        PACKED; /* reserved for internal use */
 220         unsigned short time_stamp       PACKED; /* receive time stamp (HDLC_STREAMING_MODE) */
 221         unsigned short data_buffered    PACKED; /* the number of data bytes still buffered */
 222         unsigned long reserved_2        PACKED; /* reserved for internal use */
 223         unsigned long ptr_data_bfr      PACKED; /* pointer to the data area */
 224 } ASY_DATA_RX_STATUS_EL_STRUCT;
 225
 226 #endif