wl_cfg80211.h 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514
  1. /*
  2. * Copyright (c) 2010 Broadcom Corporation
  3. *
  4. * Permission to use, copy, modify, and/or distribute this software for any
  5. * purpose with or without fee is hereby granted, provided that the above
  6. * copyright notice and this permission notice appear in all copies.
  7. *
  8. * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  9. * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  10. * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
  11. * SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  12. * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
  13. * OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
  14. * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  15. */
  16. #ifndef _wl_cfg80211_h_
  17. #define _wl_cfg80211_h_
  18. #define WL_DBG_NONE 0
  19. #define WL_DBG_CONN (1 << 5)
  20. #define WL_DBG_SCAN (1 << 4)
  21. #define WL_DBG_TRACE (1 << 3)
  22. #define WL_DBG_INFO (1 << 1)
  23. #define WL_DBG_ERR (1 << 0)
  24. #define WL_DBG_MASK ((WL_DBG_INFO | WL_DBG_ERR | WL_DBG_TRACE) | \
  25. (WL_DBG_SCAN) | (WL_DBG_CONN))
  26. #define WL_ERR(fmt, ...) \
  27. do { \
  28. if (brcmf_dbg_level & WL_DBG_ERR) { \
  29. if (net_ratelimit()) { \
  30. pr_err("ERROR @%s : " fmt, \
  31. __func__, ##__VA_ARGS__); \
  32. } \
  33. } \
  34. } while (0)
  35. #if (defined DEBUG)
  36. #define WL_INFO(fmt, ...) \
  37. do { \
  38. if (brcmf_dbg_level & WL_DBG_INFO) { \
  39. if (net_ratelimit()) { \
  40. pr_err("INFO @%s : " fmt, \
  41. __func__, ##__VA_ARGS__); \
  42. } \
  43. } \
  44. } while (0)
  45. #define WL_TRACE(fmt, ...) \
  46. do { \
  47. if (brcmf_dbg_level & WL_DBG_TRACE) { \
  48. if (net_ratelimit()) { \
  49. pr_err("TRACE @%s : " fmt, \
  50. __func__, ##__VA_ARGS__); \
  51. } \
  52. } \
  53. } while (0)
  54. #define WL_SCAN(fmt, ...) \
  55. do { \
  56. if (brcmf_dbg_level & WL_DBG_SCAN) { \
  57. if (net_ratelimit()) { \
  58. pr_err("SCAN @%s : " fmt, \
  59. __func__, ##__VA_ARGS__); \
  60. } \
  61. } \
  62. } while (0)
  63. #define WL_CONN(fmt, ...) \
  64. do { \
  65. if (brcmf_dbg_level & WL_DBG_CONN) { \
  66. if (net_ratelimit()) { \
  67. pr_err("CONN @%s : " fmt, \
  68. __func__, ##__VA_ARGS__); \
  69. } \
  70. } \
  71. } while (0)
  72. #else /* (defined DEBUG) */
  73. #define WL_INFO(fmt, args...)
  74. #define WL_TRACE(fmt, args...)
  75. #define WL_SCAN(fmt, args...)
  76. #define WL_CONN(fmt, args...)
  77. #endif /* (defined DEBUG) */
  78. #define WL_NUM_SCAN_MAX 1
  79. #define WL_NUM_PMKIDS_MAX MAXPMKID /* will be used
  80. * for 2.6.33 kernel
  81. * or later
  82. */
  83. #define WL_SCAN_BUF_MAX (1024 * 8)
  84. #define WL_TLV_INFO_MAX 1024
  85. #define WL_BSS_INFO_MAX 2048
  86. #define WL_ASSOC_INFO_MAX 512 /*
  87. * needs to grab assoc info from dongle to
  88. * report it to cfg80211 through "connect"
  89. * event
  90. */
  91. #define WL_DCMD_LEN_MAX 1024
  92. #define WL_EXTRA_BUF_MAX 2048
  93. #define WL_ISCAN_BUF_MAX 2048 /*
  94. * the buf length can be BRCMF_DCMD_MAXLEN
  95. * to reduce iteration
  96. */
  97. #define WL_ISCAN_TIMER_INTERVAL_MS 3000
  98. #define WL_SCAN_ERSULTS_LAST (BRCMF_SCAN_RESULTS_NO_MEM+1)
  99. #define WL_AP_MAX 256 /* virtually unlimitted as long
  100. * as kernel memory allows
  101. */
  102. #define WL_ROAM_TRIGGER_LEVEL -75
  103. #define WL_ROAM_DELTA 20
  104. #define WL_BEACON_TIMEOUT 3
  105. #define WL_SCAN_CHANNEL_TIME 40
  106. #define WL_SCAN_UNASSOC_TIME 40
  107. #define WL_SCAN_PASSIVE_TIME 120
  108. #define WL_ESCAN_BUF_SIZE (1024 * 64)
  109. #define WL_ESCAN_TIMER_INTERVAL_MS 8000 /* E-Scan timeout */
  110. #define WL_ESCAN_ACTION_START 1
  111. #define WL_ESCAN_ACTION_CONTINUE 2
  112. #define WL_ESCAN_ACTION_ABORT 3
  113. #define WL_AUTH_SHARED_KEY 1 /* d11 shared authentication */
  114. #define IE_MAX_LEN 512
  115. /* dongle status */
  116. enum wl_status {
  117. WL_STATUS_READY,
  118. WL_STATUS_SCANNING,
  119. WL_STATUS_SCAN_ABORTING,
  120. WL_STATUS_CONNECTING,
  121. WL_STATUS_CONNECTED,
  122. WL_STATUS_AP_CREATING,
  123. WL_STATUS_AP_CREATED
  124. };
  125. /* wi-fi mode */
  126. enum wl_mode {
  127. WL_MODE_BSS,
  128. WL_MODE_IBSS,
  129. WL_MODE_AP
  130. };
  131. /* dongle profile list */
  132. enum wl_prof_list {
  133. WL_PROF_MODE,
  134. WL_PROF_SSID,
  135. WL_PROF_SEC,
  136. WL_PROF_IBSS,
  137. WL_PROF_BAND,
  138. WL_PROF_BSSID,
  139. WL_PROF_ACT,
  140. WL_PROF_BEACONINT,
  141. WL_PROF_DTIMPERIOD
  142. };
  143. /* dongle iscan state */
  144. enum wl_iscan_state {
  145. WL_ISCAN_STATE_IDLE,
  146. WL_ISCAN_STATE_SCANING
  147. };
  148. /* dongle configuration */
  149. struct brcmf_cfg80211_conf {
  150. u32 mode; /* adhoc , infrastructure or ap */
  151. u32 frag_threshold;
  152. u32 rts_threshold;
  153. u32 retry_short;
  154. u32 retry_long;
  155. s32 tx_power;
  156. struct ieee80211_channel channel;
  157. };
  158. /* forward declaration */
  159. struct brcmf_cfg80211_info;
  160. /* cfg80211 main event loop */
  161. struct brcmf_cfg80211_event_loop {
  162. s32(*handler[BRCMF_E_LAST]) (struct brcmf_cfg80211_info *cfg,
  163. struct net_device *ndev,
  164. const struct brcmf_event_msg *e,
  165. void *data);
  166. };
  167. /* basic structure of scan request */
  168. struct brcmf_cfg80211_scan_req {
  169. struct brcmf_ssid_le ssid_le;
  170. };
  171. /* basic structure of information element */
  172. struct brcmf_cfg80211_ie {
  173. u16 offset;
  174. u8 buf[WL_TLV_INFO_MAX];
  175. };
  176. /* event queue for cfg80211 main event */
  177. struct brcmf_cfg80211_event_q {
  178. struct list_head evt_q_list;
  179. u32 etype;
  180. struct brcmf_event_msg emsg;
  181. s8 edata[1];
  182. };
  183. /* security information with currently associated ap */
  184. struct brcmf_cfg80211_security {
  185. u32 wpa_versions;
  186. u32 auth_type;
  187. u32 cipher_pairwise;
  188. u32 cipher_group;
  189. u32 wpa_auth;
  190. };
  191. /* ibss information for currently joined ibss network */
  192. struct brcmf_cfg80211_ibss {
  193. u8 beacon_interval; /* in millisecond */
  194. u8 atim; /* in millisecond */
  195. s8 join_only;
  196. u8 band;
  197. u8 channel;
  198. };
  199. /* dongle profile */
  200. struct brcmf_cfg80211_profile {
  201. u32 mode;
  202. struct brcmf_ssid ssid;
  203. u8 bssid[ETH_ALEN];
  204. u16 beacon_interval;
  205. u8 dtim_period;
  206. struct brcmf_cfg80211_security sec;
  207. struct brcmf_cfg80211_ibss ibss;
  208. s32 band;
  209. };
  210. /* dongle iscan event loop */
  211. struct brcmf_cfg80211_iscan_eloop {
  212. s32 (*handler[WL_SCAN_ERSULTS_LAST])
  213. (struct brcmf_cfg80211_info *cfg);
  214. };
  215. /* dongle iscan controller */
  216. struct brcmf_cfg80211_iscan_ctrl {
  217. struct net_device *ndev;
  218. struct timer_list timer;
  219. u32 timer_ms;
  220. u32 timer_on;
  221. s32 state;
  222. struct work_struct work;
  223. struct brcmf_cfg80211_iscan_eloop el;
  224. void *data;
  225. s8 dcmd_buf[BRCMF_DCMD_SMLEN];
  226. s8 scan_buf[WL_ISCAN_BUF_MAX];
  227. };
  228. /* association inform */
  229. struct brcmf_cfg80211_connect_info {
  230. u8 *req_ie;
  231. s32 req_ie_len;
  232. u8 *resp_ie;
  233. s32 resp_ie_len;
  234. };
  235. /* assoc ie length */
  236. struct brcmf_cfg80211_assoc_ielen_le {
  237. __le32 req_len;
  238. __le32 resp_len;
  239. };
  240. /* wpa2 pmk list */
  241. struct brcmf_cfg80211_pmk_list {
  242. struct pmkid_list pmkids;
  243. struct pmkid foo[MAXPMKID - 1];
  244. };
  245. /* dongle escan state */
  246. enum wl_escan_state {
  247. WL_ESCAN_STATE_IDLE,
  248. WL_ESCAN_STATE_SCANNING
  249. };
  250. struct escan_info {
  251. u32 escan_state;
  252. u8 escan_buf[WL_ESCAN_BUF_SIZE];
  253. struct wiphy *wiphy;
  254. struct net_device *ndev;
  255. };
  256. /* Structure to hold WPS, WPA IEs for a AP */
  257. struct ap_info {
  258. u8 probe_res_ie[IE_MAX_LEN];
  259. u8 beacon_ie[IE_MAX_LEN];
  260. u32 probe_res_ie_len;
  261. u32 beacon_ie_len;
  262. u8 *wpa_ie;
  263. u8 *rsn_ie;
  264. bool security_mode;
  265. };
  266. /**
  267. * struct brcmf_pno_param_le - PNO scan configuration parameters
  268. *
  269. * @version: PNO parameters version.
  270. * @scan_freq: scan frequency.
  271. * @lost_network_timeout: #sec. to declare discovered network as lost.
  272. * @flags: Bit field to control features of PFN such as sort criteria auto
  273. * enable switch and background scan.
  274. * @rssi_margin: Margin to avoid jitter for choosing a PFN based on RSSI sort
  275. * criteria.
  276. * @bestn: number of best networks in each scan.
  277. * @mscan: number of scans recorded.
  278. * @repeat: minimum number of scan intervals before scan frequency changes
  279. * in adaptive scan.
  280. * @exp: exponent of 2 for maximum scan interval.
  281. * @slow_freq: slow scan period.
  282. */
  283. struct brcmf_pno_param_le {
  284. __le32 version;
  285. __le32 scan_freq;
  286. __le32 lost_network_timeout;
  287. __le16 flags;
  288. __le16 rssi_margin;
  289. u8 bestn;
  290. u8 mscan;
  291. u8 repeat;
  292. u8 exp;
  293. __le32 slow_freq;
  294. };
  295. /**
  296. * struct brcmf_pno_net_param_le - scan parameters per preferred network.
  297. *
  298. * @ssid: ssid name and its length.
  299. * @flags: bit2: hidden.
  300. * @infra: BSS vs IBSS.
  301. * @auth: Open vs Closed.
  302. * @wpa_auth: WPA type.
  303. * @wsec: wsec value.
  304. */
  305. struct brcmf_pno_net_param_le {
  306. struct brcmf_ssid_le ssid;
  307. __le32 flags;
  308. __le32 infra;
  309. __le32 auth;
  310. __le32 wpa_auth;
  311. __le32 wsec;
  312. };
  313. /**
  314. * struct brcmf_pno_net_info_le - information per found network.
  315. *
  316. * @bssid: BSS network identifier.
  317. * @channel: channel number only.
  318. * @SSID_len: length of ssid.
  319. * @SSID: ssid characters.
  320. * @RSSI: receive signal strength (in dBm).
  321. * @timestamp: age in seconds.
  322. */
  323. struct brcmf_pno_net_info_le {
  324. u8 bssid[ETH_ALEN];
  325. u8 channel;
  326. u8 SSID_len;
  327. u8 SSID[32];
  328. __le16 RSSI;
  329. __le16 timestamp;
  330. };
  331. /**
  332. * struct brcmf_pno_scanresults_le - result returned in PNO NET FOUND event.
  333. *
  334. * @version: PNO version identifier.
  335. * @status: indicates completion status of PNO scan.
  336. * @count: amount of brcmf_pno_net_info_le entries appended.
  337. */
  338. struct brcmf_pno_scanresults_le {
  339. __le32 version;
  340. __le32 status;
  341. __le32 count;
  342. };
  343. /**
  344. * struct brcmf_cfg80211_info - dongle private data of cfg80211 interface
  345. *
  346. * @wdev: representing wl cfg80211 device.
  347. * @conf: dongle configuration.
  348. * @scan_request: cfg80211 scan request object.
  349. * @el: main event loop.
  350. * @evt_q_list: used for event queue.
  351. * @evt_q_lock: for event queue synchronization.
  352. * @usr_sync: mainly for dongle up/down synchronization.
  353. * @bss_list: bss_list holding scanned ap information.
  354. * @scan_results: results of the last scan.
  355. * @scan_req_int: internal scan request object.
  356. * @bss_info: bss information for cfg80211 layer.
  357. * @ie: information element object for internal purpose.
  358. * @profile: holding dongle profile.
  359. * @iscan: iscan controller information.
  360. * @conn_info: association info.
  361. * @pmk_list: wpa2 pmk list.
  362. * @event_work: event handler work struct.
  363. * @status: current dongle status.
  364. * @pub: common driver information.
  365. * @channel: current channel.
  366. * @iscan_on: iscan on/off switch.
  367. * @iscan_kickstart: indicate iscan already started.
  368. * @active_scan: current scan mode.
  369. * @sched_escan: e-scan for scheduled scan support running.
  370. * @ibss_starter: indicates this sta is ibss starter.
  371. * @link_up: link/connection up flag.
  372. * @pwr_save: indicate whether dongle to support power save mode.
  373. * @dongle_up: indicate whether dongle up or not.
  374. * @roam_on: on/off switch for dongle self-roaming.
  375. * @scan_tried: indicates if first scan attempted.
  376. * @dcmd_buf: dcmd buffer.
  377. * @extra_buf: mainly to grab assoc information.
  378. * @debugfsdir: debugfs folder for this device.
  379. * @escan_on: escan on/off switch.
  380. * @escan_info: escan information.
  381. * @escan_timeout: Timer for catch scan timeout.
  382. * @escan_timeout_work: scan timeout worker.
  383. * @escan_ioctl_buf: dongle command buffer for escan commands.
  384. * @ap_info: host ap information.
  385. * @ci: used to link this structure to netdev private data.
  386. */
  387. struct brcmf_cfg80211_info {
  388. struct wireless_dev *wdev;
  389. struct brcmf_cfg80211_conf *conf;
  390. struct cfg80211_scan_request *scan_request;
  391. struct brcmf_cfg80211_event_loop el;
  392. struct list_head evt_q_list;
  393. spinlock_t evt_q_lock;
  394. struct mutex usr_sync;
  395. struct brcmf_scan_results *bss_list;
  396. struct brcmf_scan_results *scan_results;
  397. struct brcmf_cfg80211_scan_req *scan_req_int;
  398. struct wl_cfg80211_bss_info *bss_info;
  399. struct brcmf_cfg80211_ie ie;
  400. struct brcmf_cfg80211_profile *profile;
  401. struct brcmf_cfg80211_iscan_ctrl *iscan;
  402. struct brcmf_cfg80211_connect_info conn_info;
  403. struct brcmf_cfg80211_pmk_list *pmk_list;
  404. struct work_struct event_work;
  405. unsigned long status;
  406. struct brcmf_pub *pub;
  407. u32 channel;
  408. bool iscan_on;
  409. bool iscan_kickstart;
  410. bool active_scan;
  411. bool sched_escan;
  412. bool ibss_starter;
  413. bool link_up;
  414. bool pwr_save;
  415. bool dongle_up;
  416. bool roam_on;
  417. bool scan_tried;
  418. u8 *dcmd_buf;
  419. u8 *extra_buf;
  420. struct dentry *debugfsdir;
  421. bool escan_on;
  422. struct escan_info escan_info;
  423. struct timer_list escan_timeout;
  424. struct work_struct escan_timeout_work;
  425. u8 *escan_ioctl_buf;
  426. struct ap_info *ap_info;
  427. };
  428. static inline struct wiphy *cfg_to_wiphy(struct brcmf_cfg80211_info *w)
  429. {
  430. return w->wdev->wiphy;
  431. }
  432. static inline struct brcmf_cfg80211_info *wiphy_to_cfg(struct wiphy *w)
  433. {
  434. return (struct brcmf_cfg80211_info *)(wiphy_priv(w));
  435. }
  436. static inline struct brcmf_cfg80211_info *wdev_to_cfg(struct wireless_dev *wd)
  437. {
  438. return (struct brcmf_cfg80211_info *)(wdev_priv(wd));
  439. }
  440. static inline struct net_device *cfg_to_ndev(struct brcmf_cfg80211_info *cfg)
  441. {
  442. return cfg->wdev->netdev;
  443. }
  444. static inline struct brcmf_cfg80211_info *ndev_to_cfg(struct net_device *ndev)
  445. {
  446. return wdev_to_cfg(ndev->ieee80211_ptr);
  447. }
  448. #define iscan_to_cfg(i) ((struct brcmf_cfg80211_info *)(i->data))
  449. #define cfg_to_iscan(w) (w->iscan)
  450. static inline struct
  451. brcmf_cfg80211_connect_info *cfg_to_conn(struct brcmf_cfg80211_info *cfg)
  452. {
  453. return &cfg->conn_info;
  454. }
  455. struct brcmf_cfg80211_info *brcmf_cfg80211_attach(struct net_device *ndev,
  456. struct device *busdev,
  457. struct brcmf_pub *drvr);
  458. void brcmf_cfg80211_detach(struct brcmf_cfg80211_info *cfg);
  459. /* event handler from dongle */
  460. void brcmf_cfg80211_event(struct net_device *ndev,
  461. const struct brcmf_event_msg *e, void *data);
  462. s32 brcmf_cfg80211_up(struct brcmf_cfg80211_info *cfg);
  463. s32 brcmf_cfg80211_down(struct brcmf_cfg80211_info *cfg);
  464. #endif /* _wl_cfg80211_h_ */