kernel/drivers/net/fddi/skfp/h/hwmtm.h

   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