/* * Copyright (C) 2017 The Android Open Source Project * * Portions copyright (C) 2017 Broadcom Limited * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "wifi_hal.h" #ifndef __WIFI_HAL_COMMON_H__ #define __WIFI_HAL_COMMON_H__ #define LOG_TAG "WifiHAL" #include #include "nl80211_copy.h" #include "sync.h" #define SOCKET_BUFFER_SIZE (32768U) #define RECV_BUF_SIZE (4096) #define DEFAULT_EVENT_CB_SIZE (64) #define DEFAULT_CMD_SIZE (64) #define DOT11_OUI_LEN 3 #define DOT11_MAX_SSID_LEN 32 #define ETHERTYPE_IP 0x0800 /* IP */ #define ETHERTYPE_IPV6 0x86dd /* IP protocol version 6 */ #define MAX_PROBE_RESP_IE_LEN 2048 /* Vendor OUI - This is a unique identifier that identifies organization. Lets code Android specific functions with Google OUI; although vendors can do more with their own OUI's as well. */ const uint32_t GOOGLE_OUI = 0x001A11; const uint32_t BRCM_OUI = 0x001018; /* TODO: define vendor OUI here */ #define MAC2STR(a) (a)[0], (a)[1], (a)[2], (a)[3], (a)[4], (a)[5] #define MACSTR "%02x:%02x:%02x:%02x:%02x:%02x" #define NMR2STR(a) (a)[0], (a)[1], (a)[2], (a)[3], (a)[4], (a)[5], (a)[6], (a)[7] #define NMRSTR "%02x:%02x:%02x:%02x:%02x:%02x:%02x:%02x" #define NAN_MASTER_RANK_LEN 8 #define SAR_CONFIG_SCENARIO_COUNT 100 /* This enum defines ranges for various commands; commands themselves can be defined in respective feature headers; i.e. find gscan command definitions in gscan.cpp */ typedef int (*nl_recvmsg_msg_cb_t)(struct nl_msg *msg, void *arg); typedef enum { /* don't use 0 as a valid subcommand */ VENDOR_NL80211_SUBCMD_UNSPECIFIED, /* define all vendor startup commands between 0x0 and 0x0FFF */ VENDOR_NL80211_SUBCMD_RANGE_START = 0x0001, VENDOR_NL80211_SUBCMD_RANGE_END = 0x0FFF, /* define all GScan related commands between 0x1000 and 0x10FF */ ANDROID_NL80211_SUBCMD_GSCAN_RANGE_START = 0x1000, ANDROID_NL80211_SUBCMD_GSCAN_RANGE_END = 0x10FF, /* define all NearbyDiscovery related commands between 0x1100 and 0x11FF */ ANDROID_NL80211_SUBCMD_NBD_RANGE_START = 0x1100, ANDROID_NL80211_SUBCMD_NBD_RANGE_END = 0x11FF, /* define all RTT related commands between 0x1100 and 0x11FF */ ANDROID_NL80211_SUBCMD_RTT_RANGE_START = 0x1100, ANDROID_NL80211_SUBCMD_RTT_RANGE_END = 0x11FF, ANDROID_NL80211_SUBCMD_LSTATS_RANGE_START = 0x1200, ANDROID_NL80211_SUBCMD_LSTATS_RANGE_END = 0x12FF, /* define all Logger related commands between 0x1400 and 0x14FF */ ANDROID_NL80211_SUBCMD_DEBUG_RANGE_START = 0x1400, ANDROID_NL80211_SUBCMD_DEBUG_RANGE_END = 0x14FF, /* define all wifi offload related commands between 0x1600 and 0x16FF */ ANDROID_NL80211_SUBCMD_WIFI_OFFLOAD_RANGE_START = 0x1600, ANDROID_NL80211_SUBCMD_WIFI_OFFLOAD_RANGE_END = 0x16FF, /* define all NAN related commands between 0x1700 and 0x17FF */ ANDROID_NL80211_SUBCMD_NAN_RANGE_START = 0x1700, ANDROID_NL80211_SUBCMD_NAN_RANGE_END = 0x17FF, /* define all Android Packet Filter related commands between 0x1800 and 0x18FF */ ANDROID_NL80211_SUBCMD_PKT_FILTER_RANGE_START = 0x1800, ANDROID_NL80211_SUBCMD_PKT_FILTER_RANGE_END = 0x18FF, /* define all tx power related commands between 0x1900 and 0x1910 */ ANDROID_NL80211_SUBCMD_TX_POWER_RANGE_START = 0x1900, ANDROID_NL80211_SUBCMD_TX_POWER_RANGE_END = 0x1910, /* define all thermal mode related commands between 0x1920 and 0x192F */ ANDROID_NL80211_SUBCMD_MITIGATION_RANGE_START = 0x1920, ANDROID_NL80211_SUBCMD_MITIGATION_RANGE_END = 0x192F, /* define all DSCP related commands between 0x2000 and 0x20FF */ ANDROID_NL80211_SUBCMD_DSCP_RANGE_START = 0x2000, ANDROID_NL80211_SUBCMD_DSCP_RANGE_END = 0x20FF, /* define all Channel Avoidance related commands between 0x2100 and 0x211F */ ANDROID_NL80211_SUBCMD_CHAVOID_RANGE_START = 0x2100, ANDROID_NL80211_SUBCMD_CHAVOID_RANGE_END = 0x211F, /* define all OTA Download related commands between 0x2120 and 0x212F */ ANDROID_NL80211_SUBCMD_OTA_DOWNLOAD_START = 0x2120, ANDROID_NL80211_SUBCMD_OTA_DOWNLOAD_END = 0x212F, /* define all VOIP mode config related commands between 0x2130 and 0x213F */ ANDROID_NL80211_SUBCMD_VIOP_MODE_START = 0x2130, ANDROID_NL80211_SUBCMD_VIOP_MODE_END = 0x213F, /* define all TWT related commands between 0x2140 and 0x214F */ ANDROID_NL80211_SUBCMD_TWT_START = 0x2140, ANDROID_NL80211_SUBCMD_TWT_END = 0x214F, /* define all Usable Channel related commands between 0x2150 and 0x215F */ ANDROID_NL80211_SUBCMD_USABLE_CHANNEL_START = 0x2150, ANDROID_NL80211_SUBCMD_USABLE_CHANNEL_END = 0x215F, /* define all init/deinit related commands between 0x2160 and 0x216F */ ANDROID_NL80211_SUBCMD_INIT_DEINIT_RANGE_START = 0x2160, ANDROID_NL80211_SUBCMD_INIT_DEINIT_RANGE_END = 0x216F, /* This is reserved for future usage */ } ANDROID_VENDOR_SUB_COMMAND; typedef enum { GSCAN_SUBCMD_GET_CAPABILITIES = ANDROID_NL80211_SUBCMD_GSCAN_RANGE_START, GSCAN_SUBCMD_SET_CONFIG, /* 0x1001 */ GSCAN_SUBCMD_SET_SCAN_CONFIG, /* 0x1002 */ GSCAN_SUBCMD_ENABLE_GSCAN, /* 0x1003 */ GSCAN_SUBCMD_GET_SCAN_RESULTS, /* 0x1004 */ GSCAN_SUBCMD_SCAN_RESULTS, /* 0x1005 */ GSCAN_SUBCMD_SET_HOTLIST, /* 0x1006 */ GSCAN_SUBCMD_SET_SIGNIFICANT_CHANGE_CONFIG, /* 0x1007 */ GSCAN_SUBCMD_ENABLE_FULL_SCAN_RESULTS, /* 0x1008 */ GSCAN_SUBCMD_GET_CHANNEL_LIST, /* 0x1009 */ WIFI_SUBCMD_GET_FEATURE_SET, /* 0x100A */ WIFI_SUBCMD_GET_FEATURE_SET_MATRIX, /* 0x100B */ WIFI_SUBCMD_SET_PNO_RANDOM_MAC_OUI, /* 0x100C */ WIFI_SUBCMD_NODFS_SET, /* 0x100D */ WIFI_SUBCMD_SET_COUNTRY_CODE, /* 0x100E */ /* Add more sub commands here */ GSCAN_SUBCMD_SET_EPNO_SSID, /* 0x100F */ WIFI_SUBCMD_SET_SSID_WHITE_LIST, /* 0x1010 */ WIFI_SUBCMD_SET_ROAM_PARAMS, /* 0x1011 */ WIFI_SUBCMD_ENABLE_LAZY_ROAM, /* 0x1012 */ WIFI_SUBCMD_SET_BSSID_PREF, /* 0x1013 */ WIFI_SUBCMD_SET_BSSID_BLACKLIST, /* 0x1014 */ GSCAN_SUBCMD_ANQPO_CONFIG, /* 0x1015 */ WIFI_SUBCMD_SET_RSSI_MONITOR, /* 0x1016 */ WIFI_SUBCMD_CONFIG_ND_OFFLOAD, /* 0x1017 */ WIFI_SUBCMD_CONFIG_TCPACK_SUP, /* 0x1018 */ WIFI_SUBCMD_FW_ROAM_POLICY, /* 0x1019 */ WIFI_SUBCMD_ROAM_CAPABILITY, /* 0x101a */ WIFI_SUBCMD_SET_LATENCY_MODE, /* 0x101b */ WIFI_SUBCMD_SET_MULTISTA_PRIMARY_CONNECTION, /* 0x101c */ WIFI_SUBCMD_SET_MULTISTA_USE_CASE, /* 0x101d */ WIFI_SUBCMD_SET_DTIM_CONFIG, /* 0x101e */ GSCAN_SUBCMD_MAX, /* NAN related */ NAN_SUBCMD_ENABLE = ANDROID_NL80211_SUBCMD_NAN_RANGE_START, NAN_SUBCMD_DISABLE, /* 0x1701 */ NAN_SUBCMD_PUBLISH, /* 0x1702 */ NAN_SUBCMD_SUBSCRIBE, /* 0x1703 */ NAN_SUBCMD_PUBLISH_CANCEL, /* 0x1704 */ NAN_SUBCMD_SUBSCRIBE_CANCEL, /* 0x1705 */ NAN_SUBCMD_TRANSMIT_FOLLOWUP, /* 0x1706 */ NAN_SUBCMD_CONFIG, /* 0x1707 */ NAN_SUBCMD_TCA, /* 0x1708 */ NAN_SUBCMD_STATS, /* 0x1709 */ NAN_SUBCMD_GET_CAPABILITIES, /* 0x170A */ NAN_SUBCMD_DATA_PATH_IFACE_CREATE, /* 0x170B */ NAN_SUBCMD_DATA_PATH_IFACE_DELETE, /* 0x170C */ NAN_SUBCMD_DATA_PATH_REQUEST, /* 0x170D */ NAN_SUBCMD_DATA_PATH_RESPONSE, /* 0x170E */ NAN_SUBCMD_DATA_PATH_END, /* 0x170F */ NAN_SUBCMD_DATA_PATH_SEC_INFO, /* 0x1710 */ NAN_SUBCMD_VERSION_INFO, /* 0x1711 */ NAN_SUBCMD_ENABLE_MERGE, /* 0x1712 */ APF_SUBCMD_GET_CAPABILITIES = ANDROID_NL80211_SUBCMD_PKT_FILTER_RANGE_START, APF_SUBCMD_SET_FILTER, APF_SUBCMD_READ_FILTER, WIFI_SUBCMD_TX_POWER_SCENARIO = ANDROID_NL80211_SUBCMD_TX_POWER_RANGE_START, WIFI_SUBCMD_THERMAL_MITIGATION = ANDROID_NL80211_SUBCMD_MITIGATION_RANGE_START, DSCP_SUBCMD_SET_TABLE = ANDROID_NL80211_SUBCMD_DSCP_RANGE_START, DSCP_SUBCMD_RESET_TABLE, /* 0x2001 */ CHAVOID_SUBCMD_SET_CONFIG = ANDROID_NL80211_SUBCMD_CHAVOID_RANGE_START, TWT_SUBCMD_GETCAPABILITY = ANDROID_NL80211_SUBCMD_TWT_START, TWT_SUBCMD_SETUP_REQUEST, TWT_SUBCMD_TEAR_DOWN_REQUEST, TWT_SUBCMD_INFO_FRAME_REQUEST, TWT_SUBCMD_GETSTATS, TWT_SUBCMD_CLR_STATS, WIFI_SUBCMD_CONFIG_VOIP_MODE = ANDROID_NL80211_SUBCMD_VIOP_MODE_START, WIFI_SUBCMD_GET_OTA_CURRUNT_INFO = ANDROID_NL80211_SUBCMD_OTA_DOWNLOAD_START, WIFI_SUBCMD_OTA_UPDATE, WIFI_SUBCMD_USABLE_CHANNEL = ANDROID_NL80211_SUBCMD_USABLE_CHANNEL_START, WIFI_SUBCMD_TRIGGER_SSR = ANDROID_NL80211_SUBCMD_INIT_DEINIT_RANGE_START, } WIFI_SUB_COMMAND; typedef enum { BRCM_RESERVED1 = 0, BRCM_RESERVED2 = 1, GSCAN_EVENT_SIGNIFICANT_CHANGE_RESULTS = 2, GSCAN_EVENT_HOTLIST_RESULTS_FOUND = 3, GSCAN_EVENT_SCAN_RESULTS_AVAILABLE = 4, GSCAN_EVENT_FULL_SCAN_RESULTS = 5, RTT_EVENT_COMPLETE = 6, GSCAN_EVENT_COMPLETE_SCAN = 7, GSCAN_EVENT_HOTLIST_RESULTS_LOST = 8, GSCAN_EVENT_EPNO_EVENT = 9, GOOGLE_DEBUG_RING_EVENT = 10, GOOGLE_DEBUG_MEM_DUMP_EVENT = 11, GSCAN_EVENT_ANQPO_HOTSPOT_MATCH = 12, GOOGLE_RSSI_MONITOR_EVENT = 13, GOOGLE_MKEEP_ALIVE = 14, /* * BRCM specific events should be placed after the Generic events * in order to match between the DHD and HAL */ NAN_EVENT_ENABLED = 15, NAN_EVENT_DISABLED = 16, NAN_EVENT_SUBSCRIBE_MATCH = 17, NAN_EVENT_PUBLISH_REPLIED_IND = 18, NAN_EVENT_PUBLISH_TERMINATED = 19, NAN_EVENT_SUBSCRIBE_TERMINATED = 20, NAN_EVENT_DE_EVENT = 21, NAN_EVENT_FOLLOWUP = 22, NAN_EVENT_TRANSMIT_FOLLOWUP_IND = 23, NAN_EVENT_DATA_REQUEST = 24, NAN_EVENT_DATA_CONFIRMATION = 25, NAN_EVENT_DATA_END = 26, NAN_EVENT_BEACON = 27, NAN_EVENT_SDF = 28, NAN_EVENT_TCA = 29, NAN_EVENT_SUBSCRIBE_UNMATCH = 30, NAN_EVENT_UNKNOWN = 31, BRCM_VENDOR_EVENT_HANGED = 33, ROAM_EVENT_START, GOOGLE_FILE_DUMP_EVENT = 37, NAN_ASYNC_RESPONSE_DISABLED = 40, BRCM_VENDOR_EVENT_TWT = 43, BRCM_TPUT_DUMP_EVENT = 44, NAN_EVENT_MATCH_EXPIRY = 45 } WIFI_EVENT; typedef void (*wifi_internal_event_handler) (wifi_handle handle, int events); class WifiCommand; typedef struct { int nl_cmd; uint32_t vendor_id; int vendor_subcmd; nl_recvmsg_msg_cb_t cb_func; void *cb_arg; } cb_info; typedef struct { wifi_request_id id; WifiCommand *cmd; } cmd_info; typedef struct { wifi_handle handle; // handle to wifi data char name[IFNAMSIZ+1]; // interface name + trailing null int id; // id to use when talking to driver bool is_virtual; // mark each iface as virtual or static } interface_info; typedef struct { struct nl_sock *cmd_sock; // command socket object struct nl_sock *event_sock; // event socket object int nl80211_family_id; // family id for 80211 driver int cleanup_socks[2]; // sockets used to implement wifi_cleanup bool in_event_loop; // Indicates that event loop is active bool clean_up; // Indication to exit since cleanup has started wifi_internal_event_handler event_handler; // default event handler wifi_cleaned_up_handler cleaned_up_handler; // socket cleaned up handler cb_info *event_cb; // event callbacks int num_event_cb; // number of event callbacks int alloc_event_cb; // number of allocated callback objects pthread_mutex_t cb_lock; // mutex for the event_cb access cmd_info *cmd; // Outstanding commands int num_cmd; // number of commands int alloc_cmd; // number of commands allocated interface_info **interfaces; // array of interfaces int num_interfaces; // number of interfaces int max_num_interfaces; // max number of interfaces wifi_subsystem_restart_handler restart_handler; // trigger sub system handler // add other details } hal_info; #define PNO_SSID_FOUND 0x1 #define PNO_SSID_LOST 0x2 typedef struct wifi_pno_result { unsigned char ssid[DOT11_MAX_SSID_LEN]; unsigned char ssid_len; signed char rssi; u16 channel; u16 flags; mac_addr bssid; } wifi_pno_result_t; typedef struct wifi_gscan_result { u64 ts; // Time of discovery u8 ssid[DOT11_MAX_SSID_LEN+1]; // null terminated mac_addr bssid; // BSSID u32 channel; // channel frequency in MHz s32 rssi; // in db u64 rtt; // in nanoseconds u64 rtt_sd; // standard deviation in rtt u16 beacon_period; // units are Kusec u16 capability; // Capability information u32 pad; } wifi_gscan_result_t; typedef struct wifi_gscan_full_result { wifi_gscan_result_t fixed; u32 scan_ch_bucket; // scan chbucket bitmask u32 ie_length; // byte length of Information Elements u8 ie_data[1]; // IE data to follow } wifi_gscan_full_result_t; void twt_deinit_handler(); typedef enum { TWT_EVENT_INVALID = 0, TWT_SETUP_RESPONSE = 1, TWT_TEARDOWN_COMPLETION = 2, TWT_INFORM_FRAME = 3, TWT_NOTIFY = 4, TWT_EVENT_LAST } TwtEventType; typedef enum { TWT_INVALID = 0, TWT_SETUP_REQUEST = 1, TWT_INFO_FRAME_REQUEST = 2, TWT_TEAR_DOWN_REQUEST = 3, TWT_LAST } TwtRequestType; typedef enum { TWT_ATTRIBUTE_INVALID = 0, TWT_ATTRIBUTE_CONFIG_ID = 1, TWT_ATTRIBUTE_NEG_TYPE = 2, TWT_ATTRIBUTE_TRIGGER_TYPE = 3, TWT_ATTRIBUTE_WAKE_DUR_US = 4, TWT_ATTRIBUTE_WAKE_INT_US = 5, TWT_ATTRIBUTE_WAKE_INT_MIN_US = 6, TWT_ATTRIBUTE_WAKE_INT_MAX_US = 7, TWT_ATTRIBUTE_WAKE_DUR_MIN_US = 8, TWT_ATTRIBUTE_WAKE_DUR_MAX_US = 9, TWT_ATTRIBUTE_AVG_PKT_SIZE = 10, TWT_ATTRIBUTE_AVG_PKT_NUM = 11, TWT_ATTRIBUTE_WAKE_TIME_OFF_US = 12, TWT_ATTRIBUTE_ALL_TWT = 13, TWT_ATTRIBUTE_RESUME_TIME_US = 14, TWT_ATTRIBUTE_AVG_EOSP_DUR = 15, TWT_ATTRIBUTE_EOSP_COUNT = 16, TWT_ATTRIBUTE_NUM_SP = 17, TWT_ATTRIBUTE_DEVICE_CAP = 18, TWT_ATTRIBUTE_PEER_CAP = 19, TWT_ATTRIBUTE_STATUS = 20, TWT_ATTRIBUTE_REASON_CODE = 21, TWT_ATTRIBUTE_RESUMED = 22, TWT_ATTRIBUTE_NOTIFICATION = 23, TWT_ATTRIBUTE_SUB_EVENT = 24, TWT_ATTRIBUTE_NUM_PEER_STATS = 25, TWT_ATTRIBUTE_AVG_PKT_NUM_TX = 26, TWT_ATTRIBUTE_AVG_PKT_SIZE_TX = 27, TWT_ATTRIBUTE_AVG_PKT_NUM_RX = 28, TWT_ATTRIBUTE_AVG_PKT_SIZE_RX = 29, TWT_ATTRIBUTE_MAX } TWT_ATTRIBUTE; wifi_error wifi_register_handler(wifi_handle handle, int cmd, nl_recvmsg_msg_cb_t func, void *arg); wifi_error wifi_register_vendor_handler(wifi_handle handle, uint32_t id, int subcmd, nl_recvmsg_msg_cb_t func, void *arg); void wifi_unregister_handler(wifi_handle handle, int cmd); void wifi_unregister_vendor_handler_without_lock(wifi_handle handle, uint32_t id, int subcmd); void wifi_unregister_vendor_handler(wifi_handle handle, uint32_t id, int subcmd); wifi_error wifi_register_cmd(wifi_handle handle, int id, WifiCommand *cmd); WifiCommand *wifi_unregister_cmd(wifi_handle handle, int id); WifiCommand *wifi_get_cmd(wifi_handle handle, int id); void wifi_unregister_cmd(wifi_handle handle, WifiCommand *cmd); interface_info *getIfaceInfo(wifi_interface_handle); wifi_handle getWifiHandle(wifi_interface_handle handle); hal_info *getHalInfo(wifi_handle handle); hal_info *getHalInfo(wifi_interface_handle handle); wifi_handle getWifiHandle(hal_info *info); wifi_interface_handle getIfaceHandle(interface_info *info); wifi_error wifi_cancel_cmd(wifi_request_id id, wifi_interface_handle iface); wifi_error wifi_get_cancel_cmd(wifi_request_id id, wifi_interface_handle iface); wifi_error nan_deinit_handler(); wifi_error wifi_start_hal(wifi_interface_handle iface); wifi_error wifi_stop_hal(wifi_interface_handle iface); wifi_interface_handle wifi_get_wlan_interface(wifi_handle info, wifi_interface_handle *ifaceHandles, int numIfaceHandles); wifi_error wifi_hal_ota_update(wifi_interface_handle iface, uint32_t ota_version); wifi_error wifi_hal_preInit(wifi_interface_handle iface); /* API to get wake reason statistics */ wifi_error wifi_get_wake_reason_stats(wifi_interface_handle handle, WLAN_DRIVER_WAKE_REASON_CNT *wifi_wake_reason_cnt); wifi_error wifi_virtual_interface_create(wifi_handle handle, const char* ifname, wifi_interface_type iface_type); wifi_error wifi_virtual_interface_delete(wifi_handle handle, const char* ifname); wifi_error wifi_set_coex_unsafe_channels(wifi_handle handle, u32 num_channels, wifi_coex_unsafe_channel channels[], u32 restrictions); wifi_error wifi_set_voip_mode(wifi_interface_handle handle, wifi_voip_mode mode); wifi_error wifi_set_dtim_config(wifi_interface_handle handle, u32 multiplier); void set_hautil_mode(bool halutil_mode); bool get_halutil_mode(); /* API's to support TWT */ /**@brief twt_get_capability * Request TWT capability * @param wifi_interface_handle: * @return Synchronous wifi_error and TwtCapabilitySet */ wifi_error twt_get_capability(wifi_interface_handle iface, TwtCapabilitySet* twt_cap_set); /**@brief twt_register_handler * Request to register TWT callback * @param wifi_interface_handle: * @param TwtCallbackHandler: * @return Synchronous wifi_error */ wifi_error twt_register_handler(wifi_interface_handle iface, TwtCallbackHandler handler); /**@brief twt_setup_request * Request to send TWT setup frame * @param wifi_interface_handle: * @param TwtSetupRequest: * @return Synchronous wifi_error * @return Asynchronous EventTwtSetupResponse CB return TwtSetupResponse */ wifi_error twt_setup_request(wifi_interface_handle iface, TwtSetupRequest* msg); /**@brief twt_teardown_request * Request to send TWT teardown frame * @param wifi_interface_handle: * @param TwtTeardownRequest: * @return Synchronous wifi_error * @return Asynchronous EventTwtTeardownCompletion CB return TwtTeardownCompletion * TwtTeardownCompletion may also be received due to other events * like CSA, BTCX, TWT scheduler, MultiConnection, peer-initiated teardown, etc. */ wifi_error twt_teardown_request(wifi_interface_handle iface, TwtTeardownRequest* msg); /**@brief twt_info_frame_request * Request to send TWT info frame * @param wifi_interface_handle: * @param TwtInfoFrameRequest: * @return Synchronous wifi_error * @return Asynchronous EventTwtInfoFrameReceived CB return TwtInfoFrameReceived * Driver may also receive Peer-initiated TwtInfoFrame */ wifi_error twt_info_frame_request(wifi_interface_handle iface, TwtInfoFrameRequest* msg); /**@brief twt_get_stats * Request to get TWT stats * @param wifi_interface_handle: * @param config_id: * @return Synchronous wifi_error and TwtStats */ wifi_error twt_get_stats(wifi_interface_handle iface, u8 config_id, TwtStats* stats); /**@brief twt_clear_stats * Request to clear TWT stats * @param wifi_interface_handle: * @param config_id: * @return Synchronous wifi_error */ wifi_error twt_clear_stats(wifi_interface_handle iface, u8 config_id); wifi_error wifi_trigger_subsystem_restart(wifi_handle handle); // some common macros #define min(x, y) ((x) < (y) ? (x) : (y)) #define max(x, y) ((x) > (y) ? (x) : (y)) #define NULL_CHECK_RETURN(ptr, str, ret) \ do { \ if (!(ptr)) { \ ALOGE("%s(): null pointer - #ptr (%s)\n", __FUNCTION__, str); \ return ret; \ } \ } while (0) #endif