wlan_vdev_mlme.h 38 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378
  1. /*
  2. * Copyright (c) 2018-2019 The Linux Foundation. All rights reserved.
  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
  11. * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  12. * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  13. * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  14. * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  15. */
  16. /**
  17. * DOC: Define VDEV MLME structure and APIs
  18. */
  19. #ifndef _WLAN_VDEV_MLME_H_
  20. #define _WLAN_VDEV_MLME_H_
  21. #include <wlan_vdev_mgr_tgt_if_rx_defs.h>
  22. #include <wlan_objmgr_vdev_obj.h>
  23. #include <wlan_vdev_mlme_api.h>
  24. struct vdev_mlme_obj;
  25. /* Requestor ID for multiple vdev restart */
  26. #define MULTIPLE_VDEV_RESTART_REQ_ID 0x1234
  27. /* values for vdev_type */
  28. #define WLAN_VDEV_MLME_TYPE_AP 0x1
  29. #define WLAN_VDEV_MLME_TYPE_STA 0x2
  30. #define WLAN_VDEV_MLME_TYPE_IBSS 0x3
  31. #define WLAN_VDEV_MLME_TYPE_MONITOR 0x4
  32. /* values for vdev_subtype */
  33. #define WLAN_VDEV_MLME_SUBTYPE_P2P_DEVICE 0x1
  34. #define WLAN_VDEV_MLME_SUBTYPE_P2P_CLIENT 0x2
  35. #define WLAN_VDEV_MLME_SUBTYPE_P2P_GO 0x3
  36. #define WLAN_VDEV_MLME_SUBTYPE_PROXY_STA 0x4
  37. #define WLAN_VDEV_MLME_SUBTYPE_MESH 0x5
  38. /* vdev control flags (per bits) */
  39. #define WLAN_VDEV_MLME_FLAGS_NON_MBSSID_AP 0x00000001
  40. #define WLAN_VDEV_MLME_FLAGS_TRANSMIT_AP 0x00000002
  41. #define WLAN_VDEV_MLME_FLAGS_NON_TRANSMIT_AP 0x00000004
  42. /**
  43. * struct vdev_mlme_proto_generic - generic mlme proto structure
  44. * sent in frames
  45. * @dtim_period: frequency of data transmissions per beacon 1-255
  46. * @slot_time: slot time
  47. * @protection_mode: rts cts protection mode
  48. * @beacon_interval: beacon interval
  49. * @ldpc: low density parity check value
  50. * @nss: number of spatial stream
  51. * @nss_2g: 2.4GHz number of spatial stream
  52. * @nss_5g: 5GHz number of spatial stream
  53. * @tsfadjust: adjusted timer sync value
  54. */
  55. struct vdev_mlme_proto_generic {
  56. uint8_t dtim_period;
  57. uint32_t slot_time;
  58. uint32_t protection_mode;
  59. uint16_t beacon_interval;
  60. uint8_t ldpc;
  61. uint8_t nss;
  62. uint8_t nss_2g;
  63. uint8_t nss_5g;
  64. uint64_t tsfadjust;
  65. };
  66. /**
  67. * struct vdev_mlme_proto_ap - ap specific mlme protocol
  68. * @.
  69. */
  70. struct vdev_mlme_proto_ap {
  71. };
  72. /**
  73. * struct vdev_mlme_proto_sta - sta specific mlme protocol
  74. * @assoc_id: association id of station
  75. * @uapsd_cfg: uapsd configuration
  76. */
  77. struct vdev_mlme_proto_sta {
  78. uint16_t assoc_id;
  79. uint16_t uapsd_cfg;
  80. };
  81. /**
  82. * struct vdev_mlme_proto_bss_color - bss color cfg
  83. * @flags: proposed for future use cases, currently not used.
  84. * @evt_type: bss color collision event.
  85. * @current_bss_color: current bss color.
  86. * @detection_period_ms: scan interval for both AP and STA mode.
  87. * @scan_period_ms: scan period for passive scan to detect collision.
  88. * @free_slot_expiry_time_ms: FW to notify host at timer expiry after
  89. * which Host will disable the bss color.
  90. */
  91. struct vdev_mlme_proto_bss_color {
  92. uint32_t flags;
  93. uint8_t evt_type;
  94. uint32_t current_bss_color;
  95. uint32_t detection_period_ms;
  96. uint32_t scan_period_ms;
  97. uint32_t free_slot_expiry_time_ms;
  98. };
  99. /**
  100. * struct vdev_mlme_vht_info - vdev VHT information
  101. * @caps: vht capabilities
  102. * @subfer: su beam former capability
  103. * @subfee: su beam formee capability
  104. * @mubfer: mu beam former capability
  105. * @mubfee: mu beam formee capability
  106. * @implicit_bf: Implicit BF support
  107. * @sounding_dimension: Beamformer number of sounding dimension
  108. * @bfee_sts_cap: beam formee STA capability
  109. * @allow_vht: vht capability status
  110. */
  111. struct vdev_mlme_vht_info {
  112. uint32_t caps;
  113. uint8_t subfer;
  114. uint8_t mubfer;
  115. uint8_t subfee;
  116. uint8_t mubfee;
  117. uint8_t implicit_bf;
  118. uint8_t sounding_dimension;
  119. uint8_t bfee_sts_cap;
  120. bool allow_vht;
  121. };
  122. /**
  123. * struct vdev_mlme_ht_info - vdev HT information
  124. * @ht_caps: HT capabilities
  125. * @allow_ht: HT capability status
  126. */
  127. struct vdev_mlme_ht_info {
  128. uint32_t ht_caps;
  129. bool allow_ht;
  130. };
  131. /**
  132. * struct vdev_mlme_he_ops_info - vdev mlme HEOPS information
  133. * @he_ops: he ops
  134. */
  135. struct vdev_mlme_he_ops_info {
  136. uint32_t he_ops;
  137. };
  138. /**
  139. * struct vdev_mlme_he_ops_info - vdev protocol structure holding information
  140. * that is used in frames
  141. * @generic: generic protocol information
  142. * @ap: ap specific protocol information
  143. * @sta: sta specific protocol information
  144. * @vht_info: vht information
  145. * @ht_info: ht capabilities information
  146. * @he_ops_info: he ops information
  147. * @bss_color: 11ax HE BSS Color information
  148. */
  149. struct vdev_mlme_proto {
  150. struct vdev_mlme_proto_generic generic;
  151. struct vdev_mlme_proto_ap ap;
  152. struct vdev_mlme_proto_sta sta;
  153. struct vdev_mlme_vht_info vht_info;
  154. struct vdev_mlme_ht_info ht_info;
  155. struct vdev_mlme_he_ops_info he_ops_info;
  156. struct vdev_mlme_proto_bss_color bss_color;
  157. };
  158. /**
  159. * struct vdev_mlme_mgmt_generic - generic vdev mlme mgmt cfg
  160. * @rts_threshold: RTS threshold
  161. * @frag_threshold: Fragmentation threshold
  162. * @probe_delay: time in msec for delaying to send first probe request
  163. * @repeat_probe_time: probe request transmission time
  164. * @drop_unencry: drop unencrypted status
  165. * @ tx_pwrlimit: Tx power limit
  166. * @tx_power: Tx power
  167. * @minpower: Min power
  168. * @maxpower: Max power
  169. * @maxregpower: max regulatory power
  170. * @antennamax: max antenna
  171. * @reg_class_id: reg domain class id
  172. * @ampdu: ampdu limit
  173. * @amsdu: amsdu limit
  174. * @ssid: service set identifier
  175. * @ssid_len: ssid length
  176. * @type: vdev type
  177. * @sub_type: vdev subtype
  178. * @rx_decap_type: rx decap type
  179. * @tx_decap_type: tx decap type
  180. * @disable_hw_ack: disable ha ack flag
  181. * @bssid: bssid
  182. * @phy_mode: phy mode
  183. */
  184. struct vdev_mlme_mgmt_generic {
  185. uint32_t rts_threshold;
  186. uint32_t frag_threshold;
  187. uint32_t probe_delay;
  188. uint32_t repeat_probe_time;
  189. uint32_t drop_unencry;
  190. uint32_t tx_pwrlimit;
  191. uint8_t tx_power;
  192. uint8_t minpower;
  193. uint8_t maxpower;
  194. uint8_t maxregpower;
  195. uint8_t antennamax;
  196. uint8_t reg_class_id;
  197. uint8_t ampdu;
  198. uint8_t amsdu;
  199. char ssid[WLAN_SSID_MAX_LEN + 1];
  200. uint8_t ssid_len;
  201. uint8_t type;
  202. uint8_t subtype;
  203. uint8_t rx_decap_type;
  204. uint8_t tx_decap_type;
  205. bool disable_hw_ack;
  206. uint8_t bssid[QDF_MAC_ADDR_SIZE];
  207. uint32_t phy_mode;
  208. };
  209. /**
  210. * struct vdev_mlme_mgmt_ap - ap specific vdev mlme mgmt cfg
  211. * @.
  212. */
  213. struct vdev_mlme_mgmt_ap {
  214. };
  215. /**
  216. * struct vdev_mlme_mgmt_sta - sta specific vdev mlme mgmt cfg
  217. * @.
  218. */
  219. struct vdev_mlme_mgmt_sta {
  220. };
  221. /**
  222. * struct vdev_mlme_inactivity_params - vdev mlme inactivity parameters
  223. * @bmiss_first_bcnt: bmiss first time
  224. * @bmiss_final_bcnt: bmiss final time
  225. * @keepalive_min_idle_inactive_time_secs: min time AP consider STA to be
  226. * inactive
  227. * @keepalive_max_idle_inactive_time_secs: max inactive idle time for AP to send
  228. * data-null
  229. * @keepalive_max_unresponsive_time_secs: max time to send WMI_STA_KICKOUT
  230. */
  231. struct vdev_mlme_inactivity_params {
  232. uint32_t bmiss_first_bcnt;
  233. uint32_t bmiss_final_bcnt;
  234. uint32_t keepalive_min_idle_inactive_time_secs;
  235. uint32_t keepalive_max_idle_inactive_time_secs;
  236. uint32_t keepalive_max_unresponsive_time_secs;
  237. };
  238. /**
  239. * struct vdev_mlme_rate_info - vdev mlme rate information
  240. * @rate_flags: dynamic bandwidth info
  241. * @per_band_tx_mgmt_rate: per band Tx mgmt rate
  242. * @max_rate: max bandwidth rate
  243. * @tx_mgmt_rate: Tx Mgmt rate
  244. * @bcn_tx_rate: beacon Tx rate
  245. * @type: Type of ratemask configuration
  246. * @lower32: Lower 32 bits in the 1st 64-bit value
  247. * @higher32: Higher 32 bits in the 1st 64-bit value
  248. * @lower32_2: Lower 32 bits in the 2nd 64-bit value
  249. * @half_rate: Half rate
  250. * @quarter_rate: quarter rate
  251. */
  252. struct vdev_mlme_rate_info {
  253. uint32_t rate_flags;
  254. uint32_t per_band_tx_mgmt_rate;
  255. uint32_t max_rate;
  256. uint32_t tx_mgmt_rate;
  257. uint32_t bcn_tx_rate;
  258. uint8_t type;
  259. uint32_t lower32;
  260. uint32_t higher32;
  261. uint32_t lower32_2;
  262. bool half_rate;
  263. bool quarter_rate;
  264. };
  265. /**
  266. * struct vdev_mlme_chainmask_info - vdev mlme chainmask information
  267. * @tx_chainmask: Tx chainmask
  268. * @rx_chainmask: Rx Chainmask
  269. * @num_rx_chain: Num of bits set in Rx chain
  270. * @num_tx_chain: Num of bits set in Tx chain
  271. */
  272. struct vdev_mlme_chainmask_info {
  273. uint8_t tx_chainmask;
  274. uint8_t rx_chainmask;
  275. uint8_t num_rx_chain;
  276. uint8_t num_tx_chain;
  277. };
  278. /**
  279. * struct vdev_mlme_powersave_info - vdev mlme powersave information
  280. * @packet_powersave: packet powersave
  281. * @max_li_of_moddtim: max mod dtim
  282. * @dyndtim_cnt: dynamic dtim count
  283. * @listen_interval: listen interval
  284. * @moddtim_cnt: mod dtim count
  285. */
  286. struct vdev_mlme_powersave_info {
  287. uint32_t packet_powersave;
  288. uint32_t max_li_of_moddtim;
  289. uint32_t dyndtim_cnt;
  290. uint32_t listen_interval;
  291. uint32_t moddtim_cnt;
  292. };
  293. /**
  294. * struct vdev_mlme_beacon_info - vdev mlme beacon information
  295. * @beacon_buffer: buffer allocated for beacon frame
  296. * @beacon_offsets: beacon IE's offsets
  297. */
  298. struct vdev_mlme_beacon_info {
  299. qdf_nbuf_t beacon_buffer;
  300. void *beacon_offsets;
  301. };
  302. /**
  303. * struct vdev_mlme_mbss_11ax - mbss 11ax fields required for up cmd
  304. * @profile_idx: profile index of the connected non-trans ap (mbssid case).
  305. * 0 means invalid.
  306. * @profile_num: the total profile numbers of non-trans aps (mbssid
  307. * case).
  308. * 0 means non-MBSS AP.
  309. * @mbssid-flags: MBSS IE flags indicating vdev type
  310. * @vdevid_trans: id of transmitting vdev for MBSS IE
  311. * @trans_bssid: bssid of transmitted AP (MBSS IE case)
  312. */
  313. struct vdev_mlme_mbss_11ax {
  314. uint32_t profile_idx;
  315. uint32_t profile_num;
  316. uint32_t mbssid_flags;
  317. uint8_t vdevid_trans;
  318. uint8_t trans_bssid[QDF_MAC_ADDR_SIZE];
  319. };
  320. /**
  321. * struct vdev_mlme_mgmt - vdev mlme mgmt related cfg
  322. * @generic: generic mgmt information
  323. * @ap: ap specific mgmt information
  324. * @sta: sta specific mgmt information
  325. * @inactivity_params: inactivity parameters
  326. * @rate_info: bandwidth rate information
  327. * @chainmask_info: Chainmask information
  328. * @powersave_info: Power save parameters
  329. * @beacon_info: beacon buffer information
  330. * @mbss_11ax: MBSS 11ax information
  331. */
  332. struct vdev_mlme_mgmt {
  333. struct vdev_mlme_mgmt_generic generic;
  334. struct vdev_mlme_mgmt_ap ap;
  335. struct vdev_mlme_mgmt_sta sta;
  336. struct vdev_mlme_inactivity_params inactivity_params;
  337. struct vdev_mlme_rate_info rate_info;
  338. struct vdev_mlme_chainmask_info chainmask_info;
  339. struct vdev_mlme_powersave_info powersave_info;
  340. struct vdev_mlme_beacon_info beacon_info;
  341. struct vdev_mlme_mbss_11ax mbss_11ax;
  342. };
  343. /**
  344. * enum beacon_update_op - Beacon update op type
  345. * @BEACON_INIT: Initialize beacon
  346. * @BEACON_REINIT: Re-initialize beacon
  347. * @BEACON_UPDATE: Update dynamic fields of beacon
  348. * @BEACON_CSA: Enable CSA IE
  349. * @BEACON_FREE: Beacon buffer free
  350. */
  351. enum beacon_update_op {
  352. BEACON_INIT,
  353. BEACON_REINIT,
  354. BEACON_UPDATE,
  355. BEACON_CSA,
  356. BEACON_FREE,
  357. };
  358. /**
  359. * enum vdev_cmd_type - Command type
  360. * @START_REQ: Start request
  361. * @RESTART_REQ: Restart request
  362. * @STOP_REQ: STOP request
  363. * @DELETE_REQ: DELETE request
  364. */
  365. enum vdev_cmd_type {
  366. START_REQ,
  367. RESTART_REQ,
  368. STOP_REQ,
  369. DELETE_REQ,
  370. };
  371. /**
  372. * enum vdev_start_resp_type - start respone type
  373. * @START_RESPONSE: Start response
  374. * @RESTART_RESPONSE: Restart response
  375. */
  376. enum vdev_start_resp_type {
  377. START_RESPONSE = 0,
  378. RESTART_RESPONSE,
  379. };
  380. /**
  381. * struct vdev_mlme_ops - VDEV MLME operation callbacks structure
  382. * @mlme_vdev_validate_basic_params: callback to validate VDEV basic params
  383. * @mlme_vdev_reset_proto_params: callback to Reset protocol params
  384. * @mlme_vdev_start_send: callback to initiate actions of VDEV
  385. * MLME start operation
  386. * @mlme_vdev_restart_send: callback to initiate actions of VDEV
  387. * MLME restart operation
  388. * @mlme_vdev_stop_start_send: callback to block start/restart VDEV
  389. * request command
  390. * @mlme_vdev_start_continue: callback to initiate operations on
  391. * LMAC/FW start response
  392. * @mlme_vdev_up_send: callback to initiate actions of VDEV
  393. * MLME up operation
  394. * @mlme_vdev_notify_up_complete: callback to notify VDEV MLME on moving
  395. * to UP state
  396. * @mlme_vdev_notify_roam_start: callback to initiate roaming
  397. * @mlme_vdev_update_beacon: callback to initiate beacon update
  398. * @mlme_vdev_disconnect_peers: callback to initiate disconnection of
  399. * peers
  400. * @mlme_vdev_dfs_cac_timer_stop: callback to stop the DFS CAC timer
  401. * @mlme_vdev_stop_send: callback to initiate actions of VDEV
  402. * MLME stop operation
  403. * @mlme_vdev_stop_continue: callback to initiate operations on
  404. * LMAC/FW stop response
  405. * @mlme_vdev_bss_peer_delete_continue: callback to initiate operations on BSS
  406. * peer delete completion
  407. * @mlme_vdev_down_send: callback to initiate actions of VDEV
  408. * MLME down operation
  409. * @mlme_vdev_notify_start_state_exit: callback to notify on vdev start
  410. * start state exit
  411. * @mlme_vdev_is_newchan_no_cac: callback to check CAC is required
  412. * @mlme_vdev_ext_peer_delete_all_rsp: callback to initiate actions for
  413. * vdev mlme peer delete all response
  414. */
  415. struct vdev_mlme_ops {
  416. QDF_STATUS (*mlme_vdev_validate_basic_params)(
  417. struct vdev_mlme_obj *vdev_mlme,
  418. uint16_t event_data_len, void *event_data);
  419. QDF_STATUS (*mlme_vdev_reset_proto_params)(
  420. struct vdev_mlme_obj *vdev_mlme,
  421. uint16_t event_data_len, void *event_data);
  422. QDF_STATUS (*mlme_vdev_start_send)(
  423. struct vdev_mlme_obj *vdev_mlme,
  424. uint16_t event_data_len, void *event_data);
  425. QDF_STATUS (*mlme_vdev_restart_send)(
  426. struct vdev_mlme_obj *vdev_mlme,
  427. uint16_t event_data_len, void *event_data);
  428. QDF_STATUS (*mlme_vdev_stop_start_send)(
  429. struct vdev_mlme_obj *vdev_mlme,
  430. enum vdev_cmd_type type,
  431. uint16_t event_data_len, void *event_data);
  432. QDF_STATUS (*mlme_vdev_start_continue)(
  433. struct vdev_mlme_obj *vdev_mlme,
  434. uint16_t event_data_len, void *event_data);
  435. QDF_STATUS (*mlme_vdev_sta_conn_start)(
  436. struct vdev_mlme_obj *vdev_mlme,
  437. uint16_t event_data_len, void *event_data);
  438. QDF_STATUS (*mlme_vdev_start_req_failed)(
  439. struct vdev_mlme_obj *vdev_mlme,
  440. uint16_t event_data_len, void *event_data);
  441. QDF_STATUS (*mlme_vdev_up_send)(
  442. struct vdev_mlme_obj *vdev_mlme,
  443. uint16_t event_data_len, void *event_data);
  444. QDF_STATUS (*mlme_vdev_notify_up_complete)(
  445. struct vdev_mlme_obj *vdev_mlme,
  446. uint16_t event_data_len, void *event_data);
  447. QDF_STATUS (*mlme_vdev_notify_roam_start)(
  448. struct vdev_mlme_obj *vdev_mlme,
  449. uint16_t event_data_len, void *event_data);
  450. QDF_STATUS (*mlme_vdev_update_beacon)(
  451. struct vdev_mlme_obj *vdev_mlme,
  452. enum beacon_update_op op,
  453. uint16_t event_data_len, void *event_data);
  454. QDF_STATUS (*mlme_vdev_disconnect_peers)(
  455. struct vdev_mlme_obj *vdev_mlme,
  456. uint16_t event_data_len, void *event_data);
  457. QDF_STATUS (*mlme_vdev_dfs_cac_timer_stop)(
  458. struct vdev_mlme_obj *vdev_mlme,
  459. uint16_t event_data_len, void *event_data);
  460. QDF_STATUS (*mlme_vdev_stop_send)(
  461. struct vdev_mlme_obj *vdev_mlme,
  462. uint16_t event_data_len, void *event_data);
  463. QDF_STATUS (*mlme_vdev_stop_continue)(
  464. struct vdev_mlme_obj *vdev_mlme,
  465. uint16_t event_data_len, void *event_data);
  466. QDF_STATUS (*mlme_vdev_down_send)(
  467. struct vdev_mlme_obj *vdev_mlme,
  468. uint16_t event_data_len, void *event_data);
  469. QDF_STATUS (*mlme_vdev_notify_down_complete)(
  470. struct vdev_mlme_obj *vdev_mlme,
  471. uint16_t event_data_len, void *event_data);
  472. QDF_STATUS (*mlme_vdev_ext_delete_rsp)(
  473. struct vdev_mlme_obj *vdev_mlme,
  474. struct vdev_delete_response *rsp);
  475. QDF_STATUS (*mlme_vdev_ext_stop_rsp)(
  476. struct vdev_mlme_obj *vdev_mlme,
  477. struct vdev_stop_response *rsp);
  478. QDF_STATUS (*mlme_vdev_ext_start_rsp)(
  479. struct vdev_mlme_obj *vdev_mlme,
  480. struct vdev_start_response *rsp);
  481. QDF_STATUS (*mlme_vdev_notify_start_state_exit)(
  482. struct vdev_mlme_obj *vdev_mlme);
  483. QDF_STATUS (*mlme_vdev_is_newchan_no_cac)(
  484. struct vdev_mlme_obj *vdev_mlme);
  485. QDF_STATUS (*mlme_vdev_ext_peer_delete_all_rsp)(
  486. struct vdev_mlme_obj *vdev_mlme,
  487. struct peer_delete_all_response *rsp);
  488. };
  489. #ifdef FEATURE_VDEV_RSP_WAKELOCK
  490. /**
  491. * struct wlan_vdev_wakelock - vdev wake lock sub structure
  492. * @start_wakelock: wakelock for vdev start
  493. * @stop_wakelock: wakelock for vdev stop
  494. * @delete_wakelock: wakelock for vdev delete
  495. * @wmi_cmd_rsp_runtime_lock: run time lock
  496. */
  497. struct vdev_mlme_wakelock {
  498. qdf_wake_lock_t start_wakelock;
  499. qdf_wake_lock_t stop_wakelock;
  500. qdf_wake_lock_t delete_wakelock;
  501. qdf_runtime_lock_t wmi_cmd_rsp_runtime_lock;
  502. };
  503. #endif
  504. /**
  505. * struct vdev_mlme_obj - VDEV MLME component object
  506. * @proto: VDEV MLME proto substructure
  507. * @mgmt: VDEV MLME mgmt substructure
  508. * @sm_lock: VDEV SM lock
  509. * @vdev_cmd_lock: VDEV MLME command atomicity
  510. * @sm_hdl: VDEV SM handle
  511. * @vdev: Pointer to vdev objmgr
  512. * @ops: VDEV MLME callback table
  513. * @ext_vdev_ptr: VDEV MLME legacy pointer
  514. * @vdev_rt: VDEV response timer
  515. * @vdev_wakelock: vdev wakelock sub structure
  516. */
  517. struct vdev_mlme_obj {
  518. struct vdev_mlme_proto proto;
  519. struct vdev_mlme_mgmt mgmt;
  520. #ifdef VDEV_SM_LOCK_SUPPORT
  521. qdf_spinlock_t sm_lock;
  522. qdf_mutex_t vdev_cmd_lock;
  523. #endif
  524. struct wlan_sm *sm_hdl;
  525. struct wlan_objmgr_vdev *vdev;
  526. struct vdev_mlme_ops *ops;
  527. void *ext_vdev_ptr;
  528. struct vdev_response_timer vdev_rt;
  529. #ifdef FEATURE_VDEV_RSP_WAKELOCK
  530. struct vdev_mlme_wakelock vdev_wakelock;
  531. #endif
  532. };
  533. /**
  534. * mlme_vdev_validate_basic_params - Validate basic params
  535. * @vdev_mlme_obj: VDEV MLME comp object
  536. * @event_data_len: data size
  537. * @event_data: event data
  538. *
  539. * API validate MLME VDEV basic parameters
  540. *
  541. * Return: SUCCESS on successful validation
  542. * FAILURE, if any parameter is not initialized
  543. */
  544. static inline QDF_STATUS mlme_vdev_validate_basic_params(
  545. struct vdev_mlme_obj *vdev_mlme,
  546. uint16_t event_data_len, void *event_data)
  547. {
  548. QDF_STATUS ret = QDF_STATUS_SUCCESS;
  549. if ((vdev_mlme->ops) && vdev_mlme->ops->mlme_vdev_validate_basic_params)
  550. ret = vdev_mlme->ops->mlme_vdev_validate_basic_params(
  551. vdev_mlme, event_data_len, event_data);
  552. return ret;
  553. }
  554. /**
  555. * mlme_vdev_reset_proto_params - Reset VDEV protocol params
  556. * @vdev_mlme_obj: VDEV MLME comp object
  557. * @event_data_len: data size
  558. * @event_data: event data
  559. *
  560. * API resets the protocol params fo vdev
  561. *
  562. * Return: SUCCESS on successful reset
  563. * FAILURE, if it fails due to any
  564. */
  565. static inline QDF_STATUS mlme_vdev_reset_proto_params(
  566. struct vdev_mlme_obj *vdev_mlme,
  567. uint16_t event_data_len, void *event_data)
  568. {
  569. QDF_STATUS ret = QDF_STATUS_SUCCESS;
  570. if ((vdev_mlme->ops) && vdev_mlme->ops->mlme_vdev_reset_proto_params)
  571. ret = vdev_mlme->ops->mlme_vdev_reset_proto_params(
  572. vdev_mlme, event_data_len, event_data);
  573. return ret;
  574. }
  575. /**
  576. * mlme_vdev_start_send - Invokes VDEV start operation
  577. * @vdev_mlme_obj: VDEV MLME comp object
  578. * @event_data_len: data size
  579. * @event_data: event data
  580. *
  581. * API invokes VDEV start operation
  582. *
  583. * Return: SUCCESS on successful completion of start operation
  584. * FAILURE, if it fails due to any
  585. */
  586. static inline QDF_STATUS mlme_vdev_start_send(
  587. struct vdev_mlme_obj *vdev_mlme,
  588. uint16_t event_data_len, void *event_data)
  589. {
  590. QDF_STATUS ret = QDF_STATUS_SUCCESS;
  591. if ((vdev_mlme->ops) && vdev_mlme->ops->mlme_vdev_start_send)
  592. ret = vdev_mlme->ops->mlme_vdev_start_send(
  593. vdev_mlme, event_data_len, event_data);
  594. return ret;
  595. }
  596. /**
  597. * mlme_vdev_restart_send - Invokes VDEV restart operation
  598. * @vdev_mlme_obj: VDEV MLME comp object
  599. * @event_data_len: data size
  600. * @event_data: event data
  601. *
  602. * API invokes VDEV restart operation
  603. *
  604. * Return: SUCCESS on successful completion of restart operation
  605. * FAILURE, if it fails due to any
  606. */
  607. static inline QDF_STATUS mlme_vdev_restart_send(
  608. struct vdev_mlme_obj *vdev_mlme,
  609. uint16_t event_data_len, void *event_data)
  610. {
  611. QDF_STATUS ret = QDF_STATUS_SUCCESS;
  612. if ((vdev_mlme->ops) && vdev_mlme->ops->mlme_vdev_restart_send)
  613. ret = vdev_mlme->ops->mlme_vdev_restart_send(
  614. vdev_mlme, event_data_len, event_data);
  615. return ret;
  616. }
  617. /**
  618. * mlme_vdev_stop_start_send - Invoke block VDEV restart operation
  619. * @vdev_mlme_obj: VDEV MLME comp object
  620. * @restart: restart req/start req
  621. * @event_data_len: data size
  622. * @event_data: event data
  623. *
  624. * API invokes stops pending VDEV restart operation
  625. *
  626. * Return: SUCCESS alsways
  627. */
  628. static inline QDF_STATUS mlme_vdev_stop_start_send(
  629. struct vdev_mlme_obj *vdev_mlme,
  630. uint8_t restart,
  631. uint16_t event_data_len, void *event_data)
  632. {
  633. QDF_STATUS ret = QDF_STATUS_SUCCESS;
  634. if ((vdev_mlme->ops) && vdev_mlme->ops->mlme_vdev_stop_start_send)
  635. ret = vdev_mlme->ops->mlme_vdev_stop_start_send(
  636. vdev_mlme, restart, event_data_len, event_data);
  637. return ret;
  638. }
  639. /**
  640. * mlme_vdev_start_continue - VDEV start response handling
  641. * @vdev_mlme_obj: VDEV MLME comp object
  642. * @event_data_len: data size
  643. * @event_data: event data
  644. *
  645. * API invokes VDEV start response actions
  646. *
  647. * Return: SUCCESS on successful completion of start response operation
  648. * FAILURE, if it fails due to any
  649. */
  650. static inline QDF_STATUS mlme_vdev_start_continue(
  651. struct vdev_mlme_obj *vdev_mlme,
  652. uint16_t event_data_len, void *event_data)
  653. {
  654. QDF_STATUS ret = QDF_STATUS_SUCCESS;
  655. if ((vdev_mlme->ops) && vdev_mlme->ops->mlme_vdev_start_continue)
  656. ret = vdev_mlme->ops->mlme_vdev_start_continue(
  657. vdev_mlme, event_data_len, event_data);
  658. return ret;
  659. }
  660. /**
  661. * mlme_vdev_start_req_failed - Invoke Station VDEV connection, if it pause
  662. * @vdev_mlme_obj: VDEV MLME comp object
  663. * @event_data_len: data size
  664. * @event_data: event data
  665. *
  666. * API invokes on START fail response
  667. *
  668. * Return: SUCCESS on successful invocation of callback
  669. * FAILURE, if it fails due to any
  670. */
  671. static inline QDF_STATUS mlme_vdev_start_req_failed(
  672. struct vdev_mlme_obj *vdev_mlme,
  673. uint16_t event_data_len, void *event_data)
  674. {
  675. QDF_STATUS ret = QDF_STATUS_SUCCESS;
  676. if ((vdev_mlme->ops) && vdev_mlme->ops->mlme_vdev_start_req_failed)
  677. ret = vdev_mlme->ops->mlme_vdev_start_req_failed(
  678. vdev_mlme, event_data_len, event_data);
  679. return ret;
  680. }
  681. /**
  682. * mlme_vdev_sta_conn_start - Invoke Station VDEV connection, if it pause
  683. * @vdev_mlme_obj: VDEV MLME comp object
  684. * @event_data_len: data size
  685. * @event_data: event data
  686. *
  687. * API invokes connection SM to start station connection
  688. *
  689. * Return: SUCCESS on successful invocation of connection sm
  690. * FAILURE, if it fails due to any
  691. */
  692. static inline QDF_STATUS mlme_vdev_sta_conn_start(
  693. struct vdev_mlme_obj *vdev_mlme,
  694. uint16_t event_data_len, void *event_data)
  695. {
  696. QDF_STATUS ret = QDF_STATUS_SUCCESS;
  697. if ((vdev_mlme->ops) && vdev_mlme->ops->mlme_vdev_sta_conn_start)
  698. ret = vdev_mlme->ops->mlme_vdev_sta_conn_start(
  699. vdev_mlme, event_data_len, event_data);
  700. return ret;
  701. }
  702. /**
  703. * mlme_vdev_up_send - VDEV up operation
  704. * @vdev_mlme_obj: VDEV MLME comp object
  705. * @event_data_len: data size
  706. * @event_data: event data
  707. *
  708. * API invokes VDEV up operations
  709. *
  710. * Return: SUCCESS on successful completion of up operation
  711. * FAILURE, if it fails due to any
  712. */
  713. static inline QDF_STATUS mlme_vdev_up_send(
  714. struct vdev_mlme_obj *vdev_mlme,
  715. uint16_t event_data_len, void *event_data)
  716. {
  717. QDF_STATUS ret = QDF_STATUS_SUCCESS;
  718. if ((vdev_mlme->ops) && vdev_mlme->ops->mlme_vdev_up_send)
  719. ret = vdev_mlme->ops->mlme_vdev_up_send(
  720. vdev_mlme, event_data_len, event_data);
  721. return ret;
  722. }
  723. /**
  724. * mlme_vdev_notify_up_complete - VDEV up state transition notification
  725. * @vdev_mlme_obj: VDEV MLME comp object
  726. * @event_data_len: data size
  727. * @event_data: event data
  728. *
  729. * API notifies MLME on moving to UP state
  730. *
  731. * Return: SUCCESS on successful completion of up notification
  732. * FAILURE, if it fails due to any
  733. */
  734. static inline
  735. QDF_STATUS mlme_vdev_notify_up_complete(struct vdev_mlme_obj *vdev_mlme,
  736. uint16_t event_data_len,
  737. void *event_data)
  738. {
  739. QDF_STATUS ret = QDF_STATUS_SUCCESS;
  740. if (vdev_mlme->ops && vdev_mlme->ops->mlme_vdev_notify_up_complete)
  741. ret = vdev_mlme->ops->mlme_vdev_notify_up_complete(
  742. vdev_mlme, event_data_len, event_data);
  743. return ret;
  744. }
  745. /**
  746. * mlme_vdev_notify_roam_start - VDEV Roaming notification
  747. * @vdev_mlme_obj: VDEV MLME comp object
  748. * @event_len: data size
  749. * @event_data: event data
  750. *
  751. * API notifies MLME on roaming
  752. *
  753. * Return: SUCCESS on successful completion of up notification
  754. * FAILURE, if it fails due to any
  755. */
  756. static inline
  757. QDF_STATUS mlme_vdev_notify_roam_start(struct vdev_mlme_obj *vdev_mlme,
  758. uint16_t event_len, void *event_data)
  759. {
  760. QDF_STATUS ret = QDF_STATUS_SUCCESS;
  761. if (vdev_mlme->ops && vdev_mlme->ops->mlme_vdev_notify_roam_start)
  762. ret = vdev_mlme->ops->mlme_vdev_notify_roam_start(vdev_mlme,
  763. event_len,
  764. event_data);
  765. return ret;
  766. }
  767. /**
  768. * mlme_vdev_update_beacon - Updates beacon
  769. * @vdev_mlme_obj: VDEV MLME comp object
  770. * @op: beacon update type
  771. * @event_data_len: data size
  772. * @event_data: event data
  773. *
  774. * API updates/allocates/frees the beacon
  775. *
  776. * Return: SUCCESS on successful update of beacon
  777. * FAILURE, if it fails due to any
  778. */
  779. static inline
  780. QDF_STATUS mlme_vdev_update_beacon(struct vdev_mlme_obj *vdev_mlme,
  781. enum beacon_update_op op,
  782. uint16_t event_data_len, void *event_data)
  783. {
  784. QDF_STATUS ret = QDF_STATUS_SUCCESS;
  785. if (vdev_mlme->ops && vdev_mlme->ops->mlme_vdev_update_beacon)
  786. ret = vdev_mlme->ops->mlme_vdev_update_beacon(vdev_mlme, op,
  787. event_data_len, event_data);
  788. return ret;
  789. }
  790. /**
  791. * mlme_vdev_disconnect_peers - Disconnect peers
  792. * @vdev_mlme_obj: VDEV MLME comp object
  793. * @event_data_len: data size
  794. * @event_data: event data
  795. *
  796. * API trigger stations disconnection with AP VDEV or AP disconnection with STA
  797. * VDEV
  798. *
  799. * Return: SUCCESS on successful invocation of station disconnection
  800. * FAILURE, if it fails due to any
  801. */
  802. static inline QDF_STATUS mlme_vdev_disconnect_peers(
  803. struct vdev_mlme_obj *vdev_mlme,
  804. uint16_t event_data_len, void *event_data)
  805. {
  806. QDF_STATUS ret = QDF_STATUS_SUCCESS;
  807. if ((vdev_mlme->ops) && vdev_mlme->ops->mlme_vdev_disconnect_peers)
  808. ret = vdev_mlme->ops->mlme_vdev_disconnect_peers(
  809. vdev_mlme, event_data_len, event_data);
  810. return ret;
  811. }
  812. /**
  813. * mlme_vdev_dfs_cac_timer_stop - Stop CAC timer
  814. * @vdev_mlme_obj: VDEV MLME comp object
  815. * @event_data_len: data size
  816. * @event_data: event data
  817. *
  818. * API stops the CAC timer through DFS API
  819. *
  820. * Return: SUCCESS on successful CAC timer stop
  821. * FAILURE, if it fails due to any
  822. */
  823. static inline QDF_STATUS mlme_vdev_dfs_cac_timer_stop(
  824. struct vdev_mlme_obj *vdev_mlme,
  825. uint16_t event_data_len, void *event_data)
  826. {
  827. QDF_STATUS ret = QDF_STATUS_SUCCESS;
  828. if ((vdev_mlme->ops) && vdev_mlme->ops->mlme_vdev_dfs_cac_timer_stop)
  829. ret = vdev_mlme->ops->mlme_vdev_dfs_cac_timer_stop(
  830. vdev_mlme, event_data_len, event_data);
  831. return ret;
  832. }
  833. /**
  834. * mlme_vdev_stop_send - Invokes VDEV stop operation
  835. * @vdev_mlme_obj: VDEV MLME comp object
  836. * @event_data_len: data size
  837. * @event_data: event data
  838. *
  839. * API invokes VDEV stop operation
  840. *
  841. * Return: SUCCESS on successful completion of stop operation
  842. * FAILURE, if it fails due to any
  843. */
  844. static inline QDF_STATUS mlme_vdev_stop_send(
  845. struct vdev_mlme_obj *vdev_mlme,
  846. uint16_t event_data_len, void *event_data)
  847. {
  848. QDF_STATUS ret = QDF_STATUS_SUCCESS;
  849. if ((vdev_mlme->ops) && vdev_mlme->ops->mlme_vdev_stop_send)
  850. ret = vdev_mlme->ops->mlme_vdev_stop_send(
  851. vdev_mlme, event_data_len, event_data);
  852. return ret;
  853. }
  854. /**
  855. * mlme_vdev_stop_continue - VDEV stop response handling
  856. * @vdev_mlme_obj: VDEV MLME comp object
  857. * @event_data_len: data size
  858. * @event_data: event data
  859. *
  860. * API invokes VDEV stop response actions
  861. *
  862. * Return: SUCCESS on successful completion of stop response operation
  863. * FAILURE, if it fails due to any
  864. */
  865. static inline QDF_STATUS mlme_vdev_stop_continue(
  866. struct vdev_mlme_obj *vdev_mlme,
  867. uint16_t event_data_len, void *event_data)
  868. {
  869. QDF_STATUS ret = QDF_STATUS_SUCCESS;
  870. if ((vdev_mlme->ops) && vdev_mlme->ops->mlme_vdev_stop_continue)
  871. ret = vdev_mlme->ops->mlme_vdev_stop_continue(vdev_mlme,
  872. event_data_len,
  873. event_data);
  874. return ret;
  875. }
  876. /**
  877. * mlme_vdev_down_send - VDEV down operation
  878. * @vdev_mlme_obj: VDEV MLME comp object
  879. * @event_data_len: data size
  880. * @event_data: event data
  881. *
  882. * API invokes VDEV down operation
  883. *
  884. * Return: SUCCESS on successful completion of VDEV down operation
  885. * FAILURE, if it fails due to any
  886. */
  887. static inline QDF_STATUS mlme_vdev_down_send(
  888. struct vdev_mlme_obj *vdev_mlme,
  889. uint16_t event_data_len, void *event_data)
  890. {
  891. QDF_STATUS ret = QDF_STATUS_SUCCESS;
  892. if ((vdev_mlme->ops) && vdev_mlme->ops->mlme_vdev_down_send)
  893. ret = vdev_mlme->ops->mlme_vdev_down_send(
  894. vdev_mlme, event_data_len, event_data);
  895. return ret;
  896. }
  897. /**
  898. * mlme_vdev_notify_down_complete - VDEV init state transition notification
  899. * @vdev_mlme_obj: VDEV MLME comp object
  900. * @event_data_len: data size
  901. * @event_data: event data
  902. *
  903. * API notifies MLME on moving to INIT state
  904. *
  905. * Return: SUCCESS on successful completion of down notification
  906. * FAILURE, if it fails due to any
  907. */
  908. static inline QDF_STATUS mlme_vdev_notify_down_complete(
  909. struct vdev_mlme_obj *vdev_mlme,
  910. uint16_t event_data_len, void *event_data)
  911. {
  912. QDF_STATUS ret = QDF_STATUS_SUCCESS;
  913. if ((vdev_mlme->ops) && vdev_mlme->ops->mlme_vdev_notify_down_complete)
  914. ret = vdev_mlme->ops->mlme_vdev_notify_down_complete(
  915. vdev_mlme, event_data_len, event_data);
  916. return ret;
  917. }
  918. /**
  919. * mlme_vdev_notify_start_state_exit - VDEV SM start state exit notification
  920. * @vdev_mlme_obj: VDEV MLME comp object
  921. *
  922. * API notifies on start state exit
  923. *
  924. * Return: SUCCESS on successful completion of notification
  925. * FAILURE, if it fails due to any
  926. */
  927. static inline QDF_STATUS mlme_vdev_notify_start_state_exit(
  928. struct vdev_mlme_obj *vdev_mlme)
  929. {
  930. QDF_STATUS ret = QDF_STATUS_SUCCESS;
  931. if ((vdev_mlme->ops) &&
  932. vdev_mlme->ops->mlme_vdev_notify_start_state_exit)
  933. ret = vdev_mlme->ops->mlme_vdev_notify_start_state_exit(
  934. vdev_mlme);
  935. return ret;
  936. }
  937. /**
  938. * mlme_vdev_is_newchan_no_cac - Checks new channel requires CAC
  939. * @vdev_mlme_obj: VDEV MLME comp object
  940. *
  941. * API checks whether Channel needs CAC period,
  942. * if yes, it moves to SUSPEND_RESTART to disconnect stations before
  943. * sending RESTART to FW, otherwise, it moves to RESTART_PROGRESS substate
  944. *
  945. * Return: SUCCESS to move to RESTART_PROGRESS substate
  946. * FAILURE, move to SUSPEND_RESTART state
  947. */
  948. static inline QDF_STATUS mlme_vdev_is_newchan_no_cac(
  949. struct vdev_mlme_obj *vdev_mlme)
  950. {
  951. QDF_STATUS ret = QDF_STATUS_SUCCESS;
  952. if ((vdev_mlme->ops) && vdev_mlme->ops->mlme_vdev_is_newchan_no_cac)
  953. ret = vdev_mlme->ops->mlme_vdev_is_newchan_no_cac(vdev_mlme);
  954. return ret;
  955. }
  956. #ifdef CMN_VDEV_MGR_TGT_IF_ENABLE
  957. /**
  958. * wlan_vdev_mlme_set_ssid() - set ssid
  959. * @vdev: VDEV object
  960. * @ssid: SSID (input)
  961. * @ssid_len: Length of SSID
  962. *
  963. * API to set the SSID of VDEV
  964. *
  965. * Caller need to acquire lock with wlan_vdev_obj_lock()
  966. *
  967. * Return: SUCCESS, if update is done
  968. * FAILURE, if ssid length is > max ssid len
  969. */
  970. static inline QDF_STATUS wlan_vdev_mlme_set_ssid(
  971. struct wlan_objmgr_vdev *vdev,
  972. const uint8_t *ssid, uint8_t ssid_len)
  973. {
  974. struct vdev_mlme_obj *vdev_mlme;
  975. /* This API is invoked with lock acquired, do not add log prints */
  976. vdev_mlme = wlan_vdev_mlme_get_cmpt_obj(vdev);
  977. if (!vdev_mlme)
  978. return QDF_STATUS_E_FAILURE;
  979. if (ssid_len <= WLAN_SSID_MAX_LEN) {
  980. qdf_mem_copy(vdev_mlme->mgmt.generic.ssid, ssid, ssid_len);
  981. vdev_mlme->mgmt.generic.ssid_len = ssid_len;
  982. } else {
  983. vdev_mlme->mgmt.generic.ssid_len = 0;
  984. return QDF_STATUS_E_FAILURE;
  985. }
  986. return QDF_STATUS_SUCCESS;
  987. }
  988. /**
  989. * wlan_vdev_mlme_get_ssid() - get ssid
  990. * @vdev: VDEV object
  991. * @ssid: SSID
  992. * @ssid_len: Length of SSID
  993. *
  994. * API to get the SSID of VDEV, it updates the SSID and its length
  995. * in @ssid, @ssid_len respectively
  996. *
  997. * Caller need to acquire lock with wlan_vdev_obj_lock()
  998. *
  999. * Return: SUCCESS, if update is done
  1000. * FAILURE, if ssid length is > max ssid len
  1001. */
  1002. static inline QDF_STATUS wlan_vdev_mlme_get_ssid(
  1003. struct wlan_objmgr_vdev *vdev,
  1004. uint8_t *ssid, uint8_t *ssid_len)
  1005. {
  1006. struct vdev_mlme_obj *vdev_mlme;
  1007. /* This API is invoked with lock acquired, do not add log prints */
  1008. vdev_mlme = wlan_vdev_mlme_get_cmpt_obj(vdev);
  1009. if (!vdev_mlme)
  1010. return QDF_STATUS_E_FAILURE;
  1011. if (vdev_mlme->mgmt.generic.ssid_len > 0) {
  1012. *ssid_len = vdev_mlme->mgmt.generic.ssid_len;
  1013. qdf_mem_copy(ssid, vdev_mlme->mgmt.generic.ssid, *ssid_len);
  1014. } else {
  1015. *ssid_len = 0;
  1016. return QDF_STATUS_E_FAILURE;
  1017. }
  1018. return QDF_STATUS_SUCCESS;
  1019. }
  1020. /**
  1021. * wlan_vdev_mlme_set_nss() - set NSS
  1022. * @vdev: VDEV object
  1023. * @nss: nss configured by user
  1024. *
  1025. * API to set the Number of Spatial streams
  1026. *
  1027. * Return: void
  1028. */
  1029. static inline void wlan_vdev_mlme_set_nss(
  1030. struct wlan_objmgr_vdev *vdev,
  1031. uint8_t nss)
  1032. {
  1033. struct vdev_mlme_obj *vdev_mlme;
  1034. vdev_mlme = wlan_vdev_mlme_get_cmpt_obj(vdev);
  1035. if (!vdev_mlme)
  1036. return;
  1037. vdev_mlme->proto.generic.nss = nss;
  1038. }
  1039. /**
  1040. * wlan_vdev_mlme_get_nss() - get NSS
  1041. * @vdev: VDEV object
  1042. *
  1043. * API to get the Number of Spatial Streams
  1044. *
  1045. * Return:
  1046. * @nss: nss value
  1047. */
  1048. static inline uint8_t wlan_vdev_mlme_get_nss(
  1049. struct wlan_objmgr_vdev *vdev)
  1050. {
  1051. struct vdev_mlme_obj *vdev_mlme;
  1052. vdev_mlme = wlan_vdev_mlme_get_cmpt_obj(vdev);
  1053. if (!vdev_mlme)
  1054. return 0;
  1055. return vdev_mlme->proto.generic.nss;
  1056. }
  1057. /**
  1058. * wlan_vdev_mlme_set_txchainmask() - set Tx chainmask
  1059. * @vdev: VDEV object
  1060. * @chainmask : chainmask either configured by user or max supported
  1061. *
  1062. * API to set the Tx chainmask
  1063. *
  1064. * Return: void
  1065. */
  1066. static inline void wlan_vdev_mlme_set_txchainmask(
  1067. struct wlan_objmgr_vdev *vdev,
  1068. uint8_t chainmask)
  1069. {
  1070. struct vdev_mlme_obj *vdev_mlme;
  1071. vdev_mlme = wlan_vdev_mlme_get_cmpt_obj(vdev);
  1072. if (!vdev_mlme)
  1073. return;
  1074. vdev_mlme->mgmt.chainmask_info.tx_chainmask = chainmask;
  1075. }
  1076. /**
  1077. * wlan_vdev_mlme_get_txchainmask() - get Tx chainmask
  1078. * @vdev: VDEV object
  1079. *
  1080. * API to get the Tx chainmask
  1081. *
  1082. * Return:
  1083. * @chainmask : Tx chainmask either configured by user or max supported
  1084. */
  1085. static inline uint8_t wlan_vdev_mlme_get_txchainmask(
  1086. struct wlan_objmgr_vdev *vdev)
  1087. {
  1088. struct vdev_mlme_obj *vdev_mlme;
  1089. vdev_mlme = wlan_vdev_mlme_get_cmpt_obj(vdev);
  1090. if (!vdev_mlme)
  1091. return 0;
  1092. return vdev_mlme->mgmt.chainmask_info.tx_chainmask;
  1093. }
  1094. /**
  1095. * wlan_vdev_mlme_set_rxchainmask() - set Rx chainmask
  1096. * @vdev: VDEV object
  1097. * @chainmask : Rx chainmask either configured by user or max supported
  1098. *
  1099. * API to set the Rx chainmask
  1100. *
  1101. * Return: void
  1102. */
  1103. static inline void wlan_vdev_mlme_set_rxchainmask(
  1104. struct wlan_objmgr_vdev *vdev,
  1105. uint8_t chainmask)
  1106. {
  1107. struct vdev_mlme_obj *vdev_mlme;
  1108. vdev_mlme = wlan_vdev_mlme_get_cmpt_obj(vdev);
  1109. if (!vdev_mlme)
  1110. return;
  1111. vdev_mlme->mgmt.chainmask_info.rx_chainmask = chainmask;
  1112. }
  1113. /**
  1114. * wlan_vdev_mlme_get_rxchainmask() - get Rx chainmask
  1115. * @vdev: VDEV object
  1116. *
  1117. * API to get the Rx chainmask
  1118. *
  1119. * Return:
  1120. * @chainmask : Rx chainmask either configured by user or max supported
  1121. */
  1122. static inline uint8_t wlan_vdev_mlme_get_rxchainmask(
  1123. struct wlan_objmgr_vdev *vdev)
  1124. {
  1125. struct vdev_mlme_obj *vdev_mlme;
  1126. /* This API is invoked with lock acquired, do not add log prints */
  1127. vdev_mlme = wlan_vdev_mlme_get_cmpt_obj(vdev);
  1128. if (!vdev_mlme)
  1129. return 0;
  1130. return vdev_mlme->mgmt.chainmask_info.rx_chainmask;
  1131. }
  1132. /**
  1133. * wlan_vdev_mlme_set_txpower() - set tx power
  1134. * @vdev: VDEV object
  1135. * @txpow: tx power either configured by used or max allowed
  1136. *
  1137. * API to set the tx power
  1138. *
  1139. * Return: void
  1140. */
  1141. static inline void wlan_vdev_mlme_set_txpower(
  1142. struct wlan_objmgr_vdev *vdev,
  1143. uint8_t txpow)
  1144. {
  1145. struct vdev_mlme_obj *vdev_mlme;
  1146. vdev_mlme = wlan_vdev_mlme_get_cmpt_obj(vdev);
  1147. if (!vdev_mlme)
  1148. return;
  1149. vdev_mlme->mgmt.generic.tx_power = txpow;
  1150. }
  1151. /**
  1152. * wlan_vdev_mlme_get_txpower() - get tx power
  1153. * @vdev: VDEV object
  1154. *
  1155. * API to get the tx power
  1156. *
  1157. * Return:
  1158. * @txpow: tx power either configured by used or max allowed
  1159. */
  1160. static inline uint8_t wlan_vdev_mlme_get_txpower(
  1161. struct wlan_objmgr_vdev *vdev)
  1162. {
  1163. struct vdev_mlme_obj *vdev_mlme;
  1164. vdev_mlme = wlan_vdev_mlme_get_cmpt_obj(vdev);
  1165. if (!vdev_mlme)
  1166. return 0;
  1167. return vdev_mlme->mgmt.generic.tx_power;
  1168. }
  1169. /**
  1170. * wlan_vdev_mlme_set_maxrate() - set max rate
  1171. * @vdev: VDEV object
  1172. * @maxrate: configured by used or based on configured mode
  1173. *
  1174. * API to set the max rate the vdev supports
  1175. *
  1176. * Return: void
  1177. */
  1178. static inline void wlan_vdev_mlme_set_maxrate(
  1179. struct wlan_objmgr_vdev *vdev,
  1180. uint32_t maxrate)
  1181. {
  1182. struct vdev_mlme_obj *vdev_mlme;
  1183. vdev_mlme = wlan_vdev_mlme_get_cmpt_obj(vdev);
  1184. if (!vdev_mlme)
  1185. return;
  1186. vdev_mlme->mgmt.rate_info.max_rate = maxrate;
  1187. }
  1188. /**
  1189. * wlan_vdev_mlme_get_maxrate() - get max rate
  1190. * @vdev: VDEV object
  1191. *
  1192. * API to get the max rate the vdev supports
  1193. *
  1194. * Return:
  1195. * @maxrate: configured by used or based on configured mode
  1196. */
  1197. static inline uint32_t wlan_vdev_mlme_get_maxrate(
  1198. struct wlan_objmgr_vdev *vdev)
  1199. {
  1200. struct vdev_mlme_obj *vdev_mlme;
  1201. vdev_mlme = wlan_vdev_mlme_get_cmpt_obj(vdev);
  1202. if (!vdev_mlme)
  1203. return 0;
  1204. return vdev_mlme->mgmt.rate_info.max_rate;
  1205. }
  1206. /**
  1207. * wlan_vdev_mlme_set_txmgmtrate() - set txmgmtrate
  1208. * @vdev: VDEV object
  1209. * @txmgmtrate: Tx Mgmt rate
  1210. *
  1211. * API to set Mgmt Tx rate
  1212. *
  1213. * Return: void
  1214. */
  1215. static inline void wlan_vdev_mlme_set_txmgmtrate(
  1216. struct wlan_objmgr_vdev *vdev,
  1217. uint32_t txmgmtrate)
  1218. {
  1219. struct vdev_mlme_obj *vdev_mlme;
  1220. vdev_mlme = wlan_vdev_mlme_get_cmpt_obj(vdev);
  1221. if (!vdev_mlme)
  1222. return;
  1223. vdev_mlme->mgmt.rate_info.tx_mgmt_rate = txmgmtrate;
  1224. }
  1225. /**
  1226. * wlan_vdev_mlme_get_txmgmtrate() - get txmgmtrate
  1227. * @vdev: VDEV object
  1228. *
  1229. * API to get Mgmt Tx rate
  1230. *
  1231. * Return:
  1232. * @txmgmtrate: Tx Mgmt rate
  1233. */
  1234. static inline uint32_t wlan_vdev_mlme_get_txmgmtrate(
  1235. struct wlan_objmgr_vdev *vdev)
  1236. {
  1237. struct vdev_mlme_obj *vdev_mlme;
  1238. vdev_mlme = wlan_vdev_mlme_get_cmpt_obj(vdev);
  1239. if (!vdev_mlme)
  1240. return 0;
  1241. return vdev_mlme->mgmt.rate_info.tx_mgmt_rate;
  1242. }
  1243. #endif /* CMN_VDEV_MGR_TGT_IF_ENABLE */
  1244. #endif