drivers/net/wireless/realtek/rtlwifi/rtl8192de/fw.h

   1 /******************************************************************************
   2  *
   3  * Copyright(c) 2009-2012  Realtek Corporation.
   4  *
   5  * This program is free software; you can redistribute it and/or modify it
   6  * under the terms of version 2 of the GNU General Public License as
   7  * published by the Free Software Foundation.
   8  *
   9  * This program is distributed in the hope that it will be useful, but WITHOUT
  10  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  11  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
  12  * more details.
  13  *
  14  * The full GNU General Public License is included in this distribution in the
  15  * file called LICENSE.
  16  *
  17  * Contact Information:
  18  * wlanfae <wlanfae@realtek.com>
  19  * Realtek Corporation, No. 2, Innovation Road II, Hsinchu Science Park,
  20  * Hsinchu 300, Taiwan.
  21  *
  22  * Larry Finger <Larry.Finger@lwfinger.net>
  23  *
  24  *****************************************************************************/
  25
  26 #ifndef __RTL92D__FW__H__
  27 #define __RTL92D__FW__H__
  28
  29 #define FW_8192D_START_ADDRESS                  0x1000
  30 #define FW_8192D_PAGE_SIZE                              4096
  31 #define FW_8192D_POLLING_TIMEOUT_COUNT  1000
  32
  33 #define IS_FW_HEADER_EXIST(_pfwhdr)     \
  34                 ((GET_FIRMWARE_HDR_SIGNATURE(_pfwhdr) & 0xFFF0) == 0x92C0 || \
  35                 (GET_FIRMWARE_HDR_SIGNATURE(_pfwhdr) & 0xFFF0) == 0x88C0 ||  \
  36                 (GET_FIRMWARE_HDR_SIGNATURE(_pfwhdr) & 0xFFFF) == 0x92D0 ||  \
  37                 (GET_FIRMWARE_HDR_SIGNATURE(_pfwhdr) & 0xFFFF) == 0x92D1 ||  \
  38                 (GET_FIRMWARE_HDR_SIGNATURE(_pfwhdr) & 0xFFFF) == 0x92D2 ||  \
  39                 (GET_FIRMWARE_HDR_SIGNATURE(_pfwhdr) & 0xFFFF) == 0x92D3)
  40
  41 /* Define a macro that takes an le32 word, converts it to host ordering,
  42  * right shifts by a specified count, creates a mask of the specified
  43  * bit count, and extracts that number of bits.
  44  */
  45
  46 #define SHIFT_AND_MASK_LE(__pdesc, __shift, __mask)             \
  47         ((le32_to_cpu(*(((__le32 *)(__pdesc)))) >> (__shift)) & \
  48         BIT_LEN_MASK_32(__mask))
  49
  50 /* Firmware Header(8-byte alinment required) */
  51 /* --- LONG WORD 0 ---- */
  52 #define GET_FIRMWARE_HDR_SIGNATURE(__fwhdr)             \
  53         SHIFT_AND_MASK_LE(__fwhdr, 0, 16)
  54 #define GET_FIRMWARE_HDR_CATEGORY(__fwhdr)              \
  55         SHIFT_AND_MASK_LE(__fwhdr, 16, 8)
  56 #define GET_FIRMWARE_HDR_FUNCTION(__fwhdr)              \
  57         SHIFT_AND_MASK_LE(__fwhdr, 24, 8)
  58 #define GET_FIRMWARE_HDR_VERSION(__fwhdr)               \
  59         SHIFT_AND_MASK_LE(__fwhdr + 4, 0, 16)
  60 #define GET_FIRMWARE_HDR_SUB_VER(__fwhdr)               \
  61         SHIFT_AND_MASK_LE(__fwhdr + 4, 16, 8)
  62 #define GET_FIRMWARE_HDR_RSVD1(__fwhdr)                 \
  63         SHIFT_AND_MASK_LE(__fwhdr + 4, 24, 8)
  64
  65 /* --- LONG WORD 1 ---- */
  66 #define GET_FIRMWARE_HDR_MONTH(__fwhdr)                 \
  67         SHIFT_AND_MASK_LE(__fwhdr + 8, 0, 8)
  68 #define GET_FIRMWARE_HDR_DATE(__fwhdr)                  \
  69         SHIFT_AND_MASK_LE(__fwhdr + 8, 8, 8)
  70 #define GET_FIRMWARE_HDR_HOUR(__fwhdr)                  \
  71         SHIFT_AND_MASK_LE(__fwhdr + 8, 16, 8)
  72 #define GET_FIRMWARE_HDR_MINUTE(__fwhdr)                \
  73         SHIFT_AND_MASK_LE(__fwhdr + 8, 24, 8)
  74 #define GET_FIRMWARE_HDR_ROMCODE_SIZE(__fwhdr)          \
  75         SHIFT_AND_MASK_LE(__fwhdr + 12, 0, 16)
  76 #define GET_FIRMWARE_HDR_RSVD2(__fwhdr)                 \
  77         SHIFT_AND_MASK_LE(__fwhdr + 12, 16, 16)
  78
  79 /* --- LONG WORD 2 ---- */
  80 #define GET_FIRMWARE_HDR_SVN_IDX(__fwhdr)               \
  81         SHIFT_AND_MASK_LE(__fwhdr + 16, 0, 32)
  82 #define GET_FIRMWARE_HDR_RSVD3(__fwhdr)                 \
  83         SHIFT_AND_MASK_LE(__fwhdr + 20, 0, 32)
  84
  85 /* --- LONG WORD 3 ---- */
  86 #define GET_FIRMWARE_HDR_RSVD4(__fwhdr)                 \
  87         SHIFT_AND_MASK_LE(__fwhdr + 24, 0, 32)
  88 #define GET_FIRMWARE_HDR_RSVD5(__fwhdr)                 \
  89         SHIFT_AND_MASK_LE(__fwhdr + 28, 0, 32)
  90
  91 #define pagenum_128(_len) \
  92         (u32)(((_len) >> 7) + ((_len) & 0x7F ? 1 : 0))
  93
  94 #define SET_H2CCMD_PWRMODE_PARM_MODE(__ph2ccmd, __val)          \
  95         SET_BITS_TO_LE_1BYTE(__ph2ccmd, 0, 8, __val)
  96 #define SET_H2CCMD_PWRMODE_PARM_SMART_PS(__ph2ccmd, __val)      \
  97         SET_BITS_TO_LE_1BYTE((__ph2ccmd) + 1, 0, 8, __val)
  98 #define SET_H2CCMD_PWRMODE_PARM_BCN_PASS_TIME(__ph2ccmd, __val) \
  99         SET_BITS_TO_LE_1BYTE((__ph2ccmd) + 2, 0, 8, __val)
 100 #define SET_H2CCMD_JOINBSSRPT_PARM_OPMODE(__ph2ccmd, __val)     \
 101         SET_BITS_TO_LE_1BYTE(__ph2ccmd, 0, 8, __val)
 102 #define SET_H2CCMD_RSVDPAGE_LOC_PROBE_RSP(__ph2ccmd, __val)     \
 103         SET_BITS_TO_LE_1BYTE(__ph2ccmd, 0, 8, __val)
 104 #define SET_H2CCMD_RSVDPAGE_LOC_PSPOLL(__ph2ccmd, __val)        \
 105         SET_BITS_TO_LE_1BYTE((__ph2ccmd) + 1, 0, 8, __val)
 106 #define SET_H2CCMD_RSVDPAGE_LOC_NULL_DATA(__ph2ccmd, __val)     \
 107         SET_BITS_TO_LE_1BYTE((__ph2ccmd) + 2, 0, 8, __val)
 108
 109 int rtl92d_download_fw(struct ieee80211_hw *hw);
 110 void rtl92d_fill_h2c_cmd(struct ieee80211_hw *hw, u8 element_id,
 111                          u32 cmd_len, u8 *p_cmdbuffer);
 112 void rtl92d_firmware_selfreset(struct ieee80211_hw *hw);
 113 void rtl92d_set_fw_rsvdpagepkt(struct ieee80211_hw *hw, bool b_dl_finished);
 114 void rtl92d_set_fw_joinbss_report_cmd(struct ieee80211_hw *hw, u8 mstatus);
 115
 116 #endif