1 /****************************************************************************** 2 * 3 * (C)Copyright 1998,1999 SysKonnect, 4 * a business unit of Schneider & Koch & Co. Datensysteme GmbH. 5 * 6 * This program is free software; you can redistribute it and/or modify 7 * it under the terms of the GNU General Public License as published by 8 * the Free Software Foundation; either version 2 of the License, or 9 * (at your option) any later version. 10 * 11 * The information in this file is provided "AS IS" without warranty. 12 * 13 ******************************************************************************/ 14 15 #ifndef _HWM_ 16 #define _HWM_ 17 18 #include "mbuf.h" 19 20 /* 21 * MACRO for DMA synchronization: 22 * The descriptor 'desc' is flushed for the device 'flag'. 23 * Devices are the CPU (DDI_DMA_SYNC_FORCPU) and the 24 * adapter (DDI_DMA_SYNC_FORDEV). 25 * 26 * 'desc' Pointer to a Rx or Tx descriptor. 27 * 'flag' Flag for direction (view for CPU or DEVICE) that 28 * should be synchronized. 29 * 30 * Empty macros and defines are specified here. The real macro 31 * is os-specific and should be defined in osdef1st.h. 32 */ 33 #ifndef DRV_BUF_FLUSH 34 #define DRV_BUF_FLUSH(desc,flag) 35 #define DDI_DMA_SYNC_FORCPU 36 #define DDI_DMA_SYNC_FORDEV 37 #endif 38 39 /* 40 * hardware modul dependent receive modes 41 */ 42 #define RX_ENABLE_PASS_SMT 21 43 #define RX_DISABLE_PASS_SMT 22 44 #define RX_ENABLE_PASS_NSA 23 45 #define RX_DISABLE_PASS_NSA 24 46 #define RX_ENABLE_PASS_DB 25 47 #define RX_DISABLE_PASS_DB 26 48 #define RX_DISABLE_PASS_ALL 27 49 #define RX_DISABLE_LLC_PROMISC 28 50 #define RX_ENABLE_LLC_PROMISC 29 51 52 53 #ifndef DMA_RD 54 #define DMA_RD 1 /* memory -> hw */ 55 #endif 56 #ifndef DMA_WR 57 #define DMA_WR 2 /* hw -> memory */ 58 #endif 59 #define SMT_BUF 0x80 60 61 /* 62 * bits of the frame status byte 63 */ 64 #define EN_IRQ_EOF 0x02 /* get IRQ after end of frame transmission */ 65 #define LOC_TX 0x04 /* send frame to the local SMT */ 66 #define LAST_FRAG 0x08 /* last TxD of the frame */ 67 #define FIRST_FRAG 0x10 /* first TxD of the frame */ 68 #define LAN_TX 0x20 /* send frame to network if set */ 69 #define RING_DOWN 0x40 /* error: unable to send, ring down */ 70 #define OUT_OF_TXD 0x80 /* error: not enough TxDs available */ 71 72 73 #ifndef NULL 74 #define NULL 0 75 #endif 76 77 #define C_INDIC (1L<<25) 78 #define A_INDIC (1L<<26) 79 #define RD_FS_LOCAL 0x80 80 81 /* 82 * DEBUG FLAGS 83 */ 84 #define DEBUG_SMTF 1 85 #define DEBUG_SMT 2 86 #define DEBUG_ECM 3 87 #define DEBUG_RMT 4 88 #define DEBUG_CFM 5 89 #define DEBUG_PCM 6 90 #define DEBUG_SBA 7 91 #define DEBUG_ESS 8 92 93 #define DB_HWM_RX 10 94 #define DB_HWM_TX 11 95 #define DB_HWM_GEN 12 96 97 struct s_mbuf_pool { 98 #ifndef MB_OUTSIDE_SMC 99 SMbuf mb[MAX_MBUF] ; /* mbuf pool */ 100 #endif 101 SMbuf *mb_start ; /* points to the first mb */ 102 SMbuf *mb_free ; /* free queue */ 103 } ; 104 105 struct hwm_r { 106 /* 107 * hardware modul specific receive variables 108 */ 109 u_int len ; /* length of the whole frame */ 110 char *mb_pos ; /* SMbuf receive position */ 111 } ; 112 113 struct hw_modul { 114 /* 115 * All hardware modul specific variables 116 */ 117 struct s_mbuf_pool mbuf_pool ; 118 struct hwm_r r ; 119 120 union s_fp_descr volatile *descr_p ; /* points to the desriptor area */ 121 122 u_short pass_SMT ; /* pass SMT frames */ 123 u_short pass_NSA ; /* pass all NSA frames */ 124 u_short pass_DB ; /* pass Direct Beacon Frames */ 125 u_short pass_llc_promisc ; /* pass all llc frames (default ON) */ 126 127 SMbuf *llc_rx_pipe ; /* points to the first queued llc fr */ 128 SMbuf *llc_rx_tail ; /* points to the last queued llc fr */ 129 int queued_rx_frames ; /* number of queued frames */ 130 131 SMbuf *txd_tx_pipe ; /* points to first mb in the txd ring */ 132 SMbuf *txd_tx_tail ; /* points to last mb in the txd ring */ 133 int queued_txd_mb ; /* number of SMT MBufs in txd ring */ 134 135 int rx_break ; /* rev. was breaked because ind. off */ 136 int leave_isr ; /* leave fddi_isr immedeately if set */ 137 int isr_flag ; /* set, when HWM is entered from isr */ 138 /* 139 * variables for the current transmit frame 140 */ 141 struct s_smt_tx_queue *tx_p ; /* pointer to the transmit queue */ 142 u_long tx_descr ; /* tx descriptor for FORMAC+ */ 143 int tx_len ; /* tx frame length */ 144 SMbuf *tx_mb ; /* SMT tx MBuf pointer */ 145 char *tx_data ; /* data pointer to the SMT tx Mbuf */ 146 147 int detec_count ; /* counter for out of RxD condition */ 148 u_long rx_len_error ; /* rx len FORMAC != sum of fragments */ 149 } ; 150 151 152 /* 153 * DEBUG structs and macros 154 */ 155 156 #ifdef DEBUG 157 struct os_debug { 158 int hwm_rx ; 159 int hwm_tx ; 160 int hwm_gen ; 161 } ; 162 #endif 163 164 #ifdef DEBUG 165 #ifdef DEBUG_BRD 166 #define DB_P smc->debug 167 #else 168 #define DB_P debug 169 #endif 170 171 #define DB_RX(a,b,c,lev) if (DB_P.d_os.hwm_rx >= (lev)) printf(a,b,c) 172 #define DB_TX(a,b,c,lev) if (DB_P.d_os.hwm_tx >= (lev)) printf(a,b,c) 173 #define DB_GEN(a,b,c,lev) if (DB_P.d_os.hwm_gen >= (lev)) printf(a,b,c) 174 #else /* DEBUG */ 175 #define DB_RX(a,b,c,lev) 176 #define DB_TX(a,b,c,lev) 177 #define DB_GEN(a,b,c,lev) 178 #endif /* DEBUG */ 179 180 #ifndef SK_BREAK 181 #define SK_BREAK() 182 #endif 183 184 185 /* 186 * HWM Macros 187 */ 188 189 /* 190 * BEGIN_MANUAL_ENTRY(HWM_GET_TX_PHYS) 191 * u_long HWM_GET_TX_PHYS(txd) 192 * 193 * function MACRO (hardware module, hwmtm.h) 194 * This macro may be invoked by the OS-specific module to read 195 * the physical address of the specified TxD. 196 * 197 * para txd pointer to the TxD 198 * 199 * END_MANUAL_ENTRY 200 */ 201 #define HWM_GET_TX_PHYS(txd) (u_long)AIX_REVERSE((txd)->txd_tbadr) 202 203 /* 204 * BEGIN_MANUAL_ENTRY(HWM_GET_TX_LEN) 205 * int HWM_GET_TX_LEN(txd) 206 * 207 * function MACRO (hardware module, hwmtm.h) 208 * This macro may be invoked by the OS-specific module to read 209 * the fragment length of the specified TxD 210 * 211 * para rxd pointer to the TxD 212 * 213 * return the length of the fragment in bytes 214 * 215 * END_MANUAL_ENTRY 216 */ 217 #define HWM_GET_TX_LEN(txd) ((int)AIX_REVERSE((txd)->txd_tbctrl)& RD_LENGTH) 218 219 /* 220 * BEGIN_MANUAL_ENTRY(HWM_GET_TX_USED) 221 * txd *HWM_GET_TX_USED(smc,queue) 222 * 223 * function MACRO (hardware module, hwmtm.h) 224 * This macro may be invoked by the OS-specific module to get the 225 * number of used TxDs for the queue, specified by the index. 226 * 227 * para queue the number of the send queue: Can be specified by 228 * QUEUE_A0, QUEUE_S or (frame_status & QUEUE_A0) 229 * 230 * return number of used TxDs for this send queue 231 * 232 * END_MANUAL_ENTRY 233 */ 234 #define HWM_GET_TX_USED(smc,queue) (int) (smc)->hw.fp.tx_q[queue].tx_used 235 236 /* 237 * BEGIN_MANUAL_ENTRY(HWM_GET_CURR_TXD) 238 * txd *HWM_GET_CURR_TXD(smc,queue) 239 * 240 * function MACRO (hardware module, hwmtm.h) 241 * This macro may be invoked by the OS-specific module to get the 242 * pointer to the TxD which points to the current queue put 243 * position. 244 * 245 * para queue the number of the send queue: Can be specified by 246 * QUEUE_A0, QUEUE_S or (frame_status & QUEUE_A0) 247 * 248 * return pointer to the current TxD 249 * 250 * END_MANUAL_ENTRY 251 */ 252 #define HWM_GET_CURR_TXD(smc,queue) (struct s_smt_fp_txd volatile *)\ 253 (smc)->hw.fp.tx_q[queue].tx_curr_put 254 255 /* 256 * BEGIN_MANUAL_ENTRY(HWM_GET_RX_FRAG_LEN) 257 * int HWM_GET_RX_FRAG_LEN(rxd) 258 * 259 * function MACRO (hardware module, hwmtm.h) 260 * This macro may be invoked by the OS-specific module to read 261 * the fragment length of the specified RxD 262 * 263 * para rxd pointer to the RxD 264 * 265 * return the length of the fragment in bytes 266 * 267 * END_MANUAL_ENTRY 268 */ 269 #define HWM_GET_RX_FRAG_LEN(rxd) ((int)AIX_REVERSE((rxd)->rxd_rbctrl)& \ 270 RD_LENGTH) 271 272 /* 273 * BEGIN_MANUAL_ENTRY(HWM_GET_RX_PHYS) 274 * u_long HWM_GET_RX_PHYS(rxd) 275 * 276 * function MACRO (hardware module, hwmtm.h) 277 * This macro may be invoked by the OS-specific module to read 278 * the physical address of the specified RxD. 279 * 280 * para rxd pointer to the RxD 281 * 282 * return the RxD's physical pointer to the data fragment 283 * 284 * END_MANUAL_ENTRY 285 */ 286 #define HWM_GET_RX_PHYS(rxd) (u_long)AIX_REVERSE((rxd)->rxd_rbadr) 287 288 /* 289 * BEGIN_MANUAL_ENTRY(HWM_GET_RX_USED) 290 * int HWM_GET_RX_USED(smc) 291 * 292 * function MACRO (hardware module, hwmtm.h) 293 * This macro may be invoked by the OS-specific module to get 294 * the count of used RXDs in receive queue 1. 295 * 296 * return the used RXD count of receive queue 1 297 * 298 * NOTE: Remember, because of an ASIC bug at least one RXD should be unused 299 * in the descriptor ring ! 300 * 301 * END_MANUAL_ENTRY 302 */ 303 #define HWM_GET_RX_USED(smc) ((int)(smc)->hw.fp.rx_q[QUEUE_R1].rx_used) 304 305 /* 306 * BEGIN_MANUAL_ENTRY(HWM_GET_RX_FREE) 307 * int HWM_GET_RX_FREE(smc) 308 * 309 * function MACRO (hardware module, hwmtm.h) 310 * This macro may be invoked by the OS-specific module to get 311 * the rxd_free count of receive queue 1. 312 * 313 * return the rxd_free count of receive queue 1 314 * 315 * END_MANUAL_ENTRY 316 */ 317 #define HWM_GET_RX_FREE(smc) ((int)(smc)->hw.fp.rx_q[QUEUE_R1].rx_free-1) 318 319 /* 320 * BEGIN_MANUAL_ENTRY(HWM_GET_CURR_RXD) 321 * rxd *HWM_GET_CURR_RXD(smc) 322 * 323 * function MACRO (hardware module, hwmtm.h) 324 * This macro may be invoked by the OS-specific module to get the 325 * pointer to the RxD which points to the current queue put 326 * position. 327 * 328 * return pointer to the current RxD 329 * 330 * END_MANUAL_ENTRY 331 */ 332 #define HWM_GET_CURR_RXD(smc) (struct s_smt_fp_rxd volatile *)\ 333 (smc)->hw.fp.rx_q[QUEUE_R1].rx_curr_put 334 335 /* 336 * BEGIN_MANUAL_ENTRY(HWM_RX_CHECK) 337 * void HWM_RX_CHECK(smc,low_water) 338 * 339 * function MACRO (hardware module, hwmtm.h) 340 * This macro is invoked by the OS-specific before it left the 341 * function mac_drv_rx_complete. This macro calls mac_drv_fill_rxd 342 * if the number of used RxDs is equal or lower than the 343 * the given low water mark. 344 * 345 * para low_water low water mark of used RxD's 346 * 347 * END_MANUAL_ENTRY 348 */ 349 #ifndef HWM_NO_FLOW_CTL 350 #define HWM_RX_CHECK(smc,low_water) {\ 351 if ((low_water) >= (smc)->hw.fp.rx_q[QUEUE_R1].rx_used) {\ 352 mac_drv_fill_rxd(smc) ;\ 353 }\ 354 } 355 #else 356 #define HWM_RX_CHECK(smc,low_water) mac_drv_fill_rxd(smc) 357 #endif 358 359 #ifndef HWM_EBASE 360 #define HWM_EBASE 500 361 #endif 362 363 #define HWM_E0001 HWM_EBASE + 1 364 #define HWM_E0001_MSG "HWM: Wrong size of s_rxd_os struct" 365 #define HWM_E0002 HWM_EBASE + 2 366 #define HWM_E0002_MSG "HWM: Wrong size of s_txd_os struct" 367 #define HWM_E0003 HWM_EBASE + 3 368 #define HWM_E0003_MSG "HWM: smt_free_mbuf() called with NULL pointer" 369 #define HWM_E0004 HWM_EBASE + 4 370 #define HWM_E0004_MSG "HWM: Parity error rx queue 1" 371 #define HWM_E0005 HWM_EBASE + 5 372 #define HWM_E0005_MSG "HWM: Encoding error rx queue 1" 373 #define HWM_E0006 HWM_EBASE + 6 374 #define HWM_E0006_MSG "HWM: Encoding error async tx queue" 375 #define HWM_E0007 HWM_EBASE + 7 376 #define HWM_E0007_MSG "HWM: Encoding error sync tx queue" 377 #define HWM_E0008 HWM_EBASE + 8 378 #define HWM_E0008_MSG "" 379 #define HWM_E0009 HWM_EBASE + 9 380 #define HWM_E0009_MSG "HWM: Out of RxD condition detected" 381 #define HWM_E0010 HWM_EBASE + 10 382 #define HWM_E0010_MSG "HWM: A protocol layer has tried to send a frame with an invalid frame control" 383 #define HWM_E0011 HWM_EBASE + 11 384 #define HWM_E0011_MSG "HWM: mac_drv_clear_tx_queue was called although the hardware wasn't stopped" 385 #define HWM_E0012 HWM_EBASE + 12 386 #define HWM_E0012_MSG "HWM: mac_drv_clear_rx_queue was called although the hardware wasn't stopped" 387 #define HWM_E0013 HWM_EBASE + 13 388 #define HWM_E0013_MSG "HWM: mac_drv_repair_descr was called although the hardware wasn't stopped" 389 390 #endif 391