conf.h 28 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312
  1. /*
  2. * This file is part of wl1271
  3. *
  4. * Copyright (C) 2009 Nokia Corporation
  5. *
  6. * Contact: Luciano Coelho <luciano.coelho@nokia.com>
  7. *
  8. * This program is free software; you can redistribute it and/or
  9. * modify it under the terms of the GNU General Public License
  10. * version 2 as published by the Free Software Foundation.
  11. *
  12. * This program is distributed in the hope that it will be useful, but
  13. * WITHOUT ANY WARRANTY; without even the implied warranty of
  14. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  15. * General Public License for more details.
  16. *
  17. * You should have received a copy of the GNU General Public License
  18. * along with this program; if not, write to the Free Software
  19. * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
  20. * 02110-1301 USA
  21. *
  22. */
  23. #ifndef __CONF_H__
  24. #define __CONF_H__
  25. enum {
  26. CONF_HW_BIT_RATE_1MBPS = BIT(0),
  27. CONF_HW_BIT_RATE_2MBPS = BIT(1),
  28. CONF_HW_BIT_RATE_5_5MBPS = BIT(2),
  29. CONF_HW_BIT_RATE_6MBPS = BIT(3),
  30. CONF_HW_BIT_RATE_9MBPS = BIT(4),
  31. CONF_HW_BIT_RATE_11MBPS = BIT(5),
  32. CONF_HW_BIT_RATE_12MBPS = BIT(6),
  33. CONF_HW_BIT_RATE_18MBPS = BIT(7),
  34. CONF_HW_BIT_RATE_22MBPS = BIT(8),
  35. CONF_HW_BIT_RATE_24MBPS = BIT(9),
  36. CONF_HW_BIT_RATE_36MBPS = BIT(10),
  37. CONF_HW_BIT_RATE_48MBPS = BIT(11),
  38. CONF_HW_BIT_RATE_54MBPS = BIT(12),
  39. CONF_HW_BIT_RATE_MCS_0 = BIT(13),
  40. CONF_HW_BIT_RATE_MCS_1 = BIT(14),
  41. CONF_HW_BIT_RATE_MCS_2 = BIT(15),
  42. CONF_HW_BIT_RATE_MCS_3 = BIT(16),
  43. CONF_HW_BIT_RATE_MCS_4 = BIT(17),
  44. CONF_HW_BIT_RATE_MCS_5 = BIT(18),
  45. CONF_HW_BIT_RATE_MCS_6 = BIT(19),
  46. CONF_HW_BIT_RATE_MCS_7 = BIT(20)
  47. };
  48. enum {
  49. CONF_HW_RATE_INDEX_1MBPS = 0,
  50. CONF_HW_RATE_INDEX_2MBPS = 1,
  51. CONF_HW_RATE_INDEX_5_5MBPS = 2,
  52. CONF_HW_RATE_INDEX_6MBPS = 3,
  53. CONF_HW_RATE_INDEX_9MBPS = 4,
  54. CONF_HW_RATE_INDEX_11MBPS = 5,
  55. CONF_HW_RATE_INDEX_12MBPS = 6,
  56. CONF_HW_RATE_INDEX_18MBPS = 7,
  57. CONF_HW_RATE_INDEX_22MBPS = 8,
  58. CONF_HW_RATE_INDEX_24MBPS = 9,
  59. CONF_HW_RATE_INDEX_36MBPS = 10,
  60. CONF_HW_RATE_INDEX_48MBPS = 11,
  61. CONF_HW_RATE_INDEX_54MBPS = 12,
  62. CONF_HW_RATE_INDEX_MAX = CONF_HW_RATE_INDEX_54MBPS,
  63. };
  64. enum {
  65. CONF_HW_RXTX_RATE_MCS7_SGI = 0,
  66. CONF_HW_RXTX_RATE_MCS7,
  67. CONF_HW_RXTX_RATE_MCS6,
  68. CONF_HW_RXTX_RATE_MCS5,
  69. CONF_HW_RXTX_RATE_MCS4,
  70. CONF_HW_RXTX_RATE_MCS3,
  71. CONF_HW_RXTX_RATE_MCS2,
  72. CONF_HW_RXTX_RATE_MCS1,
  73. CONF_HW_RXTX_RATE_MCS0,
  74. CONF_HW_RXTX_RATE_54,
  75. CONF_HW_RXTX_RATE_48,
  76. CONF_HW_RXTX_RATE_36,
  77. CONF_HW_RXTX_RATE_24,
  78. CONF_HW_RXTX_RATE_22,
  79. CONF_HW_RXTX_RATE_18,
  80. CONF_HW_RXTX_RATE_12,
  81. CONF_HW_RXTX_RATE_11,
  82. CONF_HW_RXTX_RATE_9,
  83. CONF_HW_RXTX_RATE_6,
  84. CONF_HW_RXTX_RATE_5_5,
  85. CONF_HW_RXTX_RATE_2,
  86. CONF_HW_RXTX_RATE_1,
  87. CONF_HW_RXTX_RATE_MAX,
  88. CONF_HW_RXTX_RATE_UNSUPPORTED = 0xff
  89. };
  90. /* Rates between and including these are MCS rates */
  91. #define CONF_HW_RXTX_RATE_MCS_MIN CONF_HW_RXTX_RATE_MCS7_SGI
  92. #define CONF_HW_RXTX_RATE_MCS_MAX CONF_HW_RXTX_RATE_MCS0
  93. enum {
  94. CONF_SG_DISABLE = 0,
  95. CONF_SG_PROTECTIVE,
  96. CONF_SG_OPPORTUNISTIC
  97. };
  98. enum {
  99. /*
  100. * Configure the min and max time BT gains the antenna
  101. * in WLAN / BT master basic rate
  102. *
  103. * Range: 0 - 255 (ms)
  104. */
  105. CONF_SG_ACL_BT_MASTER_MIN_BR = 0,
  106. CONF_SG_ACL_BT_MASTER_MAX_BR,
  107. /*
  108. * Configure the min and max time BT gains the antenna
  109. * in WLAN / BT slave basic rate
  110. *
  111. * Range: 0 - 255 (ms)
  112. */
  113. CONF_SG_ACL_BT_SLAVE_MIN_BR,
  114. CONF_SG_ACL_BT_SLAVE_MAX_BR,
  115. /*
  116. * Configure the min and max time BT gains the antenna
  117. * in WLAN / BT master EDR
  118. *
  119. * Range: 0 - 255 (ms)
  120. */
  121. CONF_SG_ACL_BT_MASTER_MIN_EDR,
  122. CONF_SG_ACL_BT_MASTER_MAX_EDR,
  123. /*
  124. * Configure the min and max time BT gains the antenna
  125. * in WLAN / BT slave EDR
  126. *
  127. * Range: 0 - 255 (ms)
  128. */
  129. CONF_SG_ACL_BT_SLAVE_MIN_EDR,
  130. CONF_SG_ACL_BT_SLAVE_MAX_EDR,
  131. /*
  132. * The maximum time WLAN can gain the antenna
  133. * in WLAN PSM / BT master/slave BR
  134. *
  135. * Range: 0 - 255 (ms)
  136. */
  137. CONF_SG_ACL_WLAN_PS_MASTER_BR,
  138. CONF_SG_ACL_WLAN_PS_SLAVE_BR,
  139. /*
  140. * The maximum time WLAN can gain the antenna
  141. * in WLAN PSM / BT master/slave EDR
  142. *
  143. * Range: 0 - 255 (ms)
  144. */
  145. CONF_SG_ACL_WLAN_PS_MASTER_EDR,
  146. CONF_SG_ACL_WLAN_PS_SLAVE_EDR,
  147. /* TODO: explain these values */
  148. CONF_SG_ACL_WLAN_ACTIVE_MASTER_MIN_BR,
  149. CONF_SG_ACL_WLAN_ACTIVE_MASTER_MAX_BR,
  150. CONF_SG_ACL_WLAN_ACTIVE_SLAVE_MIN_BR,
  151. CONF_SG_ACL_WLAN_ACTIVE_SLAVE_MAX_BR,
  152. CONF_SG_ACL_WLAN_ACTIVE_MASTER_MIN_EDR,
  153. CONF_SG_ACL_WLAN_ACTIVE_MASTER_MAX_EDR,
  154. CONF_SG_ACL_WLAN_ACTIVE_SLAVE_MIN_EDR,
  155. CONF_SG_ACL_WLAN_ACTIVE_SLAVE_MAX_EDR,
  156. CONF_SG_ACL_ACTIVE_SCAN_WLAN_BR,
  157. CONF_SG_ACL_ACTIVE_SCAN_WLAN_EDR,
  158. CONF_SG_ACL_PASSIVE_SCAN_BT_BR,
  159. CONF_SG_ACL_PASSIVE_SCAN_WLAN_BR,
  160. CONF_SG_ACL_PASSIVE_SCAN_BT_EDR,
  161. CONF_SG_ACL_PASSIVE_SCAN_WLAN_EDR,
  162. /*
  163. * Compensation percentage of probe requests when scan initiated
  164. * during BT voice/ACL link.
  165. *
  166. * Range: 0 - 255 (%)
  167. */
  168. CONF_SG_AUTO_SCAN_PROBE_REQ,
  169. /*
  170. * Compensation percentage of probe requests when active scan initiated
  171. * during BT voice
  172. *
  173. * Range: 0 - 255 (%)
  174. */
  175. CONF_SG_ACTIVE_SCAN_DURATION_FACTOR_HV3,
  176. /*
  177. * Compensation percentage of WLAN active scan window if initiated
  178. * during BT A2DP
  179. *
  180. * Range: 0 - 1000 (%)
  181. */
  182. CONF_SG_ACTIVE_SCAN_DURATION_FACTOR_A2DP,
  183. /*
  184. * Compensation percentage of WLAN passive scan window if initiated
  185. * during BT A2DP BR
  186. *
  187. * Range: 0 - 1000 (%)
  188. */
  189. CONF_SG_PASSIVE_SCAN_DURATION_FACTOR_A2DP_BR,
  190. /*
  191. * Compensation percentage of WLAN passive scan window if initiated
  192. * during BT A2DP EDR
  193. *
  194. * Range: 0 - 1000 (%)
  195. */
  196. CONF_SG_PASSIVE_SCAN_DURATION_FACTOR_A2DP_EDR,
  197. /*
  198. * Compensation percentage of WLAN passive scan window if initiated
  199. * during BT voice
  200. *
  201. * Range: 0 - 1000 (%)
  202. */
  203. CONF_SG_PASSIVE_SCAN_DURATION_FACTOR_HV3,
  204. /* TODO: explain these values */
  205. CONF_SG_CONSECUTIVE_HV3_IN_PASSIVE_SCAN,
  206. CONF_SG_BCN_HV3_COLLISION_THRESH_IN_PASSIVE_SCAN,
  207. CONF_SG_TX_RX_PROTECTION_BWIDTH_IN_PASSIVE_SCAN,
  208. /*
  209. * Defines whether the SG will force WLAN host to enter/exit PSM
  210. *
  211. * Range: 1 - SG can force, 0 - host handles PSM
  212. */
  213. CONF_SG_STA_FORCE_PS_IN_BT_SCO,
  214. /*
  215. * Defines antenna configuration (single/dual antenna)
  216. *
  217. * Range: 0 - single antenna, 1 - dual antenna
  218. */
  219. CONF_SG_ANTENNA_CONFIGURATION,
  220. /*
  221. * The threshold (percent) of max consecutive beacon misses before
  222. * increasing priority of beacon reception.
  223. *
  224. * Range: 0 - 100 (%)
  225. */
  226. CONF_SG_BEACON_MISS_PERCENT,
  227. /*
  228. * Protection time of the DHCP procedure.
  229. *
  230. * Range: 0 - 100000 (ms)
  231. */
  232. CONF_SG_DHCP_TIME,
  233. /*
  234. * RX guard time before the beginning of a new BT voice frame during
  235. * which no new WLAN trigger frame is transmitted.
  236. *
  237. * Range: 0 - 100000 (us)
  238. */
  239. CONF_SG_RXT,
  240. /*
  241. * TX guard time before the beginning of a new BT voice frame during
  242. * which no new WLAN frame is transmitted.
  243. *
  244. * Range: 0 - 100000 (us)
  245. */
  246. CONF_SG_TXT,
  247. /*
  248. * Enable adaptive RXT/TXT algorithm. If disabled, the host values
  249. * will be utilized.
  250. *
  251. * Range: 0 - disable, 1 - enable
  252. */
  253. CONF_SG_ADAPTIVE_RXT_TXT,
  254. /* TODO: explain this value */
  255. CONF_SG_GENERAL_USAGE_BIT_MAP,
  256. /*
  257. * Number of consecutive BT voice frames not interrupted by WLAN
  258. *
  259. * Range: 0 - 100
  260. */
  261. CONF_SG_HV3_MAX_SERVED,
  262. /*
  263. * The used WLAN legacy service period during active BT ACL link
  264. *
  265. * Range: 0 - 255 (ms)
  266. */
  267. CONF_SG_PS_POLL_TIMEOUT,
  268. /*
  269. * The used WLAN UPSD service period during active BT ACL link
  270. *
  271. * Range: 0 - 255 (ms)
  272. */
  273. CONF_SG_UPSD_TIMEOUT,
  274. CONF_SG_CONSECUTIVE_CTS_THRESHOLD,
  275. CONF_SG_STA_RX_WINDOW_AFTER_DTIM,
  276. CONF_SG_STA_CONNECTION_PROTECTION_TIME,
  277. /* AP params */
  278. CONF_AP_BEACON_MISS_TX,
  279. CONF_AP_RX_WINDOW_AFTER_BEACON,
  280. CONF_AP_BEACON_WINDOW_INTERVAL,
  281. CONF_AP_CONNECTION_PROTECTION_TIME,
  282. CONF_AP_BT_ACL_VAL_BT_SERVE_TIME,
  283. CONF_AP_BT_ACL_VAL_WL_SERVE_TIME,
  284. /* CTS Diluting params */
  285. CONF_SG_CTS_DILUTED_BAD_RX_PACKETS_TH,
  286. CONF_SG_CTS_CHOP_IN_DUAL_ANT_SCO_MASTER,
  287. CONF_SG_TEMP_PARAM_1,
  288. CONF_SG_TEMP_PARAM_2,
  289. CONF_SG_TEMP_PARAM_3,
  290. CONF_SG_TEMP_PARAM_4,
  291. CONF_SG_TEMP_PARAM_5,
  292. CONF_SG_TEMP_PARAM_6,
  293. CONF_SG_TEMP_PARAM_7,
  294. CONF_SG_TEMP_PARAM_8,
  295. CONF_SG_TEMP_PARAM_9,
  296. CONF_SG_TEMP_PARAM_10,
  297. CONF_SG_PARAMS_MAX,
  298. CONF_SG_PARAMS_ALL = 0xff
  299. };
  300. struct conf_sg_settings {
  301. u32 params[CONF_SG_PARAMS_MAX];
  302. u8 state;
  303. };
  304. enum conf_rx_queue_type {
  305. CONF_RX_QUEUE_TYPE_LOW_PRIORITY, /* All except the high priority */
  306. CONF_RX_QUEUE_TYPE_HIGH_PRIORITY, /* Management and voice packets */
  307. };
  308. struct conf_rx_settings {
  309. /*
  310. * The maximum amount of time, in TU, before the
  311. * firmware discards the MSDU.
  312. *
  313. * Range: 0 - 0xFFFFFFFF
  314. */
  315. u32 rx_msdu_life_time;
  316. /*
  317. * Packet detection threshold in the PHY.
  318. *
  319. * FIXME: details unknown.
  320. */
  321. u32 packet_detection_threshold;
  322. /*
  323. * The longest time the STA will wait to receive traffic from the AP
  324. * after a PS-poll has been transmitted.
  325. *
  326. * Range: 0 - 200000
  327. */
  328. u16 ps_poll_timeout;
  329. /*
  330. * The longest time the STA will wait to receive traffic from the AP
  331. * after a frame has been sent from an UPSD enabled queue.
  332. *
  333. * Range: 0 - 200000
  334. */
  335. u16 upsd_timeout;
  336. /*
  337. * The number of octets in an MPDU, below which an RTS/CTS
  338. * handshake is not performed.
  339. *
  340. * Range: 0 - 4096
  341. */
  342. u16 rts_threshold;
  343. /*
  344. * The RX Clear Channel Assessment threshold in the PHY
  345. * (the energy threshold).
  346. *
  347. * Range: ENABLE_ENERGY_D == 0x140A
  348. * DISABLE_ENERGY_D == 0xFFEF
  349. */
  350. u16 rx_cca_threshold;
  351. /*
  352. * Occupied Rx mem-blocks number which requires interrupting the host
  353. * (0 = no buffering, 0xffff = disabled).
  354. *
  355. * Range: u16
  356. */
  357. u16 irq_blk_threshold;
  358. /*
  359. * Rx packets number which requires interrupting the host
  360. * (0 = no buffering).
  361. *
  362. * Range: u16
  363. */
  364. u16 irq_pkt_threshold;
  365. /*
  366. * Max time in msec the FW may delay RX-Complete interrupt.
  367. *
  368. * Range: 1 - 100
  369. */
  370. u16 irq_timeout;
  371. /*
  372. * The RX queue type.
  373. *
  374. * Range: RX_QUEUE_TYPE_RX_LOW_PRIORITY, RX_QUEUE_TYPE_RX_HIGH_PRIORITY,
  375. */
  376. u8 queue_type;
  377. };
  378. #define CONF_TX_MAX_RATE_CLASSES 10
  379. #define CONF_TX_RATE_MASK_UNSPECIFIED 0
  380. #define CONF_TX_RATE_MASK_BASIC (CONF_HW_BIT_RATE_1MBPS | \
  381. CONF_HW_BIT_RATE_2MBPS)
  382. #define CONF_TX_RATE_RETRY_LIMIT 10
  383. /* basic rates for p2p operations (probe req/resp, etc.) */
  384. #define CONF_TX_RATE_MASK_BASIC_P2P (CONF_HW_BIT_RATE_6MBPS | \
  385. CONF_HW_BIT_RATE_12MBPS | CONF_HW_BIT_RATE_24MBPS)
  386. /*
  387. * Rates supported for data packets when operating as AP. Note the absence
  388. * of the 22Mbps rate. There is a FW limitation on 12 rates so we must drop
  389. * one. The rate dropped is not mandatory under any operating mode.
  390. */
  391. #define CONF_TX_AP_ENABLED_RATES (CONF_HW_BIT_RATE_1MBPS | \
  392. CONF_HW_BIT_RATE_2MBPS | CONF_HW_BIT_RATE_5_5MBPS | \
  393. CONF_HW_BIT_RATE_6MBPS | CONF_HW_BIT_RATE_9MBPS | \
  394. CONF_HW_BIT_RATE_11MBPS | CONF_HW_BIT_RATE_12MBPS | \
  395. CONF_HW_BIT_RATE_18MBPS | CONF_HW_BIT_RATE_24MBPS | \
  396. CONF_HW_BIT_RATE_36MBPS | CONF_HW_BIT_RATE_48MBPS | \
  397. CONF_HW_BIT_RATE_54MBPS)
  398. #define CONF_TX_CCK_RATES (CONF_HW_BIT_RATE_1MBPS | \
  399. CONF_HW_BIT_RATE_2MBPS | CONF_HW_BIT_RATE_5_5MBPS | \
  400. CONF_HW_BIT_RATE_11MBPS)
  401. #define CONF_TX_OFDM_RATES (CONF_HW_BIT_RATE_6MBPS | \
  402. CONF_HW_BIT_RATE_12MBPS | CONF_HW_BIT_RATE_24MBPS | \
  403. CONF_HW_BIT_RATE_36MBPS | CONF_HW_BIT_RATE_48MBPS | \
  404. CONF_HW_BIT_RATE_54MBPS)
  405. #define CONF_TX_MCS_RATES (CONF_HW_BIT_RATE_MCS_0 | \
  406. CONF_HW_BIT_RATE_MCS_1 | CONF_HW_BIT_RATE_MCS_2 | \
  407. CONF_HW_BIT_RATE_MCS_3 | CONF_HW_BIT_RATE_MCS_4 | \
  408. CONF_HW_BIT_RATE_MCS_5 | CONF_HW_BIT_RATE_MCS_6 | \
  409. CONF_HW_BIT_RATE_MCS_7)
  410. /*
  411. * Default rates for management traffic when operating in AP mode. This
  412. * should be configured according to the basic rate set of the AP
  413. */
  414. #define CONF_TX_AP_DEFAULT_MGMT_RATES (CONF_HW_BIT_RATE_1MBPS | \
  415. CONF_HW_BIT_RATE_2MBPS | CONF_HW_BIT_RATE_5_5MBPS)
  416. /* default rates for working as IBSS (11b and OFDM) */
  417. #define CONF_TX_IBSS_DEFAULT_RATES (CONF_HW_BIT_RATE_1MBPS | \
  418. CONF_HW_BIT_RATE_2MBPS | CONF_HW_BIT_RATE_5_5MBPS | \
  419. CONF_HW_BIT_RATE_11MBPS | CONF_TX_OFDM_RATES);
  420. struct conf_tx_rate_class {
  421. /*
  422. * The rates enabled for this rate class.
  423. *
  424. * Range: CONF_HW_BIT_RATE_* bit mask
  425. */
  426. u32 enabled_rates;
  427. /*
  428. * The dot11 short retry limit used for TX retries.
  429. *
  430. * Range: u8
  431. */
  432. u8 short_retry_limit;
  433. /*
  434. * The dot11 long retry limit used for TX retries.
  435. *
  436. * Range: u8
  437. */
  438. u8 long_retry_limit;
  439. /*
  440. * Flags controlling the attributes of TX transmission.
  441. *
  442. * Range: bit 0: Truncate - when set, FW attempts to send a frame stop
  443. * when the total valid per-rate attempts have
  444. * been exhausted; otherwise transmissions
  445. * will continue at the lowest available rate
  446. * until the appropriate one of the
  447. * short_retry_limit, long_retry_limit,
  448. * dot11_max_transmit_msdu_life_time, or
  449. * max_tx_life_time, is exhausted.
  450. * 1: Preamble Override - indicates if the preamble type
  451. * should be used in TX.
  452. * 2: Preamble Type - the type of the preamble to be used by
  453. * the policy (0 - long preamble, 1 - short preamble.
  454. */
  455. u8 aflags;
  456. };
  457. #define CONF_TX_MAX_AC_COUNT 4
  458. /* Slot number setting to start transmission at PIFS interval */
  459. #define CONF_TX_AIFS_PIFS 1
  460. /* Slot number setting to start transmission at DIFS interval normal
  461. * DCF access */
  462. #define CONF_TX_AIFS_DIFS 2
  463. enum conf_tx_ac {
  464. CONF_TX_AC_BE = 0, /* best effort / legacy */
  465. CONF_TX_AC_BK = 1, /* background */
  466. CONF_TX_AC_VI = 2, /* video */
  467. CONF_TX_AC_VO = 3, /* voice */
  468. CONF_TX_AC_CTS2SELF = 4, /* fictitious AC, follows AC_VO */
  469. CONF_TX_AC_ANY_TID = 0x1f
  470. };
  471. struct conf_tx_ac_category {
  472. /*
  473. * The AC class identifier.
  474. *
  475. * Range: enum conf_tx_ac
  476. */
  477. u8 ac;
  478. /*
  479. * The contention window minimum size (in slots) for the access
  480. * class.
  481. *
  482. * Range: u8
  483. */
  484. u8 cw_min;
  485. /*
  486. * The contention window maximum size (in slots) for the access
  487. * class.
  488. *
  489. * Range: u8
  490. */
  491. u16 cw_max;
  492. /*
  493. * The AIF value (in slots) for the access class.
  494. *
  495. * Range: u8
  496. */
  497. u8 aifsn;
  498. /*
  499. * The TX Op Limit (in microseconds) for the access class.
  500. *
  501. * Range: u16
  502. */
  503. u16 tx_op_limit;
  504. };
  505. #define CONF_TX_MAX_TID_COUNT 8
  506. /* Allow TX BA on all TIDs but 6,7. These are currently reserved in the FW */
  507. #define CONF_TX_BA_ENABLED_TID_BITMAP 0x3F
  508. enum {
  509. CONF_CHANNEL_TYPE_DCF = 0, /* DC/LEGACY*/
  510. CONF_CHANNEL_TYPE_EDCF = 1, /* EDCA*/
  511. CONF_CHANNEL_TYPE_HCCA = 2, /* HCCA*/
  512. };
  513. enum {
  514. CONF_PS_SCHEME_LEGACY = 0,
  515. CONF_PS_SCHEME_UPSD_TRIGGER = 1,
  516. CONF_PS_SCHEME_LEGACY_PSPOLL = 2,
  517. CONF_PS_SCHEME_SAPSD = 3,
  518. };
  519. enum {
  520. CONF_ACK_POLICY_LEGACY = 0,
  521. CONF_ACK_POLICY_NO_ACK = 1,
  522. CONF_ACK_POLICY_BLOCK = 2,
  523. };
  524. struct conf_tx_tid {
  525. u8 queue_id;
  526. u8 channel_type;
  527. u8 tsid;
  528. u8 ps_scheme;
  529. u8 ack_policy;
  530. u32 apsd_conf[2];
  531. };
  532. struct conf_tx_settings {
  533. /*
  534. * The TX ED value for TELEC Enable/Disable.
  535. *
  536. * Range: 0, 1
  537. */
  538. u8 tx_energy_detection;
  539. /*
  540. * Configuration for rate classes for TX (currently only one
  541. * rate class supported). Used in non-AP mode.
  542. */
  543. struct conf_tx_rate_class sta_rc_conf;
  544. /*
  545. * Configuration for access categories for TX rate control.
  546. */
  547. u8 ac_conf_count;
  548. struct conf_tx_ac_category ac_conf[CONF_TX_MAX_AC_COUNT];
  549. /*
  550. * AP-mode - allow this number of TX retries to a station before an
  551. * event is triggered from FW.
  552. * In AP-mode the hlids of unreachable stations are given in the
  553. * "sta_tx_retry_exceeded" member in the event mailbox.
  554. */
  555. u8 max_tx_retries;
  556. /*
  557. * AP-mode - after this number of seconds a connected station is
  558. * considered inactive.
  559. */
  560. u16 ap_aging_period;
  561. /*
  562. * Configuration for TID parameters.
  563. */
  564. u8 tid_conf_count;
  565. struct conf_tx_tid tid_conf[CONF_TX_MAX_TID_COUNT];
  566. /*
  567. * The TX fragmentation threshold.
  568. *
  569. * Range: u16
  570. */
  571. u16 frag_threshold;
  572. /*
  573. * Max time in msec the FW may delay frame TX-Complete interrupt.
  574. *
  575. * Range: u16
  576. */
  577. u16 tx_compl_timeout;
  578. /*
  579. * Completed TX packet count which requires to issue the TX-Complete
  580. * interrupt.
  581. *
  582. * Range: u16
  583. */
  584. u16 tx_compl_threshold;
  585. /*
  586. * The rate used for control messages and scanning on the 2.4GHz band
  587. *
  588. * Range: CONF_HW_BIT_RATE_* bit mask
  589. */
  590. u32 basic_rate;
  591. /*
  592. * The rate used for control messages and scanning on the 5GHz band
  593. *
  594. * Range: CONF_HW_BIT_RATE_* bit mask
  595. */
  596. u32 basic_rate_5;
  597. /*
  598. * TX retry limits for templates
  599. */
  600. u8 tmpl_short_retry_limit;
  601. u8 tmpl_long_retry_limit;
  602. /* Time in ms for Tx watchdog timer to expire */
  603. u32 tx_watchdog_timeout;
  604. };
  605. enum {
  606. CONF_WAKE_UP_EVENT_BEACON = 0x01, /* Wake on every Beacon*/
  607. CONF_WAKE_UP_EVENT_DTIM = 0x02, /* Wake on every DTIM*/
  608. CONF_WAKE_UP_EVENT_N_DTIM = 0x04, /* Wake every Nth DTIM */
  609. CONF_WAKE_UP_EVENT_N_BEACONS = 0x08, /* Wake every Nth beacon */
  610. CONF_WAKE_UP_EVENT_BITS_MASK = 0x0F
  611. };
  612. #define CONF_MAX_BCN_FILT_IE_COUNT 32
  613. #define CONF_BCN_RULE_PASS_ON_CHANGE BIT(0)
  614. #define CONF_BCN_RULE_PASS_ON_APPEARANCE BIT(1)
  615. #define CONF_BCN_IE_OUI_LEN 3
  616. #define CONF_BCN_IE_VER_LEN 2
  617. struct conf_bcn_filt_rule {
  618. /*
  619. * IE number to which to associate a rule.
  620. *
  621. * Range: u8
  622. */
  623. u8 ie;
  624. /*
  625. * Rule to associate with the specific ie.
  626. *
  627. * Range: CONF_BCN_RULE_PASS_ON_*
  628. */
  629. u8 rule;
  630. /*
  631. * OUI for the vendor specifie IE (221)
  632. */
  633. u8 oui[CONF_BCN_IE_OUI_LEN];
  634. /*
  635. * Type for the vendor specifie IE (221)
  636. */
  637. u8 type;
  638. /*
  639. * Version for the vendor specifie IE (221)
  640. */
  641. u8 version[CONF_BCN_IE_VER_LEN];
  642. };
  643. #define CONF_MAX_RSSI_SNR_TRIGGERS 8
  644. enum {
  645. CONF_TRIG_METRIC_RSSI_BEACON = 0,
  646. CONF_TRIG_METRIC_RSSI_DATA,
  647. CONF_TRIG_METRIC_SNR_BEACON,
  648. CONF_TRIG_METRIC_SNR_DATA
  649. };
  650. enum {
  651. CONF_TRIG_EVENT_TYPE_LEVEL = 0,
  652. CONF_TRIG_EVENT_TYPE_EDGE
  653. };
  654. enum {
  655. CONF_TRIG_EVENT_DIR_LOW = 0,
  656. CONF_TRIG_EVENT_DIR_HIGH,
  657. CONF_TRIG_EVENT_DIR_BIDIR
  658. };
  659. struct conf_sig_weights {
  660. /*
  661. * RSSI from beacons average weight.
  662. *
  663. * Range: u8
  664. */
  665. u8 rssi_bcn_avg_weight;
  666. /*
  667. * RSSI from data average weight.
  668. *
  669. * Range: u8
  670. */
  671. u8 rssi_pkt_avg_weight;
  672. /*
  673. * SNR from beacons average weight.
  674. *
  675. * Range: u8
  676. */
  677. u8 snr_bcn_avg_weight;
  678. /*
  679. * SNR from data average weight.
  680. *
  681. * Range: u8
  682. */
  683. u8 snr_pkt_avg_weight;
  684. };
  685. enum conf_bcn_filt_mode {
  686. CONF_BCN_FILT_MODE_DISABLED = 0,
  687. CONF_BCN_FILT_MODE_ENABLED = 1
  688. };
  689. enum conf_bet_mode {
  690. CONF_BET_MODE_DISABLE = 0,
  691. CONF_BET_MODE_ENABLE = 1,
  692. };
  693. struct conf_conn_settings {
  694. /*
  695. * Firmware wakeup conditions configuration. The host may set only
  696. * one bit.
  697. *
  698. * Range: CONF_WAKE_UP_EVENT_*
  699. */
  700. u8 wake_up_event;
  701. /*
  702. * Listen interval for beacons or Dtims.
  703. *
  704. * Range: 0 for beacon and Dtim wakeup
  705. * 1-10 for x Dtims
  706. * 1-255 for x beacons
  707. */
  708. u8 listen_interval;
  709. /*
  710. * Firmware wakeup conditions during suspend
  711. * Range: CONF_WAKE_UP_EVENT_*
  712. */
  713. u8 suspend_wake_up_event;
  714. /*
  715. * Listen interval during suspend.
  716. * Currently will be in DTIMs (1-10)
  717. *
  718. */
  719. u8 suspend_listen_interval;
  720. /*
  721. * Enable or disable the beacon filtering.
  722. *
  723. * Range: CONF_BCN_FILT_MODE_*
  724. */
  725. enum conf_bcn_filt_mode bcn_filt_mode;
  726. /*
  727. * Configure Beacon filter pass-thru rules.
  728. */
  729. u8 bcn_filt_ie_count;
  730. struct conf_bcn_filt_rule bcn_filt_ie[CONF_MAX_BCN_FILT_IE_COUNT];
  731. /*
  732. * The number of consecutive beacons to lose, before the firmware
  733. * becomes out of synch.
  734. *
  735. * Range: u32
  736. */
  737. u32 synch_fail_thold;
  738. /*
  739. * After out-of-synch, the number of TU's to wait without a further
  740. * received beacon (or probe response) before issuing the BSS_EVENT_LOSE
  741. * event.
  742. *
  743. * Range: u32
  744. */
  745. u32 bss_lose_timeout;
  746. /*
  747. * Beacon receive timeout.
  748. *
  749. * Range: u32
  750. */
  751. u32 beacon_rx_timeout;
  752. /*
  753. * Broadcast receive timeout.
  754. *
  755. * Range: u32
  756. */
  757. u32 broadcast_timeout;
  758. /*
  759. * Enable/disable reception of broadcast packets in power save mode
  760. *
  761. * Range: 1 - enable, 0 - disable
  762. */
  763. u8 rx_broadcast_in_ps;
  764. /*
  765. * Consecutive PS Poll failures before sending event to driver
  766. *
  767. * Range: u8
  768. */
  769. u8 ps_poll_threshold;
  770. /*
  771. * Configuration of signal average weights.
  772. */
  773. struct conf_sig_weights sig_weights;
  774. /*
  775. * Specifies if beacon early termination procedure is enabled or
  776. * disabled.
  777. *
  778. * Range: CONF_BET_MODE_*
  779. */
  780. u8 bet_enable;
  781. /*
  782. * Specifies the maximum number of consecutive beacons that may be
  783. * early terminated. After this number is reached at least one full
  784. * beacon must be correctly received in FW before beacon ET
  785. * resumes.
  786. *
  787. * Range 0 - 255
  788. */
  789. u8 bet_max_consecutive;
  790. /*
  791. * Specifies the maximum number of times to try PSM entry if it fails
  792. * (if sending the appropriate null-func message fails.)
  793. *
  794. * Range 0 - 255
  795. */
  796. u8 psm_entry_retries;
  797. /*
  798. * Specifies the maximum number of times to try PSM exit if it fails
  799. * (if sending the appropriate null-func message fails.)
  800. *
  801. * Range 0 - 255
  802. */
  803. u8 psm_exit_retries;
  804. /*
  805. * Specifies the maximum number of times to try transmit the PSM entry
  806. * null-func frame for each PSM entry attempt
  807. *
  808. * Range 0 - 255
  809. */
  810. u8 psm_entry_nullfunc_retries;
  811. /*
  812. * Specifies the dynamic PS timeout in ms that will be used
  813. * by the FW when in AUTO_PS mode
  814. */
  815. u16 dynamic_ps_timeout;
  816. /*
  817. * Specifies whether dynamic PS should be disabled and PSM forced.
  818. * This is required for certain WiFi certification tests.
  819. */
  820. u8 forced_ps;
  821. /*
  822. *
  823. * Specifies the interval of the connection keep-alive null-func
  824. * frame in ms.
  825. *
  826. * Range: 1000 - 3600000
  827. */
  828. u32 keep_alive_interval;
  829. /*
  830. * Maximum listen interval supported by the driver in units of beacons.
  831. *
  832. * Range: u16
  833. */
  834. u8 max_listen_interval;
  835. };
  836. enum {
  837. CONF_REF_CLK_19_2_E,
  838. CONF_REF_CLK_26_E,
  839. CONF_REF_CLK_38_4_E,
  840. CONF_REF_CLK_52_E,
  841. CONF_REF_CLK_38_4_M_XTAL,
  842. CONF_REF_CLK_26_M_XTAL,
  843. };
  844. enum single_dual_band_enum {
  845. CONF_SINGLE_BAND,
  846. CONF_DUAL_BAND
  847. };
  848. #define CONF_RSSI_AND_PROCESS_COMPENSATION_SIZE 15
  849. #define CONF_NUMBER_OF_SUB_BANDS_5 7
  850. #define CONF_NUMBER_OF_RATE_GROUPS 6
  851. #define CONF_NUMBER_OF_CHANNELS_2_4 14
  852. #define CONF_NUMBER_OF_CHANNELS_5 35
  853. struct conf_itrim_settings {
  854. /* enable dco itrim */
  855. u8 enable;
  856. /* moderation timeout in microsecs from the last TX */
  857. u32 timeout;
  858. };
  859. struct conf_pm_config_settings {
  860. /*
  861. * Host clock settling time
  862. *
  863. * Range: 0 - 30000 us
  864. */
  865. u32 host_clk_settling_time;
  866. /*
  867. * Host fast wakeup support
  868. *
  869. * Range: true, false
  870. */
  871. bool host_fast_wakeup_support;
  872. };
  873. struct conf_roam_trigger_settings {
  874. /*
  875. * The minimum interval between two trigger events.
  876. *
  877. * Range: 0 - 60000 ms
  878. */
  879. u16 trigger_pacing;
  880. /*
  881. * The weight for rssi/beacon average calculation
  882. *
  883. * Range: 0 - 255
  884. */
  885. u8 avg_weight_rssi_beacon;
  886. /*
  887. * The weight for rssi/data frame average calculation
  888. *
  889. * Range: 0 - 255
  890. */
  891. u8 avg_weight_rssi_data;
  892. /*
  893. * The weight for snr/beacon average calculation
  894. *
  895. * Range: 0 - 255
  896. */
  897. u8 avg_weight_snr_beacon;
  898. /*
  899. * The weight for snr/data frame average calculation
  900. *
  901. * Range: 0 - 255
  902. */
  903. u8 avg_weight_snr_data;
  904. };
  905. struct conf_scan_settings {
  906. /*
  907. * The minimum time to wait on each channel for active scans
  908. *
  909. * Range: u32 tu/1000
  910. */
  911. u32 min_dwell_time_active;
  912. /*
  913. * The maximum time to wait on each channel for active scans
  914. *
  915. * Range: u32 tu/1000
  916. */
  917. u32 max_dwell_time_active;
  918. /*
  919. * The minimum time to wait on each channel for passive scans
  920. *
  921. * Range: u32 tu/1000
  922. */
  923. u32 min_dwell_time_passive;
  924. /*
  925. * The maximum time to wait on each channel for passive scans
  926. *
  927. * Range: u32 tu/1000
  928. */
  929. u32 max_dwell_time_passive;
  930. /*
  931. * Number of probe requests to transmit on each active scan channel
  932. *
  933. * Range: u8
  934. */
  935. u16 num_probe_reqs;
  936. /*
  937. * Scan trigger (split scan) timeout. The FW will split the scan
  938. * operation into slices of the given time and allow the FW to schedule
  939. * other tasks in between.
  940. *
  941. * Range: u32 Microsecs
  942. */
  943. u32 split_scan_timeout;
  944. };
  945. struct conf_sched_scan_settings {
  946. /* minimum time to wait on the channel for active scans (in TUs) */
  947. u16 min_dwell_time_active;
  948. /* maximum time to wait on the channel for active scans (in TUs) */
  949. u16 max_dwell_time_active;
  950. /* time to wait on the channel for passive scans (in TUs) */
  951. u32 dwell_time_passive;
  952. /* time to wait on the channel for DFS scans (in TUs) */
  953. u32 dwell_time_dfs;
  954. /* number of probe requests to send on each channel in active scans */
  955. u8 num_probe_reqs;
  956. /* RSSI threshold to be used for filtering */
  957. s8 rssi_threshold;
  958. /* SNR threshold to be used for filtering */
  959. s8 snr_threshold;
  960. };
  961. /* these are number of channels on the band divided by two, rounded up */
  962. #define CONF_TX_PWR_COMPENSATION_LEN_2 7
  963. #define CONF_TX_PWR_COMPENSATION_LEN_5 18
  964. struct conf_rf_settings {
  965. /*
  966. * Per channel power compensation for 2.4GHz
  967. *
  968. * Range: s8
  969. */
  970. u8 tx_per_channel_power_compensation_2[CONF_TX_PWR_COMPENSATION_LEN_2];
  971. /*
  972. * Per channel power compensation for 5GHz
  973. *
  974. * Range: s8
  975. */
  976. u8 tx_per_channel_power_compensation_5[CONF_TX_PWR_COMPENSATION_LEN_5];
  977. };
  978. struct conf_ht_setting {
  979. u8 rx_ba_win_size;
  980. u8 tx_ba_win_size;
  981. u16 inactivity_timeout;
  982. /* bitmap of enabled TIDs for TX BA sessions */
  983. u8 tx_ba_tid_bitmap;
  984. };
  985. struct conf_memory_settings {
  986. /* Number of stations supported in IBSS mode */
  987. u8 num_stations;
  988. /* Number of ssid profiles used in IBSS mode */
  989. u8 ssid_profiles;
  990. /* Number of memory buffers allocated to rx pool */
  991. u8 rx_block_num;
  992. /* Minimum number of blocks allocated to tx pool */
  993. u8 tx_min_block_num;
  994. /* Disable/Enable dynamic memory */
  995. u8 dynamic_memory;
  996. /*
  997. * Minimum required free tx memory blocks in order to assure optimum
  998. * performance
  999. *
  1000. * Range: 0-120
  1001. */
  1002. u8 min_req_tx_blocks;
  1003. /*
  1004. * Minimum required free rx memory blocks in order to assure optimum
  1005. * performance
  1006. *
  1007. * Range: 0-120
  1008. */
  1009. u8 min_req_rx_blocks;
  1010. /*
  1011. * Minimum number of mem blocks (free+used) guaranteed for TX
  1012. *
  1013. * Range: 0-120
  1014. */
  1015. u8 tx_min;
  1016. };
  1017. struct conf_fm_coex {
  1018. u8 enable;
  1019. u8 swallow_period;
  1020. u8 n_divider_fref_set_1;
  1021. u8 n_divider_fref_set_2;
  1022. u16 m_divider_fref_set_1;
  1023. u16 m_divider_fref_set_2;
  1024. u32 coex_pll_stabilization_time;
  1025. u16 ldo_stabilization_time;
  1026. u8 fm_disturbed_band_margin;
  1027. u8 swallow_clk_diff;
  1028. };
  1029. struct conf_rx_streaming_settings {
  1030. /*
  1031. * RX Streaming duration (in msec) from last tx/rx
  1032. *
  1033. * Range: u32
  1034. */
  1035. u32 duration;
  1036. /*
  1037. * Bitmap of tids to be polled during RX streaming.
  1038. * (Note: it doesn't look like it really matters)
  1039. *
  1040. * Range: 0x1-0xff
  1041. */
  1042. u8 queues;
  1043. /*
  1044. * RX Streaming interval.
  1045. * (Note:this value is also used as the rx streaming timeout)
  1046. * Range: 0 (disabled), 10 - 100
  1047. */
  1048. u8 interval;
  1049. /*
  1050. * enable rx streaming also when there is no coex activity
  1051. */
  1052. u8 always;
  1053. };
  1054. struct conf_fwlog {
  1055. /* Continuous or on-demand */
  1056. u8 mode;
  1057. /*
  1058. * Number of memory blocks dedicated for the FW logger
  1059. *
  1060. * Range: 1-3, or 0 to disable the FW logger
  1061. */
  1062. u8 mem_blocks;
  1063. /* Minimum log level threshold */
  1064. u8 severity;
  1065. /* Include/exclude timestamps from the log messages */
  1066. u8 timestamp;
  1067. /* See enum wl1271_fwlogger_output */
  1068. u8 output;
  1069. /* Regulates the frequency of log messages */
  1070. u8 threshold;
  1071. };
  1072. #define ACX_RATE_MGMT_NUM_OF_RATES 13
  1073. struct conf_rate_policy_settings {
  1074. u16 rate_retry_score;
  1075. u16 per_add;
  1076. u16 per_th1;
  1077. u16 per_th2;
  1078. u16 max_per;
  1079. u8 inverse_curiosity_factor;
  1080. u8 tx_fail_low_th;
  1081. u8 tx_fail_high_th;
  1082. u8 per_alpha_shift;
  1083. u8 per_add_shift;
  1084. u8 per_beta1_shift;
  1085. u8 per_beta2_shift;
  1086. u8 rate_check_up;
  1087. u8 rate_check_down;
  1088. u8 rate_retry_policy[ACX_RATE_MGMT_NUM_OF_RATES];
  1089. };
  1090. struct conf_hangover_settings {
  1091. u32 recover_time;
  1092. u8 hangover_period;
  1093. u8 dynamic_mode;
  1094. u8 early_termination_mode;
  1095. u8 max_period;
  1096. u8 min_period;
  1097. u8 increase_delta;
  1098. u8 decrease_delta;
  1099. u8 quiet_time;
  1100. u8 increase_time;
  1101. u8 window_size;
  1102. };
  1103. struct conf_drv_settings {
  1104. struct conf_sg_settings sg;
  1105. struct conf_rx_settings rx;
  1106. struct conf_tx_settings tx;
  1107. struct conf_conn_settings conn;
  1108. struct conf_itrim_settings itrim;
  1109. struct conf_pm_config_settings pm_config;
  1110. struct conf_roam_trigger_settings roam_trigger;
  1111. struct conf_scan_settings scan;
  1112. struct conf_sched_scan_settings sched_scan;
  1113. struct conf_rf_settings rf;
  1114. struct conf_ht_setting ht;
  1115. struct conf_memory_settings mem_wl127x;
  1116. struct conf_memory_settings mem_wl128x;
  1117. struct conf_fm_coex fm_coex;
  1118. struct conf_rx_streaming_settings rx_streaming;
  1119. struct conf_fwlog fwlog;
  1120. struct conf_rate_policy_settings rate;
  1121. struct conf_hangover_settings hangover;
  1122. u8 hci_io_ds;
  1123. };
  1124. #endif