LinuxWireless
|
Size: 7662
Comment: 1) Changed bullet styles to manual as hard to follow. 2) Grammar fix. 3) Misc. presentation fixes. 4) RM'ed Hardy as EOL.
|
← Revision 49 as of 2018-02-17 16:20:26 ⇥
Size: 7674
Comment: 1) RM'd Ubuntu compat-wireless as it's gone. 2) Misc. tweaks.
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 4: | Line 4: |
| = General Info = | = Introduction = |
| Line 6: | Line 6: |
| Escalating bugs and issues to the upstream developers is important to improving the overall quality of wireless drivers. Before we get started we will review first a few general details about the life cycle of Ubuntu's kernel releases so you are more comfortable with how things get into Ubuntu and what you are using. | This page is about debugging 802.11 a/b/g/n/ac WiFi issues. Gathering debugging information is vital for developers to fix wireless driver bugs. This process helps improve the overall quality of wireless drivers. |
| Line 8: | Line 8: |
| = Debugging information to provide in your bug report = | = Debugging information to provide in your report = |
| Line 10: | Line 10: |
| When providing information for a bug to be worked on by a developer, please mention the following information: | First, please note "I don't know", "I haven't tested this", "I'll test later", "I'm assuming that...", etc. are not acceptable answers to any of the below. If you don't understand the question, or have to assume something, please advise to what you don't understand or are assuming specifically in your report, and it will be clarified. Otherwise, making such a response will further delay your issue being addressed. Also, please post in your report both the question and answer, as the presentation of the information here can change: |
| Line 12: | Line 14: |
| 2. If you update your BIOS to the newest version, does this change anything? 3. Regarding your wireless Access Point (AP): 3a. What is the AP manufacturer, model, and firmware version? 3i. If you update the AP to latest firmware does it change anything? 3b. What wireless connection type are you using (e.g. 802.11n, 802.11g, etc.)? 4. If you adjust any the following does it change anything: 4a. WiFi type (ex. 802.11n to 802.11g only) 4b. Encryption Type (ex. WEP, WPA2-PSK TKIP+AES) 4c. MAC Filtering 4d. QoS (Quality of Service)/WMM (Wi-Fi Multimedia) 4e. Beacon Interval (usually default is 100, adjusting to 50 would be fine) 4f. Router Internal Firewall 4g. WiFi Channel (changing from default 11 to non-default that has no/least number of APs on it) 5. Does another wireless device tested with the AP have the same problem as the hardware you initially reported with? 6. What is the distance of the wireless device from AP? 7. What is the number and type of obstructions between your device and the AP? 7a. If you bring the device close to the AP and eliminate obstructions, does this change anything? 8. Does the issue occur with different APs? 9. Is it a regression (e.g. did the problem happen in a prior Ubuntu release)? 9a. If so, what release specifically did it last work with? 9b. If you do not know, could you please test for this in the earliest release of Ubuntu that is supported as per [[https://wiki.ubuntu.com/Releases|Ubuntu Releases]]? 10. Does this problem occur in the newest mainline kernel following [[https://wiki.ubuntu.com/Kernel/MainlineBuilds]]? Please mention what specific version of the mainline kernel you tested with in your report. 10a. If the mainline works, does either the [[http://cdimage.ubuntu.com/daily-live/current/|development release]] or the Ubuntu provided stable compat-wireless backport work following [[https://wiki.ubuntu.com/Kernel/LinuxWireless#Compat-wireless_in_Ubuntu]]? Please mention in your report the specific version you tested. 10b. If the mainline does not work, could you please test upstream's compat-wireless backport via [[https://wiki.ubuntu.com/Kernel/LinuxWireless#Compat-wireless_from_upstream]]? Please mention in your report the specific version you tested. 11. Does ndiswrapper work following [[https://help.ubuntu.com/community/WifiDocs/Driver/Ndiswrapper]]? Please mention what specific version of ndiswrapper you tested with, and a link to the Windows driver you used in your report. 11a. If ndiswrapper does not work, you are welcome to file a new bug report by executing at a terminal: {{{ ubuntu-bug ndiswrapper-utils-1.9 }}} 12. Only for '''Broadcom''' wireless chipsets, does the Broadcom STA driver work following [[https://help.ubuntu.com/community/WifiDocs/Driver/bcm43xx]]? Please mention what specific version of Broadcom STA you tested with in your report. 13. Only for '''Realtek''' wireless chipsets, does the upstream Realtek drivers downloaded from [[http://www.realtek.com.tw]] work? Please mention what specific version of the drivers you tested with in your report. |
2. If you update your BIOS to the newest version following the guide [[https://help.ubuntu.com/community/BIOSUpdate|here]], does this change anything? 3. Regarding your wireless Access Point (WAP): 3a. What is the current WAP manufacturer, full model, revision, and firmware version? <<BR>> 3b. If you update the WAP to the latest firmware does it change anything? <<BR>> 3c. What wireless connection type are you using (802.11ac, 802.11n 150/300, 802.11g, etc.)? <<BR>> 3d. If you switch to a different wireless type (802.11g or 802.11n if you are using 802.11g) does this change anything? <<BR>> 3e. What channel specifically are you using when this problem is reproducible? <<BR>> 3f. In order to understand the wireless environment your WAP is working in, please provide the output of the following terminal command: {{{ sudo iw dev wlan0 scan | grep -i "ds parameter set" }}} 3g. What encryption type are you using (ex. WEP, WPA2-PSK, etc.)? <<BR>> 3h. If you change and remove encryption entirely does this change anything? <<BR>> 3i. Do you have QoS (Quality of Service)/WMM (Wi-Fi Multimedia) enabled? <<BR>> 3j. If you disable/enable QoS/WMM does it change anything? <<BR>> 3k. What is the current beacon interval (usually default is 100)? <<BR>> 3l. If you adjust this to 50 does it change anything? <<BR>> 3m. Does your WAP have a firewall enabled? <<BR>> 3n. If you enable/disable the firewall does it change anything? <<BR>> 3o. What frequency are you using (2.4GHz, 5GHz, etc.)? <<BR>> 3p. If you change frequency does it change anything? 4. Does another wireless device tested with the WAP have the same problem as the hardware you initially reported with? 5. What is the distance of the wireless device from the WAP? 6. What is the number and type of obstructions between your device and the WAP? 6a. If you bring the device close to the WAP and eliminate obstructions, does this change anything? 7. Does the issue occur with different WAPs? 8. Is it a regression (i.e. did the problem happen in a prior Ubuntu release)? If so, what release specifically did it last work with? If you do not know, could you please test for this in the earliest release of Ubuntu that is supported as per [[https://wiki.ubuntu.com/Releases|Ubuntu Releases]]? 9. Does this problem occur in the newest mainline kernel following [[https://wiki.ubuntu.com/Kernel/MainlineBuilds]]? Please mention what specific version of the mainline kernel you tested with in your report. 10. After testing the latest mainline kernel: 10a. If the mainline kernel works, does the [[http://cdimage.ubuntu.com/daily-live/current/|development release]] work? Please mention in your report the specific version you tested. |
| Line 42: | Line 44: |
| = Ubuntu's kernels = | 10b. If the mainline kernel doesn't work, could you please test compat-wireless from upstream via [[https://wiki.ubuntu.com/Kernel/LinuxWireless#Compat-wireless_from_upstream|here]] and advise to the results? 11. Only for '''Broadcom''' wireless chipsets, does the Broadcom STA driver work following [[https://help.ubuntu.com/community/WifiDocs/Driver/bcm43xx]]? Please mention what specific version of Broadcom STA you tested with in your report. 12. Only for '''Realtek''' wireless chipsets: 12a. Does disabling the firmware power management change anything? This may be done via a terminal: {{{ sudo nano /etc/modprobe.d/DRIVER.conf }}}{{{ options DRIVER ips=0 fwlps=0 }}} where DRIVER is the kernel driver in use for your card found by executing at a terminal: {{{ lspci -v }}} 12b. Does the upstream proprietary Realtek driver downloaded from [[http://www.realtek.com.tw]] work? Please mention what specific version of the drivers you tested with in your report. If it doesn't work, please contact the card vendor, for example ASUS (not Realtek), file a case number requesting the driver be fixed, and post the case number to your report. 13. Only for '''Intel''' wireless chipsets: 13a. '''Please advise to which firmware version the device is using.''' Stating the linux-firmware version (ex. apt-cache policy linux-firmware), while necessary, is not the firmware version in use, but the package version of linux-firwmare. In order to find the version in use, one may check dmesg. For example, if the chipset was using the iwlwifi driver:{{{ cat /var/log/dmesg | grep "firmware version" [ 2.820714] iwlwifi 0000:03:00.0: loaded firmware version 25.222.9.0 op_mode iwlmvm }}} For more on this, please see [[https://wiki.ubuntu.com/Kernel/Firmware|here]]. <<BR>> 13b. Did this work on a prior [[https://launchpad.net/ubuntu/+source/linux-firmware|linux-firmware]] version? If you don't know, please test a prior release and advise to which version of the firmware, and kernel you tested specifically. <<BR>> 13c. Does this work, or have a measurable positive impact using the latest firmware available from [[https://downloadcenter.intel.com/Detail_Desc.aspx?DwnldID=17045|Intel]]? If you don't know, please test this with the latest mainline kernel, and firmware available for your chipset. 14. Does ndiswrapper work following [[https://help.ubuntu.com/community/WifiDocs/Driver/Ndiswrapper]]? Please mention what specific version of ndiswrapper you tested with, and a link to the Windows driver you used in your report. <!> If ndiswrapper does not work, you are welcome to file a new bug report by executing at a terminal: {{{ ubuntu-bug ndiswrapper-utils-1.9 }}} |
| Line 44: | Line 66: |
| During the Ubuntu development cycle, which happens every 6 months, the Ubuntu kernel will be picked from the latest stable kernel release available. At Ubuntu's Intrepid release cycle, for example, this was the 2.6.27 kernel, for Jaunty this was the 2.6.28 kernel, and for Karmic 2.6.31. | = Compat-wireless from upstream = |
| Line 46: | Line 68: |
| = The Linux wireless guide on reporting bugs = Please be sure to read this guide in its entirety: http://wireless.kernel.org/en/users/Documentation/Reporting_bugs |
Upstream has a more bleeding-edge tree called linux-next, that uses the stable tree as it's base. One would want to test this, as it contains the latest features and fixes, and is a staging area for code that may be merged into Linus's tree. Testing this gives developers vital information on what may fix your issue. For more on this, please see [[https://www.kernel.org/doc/man-pages/linux-next.html|here]]. |
| Line 55: | Line 74: |
| = Ubuntu kernel release to stable kernel map = | = The Linux wireless guide on reporting bugs = |
| Line 57: | Line 76: |
| Unfortunately Ubuntu's kernels do not tell you what the extra version is (ex. for Intrepid the .10 in 2.6.27.10) and this is required to report bugs upstream. Because of this you can look at the [[http://kernel.ubuntu.com/~kernel-ppa/info/kernel-version-map.html|Ubuntu kernel version --> detailed mainline kernel version map]] to find out what exact upstream mainline kernel your kernel is based on. For example if you get: {{{ cat /proc/version_signature Ubuntu 2.6.27-10.20-generic }}} You can then look at the map as to what exactly this maps to. In this case this would map to the 2.6.27.7 kernel. It should be noted that the /proc/version_signature is an Ubuntu specific feature to help you get the detailed kernel version. = Compat-wireless from Ubuntu repositories = The compat-wireless packages in Ubuntu are generated with select wireless commits from linus' stable tree. This provides one with the benefit of improved wireless functionality in a stable Ubuntu release, without adding any other, potentially unnecessary code. The following is a list of compat-wireless packages available from the Ubuntu repositories: Quantal - [[https://launchpad.net/ubuntu/+source/linux-backports-modules-3.5.0]] <<BR>><<BR>> Precise - [[https://launchpad.net/ubuntu/+source/linux-backports-modules-3.0.0]] <<BR>><<BR>> Lucid - [[https://launchpad.net/ubuntu/+source/linux-backports-modules-2.6.32]] == Installing compat-wireless == For [[https://launchpad.net/ubuntu/+source/linux-backports-modules-3.2.0|Precise]], this may be done by executing the following at a terminal: {{{ sudo apt-get -y install linux-backports-modules-cw-3.3-3.2.0.23-generic-pae }}} and then reboot. You will probably get newer versions of this package if you enable the proposed repository as explained above. While compat-wireless in Ubuntu is updated regularly, it may not be every day. If you want to ensure you are running the cutting edge, one would want to use compat-wireless from upstream. == Removing compat-wireless == Please keep in mind that linux-backports-modules install modules in /lib/modules/$(uname -r)/updates/ and upon removal the modules are not removed. So be sure to rm -rf that updates directory (and only the updates directory!). = Compat-wireless from upstream = Upstream packages a compat-wireless backport based on the [[http://linux.f-seidel.de/linux-next/pmwiki/pmwiki.php?n=Linux-next.FAQ|linux-next]] tree. This may be found at [[https://backports.wiki.kernel.org/index.php/Releases]]. The linux-next tree contains new features and fixes, and is a staging area for testing code that may be merged into linus' tree. Testing this gives developers vital information on what may fix your issue. |
For debugging information preferred by upstream please see: [[http://wireless.kernel.org/en/users/Documentation/Reporting_bugs]] |
Introduction
This page is about debugging 802.11 a/b/g/n/ac WiFi issues. Gathering debugging information is vital for developers to fix wireless driver bugs. This process helps improve the overall quality of wireless drivers.
Debugging information to provide in your report
First, please note "I don't know", "I haven't tested this", "I'll test later", "I'm assuming that...", etc. are not acceptable answers to any of the below. If you don't understand the question, or have to assume something, please advise to what you don't understand or are assuming specifically in your report, and it will be clarified. Otherwise, making such a response will further delay your issue being addressed.
Also, please post in your report both the question and answer, as the presentation of the information here can change:
- What is the full computer model number (ex. HP G32-301TX Notebook PC)?
If you update your BIOS to the newest version following the guide here, does this change anything?
- Regarding your wireless Access Point (WAP):
3a. What is the current WAP manufacturer, full model, revision, and firmware version?
3b. If you update the WAP to the latest firmware does it change anything?
3c. What wireless connection type are you using (802.11ac, 802.11n 150/300, 802.11g, etc.)?
3d. If you switch to a different wireless type (802.11g or 802.11n if you are using 802.11g) does this change anything?
3e. What channel specifically are you using when this problem is reproducible?
3f. In order to understand the wireless environment your WAP is working in, please provide the output of the following terminal command:sudo iw dev wlan0 scan | grep -i "ds parameter set"
3g. What encryption type are you using (ex. WEP, WPA2-PSK, etc.)?
3h. If you change and remove encryption entirely does this change anything?
3i. Do you have QoS (Quality of Service)/WMM (Wi-Fi Multimedia) enabled?
3j. If you disable/enable QoS/WMM does it change anything?
3k. What is the current beacon interval (usually default is 100)?
3l. If you adjust this to 50 does it change anything?
3m. Does your WAP have a firewall enabled?
3n. If you enable/disable the firewall does it change anything?
3o. What frequency are you using (2.4GHz, 5GHz, etc.)?
3p. If you change frequency does it change anything?
- Does another wireless device tested with the WAP have the same problem as the hardware you initially reported with?
- What is the distance of the wireless device from the WAP?
- What is the number and type of obstructions between your device and the WAP?
- 6a. If you bring the device close to the WAP and eliminate obstructions, does this change anything?
- Does the issue occur with different WAPs?
Is it a regression (i.e. did the problem happen in a prior Ubuntu release)? If so, what release specifically did it last work with? If you do not know, could you please test for this in the earliest release of Ubuntu that is supported as per Ubuntu Releases?
Does this problem occur in the newest mainline kernel following https://wiki.ubuntu.com/Kernel/MainlineBuilds? Please mention what specific version of the mainline kernel you tested with in your report.
- After testing the latest mainline kernel:
10a. If the mainline kernel works, does the development release work? Please mention in your report the specific version you tested.
10b. If the mainline kernel doesn't work, could you please test compat-wireless from upstream via here and advise to the results?
Only for Broadcom wireless chipsets, does the Broadcom STA driver work following https://help.ubuntu.com/community/WifiDocs/Driver/bcm43xx? Please mention what specific version of Broadcom STA you tested with in your report.
Only for Realtek wireless chipsets:
12a. Does disabling the firmware power management change anything? This may be done via a terminal:
sudo nano /etc/modprobe.d/DRIVER.conf
options DRIVER ips=0 fwlps=0
where DRIVER is the kernel driver in use for your card found by executing at a terminal:
lspci -v
12b. Does the upstream proprietary Realtek driver downloaded from http://www.realtek.com.tw work? Please mention what specific version of the drivers you tested with in your report. If it doesn't work, please contact the card vendor, for example ASUS (not Realtek), file a case number requesting the driver be fixed, and post the case number to your report.
Only for Intel wireless chipsets:
13a. Please advise to which firmware version the device is using. Stating the linux-firmware version (ex. apt-cache policy linux-firmware), while necessary, is not the firmware version in use, but the package version of linux-firwmare. In order to find the version in use, one may check dmesg. For example, if the chipset was using the iwlwifi driver:
cat /var/log/dmesg | grep "firmware version" [ 2.820714] iwlwifi 0000:03:00.0: loaded firmware version 25.222.9.0 op_mode iwlmvm
For more on this, please see here.
13b. Did this work on a prior linux-firmware version? If you don't know, please test a prior release and advise to which version of the firmware, and kernel you tested specifically.
13c. Does this work, or have a measurable positive impact using the latest firmware available from Intel? If you don't know, please test this with the latest mainline kernel, and firmware available for your chipset.
Does ndiswrapper work following https://help.ubuntu.com/community/WifiDocs/Driver/Ndiswrapper? Please mention what specific version of ndiswrapper you tested with, and a link to the Windows driver you used in your report.
If ndiswrapper does not work, you are welcome to file a new bug report by executing at a terminal: ubuntu-bug ndiswrapper-utils-1.9
Compat-wireless from upstream
Upstream has a more bleeding-edge tree called linux-next, that uses the stable tree as it's base. One would want to test this, as it contains the latest features and fixes, and is a staging area for code that may be merged into Linus's tree. Testing this gives developers vital information on what may fix your issue. For more on this, please see here.
The Ubuntu proposed repository
Keep in mind Ubuntu has a "proposed" repository which allows you to get newer stable kernels (if you are using 2.6.27.10 the proposed repository may have a 2.6.27.14 kernel). Instructions on enabling this repository may be found here. The kernels are propagated over time from the proposed repository to updates over a few weeks period of time after general testing and acceptance.
The Linux wireless guide on reporting bugs
For debugging information preferred by upstream please see: http://wireless.kernel.org/en/users/Documentation/Reporting_bugs
Kernel/LinuxWireless (last edited 2018-02-17 16:20:26 by penalvch)