conf.h 25 KB

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