3 * ===================================
4 * HARP | Host ATM Research Platform
5 * ===================================
8 * This Host ATM Research Platform ("HARP") file (the "Software") is
9 * made available by Network Computing Services, Inc. ("NetworkCS")
10 * "AS IS". NetworkCS does not provide maintenance, improvements or
11 * support of any kind.
13 * NETWORKCS MAKES NO WARRANTIES OR REPRESENTATIONS, EXPRESS OR IMPLIED,
14 * INCLUDING, BUT NOT LIMITED TO, IMPLIED WARRANTIES OF MERCHANTABILITY
15 * AND FITNESS FOR A PARTICULAR PURPOSE, AS TO ANY ELEMENT OF THE
16 * SOFTWARE OR ANY SUPPORT PROVIDED IN CONNECTION WITH THIS SOFTWARE.
17 * In no event shall NetworkCS be responsible for any damages, including
18 * but not limited to consequential damages, arising from or relating to
19 * any use of the Software or related support.
21 * Copyright 1994-1998 Network Computing Services, Inc.
23 * Copies of this Software may be made, however, the above copyright
24 * notice must be reproduced on all copies.
34 * ATM Physical and Network Interface definitions
38 #ifndef _NETATM_ATM_IF_H
39 #define _NETATM_ATM_IF_H
44 #define ATM_NIF_MTU 9180 /* Default network interface MTU */
46 #define ATM_PCR_25 59111 /* Peak Cell Rate for 25.6 Mbs */
47 #define ATM_PCR_DS3 (12*8000) /* 12 cells in 1/8000 sec */
48 #define ATM_PCR_TAXI100 227273 /* Peak Cell Rate for 100 Mbs TAXI */
49 #define ATM_PCR_TAXI140 318181 /* Peak Cell Rate for 140 Mbs TAXI */
50 #define ATM_PCR_OC3C 353207 /* Peak Cell Rate for OC3c */
51 #define ATM_PCR_OC12C 1416905 /* Peak Cell Rate for OC12c */
55 * Media Access Control (MAC) address
58 u_char ma_data[6]; /* MAC address */
60 typedef struct mac_addr Mac_addr;
64 * Adapter vendor identifiers
67 VENDOR_UNKNOWN, /* Unknown vendor */
68 VENDOR_FORE, /* FORE Systems, Inc. */
69 VENDOR_ENI, /* Efficient Networks, Inc. */
70 VENDOR_IDT, /* Integrated Device Technology, Inc. */
71 VENDOR_PROSUM, /* Prosum, Inc. */
72 VENDOR_NETGRAPH /* Netgraph device */
74 typedef enum atm_vendor Atm_vendor;
78 * Adapter vendor interface identifiers
81 VENDAPI_UNKNOWN, /* Unknown interface */
82 VENDAPI_FORE_1, /* FORE - 200 Series */
83 VENDAPI_ENI_1, /* ENI - Midway */
84 VENDAPI_IDT_1, /* IDT - NICStAR */
85 VENDAPI_IDT_2, /* IDT 77252 */
86 VENDAPI_NETGRAPH_1, /* Netgraph API v1 */
87 VENDAPI_FORE_2, /* FORE - HE Series */
89 typedef enum atm_vendapi Atm_vendapi;
93 * Adapter device model identifiers
96 DEV_UNKNOWN, /* Unknown device */
97 DEV_FORE_SBA200E, /* FORE SBA-200E */
98 DEV_FORE_SBA200, /* FORE SBA-200 */
99 DEV_FORE_PCA200E, /* FORE PCA-200E */
100 DEV_FORE_ESA200E, /* FORE ESA-200E */
101 DEV_ENI_155P, /* ENI-155p */
102 DEV_IDT_155, /* IDT NICStAR */
103 DEV_PROATM_25, /* Prosum boards based on IDT 77252 */
104 DEV_PROATM_155, /* Prosum boards based on IDT 77252 */
105 DEV_VATMPIF, /* Virtual ATM Physical IF */
106 DEV_FORE_LE25, /* ForeLE-25 */
107 DEV_FORE_LE155, /* ForeLE-155 */
108 DEV_IDT_25, /* IDT NICStAR */
109 DEV_IDTABR_25, /* IDT 77252 evaluation board */
110 DEV_IDTABR_155, /* IDT 77252 evaluation board */
111 DEV_FORE_HE155, /* ForeRunnerHE-155 */
112 DEV_FORE_HE622, /* ForeRunnerHE-622 */
114 typedef enum atm_device Atm_device;
118 * Adapter media identifiers
121 MEDIA_UNKNOWN, /* Unknown media type */
122 MEDIA_TAXI_100, /* TAXI - 100 Mbps */
123 MEDIA_TAXI_140, /* TAXI - 140 Mbps */
124 MEDIA_OC3C, /* OC-3C */
125 MEDIA_OC12C, /* OC-12C */
126 MEDIA_UTP155, /* UTP-155 */
127 MEDIA_UTP25, /* UTP-25.6 */
128 MEDIA_VIRTUAL, /* Virtual Link */
131 typedef enum atm_media Atm_media;
135 * Bus type identifiers
138 BUS_UNKNOWN, /* Unknown bus type */
139 BUS_SBUS_B16, /* SBus: 16 byte (4 word) max burst */
140 BUS_SBUS_B32, /* SBus: 32 byte (8 word) max burst */
144 BUS_VIRTUAL /* Virtual Bus */
146 typedef enum atm_bus Atm_bus;
149 #define VERSION_LEN 16 /* Length of version info string */
153 * ATM adapter configuration information structure
156 Atm_vendor ac_vendor; /* Vendor */
157 Atm_vendapi ac_vendapi; /* Vendor interface */
158 Atm_device ac_device; /* Device model */
159 Atm_media ac_media; /* Media type */
160 u_long ac_serial; /* Serial number */
161 Atm_bus ac_bustype; /* Bus type */
162 u_long ac_busslot; /* Bus slot info (bus type dependent) */
163 u_long ac_ram; /* Device ram offset */
164 u_long ac_ramsize; /* Device ram size */
165 Mac_addr ac_macaddr; /* MAC address */
166 char ac_hard_vers[VERSION_LEN]; /* Hardware version */
167 char ac_firm_vers[VERSION_LEN]; /* Firmware version */
169 typedef struct atm_config Atm_config;
177 * Common structure used to define each physical ATM device interface.
178 * This structure will (normally) be embedded at the top of each driver's
179 * device-specific interface structure.
182 struct atm_pif *pif_next; /* Next registered atm interface */
183 const char *pif_name; /* Device name */
184 short pif_unit; /* Device unit number */
185 u_char pif_flags; /* Interface flags (see below) */
186 struct sigmgr *pif_sigmgr; /* Signalling Manager for interface */
187 struct siginst *pif_siginst; /* Signalling protocol instance */
188 struct stack_defn *pif_services; /* Interface's stack services */
189 struct mac_addr pif_macaddr; /* Interface's MAC address */
190 struct atm_nif *pif_nif; /* List of network interfaces */
191 struct atm_pif *pif_grnext; /* Next atm device in group */
193 /* Exported functions */
194 int (*pif_ioctl) /* Interface ioctl handler */
195 (int, caddr_t, caddr_t);
197 /* Interface statistics */
198 u_quad_t pif_ipdus; /* PDUs received from interface */
199 u_quad_t pif_opdus; /* PDUs sent to interface */
200 u_quad_t pif_ibytes; /* Bytes received from interface */
201 u_quad_t pif_obytes; /* Bytes sent to interface */
202 u_quad_t pif_ierrors; /* Errors receiving from interface */
203 u_quad_t pif_oerrors; /* Errors sending to interface */
204 u_quad_t pif_cmderrors; /* Interface command errors */
205 caddr_t pif_cardstats; /* Card specific statistics */
207 /* Interface capabilities */
208 u_short pif_maxvpi; /* Maximum VPI value supported */
209 u_short pif_maxvci; /* Maximum VCI value supported */
210 u_int pif_pcr; /* Peak Cell Rate */
214 * Physical interface flags
216 #define PIF_UP 0x01 /* Interface is up */
217 #define PIF_LOOPBACK 0x02 /* Loopback local packets */
221 * Structure defining an ATM network interface. This structure is used as
222 * the hook between the standard BSD network layer interface mechanism and
223 * the ATM device layer. There may be one or more network interfaces for
224 * each physical ATM interface.
227 struct ifnet nif_if; /* Network interface */
228 struct atm_pif *nif_pif; /* Our physical interface */
229 char nif_name[IFNAMSIZ];/* Network interface name */
230 u_char nif_sel; /* Interface's address selector */
231 struct atm_nif *nif_pnext; /* Next net interface on phys i/f */
233 /* Interface statistics (in addition to ifnet stats) */
234 long nif_ibytes; /* Bytes received from interface */
235 long nif_obytes; /* Bytes sent to interface */
240 * Common Device VCC Entry
242 * Contains the common information for each VCC which is opened
243 * through a particular device.
246 struct cmn_vcc *cv_next; /* Next in list */
247 void *cv_toku; /* Upper layer's token */
248 void (*cv_upper) /* Upper layer's interface */
249 (int, void *, intptr_t, intptr_t);
250 Atm_connvc *cv_connvc; /* Associated connection VCC */
251 u_char cv_state; /* VCC state (see below) */
252 u_char cv_flags; /* VCC flags (see below) */
254 typedef struct cmn_vcc Cmn_vcc;
259 #define CVS_FREE 0 /* Not allocated */
260 #define CVS_INST 1 /* Instantiated, waiting for INIT */
261 #define CVS_INITED 2 /* Initialized, waiting for driver */
262 #define CVS_ACTIVE 3 /* Device activated by driver */
263 #define CVS_PTERM 4 /* Waiting for TERM */
264 #define CVS_TERM 5 /* Terminated */
269 #define CVF_RSVD 0x0f /* Reserved for device-specific use */
273 * Common Device Unit Structure
275 * Contains the common information for a single device (adapter).
278 struct atm_pif cu_pif; /* Physical interface */
279 u_int cu_unit; /* Local unit number */
280 u_char cu_flags; /* Device flags (see below) */
281 u_int cu_mtu; /* Interface MTU */
283 u_int cu_open_vcc; /* Open VCC count */
284 Cmn_vcc *cu_vcc; /* List of VCC's on interface */
286 u_int cu_intrpri; /* Highest unit interrupt priority */
287 int cu_savepri; /* Saved priority for locking device */
289 uma_zone_t cu_vcc_zone; /* Device VCC zone */
290 uma_zone_t cu_nif_zone; /* Device NIF zone */
292 int (*cu_ioctl) /* Interface ioctl handler */
293 (int, caddr_t, caddr_t);
294 int (*cu_instvcc) /* VCC stack instantion handler */
295 (struct cmn_unit *, Cmn_vcc *);
296 int (*cu_openvcc) /* Open VCC handler */
297 (struct cmn_unit *, Cmn_vcc *);
298 int (*cu_closevcc) /* Close VCC handler */
299 (struct cmn_unit *, Cmn_vcc *);
300 void (*cu_output) /* Data output handler */
301 (struct cmn_unit *, Cmn_vcc *, KBuffer *);
303 Atm_config cu_config; /* Device configuration data */
305 void * cu_softc; /* pointer to driver state */
307 typedef struct cmn_unit Cmn_unit;
312 #define CUF_REGISTER 0x01 /* Device is registered */
313 #define CUF_INITED 0x02 /* Device is initialized */
317 * Structure used to define a network convergence module and its associated
318 * entry points. A convergence module is used to provide the interface
319 * translations necessary between the ATM system and the BSD network layer
320 * interface mechanism. There will be one network convergence module for
321 * each protocol address family supporting ATM connections.
324 struct atm_ncm *ncm_next; /* Next in registry list */
325 u_short ncm_family; /* Protocol family */
326 /* Exported functions */
327 int (*ncm_ifoutput) /* Interface if_output handler */
328 (struct ifnet *, KBuffer *, struct sockaddr *);
329 int (*ncm_stat) /* Network i/f status handler */
330 (int, struct atm_nif *, intptr_t);
334 * ncm_stat() commands
336 #define NCM_ATTACH 1 /* Attaching a new net i/f */
337 #define NCM_DETACH 2 /* Detaching a current net i/f */
338 #define NCM_SETADDR 3 /* Net i/f address change */
339 #define NCM_SIGATTACH 4 /* Attaching a signalling manager */
340 #define NCM_SIGDETACH 5 /* Detaching a signalling manager */
344 * atm_dev_alloc() parameters
346 #define ATM_DEV_NONCACHE 1 /* Allocate non-cacheable memory */
349 * atm_dev_compress() buffer allocation sizes
351 #define ATM_DEV_CMPR_LG MCLBYTES /* Size of large buffers */
352 #define ATM_DEV_CMPR_SM MLEN /* Size of small buffers */
355 * Macros to lock out device interrupts
357 #define DEVICE_LOCK(u) ((u)->cu_savepri = splimp())
358 #define DEVICE_UNLOCK(u) ((void) splx((u)->cu_savepri))
361 * Macro to schedule the ATM interrupt queue handler
363 typedef void (atm_intr_t)(void *, KBuffer *); /* Callback function type */
364 typedef atm_intr_t *atm_intr_func_t; /* Pointer to callback function */
368 #endif /* _NETATM_ATM_IF_H */