wlan_defs.h 26 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858
  1. /*
  2. * Copyright (c) 2004-2010, 2013-2016 The Linux Foundation. All rights reserved.
  3. *
  4. * Previously licensed under the ISC license by Qualcomm Atheros, Inc.
  5. *
  6. *
  7. * Permission to use, copy, modify, and/or distribute this software for
  8. * any purpose with or without fee is hereby granted, provided that the
  9. * above copyright notice and this permission notice appear in all
  10. * copies.
  11. *
  12. * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
  13. * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
  14. * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
  15. * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
  16. * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
  17. * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
  18. * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  19. * PERFORMANCE OF THIS SOFTWARE.
  20. */
  21. /*
  22. * This file was originally distributed by Qualcomm Atheros, Inc.
  23. * under proprietary terms before Copyright ownership was assigned
  24. * to the Linux Foundation.
  25. */
  26. #ifndef __WLAN_DEFS_H__
  27. #define __WLAN_DEFS_H__
  28. /* A_COMPILE_TIME_ASSERT */
  29. #include <a_osapi.h>
  30. /*
  31. * This file contains WLAN definitions that may be used across both
  32. * Host and Target software.
  33. */
  34. /*
  35. * MAX_SPATIAL_STREAM should be defined in a fwconfig_xxx.h file,
  36. * but for now provide a default value here in case it's not defined
  37. * in the fwconfig_xxx.h file.
  38. */
  39. #define NUM_SPATIAL_STREAM 2
  40. #ifndef MAX_SPATIAL_STREAM
  41. #define MAX_SPATIAL_STREAM 3
  42. #endif
  43. /*
  44. * MAX_SPATIAL_STREAM_ANY -
  45. * what is the largest number of spatial streams that any target supports
  46. */
  47. #define MAX_SPATIAL_STREAM_ANY 4
  48. #ifndef CONFIG_160MHZ_SUPPORT
  49. #define CONFIG_160MHZ_SUPPORT 0
  50. #endif
  51. #ifndef SUPPORT_11AX
  52. #define SUPPORT_11AX 0 /* 11ax not supported by default */
  53. #endif
  54. /* defines to set Packet extension values which can be 0 us, 8 us or 16 us */
  55. /* NOTE: Below values cannot be changed without breaking WMI Compatibility */
  56. #define MAX_HE_NSS 8
  57. #define MAX_HE_MODULATION 8
  58. #define MAX_HE_RU 4
  59. #define HE_MODULATION_NONE 7
  60. #define HE_PET_0_USEC 0
  61. #define HE_PET_8_USEC 1
  62. #define HE_PET_16_USEC 2
  63. typedef enum {
  64. MODE_11A = 0, /* 11a Mode */
  65. MODE_11G = 1, /* 11b/g Mode */
  66. MODE_11B = 2, /* 11b Mode */
  67. MODE_11GONLY = 3, /* 11g only Mode */
  68. MODE_11NA_HT20 = 4, /* 11a HT20 mode */
  69. MODE_11NG_HT20 = 5, /* 11g HT20 mode */
  70. MODE_11NA_HT40 = 6, /* 11a HT40 mode */
  71. MODE_11NG_HT40 = 7, /* 11g HT40 mode */
  72. MODE_11AC_VHT20 = 8,
  73. MODE_11AC_VHT40 = 9,
  74. MODE_11AC_VHT80 = 10,
  75. MODE_11AC_VHT20_2G = 11,
  76. MODE_11AC_VHT40_2G = 12,
  77. MODE_11AC_VHT80_2G = 13,
  78. #if CONFIG_160MHZ_SUPPORT
  79. MODE_11AC_VHT80_80 = 14,
  80. MODE_11AC_VHT160 = 15,
  81. #endif
  82. #if SUPPORT_11AX
  83. MODE_11AX_HE20 = 16,
  84. MODE_11AX_HE40 = 17,
  85. MODE_11AX_HE80 = 18,
  86. MODE_11AX_HE80_80 = 19,
  87. MODE_11AX_HE160 = 20,
  88. MODE_11AX_HE20_2G = 21,
  89. MODE_11AX_HE40_2G = 22,
  90. MODE_11AX_HE80_2G = 23,
  91. #endif
  92. /*
  93. * MODE_UNKNOWN should not be used within the host / target interface.
  94. * Thus, it is permissible for ODE_UNKNOWN to be conditionally-defined,
  95. * taking different values when compiling for different targets.
  96. */
  97. MODE_UNKNOWN,
  98. MODE_UNKNOWN_NO_160MHZ_SUPPORT = 14, /* not needed? */
  99. /* MODE_UNKNOWN_NO_11AX_SUPPORT = 16,*/ /* not needed? */
  100. /* MODE_UNKNOWN_11AX_SUPPORT = 24,*/ /* not needed? */
  101. MODE_UNKNOWN_160MHZ_SUPPORT = MODE_UNKNOWN, /* not needed? */
  102. #ifdef ATHR_WIN_NWF
  103. PHY_MODE_MAX = MODE_UNKNOWN,
  104. PHY_MODE_MAX_NO_160_MHZ_SUPPORT = MODE_UNKNOWN_NO_160MHZ_SUPPORT,
  105. PHY_MODE_MAX_160_MHZ_SUPPORT = MODE_UNKNOWN_160MHZ_SUPPORT,
  106. #else
  107. MODE_MAX = MODE_UNKNOWN,
  108. MODE_MAX_NO_160_MHZ_SUPPORT = MODE_UNKNOWN_NO_160MHZ_SUPPORT,
  109. MODE_MAX_160_MHZ_SUPPORT = MODE_UNKNOWN_160MHZ_SUPPORT,
  110. #endif
  111. } WLAN_PHY_MODE;
  112. #if CONFIG_160MHZ_SUPPORT == 0
  113. A_COMPILE_TIME_ASSERT(
  114. mode_unknown_value_consistency_Check,
  115. MODE_UNKNOWN == MODE_UNKNOWN_NO_160MHZ_SUPPORT);
  116. #else
  117. A_COMPILE_TIME_ASSERT(
  118. mode_unknown_value_consistency_Check,
  119. MODE_UNKNOWN == MODE_UNKNOWN_160MHZ_SUPPORT);
  120. #endif
  121. typedef enum {
  122. VHT_MODE_NONE = 0, /* NON VHT Mode, e.g., HT, DSSS, CCK */
  123. VHT_MODE_20M = 1,
  124. VHT_MODE_40M = 2,
  125. VHT_MODE_80M = 3,
  126. VHT_MODE_160M = 4
  127. } VHT_OPER_MODE;
  128. typedef enum {
  129. WLAN_11A_CAPABILITY = 1,
  130. WLAN_11G_CAPABILITY = 2,
  131. WLAN_11AG_CAPABILITY = 3,
  132. } WLAN_CAPABILITY;
  133. #if (NUM_SPATIAL_STREAM > 3)
  134. #define A_RATEMASK A_UINT64
  135. #else
  136. #define A_RATEMASK A_UINT32
  137. #endif
  138. #define A_RATEMASK_NUM_OCTET (sizeof (A_RATEMASK))
  139. #define A_RATEMASK_NUM_BITS ((sizeof (A_RATEMASK)) << 3)
  140. #if CONFIG_160MHZ_SUPPORT != 0
  141. #define IS_MODE_VHT(mode) (((mode) == MODE_11AC_VHT20) || \
  142. ((mode) == MODE_11AC_VHT40) || \
  143. ((mode) == MODE_11AC_VHT80) || \
  144. ((mode) == MODE_11AC_VHT80_80) || \
  145. ((mode) == MODE_11AC_VHT160))
  146. #else
  147. #define IS_MODE_VHT(mode) (((mode) == MODE_11AC_VHT20) || \
  148. ((mode) == MODE_11AC_VHT40) || \
  149. ((mode) == MODE_11AC_VHT80))
  150. #endif
  151. #define IS_MODE_HE(mode) (((mode) == MODE_11AX_HE20) || \
  152. ((mode) == MODE_11AX_HE40) || \
  153. ((mode) == MODE_11AX_HE80) || \
  154. ((mode) == MODE_11AX_HE80_80) || \
  155. ((mode) == MODE_11AX_HE160) || \
  156. ((mode) == MODE_11AX_HE20_2G) || \
  157. ((mode) == MODE_11AX_HE40_2G) || \
  158. ((mode) == MODE_11AX_HE80_2G))
  159. #define IS_MODE_VHT_2G(mode) (((mode) == MODE_11AC_VHT20_2G) || \
  160. ((mode) == MODE_11AC_VHT40_2G) || \
  161. ((mode) == MODE_11AC_VHT80_2G))
  162. #define IS_MODE_11A(mode) (((mode) == MODE_11A) || \
  163. ((mode) == MODE_11NA_HT20) || \
  164. ((mode) == MODE_11NA_HT40) || \
  165. (IS_MODE_VHT(mode)))
  166. #define IS_MODE_11B(mode) ((mode) == MODE_11B)
  167. #define IS_MODE_11G(mode) (((mode) == MODE_11G) || \
  168. ((mode) == MODE_11GONLY) || \
  169. ((mode) == MODE_11NG_HT20) || \
  170. ((mode) == MODE_11NG_HT40) || \
  171. (IS_MODE_VHT_2G(mode)))
  172. #define IS_MODE_11GN(mode) (((mode) == MODE_11NG_HT20) || \
  173. ((mode) == MODE_11NG_HT40))
  174. #define IS_MODE_11GONLY(mode) ((mode) == MODE_11GONLY)
  175. enum {
  176. /* 11a channels */
  177. REGDMN_MODE_11A = 0x00000001,
  178. /* 11a turbo-only channels */
  179. REGDMN_MODE_TURBO = 0x00000002,
  180. /* 11b channels */
  181. REGDMN_MODE_11B = 0x00000004,
  182. /* 11g channels (OFDM only) */
  183. REGDMN_MODE_PUREG = 0x00000008,
  184. /* XXX historical */
  185. REGDMN_MODE_11G = 0x00000008,
  186. /* 11g+Turbo channels */
  187. REGDMN_MODE_108G = 0x00000020,
  188. /* 11a+Turbo channels */
  189. REGDMN_MODE_108A = 0x00000040,
  190. /* XR channels */
  191. REGDMN_MODE_XR = 0x00000100,
  192. /* 11A half rate channels */
  193. REGDMN_MODE_11A_HALF_RATE = 0x00000200,
  194. /* 11A quarter rate channels */
  195. REGDMN_MODE_11A_QUARTER_RATE = 0x00000400,
  196. /* 11N-G HT20 channels */
  197. REGDMN_MODE_11NG_HT20 = 0x00000800,
  198. /* 11N-A HT20 channels */
  199. REGDMN_MODE_11NA_HT20 = 0x00001000,
  200. /* 11N-G HT40 + channels */
  201. REGDMN_MODE_11NG_HT40PLUS = 0x00002000,
  202. /* 11N-G HT40 - channels */
  203. REGDMN_MODE_11NG_HT40MINUS = 0x00004000,
  204. /* 11N-A HT40 + channels */
  205. REGDMN_MODE_11NA_HT40PLUS = 0x00008000,
  206. /* 11N-A HT40 - channels */
  207. REGDMN_MODE_11NA_HT40MINUS = 0x00010000,
  208. /* 5Ghz, VHT20 */
  209. REGDMN_MODE_11AC_VHT20 = 0x00020000,
  210. /* 5Ghz, VHT40 + channels */
  211. REGDMN_MODE_11AC_VHT40PLUS = 0x00040000,
  212. /* 5Ghz VHT40 - channels */
  213. REGDMN_MODE_11AC_VHT40MINUS = 0x00080000,
  214. /* 5Ghz, VHT80 channels */
  215. REGDMN_MODE_11AC_VHT80 = 0x000100000,
  216. REGDMN_MODE_11AC_VHT20_2G = 0x000200000, /* 2Ghz, VHT20 */
  217. REGDMN_MODE_11AC_VHT40_2G = 0x000400000, /* 2Ghz, VHT40 */
  218. REGDMN_MODE_11AC_VHT80_2G = 0x000800000, /* 2Ghz, VHT80 */
  219. REGDMN_MODE_11AC_VHT160 = 0x001000000, /* 5Ghz, VHT160 */
  220. REGDMN_MODE_11AC_VHT40_2GPLUS = 0x002000000, /* 2Ghz, VHT40+ */
  221. REGDMN_MODE_11AC_VHT40_2GMINUS = 0x004000000, /* 2Ghz, VHT40- */
  222. REGDMN_MODE_11AC_VHT80_80 = 0x008000000, /* 5GHz, VHT80+80 */
  223. };
  224. #define REGDMN_MODE_ALL (0xFFFFFFFF) /* REGDMN_MODE_ALL is defined out of the enum
  225. * to prevent the ARM compile "warning #66:
  226. * enumeration value is out of int range"
  227. * Anyway, this is a BIT-OR of all possible values.
  228. */
  229. #define REGDMN_CAP1_CHAN_HALF_RATE 0x00000001
  230. #define REGDMN_CAP1_CHAN_QUARTER_RATE 0x00000002
  231. #define REGDMN_CAP1_CHAN_HAL49GHZ 0x00000004
  232. /* regulatory capabilities */
  233. #define REGDMN_EEPROM_EEREGCAP_EN_FCC_MIDBAND 0x0040
  234. #define REGDMN_EEPROM_EEREGCAP_EN_KK_U1_EVEN 0x0080
  235. #define REGDMN_EEPROM_EEREGCAP_EN_KK_U2 0x0100
  236. #define REGDMN_EEPROM_EEREGCAP_EN_KK_MIDBAND 0x0200
  237. #define REGDMN_EEPROM_EEREGCAP_EN_KK_U1_ODD 0x0400
  238. #define REGDMN_EEPROM_EEREGCAP_EN_KK_NEW_11A 0x0800
  239. typedef struct {
  240. A_UINT32 tlv_header; /* TLV tag and len; tag equals WMI_TLVTAG_STRUC_HAL_REG_CAPABILITIES */
  241. A_UINT32 eeprom_rd; /* regdomain value specified in EEPROM */
  242. A_UINT32 eeprom_rd_ext; /* regdomain */
  243. A_UINT32 regcap1; /* CAP1 capabilities bit map. */
  244. A_UINT32 regcap2; /* REGDMN EEPROM CAP. */
  245. A_UINT32 wireless_modes; /* REGDMN MODE */
  246. A_UINT32 low_2ghz_chan;
  247. A_UINT32 high_2ghz_chan;
  248. A_UINT32 low_5ghz_chan;
  249. A_UINT32 high_5ghz_chan;
  250. } HAL_REG_CAPABILITIES;
  251. /*
  252. * Used to update rate-control logic with the status of the tx-completion.
  253. * In host-based implementation of the rate-control feature, this struture is used to
  254. * create the payload for HTT message/s from target to host.
  255. */
  256. typedef struct {
  257. A_UINT8 rateCode;
  258. A_UINT8 flags;
  259. } RATE_CODE;
  260. typedef struct {
  261. RATE_CODE ptx_rc; /* rate code, bw, chain mask sgi */
  262. A_UINT8 reserved[2];
  263. A_UINT32 flags; /* Encodes information such as excessive
  264. retransmission, aggregate, some info
  265. from .11 frame control,
  266. STBC, LDPC, (SGI and Tx Chain Mask
  267. are encoded in ptx_rc->flags field),
  268. AMPDU truncation (BT/time based etc.),
  269. RTS/CTS attempt */
  270. A_UINT32 num_enqued; /* # of MPDUs (for non-AMPDU 1) for this rate */
  271. A_UINT32 num_retries; /* Total # of transmission attempt for this rate */
  272. A_UINT32 num_failed; /* # of failed MPDUs in A-MPDU, 0 otherwise */
  273. A_UINT32 ack_rssi; /* ACK RSSI: b'7..b'0 avg RSSI across all chain */
  274. A_UINT32 time_stamp; /* ACK timestamp (helps determine age) */
  275. A_UINT32 is_probe; /* Valid if probing. Else, 0 */
  276. A_UINT32 ba_win_size; /* b'7..b0, block Ack Window size, b'31..b8 Resvd */
  277. A_UINT32 failed_ba_bmap_0_31; /* failed BA bitmap 0..31 */
  278. A_UINT32 failed_ba_bmap_32_63; /* failed BA bitmap 32..63 */
  279. A_UINT32 bmap_tried_0_31; /* enqued bitmap 0..31 */
  280. A_UINT32 bmap_tried_32_63; /* enqued bitmap 32..63 */
  281. } RC_TX_DONE_PARAMS;
  282. #define RC_SET_TX_DONE_INFO(_dst, _rc, _f, _nq, _nr, _nf, _rssi, _ts) \
  283. do { \
  284. (_dst).ptx_rc.rateCode = (_rc).rateCode; \
  285. (_dst).ptx_rc.flags = (_rc).flags; \
  286. (_dst).flags = (_f); \
  287. (_dst).num_enqued = (_nq); \
  288. (_dst).num_retries = (_nr); \
  289. (_dst).num_failed = (_nf); \
  290. (_dst).ack_rssi = (_rssi); \
  291. (_dst).time_stamp = (_ts); \
  292. } while (0)
  293. #define RC_SET_TXBF_DONE_INFO(_dst, _f) \
  294. do { \
  295. (_dst).flags |= (_f); \
  296. } while (0)
  297. /* NOTE: NUM_DYN_BW and NUM_SCHED_ENTRIES cannot be changed without breaking WMI Compatibility */
  298. #define NUM_SCHED_ENTRIES 2
  299. #define NUM_DYN_BW_MAX 4
  300. /* Some products only use 20/40/80; some use 20/40/80/160 */
  301. #ifndef NUM_DYN_BW
  302. /* default: support up through 80 MHz */
  303. #define NUM_DYN_BW 3
  304. #endif
  305. #define NUM_DYN_BW_MASK 0x3
  306. #define PROD_SCHED_BW_ENTRIES (NUM_SCHED_ENTRIES * NUM_DYN_BW)
  307. typedef A_UINT8 A_RATE;
  308. #if NUM_DYN_BW > 4
  309. /* Extend rate table module first*/
  310. #error "Extend rate table module first"
  311. #endif
  312. #define MAX_PEERS 32
  313. #if defined(CONFIG_AR900B_SUPPORT) || defined(AR900B)
  314. typedef struct {
  315. A_UINT32 psdu_len[NUM_DYN_BW * NUM_SCHED_ENTRIES];
  316. A_UINT16 flags[NUM_SCHED_ENTRIES][NUM_DYN_BW];
  317. A_RATE rix[NUM_SCHED_ENTRIES][NUM_DYN_BW];
  318. A_UINT8 tpc[NUM_SCHED_ENTRIES][NUM_DYN_BW];
  319. A_UINT32 antmask[NUM_SCHED_ENTRIES];
  320. A_UINT8 num_mpdus[NUM_DYN_BW * NUM_SCHED_ENTRIES];
  321. A_UINT16 txbf_cv_len;
  322. A_UINT32 txbf_cv_ptr;
  323. A_UINT16 txbf_flags;
  324. A_UINT16 txbf_cv_size;
  325. A_UINT8 txbf_nc_idx;
  326. A_UINT8 tries[NUM_SCHED_ENTRIES];
  327. A_UINT8 bw_mask[NUM_SCHED_ENTRIES];
  328. A_UINT8 max_bw[NUM_SCHED_ENTRIES];
  329. A_UINT8 num_sched_entries;
  330. A_UINT8 paprd_mask;
  331. A_UINT8 rts_rix;
  332. A_UINT8 sh_pream;
  333. A_UINT8 min_spacing_1_4_us;
  334. A_UINT8 fixed_delims;
  335. A_UINT8 bw_in_service;
  336. A_RATE probe_rix;
  337. A_UINT8 num_valid_rates;
  338. A_UINT8 rtscts_tpc;
  339. A_UINT8 dd_profile;
  340. } RC_TX_RATE_SCHEDULE;
  341. #else
  342. typedef struct {
  343. A_UINT32 psdu_len[NUM_DYN_BW * NUM_SCHED_ENTRIES];
  344. A_UINT16 flags[NUM_DYN_BW * NUM_SCHED_ENTRIES];
  345. A_RATE rix[NUM_DYN_BW * NUM_SCHED_ENTRIES];
  346. A_UINT8 tpc[NUM_DYN_BW * NUM_SCHED_ENTRIES];
  347. A_UINT8 num_mpdus[NUM_DYN_BW * NUM_SCHED_ENTRIES];
  348. A_UINT32 antmask[NUM_SCHED_ENTRIES];
  349. A_UINT32 txbf_cv_ptr;
  350. A_UINT16 txbf_cv_len;
  351. A_UINT8 tries[NUM_SCHED_ENTRIES];
  352. A_UINT8 num_valid_rates;
  353. A_UINT8 paprd_mask;
  354. A_UINT8 rts_rix;
  355. A_UINT8 sh_pream;
  356. A_UINT8 min_spacing_1_4_us;
  357. A_UINT8 fixed_delims;
  358. A_UINT8 bw_in_service;
  359. A_RATE probe_rix;
  360. } RC_TX_RATE_SCHEDULE;
  361. #endif
  362. typedef struct {
  363. A_UINT16 flags[NUM_DYN_BW * NUM_SCHED_ENTRIES];
  364. A_RATE rix[NUM_DYN_BW * NUM_SCHED_ENTRIES];
  365. #ifdef DYN_TPC_ENABLE
  366. A_UINT8 tpc[NUM_DYN_BW * NUM_SCHED_ENTRIES];
  367. #endif
  368. #ifdef SECTORED_ANTENNA
  369. A_UINT32 antmask[NUM_SCHED_ENTRIES];
  370. #endif
  371. A_UINT8 tries[NUM_SCHED_ENTRIES];
  372. A_UINT8 num_valid_rates;
  373. A_UINT8 rts_rix;
  374. A_UINT8 sh_pream;
  375. A_UINT8 bw_in_service;
  376. A_RATE probe_rix;
  377. A_UINT8 dd_profile;
  378. } RC_TX_RATE_INFO;
  379. /*
  380. * Temporarily continue to provide the WHAL_RC_INIT_RC_MASKS def in wlan_defsh
  381. * for older targets.
  382. * The WHAL_RX_INIT_RC_MASKS macro def needs to be moved into ratectrl_11ac.h
  383. * for all targets, but until this is complete, the WHAL_RC_INIT_RC_MASKS def
  384. * will be maintained here in its old location.
  385. */
  386. #if CONFIG_160MHZ_SUPPORT == 0
  387. #define WHAL_RC_INIT_RC_MASKS(_rm) do { \
  388. _rm[WHAL_RC_MASK_IDX_NON_HT] = A_RATEMASK_OFDM_CCK; \
  389. _rm[WHAL_RC_MASK_IDX_HT_20] = A_RATEMASK_HT_20; \
  390. _rm[WHAL_RC_MASK_IDX_HT_40] = A_RATEMASK_HT_40; \
  391. _rm[WHAL_RC_MASK_IDX_VHT_20] = A_RATEMASK_VHT_20; \
  392. _rm[WHAL_RC_MASK_IDX_VHT_40] = A_RATEMASK_VHT_40; \
  393. _rm[WHAL_RC_MASK_IDX_VHT_80] = A_RATEMASK_VHT_80; \
  394. } while (0)
  395. #endif
  396. /**
  397. * strucutre describing host memory chunk.
  398. */
  399. typedef struct {
  400. A_UINT32 tlv_header; /* TLV tag and len; tag equals WMITLV_TAG_STRUC_wlan_host_memory_chunk */
  401. /** id of the request that is passed up in service ready */
  402. A_UINT32 req_id;
  403. /** the physical address the memory chunk */
  404. A_UINT32 ptr;
  405. /** size of the chunk */
  406. A_UINT32 size;
  407. } wlan_host_memory_chunk;
  408. #define NUM_UNITS_IS_NUM_VDEVS 0x1
  409. #define NUM_UNITS_IS_NUM_PEERS 0x2
  410. #define NUM_UNITS_IS_NUM_ACTIVE_PEERS 0x4
  411. /* request host to allocate memory contiguously */
  412. #define REQ_TO_HOST_FOR_CONT_MEMORY 0x8
  413. /**
  414. * structure used by FW for requesting host memory
  415. */
  416. typedef struct {
  417. A_UINT32 tlv_header; /* TLV tag and len; tag equals WMI_TLVTAG_STRUC_wlan_host_mem_req */
  418. /** ID of the request */
  419. A_UINT32 req_id;
  420. /** size of the of each unit */
  421. A_UINT32 unit_size;
  422. /**
  423. * flags to indicate that
  424. * the number units is dependent
  425. * on number of resources(num vdevs num peers .. etc)
  426. */
  427. A_UINT32 num_unit_info;
  428. /*
  429. * actual number of units to allocate . if flags in the num_unit_info
  430. * indicate that number of units is tied to number of a particular
  431. * resource to allocate then num_units filed is set to 0 and host
  432. * will derive the number units from number of the resources it is
  433. * requesting.
  434. */
  435. A_UINT32 num_units;
  436. } wlan_host_mem_req;
  437. typedef enum {
  438. IGNORE_DTIM = 0x01,
  439. NORMAL_DTIM = 0x02,
  440. STICK_DTIM = 0x03,
  441. AUTO_DTIM = 0x04,
  442. } BEACON_DTIM_POLICY;
  443. /* During test it is observed that 6 * 400 = 2400 can
  444. * be alloced in addition to CFG_TGT_NUM_MSDU_DESC.
  445. * If there is any change memory requirement, this number
  446. * needs to be revisited. */
  447. #define TOTAL_VOW_ALLOCABLE 2400
  448. #define VOW_DESC_GRAB_MAX 800
  449. #define VOW_GET_NUM_VI_STA(vow_config) (((vow_config) & 0xffff0000) >> 16)
  450. #define VOW_GET_DESC_PER_VI_STA(vow_config) ((vow_config) & 0x0000ffff)
  451. /***TODO!!! Get these values dynamically in WMI_READY event and use it to calculate the mem req*/
  452. /* size in bytes required for msdu descriptor. If it changes, this should be updated. LARGE_AP
  453. * case is not considered. LARGE_AP is disabled when VoW is enabled.*/
  454. #define MSDU_DESC_SIZE 20
  455. /* size in bytes required to support a peer in target.
  456. * This obtained by considering Two tids per peer.
  457. * peer structure = 168 bytes
  458. * tid = 96 bytes (per sta 2 means we need 192 bytes)
  459. * peer_cb = 16 * 2
  460. * key = 52 * 2
  461. * AST = 12 * 2
  462. * rate, reorder.. = 384
  463. * smart antenna = 50
  464. */
  465. #define MEMORY_REQ_FOR_PEER 800
  466. /*
  467. * NB: it is important to keep all the fields in the structure dword long
  468. * so that it is easy to handle the statistics in BE host.
  469. */
  470. struct wlan_dbg_tx_stats {
  471. /* Num HTT cookies queued to dispatch list */
  472. A_INT32 comp_queued;
  473. /* Num HTT cookies dispatched */
  474. A_INT32 comp_delivered;
  475. /* Num MSDU queued to WAL */
  476. A_INT32 msdu_enqued;
  477. /* Num MPDU queue to WAL */
  478. A_INT32 mpdu_enqued;
  479. /* Num MSDUs dropped by WMM limit */
  480. A_INT32 wmm_drop;
  481. /* Num Local frames queued */
  482. A_INT32 local_enqued;
  483. /* Num Local frames done */
  484. A_INT32 local_freed;
  485. /* Num queued to HW */
  486. A_INT32 hw_queued;
  487. /* Num PPDU reaped from HW */
  488. A_INT32 hw_reaped;
  489. /* Num underruns */
  490. A_INT32 underrun;
  491. #if defined(AR900B)
  492. /* HW Paused. */
  493. A_UINT32 hw_paused;
  494. #endif
  495. /* Num PPDUs cleaned up in TX abort */
  496. A_INT32 tx_abort;
  497. /* Num MPDUs requed by SW */
  498. A_INT32 mpdus_requed;
  499. /* excessive retries */
  500. A_UINT32 tx_ko;
  501. #if defined(AR900B)
  502. A_UINT32 tx_xretry;
  503. #endif
  504. /* data hw rate code */
  505. A_UINT32 data_rc;
  506. /* Scheduler self triggers */
  507. A_UINT32 self_triggers;
  508. /* frames dropped due to excessive sw retries */
  509. A_UINT32 sw_retry_failure;
  510. /* illegal rate phy errors */
  511. A_UINT32 illgl_rate_phy_err;
  512. /* wal pdev continous xretry */
  513. A_UINT32 pdev_cont_xretry;
  514. /* wal pdev continous xretry */
  515. A_UINT32 pdev_tx_timeout;
  516. /* wal pdev resets */
  517. A_UINT32 pdev_resets;
  518. /* frames dropped due to non-availability of stateless TIDs */
  519. A_UINT32 stateless_tid_alloc_failure;
  520. /* PhY/BB underrun */
  521. A_UINT32 phy_underrun;
  522. /* MPDU is more than txop limit */
  523. A_UINT32 txop_ovf;
  524. #if defined(AR900B)
  525. /* Number of Sequences posted */
  526. A_UINT32 seq_posted;
  527. /* Number of Sequences failed queueing */
  528. A_UINT32 seq_failed_queueing;
  529. /* Number of Sequences completed */
  530. A_UINT32 seq_completed;
  531. /* Number of Sequences restarted */
  532. A_UINT32 seq_restarted;
  533. /* Number of MU Sequences posted */
  534. A_UINT32 mu_seq_posted;
  535. /* Num MPDUs flushed by SW, HWPAUSED, SW TXABORT (Reset,channel change) */
  536. A_INT32 mpdus_sw_flush;
  537. /* Num MPDUs filtered by HW, all filter condition (TTL expired) */
  538. A_INT32 mpdus_hw_filter;
  539. /* Num MPDUs truncated by PDG (TXOP, TBTT, PPDU_duration based on rate, dyn_bw) */
  540. A_INT32 mpdus_truncated;
  541. /* Num MPDUs that was tried but didn't receive ACK or BA */
  542. A_INT32 mpdus_ack_failed;
  543. /* Num MPDUs that was dropped du to expiry. */
  544. A_INT32 mpdus_expired;
  545. /* Num mc drops */
  546. /* A_UINT32 mc_drop; */
  547. #endif
  548. };
  549. struct wlan_dbg_rx_stats {
  550. /* Cnts any change in ring routing mid-ppdu */
  551. A_INT32 mid_ppdu_route_change;
  552. /* Total number of statuses processed */
  553. A_INT32 status_rcvd;
  554. /* Extra frags on rings 0-3 */
  555. A_INT32 r0_frags;
  556. A_INT32 r1_frags;
  557. A_INT32 r2_frags;
  558. A_INT32 r3_frags;
  559. /* MSDUs / MPDUs delivered to HTT */
  560. A_INT32 htt_msdus;
  561. A_INT32 htt_mpdus;
  562. /* MSDUs / MPDUs delivered to local stack */
  563. A_INT32 loc_msdus;
  564. A_INT32 loc_mpdus;
  565. /* AMSDUs that have more MSDUs than the status ring size */
  566. A_INT32 oversize_amsdu;
  567. /* Number of PHY errors */
  568. A_INT32 phy_errs;
  569. /* Number of PHY errors drops */
  570. A_INT32 phy_err_drop;
  571. /* Number of mpdu errors - FCS, MIC, ENC etc. */
  572. A_INT32 mpdu_errs;
  573. #if defined(AR900B)
  574. /* Number of rx overflow errors. */
  575. A_INT32 rx_ovfl_errs;
  576. #endif
  577. };
  578. struct wlan_dbg_mem_stats {
  579. A_UINT32 iram_free_size;
  580. A_UINT32 dram_free_size;
  581. };
  582. struct wlan_dbg_peer_stats {
  583. A_INT32 dummy; /* REMOVE THIS ONCE REAL PEER STAT COUNTERS ARE ADDED */
  584. };
  585. typedef struct {
  586. A_UINT32 mcs[10];
  587. A_UINT32 sgi[10];
  588. A_UINT32 nss[4];
  589. A_UINT32 nsts;
  590. A_UINT32 stbc[10];
  591. A_UINT32 bw[3];
  592. A_UINT32 pream[6];
  593. A_UINT32 ldpc;
  594. A_UINT32 txbf;
  595. A_UINT32 mgmt_rssi;
  596. A_UINT32 data_rssi;
  597. A_UINT32 rssi_chain0;
  598. A_UINT32 rssi_chain1;
  599. A_UINT32 rssi_chain2;
  600. #if defined(AR900B)
  601. A_UINT32 rssi_chain3;
  602. #endif
  603. } wlan_dbg_rx_rate_info_t;
  604. typedef struct {
  605. A_UINT32 mcs[10];
  606. A_UINT32 sgi[10];
  607. #if defined(CONFIG_AR900B_SUPPORT) || defined(AR900B)
  608. A_UINT32 nss[4];
  609. #else
  610. A_UINT32 nss[3];
  611. #endif
  612. A_UINT32 stbc[10];
  613. A_UINT32 bw[3];
  614. A_UINT32 pream[4];
  615. A_UINT32 ldpc;
  616. A_UINT32 rts_cnt;
  617. A_UINT32 ack_rssi;
  618. } wlan_dbg_tx_rate_info_t ;
  619. #define WLAN_MAX_MCS 10
  620. typedef struct {
  621. A_UINT32 mcs[WLAN_MAX_MCS];
  622. A_UINT32 sgi[WLAN_MAX_MCS];
  623. A_UINT32 nss[MAX_SPATIAL_STREAM_ANY];
  624. A_UINT32 nsts;
  625. A_UINT32 stbc[WLAN_MAX_MCS];
  626. A_UINT32 bw[NUM_DYN_BW_MAX];
  627. A_UINT32 pream[6];
  628. A_UINT32 ldpc;
  629. A_UINT32 txbf;
  630. A_UINT32 mgmt_rssi;
  631. A_UINT32 data_rssi;
  632. A_UINT32 rssi_chain0;
  633. A_UINT32 rssi_chain1;
  634. A_UINT32 rssi_chain2;
  635. A_UINT32 rssi_chain3;
  636. A_UINT32 reserved[8];
  637. } wlan_dbg_rx_rate_info_v2_t ;
  638. typedef struct {
  639. A_UINT32 mcs[WLAN_MAX_MCS];
  640. A_UINT32 sgi[WLAN_MAX_MCS];
  641. A_UINT32 nss[MAX_SPATIAL_STREAM_ANY];
  642. A_UINT32 stbc[WLAN_MAX_MCS];
  643. A_UINT32 bw[NUM_DYN_BW_MAX];
  644. A_UINT32 pream[4];
  645. A_UINT32 ldpc;
  646. A_UINT32 rts_cnt;
  647. A_UINT32 ack_rssi;
  648. A_UINT32 reserved[8];
  649. } wlan_dbg_tx_rate_info_v2_t ;
  650. #define WHAL_DBG_PHY_ERR_MAXCNT 18
  651. #define WHAL_DBG_SIFS_STATUS_MAXCNT 8
  652. #define WHAL_DBG_SIFS_ERR_MAXCNT 8
  653. #define WHAL_DBG_CMD_RESULT_MAXCNT 11
  654. #define WHAL_DBG_CMD_STALL_ERR_MAXCNT 4
  655. #define WHAL_DBG_FLUSH_REASON_MAXCNT 40
  656. typedef enum {
  657. WIFI_URRN_STATS_FIRST_PKT,
  658. WIFI_URRN_STATS_BETWEEN_MPDU,
  659. WIFI_URRN_STATS_WITHIN_MPDU,
  660. WHAL_MAX_URRN_STATS
  661. } wifi_urrn_type_t;
  662. typedef struct wlan_dbg_txbf_snd_stats {
  663. A_UINT32 cbf_20[4];
  664. A_UINT32 cbf_40[4];
  665. A_UINT32 cbf_80[4];
  666. A_UINT32 sounding[9];
  667. A_UINT32 cbf_160[4];
  668. } wlan_dbg_txbf_snd_stats_t;
  669. typedef struct wlan_dbg_wifi2_error_stats {
  670. A_UINT32 urrn_stats[WHAL_MAX_URRN_STATS];
  671. A_UINT32 flush_errs[WHAL_DBG_FLUSH_REASON_MAXCNT];
  672. A_UINT32 schd_stall_errs[WHAL_DBG_CMD_STALL_ERR_MAXCNT];
  673. A_UINT32 schd_cmd_result[WHAL_DBG_CMD_RESULT_MAXCNT];
  674. A_UINT32 sifs_status[WHAL_DBG_SIFS_STATUS_MAXCNT];
  675. A_UINT8 phy_errs[WHAL_DBG_PHY_ERR_MAXCNT];
  676. A_UINT32 rx_rate_inval;
  677. } wlan_dbg_wifi2_error_stats_t;
  678. typedef struct wlan_dbg_wifi2_error2_stats {
  679. A_UINT32 schd_errs[WHAL_DBG_CMD_STALL_ERR_MAXCNT];
  680. A_UINT32 sifs_errs[WHAL_DBG_SIFS_ERR_MAXCNT];
  681. } wlan_dbg_wifi2_error2_stats_t;
  682. #define WLAN_DBG_STATS_SIZE_TXBF_VHT 10
  683. #define WLAN_DBG_STATS_SIZE_TXBF_HT 8
  684. #define WLAN_DBG_STATS_SIZE_TXBF_OFDM 8
  685. #define WLAN_DBG_STATS_SIZE_TXBF_CCK 7
  686. typedef struct wlan_dbg_txbf_data_stats {
  687. A_UINT32 tx_txbf_vht[WLAN_DBG_STATS_SIZE_TXBF_VHT];
  688. A_UINT32 rx_txbf_vht[WLAN_DBG_STATS_SIZE_TXBF_VHT];
  689. A_UINT32 tx_txbf_ht[WLAN_DBG_STATS_SIZE_TXBF_HT];
  690. A_UINT32 tx_txbf_ofdm[WLAN_DBG_STATS_SIZE_TXBF_OFDM];
  691. A_UINT32 tx_txbf_cck[WLAN_DBG_STATS_SIZE_TXBF_CCK];
  692. } wlan_dbg_txbf_data_stats_t;
  693. struct wlan_dbg_tx_mu_stats {
  694. A_UINT32 mu_sch_nusers_2;
  695. A_UINT32 mu_sch_nusers_3;
  696. A_UINT32 mu_mpdus_queued_usr[4];
  697. A_UINT32 mu_mpdus_tried_usr[4];
  698. A_UINT32 mu_mpdus_failed_usr[4];
  699. A_UINT32 mu_mpdus_requeued_usr[4];
  700. A_UINT32 mu_err_no_ba_usr[4];
  701. A_UINT32 mu_mpdu_underrun_usr[4];
  702. A_UINT32 mu_ampdu_underrun_usr[4];
  703. };
  704. struct wlan_dbg_tx_selfgen_stats {
  705. A_UINT32 su_ndpa;
  706. A_UINT32 su_ndp;
  707. A_UINT32 mu_ndpa;
  708. A_UINT32 mu_ndp;
  709. A_UINT32 mu_brpoll_1;
  710. A_UINT32 mu_brpoll_2;
  711. A_UINT32 mu_bar_1;
  712. A_UINT32 mu_bar_2;
  713. A_UINT32 cts_burst;
  714. A_UINT32 su_ndp_err;
  715. A_UINT32 su_ndpa_err;
  716. A_UINT32 mu_ndp_err;
  717. A_UINT32 mu_brp1_err;
  718. A_UINT32 mu_brp2_err;
  719. };
  720. typedef struct wlan_dbg_sifs_resp_stats {
  721. A_UINT32 ps_poll_trigger; /* num ps-poll trigger frames */
  722. A_UINT32 uapsd_trigger; /* num uapsd trigger frames */
  723. A_UINT32 qb_data_trigger[2]; /* num data trigger frames; idx 0: explicit and idx 1: implicit */
  724. A_UINT32 qb_bar_trigger[2]; /* num bar trigger frames; idx 0: explicit and idx 1: implicit */
  725. A_UINT32 sifs_resp_data; /* num ppdus transmitted at SIFS interval */
  726. A_UINT32 sifs_resp_err; /* num ppdus failed to meet SIFS resp timing */
  727. } wlan_dgb_sifs_resp_stats_t;
  728. /** wlan_dbg_wifi2_error_stats_t is not grouped with the
  729. * following structure as it is allocated differently and only
  730. * belongs to whal
  731. */
  732. typedef struct wlan_dbg_stats_wifi2 {
  733. wlan_dbg_txbf_snd_stats_t txbf_snd_info;
  734. wlan_dbg_txbf_data_stats_t txbf_data_info;
  735. struct wlan_dbg_tx_selfgen_stats tx_selfgen;
  736. struct wlan_dbg_tx_mu_stats tx_mu;
  737. wlan_dgb_sifs_resp_stats_t sifs_resp_info;
  738. } wlan_dbg_wifi2_stats_t;
  739. typedef struct {
  740. wlan_dbg_rx_rate_info_t rx_phy_info;
  741. wlan_dbg_tx_rate_info_t tx_rate_info;
  742. } wlan_dbg_rate_info_t;
  743. typedef struct {
  744. wlan_dbg_rx_rate_info_v2_t rx_phy_info;
  745. wlan_dbg_tx_rate_info_v2_t tx_rate_info;
  746. } wlan_dbg_rate_info_v2_t;
  747. struct wlan_dbg_stats {
  748. struct wlan_dbg_tx_stats tx;
  749. struct wlan_dbg_rx_stats rx;
  750. #if defined(AR900B)
  751. struct wlan_dbg_mem_stats mem;
  752. #endif
  753. struct wlan_dbg_peer_stats peer;
  754. };
  755. #define DBG_STATS_MAX_HWQ_NUM 10
  756. #define DBG_STATS_MAX_TID_NUM 20
  757. #define DBG_STATS_MAX_CONG_NUM 16
  758. struct wlan_dbg_txq_stats {
  759. A_UINT16 num_pkts_queued[DBG_STATS_MAX_HWQ_NUM];
  760. A_UINT16 tid_hw_qdepth[DBG_STATS_MAX_TID_NUM]; /* WAL_MAX_TID is 20 */
  761. A_UINT16 tid_sw_qdepth[DBG_STATS_MAX_TID_NUM]; /* WAL_MAX_TID is 20 */
  762. };
  763. struct wlan_dbg_tidq_stats {
  764. A_UINT32 wlan_dbg_tid_txq_status;
  765. struct wlan_dbg_txq_stats txq_st;
  766. };
  767. typedef enum {
  768. WHAL_REG_EXT_FCC_MIDBAND = 0,
  769. WHAL_REG_EXT_JAPAN_MIDBAND = 1,
  770. WHAL_REG_EXT_FCC_DFS_HT40 = 2,
  771. WHAL_REG_EXT_JAPAN_NONDFS_HT40 = 3,
  772. WHAL_REG_EXT_JAPAN_DFS_HT40 = 4,
  773. WHAL_REG_EXT_FCC_CH_144 = 5,
  774. } WHAL_REG_EXT_BITMAP;
  775. #endif /* __WLANDEFS_H__ */