2025-05-10 21:58:58 +08:00

347 lines
8.3 KiB
C

/******************************************************************************
*
* Copyright(c)2019 Realtek Corporation.
*
* This program is free software; you can redistribute it and/or modify it
* under the terms of version 2 of the GNU General Public License as
* published by the Free Software Foundation.
*
* This program is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
* more details.
*
*****************************************************************************/
#ifndef _PHL_WOW_DEF_H_
#define _PHL_WOW_DEF_H_
enum rtw_wow_op_mode {
RTW_WOW_OP_NONE = 0,
RTW_WOW_OP_PWR_DOWN,
RTW_WOW_OP_DISCONNECT_STBY,
RTW_WOW_OP_CONNECT_STBY,
RTW_WOW_OP_MAX = 0xF
};
enum rtw_wow_wake_reason {
RTW_WOW_RSN_UNKNOWN = 0,
RTW_WOW_RSN_RX_PAIRWISEKEY,
RTW_WOW_RSN_RX_GTK,
RTW_WOW_RSN_RX_FOURWAY_HANDSHAKE,
RTW_WOW_RSN_RX_DISASSOC,
RTW_WOW_RSN_RX_DEAUTH, /* 5 */
RTW_WOW_RSN_RX_ARP_REQUEST,
RTW_WOW_RSN_RX_NS,
RTW_WOW_RSN_RX_EAPREQ_IDENTIFY,
RTW_WOW_RSN_FW_DECISION_DISCONNECT,
RTW_WOW_RSN_RX_MAGIC_PKT, /* 10 */
RTW_WOW_RSN_RX_UNICAST_PKT,
RTW_WOW_RSN_RX_PATTERN_PKT,
RTW_WOW_RSN_RTD3_SSID_MATCH,
RTW_WOW_RSN_RX_DATA_PKT,
RTW_WOW_RSN_RX_SSDP_MATCH, /* 15 */
RTW_WOW_RSN_RX_WSD_MATCH,
RTW_WOW_RSN_RX_SLP_MATCH,
RTW_WOW_RSN_RX_LLTD_MATCH,
RTW_WOW_RSN_RX_MDNS_MATCH,
RTW_WOW_RSN_RX_REALWOW_V2_WAKEUP_PKT, /* 20 */
RTW_WOW_RSN_RX_REALWOW_V2_ACK_LOST,
RTW_WOW_RSN_RX_REALWOW_V2_TX_KAPKT,
RTW_WOW_RSN_ENABLE_FAIL_DMA_IDLE,
RTW_WOW_RSN_ENABLE_FAIL_DMA_PAUSE,
RTW_WOW_RSN_RTIME_FAIL_DMA_IDLE, /* 25 */
RTW_WOW_RSN_RTIME_FAIL_DMA_PAUSE,
RTW_WOW_RSN_RX_SNMP_MISMATCHED_PKT,
RTW_WOW_RSN_RX_DESIGNATED_MAC_PKT,
RTW_WOW_RSN_NLO_SSID_MACH,
RTW_WOW_RSN_AP_OFFLOAD_WAKEUP, /* 30 */
RTW_WOW_RSN_DMAC_ERROR_OCCURRED,
RTW_WOW_RSN_EXCEPTION_OCCURRED,
RTW_WOW_RSN_L0_TO_L1_ERROR_OCCURRED,
RTW_WOW_RSN_ASSERT_OCCURRED,
RTW_WOW_RSN_L2_ERROR_OCCURRED, /* 35 */
RTW_WOW_RSN_WDT_TIMEOUT_WAKE,
RTW_WOW_RSN_RX_ACTION,
RTW_WOW_RSN_CLK_32K_UNLOCK,
RTW_WOW_RSN_CLK_32K_LOCK,
RTW_WOW_RSN_MAX = 0xFF
};
struct rtw_keep_alive_info {
/* core */
u8 keep_alive_en;
u8 keep_alive_period;
/* phl/hal */
u8 null_pkt_id;
};
struct rtw_disc_det_info {
/* core */
u8 disc_det_en;
u8 disc_wake_en;
u8 try_pkt_count;
u8 check_period;
u8 cnt_bcn_lost_en;
u8 cnt_bcn_lost_limit;
};
#define MAX_NLO_NUM 10
#define MAX_SSID_LEN 32
#define MAX_NLO_CHANNEL 40
struct rtw_nlo_info {
u8 nlo_en;
u8 num_of_networks;
u8 num_of_hidden_ap;
u8 ssid[MAX_NLO_NUM][MAX_SSID_LEN];
u8 ssidlen[MAX_NLO_NUM];
u8 chipertype[MAX_NLO_NUM];
u8 probe_req_id;
struct scan_ofld_ch_info channel_list[MAX_NLO_CHANNEL];
u8 channel_num;
u32 delay; /* ms */
u32 period; /* ms */
u8 cycle;
u32 slow_period; /* ms */
void (* construct_pbreq)(void *priv, u8 *pkt_buf, u16 *len);
};
struct rtw_arp_ofld_content {
u8 arp_en;
u8 remote_ipv4_addr[IPV4_ADDRESS_LENGTH];
u8 host_ipv4_addr[IPV4_ADDRESS_LENGTH];
u8 mac_addr[MAC_ADDRESS_LENGTH];
};
struct rtw_arp_ofld_info {
u8 arp_en;
u8 arp_action; /* 0 = send arp response, 1 = wake up host */
u8 arp_rsp_id;
struct rtw_arp_ofld_content arp_ofld_content;
};
struct rtw_ndp_ofld_content {
u8 ndp_en;
u8 chk_remote_ip;
u8 num_target_ip;
u8 mac_addr[MAC_ADDRESS_LENGTH];
u8 remote_ipv6_addr[IPV6_ADDRESS_LENGTH];
u8 target_ipv6_addr[2][IPV6_ADDRESS_LENGTH];
};
struct rtw_ndp_ofld_info {
u8 ndp_en;
u8 ndp_id;
struct rtw_ndp_ofld_content ndp_ofld_content[2];
};
struct rtw_gtk_ofld_content {
u8 kck[32];
u32 kck_len;
u8 kek[32];
u32 kek_len;
u8 tk1[16];
u8 txmickey[8];
u8 rxmickey[8];
u8 replay_cnt[8];
u8 igtk_keyid[4];
u8 ipn[8];
u8 igtk[2][32];
u8 igtk_len;
u8 psk[32];
u8 psk_len;
};
struct rtw_gtk_ofld_info {
/* core */
u8 gtk_en;
u8 tkip_en;
u8 ieee80211w_en;
u8 pairwise_wakeup;
u8 bip_sec_algo;
u8 akmtype_byte3;
struct rtw_gtk_ofld_content gtk_ofld_content;
/* phl */
u8 hw_11w_en; /* keep 1 for BIP-CMAC-128 so far */
u8 gtk_rsp_id; /* eapol pkt id */
u8 sa_query_id;
};
#define MAX_WOW_PATTERN_SIZE_BIT 128
#define MAX_WOW_PATTERN_SIZE_BYTE 16
#define MAX_WOW_PATTERN_SIZE_DWORD 4
struct rtw_wowcam_upd_info {
u8 rw;
u8 wow_cam_idx;
u32 wake_mask[4];
u16 match_crc;
u8 is_negative_pattern_match;
u8 skip_mac_hdr;
u8 uc;
u8 mc;
u8 bc;
u8 valid;
u8 ptrn[MAX_WOW_PATTERN_SIZE_BIT];
u32 ptrn_len;
u8 mask[MAX_WOW_PATTERN_SIZE_BYTE];
};
#define MAX_WOW_CAM_NUM 18
struct rtw_pattern_match_info{
struct rtw_wowcam_upd_info wowcam_info[MAX_WOW_CAM_NUM];
};
#define MAX_REALWOW_KCP_SIZE 124 /* (100 + 24) */
#define MAX_REALWOW_PAYLOAD 64
struct rtw_realwow_ofld_content {
u16 interval; /* unit : 1 ms */
u16 keep_alive_pkt_size;
u16 ack_lost_limit;
u16 ack_ptrn_size;
u16 wakeup_ptrn_size;
u16 keep_alive_pkt_ptrn[MAX_REALWOW_KCP_SIZE];
u8 ack_ptrn[MAX_REALWOW_PAYLOAD];
u8 wakeup_ptrn[MAX_REALWOW_PAYLOAD];
u32 wakeup_sec_num;
};
struct rtw_realwow_info {
u8 realwow_en;
u8 auto_wakeup;
u8 keepalive_id;
u8 wakeup_pattern_id;
u8 ack_pattern_id;
struct rtw_realwow_ofld_content realwow_ofld_content;
};
struct rtw_dev2hst_gpio_info {
/* dword0 */
u32 dev2hst_gpio_en:1;
u32 disable_inband:1;
u32 gpio_output_input:1;
u32 gpio_active:1;
u32 toggle_pulse:1;
u32 data_pin_wakeup:1;
u32 gpio_pulse_nonstop:1;
u32 gpio_time_unit:1;
u32 gpio_num:8;
u32 gpio_pulse_dura:8;
u32 gpio_pulse_period:8;
/* dword1 */
u32 gpio_pulse_count:8;
u32 rsvd0:24;
/* dword2 */
u32 customer_id:8;
u32 rsvd1:24;
/* dword3 */
u32 rsn_a_en:1;
u32 rsn_a_toggle_pulse:1;
u32 rsn_a_pulse_nonstop:1;
u32 rsn_a_time_unit:1;
u32 rsvd2:28;
/* dword4 */
u32 rsn_a:8;
u32 rsn_a_pulse_duration:8;
u32 rsn_a_pulse_period:8;
u32 rsn_a_pulse_count:8;
/* dword5 */
u32 rsn_b_en:1;
u32 rsn_b_toggle_pulse:1;
u32 rsn_b_pulse_nonstop:1;
u32 rsn_b_time_unit:1;
u32 rsvd3:28;
/* dword6 */
u32 rsn_b:8;
u32 rsn_b_pulse_duration:8;
u32 rsn_b_pulse_period:8;
u32 rsn_b_pulse_count:8;
};
struct rtw_wow_gpio_info {
struct rtw_dev2hst_gpio_info d2h_gpio_info;
enum rtw_gpio_mode dev2hst_gpio_mode;
u8 dev2hst_gpio;
u8 dev2hst_high;
};
struct rtw_remote_wake_ctrl_info {
/* core */
u8 ptk_tx_iv[IV_LENGTH];
u8 valid_check;
u8 symbol_check_en;
u8 gtk_key_idx;
u8 ptk_rx_iv[IV_LENGTH];
u8 gtk_rx_iv_idx0[IV_LENGTH];
u8 gtk_rx_iv_idx1[IV_LENGTH];
u8 gtk_rx_iv_idx2[IV_LENGTH];
u8 gtk_rx_iv_idx3[IV_LENGTH];
};
struct rtw_wow_wake_info {
/* core */
u8 wow_en;
u8 drop_all_pkt;
u8 rx_parse_after_wake;
u8 pairwise_sec_algo;
u8 group_sec_algo;
u8 bip_sec_algo;
u8 pattern_match_en;
u8 magic_pkt_en;
u8 hw_unicast_en;
u8 fw_unicast_en;
u8 deauth_wakeup;
u8 rekey_wakeup;
u8 eap_wakeup;
u8 all_data_wakeup;
struct rtw_remote_wake_ctrl_info remote_wake_ctrl_info;
};
struct rtw_aoac_report {
/* status check */
u8 rpt_fail;
/* report from fw */
u8 rpt_ver;
u8 sec_type;
u8 key_idx;
u8 pattern_idx;
u8 rekey_ok;
u8 ptk_tx_iv[IV_LENGTH];
u8 eapol_key_replay_count[8];
u8 gtk[32];
u8 ptk_rx_iv[IV_LENGTH];
u8 gtk_rx_iv[4][IV_LENGTH];
u8 igtk_key_id[8];
u8 igtk_ipn[8];
u8 igtk[32];
};
#ifdef CONFIG_WOWLAN
/* Exported APIs to core */
enum rtw_phl_status rtw_phl_cfg_keep_alive_info(void *phl, struct rtw_keep_alive_info *info);
enum rtw_phl_status rtw_phl_cfg_disc_det_info(void *phl, struct rtw_disc_det_info *info);
void rtw_phl_cfg_nlo_info(void *phl, struct rtw_nlo_info *info);
void rtw_phl_cfg_arp_ofld_info(void *phl, struct rtw_arp_ofld_info *info);
void rtw_phl_cfg_ndp_ofld_info(void *phl, struct rtw_ndp_ofld_info *info);
enum rtw_phl_status rtw_phl_remove_wow_ptrn_info(void *phl, u8 phl_ptrn_id);
enum rtw_phl_status rtw_phl_add_wow_ptrn_info(void *phl, struct rtw_wowcam_upd_info *info, u8 *phl_ptrn_id);
enum rtw_phl_status rtw_phl_cfg_gtk_ofld_info(void *phl, struct rtw_gtk_ofld_info *info);
enum rtw_phl_status rtw_phl_cfg_realwow_info(void *phl, struct rtw_realwow_info *info);
enum rtw_phl_status rtw_phl_cfg_wow_wake(void *phl, struct rtw_wow_wake_info *info);
enum rtw_phl_status rtw_phl_cfg_gpio_wake_pulse(void *phl, struct rtw_wow_gpio_info *info);
const char *rtw_phl_get_wow_rsn_str(void *phl, enum rtw_wow_wake_reason wake_rsn);
enum rtw_phl_status rtw_phl_cfg_wow_set_sw_gpio_mode(void *phl, struct rtw_wow_gpio_info *info);
enum rtw_phl_status rtw_phl_cfg_wow_sw_gpio_ctrl(void *phl, struct rtw_wow_gpio_info *info);
#endif /* CONFIG_WOWLAN */
#endif /* _PHL_WOW_DEF_H_ */