cfg_mlme_lfr.h 66 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957
  1. /*
  2. * Copyright (c) 2012-2021 The Linux Foundation. All rights reserved.
  3. *
  4. * Permission to use, copy, modify, and/or distribute this software for
  5. * any purpose with or without fee is hereby granted, provided that the
  6. * above copyright notice and this permission notice appear in all
  7. * copies.
  8. *
  9. * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
  10. * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
  11. * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
  12. * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
  13. * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
  14. * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
  15. * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  16. * PERFORMANCE OF THIS SOFTWARE.
  17. */
  18. /**
  19. * DOC: This file contains configuration definitions for MLME LFR.
  20. */
  21. #ifndef CFG_MLME_LFR_H__
  22. #define CFG_MLME_LFR_H__
  23. /*
  24. * <ini>
  25. * mawc_roam_enabled - Enable/Disable MAWC during roaming
  26. * @Min: 0 - Disabled
  27. * @Max: 1 - Enabled
  28. * @Default: 0
  29. *
  30. * This ini is used to control MAWC during roaming.
  31. *
  32. * Related: MAWCEnabled.
  33. *
  34. * Supported Feature: MAWC Roaming
  35. *
  36. * Usage: Internal/External
  37. *
  38. * </ini>
  39. */
  40. #define CFG_LFR_MAWC_ROAM_ENABLED CFG_INI_BOOL( \
  41. "mawc_roam_enabled", \
  42. 0, \
  43. "Enable/Disable MAWC during roaming")
  44. /*
  45. * <ini>
  46. * mawc_roam_traffic_threshold - Configure traffic threshold
  47. * @Min: 0
  48. * @Max: 0xFFFFFFFF
  49. * @Default: 300
  50. *
  51. * This ini is used to configure the data traffic load in kbps to
  52. * register CMC.
  53. *
  54. * Related: mawc_roam_enabled.
  55. *
  56. * Supported Feature: MAWC Roaming
  57. *
  58. * Usage: Internal/External
  59. *
  60. * </ini>
  61. */
  62. #define CFG_LFR_MAWC_ROAM_TRAFFIC_THRESHOLD CFG_INI_UINT( \
  63. "mawc_roam_traffic_threshold", \
  64. 0, \
  65. 0xFFFFFFFF, \
  66. 300, \
  67. CFG_VALUE_OR_DEFAULT, \
  68. "Configure traffic threshold")
  69. /*
  70. * <ini>
  71. * mawc_roam_ap_rssi_threshold - Best AP RSSI threshold
  72. * @Min: -120
  73. * @Max: 0
  74. * @Default: -66
  75. *
  76. * This ini is used to specify the RSSI threshold to scan for the AP.
  77. *
  78. * Related: mawc_roam_enabled.
  79. *
  80. * Supported Feature: MAWC Roaming
  81. *
  82. * Usage: Internal/External
  83. *
  84. * </ini>
  85. */
  86. #define CFG_LFR_MAWC_ROAM_AP_RSSI_THRESHOLD CFG_INI_INT( \
  87. "mawc_roam_ap_rssi_threshold", \
  88. -120, \
  89. 0, \
  90. -66, \
  91. CFG_VALUE_OR_DEFAULT, \
  92. "Best AP RSSI threshold")
  93. /*
  94. * <ini>
  95. * mawc_roam_rssi_high_adjust - Adjust MAWC roam high RSSI
  96. * @Min: 3
  97. * @Max: 5
  98. * @Default: 5
  99. *
  100. * This ini is used for high RSSI threshold adjustment in stationary state
  101. * to suppress the scan.
  102. *
  103. * Related: mawc_roam_enabled.
  104. *
  105. * Supported Feature: MAWC Roaming
  106. *
  107. * Usage: Internal/External
  108. *
  109. * </ini>
  110. */
  111. #define CFG_LFR_MAWC_ROAM_RSSI_HIGH_ADJUST CFG_INI_UINT( \
  112. "mawc_roam_rssi_high_adjust", \
  113. 3, \
  114. 5, \
  115. 5, \
  116. CFG_VALUE_OR_DEFAULT, \
  117. "Adjust MAWC roam high RSSI")
  118. /*
  119. * <ini>
  120. * mawc_roam_rssi_low_adjust - Adjust MAWC roam low RSSI
  121. * @Min: 3
  122. * @Max: 5
  123. * @Default: 5
  124. *
  125. * This ini is used for low RSSI threshold adjustment in stationary state
  126. * to suppress the scan.
  127. *
  128. * Related: mawc_roam_enabled.
  129. *
  130. * Supported Feature: MAWC Roaming
  131. *
  132. * Usage: Internal/External
  133. *
  134. * </ini>
  135. */
  136. #define CFG_LFR_MAWC_ROAM_RSSI_LOW_ADJUST CFG_INI_UINT( \
  137. "mawc_roam_rssi_low_adjust", \
  138. 3, \
  139. 5, \
  140. 5, \
  141. CFG_VALUE_OR_DEFAULT, \
  142. "Adjust MAWC roam low RSSI")
  143. /*
  144. * <ini>
  145. * rssi_abs_thresh - The min RSSI of the candidate AP to consider roam
  146. * @Min: -96
  147. * @Max: 0
  148. * @Default: 0
  149. *
  150. * The RSSI value of the candidate AP should be higher than rssi_abs_thresh
  151. * to roam to the AP. 0 means no absolute minimum RSSI is required.
  152. *
  153. * Related: None
  154. *
  155. * Supported Feature: Roaming
  156. *
  157. * Usage: External
  158. *
  159. * </ini>
  160. */
  161. #define CFG_LFR_ROAM_RSSI_ABS_THRESHOLD CFG_INI_INT( \
  162. "rssi_abs_thresh", \
  163. -96, \
  164. 0, \
  165. 0, \
  166. CFG_VALUE_OR_DEFAULT, \
  167. "The min RSSI of the candidate AP to consider roam")
  168. /*
  169. * <ini>
  170. * lookup_threshold_5g_offset - Lookup threshold offset for 5G band
  171. * @Min: -120
  172. * @Max: 120
  173. * @Default: 0
  174. *
  175. * This ini is used to set the 5G band lookup threshold for roaming.
  176. * It depends on another INI which is gNeighborLookupThreshold.
  177. * gNeighborLookupThreshold is a legacy INI item which will be used to
  178. * set the RSSI lookup threshold for both 2G and 5G bands. If the
  179. * user wants to setup a different threshold for a 5G band, then user
  180. * can use this offset value which will be summed up to the value of
  181. * gNeighborLookupThreshold and used for 5G
  182. * e.g: gNeighborLookupThreshold = -76dBm
  183. * lookup_threshold_5g_offset = 6dBm
  184. * Then the 5G band will be configured to -76+6 = -70dBm
  185. * A default value of Zero to lookup_threshold_5g_offset will keep the
  186. * thresholds same for both 2G and 5G bands
  187. *
  188. * Related: gNeighborLookupThreshold
  189. *
  190. * Supported Feature: Roaming
  191. *
  192. * Usage: Internal/External
  193. *
  194. * </ini>
  195. */
  196. #define CFG_LFR_5G_RSSI_THRESHOLD_OFFSET CFG_INI_INT( \
  197. "lookup_threshold_5g_offset", \
  198. -120, \
  199. 120, \
  200. 0, \
  201. CFG_VALUE_OR_DEFAULT, \
  202. "Lookup threshold offset for 5G band")
  203. /*
  204. * <ini>
  205. * gEnableFastRoamInConcurrency - Enable LFR roaming on STA during concurrency
  206. * @Min: 0
  207. * @Max: 1
  208. * @Default: 1
  209. *
  210. * This INI is used to enable Legacy fast roaming(LFR) on STA link during
  211. * concurrent sessions.
  212. *
  213. * Related: None
  214. *
  215. * Supported Feature: Roaming
  216. *
  217. * Usage: External
  218. *
  219. * </ini>
  220. */
  221. #define CFG_LFR_ENABLE_FAST_ROAM_IN_CONCURRENCY CFG_INI_BOOL( \
  222. "gEnableFastRoamInConcurrency", \
  223. 1, \
  224. "Enable LFR roaming on STA during concurrency")
  225. /*
  226. * <ini>
  227. * gEnableEarlyStopScan - Set early stop scan
  228. * @Min: 0
  229. * @Max: 1
  230. * @Default: 0
  231. *
  232. * This ini is used to set early stop scan. Early stop
  233. * scan is a feature for roaming to stop the scans at
  234. * an early stage as soon as we find a better AP to roam.
  235. * This would make the roaming happen quickly.
  236. *
  237. * Related: None
  238. *
  239. * Supported Feature: LFR Scan
  240. *
  241. * Usage: External
  242. *
  243. * </ini>
  244. */
  245. #define CFG_LFR_EARLY_STOP_SCAN_ENABLE CFG_INI_BOOL( \
  246. "gEnableEarlyStopScan", \
  247. 0, \
  248. "Set early stop scan")
  249. /*
  250. * <ini>
  251. * gEarlyStopScanMinThreshold - Set early stop scan min
  252. * threshold
  253. * @Min: -80
  254. * @Max: -70
  255. * @Default: -73
  256. *
  257. * This ini is used to set the early stop scan minimum
  258. * threshold. Early stop scan minimum threshold is the
  259. * minimum threshold to be considered for stopping the
  260. * scan. The algorithm starts with a scan on the greedy
  261. * channel list with the maximum threshold and steps down
  262. * the threshold by 20% for each further channel. It can
  263. * step down on each channel but cannot go lower than the
  264. * minimum threshold.
  265. *
  266. * Related: None
  267. *
  268. * Supported Feature: Scan
  269. *
  270. * Usage: External
  271. *
  272. * </ini>
  273. */
  274. #define CFG_LFR_EARLY_STOP_SCAN_MIN_THRESHOLD CFG_INI_INT( \
  275. "gEarlyStopScanMinThreshold", \
  276. -80, \
  277. -70, \
  278. -73, \
  279. CFG_VALUE_OR_DEFAULT, \
  280. "Set early stop scan min")
  281. /*
  282. * <ini>
  283. * gEarlyStopScanMaxThreshold - Set early stop scan max
  284. * threshold
  285. * @Min: -60
  286. * @Max: -40
  287. * @Default: -43
  288. *
  289. * This ini is used to set the the early stop scan maximum
  290. * threshold at which the candidate AP should be to be
  291. * qualified as a potential roam candidate and good enough
  292. * to stop the roaming scan.
  293. *
  294. * Related: None
  295. *
  296. * Supported Feature: Scan
  297. *
  298. * Usage: External
  299. *
  300. * </ini>
  301. */
  302. #define CFG_LFR_EARLY_STOP_SCAN_MAX_THRESHOLD CFG_INI_INT( \
  303. "gEarlyStopScanMaxThreshold", \
  304. -60, \
  305. -40, \
  306. -43, \
  307. CFG_VALUE_OR_DEFAULT, \
  308. "Set early stop scan max")
  309. /*
  310. * <ini>
  311. * gtraffic_threshold - Dense traffic threshold
  312. * @Min: 0
  313. * @Max: 0xffffffff
  314. * @Default: 400
  315. *
  316. * Dense traffic threshold
  317. * traffic threshold required for dense roam scan
  318. * Measured in kbps
  319. *
  320. * Related: None
  321. *
  322. * Supported Feature: Roaming
  323. *
  324. * Usage: External
  325. *
  326. * </ini>
  327. */
  328. #define CFG_LFR_ROAM_DENSE_TRAFFIC_THRESHOLD CFG_INI_UINT( \
  329. "gtraffic_threshold", \
  330. 0, \
  331. 0xffffffff, \
  332. 400, \
  333. CFG_VALUE_OR_DEFAULT, \
  334. "Dense traffic threshold")
  335. /*
  336. * <ini>
  337. * groam_dense_rssi_thresh_offset - Sets dense roam RSSI threshold diff
  338. * @Min: 0
  339. * @Max: 20
  340. * @Default: 10
  341. *
  342. * This INI is used to set offset value from normal RSSI threshold to dense
  343. * RSSI threshold FW will optimize roaming based on new RSSI threshold once
  344. * it detects dense environment.
  345. *
  346. * Related: None
  347. *
  348. * Supported Feature: Roaming
  349. *
  350. * Usage: External
  351. *
  352. * </ini>
  353. */
  354. #define CFG_LFR_ROAM_DENSE_RSSI_THRE_OFFSET CFG_INI_UINT( \
  355. "groam_dense_rssi_thresh_offset", \
  356. 0, \
  357. 20, \
  358. 10, \
  359. CFG_VALUE_OR_DEFAULT, \
  360. "Dense traffic threshold")
  361. /*
  362. * <ini>
  363. * groam_dense_min_aps - Sets minimum number of AP for dense roam
  364. * @Min: 1
  365. * @Max: 5
  366. * @Default: 3
  367. *
  368. * Minimum number of APs required for dense roam. FW will consider
  369. * environment as dense once it detects #APs operating is more than
  370. * groam_dense_min_aps.
  371. *
  372. * Related: None
  373. *
  374. * Supported Feature: Roaming
  375. *
  376. * Usage: External
  377. *
  378. * </ini>
  379. */
  380. #define CFG_LFR_ROAM_DENSE_MIN_APS CFG_INI_UINT( \
  381. "groam_dense_min_aps", \
  382. 1, \
  383. 5, \
  384. 3, \
  385. CFG_VALUE_OR_DEFAULT, \
  386. "Sets minimum number of AP for dense roam")
  387. /*
  388. * <ini>
  389. * roam_bg_scan_bad_rssi_thresh - RSSI threshold for background roam
  390. * @Min: -96
  391. * @Max: 0
  392. * @Default: -76
  393. *
  394. * If the DUT is connected to an AP with weak signal, then the bad RSSI
  395. * threshold will be used as an opportunity to use the scan results
  396. * from other scan clients and try to roam if there is a better AP
  397. * available in the environment.
  398. *
  399. * Related: None
  400. *
  401. * Supported Feature: Roaming
  402. *
  403. * Usage: External
  404. *
  405. * </ini>
  406. */
  407. #define CFG_LFR_ROAM_BG_SCAN_BAD_RSSI_THRESHOLD CFG_INI_INT( \
  408. "roam_bg_scan_bad_rssi_thresh", \
  409. -96, \
  410. 0, \
  411. -76, \
  412. CFG_VALUE_OR_DEFAULT, \
  413. "RSSI threshold for background roam")
  414. /*
  415. * <ini>
  416. * roam_bg_scan_client_bitmap - Bitmap used to identify the scan clients
  417. * @Min: 0
  418. * @Max: 0x7FF
  419. * @Default: 0x424
  420. *
  421. * This bitmap is used to define the client scans that need to be used
  422. * by the roaming module to perform a background roaming.
  423. * Currently supported bit positions are as follows:
  424. * Bit 0 is reserved in the firmware.
  425. * WMI_SCAN_CLIENT_NLO - 1
  426. * WMI_SCAN_CLIENT_EXTSCAN - 2
  427. * WMI_SCAN_CLIENT_ROAM - 3
  428. * WMI_SCAN_CLIENT_P2P - 4
  429. * WMI_SCAN_CLIENT_LPI - 5
  430. * WMI_SCAN_CLIENT_NAN - 6
  431. * WMI_SCAN_CLIENT_ANQP - 7
  432. * WMI_SCAN_CLIENT_OBSS - 8
  433. * WMI_SCAN_CLIENT_PLM - 9
  434. * WMI_SCAN_CLIENT_HOST - 10
  435. *
  436. * Related: None
  437. *
  438. * Supported Feature: Roaming
  439. *
  440. * Usage: External
  441. *
  442. * </ini>
  443. */
  444. #define CFG_LFR_ROAM_BG_SCAN_CLIENT_BITMAP CFG_INI_UINT( \
  445. "roam_bg_scan_client_bitmap", \
  446. 0, \
  447. 0x7FF, \
  448. 0x424, \
  449. CFG_VALUE_OR_DEFAULT, \
  450. "Bitmap used to identify the scan clients")
  451. /*
  452. * <ini>
  453. * roam_bad_rssi_thresh_offset_2g - RSSI threshold offset for 2G to 5G roam
  454. * @Min: 0
  455. * @Max: 86
  456. * @Default: 40
  457. *
  458. * If the DUT is connected to an AP with weak signal in 2G band, then the
  459. * bad RSSI offset for 2g would be used as offset from the bad RSSI
  460. * threshold configured and then use the resulting rssi for an opportunity
  461. * to use the scan results from other scan clients and try to roam to
  462. * 5G Band ONLY if there is a better AP available in the environment.
  463. *
  464. * For example if the roam_bg_scan_bad_rssi_thresh is -76 and
  465. * roam_bad_rssi_thresh_offset_2g is 40 then the difference of -36 would be
  466. * used as a trigger to roam to a 5G AP if DUT initially connected to a 2G AP
  467. *
  468. * Related: roam_bg_scan_bad_rssi_thresh
  469. *
  470. * Supported Feature: Roaming
  471. *
  472. * Usage: External
  473. *
  474. * </ini>
  475. */
  476. #define CFG_LFR_ROAM_BG_SCAN_BAD_RSSI_OFFSET_2G CFG_INI_UINT( \
  477. "roam_bad_rssi_thresh_offset_2g", \
  478. 0, \
  479. 86, \
  480. 40, \
  481. CFG_VALUE_OR_DEFAULT, \
  482. "RSSI threshold offset for 2G to 5G roam")
  483. /*
  484. * <ini>
  485. * roam_data_rssi_threshold_triggers - triggers of data rssi threshold for roam
  486. * @Min: 0
  487. * @Max: 0xffff
  488. * @Default: 0x3
  489. *
  490. * If the DUT is connected to an AP with weak signal, during latest
  491. * rx_data_inactivity_time, if there is no activity or avg of data_rssi is
  492. * better than roam_data_rssi_threshold(-70dbM), then suppress roaming
  493. * triggered by roam_data_rssi_threshold_triggers: low RSSI or bg scan.
  494. * Triggers bitmap definition:
  495. * ROAM_DATA_RSSI_FLAG_LOW_RSSI 1<<0
  496. * ROAM_DATA_RSSI_FLAG_BACKGROUND 1<<1
  497. *
  498. * Related: None
  499. *
  500. * Supported Feature: Roaming
  501. *
  502. * Usage: External
  503. *
  504. * </ini>
  505. */
  506. #define CFG_ROAM_DATA_RSSI_THRESHOLD_TRIGGERS CFG_INI_UINT( \
  507. "roam_data_rssi_threshold_triggers", \
  508. 0, \
  509. 0xffff, \
  510. 0x3, \
  511. CFG_VALUE_OR_DEFAULT, \
  512. "Triggers of DATA RSSI threshold for roam")
  513. /*
  514. * <ini>
  515. * roam_data_rssi_threshold - Data RSSI threshold for background roam
  516. * @Min: -96
  517. * @Max: 0
  518. * @Default: -70
  519. *
  520. * If the DUT is connected to an AP with weak signal, during latest
  521. * rx_data_inactivity_time, if there is no activity or avg of data_rssi is
  522. * better than roam_data_rssi_threshold(-70dbM), then suppress roaming
  523. * triggered by roam_data_rssi_threshold_triggers: low RSSI or bg scan.
  524. *
  525. * Related: None
  526. *
  527. * Supported Feature: Roaming
  528. *
  529. * Usage: External
  530. *
  531. * </ini>
  532. */
  533. #define CFG_ROAM_DATA_RSSI_THRESHOLD CFG_INI_INT( \
  534. "roam_data_rssi_threshold", \
  535. -96, \
  536. 0, \
  537. -70, \
  538. CFG_VALUE_OR_DEFAULT, \
  539. "DATA RSSI threshold for roam")
  540. /*
  541. * <ini>
  542. * rx_data_inactivity_time - Duration to check data rssi
  543. * @Min: 0
  544. * @Max: 100000 ms
  545. * @Default: 2000
  546. *
  547. * If the DUT is connected to an AP with weak signal, during latest
  548. * rx_data_inactivity_time, if there is no activity or avg of data_rssi is
  549. * better than roam_data_rssi_threshold(-70dbM), then suppress roaming
  550. * triggered by roam_data_rssi_threshold_triggers: low RSSI or bg scan.
  551. *
  552. * Related: None
  553. *
  554. * Supported Feature: Roaming
  555. *
  556. * Usage: External
  557. *
  558. * </ini>
  559. */
  560. #define CFG_RX_DATA_INACTIVITY_TIME CFG_INI_UINT( \
  561. "rx_data_inactivity_time", \
  562. 0, \
  563. 100000, \
  564. 2000, \
  565. CFG_VALUE_OR_DEFAULT, \
  566. "Rx inactivity time to check data rssi")
  567. /*
  568. * <ini>
  569. * roamscan_adaptive_dwell_mode - Sets dwell time adaptive mode
  570. * @Min: 0
  571. * @Max: 4
  572. * @Default: 4
  573. *
  574. * This parameter will set the algo used in dwell time optimization during
  575. * roam scan. see enum scan_dwelltime_adaptive_mode.
  576. * Acceptable values for this:
  577. * 0: Default (Use firmware default mode)
  578. * 1: Conservative optimization
  579. * 2: Moderate optimization
  580. * 3: Aggressive optimization
  581. * 4: Static
  582. *
  583. * Related: None
  584. *
  585. * Supported Feature: Roaming
  586. *
  587. * Usage: External
  588. *
  589. * </ini>
  590. */
  591. #define CFG_LFR_ADAPTIVE_ROAMSCAN_DWELL_MODE CFG_INI_UINT( \
  592. "roamscan_adaptive_dwell_mode", \
  593. 0, \
  594. 4, \
  595. 4, \
  596. CFG_VALUE_OR_DEFAULT, \
  597. "Sets dwell time adaptive mode")
  598. /*
  599. * <ini>
  600. * gper_roam_enabled - To enabled/disable PER based roaming in FW
  601. * @Min: 0
  602. * @Max: 3
  603. * @Default: 3
  604. *
  605. * This ini is used to enable/disable Packet error based roaming, enabling this
  606. * will cause DUT to monitor Tx and Rx traffic and roam to a better candidate
  607. * if current is not good enough.
  608. *
  609. * Values supported:
  610. * 0: disabled
  611. * 1: enabled for Rx traffic
  612. * 2: enabled for Tx traffic
  613. * 3: enabled for Tx and Rx traffic
  614. *
  615. * Related: gper_roam_high_rate_th, gper_roam_low_rate_th,
  616. * gper_roam_th_percent, gper_roam_rest_time
  617. *
  618. * Supported Feature: LFR-3.0
  619. *
  620. * Usage: Internal
  621. *
  622. * </ini>
  623. */
  624. #define CFG_LFR_PER_ROAM_ENABLE CFG_INI_UINT( \
  625. "gper_roam_enabled", \
  626. 0, \
  627. 3, \
  628. 3, \
  629. CFG_VALUE_OR_DEFAULT, \
  630. "To enabled/disable PER based roaming in FW")
  631. /*
  632. * <ini>
  633. * gper_roam_high_rate_th - Rate at which PER based roam will stop
  634. * @Min: 1 Mbps
  635. * @Max: 0xffffffff
  636. * @Default: 40 Mbps
  637. *
  638. * This ini is used to define the data rate in mbps*10 at which FW will stop
  639. * monitoring the traffic for PER based roam.
  640. *
  641. * Related: gper_roam_enabled, gper_roam_low_rate_th,
  642. * gper_roam_th_percent, gper_roam_rest_time
  643. *
  644. * Supported Feature: LFR-3.0
  645. *
  646. * Usage: Internal
  647. *
  648. * </ini>
  649. */
  650. #define CFG_LFR_PER_ROAM_CONFIG_HIGH_RATE_TH CFG_INI_UINT( \
  651. "gper_roam_high_rate_th", \
  652. 10, \
  653. 0xffffffff, \
  654. 400, \
  655. CFG_VALUE_OR_DEFAULT, \
  656. "Rate at which PER based roam will stop")
  657. /*
  658. * <ini>
  659. * gper_roam_low_rate_th - Rate at which FW starts considering traffic for PER
  660. * based roam.
  661. *
  662. * @Min: 1 Mbps
  663. * @Max: 0xffffffff
  664. * @Default: 20 Mbps
  665. *
  666. * This ini is used to define the rate in mbps*10 at which FW starts considering
  667. * traffic for PER based roam, if gper_roam_th_percent of data is below this
  668. * rate, FW will issue a roam scan.
  669. *
  670. * Related: gper_roam_enabled, gper_roam_high_rate_th,
  671. * gper_roam_th_percent, gper_roam_rest_time
  672. *
  673. * Supported Feature: LFR-3.0
  674. *
  675. * Usage: Internal
  676. *
  677. * </ini>
  678. */
  679. #define CFG_LFR_PER_ROAM_CONFIG_LOW_RATE_TH CFG_INI_UINT( \
  680. "gper_roam_low_rate_th", \
  681. 10, \
  682. 0xffffffff, \
  683. 200, \
  684. CFG_VALUE_OR_DEFAULT, \
  685. "Rate at which FW starts considering traffic for PER")
  686. /*
  687. * <ini>
  688. * gper_roam_th_percent - Percentage at which FW will issue a roam scan if
  689. * traffic is below gper_roam_low_rate_th rate.
  690. *
  691. * @Min: 10%
  692. * @Max: 100%
  693. * @Default: 60%
  694. *
  695. * This ini is used to define the percentage at which FW will issue a roam scan
  696. * if traffic is below gper_roam_low_rate_th rate.
  697. *
  698. * Related: gper_roam_enabled, gper_roam_high_rate_th,
  699. * gper_roam_high_rate_th, gper_roam_rest_time
  700. *
  701. * Supported Feature: LFR-3.0
  702. *
  703. * Usage: Internal
  704. *
  705. * </ini>
  706. */
  707. #define CFG_LFR_PER_ROAM_CONFIG_RATE_TH_PERCENT CFG_INI_UINT( \
  708. "gper_roam_th_percent", \
  709. 10, \
  710. 100, \
  711. 60, \
  712. CFG_VALUE_OR_DEFAULT, \
  713. "Percentage at which FW will issue a roam scan")
  714. /*
  715. * <ini>
  716. * gper_roam_rest_time - Time for which FW will wait once it issues a
  717. * roam scan.
  718. *
  719. * @Min: 10 seconds
  720. * @Max: 3600 seconds
  721. * @Default: 300 seconds
  722. *
  723. * This ini is used to define the time for which FW will wait once it issues a
  724. * PER based roam scan.
  725. *
  726. * Related: gper_roam_enabled, gper_roam_high_rate_th,
  727. * gper_roam_high_rate_th, gper_roam_th_percent
  728. *
  729. * Supported Feature: LFR-3.0
  730. *
  731. * Usage: Internal
  732. *
  733. * </ini>
  734. */
  735. #define CFG_LFR_PER_ROAM_REST_TIME CFG_INI_UINT( \
  736. "gper_roam_rest_time", \
  737. 10, \
  738. 3600, \
  739. 300, \
  740. CFG_VALUE_OR_DEFAULT, \
  741. "Time for which FW will wait once it issues a roam scan")
  742. /*
  743. * <ini>
  744. * gper_roam_mon_time - Minimum time required in seconds to
  745. * be considered as valid scenario for PER based roam
  746. * @Min: 5
  747. * @Max: 25
  748. * @Default: 25
  749. *
  750. * This ini is used to define minimum time in seconds for which DUT has
  751. * collected the PER stats before it can consider the stats hysteresis to be
  752. * valid for PER based scan.
  753. * DUT collects following information during this period:
  754. * 1. % of packets below gper_roam_low_rate_th
  755. * 2. # packets above gper_roam_high_rate_th
  756. * if DUT gets (1) greater than gper_roam_th_percent and (2) is zero during
  757. * this period, it triggers PER based roam scan.
  758. *
  759. * Related: gper_roam_enabled, gper_roam_high_rate_th, gper_roam_low_rate_th,
  760. * gper_roam_th_percent, gper_roam_rest_time
  761. *
  762. * Supported Feature: LFR-3.0
  763. *
  764. * Usage: Internal
  765. *
  766. * </ini>
  767. */
  768. #define CFG_LFR_PER_ROAM_MONITOR_TIME CFG_INI_UINT( \
  769. "gper_roam_mon_time", \
  770. 5, \
  771. 25, \
  772. 25, \
  773. CFG_VALUE_OR_DEFAULT, \
  774. "Minimum time to be considered as valid scenario for PER based roam")
  775. /*
  776. * <ini>
  777. * gper_min_rssi_threshold_for_roam - Minimum roamable AP RSSI for
  778. * candidate selection for PER based roam
  779. * @Min: 0
  780. * @Max: 96
  781. * @Default: 83
  782. *
  783. * Minimum roamable AP RSSI for candidate selection for PER based roam
  784. *
  785. * Related: gper_roam_enabled, gper_roam_high_rate_th, gper_roam_low_rate_th,
  786. * gper_roam_th_percent, gper_roam_rest_time
  787. *
  788. * Supported Feature: LFR-3.0
  789. *
  790. * Usage: Internal
  791. *
  792. * </ini>
  793. */
  794. #define CFG_LFR_PER_ROAM_MIN_CANDIDATE_RSSI CFG_INI_UINT( \
  795. "gper_min_rssi_threshold_for_roam", \
  796. 10, \
  797. 96, \
  798. 83, \
  799. CFG_VALUE_OR_DEFAULT, \
  800. "Minimum roamable AP RSSI for candidate selection for PER based roam")
  801. /*
  802. * <ini>
  803. * groam_disallow_duration - disallow duration before roaming
  804. * @Min: 0
  805. * @Max: 3600
  806. * @Default: 30
  807. *
  808. * This ini is used to configure how long LCA[Last Connected AP] AP will
  809. * be disallowed before it can be a roaming candidate again, in units of
  810. * seconds.
  811. *
  812. * Related: LFR
  813. *
  814. * Usage: Internal
  815. *
  816. * </ini>
  817. */
  818. #define CFG_LFR3_ROAM_DISALLOW_DURATION CFG_INI_UINT( \
  819. "groam_disallow_duration", \
  820. 0, \
  821. 3600, \
  822. 30, \
  823. CFG_VALUE_OR_DEFAULT, \
  824. "disallow duration before roaming")
  825. /*
  826. * <ini>
  827. * grssi_channel_penalization - RSSI penalization
  828. * @Min: 0
  829. * @Max: 15
  830. * @Default: 5
  831. *
  832. * This ini is used to configure RSSI that will be penalized if candidate(s)
  833. * are found to be in the same channel as disallowed AP's, in units of db.
  834. *
  835. * Related: LFR
  836. *
  837. * Usage: Internal
  838. *
  839. * </ini>
  840. */
  841. #define CFG_LFR3_ROAM_RSSI_CHANNEL_PENALIZATION CFG_INI_UINT( \
  842. "grssi_channel_penalization", \
  843. 0, \
  844. 15, \
  845. 5, \
  846. CFG_VALUE_OR_DEFAULT, \
  847. "RSSI penalization")
  848. /*
  849. * <ini>
  850. * groam_num_disallowed_aps - Max number of AP's to maintain in LCA list
  851. * @Min: 0
  852. * @Max: 8
  853. * @Default: 3
  854. *
  855. * This ini is used to set the maximum number of AP's to be maintained
  856. * in LCA [Last Connected AP] list.
  857. *
  858. * Related: LFR
  859. *
  860. * Usage: Internal
  861. *
  862. * </ini>
  863. */
  864. #define CFG_LFR3_ROAM_NUM_DISALLOWED_APS CFG_INI_UINT( \
  865. "groam_num_disallowed_aps", \
  866. 0, \
  867. 8, \
  868. 3, \
  869. CFG_VALUE_OR_DEFAULT, \
  870. "Max number of AP's to maintain in LCA list")
  871. /*
  872. * <ini>
  873. * enable_5g_band_pref - Enable preference for 5G from INI.
  874. * @Min: 0
  875. * @Max: 1
  876. * @Default: 0
  877. * This ini is used to enable 5G preference parameters.
  878. *
  879. * Related: 5g_rssi_boost_threshold, 5g_rssi_boost_factor, 5g_max_rssi_boost
  880. * 5g_rssi_penalize_threshold, 5g_rssi_penalize_factor, 5g_max_rssi_penalize
  881. *
  882. * Supported Feature: 5G band preference
  883. *
  884. * Usage: External
  885. *
  886. * </ini>
  887. */
  888. #define CFG_LFR_ENABLE_5G_BAND_PREF CFG_INI_BOOL( \
  889. "enable_5g_band_pref", \
  890. 0, \
  891. "Enable preference for 5G from INI")
  892. /*
  893. * <ini>
  894. * 5g_rssi_boost_threshold - A_band_boost_threshold above which 5G is favored.
  895. * @Min: -70
  896. * @Max: -55
  897. * @Default: -60
  898. * This ini is used to set threshold for 5GHz band preference.
  899. *
  900. * Related: 5g_rssi_boost_factor, 5g_max_rssi_boost
  901. * 5g_rssi_penalize_threshold, 5g_rssi_penalize_factor, 5g_max_rssi_penalize
  902. *
  903. * Supported Feature: 5G band preference
  904. *
  905. * Usage: External
  906. *
  907. * </ini>
  908. */
  909. #define CFG_LFR_5G_RSSI_BOOST_THRESHOLD CFG_INI_INT( \
  910. "5g_rssi_boost_threshold", \
  911. -70, \
  912. -55, \
  913. -60, \
  914. CFG_VALUE_OR_DEFAULT, \
  915. "A_band_boost_threshold above which 5 GHz is favored")
  916. /*
  917. * <ini>
  918. * 5g_rssi_boost_factor - Factor by which 5GHz RSSI is boosted.
  919. * @Min: 0
  920. * @Max: 2
  921. * @Default: 1
  922. * This ini is used to set the 5Ghz boost factor.
  923. *
  924. * Related: 5g_rssi_boost_threshold, 5g_max_rssi_boost
  925. * 5g_rssi_penalize_threshold, 5g_rssi_penalize_factor, 5g_max_rssi_penalize
  926. *
  927. * Supported Feature: 5G band preference
  928. *
  929. * Usage: External
  930. *
  931. * </ini>
  932. */
  933. #define CFG_LFR_5G_RSSI_BOOST_FACTOR CFG_INI_UINT( \
  934. "5g_rssi_boost_factor", \
  935. 0, \
  936. 2, \
  937. 1, \
  938. CFG_VALUE_OR_DEFAULT, \
  939. "Factor by which 5GHz RSSI is boosted")
  940. /*
  941. * <ini>
  942. * 5g_max_rssi_boost - Maximum boost that can be applied to 5GHz RSSI.
  943. * @Min: 0
  944. * @Max: 20
  945. * @Default: 10
  946. * This ini is used to set maximum boost which can be given to a 5Ghz network.
  947. *
  948. * Related: 5g_rssi_boost_threshold, 5g_rssi_boost_factor
  949. * 5g_rssi_penalize_threshold, 5g_rssi_penalize_factor, 5g_max_rssi_penalize
  950. *
  951. * Supported Feature: 5G band preference
  952. *
  953. * Usage: External
  954. *
  955. * </ini>
  956. */
  957. #define CFG_LFR_5G_MAX_RSSI_BOOST CFG_INI_UINT( \
  958. "5g_max_rssi_boost", \
  959. 0, \
  960. 20, \
  961. 10, \
  962. CFG_VALUE_OR_DEFAULT, \
  963. "Maximum boost that can be applied to 5GHz RSSI")
  964. /*
  965. * <ini>
  966. * 5g_rssi_penalize_threshold - A_band_penalize_threshold above which
  967. * 5 GHz is not favored.
  968. * @Min: -80
  969. * @Max: -65
  970. * @Default: -70
  971. * This ini is used to set threshold for 5GHz band preference.
  972. *
  973. * Related: 5g_rssi_penalize_factor, 5g_max_rssi_penalize
  974. * 5g_rssi_boost_threshold, 5g_rssi_boost_factor, 5g_max_rssi_boost
  975. *
  976. * Supported Feature: 5G band preference
  977. *
  978. * Usage: External
  979. *
  980. * </ini>
  981. */
  982. #define CFG_LFR_5G_RSSI_PENALIZE_THRESHOLD CFG_INI_INT( \
  983. "5g_rssi_penalize_threshold", \
  984. -80, \
  985. -65, \
  986. -70, \
  987. CFG_VALUE_OR_DEFAULT, \
  988. "A_band_penalize_threshold above which 5 GHz is not favored")
  989. /*
  990. * <ini>
  991. * 5g_rssi_penalize_factor - Factor by which 5GHz RSSI is penalizeed.
  992. * @Min: 0
  993. * @Max: 2
  994. * @Default: 1
  995. * This ini is used to set the 5Ghz penalize factor.
  996. *
  997. * Related: 5g_rssi_penalize_threshold, 5g_max_rssi_penalize
  998. * 5g_rssi_boost_threshold, 5g_rssi_boost_factor, 5g_max_rssi_boost
  999. *
  1000. * Supported Feature: 5G band preference
  1001. *
  1002. * Usage: External
  1003. *
  1004. * </ini>
  1005. */
  1006. #define CFG_LFR_5G_RSSI_PENALIZE_FACTOR CFG_INI_UINT( \
  1007. "5g_rssi_penalize_factor", \
  1008. 0, \
  1009. 2, \
  1010. 1, \
  1011. CFG_VALUE_OR_DEFAULT, \
  1012. "Factor by which 5GHz RSSI is penalizeed")
  1013. /*
  1014. * <ini>
  1015. * 5g_max_rssi_penalize - Maximum penalty that can be applied to 5GHz RSSI.
  1016. * @Min: 0
  1017. * @Max: 20
  1018. * @Default: 10
  1019. * This ini is used to set maximum penalty which can be given to a 5Ghz network.
  1020. *
  1021. * Related: 5g_rssi_penalize_threshold, 5g_rssi_penalize_factor
  1022. * 5g_rssi_boost_threshold, 5g_rssi_boost_factor, 5g_max_rssi_boost
  1023. *
  1024. * Supported Feature: 5G band preference
  1025. *
  1026. * Usage: External
  1027. *
  1028. * </ini>
  1029. */
  1030. #define CFG_LFR_5G_MAX_RSSI_PENALIZE CFG_INI_UINT( \
  1031. "5g_max_rssi_penalize", \
  1032. 0, \
  1033. 20, \
  1034. 10, \
  1035. CFG_VALUE_OR_DEFAULT, \
  1036. "Maximum penalty that can be applied to 5GHz RSSI")
  1037. /*
  1038. * <ini>
  1039. * max_num_pre_auth - Configure max number of pre-auth
  1040. * @Min: 0
  1041. * @Max: 256
  1042. * @Default: 64
  1043. *
  1044. * This ini is used to configure the data max number of pre-auth
  1045. *
  1046. * Usage: Internal
  1047. *
  1048. * </ini>
  1049. */
  1050. #define CFG_LFR_MAX_NUM_PRE_AUTH CFG_UINT( \
  1051. "max_num_pre_auth", \
  1052. 0, \
  1053. 256, \
  1054. 64, \
  1055. CFG_VALUE_OR_DEFAULT, \
  1056. "")
  1057. /*
  1058. * <ini>
  1059. * roam_preauth_retry_count
  1060. *
  1061. * @Min: 1
  1062. * @Max: 10
  1063. * @Default: 5
  1064. *
  1065. * The maximum number of software retries for preauth or
  1066. * reassoc made before picking up the next candidate for
  1067. * connection during roaming.
  1068. *
  1069. * Related: N/A
  1070. *
  1071. * Supported Features: Roaming
  1072. *
  1073. * Usage: Internal/External
  1074. *
  1075. * </ini>
  1076. */
  1077. #define CFG_LFR3_ROAM_PREAUTH_RETRY_COUNT CFG_INI_INT( \
  1078. "roam_preauth_retry_count", \
  1079. 1, \
  1080. 10, \
  1081. 5, \
  1082. CFG_VALUE_OR_DEFAULT, \
  1083. "The maximum number of software retries for preauth")
  1084. /*
  1085. * <ini>
  1086. * roam_preauth_no_ack_timeout
  1087. *
  1088. * @Min: 5
  1089. * @Max: 50
  1090. * @Default: 5
  1091. *
  1092. * Time to wait (in ms) after sending an preauth or reassoc
  1093. * request which didn't have an ack, before considering
  1094. * it as a failure and making another software retry.
  1095. *
  1096. * Related: N/A
  1097. *
  1098. * Supported Features: Roaming
  1099. *
  1100. * Usage: Internal/External
  1101. *
  1102. * </ini>
  1103. */
  1104. #define CFG_LFR3_ROAM_PREAUTH_NO_ACK_TIMEOUT CFG_INI_INT( \
  1105. "roam_preauth_no_ack_timeout", \
  1106. 5, \
  1107. 50, \
  1108. 5, \
  1109. CFG_VALUE_OR_DEFAULT, \
  1110. "Time to wait after sending an preauth or reassoc")
  1111. /*
  1112. * <ini>
  1113. * FastRoamEnabled - Enable fast roaming
  1114. * @Min: 0
  1115. * @Max: 1
  1116. * @Default: 1
  1117. *
  1118. * This ini is used to inform FW to enable fast roaming
  1119. *
  1120. * Related: None
  1121. *
  1122. * Supported Feature: Roaming
  1123. *
  1124. * Usage: External
  1125. *
  1126. * </ini>
  1127. */
  1128. #define CFG_LFR_FEATURE_ENABLED CFG_INI_BOOL( \
  1129. "FastRoamEnabled", \
  1130. 1, \
  1131. "Enable fast roaming")
  1132. /*
  1133. * <ini>
  1134. * MAWCEnabled - Enable/Disable Motion Aided Wireless Connectivity Global
  1135. * @Min: 0 - Disabled
  1136. * @Max: 1 - Enabled
  1137. * @Default: 0
  1138. *
  1139. * This ini is used to controls the MAWC feature globally.
  1140. * MAWC is Motion Aided Wireless Connectivity.
  1141. *
  1142. * Related: mawc_roam_enabled.
  1143. *
  1144. * Supported Feature: Roaming and PNO/NLO
  1145. *
  1146. * Usage: Internal/External
  1147. *
  1148. * </ini>
  1149. */
  1150. #define CFG_LFR_MAWC_FEATURE_ENABLED CFG_INI_BOOL( \
  1151. "MAWCEnabled", \
  1152. 0, \
  1153. "Enable MAWC")
  1154. /*
  1155. * <ini>
  1156. * FastTransitionEnabled - Enable fast transition in case of 11r and ese.
  1157. * @Min: 0
  1158. * @Max: 1
  1159. * @Default: 1
  1160. *
  1161. * This ini is used to turn ON/OFF the whole neighbor roam, pre-auth, reassoc.
  1162. * With this turned OFF 11r will completely not work. For 11r this flag has to
  1163. * be ON. For ESE fastroam will not work.
  1164. *
  1165. * Related: None
  1166. *
  1167. * Supported Feature: Roaming
  1168. *
  1169. * Usage: External
  1170. *
  1171. * </ini>
  1172. */
  1173. #define CFG_LFR_FAST_TRANSITION_ENABLED CFG_INI_BOOL( \
  1174. "FastTransitionEnabled", \
  1175. 1, \
  1176. "Enable fast transition")
  1177. /*
  1178. * <ini>
  1179. * RoamRssiDiff - Enable roam based on rssi
  1180. * @Min: 0
  1181. * @Max: 100
  1182. * @Default: 5
  1183. *
  1184. * This INI is used to decide whether to Roam or not based on RSSI. AP1 is the
  1185. * currently associated AP and AP2 is chosen for roaming. The Roaming will
  1186. * happen only if AP2 has better Signal Quality and it has a RSSI better than
  1187. * AP2. RoamRssiDiff is the number of units (typically measured in dB) AP2
  1188. * is better than AP1.
  1189. *
  1190. * Related: None
  1191. *
  1192. * Supported Feature: Roaming
  1193. *
  1194. * Usage: External
  1195. *
  1196. * </ini>
  1197. */
  1198. #define CFG_LFR_ROAM_RSSI_DIFF CFG_INI_UINT( \
  1199. "RoamRssiDiff", \
  1200. 0, \
  1201. 100, \
  1202. 5, \
  1203. CFG_VALUE_OR_DEFAULT, \
  1204. "Enable roam based on rssi")
  1205. /*
  1206. * <ini>
  1207. * bg_rssi_threshold - To set RSSI Threshold for BG scan roaming
  1208. * @Min: 0
  1209. * @Max: 100
  1210. * @Default: 5
  1211. *
  1212. * This INI is used to set the value of rssi threshold to trigger roaming
  1213. * after background scan. To trigger roam after bg scan, value of rssi of
  1214. * candidate AP should be higher by this threshold than the rssi of the
  1215. * currrently associated AP.
  1216. *
  1217. * Related: RoamRssiDiff
  1218. *
  1219. * Supported Feature: Roaming
  1220. *
  1221. * Usage: External
  1222. *
  1223. * </ini>
  1224. */
  1225. #define CFG_LFR_ROAM_BG_RSSI_TH CFG_INI_UINT( \
  1226. "bg_rssi_threshold", \
  1227. 0, \
  1228. 100, \
  1229. 5, \
  1230. CFG_VALUE_OR_DEFAULT, \
  1231. "Enable roam based on rssi after BG scan")
  1232. /*
  1233. * <ini>
  1234. * gWESModeEnabled - Enable WES mode
  1235. * @Min: 0
  1236. * @Max: 1
  1237. * @Default: 0
  1238. *
  1239. * This ini is used to enable/disable Wireless Extended Security mode.
  1240. *
  1241. * Related: None
  1242. *
  1243. * Supported Feature: Roaming
  1244. *
  1245. * Usage: External
  1246. *
  1247. * </ini>
  1248. */
  1249. #define CFG_LFR_ENABLE_WES_MODE CFG_INI_BOOL( \
  1250. "gWESModeEnabled", \
  1251. 0, \
  1252. "Enable WES mode")
  1253. /*
  1254. * <ini>
  1255. * gRoamScanOffloadEnabled - Enable Roam Scan Offload
  1256. * @Min: 0
  1257. * @Max: 1
  1258. * @Default: 1
  1259. *
  1260. * This INI is used to enable Roam Scan Offload in firmware
  1261. *
  1262. * Related: None
  1263. *
  1264. * Supported Feature: Roaming
  1265. *
  1266. * Usage: External
  1267. *
  1268. * </ini>
  1269. */
  1270. #define CFG_LFR_ROAM_SCAN_OFFLOAD_ENABLED CFG_INI_BOOL( \
  1271. "gRoamScanOffloadEnabled", \
  1272. 1, \
  1273. "Enable Roam Scan Offload")
  1274. /*
  1275. * <ini>
  1276. * gNeighborScanChannelList - Set channels to be scanned
  1277. * by firmware for LFR scan
  1278. * @Default: ""
  1279. *
  1280. * This ini is used to set the channels to be scanned
  1281. * by firmware for LFR scan.
  1282. *
  1283. * Related: None
  1284. *
  1285. * Supported Feature: LFR Scan
  1286. *
  1287. * Usage: External
  1288. *
  1289. * </ini>
  1290. */
  1291. #define CFG_LFR_NEIGHBOR_SCAN_CHANNEL_LIST CFG_INI_STRING( \
  1292. "gNeighborScanChanList", \
  1293. 0, \
  1294. CFG_VALID_CHANNEL_LIST_STRING_LEN, \
  1295. "", \
  1296. "Set channels to be scanned")
  1297. /*
  1298. * <ini>
  1299. * gNeighborScanTimerPeriod - Set neighbor scan timer period
  1300. * @Min: 3
  1301. * @Max: 300
  1302. * @Default: 100
  1303. *
  1304. * This ini is used to set the timer period in secs after
  1305. * which neighbor scan is trigerred.
  1306. *
  1307. * Related: None
  1308. *
  1309. * Supported Feature: LFR Scan
  1310. *
  1311. * Usage: External
  1312. *
  1313. * </ini>
  1314. */
  1315. #define CFG_LFR_NEIGHBOR_SCAN_TIMER_PERIOD CFG_INI_UINT( \
  1316. "gNeighborScanTimerPeriod", \
  1317. 3, \
  1318. 300, \
  1319. 100, \
  1320. CFG_VALUE_OR_DEFAULT, \
  1321. "Neighbor scan timer period")
  1322. /*
  1323. * <ini>
  1324. * gRoamRestTimeMin/RoamScan_HomeTime - Set min neighbor scan timer period
  1325. * @Min: 3
  1326. * @Max: 300
  1327. * @Default: 50
  1328. *
  1329. * This is the min rest time after which firmware will check for traffic
  1330. * and if there no traffic it will move to a new channel to scan
  1331. * else it will stay on the home channel till gNeighborScanTimerPeriod time
  1332. * and then will move to a new channel to scan.
  1333. *
  1334. * Related: None
  1335. *
  1336. * Supported Feature: LFR Scan
  1337. *
  1338. * Usage: External
  1339. *
  1340. * </ini>
  1341. */
  1342. #define CFG_LFR_NEIGHBOR_SCAN_MIN_TIMER_PERIOD CFG_INI_UINT( \
  1343. "gRoamRestTimeMin RoamScan_HomeTime", \
  1344. 3, \
  1345. 300, \
  1346. 50, \
  1347. CFG_VALUE_OR_DEFAULT, \
  1348. "Min neighbor scan timer period")
  1349. /*
  1350. * <ini>
  1351. * gNeighborLookupThreshold/RoamRSSI_Trigger - Set neighbor lookup rssi
  1352. * threshold
  1353. * @Min: -100
  1354. * @Max: 120
  1355. * @Default: 78
  1356. *
  1357. * This is used to control the RSSI threshold for neighbor lookup.
  1358. *
  1359. * Related: None
  1360. *
  1361. * Supported Feature: LFR Scan
  1362. *
  1363. * Usage: External
  1364. *
  1365. * </ini>
  1366. */
  1367. #define CFG_LFR_NEIGHBOR_LOOKUP_RSSI_THRESHOLD CFG_INI_INT( \
  1368. "gNeighborLookupThreshold RoamRSSI_Trigger", \
  1369. -100, \
  1370. 120, \
  1371. 78, \
  1372. CFG_VALUE_OR_DEFAULT, \
  1373. "Neighbor lookup rssi threshold")
  1374. /*
  1375. * <ini>
  1376. * gOpportunisticThresholdDiff - Set oppurtunistic threshold diff
  1377. * @Min: 0
  1378. * @Max: 127
  1379. * @Default: 0
  1380. *
  1381. * This ini is used to set opportunistic threshold diff.
  1382. * This parameter is the RSSI diff above neighbor lookup
  1383. * threshold, when opportunistic scan should be triggered.
  1384. * MAX value is chosen so that this type of scan can be
  1385. * always enabled by user.
  1386. * MIN value will cause opportunistic scan to be triggered
  1387. * in neighbor lookup RSSI range.
  1388. *
  1389. * Related: None
  1390. *
  1391. * Supported Feature: LFR Scan
  1392. *
  1393. * Usage: External
  1394. *
  1395. * </ini>
  1396. */
  1397. #define CFG_LFR_OPPORTUNISTIC_SCAN_THRESHOLD_DIFF CFG_INI_UINT( \
  1398. "gOpportunisticThresholdDiff", \
  1399. 0, \
  1400. 127, \
  1401. 0, \
  1402. CFG_VALUE_OR_DEFAULT, \
  1403. "Set oppurtunistic threshold diff")
  1404. /*
  1405. * <ini>
  1406. * gRoamRescanRssiDiff/RoamScan_StepRSSI - Sets RSSI for Scan trigger in
  1407. * firmware
  1408. * @Min: 0
  1409. * @Max: 100
  1410. * @Default: 5
  1411. *
  1412. * This INI is the drop in RSSI value that will trigger a precautionary
  1413. * scan by firmware. Max value is chosen in such a way that this type
  1414. * of scan can be disabled by user.
  1415. *
  1416. * Related: None
  1417. *
  1418. * Supported Feature: Roaming
  1419. *
  1420. * Usage: External
  1421. *
  1422. * </ini>
  1423. */
  1424. #define CFG_LFR_ROAM_RESCAN_RSSI_DIFF CFG_INI_UINT( \
  1425. "gRoamRescanRssiDiff RoamScan_StepRSSI", \
  1426. 0, \
  1427. 100, \
  1428. 5, \
  1429. CFG_VALUE_OR_DEFAULT, \
  1430. "Sets RSSI for Scan trigger in firmware")
  1431. /*
  1432. * <ini>
  1433. * gNeighborScanChannelMinTime - Set neighbor scan channel min time
  1434. * @Min: 10
  1435. * @Max: 40
  1436. * @Default: 20
  1437. *
  1438. * This ini is used to set the minimum time in secs spent on each
  1439. * channel in LFR scan inside firmware.
  1440. *
  1441. * Related: None
  1442. *
  1443. * Supported Feature: LFR Scan
  1444. *
  1445. * Usage: External
  1446. *
  1447. * </ini>
  1448. */
  1449. #define CFG_LFR_NEIGHBOR_SCAN_MIN_CHAN_TIME CFG_INI_UINT( \
  1450. "gNeighborScanChannelMinTime", \
  1451. 10, \
  1452. 40, \
  1453. 20, \
  1454. CFG_VALUE_OR_DEFAULT, \
  1455. "Neighbor scan channel min time")
  1456. /*
  1457. * <ini>
  1458. * gNeighborScanChannelMaxTime/RoamScan_ActiveCH_DwellTime - Set neighbor scan
  1459. * channel max time
  1460. * @Min: 3
  1461. * @Max: 300
  1462. * @Default: 40
  1463. *
  1464. * This ini is used to set the maximum time in secs spent on each
  1465. * channel in LFR scan inside firmware.
  1466. *
  1467. * Related: None
  1468. *
  1469. * Supported Feature: LFR Scan
  1470. *
  1471. * Usage: External
  1472. *
  1473. * </ini>
  1474. */
  1475. #define CFG_LFR_NEIGHBOR_SCAN_MAX_CHAN_TIME CFG_INI_UINT( \
  1476. "gNeighborScanChannelMaxTime RoamScan_ActiveCH_DwellTime", \
  1477. 3, \
  1478. 300, \
  1479. 40, \
  1480. CFG_VALUE_OR_DEFAULT, \
  1481. "Neighbor scan channel max time")
  1482. /*
  1483. * <ini>
  1484. * gNeighborScanRefreshPeriod - Set neighbor scan refresh period
  1485. * @Min: 1000
  1486. * @Max: 60000
  1487. * @Default: 20000
  1488. *
  1489. * This ini is used by firmware to set scan refresh period
  1490. * in msecs for lfr scan.
  1491. *
  1492. * Related: None
  1493. *
  1494. * Supported Feature: LFR Scan
  1495. *
  1496. * Usage: External
  1497. *
  1498. * </ini>
  1499. */
  1500. #define CFG_LFR_NEIGHBOR_SCAN_RESULTS_REFRESH_PERIOD CFG_INI_UINT( \
  1501. "gNeighborScanRefreshPeriod", \
  1502. 1000, \
  1503. 60000, \
  1504. 20000, \
  1505. CFG_VALUE_OR_DEFAULT, \
  1506. "Neighbor scan refresh period")
  1507. /*
  1508. * <ini>
  1509. * gFullRoamScanPeriod - Set full roam scan refresh period
  1510. * @Min: 0
  1511. * @Max: 600
  1512. * @Default: 0
  1513. *
  1514. * This ini is used by firmware to set full roam scan period in secs.
  1515. * Full roam scan period is the minimum idle period in seconds between two
  1516. * successive full channel roam scans. If this is configured as a non-zero,
  1517. * full roam scan will be triggered for every configured interval.
  1518. * If this configured as 0, full roam scan will not be triggered at all.
  1519. *
  1520. * Related: None
  1521. *
  1522. * Supported Feature: LFR Scan
  1523. *
  1524. * Usage: External
  1525. *
  1526. * </ini>
  1527. */
  1528. #define CFG_LFR_FULL_ROAM_SCAN_REFRESH_PERIOD CFG_INI_UINT( \
  1529. "gFullRoamScanPeriod", \
  1530. 0, \
  1531. 600, \
  1532. 0, \
  1533. CFG_VALUE_OR_DEFAULT, \
  1534. "Full roam scan refresh period")
  1535. /*
  1536. * <ini>
  1537. * gEmptyScanRefreshPeriod - Set empty scan refresh period
  1538. * @Min: 0
  1539. * @Max: 60000
  1540. * @Default: 0
  1541. *
  1542. * This ini is used by firmware to set scan period in msecs
  1543. * following empty scan results.
  1544. *
  1545. * Related: None
  1546. *
  1547. * Supported Feature: LFR Scan
  1548. *
  1549. * Usage: External
  1550. *
  1551. * </ini>
  1552. */
  1553. #define CFG_LFR_EMPTY_SCAN_REFRESH_PERIOD CFG_INI_UINT( \
  1554. "gEmptyScanRefreshPeriod", \
  1555. 0, \
  1556. 60000, \
  1557. 0, \
  1558. CFG_VALUE_OR_DEFAULT, \
  1559. "Empty scan refresh period")
  1560. /*
  1561. * <ini>
  1562. * gRoamBmissFirstBcnt - Beacon miss count to trigger 1st bmiss event
  1563. * @Min: 5
  1564. * @Max: 100
  1565. * @Default: 10
  1566. *
  1567. * This ini used to control how many beacon miss will trigger first bmiss
  1568. * event. First bmiss event will result in roaming scan.
  1569. *
  1570. * Related: None
  1571. *
  1572. * Usage: External
  1573. *
  1574. * </ini>
  1575. */
  1576. #define CFG_LFR_ROAM_BMISS_FIRST_BCNT CFG_INI_UINT( \
  1577. "gRoamBmissFirstBcnt", \
  1578. 5, \
  1579. 100, \
  1580. 10, \
  1581. CFG_VALUE_OR_DEFAULT, \
  1582. "First beacon miss count")
  1583. /*
  1584. * <ini>
  1585. * gRoamBmissFinalBcnt - Beacon miss count to trigger final bmiss event
  1586. * @Min: 5
  1587. * @Max: 100
  1588. * @Default: 20
  1589. *
  1590. * This ini used to control how many beacon miss will trigger final bmiss
  1591. * event. Final bmiss event will make roaming take place or cause the
  1592. * indication of final bmiss event.
  1593. *
  1594. * Related: None
  1595. *
  1596. * Usage: External
  1597. *
  1598. * </ini>
  1599. */
  1600. #define CFG_LFR_ROAM_BMISS_FINAL_BCNT CFG_INI_UINT( \
  1601. "gRoamBmissFinalBcnt", \
  1602. 5, \
  1603. 100, \
  1604. 20, \
  1605. CFG_VALUE_OR_DEFAULT, \
  1606. "Final beacon miss count")
  1607. /*
  1608. * <ini>
  1609. * gAllowDFSChannelRoam - Allow dfs channel in roam
  1610. * @Min: 0
  1611. * @Max: 2
  1612. * @Default: 1
  1613. *
  1614. * This ini is used to set default dfs channel
  1615. *
  1616. * Related: None
  1617. *
  1618. * Supported Feature: STA
  1619. *
  1620. * Usage: Internal/External
  1621. *
  1622. * </ini>
  1623. */
  1624. #define CFG_LFR_ROAMING_DFS_CHANNEL CFG_INI_UINT( \
  1625. "gAllowDFSChannelRoam", \
  1626. 0, \
  1627. 2, \
  1628. 1, \
  1629. CFG_VALUE_OR_DEFAULT, \
  1630. "Allow dfs channel in roam")
  1631. /*
  1632. * <ini>
  1633. * gRoamScanHiRssiMaxCount - Sets 5GHz maximum scan count
  1634. * @Min: 0
  1635. * @Max: 10
  1636. * @Default: 3
  1637. *
  1638. * This INI is used to set maximum scan count in 5GHz
  1639. *
  1640. * Related: None
  1641. *
  1642. * Supported Feature: Roaming
  1643. *
  1644. * Usage: External
  1645. *
  1646. * </ini>
  1647. */
  1648. #define CFG_LFR_ROAM_SCAN_HI_RSSI_MAXCOUNT CFG_INI_UINT( \
  1649. "gRoamScanHiRssiMaxCount", \
  1650. 0, \
  1651. 10, \
  1652. 3, \
  1653. CFG_VALUE_OR_DEFAULT, \
  1654. "5GHz maximum scan count")
  1655. /*
  1656. * <ini>
  1657. * gRoamScanHiRssiDelta - Sets RSSI Delta for scan trigger
  1658. * @Min: 0
  1659. * @Max: 16
  1660. * @Default: 10
  1661. *
  1662. * This INI is used to set change in RSSI at which scan is triggered
  1663. * in 5GHz.
  1664. *
  1665. * Related: None
  1666. *
  1667. * Supported Feature: Roaming
  1668. *
  1669. * Usage: External
  1670. *
  1671. * </ini>
  1672. */
  1673. #define CFG_LFR_ROAM_SCAN_HI_RSSI_DELTA CFG_INI_UINT( \
  1674. "gRoamScanHiRssiDelta", \
  1675. 0, \
  1676. 16, \
  1677. 10, \
  1678. CFG_VALUE_OR_DEFAULT, \
  1679. "RSSI Delta for scan trigger")
  1680. /*
  1681. * <ini>
  1682. * gRoamScanHiRssiDelay - Sets minimum delay between 5GHz scans
  1683. * @Min: 5000
  1684. * @Max: 0x7fffffff
  1685. * @Default: 15000
  1686. *
  1687. * This INI is used to set the minimum delay between 5GHz scans.
  1688. *
  1689. * Related: None
  1690. *
  1691. * Supported Feature: Roaming
  1692. *
  1693. * Usage: External
  1694. *
  1695. * </ini>
  1696. */
  1697. #define CFG_LFR_ROAM_SCAN_HI_RSSI_DELAY CFG_INI_UINT( \
  1698. "gRoamScanHiRssiDelay", \
  1699. 5000, \
  1700. 0x7fffffff, \
  1701. 15000, \
  1702. CFG_VALUE_OR_DEFAULT, \
  1703. "Minimum delay between 5GHz scans")
  1704. /*
  1705. * <ini>
  1706. * gRoamScanHiRssiUpperBound - Sets upper bound after which 5GHz scan
  1707. * @Min: -66
  1708. * @Max: 0
  1709. * @Default: -30
  1710. *
  1711. * This INI is used to set the RSSI upper bound above which the 5GHz scan
  1712. * will not be performed.
  1713. *
  1714. * Related: None
  1715. *
  1716. * Supported Feature: Roaming
  1717. *
  1718. * Usage: External
  1719. *
  1720. * </ini>
  1721. */
  1722. #define CFG_LFR_ROAM_SCAN_HI_RSSI_UB CFG_INI_INT( \
  1723. "gRoamScanHiRssiUpperBound", \
  1724. -66, \
  1725. 0, \
  1726. -30, \
  1727. CFG_VALUE_OR_DEFAULT, \
  1728. "Upper bound after which 5GHz scan")
  1729. /*
  1730. * <ini>
  1731. * gRoamPrefer5GHz - Prefer roaming to 5GHz Bss
  1732. * @Min: 0
  1733. * @Max: 1
  1734. * @Default: 1
  1735. *
  1736. * This ini is used to inform FW to prefer roaming to 5GHz BSS
  1737. *
  1738. * Related: None
  1739. *
  1740. * Supported Feature: Roaming
  1741. *
  1742. * Usage: External
  1743. *
  1744. * </ini>
  1745. */
  1746. #define CFG_LFR_ROAM_PREFER_5GHZ CFG_INI_BOOL( \
  1747. "gRoamPrefer5GHz", \
  1748. 1, \
  1749. "Prefer roaming to 5GHz Bss")
  1750. /*
  1751. * <ini>
  1752. * gRoamIntraBand - Prefer roaming within Band
  1753. * @Min: 0
  1754. * @Max: 1
  1755. * @Default: 0
  1756. *
  1757. * This ini is used to inform FW to prefer roaming within band
  1758. *
  1759. * Related: None
  1760. *
  1761. * Supported Feature: Roaming
  1762. *
  1763. * Usage: External
  1764. *
  1765. * </ini>
  1766. */
  1767. #define CFG_LFR_ROAM_INTRA_BAND CFG_INI_BOOL( \
  1768. "gRoamIntraBand", \
  1769. 0, \
  1770. "Prefer roaming within Band")
  1771. /*
  1772. * <ini>
  1773. * gRoamScanNProbes - Sets the number of probes to be sent for firmware roaming
  1774. * @Min: 1
  1775. * @Max: 10
  1776. * @Default: 2
  1777. *
  1778. * This INI is used to set the maximum number of probes the firmware can send
  1779. * for firmware internal roaming cases.
  1780. *
  1781. * Related: None
  1782. *
  1783. * Supported Feature: Roaming
  1784. *
  1785. * Usage: External
  1786. *
  1787. * </ini>
  1788. */
  1789. #define CFG_LFR_ROAM_SCAN_N_PROBES CFG_INI_UINT( \
  1790. "gRoamScanNProbes", \
  1791. 1, \
  1792. 10, \
  1793. 2, \
  1794. CFG_VALUE_OR_DEFAULT, \
  1795. "The number of probes to be sent for firmware roaming")
  1796. /*
  1797. * <ini>
  1798. * gRoamScanHomeAwayTime/RoamScan_AwayTime - Sets the Home Away Time to firmware
  1799. * @Min: 0
  1800. * @Max: 300
  1801. * @Default: 0
  1802. *
  1803. * Home Away Time should be at least equal to (gNeighborScanChannelMaxTime
  1804. * + (2*RFS)), where RFS is the RF Switching time(3). It is twice RFS
  1805. * to consider the time to go off channel and return to the home channel.
  1806. *
  1807. * Related: gNeighborScanChannelMaxTime
  1808. *
  1809. * Supported Feature: Roaming
  1810. *
  1811. * Usage: External
  1812. *
  1813. * </ini>
  1814. */
  1815. #define CFG_LFR_ROAM_SCAN_HOME_AWAY_TIME CFG_INI_UINT( \
  1816. "gRoamScanHomeAwayTime RoamScan_AwayTime", \
  1817. 0, \
  1818. 300, \
  1819. 0, \
  1820. CFG_VALUE_OR_DEFAULT, \
  1821. "the home away time to firmware")
  1822. /*
  1823. * <ini>
  1824. * gDelayBeforeVdevStop - wait time for tx complete before vdev stop
  1825. * @Min: 2
  1826. * @Max: 200
  1827. * @Default: 20
  1828. *
  1829. * This INI is used to set wait time for tx complete before vdev stop.
  1830. *
  1831. * Related: None
  1832. *
  1833. * Usage: External
  1834. *
  1835. * </ini>
  1836. */
  1837. #define CFG_LFR_DELAY_BEFORE_VDEV_STOP CFG_INI_UINT( \
  1838. "gDelayBeforeVdevStop", \
  1839. 2, \
  1840. 200, \
  1841. 20, \
  1842. CFG_VALUE_OR_DEFAULT, \
  1843. "wait time for tx complete before vdev stop")
  1844. /*
  1845. * <ini>
  1846. * enable_bss_load_roam_trigger - enable/disable bss load based roam trigger
  1847. * @Min: 0
  1848. * @Max: 1
  1849. * @Default: 0
  1850. *
  1851. * This ini when enabled, allows the firmware to roam when bss load outpaces
  1852. * the configured bss load threshold. When this ini is disabled, firmware
  1853. * doesn't consider bss load values to trigger roam.
  1854. *
  1855. * Related: None
  1856. *
  1857. * Supported Feature: Roaming
  1858. *
  1859. * Usage: External
  1860. *
  1861. * </ini>
  1862. */
  1863. #define CFG_ENABLE_BSS_LOAD_TRIGGERED_ROAM CFG_INI_BOOL( \
  1864. "enable_bss_load_roam_trigger", \
  1865. 0, \
  1866. "enable bss load triggered roaming")
  1867. /*
  1868. * <ini>
  1869. * bss_load_threshold/RoamCU_Trigger - bss load above which the STA should
  1870. * trigger roaming
  1871. * @Min: 0
  1872. * @Max: 100
  1873. * @Default: 70
  1874. *
  1875. * When the bss laod value that is sampled exceeds this threshold, firmware
  1876. * will trigger roaming if bss load trigger is enabled.
  1877. *
  1878. * Related: None
  1879. *
  1880. * Supported Feature: Roaming
  1881. *
  1882. * Usage: External
  1883. *
  1884. * </ini>
  1885. */
  1886. #define CFG_BSS_LOAD_THRESHOLD CFG_INI_UINT( \
  1887. "bss_load_threshold RoamCU_Trigger", \
  1888. 0, \
  1889. 100, \
  1890. 70, \
  1891. CFG_VALUE_OR_DEFAULT, \
  1892. "bss load threshold")
  1893. /*
  1894. * <ini>
  1895. * bss_load_sample_time - Time in milliseconds for which the bss load values
  1896. * obtained from the beacons is sampled.
  1897. * @Min: 0
  1898. * @Max: 0xffffffff
  1899. * @Default: 10000
  1900. *
  1901. * Related: None
  1902. *
  1903. * Supported Feature: Roaming
  1904. *
  1905. * Usage: External
  1906. *
  1907. * </ini>
  1908. */
  1909. #define CFG_BSS_LOAD_SAMPLE_TIME CFG_INI_UINT( \
  1910. "bss_load_sample_time", \
  1911. 0, \
  1912. 0xffffffff, \
  1913. 10000, \
  1914. CFG_VALUE_OR_DEFAULT, \
  1915. "bss load sampling time")
  1916. /*
  1917. * <ini>
  1918. * bss_load_trigger_5g_rssi_threshold/RoamCU_5GRSSIRange -
  1919. * Current AP minimum RSSI in dBm below
  1920. * which roaming can be triggered if BSS load exceeds bss_load_threshold.
  1921. * @Min: -120
  1922. * @Max: 0
  1923. * @Default: -70
  1924. *
  1925. * If connected AP is in 5Ghz, then consider bss load roam triggered only if
  1926. * load % > bss_load_threshold && connected AP rssi is worse than
  1927. * bss_load_trigger_5g_rssi_threshold
  1928. *
  1929. * Related: "bss_load_threshold"
  1930. *
  1931. * Supported Feature: Roaming
  1932. *
  1933. * Usage: Internal/External
  1934. *
  1935. * </ini>
  1936. */
  1937. #define CFG_BSS_LOAD_TRIG_5G_RSSI_THRES CFG_INI_INT( \
  1938. "bss_load_trigger_5g_rssi_threshold RoamCU_5GRSSIRange", \
  1939. -120, \
  1940. 0, \
  1941. -70, \
  1942. CFG_VALUE_OR_DEFAULT, \
  1943. "Minimum RSSI of current AP in 5GHz band for BSS load roam trigger")
  1944. /*
  1945. * <ini>
  1946. * bss_load_trigger_2g_rssi_threshold/RoamCU_24GRSSIRange -
  1947. * Current AP minimum RSSI in dBm below
  1948. * which roaming can be triggered if BSS load exceeds bss_load_threshold.
  1949. * @Min: -120
  1950. * @Max: 0
  1951. * @Default: -60
  1952. *
  1953. * If connected AP is in 2Ghz, then consider bss load roam triggered only if
  1954. * load % > bss_load_threshold && connected AP rssi is worse than
  1955. * bss_load_trigger_2g_rssi_threshold.
  1956. *
  1957. * Related: "bss_load_threshold"
  1958. *
  1959. * Supported Feature: Roaming
  1960. *
  1961. * Usage: Internal/External
  1962. *
  1963. * </ini>
  1964. */
  1965. #define CFG_BSS_LOAD_TRIG_2G_RSSI_THRES CFG_INI_INT( \
  1966. "bss_load_trigger_2g_rssi_threshold RoamCU_24GRSSIRange", \
  1967. -120, \
  1968. 0, \
  1969. -60, \
  1970. CFG_VALUE_OR_DEFAULT, \
  1971. "Minimum RSSI of current AP in 2.4GHz band for BSS load roam trigger")
  1972. /*
  1973. * <ini>
  1974. * ho_delay_for_rx - Delay hand-off (in msec) by this duration to receive
  1975. * pending rx frames from current BSS
  1976. * @Min: 0
  1977. * @Max: 200
  1978. * @Default: 0
  1979. *
  1980. * For LFR 3.0 roaming scenario, once roam candidate is found, firmware
  1981. * waits for minimum this much duration to receive pending rx frames from
  1982. * current BSS before switching to new channel for handoff to new AP.
  1983. *
  1984. * Related: None
  1985. *
  1986. * Supported Feature: Roaming
  1987. *
  1988. * Usage: External
  1989. *
  1990. * </ini>
  1991. */
  1992. #define CFG_LFR3_ROAM_HO_DELAY_FOR_RX CFG_INI_UINT( \
  1993. "ho_delay_for_rx", \
  1994. 0, \
  1995. 200, \
  1996. 0, \
  1997. CFG_VALUE_OR_DEFAULT, \
  1998. "Delay Hand-off by this duration to receive")
  1999. /*
  2000. * <ini>
  2001. * min_delay_btw_roam_scans - Min duration (in sec) allowed btw two
  2002. * consecutive roam scans
  2003. * @Min: 0
  2004. * @Max: 60
  2005. * @Default: 10
  2006. *
  2007. * Roam scan is not allowed if duration between two consecutive
  2008. * roam scans is less than this time.
  2009. *
  2010. * Related: None
  2011. *
  2012. * Supported Feature: Roaming
  2013. *
  2014. * Usage: External
  2015. *
  2016. * </ini>
  2017. */
  2018. #define CFG_LFR_MIN_DELAY_BTW_ROAM_SCAN CFG_INI_UINT( \
  2019. "min_delay_btw_roam_scans", \
  2020. 0, \
  2021. 60, \
  2022. 10, \
  2023. CFG_VALUE_OR_DEFAULT, \
  2024. "Min duration")
  2025. /*
  2026. * <ini>
  2027. * roam_trigger_reason_bitmask - Contains roam_trigger_reasons
  2028. * @Min: 0
  2029. * @Max: 0xFFFFFFFF
  2030. * @Default: 0x10DA
  2031. *
  2032. * Bitmask containing roam_trigger_reasons for which
  2033. * min_delay_btw_roam_scans constraint should be applied.
  2034. * Currently supported bit positions are as follows:
  2035. * Bit 0 is reserved in the firmware.
  2036. * WMI_ROAM_TRIGGER_REASON_PER - 1
  2037. * WMI_ROAM_TRIGGER_REASON_BMISS - 2
  2038. * WMI_ROAM_TRIGGER_REASON_LOW_RSSI - 3
  2039. * WMI_ROAM_TRIGGER_REASON_HIGH_RSSI - 4
  2040. * WMI_ROAM_TRIGGER_REASON_PERIODIC - 5
  2041. * WMI_ROAM_TRIGGER_REASON_MAWC - 6
  2042. * WMI_ROAM_TRIGGER_REASON_DENSE - 7
  2043. * WMI_ROAM_TRIGGER_REASON_BACKGROUND - 8
  2044. * WMI_ROAM_TRIGGER_REASON_FORCED - 9
  2045. * WMI_ROAM_TRIGGER_REASON_BTM - 10
  2046. * WMI_ROAM_TRIGGER_REASON_UNIT_TEST - 11
  2047. * WMI_ROAM_TRIGGER_REASON_BSS_LOAD - 12
  2048. * WMI_ROAM_TRIGGER_REASON_DEAUTH - 13
  2049. * WMI_ROAM_TRIGGER_REASON_IDLE - 14
  2050. * WMI_ROAM_TRIGGER_REASON_MAX - 15
  2051. *
  2052. * For Ex: 0xDA (PER, LOW_RSSI, HIGH_RSSI, MAWC, DENSE)
  2053. *
  2054. * Related: None
  2055. *
  2056. * Supported Feature: Roaming
  2057. *
  2058. * Usage: External
  2059. *
  2060. * </ini>
  2061. */
  2062. #define CFG_LFR_ROAM_SCAN_TRIGGER_REASON_BITMASK CFG_INI_UINT( \
  2063. "roam_trigger_reason_bitmask", \
  2064. 0, \
  2065. 0xFFFFFFFF, \
  2066. 0x10DA, \
  2067. CFG_VALUE_OR_DEFAULT, \
  2068. "Contains roam_trigger_reasons")
  2069. /*
  2070. * <ini>
  2071. * enable_ftopen - enable/disable FT open feature
  2072. * @Min: 0
  2073. * @Max: 1
  2074. * @Default: 1
  2075. *
  2076. * This INI is used to enable/disable FT open feature
  2077. *
  2078. * Related: None
  2079. *
  2080. * Supported Feature: Roaming
  2081. *
  2082. * Usage: External
  2083. *
  2084. * </ini>
  2085. */
  2086. #define CFG_LFR_ROAM_FT_OPEN_ENABLE CFG_INI_BOOL( \
  2087. "enable_ftopen", \
  2088. 1, \
  2089. "enable/disable FT open feature")
  2090. /*
  2091. * <ini>
  2092. * roam_force_rssi_trigger - To force RSSI trigger
  2093. * irrespective of channel list type
  2094. * @Min: 0
  2095. * @Max: 1
  2096. * @Default: 1
  2097. *
  2098. * This ini is used to set roam scan mode
  2099. * WMI_ROAM_SCAN_MODE_RSSI_CHANGE, irrespective of whether
  2100. * channel list type is CHANNEL_LIST_STATIC or not
  2101. *
  2102. * Related: None
  2103. *
  2104. * Supported Feature: Roaming
  2105. *
  2106. * Usage: External
  2107. *
  2108. * </ini>
  2109. */
  2110. #define CFG_LFR_ROAM_FORCE_RSSI_TRIGGER CFG_INI_BOOL( \
  2111. "roam_force_rssi_trigger", \
  2112. 1, \
  2113. "To force RSSI trigger")
  2114. #ifdef WLAN_FEATURE_ROAM_OFFLOAD
  2115. /*
  2116. * <ini>
  2117. * gRoamOffloadEnabled - enable/disable roam offload feature
  2118. * @Min: 0
  2119. * @Max: 1
  2120. * @Default: 1
  2121. *
  2122. * This INI is used to enable/disable roam offload feature
  2123. *
  2124. * Related: None
  2125. *
  2126. * Supported Feature: Roaming
  2127. *
  2128. * Usage: External
  2129. *
  2130. * </ini>
  2131. */
  2132. #define CFG_LFR3_ROAMING_OFFLOAD CFG_INI_BOOL( \
  2133. "gRoamOffloadEnabled", \
  2134. 1, \
  2135. "enable roam offload")
  2136. /*
  2137. * <ini>
  2138. * enable_self_bss_roam - enable/disable roaming to self bss
  2139. * @Min: 0
  2140. * @Max: 1
  2141. * @Default: 1
  2142. *
  2143. * This INI is used to enable/disable roaming to already connected BSSID
  2144. *
  2145. * Related: None
  2146. *
  2147. * Supported Feature: Roaming
  2148. *
  2149. * Usage: Internal
  2150. *
  2151. * </ini>
  2152. */
  2153. #define CFG_LFR3_ENABLE_SELF_BSS_ROAM CFG_INI_BOOL( \
  2154. "enable_self_bss_roam", \
  2155. 0, \
  2156. "enable self bss roam")
  2157. /*
  2158. * <ini>
  2159. * enable_disconnect_roam_offload - Enable/Disable emergency roaming during
  2160. * deauth/disassoc
  2161. * @Min: 0 - Disabled
  2162. * @Max: 1 - Enabled
  2163. * @Default: 1
  2164. *
  2165. * When this ini is enabled firmware will trigger roam scan and roam to a new ap
  2166. * if candidate is found and it will not send the deauth/disassoc frame to
  2167. * the host driver.
  2168. * If roaming fails after this deauth, then firmware will send
  2169. * WMI_ROAM_REASON_DEAUTH event to the host. If roaming is successful, driver
  2170. * follows the normal roam synch event path.
  2171. *
  2172. * Supported Feature: Roaming
  2173. *
  2174. * Usage: Internal/External
  2175. *
  2176. * </ini>
  2177. */
  2178. #define CFG_LFR_ENABLE_DISCONNECT_ROAM CFG_INI_BOOL( \
  2179. "enable_disconnect_roam_offload", \
  2180. true, \
  2181. "Enable/Disable roaming on deauth/disassoc from AP")
  2182. /*
  2183. * <ini>
  2184. * enable_idle_roam - Enable/Disable idle roaming
  2185. * @Min: 0 - Disabled
  2186. * @Max: 1 - Enabled
  2187. * @Default: 0
  2188. *
  2189. * When this ini is enabled firmware will trigger roam scan and roam to a new
  2190. * ap if current connected AP rssi falls below the threshold. To consider the
  2191. * connection as idle, the following conditions should be met if this ini
  2192. * "enable_idle_roam" is enabled:
  2193. * 1. User space sends "SET SUSPENDMODE" command with value 0.
  2194. * 2. No TX/RX data for idle time configured via ini "idle_roam_inactive_time".
  2195. * 3. Connected AP rssi change doesn't exceed a specific delta value.
  2196. * (configured via ini idle_roam_rssi_delta)
  2197. * 4. Connected AP rssi falls below minimum rssi (configured via ini
  2198. * "idle_roam_min_rssi").
  2199. *
  2200. * Supported Feature: Roaming
  2201. *
  2202. * Usage: Internal/External
  2203. *
  2204. * </ini>
  2205. */
  2206. #define CFG_LFR_ENABLE_IDLE_ROAM CFG_INI_BOOL( \
  2207. "enable_idle_roam", \
  2208. false, \
  2209. "Enable/Disable idle roam")
  2210. /*
  2211. * <ini>
  2212. * idle_roam_rssi_delta/RoamIdle_RSSIVariation - This threshold is the criteria
  2213. * to decide whether DUT is idle or moving. If rssi delta is more than
  2214. * configured threshold then its considered as not idle. RSSI delta is entered
  2215. *in dBm. Idle roaming can be triggered if the connected AP rssi change exceeds
  2216. * or falls below the rssi delta and if other criteria of ini "enable_idle_roam"
  2217. * is met
  2218. * @Min: 0
  2219. * @Max: 50
  2220. * @Default: 3
  2221. *
  2222. * Related: enable_idle_roam
  2223. *
  2224. * Supported Feature: Roaming
  2225. *
  2226. * Usage: Internal/External
  2227. *
  2228. * </ini>
  2229. */
  2230. #define CFG_LFR_IDLE_ROAM_RSSI_DELTA CFG_INI_UINT( \
  2231. "idle_roam_rssi_delta RoamIdle_RSSIVariation", \
  2232. 0, \
  2233. 50, \
  2234. 3, \
  2235. CFG_VALUE_OR_DEFAULT, \
  2236. "Configure RSSI delta to start idle roam")
  2237. /*
  2238. * <ini>
  2239. * idle_roam_inactive_time - Time duration in millseconds for which the
  2240. * connection is idle.
  2241. * @Min: 0
  2242. * @Max: 0xFFFFFFFF
  2243. * @Default: 10000
  2244. *
  2245. * This ini is used to configure the time in seconds for which the connection
  2246. * candidate is idle and after which idle roam scan can be triggered if
  2247. * other criteria of ini "enable_idle_roam" is met.
  2248. *
  2249. * Related: enable_idle_roam
  2250. *
  2251. * Supported Feature: Roaming
  2252. *
  2253. * Usage: Internal/External
  2254. *
  2255. * </ini>
  2256. */
  2257. #define CFG_LFR_IDLE_ROAM_INACTIVE_TIME CFG_INI_UINT( \
  2258. "idle_roam_inactive_time", \
  2259. 0, \
  2260. 0xFFFFFFFF, \
  2261. 10000, \
  2262. CFG_VALUE_OR_DEFAULT, \
  2263. "Configure RSSI delta to start idle roam")
  2264. /*
  2265. * <ini>
  2266. * idle_data_packet_count/RoamIdle_InactivePacketCount - No of tx/rx packets
  2267. * above which the connection is not idle.
  2268. * @Min: 0
  2269. * @Max: 0xFFFFFFFF
  2270. * @Default: 10
  2271. *
  2272. * This ini is used to configure the acceptable number of tx/rx packets below
  2273. * which the connection is idle. Ex: If idle_data_packet_count is 10
  2274. * and if the tx/rx packet count is less than 10, the connection is
  2275. * idle. If there are more than 10 packets, the connection is active one.
  2276. *
  2277. * Related: enable_idle_roam
  2278. *
  2279. * Supported Feature: Roaming
  2280. *
  2281. * Usage: Internal/External
  2282. *
  2283. * </ini>
  2284. */
  2285. #define CFG_LFR_IDLE_ROAM_PACKET_COUNT CFG_INI_UINT( \
  2286. "idle_data_packet_count RoamIdle_InactivePacketCount", \
  2287. 0, \
  2288. 0xFFFFFFFF, \
  2289. 10, \
  2290. CFG_VALUE_OR_DEFAULT, \
  2291. "Configure idle packet count")
  2292. /*
  2293. * <ini>
  2294. * idle_roam_min_rssi/RoamIdle_MinRSSI - Minimum RSSI of connected AP, below
  2295. * which idle roam scan can be triggered if other criteria of ini
  2296. * "enable_idle_roam" is met.
  2297. * @Min: -96
  2298. * @Max: 0
  2299. * @Default: -65
  2300. *
  2301. * Related: enable_idle_roam
  2302. *
  2303. * Supported Feature: Roaming
  2304. *
  2305. * Usage: Internal/External
  2306. *
  2307. * </ini>
  2308. */
  2309. #define CFG_LFR_IDLE_ROAM_MIN_RSSI CFG_INI_INT( \
  2310. "idle_roam_min_rssi RoamIdle_MinRSSI", \
  2311. -96, \
  2312. 0, \
  2313. -65, \
  2314. CFG_VALUE_OR_DEFAULT, \
  2315. "Configure idle roam minimum RSSI")
  2316. /*
  2317. * <ini>
  2318. * idle_roam_band - Band on which idle roam scan will be
  2319. * enabled
  2320. * @Min: 0
  2321. * @Max: 2
  2322. * @Default: 0
  2323. *
  2324. * Value 0 - Allow idle roam on both bands
  2325. * Value 1 - Allow idle roam only on 2G band
  2326. * Value 2 - Allow idle roam only on 5G band
  2327. *
  2328. * Related: enable_idle_roam
  2329. *
  2330. * Supported Feature: Roaming
  2331. *
  2332. * Usage: Internal/External
  2333. *
  2334. * </ini>
  2335. */
  2336. #define CFG_LFR_IDLE_ROAM_BAND CFG_INI_UINT( \
  2337. "idle_roam_band", \
  2338. 0, \
  2339. 2, \
  2340. 0, \
  2341. CFG_VALUE_OR_DEFAULT, \
  2342. "Band on which idle roam needs to be enabled")
  2343. /*
  2344. * <ini>
  2345. * roam_triggers - Bitmap of roaming triggers. Setting this to
  2346. * zero will disable roaming altogether for the STA interface.
  2347. * ESS report element of beacon explores BSS information, for roaming station
  2348. * uses it to consider next AP to roam. ROAM_TRIGGER_REASON_ESS_RSSI bit is
  2349. * to enable/disable roam trigger for ESS RSSI reason. This bit of ini is also
  2350. * used for WFA certification.
  2351. * @Min: 0
  2352. * @Max: 0xFFFFFFFF
  2353. * @Default: 0x3FFFF
  2354. *
  2355. * ROAM_TRIGGER_REASON_PER BIT 1
  2356. * ROAM_TRIGGER_REASON_BMISS BIT 2
  2357. * ROAM_TRIGGER_REASON_LOW_RSSI BIT 3
  2358. * ROAM_TRIGGER_REASON_HIGH_RSSI BIT 4
  2359. * ROAM_TRIGGER_REASON_PERIODIC BIT 5
  2360. * ROAM_TRIGGER_REASON_MAWC BIT 6
  2361. * ROAM_TRIGGER_REASON_DENSE BIT 7
  2362. * ROAM_TRIGGER_REASON_BACKGROUND BIT 8
  2363. * ROAM_TRIGGER_REASON_FORCED BIT 9
  2364. * ROAM_TRIGGER_REASON_BTM BIT 10
  2365. * ROAM_TRIGGER_REASON_UNIT_TEST BIT 11
  2366. * ROAM_TRIGGER_REASON_BSS_LOAD BIT 12
  2367. * ROAM_TRIGGER_REASON_DEAUTH BIT 13
  2368. * ROAM_TRIGGER_REASON_IDLE BIT 14
  2369. * ROAM_TRIGGER_REASON_STA_KICKOUT BIT 15
  2370. * ROAM_TRIGGER_REASON_ESS_RSSI BIT 16
  2371. * ROAM_TRIGGER_REASON_WTC_BTM BIT 17
  2372. * ROAM_TRIGGER_REASON_PMK_TIMEOUT BIT 18
  2373. * ROAM_TRIGGER_REASON_MAX BIT 19
  2374. *
  2375. * Related: none
  2376. *
  2377. * Supported Feature: Roaming
  2378. *
  2379. * Usage: External
  2380. *
  2381. * </ini>
  2382. */
  2383. #define CFG_ROAM_TRIGGER_BITMAP CFG_INI_UINT( \
  2384. "roam_triggers", \
  2385. 0, \
  2386. 0xFFFFFFFF, \
  2387. 0x7FFFF, \
  2388. CFG_VALUE_OR_DEFAULT, \
  2389. "Bitmap of roaming triggers")
  2390. /*
  2391. * <ini>
  2392. * sta_disable_roam - Disable Roam on sta interface
  2393. * @Min: 0 - Roam Enabled on sta interface
  2394. * @Max: 0xffffffff - Roam Disabled on sta interface irrespective
  2395. * of other interface connections
  2396. * @Default: 0x00
  2397. *
  2398. * Disable roaming on STA iface to avoid audio glitches on p2p and ndp if
  2399. * those are in connected state. Each bit for "sta_disable_roam" INI represents
  2400. * an interface for which sta roaming can be disabled.
  2401. *
  2402. * LFR3_STA_ROAM_DISABLE_BY_P2P BIT(0)
  2403. * LFR3_STA_ROAM_DISABLE_BY_NAN BIT(1)
  2404. *
  2405. * Related: None.
  2406. *
  2407. * Supported Feature: ROAM
  2408. *
  2409. * Usage: Internal
  2410. *
  2411. * </ini>
  2412. */
  2413. #define CFG_STA_DISABLE_ROAM CFG_INI_UINT( \
  2414. "sta_disable_roam", \
  2415. 0, \
  2416. 0xffffffff, \
  2417. 0x00, \
  2418. CFG_VALUE_OR_DEFAULT, \
  2419. "disable roam on STA iface if one of the iface mentioned in default is in connected state")
  2420. /*
  2421. * <ini>
  2422. * enable_dual_sta_roam_offload - Enable roaming offload on both interfaces
  2423. * for STA + STA
  2424. * @Min: 0 - Dual STA Roam offload Disabled
  2425. * @Max: 1 - Dual STA Roam offload Enabled
  2426. * @Default: 1
  2427. *
  2428. * Enabling this ini will:
  2429. * a) Enforce the STA + STA connection be DBS if the hw is capable.
  2430. * b) Enable Roam Scan Offload on both the STA vdev.
  2431. * c) Enable firmware to support sequential roaming on both STA vdev
  2432. * if the firmware is capable of dual sta roaming.
  2433. *
  2434. * Related: None.
  2435. *
  2436. * Supported Feature: ROAM
  2437. *
  2438. * Usage: External
  2439. *
  2440. * </ini>
  2441. */
  2442. #define CFG_ENABLE_DUAL_STA_ROAM_OFFLOAD CFG_INI_UINT( \
  2443. "enable_dual_sta_roam_offload", \
  2444. false, \
  2445. true, \
  2446. true, \
  2447. CFG_VALUE_OR_DEFAULT, \
  2448. "Enable roam on both STA vdev")
  2449. #define ROAM_OFFLOAD_ALL \
  2450. CFG(CFG_LFR3_ROAMING_OFFLOAD) \
  2451. CFG(CFG_LFR3_ENABLE_SELF_BSS_ROAM) \
  2452. CFG(CFG_LFR_ENABLE_DISCONNECT_ROAM) \
  2453. CFG(CFG_LFR_ENABLE_IDLE_ROAM) \
  2454. CFG(CFG_LFR_IDLE_ROAM_RSSI_DELTA) \
  2455. CFG(CFG_LFR_IDLE_ROAM_INACTIVE_TIME) \
  2456. CFG(CFG_LFR_IDLE_ROAM_PACKET_COUNT) \
  2457. CFG(CFG_LFR_IDLE_ROAM_MIN_RSSI) \
  2458. CFG(CFG_LFR_IDLE_ROAM_BAND) \
  2459. CFG(CFG_ROAM_TRIGGER_BITMAP) \
  2460. CFG(CFG_STA_DISABLE_ROAM) \
  2461. CFG(CFG_ENABLE_DUAL_STA_ROAM_OFFLOAD) \
  2462. #else
  2463. #define ROAM_OFFLOAD_ALL
  2464. #endif
  2465. #ifdef FEATURE_WLAN_ESE
  2466. /*
  2467. * <ini>
  2468. * EseEnabled - Enable ESE feature
  2469. * @Min: 0
  2470. * @Max: 1
  2471. * @Default: 0
  2472. *
  2473. * This ini is used to enable/disable ESE feature
  2474. *
  2475. * Related: None
  2476. *
  2477. * Supported Feature: Roaming
  2478. *
  2479. * Usage: External
  2480. *
  2481. * </ini>
  2482. */
  2483. #define CFG_LFR_ESE_FEATURE_ENABLED CFG_INI_BOOL( \
  2484. "EseEnabled", \
  2485. 0, \
  2486. "Enable ESE")
  2487. #define LFR_ESE_ALL CFG(CFG_LFR_ESE_FEATURE_ENABLED)
  2488. #else
  2489. #define LFR_ESE_ALL
  2490. #endif
  2491. #ifdef FEATURE_LFR_SUBNET_DETECTION
  2492. /*
  2493. * <ini>
  2494. * gLFRSubnetDetectionEnable - Enable LFR3 subnet detection
  2495. * @Min: 0
  2496. * @Max: 1
  2497. * @Default: 1
  2498. *
  2499. * Enable IP subnet detection during legacy fast roming version 3. Legacy fast
  2500. * roaming could roam across IP subnets without host processors' knowledge.
  2501. * This feature enables firmware to wake up the host processor if it
  2502. * successfully determines change in the IP subnet. Change in IP subnet could
  2503. * potentially cause disruption in IP connnectivity if IP address is not
  2504. * refreshed.
  2505. *
  2506. * Related: None
  2507. *
  2508. * Supported Feature: Roaming
  2509. *
  2510. * Usage: External
  2511. *
  2512. * </ini>
  2513. */
  2514. #define CFG_LFR3_ENABLE_SUBNET_DETECTION CFG_INI_BOOL( \
  2515. "gLFRSubnetDetectionEnable", \
  2516. 1, \
  2517. "Enable LFR3 subnet detection")
  2518. #define LFR_SUBNET_DETECTION_ALL CFG(CFG_LFR3_ENABLE_SUBNET_DETECTION)
  2519. #else
  2520. #define LFR_SUBNET_DETECTION_ALL
  2521. #endif
  2522. #if defined(WLAN_SAE_SINGLE_PMK) && defined(WLAN_FEATURE_ROAM_OFFLOAD)
  2523. /*
  2524. * <ini>
  2525. * sae_single_pmk_feature_enabled - Enable/disable sae single pmk feature.
  2526. * @Min: 0
  2527. * @Max: 1
  2528. * @Default: 1
  2529. *
  2530. * This INI is to enable/disable SAE Roaming with same PMK/PMKID feature support
  2531. *
  2532. * Related: None.
  2533. *
  2534. * Supported Feature: Roaming
  2535. *
  2536. * Usage: Internal
  2537. *
  2538. * </ini>
  2539. */
  2540. #define CFG_SAE_SINGLE_PMK CFG_INI_BOOL( \
  2541. "sae_single_pmk_feature_enabled", \
  2542. true, \
  2543. "Enable/disable SAE Roaming with single PMK/PMKID")
  2544. #define SAE_SINGLE_PMK_ALL CFG(CFG_SAE_SINGLE_PMK)
  2545. #else
  2546. #define SAE_SINGLE_PMK_ALL
  2547. #endif
  2548. #ifdef WLAN_ADAPTIVE_11R
  2549. /*
  2550. * <ini>
  2551. * adaptive_11r - Enable/disable adaptive 11r feature.
  2552. * @Min: 0
  2553. * @Max: 1
  2554. * @Default: 0
  2555. *
  2556. * Adaptive 11r feature enables the AP to support FT-AKM without
  2557. * configuring the FT-AKM in the network. The AP will advertise non-FT akm
  2558. * with a vendor specific IE having Adaptive 11r bit set to 1 in the IE data.
  2559. * The AP also advertises the MDE in beacon/probe response.
  2560. *
  2561. * STA should check the adaptive 11r capability if the AP advertises MDE in
  2562. * beacon/probe and adaptive 11r capability in vendor specific IE. If adaptive
  2563. * 11r capability is found, STA can advertise the FT equivalent of the non-FT
  2564. * AKM and connect with 11r protocol.
  2565. *
  2566. * Related: None.
  2567. *
  2568. * Supported Feature: Fast BSS Transition
  2569. *
  2570. * Usage: External
  2571. *
  2572. * </ini>
  2573. */
  2574. #define CFG_ADAPTIVE_11R CFG_INI_BOOL( \
  2575. "enable_adaptive_11r", \
  2576. false, \
  2577. "Enable/disable adaptive 11r support")
  2578. #define ADAPTIVE_11R_ALL CFG(CFG_ADAPTIVE_11R)
  2579. #else
  2580. #define ADAPTIVE_11R_ALL
  2581. #endif
  2582. /*
  2583. * <ini>
  2584. * roaming_scan_policy - To config roaming scan policy
  2585. * @Min: 0
  2586. * @Max: 1
  2587. * @Default: 0
  2588. *
  2589. * This ini is used to configure roaming scan behavior from HOST
  2590. * 0 : DBS scan
  2591. * 1 : Non-DBS scan
  2592. *
  2593. * Related: None
  2594. *
  2595. * Supported Feature: Roaming
  2596. *
  2597. * Usage: External
  2598. *
  2599. * </ini>
  2600. */
  2601. #define CFG_ROAM_SCAN_SCAN_POLICY CFG_INI_BOOL( \
  2602. "roaming_scan_policy", \
  2603. 0, \
  2604. "Config roam scan policy")
  2605. /*
  2606. * <ini>
  2607. * enable_ft_im_roaming - FW needs to perform FT initial moiblity association
  2608. * instead of FT roaming for deauth roam trigger
  2609. * @Min: 0
  2610. * @Max: 1
  2611. * @Default: 1
  2612. *
  2613. * This ini is used to FT roaming for deauth roam trigger behavior from HOST
  2614. * 0 - To disable FT-IM
  2615. * 1 - To enable FT-IM
  2616. *
  2617. * Related: None
  2618. *
  2619. * Supported Feature: Roaming
  2620. *
  2621. * Usage: Internal
  2622. *
  2623. * </ini>
  2624. */
  2625. #define CFG_FT_IM_ROAMING CFG_INI_BOOL( \
  2626. "enable_ft_im_roaming", \
  2627. 1, \
  2628. "FT roaming for deauth roam trigger")
  2629. /*
  2630. * <ini>
  2631. * roam_scan_inactivity_time - Device inactivity monitoring time in
  2632. * milliseconds for which the device is considered to be inactive with data
  2633. * packets count is less than configured roam_inactive_data_count.
  2634. *
  2635. * @Min: 0
  2636. * @Max: 0xFFFFFFFF
  2637. * @Default: 0
  2638. *
  2639. * The below three ini values are used to control the roam scan after the
  2640. * firmware gets empty roam scan results during periodic roam scans.
  2641. * 1. roam_scan_inactivity_time
  2642. * 2. roam_inactive_data_count
  2643. * 3. roam_scan_period_after_inactivity
  2644. * The first two ini "roam_scan_inactivity_time" and "roam_inactive_data_count"
  2645. * is frames the criteria to detect if the DUT is inactive. If the device is
  2646. * identified to be inactive based on the above two ini, then the value,
  2647. * "roam_scan_period_after_inactivity" will be used as periodic roam scan
  2648. * duration.
  2649. *
  2650. * Related: roam_inactive_data_count
  2651. *
  2652. * Supported Feature: Roaming
  2653. *
  2654. * Usage: External
  2655. *
  2656. * </ini>
  2657. */
  2658. #define CFG_ROAM_SCAN_INACTIVITY_TIME CFG_INI_UINT( \
  2659. "roam_scan_inactivity_time", \
  2660. 0, \
  2661. 0xFFFFFFFF, \
  2662. 0, \
  2663. CFG_VALUE_OR_DEFAULT, \
  2664. "Device inactivity monitoring time")
  2665. /*
  2666. * <ini>
  2667. * roam_inactive_data_count/RoamScan_InactiveCount - Maximum allowed data
  2668. * packets count during roam_scan_inactivity_time.
  2669. *
  2670. * @Min: 0
  2671. * @Max: 0xFFFFFFFF
  2672. * @Default: 10
  2673. *
  2674. * The DUT is said to be inactive only if the data packets count
  2675. * during this roam_scan_inactivity_time is less than the configured
  2676. * roam_inactive_data_count.
  2677. *
  2678. * Related: roam_scan_inactivity_time
  2679. *
  2680. * Supported Feature: Roaming
  2681. *
  2682. * Usage: External
  2683. *
  2684. * </ini>
  2685. */
  2686. #define CFG_ROAM_INACTIVE_COUNT CFG_INI_UINT( \
  2687. "roam_inactive_data_count RoamScan_InactiveCount", \
  2688. 0, \
  2689. 0xFFFFFFFF, \
  2690. 10, \
  2691. CFG_VALUE_OR_DEFAULT, \
  2692. "Roam scan inactivity period data pkt count")
  2693. /*
  2694. * <ini>
  2695. * roam_scan_period_after_inactivity - Roam scan duration in ms after device is
  2696. * out of inactivity state.
  2697. *
  2698. * @Min: 0
  2699. * @Max: 0xFFFFFFFF
  2700. * @Default: 120000
  2701. *
  2702. * If there is empty scan results during roam scan, firmware will move to
  2703. * roam scan inactive state if roam_scan_inactivity and
  2704. * roam_inactive_data_count criteria are met.
  2705. * This ini is used to configure the roam scan duration in ms once the
  2706. * inactivity is finished and roam scan can be started.
  2707. *
  2708. * Related: roam_scan_inactivity_time, roam_inactive_data_count
  2709. *
  2710. * Supported Feature: Roaming
  2711. *
  2712. * Usage: External
  2713. *
  2714. * </ini>
  2715. */
  2716. #define CFG_POST_INACTIVITY_ROAM_SCAN_PERIOD CFG_INI_UINT( \
  2717. "roam_scan_period_after_inactivity", \
  2718. 0, \
  2719. 0xFFFFFFFF, \
  2720. 120000, \
  2721. CFG_VALUE_OR_DEFAULT, \
  2722. "Roam scan period post inactivity")
  2723. #ifdef WLAN_FEATURE_ROAM_OFFLOAD
  2724. /*
  2725. * <ini>
  2726. * enable_roam_reason_vsie - Enable/Disable inclusion of Roam Reason
  2727. * in Re(association) frame
  2728. *
  2729. * @Min: 0
  2730. * @Max: 1
  2731. * @Default: 0
  2732. *
  2733. * This ini is used to enable fw to include/exclude roam reason vsie in
  2734. * Re(association)
  2735. *
  2736. * Related: None
  2737. *
  2738. * Supported Feature: Roaming
  2739. *
  2740. * Usage: internal
  2741. *
  2742. * </ini>
  2743. */
  2744. #define CFG_ENABLE_ROAM_REASON_VSIE CFG_INI_BOOL( \
  2745. "enable_roam_reason_vsie", \
  2746. 0, \
  2747. "To Enable enable_roam_reason_vsie")
  2748. #define ROAM_REASON_VSIE_ALL CFG(CFG_ENABLE_ROAM_REASON_VSIE)
  2749. #else
  2750. #define ROAM_REASON_VSIE_ALL
  2751. #endif
  2752. #define CFG_LFR_ALL \
  2753. CFG(CFG_LFR_MAWC_ROAM_ENABLED) \
  2754. CFG(CFG_LFR_MAWC_ROAM_TRAFFIC_THRESHOLD) \
  2755. CFG(CFG_LFR_MAWC_ROAM_AP_RSSI_THRESHOLD) \
  2756. CFG(CFG_LFR_MAWC_ROAM_RSSI_HIGH_ADJUST) \
  2757. CFG(CFG_LFR_MAWC_ROAM_RSSI_LOW_ADJUST) \
  2758. CFG(CFG_LFR_ROAM_RSSI_ABS_THRESHOLD) \
  2759. CFG(CFG_LFR_5G_RSSI_THRESHOLD_OFFSET) \
  2760. CFG(CFG_LFR_ENABLE_FAST_ROAM_IN_CONCURRENCY) \
  2761. CFG(CFG_LFR_EARLY_STOP_SCAN_ENABLE) \
  2762. CFG(CFG_LFR_EARLY_STOP_SCAN_MIN_THRESHOLD) \
  2763. CFG(CFG_LFR_EARLY_STOP_SCAN_MAX_THRESHOLD) \
  2764. CFG(CFG_LFR_ROAM_DENSE_TRAFFIC_THRESHOLD) \
  2765. CFG(CFG_LFR_ROAM_DENSE_RSSI_THRE_OFFSET) \
  2766. CFG(CFG_LFR_ROAM_DENSE_MIN_APS) \
  2767. CFG(CFG_LFR_ROAM_BG_SCAN_BAD_RSSI_THRESHOLD) \
  2768. CFG(CFG_LFR_ROAM_BG_SCAN_CLIENT_BITMAP) \
  2769. CFG(CFG_LFR_ROAM_BG_SCAN_BAD_RSSI_OFFSET_2G) \
  2770. CFG(CFG_ROAM_DATA_RSSI_THRESHOLD_TRIGGERS) \
  2771. CFG(CFG_ROAM_DATA_RSSI_THRESHOLD) \
  2772. CFG(CFG_RX_DATA_INACTIVITY_TIME) \
  2773. CFG(CFG_LFR_ADAPTIVE_ROAMSCAN_DWELL_MODE) \
  2774. CFG(CFG_LFR_PER_ROAM_ENABLE) \
  2775. CFG(CFG_LFR_PER_ROAM_CONFIG_HIGH_RATE_TH) \
  2776. CFG(CFG_LFR_PER_ROAM_CONFIG_LOW_RATE_TH) \
  2777. CFG(CFG_LFR_PER_ROAM_CONFIG_RATE_TH_PERCENT) \
  2778. CFG(CFG_LFR_PER_ROAM_REST_TIME) \
  2779. CFG(CFG_LFR_PER_ROAM_MONITOR_TIME) \
  2780. CFG(CFG_LFR_PER_ROAM_MIN_CANDIDATE_RSSI) \
  2781. CFG(CFG_LFR3_ROAM_DISALLOW_DURATION) \
  2782. CFG(CFG_LFR3_ROAM_RSSI_CHANNEL_PENALIZATION) \
  2783. CFG(CFG_LFR3_ROAM_NUM_DISALLOWED_APS) \
  2784. CFG(CFG_LFR_ENABLE_5G_BAND_PREF) \
  2785. CFG(CFG_LFR_5G_RSSI_BOOST_THRESHOLD) \
  2786. CFG(CFG_LFR_5G_RSSI_BOOST_FACTOR) \
  2787. CFG(CFG_LFR_5G_MAX_RSSI_BOOST) \
  2788. CFG(CFG_LFR_5G_RSSI_PENALIZE_THRESHOLD) \
  2789. CFG(CFG_LFR_5G_RSSI_PENALIZE_FACTOR) \
  2790. CFG(CFG_LFR_5G_MAX_RSSI_PENALIZE) \
  2791. CFG(CFG_LFR_MAX_NUM_PRE_AUTH) \
  2792. CFG(CFG_LFR3_ROAM_PREAUTH_RETRY_COUNT) \
  2793. CFG(CFG_LFR3_ROAM_PREAUTH_NO_ACK_TIMEOUT) \
  2794. CFG(CFG_LFR_FEATURE_ENABLED) \
  2795. CFG(CFG_LFR_MAWC_FEATURE_ENABLED) \
  2796. CFG(CFG_LFR_FAST_TRANSITION_ENABLED) \
  2797. CFG(CFG_LFR_ROAM_RSSI_DIFF) \
  2798. CFG(CFG_LFR_ROAM_BG_RSSI_TH) \
  2799. CFG(CFG_LFR_ENABLE_WES_MODE) \
  2800. CFG(CFG_LFR_ROAM_SCAN_OFFLOAD_ENABLED) \
  2801. CFG(CFG_LFR_NEIGHBOR_SCAN_CHANNEL_LIST) \
  2802. CFG(CFG_LFR_NEIGHBOR_SCAN_TIMER_PERIOD) \
  2803. CFG(CFG_LFR_NEIGHBOR_SCAN_MIN_TIMER_PERIOD) \
  2804. CFG(CFG_LFR_NEIGHBOR_LOOKUP_RSSI_THRESHOLD) \
  2805. CFG(CFG_LFR_OPPORTUNISTIC_SCAN_THRESHOLD_DIFF) \
  2806. CFG(CFG_LFR_ROAM_RESCAN_RSSI_DIFF) \
  2807. CFG(CFG_LFR_NEIGHBOR_SCAN_MIN_CHAN_TIME) \
  2808. CFG(CFG_LFR_NEIGHBOR_SCAN_MAX_CHAN_TIME) \
  2809. CFG(CFG_LFR_NEIGHBOR_SCAN_RESULTS_REFRESH_PERIOD) \
  2810. CFG(CFG_LFR_EMPTY_SCAN_REFRESH_PERIOD) \
  2811. CFG(CFG_LFR_ROAM_BMISS_FIRST_BCNT) \
  2812. CFG(CFG_LFR_ROAM_BMISS_FINAL_BCNT) \
  2813. CFG(CFG_LFR_ROAMING_DFS_CHANNEL) \
  2814. CFG(CFG_LFR_ROAM_SCAN_HI_RSSI_MAXCOUNT) \
  2815. CFG(CFG_LFR_ROAM_SCAN_HI_RSSI_DELTA) \
  2816. CFG(CFG_LFR_ROAM_SCAN_HI_RSSI_DELAY) \
  2817. CFG(CFG_LFR_ROAM_SCAN_HI_RSSI_UB) \
  2818. CFG(CFG_LFR_ROAM_PREFER_5GHZ) \
  2819. CFG(CFG_LFR_ROAM_INTRA_BAND) \
  2820. CFG(CFG_LFR_ROAM_SCAN_N_PROBES) \
  2821. CFG(CFG_LFR_ROAM_SCAN_HOME_AWAY_TIME) \
  2822. CFG(CFG_LFR_DELAY_BEFORE_VDEV_STOP) \
  2823. CFG(CFG_ENABLE_BSS_LOAD_TRIGGERED_ROAM) \
  2824. CFG(CFG_BSS_LOAD_THRESHOLD) \
  2825. CFG(CFG_BSS_LOAD_SAMPLE_TIME) \
  2826. CFG(CFG_LFR3_ROAM_HO_DELAY_FOR_RX) \
  2827. CFG(CFG_LFR_MIN_DELAY_BTW_ROAM_SCAN) \
  2828. CFG(CFG_LFR_ROAM_SCAN_TRIGGER_REASON_BITMASK) \
  2829. CFG(CFG_LFR_ROAM_FT_OPEN_ENABLE) \
  2830. CFG(CFG_LFR_ROAM_FORCE_RSSI_TRIGGER) \
  2831. CFG(CFG_ROAM_SCAN_SCAN_POLICY) \
  2832. CFG(CFG_ROAM_SCAN_INACTIVITY_TIME) \
  2833. CFG(CFG_FT_IM_ROAMING) \
  2834. CFG(CFG_ROAM_INACTIVE_COUNT) \
  2835. CFG(CFG_POST_INACTIVITY_ROAM_SCAN_PERIOD) \
  2836. CFG(CFG_BSS_LOAD_TRIG_5G_RSSI_THRES) \
  2837. CFG(CFG_BSS_LOAD_TRIG_2G_RSSI_THRES) \
  2838. CFG(CFG_LFR_FULL_ROAM_SCAN_REFRESH_PERIOD) \
  2839. ADAPTIVE_11R_ALL \
  2840. ROAM_OFFLOAD_ALL \
  2841. LFR_ESE_ALL \
  2842. LFR_SUBNET_DETECTION_ALL \
  2843. SAE_SINGLE_PMK_ALL \
  2844. ROAM_REASON_VSIE_ALL
  2845. #endif /* CFG_MLME_LFR_H__ */