cfg_mlme_lfr.h 67 KB

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