-
Notifications
You must be signed in to change notification settings - Fork 48
Implement dynamic MCS selection based on signal strength in vWIFI driver #80
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Follow the consistent coding style.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It seems that you are adjusting the MCS based on the current signal strength. However, what if a user wants to set the MCS manually using a command like iw dev wlan0 set bitrates ht-mcs-2.4 <mcs_index>?
To support this, you could consider implementing the set_bitrate_mask() callback in your cfg80211_ops and storing the specified MCS in the corresponding vwifi interface structure.
Thanks for you suggestion ,I can try to included the MCS for maunally adjust ! |
79a5101
to
4e81b72
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Can you explain in more detail how your design handles MCS settings? In particular, the MCS formula.
Also, why is the MCS index constrained to 7, 15, 23 and 31? Please clarify the reasoning behind these limits.
vwifi.c
Outdated
@@ -88,6 +88,8 @@ struct vwifi_vif { | |||
struct wireless_dev wdev; | |||
struct net_device *ndev; | |||
struct net_device_stats stats; | |||
int manual_mcs; /* ADDED: Store user-specified MCS */ |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Remove "ADDED:" prefix from the comment
vwifi.c
Outdated
@@ -88,6 +88,8 @@ struct vwifi_vif { | |||
struct wireless_dev wdev; | |||
struct net_device *ndev; | |||
struct net_device_stats stats; | |||
int manual_mcs; /* ADDED: Store user-specified MCS */ | |||
bool manual_mcs_set; /* ADDED: Flag to indicate manual MCS override */ |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Remove "ADDED:" prefix from the comment
vwifi.c
Outdated
@@ -1728,13 +1743,8 @@ static int vwifi_start_ap(struct wiphy *wiphy, | |||
|
|||
/* Initialize hrtimer of beacon */ | |||
pr_info("vwifi: init beacon_timer.\n"); | |||
#if LINUX_VERSION_CODE >= KERNEL_VERSION(6, 15, 0) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Don't modify unrelated code segment!
You should align with the latest version of vwifi.
Nit: It might be better to squash all the “Fix coding style” commits. |
scripts/hostapd.conf
Outdated
@@ -2,7 +2,7 @@ interface=vw0 | |||
driver=nl80211 | |||
debug=1 | |||
ctrl_interface=/var/run/hostapd | |||
ctrl_interface_group=0 | |||
ctrl_interface_group=root |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The changes to the MCS configuration logic and the hostapd.conf control group setting serve different purposes and should be separated into distinct PRs.
The MCS logic affects runtime behavior of the vwifi driver, while the ctrl_interface_group=root
change only impacts permission control for the hostapd socket.
Splitting them would improve clarity, ease future debugging, and allow better tracking of changes.
vwifi.c
Outdated
const char *modulation; | ||
if (vif->manual_mcs_set) { | ||
mcs_index = vif->manual_mcs; | ||
switch (mcs_index) { |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
According to IEEE 802.11n
, MCS indices 7
, 15
, 23
, and 31
all use 64-QAM modulation.
You should revise the descriptions associated with each MCS index accordingly, or consider modifying your design if your intention was to differentiate based on modulation type.
ref:
mcsindex
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Why is there a shell script embedded in the kernel module???
Use command
$ clang-format -i *.[ch]
to maintain a consistent coding style in your implementation!
vwifi.c
Outdated
{ \ | ||
.bitrate = (_rate), \ | ||
.hw_value = (_hw_value), \ | ||
for file in ${SOURCES} |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Why is there a shell script embedded in the kernel module???
Use command
$ clang-format -i *.[ch]
to maintain a consistent coding style in your implementation!
c556347
to
c96febb
Compare
vwifi.c
Outdated
/* Checks vif->manual_mcs_set to use vif->manual_mcs if set; | ||
* Assigns modulation string for manual MCS ; else auto change based |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Nit: Use imperative mood
Edit: solved
vwifi.c
Outdated
@@ -1403,8 +1403,19 @@ static int vwifi_get_station(struct wiphy *wiphy, | |||
sinfo->tx_failed = vif->stats.tx_dropped; | |||
sinfo->tx_bytes = vif->stats.tx_bytes; | |||
sinfo->rx_bytes = vif->stats.rx_bytes; | |||
|
|||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Nit: stray line
vwifi.c
Outdated
sinfo->tx_bytes, sinfo->rx_bytes); | ||
|
||
/* Dynamic modulation based on signal strength */ | ||
/* Checks vif->manual_mcs_set to use vif->manual_mcs if set; |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
s/Checks/Check
Edit: solved
@@ -2276,10 +2353,29 @@ static const struct ieee80211_rate vwifi_supported_rates[] = { | |||
RATE_ENT(120, 0x40), RATE_ENT(180, 0x80), RATE_ENT(240, 0x100), | |||
RATE_ENT(360, 0x200), RATE_ENT(480, 0x400), RATE_ENT(540, 0x800), | |||
}; | |||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I don't think this is necessary.
above picture demonstrate the random signal strength mapping to different MCS .(code from MCS 24-31) |
Further discussion on this implementation can be found in issue82 |
9ae6b0c
to
cd7ad7b
Compare
solved thanks. |
0bd7dfb
to
18db1a8
Compare
I test all of the possible index (MCS 0-31) (short GI /long GI),i will attach of my test log,and below is a part of the log
and the script of testing bench can be sending mail to you, thanks a lot ! contact me :[email protected] |
vwifi.c
Outdated
VWIFI_TXRATE_GI_400NS, /* Short GI, 0.4 µs */ | ||
}; | ||
|
||
static int gi_mode = VWIFI_TXRATE_GI_800NS; |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Avoid this approach. The GI should be updated in the set_bitrate_mask
callback to support user configuration via the iw
command.
vwifi.c
Outdated
@@ -88,6 +98,10 @@ struct vwifi_vif { | |||
struct wireless_dev wdev; | |||
struct net_device *ndev; | |||
struct net_device_stats stats; | |||
int manual_mcs; |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Remove unused variable.
vwifi.c
Outdated
int manual_mcs; | ||
bool manual_mcs_set; | ||
struct cfg80211_bitrate_mask bitrate_mask; | ||
enum vwifi_txrate_gi gi; /* for GI tracking */ |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The GI information can be stored in the cfg80211_bitrate_mask
structure, so there is no need to use an additional variable.
int mcs_index; | ||
const char *modulation; | ||
const char *coding_rate; | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Add a comprehensive description of your dynamic MCS selection algorithm.
@@ -1446,9 +1603,13 @@ static int vwifi_dump_station(struct wiphy *wiphy, | |||
{ | |||
struct vwifi_vif *ap_vif = ndev_get_vwifi_vif(dev); | |||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Explain the modifications to the defensive sanity check in vwifi_dump_station
in git commit message.
d88d1b7
to
92f8f79
Compare
This commit enhances the vWIFI driver by implementing dynamic Modulation and Coding Scheme (MCS) selection in the `vwifi_get_station` function, adjusting the MCS index based on signal strength. After implement dynamic MCS can avoid TX power waste for a bad channel quality.
Implement the set_bitrate_mask callback in cfg80211_ops to support manual MCS settings using `iw dev <interface> set bitrates ht-mcs-2.4 <mcs_index>`, addressing reviewer feedback. Store the selected MCS in vwifi_vif->manual_mcs and track its state with vwifi_vif->manual_mcs_set. Support MCS indices 7, 15, 23, and 31, with validation and logging. Tested with `iw dev vw1 set bitrates ht-mcs-2.4 15`, achieving MCS 15 at 130.0 MBit/s (bitrate calculation pending refinement to ~52 MBit/s). Test commands format $sudo ip netns exec ns1 iw dev vw1 link $sudo ip netns exec ns1 iw dev vw1 set bitrates ht-mcs-2.4 15 /*(changable 7,15,23,31)*/ $sudo ip netns exec ns1 iw dev vw1 link
92f8f79
to
c142feb
Compare
Below is the test of all possible index (MCS 0-31) (sgi,lgi),giving a part of it at below:
the test can be reproduce based on my providing test script <test_vwifi_bitrates.sh>. |
Please reformat the structure of the following commit
|
Also, I realized a serious issue that in auto selection MCS, for the guard intervals (GI), which have multiple functions, such as prefix, that eliminate ICI and ISI in OFDM based system, now we only have signal strength, this should also consider many other physical parameters, such as delay spread for estimating the GI .The above issue also indicates that manual set guard intervals is a little bit weird in modern wireless system. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Extend the existing scripts/verify.sh
as an integrated test.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Use git rebase -i
to rework git commits.
c142feb
to
fa402a1
Compare
Integrated and conduct result in same behavior of <test_vwifi_bitrates.sh>. |
As we mention in meeting can i break this branch into multiple ? |
fa402a1
to
591910d
Compare
Update the vwifi_set_bitrate_mask callback to support the full range of MCS indices 24 through 31, aligning with the 4-spatial-stream configuration in nf_band_2ghz. This change enabling support for manual MCS from 24-31 coding schemes (1/2, 3/4, 2/3, 5/6) and modulations (BPSK, QPSK,16-QAM, 64-QAM) as defined by the IEEE 802.11n specification. The callback now rejects indices outside 24–31, ensuring compliance with 4-stream capabilities and allowing comprehensive rate testing (26–260 Mbps). The auto MCS selection, due to this function is based on only signal strength, while the MCS should construct with modulation and coding scheme, which the coding scheme is related with BER (bite error rate), previous vWiFI only implement random signal strength, meaning that bit error rate should also based on the channel state info.
- Adjust MCS indices 24 to 31 to match spec table's modulation (BPSK to 64-QAM) and coding rates (1/2 to 5/6). - Revise signal strength thresholds (-45 to -75 dBm) to reflect realistic SNR requirements for each modulation scheme. - Preserve random signal generation logic using rand_int_smooth. - Ensure consistency with the reference table's structure and parameters.
…CS 0-31 This commit enhances the vwifi driver and test script to fully support HT mode with MCS 0-31, dynamic guard interval (GI) selection (0.8 µs and 0.4 µs), and robust testing. Key changes: - Adde `gi_mode` module parameter to vwifi.c to enable dynamic switching between long GI (0.8 µs) and short GI (0.4 µs), replacing hardcoded `vif->gi = VWIFI_TXRATE_GI_800NS` in `vwifi_set_bitrate_mask`. - Update `vwifi_set_bitrate_mask` to use `gi_mode` and added logging for GI and MCS settings. - Enhance `vwifi_get_station` to report GI correctly in `sinfo->txrate` and `sinfo->rxrate` with `RATE_INFO_FLAGS_SHORT_GI`. - Update `test_vwifi_bitrates.sh` to: - Test MCS 0-31 with both long and short GI on `vw1` and `vw2`. - Validate bitrates against `ht_mcs_table` (`rate_800ns`, `rate_400ns`). - Add error handling for `gi_mode` writes and connection checks. - Include debug output for `wpa_supplicant` and `iw dev link`. - Suggested debugfs fallback for per-interface GI control if `gi_mode` fails. These changes ensure compliance with reviewer requirements for HT mode, MCS 0-31, GI selection, and dynamic MCS selection, with robust testing and validation.
…egrate test script This commit refactors the vwifi driver to store Guard Interval (GI) information solely in cfg80211_bitrate_mask, eliminating the redundant short_gi variable, and introduces a spatial stream index for future optimization. It also adds a comprehensive comment block for manual_mcs and updates the test script to validate all MCS indices (0–31) with sgi-2.4 and lgi-2.4. changes: - vwifi_vif: - Remove short_gi, storing GI in vif->bitrate_mask.control[NL80211_BAND_2GHZ].gi. - Add spatial_streams field (int, default 1) for future multi-stream support. - Add manual_mcs field with detailed comment block explaining its role in storing the first enabled MCS for consistent bitrate reporting. - vwifi_set_bitrate_mask: - Store GI in vif->bitrate_mask.control[NL80211_BAND_2GHZ].gi, removing short_gi usage. - vwifi_get_station: - GI logic using vif->bitrate_mask.gi for short (0.4µs), long (0.8µs), or default GI. - Correct pr_info format string for modulation and coding_rate alignment. - Configure sinfo->rxrate/txrate with vif->bitrate_mask.gi and vif->manual_mcs. Test script (test_vwifi_bitrates.sh): -Updated to test MCS 0–31 with sgi-2.4 and lgi-2.4: - Test header (Testing MCS <mcs> with <gi> on vw1). - GI status (Set GI to long/short). - iw dev vw1 link output (MAC, SSID, freq, RX/TX, signal, bitrates). - Success/failure message with actual vs. expected bitrate. - Add expected bitrate arrays for lgi-2.4 and sgi-2.4. - Enhance stability with 2s retry sleep, 1s sleep after iw set bitrates, and 2s setup delay. - Ensure cleanup resets bitrate. - correct history typo. Testing: - Verified GI (0.4µs/0.8µs) and MCS (0–31) with iw dev vw1 set bitrates and iw dev vw1 link.
591910d
to
c800205
Compare
solved ! thanks. |
This commit enhances the vWIFI driver by implementing dynamic Modulation and Coding Scheme (MCS) selection in the
vwifi_get_station
function, adjusting the MCS index based on signal strengthAfter implement dynamic MCS can avoid TX power waste for a bad channel quality