drivers/staging/wlags49_h2/hcf.h

   1
   2 //   vim:tw=110:ts=4:
   3 #ifndef HCF_H
   4 #define HCF_H 1
   5
   6 /************************************************************************************************************
   7 *
   8 * FILE   : hcf.h
   9 *
  10 * DATE   : $Date: 2004/08/05 11:47:10 $   $Revision: 1.7 $
  11 * Original: 2004/05/19 07:26:01    Revision: 1.56      Tag: hcf7_t20040602_01
  12 * Original: 2004/05/12 08:47:23    Revision: 1.53      Tag: hcf7_t7_20040513_01
  13 * Original: 2004/04/15 09:24:42    Revision: 1.46      Tag: hcf7_t7_20040415_01
  14 * Original: 2004/04/08 15:18:16    Revision: 1.45      Tag: t7_20040413_01
  15 * Original: 2004/04/01 15:32:55    Revision: 1.43      Tag: t7_20040401_01
  16 * Original: 2004/03/10 15:39:28    Revision: 1.39      Tag: t20040310_01
  17 * Original: 2004/03/04 11:03:38    Revision: 1.37      Tag: t20040304_01
  18 * Original: 2004/03/02 14:51:21    Revision: 1.35      Tag: t20040302_03
  19 * Original: 2004/02/24 13:00:28    Revision: 1.28      Tag: t20040224_01
  20 * Original: 2004/02/09 14:50:14    Revision: 1.26      Tag: t20040219_01
  21 *
  22 * AUTHOR : Nico Valster
  23 *
  24 * SPECIFICATION: ..........
  25 *
  26 * DESC   : Definitions and Prototypes for MSF as well as HCF sources
  27 *
  28 *                  Customizable via HCFCFG.H
  29 *
  30 *
  31 **************************************************************************************************************
  32
  33 **************************************************************************************************************
  34 *
  35 *
  36 * SOFTWARE LICENSE
  37 *
  38 * This software is provided subject to the following terms and conditions,
  39 * which you should read carefully before using the software.  Using this
  40 * software indicates your acceptance of these terms and conditions.  If you do
  41 * not agree with these terms and conditions, do not use the software.
  42 *
  43 * COPYRIGHT © 1994 - 1995       by AT&T.                                All Rights Reserved
  44 * COPYRIGHT © 1996 - 2000 by Lucent Technologies.       All Rights Reserved
  45 * COPYRIGHT © 2001 - 2004       by Agere Systems Inc.   All Rights Reserved
  46 * All rights reserved.
  47 *
  48 * Redistribution and use in source or binary forms, with or without
  49 * modifications, are permitted provided that the following conditions are met:
  50 *
  51 * . Redistributions of source code must retain the above copyright notice, this
  52 *    list of conditions and the following Disclaimer as comments in the code as
  53 *    well as in the documentation and/or other materials provided with the
  54 *    distribution.
  55 *
  56 * . Redistributions in binary form must reproduce the above copyright notice,
  57 *    this list of conditions and the following Disclaimer in the documentation
  58 *    and/or other materials provided with the distribution.
  59 *
  60 * . Neither the name of Agere Systems Inc. nor the names of the contributors
  61 *    may be used to endorse or promote products derived from this software
  62 *    without specific prior written permission.
  63 *
  64 * Disclaimer
  65 *
  66 * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
  67 * INCLUDING, BUT NOT LIMITED TO, INFRINGEMENT AND THE IMPLIED WARRANTIES OF
  68 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  ANY
  69 * USE, MODIFICATION OR DISTRIBUTION OF THIS SOFTWARE IS SOLELY AT THE USERS OWN
  70 * RISK. IN NO EVENT SHALL AGERE SYSTEMS INC. OR CONTRIBUTORS BE LIABLE FOR ANY
  71 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  72 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  73 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  74 * ON ANY THEORY OF LIABILITY, INCLUDING, BUT NOT LIMITED TO, CONTRACT, STRICT
  75 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  76 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
  77 * DAMAGE.
  78 *
  79 *
  80 *************************************************************************************************************/
  81
  82
  83 #include "hcfcfg.h"     // System Constants to be defined by the MSF-programmer to tailor the HCF
  84 #include "mdd.h"        // Include file common for HCF, MSF
  85
  86
  87 /************************************************************************************************/
  88 /**************************************  MACROS  ************************************************/
  89 /************************************************************************************************/
  90
  91 #define LOF(x)                  (sizeof(x)/sizeof(hcf_16)-1)
  92
  93 /*      Endianess
  94  *      Little Endian (a.k.a. Intel), least significant byte first
  95  *      Big Endian (a.k.a. Motorola), most significant byte first
  96  *
  97  * The following macros are supplied
  98  *  o CNV_LITTLE_TO_SHORT(w)                    interprets the 16-bits input value as Little Endian, returns an hcf_16
  99  *      o CNV_BIG_TO_SHORT(w)                           interprets the 16-bits input value as Big Endian, returns an hcf_16
 100  *
 101  */
 102
 103 /* To increase portability, use unsigned char and unsigned char * when accessing parts of larger
 104  * types to convert their Endianess
 105  */
 106
 107 #define CNV_END_SHORT(w)  (hcf_16)( ((hcf_16)(w) & 0x00FF) << 8 | ((hcf_16)(w) & 0xFF00) >> 8 )
 108 #define CNV_END_LONG(dw)  (hcf_32)( (dw >> 24) | ((dw >> 8) & 0xff00) | ((dw << 8) & 0xff0000) | (dw << 24) )
 109
 110 #if HCF_BIG_ENDIAN
 111 //******************************************** B I G   E N D I A N *******************************************
 112 #define CNV_LITTLE_TO_SHORT(w)  CNV_END_SHORT(w)        //    endianess conversion needed
 113 #define CNV_BIG_TO_SHORT(w)             (w)                             // no endianess conversion needed
 114 #define CNV_LITTLE_TO_LONG(dw)  CNV_END_LONG(dw)
 115 #define CNV_LONG_TO_LITTLE(dw)  CNV_END_LONG(dw)
 116 #else
 117 //****************************************** L I T T L E   E N D I A N ****************************************
 118 #define CNV_LITTLE_TO_SHORT(w)  (w)                             // no endianess conversion needed
 119 #define CNV_BIG_TO_SHORT(w)             CNV_END_SHORT(w)        //    endianess conversion needed
 120 #define CNV_LITTLE_TO_LONG(dw)  (dw)
 121 #define CNV_LONG_TO_LITTLE(dw)  (dw)
 122
 123 #if defined HCF_ALIGN && HCF_ALIGN > 1
 124 #define CNV_SHORTP_TO_LITTLE(pw)        ((hcf_16)(*(hcf_8 *)pw))                        | ((hcf_16)(*((hcf_8 *)pw+1)) << 8)
 125 #define CNV_LONGP_TO_LITTLE(pdw)        ((hcf_32)(*(hcf_8 *)pdw))                       | ((hcf_32)(*((hcf_8 *)pdw+1)) << 8)    | \
 126                                                                         ((hcf_32)(*((hcf_8 *)pdw+2)) << 16) | ((hcf_32)(*((hcf_8 *)pdw+3)) << 24)
 127 #else
 128 #define CNV_LONGP_TO_LITTLE(pdw)        (*(hcf_32 *)pdw)
 129 #define CNV_SHORTP_TO_LITTLE(pw)        (*(hcf_16 *)pw)
 130 #endif
 131
 132 #endif // HCF_BIG_ENDIAN
 133
 134 // conversion macros which can be expressed in other macros
 135 #define CNV_SHORT_TO_LITTLE(w)  CNV_LITTLE_TO_SHORT(w)
 136 #define CNV_SHORT_TO_BIG(w)             CNV_BIG_TO_SHORT(w)
 137
 138 /************************************************************************************************/
 139 /**************************************  END OF MACROS  *****************************************/
 140 /************************************************************************************************/
 141
 142 /***********************************************************************************************************/
 143 /*****************                                                  ****************************************/
 144 /***********************************************************************************************************/
 145
 146 // offsets Transmit/Receive Frame Structure
 147 #define HFS_STAT                                0x0000
 148 #define HFS_SWSUP                               0x0006                                  //SW Support
 149 #define HFS_Q_INFO                              0x0006                                  //Signal/Silence level
 150 #define HFS_RATE                                0x0008                                  //RxFlow/Rate
 151 #define         HFS_STAT_ERR            RX_STAT_ERR                             //link "natural" HCF name to "natural" MSF name
 152 #define HFS_TX_CNTL                             0x0036
 153                                                                                                                 // H-I     H-II
 154 #define HFS_DAT_LEN                             (HFS_ADDR_DEST - 2)             // 0x002C  0x0038
 155 #define HFS_ADDR_DEST                   0x003A                                  // 0x002E  0x003A
 156 #define HFS_ADDR_SRC                    (HFS_ADDR_DEST + 6)             // 0x0034  0x0040
 157 #define HFS_LEN                                 (HFS_ADDR_SRC  + 6)             // 0x003A  0x0046
 158 #define HFS_DAT                                 (HFS_LEN       + 2)             // 0x003C  0x0048
 159 #define HFS_TYPE                                (HFS_DAT       + 6)             // 0x0042  0x004E
 160
 161
 162 //=============================  D E S C R I P T O R   S T R U C T U R E  ==============================
 163 //;?MDD.H stuff ;?
 164
 165 #if HCF_BIG_ENDIAN
 166 #define DESC_STRCT_CNT          0
 167 #define DESC_STRCT_SIZE         1
 168 #else
 169 #define DESC_STRCT_CNT          1
 170 #define DESC_STRCT_SIZE         0
 171 #endif // HCF_BIG_ENDIAN
 172
 173 #define BUF_CNT                         buf_dim[DESC_STRCT_CNT]
 174 #define BUF_SIZE                        buf_dim[DESC_STRCT_SIZE]
 175
 176 typedef struct DESC_STRCT {
 177         hcf_16                                  buf_dim[2];
 178         hcf_32                                  buf_phys_addr;
 179         hcf_32                                  next_desc_phys_addr;    // physical address of next descriptor
 180         hcf_32                                  desc_phys_addr;                 // physical address of this descriptor
 181         struct DESC_STRCT               *next_desc_addr;
 182         hcf_8   FAR                             *buf_addr;
 183 #if (HCF_EXT) & HCF_EXT_DESC_STRCT
 184         void FAR                           *DESC_MSFSup;                        // pointer for arbitrary use by the MSF
 185 #endif // HCF_DESC_STRCT_EXT
 186 } DESC_STRCT;
 187
 188 #define HCF_DASA_SIZE                   12                                                      //size in bytes for DA/SA
 189
 190 #define DESC_CNT_MASK                   0x0FFF
 191
 192 #define GET_BUF_SIZE(descp)       ((descp)->BUF_SIZE)
 193 #define GET_BUF_CNT(descp)        ((descp)->BUF_CNT)
 194 #define SET_BUF_SIZE(descp, size) (descp)->BUF_SIZE = size;
 195 #define SET_BUF_CNT(descp, count) (descp)->BUF_CNT = count;
 196
 197 //=========================================  T A L L I E S  ===================================================
 198
 199 typedef struct  {  //Hermes Tallies (IFB substructure)
 200   hcf_32        TxUnicastFrames;
 201   hcf_32        TxMulticastFrames;
 202   hcf_32        TxFragments;
 203   hcf_32        TxUnicastOctets;
 204   hcf_32        TxMulticastOctets;
 205   hcf_32        TxDeferredTransmissions;
 206   hcf_32        TxSingleRetryFrames;
 207   hcf_32        TxMultipleRetryFrames;
 208   hcf_32        TxRetryLimitExceeded;
 209   hcf_32        TxDiscards;
 210   hcf_32        RxUnicastFrames;
 211   hcf_32        RxMulticastFrames;
 212   hcf_32        RxFragments;
 213   hcf_32        RxUnicastOctets;
 214   hcf_32        RxMulticastOctets;
 215   hcf_32        RxFCSErrors;
 216   hcf_32        RxDiscardsNoBuffer;
 217   hcf_32        TxDiscardsWrongSA;
 218   hcf_32        RxWEPUndecryptable;
 219   hcf_32        RxMsgInMsgFragments;
 220   hcf_32        RxMsgInBadMsgFragments;
 221   hcf_32        RxDiscardsWEPICVError;
 222   hcf_32        RxDiscardsWEPExcluded;
 223 #if (HCF_EXT) & HCF_EXT_TALLIES_FW
 224   hcf_32        TalliesExtra[32];
 225 #endif // HCF_EXT_TALLIES_FW
 226 } CFG_HERMES_TALLIES_STRCT;
 227
 228 typedef struct  {  //HCF Tallies (IFB substructure)
 229   hcf_32        NoBufInfo;                              //No buffer available for unsolicited Notify frame
 230   hcf_32        NoBufMB;                                        //No space available in MailBox
 231   hcf_32        MiscErr;                                        /* Command errors
 232                                                                                  *  - time out on completion synchronous part Hermes Command
 233                                                                                  *  - completed Hermes Command doesn't match original command
 234                                                                                  *  - status of completed Hermes Command contains error bits
 235                                                                                  */
 236 #if (HCF_EXT) & HCF_EXT_TALLIES_FW
 237   hcf_32        EngCnt[8];
 238 #endif // HCF_EXT_TALLIES_FW
 239 } CFG_HCF_TALLIES_STRCT;
 240
 241 //Note this way to define ..._TAL_CNT implies that all tallies must keep the same (hcf_32) size
 242 #if (HCF_TALLIES) & ( HCF_TALLIES_NIC | HCF_TALLIES_HCF )
 243 #if (HCF_TALLIES) & HCF_TALLIES_NIC     //Hermes tally support
 244 #define         HCF_NIC_TAL_CNT (sizeof(CFG_HERMES_TALLIES_STRCT)/ sizeof(hcf_32))
 245 #else
 246 #define         HCF_NIC_TAL_CNT 0
 247 #endif // HCF_TALLIES
 248 #if (HCF_TALLIES) & HCF_TALLIES_HCF     //HCF tally support
 249 #define         HCF_HCF_TAL_CNT (sizeof(CFG_HCF_TALLIES_STRCT)   / sizeof(hcf_32))
 250 #else
 251 #define         HCF_HCF_TAL_CNT 0
 252 #endif // HCF_TALLIES
 253 #define HCF_TOT_TAL_CNT ( HCF_NIC_TAL_CNT + HCF_NIC_TAL_CNT )
 254 #endif // HCF_TALLIES_NIC / HCF_TALLIES_HCF
 255
 256
 257 /***********************************************************************************************************/
 258 /********************************** I N T E R F A C E   B L O C K ******************************************/
 259 /***********************************************************************************************************/
 260
 261 #define IFB_VERSION 0x0E                                // initially 0, to be incremented by every IFB layout change
 262
 263 typedef struct  {
 264   hcf_io                IFB_IOBase;                             // I/O address of Hermes chip as passed by MSF at hcf_connect call
 265   hcf_16                IFB_IORange;                    // I/O Range used by Hermes chip
 266   hcf_16                IFB_DLMode;                             // Download Mode state
 267   hcf_16                IFB_Cmd;                                // cmd in progress flag, to be ack-ed before next cmd can be issued
 268   hcf_16                IFB_RxFID;                              // FID of "current" RxFS (non-DMA mode)
 269 //;?#if tx_delay option
 270   hcf_16                IFB_TxFID;                              // fid storage during "delayed" send
 271 //;?#endif tx_delay option
 272   hcf_16                IFB_RxLen;                              //
 273   hcf_16                IFB_DefunctStat;                // BAP initialization or Cmd Completion failed
 274   hcf_16                IFB_ErrCmd;                             // contents Status reg when error bits and/or mismatch in cmd_wait
 275   hcf_16                IFB_ErrQualifier;               // contents Resp0  reg when error bits and/or mismatch in cmd_wait
 276   hcf_16                IFB_lal;                                // LookAhead Length
 277   wci_bufp              IFB_lap;                                // LookAhead Buffer pointer
 278   hcf_16                IFB_LinkStat;                   // Link Status
 279   hcf_16                IFB_DSLinkStat;                 // Link Status, new strategy introduced for DeepSleep
 280   hcf_16                IFB_CarryIn;                    // carry and carry-flag to move 1 byte from one get_frag to the next
 281   hcf_16                IFB_CarryOut;                   // carry and carry-flag to move 1 byte from one put_frag to the next
 282   hcf_16                IFB_Version;                    // IFB_VERSION, incremented by every SIGNIFICANT IFB layout change
 283   hcf_16                IFB_CardStat;                   // NIC error / F/W incompatibility status
 284   hcf_16                IFB_RscInd;                             // non-DMA: TxFID available, DMA: always 1
 285   hcf_16                IFB_CntlOpt;                    // flags: 32 bits I/O, DMA available, DMA enabled
 286   hcf_16                IFB_BusType;                    // BusType, derived via CFG_NIC_BUS_TYPE
 287   CFG_FW_IDENTITY_STRCT  IFB_FWIdentity; /* keep FWIdentity/Sup and PRIIdentity/Sup in sequence
 288                                                                                   * because of the (dumb) copy in init() */
 289 #if defined MSF_COMPONENT_ID
 290   CFG_SUP_RANGE_STRCT    IFB_FWSup;
 291   CFG_PRI_IDENTITY_STRCT IFB_PRIIdentity;
 292   CFG_SUP_RANGE_STRCT    IFB_PRISup;
 293   CFG_SUP_RANGE_STRCT    IFB_HSISup;
 294 #endif // MSF_COMPONENT_ID
 295 #if (HCF_EXT) & HCF_EXT_INFO_LOG
 296   RID_LOGP              IFB_RIDLogp;                    // pointer to RID_LOG structure
 297 #endif // HCF_EXT_INFO_LOG
 298 #if HCF_PROT_TIME
 299   hcf_32                IFB_TickIni;                    // initialization of S/W counter based protection loop
 300 #endif // HCF_PROT_TIME
 301 #if (HCF_EXT) & HCF_EXT_INT_TICK
 302   int                   IFB_TickCnt;                    // Hermes Timer Tick Counter
 303 #endif // HCF_EXT_INT_TICK
 304 #if (HCF_EXT) & HCF_EXT_MB
 305   hcf_16           *IFB_MBp;                            // pointer to the MailBox
 306   hcf_16                IFB_MBSize;                             // size of the MailBox
 307   hcf_16                IFB_MBWp;                               // zero-based write index into the MailBox
 308   hcf_16                IFB_MBRp;                               // zero-based read  index into the MailBox
 309   hcf_16                IFB_MBInfoLen;                  // contents of L-field of the oldest available MailBoxInfoBlock
 310 #endif // HCF_EXT_MB
 311 #if (HCF_TYPE) & HCF_TYPE_WPA
 312   hcf_16                IFB_MICTxCntl;                  // MIC bit and Key index in TxControl field of TxFS
 313   hcf_32                IFB_MICTxKey[2];                // calculating key
 314   hcf_32                IFB_MICTx[2];                   // Tx MIC calculation Engine state
 315   hcf_16                IFB_MICTxCarry;                 // temp length, carries over from one Tx fragment to another
 316   hcf_16                IFB_MICRxCarry;                 // temp length, carries over from one Rx fragment to another
 317   hcf_32                IFB_MICRxKey[4*2];              // 4 checking keys
 318   hcf_32                IFB_MICRx[2];                   // Rx MIC calculation Engine state
 319 #endif // HCF_TYPE_WPA
 320 #if HCF_ASSERT
 321 #if (HCF_ASSERT) & HCF_ASSERT_MB
 322   CFG_MB_INFO_RANGE1_STRCT      IFB_AssertStrct; // Add some complication to the HCF as prize for the new MSF I/F
 323 #endif // HCF_ASSERT_MB
 324                                                                                 // target of above IFB_AssertStrct
 325   hcf_16                IFB_AssertLine;                 //  - line number ( + encoded module name )
 326   hcf_16                IFB_AssertTrace;                //  - bit based trace of all hcf_.... invocations
 327   hcf_32                IFB_AssertQualifier;    //  - qualifier
 328   hcf_16                IFB_AssertLvl;                  // Assert Filtering, Not yet implemented
 329   hcf_16                IFB_AssertWhere;                // Where parameter of the Assert macro
 330 #if (HCF_ASSERT) & ( HCF_ASSERT_LNK_MSF_RTN | HCF_ASSERT_RT_MSF_RTN )
 331   MSF_ASSERT_RTNP       IFB_AssertRtn;          // MSF Assert Call back routine (inspired by GEF, DrDobbs Nov 1998 )
 332 #endif // HCF_ASSERT_LNK_MSF_RTN
 333 #if (HCF_ASSERT) & HCF_ASSERT_PRINTF    // engineering facilty intended as F/W debugging aid
 334    hcf_16       IFB_DbgPrintF_Cnt;
 335    CFG_FW_PRINTF_BUFFER_LOCATION_STRCT IFB_FwPfBuff;
 336 #endif // HCF_ASSERT_PRINTF
 337 #endif // HCF_ASSERT
 338 #if ! defined HCF_INT_OFF
 339   hcf_16 volatile IFB_IntOffCnt;                // 0xFFFF based HCF_ACT_INT_OFF nesting counter, DeepSleep flag
 340 #endif // HCF_INT_OFF
 341 #if (HCF_TYPE) & HCF_TYPE_CCX
 342   hcf_16         IFB_CKIPStat;                  // CKIP Status flag
 343 #endif // HCF_TYPE_CCX
 344 #if (HCF_TALLIES) & ( HCF_TALLIES_NIC | HCF_TALLIES_HCF )       //Hermes and/or HCF tally support
 345   hcf_32                IFB_Silly_you_should_align;     //;?
 346   hcf_16                IFB_TallyLen;                   // Tally length (to build an LTV)
 347   hcf_16                IFB_TallyTyp;                   // Tally Type (to build an LTV)
 348 #endif // HCF_TALLIES_NIC / HCF_TALLIES_HCF
 349 #if (HCF_TALLIES) & HCF_TALLIES_NIC             //Hermes tally support
 350   CFG_HERMES_TALLIES_STRCT      IFB_NIC_Tallies;
 351 #endif // HCF_TALLIES_NIC
 352 #if (HCF_TALLIES) & HCF_TALLIES_HCF             //HCF tally support
 353   CFG_HCF_TALLIES_STRCT         IFB_HCF_Tallies;
 354 #endif // HCF_TALLIES_HCF
 355 #if HCF_DMA
 356   //used for a pool of destination_address descriptor/buffers, used during tx encapsulation points to the
 357   //first/last descriptor in the descriptor chain, so we can easily remove and append a packet.
 358   DESC_STRCT    *IFB_FirstDesc[2];
 359   DESC_STRCT    *IFB_LastDesc[2];
 360   DESC_STRCT    *IFB_ConfinedDesc[2];   // pointers to descriptor used for host reclaim purposes.
 361   hcf_16                IFB_DmaPackets;                 // HREG_EV_[TX/RX]DMA_DONE flags, reports DMA Frame availability to MSF
 362 #endif // HCF_DMA
 363 #if (HCF_EXT) & HCF_EXT_INT_TX_EX
 364   hcf_16                IFB_TxFsStat;                   // Tx message monitoring
 365   hcf_16                IFB_TxFsGap[2];                 //;?make this robust
 366   hcf_16                IFB_TxFsSwSup;
 367 #endif // HCF_EXT_INT_TX_EX
 368   hcf_16                IFB_Magic;                              /* "Magic" signature, to help the debugger interpret a memory dump
 369                                                                                  * also the last field cleared at hcf_connect
 370                                                                                  */
 371 #if (HCF_EXT) & HCF_EXT_IFB_STRCT               // for usage by the MSF
 372   void FAR         *IFB_MSFSup;                         // pointer for arbitrary use by the MSF
 373 #endif // HCF_EXT_IFB_STRCT_EXT
 374 } IFB_STRCT;
 375
 376 typedef IFB_STRCT*      IFBP;
 377
 378
 379 /***********************************************************************************************************/
 380 /**********************   W C I    F U N C T I O N S    P R O T O T Y P E S   ******************************/
 381 /***********************************************************************************************************/
 382
 383 EXTERN_C int             hcf_action                     (IFBP ifbp, hcf_16 cmd );
 384 EXTERN_C int             hcf_connect            (IFBP ifbp, hcf_io io_base );
 385 #if (HCF_ENCAP) & HCF_ENC_SUP
 386 EXTERN_C hcf_8           hcf_encap                      (wci_bufp type );
 387 #endif // HCF_ENC_SUP
 388 EXTERN_C int             hcf_get_info           (IFBP ifbp, LTVP ltvp );
 389 EXTERN_C int             hcf_service_nic        (IFBP ifbp, wci_bufp bufp, unsigned int len );
 390 EXTERN_C int             hcf_cntl                       (IFBP ifbp, hcf_16 cmd );
 391 EXTERN_C int             hcf_put_info           (IFBP ifbp, LTVP ltvp );
 392 EXTERN_C int             hcf_rcv_msg            (IFBP ifbp, DESC_STRCT *descp, unsigned int offset );
 393 EXTERN_C int             hcf_send_msg       (IFBP ifbp, DESC_STRCT *dp, hcf_16 tx_cntl );
 394 #if HCF_DMA
 395 EXTERN_C void            hcf_dma_tx_put         (IFBP ifbp, DESC_STRCT *d, hcf_16 tx_cntl );
 396 EXTERN_C DESC_STRCT* hcf_dma_tx_get             (IFBP ifbp );
 397 EXTERN_C DESC_STRCT* hcf_dma_rx_get             (IFBP ifbp );
 398 EXTERN_C void            hcf_dma_rx_put         (IFBP ifbp, DESC_STRCT *d );
 399 #endif // HCF_DMA
 400 #if (HCF_ASSERT) & HCF_ASSERT_LNK_MSF_RTN
 401 EXTERN_C void            msf_assert                     (unsigned int line_number, hcf_16 trace, hcf_32 qual );
 402 #endif // HCF_ASSERT_LNK_MSF_RTN
 403
 404 #endif  // HCF_H
 405