staging: rtl8723bs: replace magic numbers with named constants
PATCH 1/1 staging: rtl8723bs: replace magic numbers with named constants
Remove the magic numbers in rtl8723b_InitBeaconParameters() as requested by the outstanding TODO comment. Replace 0x6404 and 0x660F with named constants defined in rtl8723b_hal.h alongside the existing beacon timing constants.
--- drivers/staging/rtl8723bs/hal/rtl8723b_hal_init.c | 5 ++--- drivers/staging/rtl8723bs/include/rtl8723b_hal.h | 2 ++ 2 files changed, 4 insertions(+), 3 deletions(-)
drivers/staging/rtl8723bs/hal/rtl8723b_hal_init.c +2 -3
@@ -878,8 +878,7 @@ void rtl8723b_InitBeaconParameters(struct adapter *padapter)rtw_write16 (padapter,REG_BCN_CTRL , val16); -/* TODO: Remove these magic number */ -rtw_write16 (padapter,REG_TBTT_PROHIBIT ,0x6404 );/* ms */ +rtw_write16 (padapter,REG_TBTT_PROHIBIT ,TBTT_PROHIBIT_TIME_8723B );/* Firmware will control REG_DRVERLYINT when power saving is enable, */ /* so don't set this register on STA mode. */ if (check_fwstate (&padapter->mlmepriv,WIFI_STATION_STATE ) == false)
@@ -888,7 +887,7 @@ void rtl8723b_InitBeaconParameters(struct adapter *padapter)/* Suggested by designer timchen. Change beacon AIFS to the largest number */ /* because test chip does not contension before sending beacon. by tynli. 2009.11.03 */ -rtw_write16 (padapter,REG_BCNTCFG ,0x660F ); +rtw_write16 (padapter,REG_BCNTCFG ,BCN_AIFS_CFG_8723B ); pHalData->RegBcnCtrlVal =rtw_read8 (padapter,REG_BCN_CTRL ); pHalData->RegTxPause =rtw_read8 (padapter,REG_TXPAUSE );
drivers/staging/rtl8723bs/include/rtl8723b_hal.h +2 -0
@@ -71,6 +71,8 @@ struct rt_firmware_hdr {#define DRIVER_EARLY_INT_TIME_8723B 0x05#define BCN_DMA_ATIME_INT_TIME_8723B 0x02 +#define TBTT_PROHIBIT_TIME_8723B 0x6404 +#define BCN_AIFS_CFG_8723B 0x660F/* for 8723B */ /* TX 32K, RX 16K, Page size 128B for TX, 8B for RX */
Signature · 1 line
2.54.0
Quoted 6 lines · Jad Keskes
Remove the magic numbers in
rtl8723b_InitBeaconParameters()as requested by the outstanding TODO comment. Replace0x6404and0x660Fwith named constants defined inrtl8723b_hal.halongside the existing beacon timing constants.Signed-off-by Jad Keskes <[email protected]>
Just having the same define but as a goto doesn't add any information or value.
This is actually the third attempt to do this. The first two were AI patches. On the first time, I asked how the author came up with the definition and the had the AI generate a halucinated fake spec. On the second patch, the AI found the first fake spec and assumed it was correct. :P
Your patch at least doesn't try to pass off any wrong information so that's good.
I was able to find this explanation from an out of tree driver.
https://gitlab.elettra.eu/intel_socfpga/linux-socfpga/-/blob/socfpga-5.15.60-lts/drivers/net/wireless/realtek/rtw88/rtw8822b.c?ref_type=heads
#define WLAN_TBTT_PROHIBIT 0x04 /* unit : 32us */
#define WLAN_TBTT_HOLD_TIME 0x064 /* unit : 32us */
But it's weird that the comment here says ms. I don't know what is correct. That driver doesn't have any explanation for the 0x660f value.
regards,
dan carpenter
Quoted 10 lines · Dan Carpenter
Quoted 6 lines · Jad Keskes
Remove the magic numbers in
rtl8723b_InitBeaconParameters()as requested by the outstanding TODO comment. Replace0x6404and0x660Fwith named constants defined inrtl8723b_hal.halongside the existing beacon timing constants.Signed-off-by Jad Keskes <[email protected]>Just having the same define but as a goto doesn't add any information or value.
Ugh... Sorry, I meant to say "just having the same value but as a define doesn't add any information."
regards,
dan carpenter
PATCH 1/1 staging: rtl8723bs: replace beacon timing magic numbers with named constants
In reply to Dan CarpenterDecompose the beacon timing magic numbers in rtl8723b_InitBeaconParameters() into named constants with bitfield expressions to document the register layout.
REG_TBTT_PROHIBIT (0x0540): The value 0x6404 splits into hold time (0x64) in the upper byte and prohibit setup time (0x04) in the lower byte, in 32us units — matching the layout used in the rtw88 driver (WLAN_TBTT_HOLD_TIME << 8 | WLAN_TBTT_PROHIBIT).
REG_BCNTCFG (0x0510): The value 0x660F follows the same bitfield layout as the adjacent EDCA AC parameter registers:
AIFS = bits[7:0] = 0x0F (disables contention before beacon Tx); CWmin = bits[11:8] = 0x06; CWmax = bits[15:12] = 0x06.
This layout is confirmed by rtl8192cu which writes 0x66FF (test chips) and 0x660F (normal chips) — only AIFS varies, the CW byte stays 0x66.
Drop the misleading "ms" unit comment on REG_TBTT_PROHIBIT and the outstanding TODO marker since this was the last item it referenced.
--- drivers/staging/rtl8723bs/hal/rtl8723b_hal_init.c | 5 ++--- drivers/staging/rtl8723bs/include/rtl8723b_hal.h | 13 +++++++++++++ 2 files changed, 15 insertions(+), 3 deletions(-)
drivers/staging/rtl8723bs/hal/rtl8723b_hal_init.c +2 -3
@@ -878,8 +878,7 @@ void rtl8723b_InitBeaconParameters(struct adapter *padapter)rtw_write16 (padapter,REG_BCN_CTRL , val16); -/* TODO: Remove these magic number */ -rtw_write16 (padapter,REG_TBTT_PROHIBIT ,0x6404 );/* ms */ +rtw_write16 (padapter,REG_TBTT_PROHIBIT ,TBTT_PROHIBIT_TIME_8723B );/* Firmware will control REG_DRVERLYINT when power saving is enable, */ /* so don't set this register on STA mode. */ if (check_fwstate (&padapter->mlmepriv,WIFI_STATION_STATE ) == false)
@@ -888,7 +887,7 @@ void rtl8723b_InitBeaconParameters(struct adapter *padapter)/* Suggested by designer timchen. Change beacon AIFS to the largest number */ /* because test chip does not contension before sending beacon. by tynli. 2009.11.03 */ -rtw_write16 (padapter,REG_BCNTCFG ,0x660F ); +rtw_write16 (padapter,REG_BCNTCFG ,BCNTCFG_8723B ); pHalData->RegBcnCtrlVal =rtw_read8 (padapter,REG_BCN_CTRL ); pHalData->RegTxPause =rtw_read8 (padapter,REG_TXPAUSE );
drivers/staging/rtl8723bs/include/rtl8723b_hal.h +13 -0
@@ -72,6 +72,19 @@ struct rt_firmware_hdr {#define DRIVER_EARLY_INT_TIME_8723B 0x05#define BCN_DMA_ATIME_INT_TIME_8723B 0x02 +/* REG_TBTT_PROHIBIT (0x0540) - TBTT prohibit hold/setup in 32us units */ +#define TBTT_PROHIBIT_SETUP_8723B 0x04 +#define TBTT_PROHIBIT_HOLD_8723B 0x64 +#define TBTT_PROHIBIT_TIME_8723B \ + ((TBTT_PROHIBIT_HOLD_8723B << 8) | TBTT_PROHIBIT_SETUP_8723B) + +/* REG_BCNTCFG (0x0510) - beacon AIFS, CWmin, CWmax (EDCA-like layout) */ +#define BCN_AIFS_8723B 0x0F +#define BCN_CW_MIN_8723B 0x06 +#define BCN_CW_MAX_8723B 0x06 +#define BCNTCFG_8723B \ + ((BCN_CW_MAX_8723B << 12) | (BCN_CW_MIN_8723B << 8) | BCN_AIFS_8723B) +/* for 8723B */ /* TX 32K, RX 16K, Page size 128B for TX, 8B for RX */ #define PAGE_SIZE_TX_8723B 128
Signature · 1 line
2.54.0
Greg KH
maintainerRe: [PATCH] staging: rtl8723bs: replace beacon timing magic numbers with named constants
Quoted 8 lines · Jad Keskes
Decompose the beacon timing magic numbers in
rtl8723b_InitBeaconParameters()into named constants with bitfield expressions to document the register layout.
REG_TBTT_PROHIBIT(0x0540): The value0x6404splits into hold time (0x64) in the upper byte and prohibit setup time (0x04) in the lower byte, in 32us units — matching the layout used in the rtw88 driver (WLAN_TBTT_HOLD_TIME<< 8 |WLAN_TBTT_PROHIBIT).
Where did this info come from?
Quoted 7 lines
REG_BCNTCFG(0x0510): The value0x660Ffollows the same bitfield layout as the adjacent EDCA AC parameter registers:
AIFS = bits[7:0] =0x0F(disables contention before beacon Tx); CWmin = bits[11:8] =0x06; CWmax = bits[15:12] =0x06.
This layout is confirmed by rtl8192cu which writes0x66FF(test chips) and0x660F(normal chips) — only AIFS varies, the CW byte stays0x66.
Same here, where did you get this information from?
Did you use a LLM for this change?
thanks,
greg k-h
A message that is not in the archive (sent off-list or not yet received): ak5bkRTGALDhBMAL@fedora
A message that is not in the archive (sent off-list or not yet received): 2026070820-unclog-busboy-dad9@gregkh
Re: [PATCH] staging: rtl8723bs: replace beacon timing magic numbers with named constants
Quoted 11 lines · Greg KH
On Wed, Jul 08, 2026 at 03:17:02PM +0100, Jad Keskes wrote:
<snip>
For some reason you sent this only to me, which is a bit rude to everyone else on the mailing list. I'll be glad to respond if you resend it to everyone.
thanks,
greg k-h
Apologies, meant to send that to the list. Resending:
Yeah, that info is from the out-of-tree driver Dan linked in the TODO thread. REG_TBTT_PROHIBIT has the same hold/setup layout as rtw88's WLAN_TBTT_HOLD_TIME / WLAN_TBTT_PROHIBIT.
REG_BCNTCFG — check rtl8192cu in the tree. Same register, same 0x66 CW byte. Production writes 0x660F, test chips write 0x66FF. Only the AIFS changes.
Greg KH
maintainerRe: [PATCH] staging: rtl8723bs: replace beacon timing magic numbers with named constants
Quoted 9 lines · Jad Keskes
Quoted 8 lines · Greg KH
On Wed, Jul 08, 2026 at 03:17:02PM +0100, Jad Keskes wrote:
<snip>
For some reason you sent this only to me, which is a bit rude to everyone else on the mailing list. I'll be glad to respond if you resend it to everyone.
Quoted 7 lines
Quoted 3 lines
thanks,
greg k-h
Apologies, meant to send that to the list. Resending:
Yeah, that info is from the out-of-tree driver Dan linked in the TODO thread.
What thread? Point to it please in the changelog.
Quoted 4 lines
REG_TBTT_PROHIBIThas the same hold/setup layout as rtw88'sWLAN_TBTT_HOLD_TIME/WLAN_TBTT_PROHIBIT.
REG_BCNTCFG— check rtl8192cu in the tree. Same register, same0x66CW byte. Production writes0x660F, test chips write0x66FF. Only the AIFS changes.
Great, document this and where you got the info from in the changelog so that it doesn't look like you just made it up out of the air :)
thanks,
greg k-h