1 /******************************************************************************
3 * Copyright(c) 2007 - 2012 Realtek Corporation. All rights reserved.
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.
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
14 ******************************************************************************/
15 #ifndef __RTW_PWRCTRL_H_
16 #define __RTW_PWRCTRL_H_
34 #define XMIT_ALIVE BIT(0)
35 #define RECV_ALIVE BIT(1)
36 #define CMD_ALIVE BIT(2)
37 #define EVT_ALIVE BIT(3)
38 #define BTCOEX_ALIVE BIT(4)
46 PS_MODE_DTIM , /* PS_MODE_SELF_DEFINED */
57 #ifdef CONFIG_PNO_SUPPORT
58 #define MAX_PNO_LIST_COUNT 16
59 #define MAX_SCAN_LIST_COUNT 14 /* 2.4G only */
64 BIT[3] = Protocol PS state, 0: register active state , 1: register sleep state
69 #define PS_LCLK (PS_DPS)
70 #define PS_RF_OFF BIT(1)
71 #define PS_ALL_ON BIT(2)
72 #define PS_ST_ACTIVE BIT(3)
74 #define PS_ISR_ENABLE BIT(4)
75 #define PS_IMR_ENABLE BIT(5)
77 #define PS_TOGGLE BIT(7)
79 #define PS_STATE_MASK (0x0F)
80 #define PS_STATE_HW_MASK (0x07)
81 #define PS_SEQ_MASK (0xc0)
83 #define PS_STATE(x) (PS_STATE_MASK & (x))
84 #define PS_STATE_HW(x) (PS_STATE_HW_MASK & (x))
85 #define PS_SEQ(x) (PS_SEQ_MASK & (x))
87 #define PS_STATE_S0 (PS_DPS)
88 #define PS_STATE_S1 (PS_LCLK)
89 #define PS_STATE_S2 (PS_RF_OFF)
90 #define PS_STATE_S3 (PS_ALL_ON)
91 #define PS_STATE_S4 ((PS_ST_ACTIVE) | (PS_ALL_ON))
94 #define PS_IS_RF_ON(x) ((x) & (PS_ALL_ON))
95 #define PS_IS_ACTIVE(x) ((x) & (PS_ST_ACTIVE))
96 #define CLR_PS_STATE(x) ((x) = ((x) & (0xF0)))
99 struct reportpwrstate_parm {
101 unsigned char state; /* the CPWM value */
106 typedef _sema _pwrlock;
109 #define LPS_DELAY_TIME 1*HZ /* 1 sec */
111 #define EXE_PWR_NONE 0x01
112 #define EXE_PWR_IPS 0x02
113 #define EXE_PWR_LPS 0x04
116 enum rt_rf_power_state {
117 rf_on, /* RF is on after RFSleep or RFOff */
118 rf_sleep, /* 802.11 Power Save mode */
119 rf_off, /* HW/SW Radio OFF or Inactive Power Save */
120 /* Add the new RF state above this line ===== */
124 /* RF Off Level for IPS or HW/SW radio off */
125 #define RT_RF_OFF_LEVL_ASPM BIT(0) /* PCI ASPM */
126 #define RT_RF_OFF_LEVL_CLK_REQ BIT(1) /* PCI clock request */
127 #define RT_RF_OFF_LEVL_PCI_D3 BIT(2) /* PCI D3 mode */
128 #define RT_RF_OFF_LEVL_HALT_NIC BIT(3) /* NIC halt, re-initialize hw parameters */
129 #define RT_RF_OFF_LEVL_FREE_FW BIT(4) /* FW free, re-download the FW */
130 #define RT_RF_OFF_LEVL_FW_32K BIT(5) /* FW in 32k */
131 #define RT_RF_PS_LEVEL_ALWAYS_ASPM BIT(6) /* Always enable ASPM and Clock Req in initialization. */
132 #define RT_RF_LPS_DISALBE_2R BIT(30) /* When LPS is on, disable 2R if no packet is received or transmittd. */
133 #define RT_RF_LPS_LEVEL_ASPM BIT(31) /* LPS with ASPM */
135 #define RT_IN_PS_LEVEL(ppsc, _PS_FLAG) ((ppsc->cur_ps_level & _PS_FLAG) ? true : false)
136 #define RT_CLEAR_PS_LEVEL(ppsc, _PS_FLAG) (ppsc->cur_ps_level &= (~(_PS_FLAG)))
137 #define RT_SET_PS_LEVEL(ppsc, _PS_FLAG) (ppsc->cur_ps_level |= _PS_FLAG)
139 /* ASPM OSC Control bit, added by Roger, 2013.03.29. */
140 #define RT_PCI_ASPM_OSC_IGNORE 0 /* PCI ASPM ignore OSC control in default */
141 #define RT_PCI_ASPM_OSC_ENABLE BIT0 /* PCI ASPM controlled by OS according to ACPI Spec 5.0 */
142 #define RT_PCI_ASPM_OSC_DISABLE BIT1 /* PCI ASPM controlled by driver or BIOS, i.e., force enable ASPM */
145 enum _PS_BBRegBackup_ {
153 enum { /* for ips_mode */
160 /* Design for pwrctrl_priv.ips_deny, 32 bits for 32 reasons at most */
161 enum PS_DENY_REASON {
162 PS_DENY_DRV_INITIAL = 0,
169 PS_DENY_DRV_REMOVE = 30,
173 #ifdef CONFIG_PNO_SUPPORT
174 typedef struct pno_nlo_info
176 u32 fast_scan_period; /* Fast scan period */
177 u32 ssid_num; /* number of entry */
178 u32 slow_scan_period; /* slow scan period */
179 u32 fast_scan_iterations; /* Fast scan iterations */
180 u8 ssid_length[MAX_PNO_LIST_COUNT]; /* SSID Length Array */
181 u8 ssid_cipher_info[MAX_PNO_LIST_COUNT]; /* Cipher information for security */
182 u8 ssid_channel_info[MAX_PNO_LIST_COUNT]; /* channel information */
185 typedef struct pno_ssid {
190 typedef struct pno_ssid_list {
191 pno_ssid_t node[MAX_PNO_LIST_COUNT];
194 typedef struct pno_scan_channel_info
199 u8 active; /* set 1 means active scan, or pasivite scan. */
200 }pno_scan_channel_info_t;
202 typedef struct pno_scan_info
204 u8 enableRFE; /* Enable RFE */
205 u8 period_scan_time; /* exclusive with fast_scan_period and slow_scan_period */
206 u8 periodScan; /* exclusive with fast_scan_period and slow_scan_period */
207 u8 orig_80_offset; /* original channel 80 offset */
208 u8 orig_40_offset; /* original channel 40 offset */
209 u8 orig_bw; /* original bandwidth */
210 u8 orig_ch; /* original channel */
211 u8 channel_num; /* number of channel */
212 u64 rfe_type; /* rfe_type && 0x00000000000000ff */
213 pno_scan_channel_info_t ssid_channel_info[MAX_SCAN_LIST_COUNT];
215 #endif /* CONFIG_PNO_SUPPORT */
220 _pwrlock check_32k_lock;
221 volatile u8 rpwm; /* requested power state for fw */
222 volatile u8 cpwm; /* fw current power state. updated when 1. read from HCPWM 2. driver lowers power level */
223 volatile u8 tog; /* toggling */
224 volatile u8 cpwm_tog; /* toggling */
232 _workitem cpwm_event;
234 _workitem rpwmtimeoutwi;
235 _timer pwr_rpwm_timer;
236 u8 bpower_saving; /* for LPS/IPS */
240 u8 reg_pdnmode; /* powerdown mode */
252 u8 ips_mode_req; /* used to accept the mode setting request, will update to ipsmode later */
253 uint bips_processing;
254 unsigned long ips_deny_time; /* will deny IPS when system time is smaller than this */
255 u8 pre_ips_type;/* 0: default flow, 1: carddisbale flow */
257 /* ps_deny: if 0, power save is free to go; otherwise deny all kinds of power save. */
258 /* Use PS_DENY_REASON to decide reason. */
259 /* Don't access this variable directly without control function, */
260 /* and this variable should be protected by lock. */
263 u8 ps_processing; /* temporarily used to mark whether in rtw_ps_processor */
265 u8 fw_psmode_iface_id;
270 u8 bFwCurrentInPSMode;
271 unsigned long DelayLPSLastTimeStamp;
272 s32 pnp_current_pwr_state;
276 u8 bInternalAutoSuspend;
282 u8 bSupportRemoteWakeup;
283 u8 wowlan_wake_reason;
290 u8 wowlan_pattern_idx;
291 u8 wowlan_pno_enable;
292 #ifdef CONFIG_PNO_SUPPORT
295 pno_nlo_info_t *pnlo_info;
296 pno_scan_info_t *pscan_info;
297 pno_ssid_list_t *pno_ssid_list;
299 u32 wowlan_pattern_context[8][5];
301 #endif /* CONFIG_WOWLAN */
302 _timer pwr_state_check_timer;
303 int pwr_state_check_interval;
304 u8 pwr_state_check_cnts;
306 int ps_flag; /* used by autosuspend */
308 enum rt_rf_power_state rf_pwrstate;/* cur power state, only for IPS */
309 /* rt_rf_power_state current_rfpwrstate; */
310 enum rt_rf_power_state change_rfpwrstate;
312 u8 bHWPowerdown; /* power down mode selection. 0:radio off, 1:power down */
313 u8 bHWPwrPindetect; /* come from registrypriv.hwpwrp_detect. enable power down function. 0:disable, 1:enable */
316 unsigned long PS_BBRegBackup[PSBBREG_TOTALCNT];
319 #define rtw_get_ips_mode_req(pwrctl) \
320 (pwrctl)->ips_mode_req
322 #define rtw_ips_mode_req(pwrctl, ips_mode) \
323 (pwrctl)->ips_mode_req = (ips_mode)
325 #define RTW_PWR_STATE_CHK_INTERVAL 2000
327 #define _rtw_set_pwr_state_check_timer(pwrctl, ms) \
329 /*DBG_871X("%s _rtw_set_pwr_state_check_timer(%p, %d)\n", __func__, (pwrctl), (ms));*/ \
330 _set_timer(&(pwrctl)->pwr_state_check_timer, (ms)); \
333 #define rtw_set_pwr_state_check_timer(pwrctl) \
334 _rtw_set_pwr_state_check_timer((pwrctl), (pwrctl)->pwr_state_check_interval)
336 extern void rtw_init_pwrctrl_priv(struct adapter *adapter);
337 extern void rtw_free_pwrctrl_priv(struct adapter * adapter);
339 s32 rtw_register_task_alive(struct adapter *, u32 task);
340 void rtw_unregister_task_alive(struct adapter *, u32 task);
341 extern s32 rtw_register_tx_alive(struct adapter *padapter);
342 extern void rtw_unregister_tx_alive(struct adapter *padapter);
343 extern s32 rtw_register_cmd_alive(struct adapter *padapter);
344 extern void rtw_unregister_cmd_alive(struct adapter *padapter);
345 extern void cpwm_int_hdl(struct adapter *padapter, struct reportpwrstate_parm *preportpwrstate);
346 extern void LPS_Leave_check(struct adapter *padapter);
348 extern void LeaveAllPowerSaveMode(struct adapter * Adapter);
349 extern void LeaveAllPowerSaveModeDirect(struct adapter * Adapter);
350 void _ips_enter(struct adapter *padapter);
351 void ips_enter(struct adapter *padapter);
352 int _ips_leave(struct adapter *padapter);
353 int ips_leave(struct adapter *padapter);
355 void rtw_ps_processor(struct adapter *padapter);
357 s32 LPS_RF_ON_check(struct adapter *padapter, u32 delay_ms);
358 void LPS_Enter(struct adapter *padapter, const char *msg);
359 void LPS_Leave(struct adapter *padapter, const char *msg);
360 void traffic_check_for_leave_lps(struct adapter *padapter, u8 tx, u32 tx_packets);
361 void rtw_set_ps_mode(struct adapter *padapter, u8 ps_mode, u8 smart_ps, u8 bcn_ant_mode, const char *msg);
362 void rtw_set_rpwm(struct adapter *padapter, u8 val8);
364 void rtw_set_ips_deny(struct adapter *padapter, u32 ms);
365 int _rtw_pwr_wakeup(struct adapter *padapter, u32 ips_deffer_ms, const char *caller);
366 #define rtw_pwr_wakeup(adapter) _rtw_pwr_wakeup(adapter, RTW_PWR_STATE_CHK_INTERVAL, __func__)
367 #define rtw_pwr_wakeup_ex(adapter, ips_deffer_ms) _rtw_pwr_wakeup(adapter, ips_deffer_ms, __func__)
368 int rtw_pm_set_ips(struct adapter *padapter, u8 mode);
369 int rtw_pm_set_lps(struct adapter *padapter, u8 mode);
371 void rtw_ps_deny(struct adapter *padapter, enum PS_DENY_REASON reason);
372 void rtw_ps_deny_cancel(struct adapter *padapter, enum PS_DENY_REASON reason);
373 u32 rtw_ps_deny_get(struct adapter *padapter);
375 #endif /* __RTL871X_PWRCTRL_H_ */