conf.h 28 KB

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