1 |
1275 |
phoenix |
/*****************************************************************************
|
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
|