drivers/staging/rtl8712/rtl871x_pwrctrl.h

   1 /******************************************************************************
   2  *
   3  * Copyright(c) 2007 - 2010 Realtek Corporation. All rights reserved.
   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  * You should have received a copy of the GNU General Public License along with
  15  * this program; if not, write to the Free Software Foundation, Inc.,
  16  * 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA
  17  *
  18  * Modifications for inclusion into the Linux staging tree are
  19  * Copyright(c) 2010 Larry Finger. All rights reserved.
  20  *
  21  * Contact information:
  22  * WLAN FAE <wlanfae@realtek.com>
  23  * Larry Finger <Larry.Finger@lwfinger.net>
  24  *
  25  ******************************************************************************/
  26 #ifndef __RTL871X_PWRCTRL_H_
  27 #define __RTL871X_PWRCTRL_H_
  28
  29 #include "osdep_service.h"
  30 #include "drv_types.h"
  31
  32
  33 #define FW_PWR0 0
  34 #define FW_PWR1         1
  35 #define FW_PWR2         2
  36 #define FW_PWR3         3
  37
  38
  39 #define HW_PWR0 7
  40 #define HW_PWR1         6
  41 #define HW_PWR2         2
  42 #define HW_PWR3 0
  43 #define HW_PWR4 8
  44
  45 #define FW_PWRMSK       0x7
  46
  47
  48 #define XMIT_ALIVE      BIT(0)
  49 #define RECV_ALIVE      BIT(1)
  50 #define CMD_ALIVE       BIT(2)
  51 #define EVT_ALIVE       BIT(3)
  52
  53
  54 enum Power_Mgnt {
  55         PS_MODE_ACTIVE  = 0     ,
  56         PS_MODE_MIN                     ,
  57         PS_MODE_MAX                     ,
  58         PS_MODE_DTIM                    ,
  59         PS_MODE_VOIP                    ,
  60         PS_MODE_UAPSD_WMM       ,
  61         PS_MODE_UAPSD                   ,
  62         PS_MODE_IBSS                    ,
  63         PS_MODE_WWLAN           ,
  64         PM_Radio_Off                    ,
  65         PM_Card_Disable         ,
  66         PS_MODE_NUM
  67 };
  68
  69
  70 /*
  71         BIT[2:0] = HW state
  72         BIT[3] = Protocol PS state, 0: register active state,
  73                                     1: register sleep state
  74         BIT[4] = sub-state
  75 */
  76
  77 #define         PS_DPS                          BIT(0)
  78 #define         PS_LCLK                         (PS_DPS)
  79 #define PS_RF_OFF                       BIT(1)
  80 #define PS_ALL_ON                       BIT(2)
  81 #define PS_ST_ACTIVE            BIT(3)
  82 #define PS_LP                           BIT(4)  /* low performance */
  83
  84 #define PS_STATE_MASK           (0x0F)
  85 #define PS_STATE_HW_MASK        (0x07)
  86 #define         PS_SEQ_MASK             (0xc0)
  87
  88 #define PS_STATE(x)                     (PS_STATE_MASK & (x))
  89 #define PS_STATE_HW(x)  (PS_STATE_HW_MASK & (x))
  90 #define PS_SEQ(x)                       (PS_SEQ_MASK & (x))
  91
  92 #define PS_STATE_S0             (PS_DPS)
  93 #define         PS_STATE_S1             (PS_LCLK)
  94 #define PS_STATE_S2             (PS_RF_OFF)
  95 #define         PS_STATE_S3             (PS_ALL_ON)
  96 #define PS_STATE_S4             ((PS_ST_ACTIVE) | (PS_ALL_ON))
  97
  98
  99 #define         PS_IS_RF_ON(x)          ((x) & (PS_ALL_ON))
 100 #define         PS_IS_ACTIVE(x)         ((x) & (PS_ST_ACTIVE))
 101 #define         CLR_PS_STATE(x) ((x) = ((x) & (0xF0)))
 102
 103
 104 struct reportpwrstate_parm {
 105         unsigned char mode;
 106         unsigned char state; /* the CPWM value */
 107         unsigned short rsvd;
 108 };
 109
 110 static inline void _enter_pwrlock(struct semaphore *plock)
 111 {
 112         _down_sema(plock);
 113 }
 114
 115 struct  pwrctrl_priv {
 116         struct semaphore lock;
 117         /*volatile*/ u8 rpwm; /* requested power state for fw */
 118         /* fw current power state. updated when 1. read from HCPWM or
 119          * 2. driver lowers power level */
 120         /*volatile*/ u8 cpwm;
 121         /*volatile*/ u8 tog; /* toggling */
 122         /*volatile*/ u8 cpwm_tog; /* toggling */
 123         /*volatile*/ u8 tgt_rpwm; /* wanted power state */
 124         uint pwr_mode;
 125         uint smart_ps;
 126         uint alives;
 127         uint ImrContent;        /* used to store original imr. */
 128         uint bSleep; /* sleep -> active is different from active -> sleep. */
 129
 130         _workitem SetPSModeWorkItem;
 131         _workitem rpwm_workitem;
 132         struct timer_list rpwm_check_timer;
 133         u8      rpwm_retry;
 134         uint    bSetPSModeWorkItemInProgress;
 135
 136         struct semaphore pnp_pwr_mgnt_sema;
 137         spinlock_t pnp_pwr_mgnt_lock;
 138         s32     pnp_current_pwr_state;
 139         u8      pnp_bstop_trx;
 140         u8      pnp_wwirp_pending;
 141 };
 142
 143 void r8712_init_pwrctrl_priv(struct _adapter *adapter);
 144 sint r8712_register_cmd_alive(struct _adapter *padapter);
 145 void r8712_unregister_cmd_alive(struct _adapter *padapter);
 146 void r8712_cpwm_int_hdl(struct _adapter *padapter,
 147                         struct reportpwrstate_parm *preportpwrstate);
 148 void r8712_set_ps_mode(struct _adapter *padapter, uint ps_mode,
 149                         uint smart_ps);
 150 void r8712_set_rpwm(struct _adapter *padapter, u8 val8);
 151
 152 #endif  /* __RTL871X_PWRCTRL_H_ */