Subversion Repositories shark

Rev

Rev 422 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
422 giacomo 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