common.h

   1
   2 #include "wifi_hal.h"
   3
   4 #ifndef __WIFI_HAL_COMMON_H__
   5 #define __WIFI_HAL_COMMON_H__
   6
   7 #define LOG_TAG  "WifiHAL"
   8
   9 #include <utils/Log.h>
  10 #include "nl80211_copy.h"
  11 #include "sync.h"
  12
  13 #define SOCKET_BUFFER_SIZE      (32768U)
  14 #define RECV_BUF_SIZE           (4096)
  15 #define DEFAULT_EVENT_CB_SIZE   (64)
  16 #define DEFAULT_CMD_SIZE        (64)
  17 #define DOT11_OUI_LEN             3
  18
  19 typedef struct {
  20         int num_bssid;
  21         mac_addr bssids[MAX_BLACKLIST_BSSID];
  22 } wifi_bssid_params;
  23
  24 /*
  25  Vendor OUI - This is a unique identifier that identifies organization. Lets
  26  code Android specific functions with Google OUI; although vendors can do more
  27  with their own OUI's as well.
  28  */
  29
  30 const uint32_t GOOGLE_OUI = 0x001A11;
  31 /* TODO: define vendor OUI here */
  32
  33 typedef enum {
  34
  35     GSCAN_ATTRIBUTE_NUM_BUCKETS = 10,
  36     GSCAN_ATTRIBUTE_BASE_PERIOD,
  37     GSCAN_ATTRIBUTE_BUCKETS_BAND,
  38     GSCAN_ATTRIBUTE_BUCKET_ID,
  39     GSCAN_ATTRIBUTE_BUCKET_PERIOD,
  40     GSCAN_ATTRIBUTE_BUCKET_NUM_CHANNELS,
  41     GSCAN_ATTRIBUTE_BUCKET_CHANNELS,
  42     GSCAN_ATTRIBUTE_NUM_AP_PER_SCAN,
  43     GSCAN_ATTRIBUTE_REPORT_THRESHOLD,
  44     GSCAN_ATTRIBUTE_NUM_SCANS_TO_CACHE,
  45     GSCAN_ATTRIBUTE_REPORT_THRESHOLD_NUM_SCANS,
  46     GSCAN_ATTRIBUTE_BAND = GSCAN_ATTRIBUTE_BUCKETS_BAND,
  47
  48     GSCAN_ATTRIBUTE_ENABLE_FEATURE = 20,
  49     GSCAN_ATTRIBUTE_SCAN_RESULTS_COMPLETE,              /* indicates no more results */
  50     GSCAN_ATTRIBUTE_REPORT_EVENTS,
  51
  52     /* remaining reserved for additional attributes */
  53     GSCAN_ATTRIBUTE_NUM_OF_RESULTS = 30,
  54     GSCAN_ATTRIBUTE_SCAN_RESULTS,                       /* flat array of wifi_scan_result */
  55     GSCAN_ATTRIBUTE_NUM_CHANNELS,
  56     GSCAN_ATTRIBUTE_CHANNEL_LIST,
  57     GSCAN_ATTRIBUTE_SCAN_ID,
  58     GSCAN_ATTRIBUTE_SCAN_FLAGS,
  59     GSCAN_ATTRIBUTE_SCAN_BUCKET_BIT,
  60
  61     /* remaining reserved for additional attributes */
  62
  63     GSCAN_ATTRIBUTE_SSID = 40,
  64     GSCAN_ATTRIBUTE_BSSID,
  65     GSCAN_ATTRIBUTE_CHANNEL,
  66     GSCAN_ATTRIBUTE_RSSI,
  67     GSCAN_ATTRIBUTE_TIMESTAMP,
  68     GSCAN_ATTRIBUTE_RTT,
  69     GSCAN_ATTRIBUTE_RTTSD,
  70
  71     /* remaining reserved for additional attributes */
  72
  73     GSCAN_ATTRIBUTE_HOTLIST_BSSIDS = 50,
  74     GSCAN_ATTRIBUTE_RSSI_LOW,
  75     GSCAN_ATTRIBUTE_RSSI_HIGH,
  76     GSCAN_ATTRIBUTE_HOTLIST_ELEM,
  77     GSCAN_ATTRIBUTE_HOTLIST_FLUSH,
  78     GSCAN_ATTRIBUTE_CHANNEL_NUMBER,
  79
  80     /* remaining reserved for additional attributes */
  81     GSCAN_ATTRIBUTE_RSSI_SAMPLE_SIZE = 60,
  82     GSCAN_ATTRIBUTE_LOST_AP_SAMPLE_SIZE,
  83     GSCAN_ATTRIBUTE_MIN_BREACHING,
  84     GSCAN_ATTRIBUTE_SIGNIFICANT_CHANGE_BSSIDS,
  85
  86     GSCAN_ATTRIBUTE_BUCKET_STEP_COUNT = 70,
  87     GSCAN_ATTRIBUTE_BUCKET_EXPONENT,
  88     GSCAN_ATTRIBUTE_BUCKET_MAX_PERIOD,
  89
  90     GSCAN_ATTRIBUTE_NUM_BSSID,
  91     GSCAN_ATTRIBUTE_BLACKLIST_BSSID,
  92
  93     GSCAN_ATTRIBUTE_MAX
  94
  95 } GSCAN_ATTRIBUTE;
  96
  97 /*
  98  This enum defines ranges for various commands; commands themselves
  99  can be defined in respective feature headers; i.e. find gscan command
 100  definitions in gscan.cpp
 101  */
 102
 103 typedef enum {
 104     /* don't use 0 as a valid subcommand */
 105     VENDOR_NL80211_SUBCMD_UNSPECIFIED,
 106
 107     /* define all vendor startup commands between 0x0 and 0x0FFF */
 108     VENDOR_NL80211_SUBCMD_RANGE_START = 0x0001,
 109     VENDOR_NL80211_SUBCMD_RANGE_END   = 0x0FFF,
 110
 111     /* define all GScan related commands between 0x1000 and 0x10FF */
 112     ANDROID_NL80211_SUBCMD_GSCAN_RANGE_START = 0x1000,
 113     ANDROID_NL80211_SUBCMD_GSCAN_RANGE_END   = 0x10FF,
 114
 115     /* define all NearbyDiscovery related commands between 0x1100 and 0x11FF */
 116     ANDROID_NL80211_SUBCMD_NBD_RANGE_START = 0x1100,
 117     ANDROID_NL80211_SUBCMD_NBD_RANGE_END   = 0x11FF,
 118
 119     /* define all RTT related commands between 0x1100 and 0x11FF */
 120     ANDROID_NL80211_SUBCMD_RTT_RANGE_START = 0x1100,
 121     ANDROID_NL80211_SUBCMD_RTT_RANGE_END   = 0x11FF,
 122
 123     ANDROID_NL80211_SUBCMD_LSTATS_RANGE_START = 0x1200,
 124     ANDROID_NL80211_SUBCMD_LSTATS_RANGE_END   = 0x12FF,
 125
 126     /* define all wifi offload related commands between 0x1400 and 0x14FF */
 127     ANDROID_NL80211_SUBCMD_WIFI_OFFLOAD_RANGE_START = 0x1400,
 128     ANDROID_NL80211_SUBCMD_WIFI_OFFLOAD_RANGE_END   = 0x14FF,
 129
 130    /* This is reserved for future usage */
 131
 132 } ANDROID_VENDOR_SUB_COMMAND;
 133
 134 typedef enum {
 135     SLSI_NL80211_VENDOR_SUBCMD_GET_CAPABILITIES = ANDROID_NL80211_SUBCMD_GSCAN_RANGE_START,
 136     SLSI_NL80211_VENDOR_SUBCMD_GET_VALID_CHANNELS,
 137     SLSI_NL80211_VENDOR_SUBCMD_ADD_GSCAN,
 138     SLSI_NL80211_VENDOR_SUBCMD_DEL_GSCAN,
 139     SLSI_NL80211_VENDOR_SUBCMD_GET_SCAN_RESULTS,
 140     SLSI_NL80211_VENDOR_SUBCMD_SET_BSSID_HOTLIST,
 141     SLSI_NL80211_VENDOR_SUBCMD_RESET_BSSID_HOTLIST,
 142     SLSI_NL80211_VENDOR_SUBCMD_GET_HOTLIST_RESULTS,
 143     SLSI_NL80211_VENDOR_SUBCMD_SET_SIGNIFICANT_CHANGE,
 144     SLSI_NL80211_VENDOR_SUBCMD_RESET_SIGNIFICANT_CHANGE,
 145     SLSI_NL80211_VENDOR_SUBCMD_SET_GSCAN_OUI,
 146     SLSI_NL80211_VENDOR_SUBCMD_SET_NODFS,
 147     /*Add any GSCAN subcmds before this*/
 148     SLSI_NL80211_VENDOR_SUBCMD_START_KEEP_ALIVE_OFFLOAD,
 149     SLSI_NL80211_VENDOR_SUBCMD_STOP_KEEP_ALIVE_OFFLOAD,
 150     SLSI_NL80211_VENDOR_SUBCMD_SET_BSSID_BLACKLIST,
 151     SLSI_NL80211_VENDOR_SUBCMD_SET_EPNO_LIST,
 152     SLSI_NL80211_VENDOR_SUBCMD_SET_HS_LIST,
 153     SLSI_NL80211_VENDOR_SUBCMD_RESET_HS_LIST,
 154     SLSI_NL80211_VENDOR_SUBCMD_SET_RSSI_MONITOR,
 155     SLSI_NL80211_VENDOR_SUBCMD_LLS_SET_INFO,
 156     SLSI_NL80211_VENDOR_SUBCMD_LLS_GET_INFO,
 157     SLSI_NL80211_VENDOR_SUBCMD_LLS_CLEAR_INFO,
 158     SLSI_NL80211_VENDOR_SUBCMD_GET_FEATURE_SET,
 159     SLSI_NL80211_VENDOR_SUBCMD_SET_COUNTRY_CODE
 160 } WIFI_SUB_COMMAND;
 161
 162 typedef enum {
 163     GSCAN_EVENT_SIGNIFICANT_CHANGE_RESULTS ,
 164     GSCAN_EVENT_HOTLIST_RESULTS_FOUND,
 165     GSCAN_EVENT_SCAN_RESULTS_AVAILABLE,
 166     GSCAN_EVENT_FULL_SCAN_RESULTS,
 167     GSCAN_EVENT_COMPLETE_SCAN,
 168     GSCAN_EVENT_HOTLIST_RESULTS_LOST,
 169     WIFI_SUBCMD_KEY_MGMT_ROAM_AUTH, /* Handled by supplicant. not in Wifi-HAL */
 170     WIFI_HANGED_EVENT,
 171     WIFI_EPNO_EVENT,
 172     WIFI_HOTSPOT_MATCH,
 173     WIFI_RSSI_REPORT_EVENT
 174
 175 } WIFI_EVENT;
 176
 177 typedef void (*wifi_internal_event_handler) (wifi_handle handle, int events);
 178
 179 class WifiCommand;
 180
 181 typedef struct {
 182     int nl_cmd;
 183     uint32_t vendor_id;
 184     int vendor_subcmd;
 185     nl_recvmsg_msg_cb_t cb_func;
 186     void *cb_arg;
 187 } cb_info;
 188
 189 typedef struct {
 190     wifi_request_id id;
 191     WifiCommand *cmd;
 192 } cmd_info;
 193
 194 typedef struct {
 195     wifi_handle handle;                             // handle to wifi data
 196     char name[8+1];                                 // interface name + trailing null
 197     int  id;                                        // id to use when talking to driver
 198 } interface_info;
 199
 200 typedef struct {
 201
 202     struct nl_sock *cmd_sock;                       // command socket object
 203     struct nl_sock *event_sock;                     // event socket object
 204     int nl80211_family_id;                          // family id for 80211 driver
 205     int cleanup_socks[2];                           // sockets used to implement wifi_cleanup
 206
 207     bool in_event_loop;                             // Indicates that event loop is active
 208     bool clean_up;                                  // Indication to clean up the socket
 209
 210     wifi_internal_event_handler event_handler;      // default event handler
 211     wifi_cleaned_up_handler cleaned_up_handler;     // socket cleaned up handler
 212
 213     cb_info *event_cb;                              // event callbacks
 214     int num_event_cb;                               // number of event callbacks
 215     int alloc_event_cb;                             // number of allocated callback objects
 216     pthread_mutex_t cb_lock;                        // mutex for the event_cb access
 217
 218     cmd_info *cmd;                                  // Outstanding commands
 219     int num_cmd;                                    // number of commands
 220     int alloc_cmd;                                  // number of commands allocated
 221
 222     interface_info **interfaces;                    // array of interfaces
 223     int num_interfaces;                             // number of interfaces
 224
 225
 226     // add other details
 227 } hal_info;
 228
 229 wifi_error wifi_register_handler(wifi_handle handle, int cmd, nl_recvmsg_msg_cb_t func, void *arg);
 230 wifi_error wifi_register_vendor_handler(wifi_handle handle,
 231             uint32_t id, int subcmd, nl_recvmsg_msg_cb_t func, void *arg);
 232
 233 void wifi_unregister_handler(wifi_handle handle, int cmd);
 234 void wifi_unregister_vendor_handler(wifi_handle handle, uint32_t id, int subcmd);
 235
 236 wifi_error wifi_register_cmd(wifi_handle handle, int id, WifiCommand *cmd);
 237 WifiCommand *wifi_unregister_cmd(wifi_handle handle, int id);
 238 WifiCommand *wifi_get_cmd(wifi_handle handle, int id);
 239 void wifi_unregister_cmd(wifi_handle handle, WifiCommand *cmd);
 240 wifi_error wifi_cancel_cmd(wifi_request_id id, wifi_interface_handle iface);
 241
 242 interface_info *getIfaceInfo(wifi_interface_handle);
 243 wifi_handle getWifiHandle(wifi_interface_handle handle);
 244 hal_info *getHalInfo(wifi_handle handle);
 245 hal_info *getHalInfo(wifi_interface_handle handle);
 246 wifi_handle getWifiHandle(hal_info *info);
 247 wifi_interface_handle getIfaceHandle(interface_info *info);
 248
 249
 250 // some common macros
 251
 252 #define min(x, y)       ((x) < (y) ? (x) : (y))
 253 #define max(x, y)       ((x) > (y) ? (x) : (y))
 254
 255 #endif
 256