sdla_asy.h
上传用户:szlgq88
上传日期:2009-04-28
资源大小:48287k
文件大小:12k
源码类别:

嵌入式Linux

开发平台:

Unix_Linux

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