Wifidocswirelesstroubleshootingguide: 1. Before Using This Guide
Wifidocswirelesstroubleshootingguide: 1. Before Using This Guide
Wifidocswirelesstroubleshootingguide: 1. Before Using This Guide
WifiDocsWirelessTroubleShootingGuide
Style Cleanup Required: This article does not follow the style standards in
the Wiki Guide. More info...
Contents
2. Purpose
This guide can serve as a checklist for troubleshooting your wireless network
connections. While it may not solve all your problems, it can hopefully steer you in
the right direction.
https://help.ubuntu.com/community/WifiDocs/WirelessTroubleShootingGuide?action... 20.Nov.09
WifiDocs/WirelessTroubleShootingGuide - Community Ubuntu Documentation Page 2 of 22
3. Overview
3.1. Steps
z The basic structure
{ Check for Device Recognition
z This structure is setup in a specific order. Do not move on until you get
everything resolved in the current step. For example, step 3 is router
association. You can not move on to the next step of ip assignment until you
get router association. If you can't get past a step, look for more help in that
specific area. Once it's resolved, move onto the next step.
3.4. Commands
z Reading through the commands section is not necessary for this guide, but
could prove useful.
z The first section contains the commands associated with troubleshooting
wireless. Details about the command and some basics of what it does will be
given. When going through the steps, anywhere a command is given it will
link to the command section.
z With each command will be an example with key points noted.
z For more information on each command check the manual.
{ man <command>
z Where a word appears inside <>. you need to input a value to complete the
command. Do not include the <> symbols in your command.
{ eg Where you see <ath0> you need to replace this with your device's
https://help.ubuntu.com/community/WifiDocs/WirelessTroubleShootingGuide?action... 20.Nov.09
WifiDocs/WirelessTroubleShootingGuide - Community Ubuntu Documentation Page 3 of 22
sudo iwconfig
4. Troubleshooting Steps
4.1. Check Device
Commands we'll be using in this section: lshw lspci lsusb
4.1.1. PnP
plug and Play is a term used in the computer field to describe a computer's
ability to have new device, normally peripherals, added without having to
reconfigure or restart the computer. It is not a term stating the device will work as
described immediately. A driver has to be installed so the os can communicate
with the device
Run the following command. Hopefully you'll get some output about the
device.
Socket 0:
product info: "Atheros Communications, Inc.", "AR5001-
0000-0000", "Wireless LAN Reference Card", "00"
manfid: 0x0271, 0x0012
https://help.ubuntu.com/community/WifiDocs/WirelessTroubleShootingGuide?action... 20.Nov.09
WifiDocs/WirelessTroubleShootingGuide - Community Ubuntu Documentation Page 4 of 22
function: 6 (network)
If you get no output then the memory on the card cannot be read. Now
we need to open a configuration file and add this information to it:
the information you add should look like this, with your own data
substituted.
Now run lshw to see if the card is recognized and loaded properly.
Most cards requiring this step will be older devices. You should not have to do
this with any cards made in the past few years, but there can be exceptions.
Notice the bind line which states what driver should be allocated to the device.
You will need to find what driver your device uses. More on that in the next step.
On several, especially new systems the Yenta bridge is not on the root PCI
bridge, but behind a PCI-to-PCI bridge. On some x86 or x86_64 systems,
these bridges aren't corrreclty set up by the BIOS, which may cause CardBus
and even PCMCIA devices not to show up in lspci or in pccardctl ident
correctly. If you suspect that this may be the cause, issue this command:
https://help.ubuntu.com/community/WifiDocs/WirelessTroubleShootingGuide?action... 20.Nov.09
WifiDocs/WirelessTroubleShootingGuide - Community Ubuntu Documentation Page 5 of 22
latency=64
Bus: primary=02, secondary=03, subordinate=06, sec-
latency=176
Bus: primary=02, secondary=07, subordinate=0a, sec-
latency=176
pci=assign-busses
When a card is first inserted, the system attempts to read the card's memory.
This can sometimes cause your system to lock-up. Try this to see if it helps:
https://help.ubuntu.com/community/WifiDocs/WirelessTroubleShootingGuide?action... 20.Nov.09
WifiDocs/WirelessTroubleShootingGuide - Community Ubuntu Documentation Page 6 of 22
First you should check if a driver automatically loaded. (Your device may be
supported in Ubuntu with a native driver.) Use the lshw command. As explained
under lshw, if there is a line saying "configuration: ...driver=..." in the description
of the wireless card, this indicates the driver is OK
Devices using the ralink chipset are listed with the rt2x00 driver. the
rt2x00 driver only works for kernels 2.6.13 or greater. For a kernel older then this
you need to use rt2500 for pci devices or rt2570 for usb devices
Not all cards/devices have a linux driver. If you find your card is not supported
you will have to look at an app called ndiswrapper.
blacklist modulename
For example, if you own a D-Link DWL-G520+ card which uses the ACX111
chipset, and you plan to use the ndiswrapper module, you have to blacklist the acx
module, by creating the file /etc/modprobe.d/blacklist-acx with a single line inside
which states :
blacklist acx
https://help.ubuntu.com/community/WifiDocs/WirelessTroubleShootingGuide?action... 20.Nov.09
WifiDocs/WirelessTroubleShootingGuide - Community Ubuntu Documentation Page 7 of 22
If you ran lshw and saw a driver bound to the device then let's test to make
sure it's communicating to the kernel.
1. run the command lsmod to see if driver is loaded. (look for the driver
name that was listed in the output of lshw, "configuration" line). If you
did not see the driver module in the list then use the modprobe
command to load it.
2. run the command iwconfig. If you see output like in the example in
the command section then the driver is at least identifying the device
as a wireless device to the kernel.
a. Opening networking in system>administration> and seeing the
device in the list is how to identify through gui if driver is at
least communicating to the kernel at a basic level.
3. run the command iwlist to scan for a router. If an access point is
identified this is a second identifier which shows the driver as
communicating and shows that it's probably working as it can
complete a wireless interface task. (note not all cards support scanning
so this may not work for you)
blacklist <drivername>
blacklist <drivername>_cs
Newer laptops come with features to disable the wireless radio to save
battery when not in use. Usually this is switched by a FN+Fx key combo or
specific button for the purpose. It is possible driver and everything is ok but
the wireless device is in the disabled state and can't be used. Using the
designated key(s) in linux sometimes does not work.
Usually this is apparent by running the lshw command you see *-
network:1 DISABLED or wireless=radio off, or if you run the
iwconfig command you see eth1 NOT READY!. So how do you
https://help.ubuntu.com/community/WifiDocs/WirelessTroubleShootingGuide?action... 20.Nov.09
WifiDocs/WirelessTroubleShootingGuide - Community Ubuntu Documentation Page 8 of 22
rectify this? It varies so much the exact solution can't be put here in this
document for all the different models. So...
z Look at the LaptopTestingTeam page on the team wiki to see if your laptop
is listed with any information.
z Do a google search using terms such as manufacture, model, linux, wireless,
enable, button, radio....etc. When searching and finding similar pages that
don't help, use words that are used in those pages to help you search.
z Go to the ubuntu forums and ask, maybe someone else has the same laptop
and knows the work around.
note: not all these may be used, check the man page for more informatin
https://help.ubuntu.com/community/WifiDocs/WirelessTroubleShootingGuide?action... 20.Nov.09
WifiDocs/WirelessTroubleShootingGuide - Community Ubuntu Documentation Page 9 of 22
There have been a few posts where no association is established with router
even on an open signal. At the point of writing this line, no answer has been seen
to why this happens. A router reboot has been noted once to resolve but in other
situations has caused heartache as network settings need to be set up again.
Booting with acpi=off or noapci should be tried.
4.4. ip assignment
Now that you have association to the router did you get an ip assigned to the
device? This can be checked two ways.
1. Run the command ifconfig and look for an assigned ip.
https://help.ubuntu.com/community/WifiDocs/WirelessTroubleShootingGuide?action... 20.Nov.09
WifiDocs/WirelessTroubleShootingGuide - Community Ubuntu Documentation Page 10 of 22
2. You can always try to ping the router with the routers ip. A lot of
home routers use something similar to 192.168.0.1 You'll have to find
what that ip address is to ping.
If you do not have an ip then here are things to try
{ Using DHCP
or
You may want to try and reboot making sure your networking interfaces
file is set up properly.
If you can connect to the router, but can't get an ip, it may be because you put the
wrong WEP key in.
z Now try to ping your router and a website. If you're connected now and have
an ip assigned but can not surf website then move on to next section.
z You will need to make sure your interfaces file is set up properly so you get
internet again when you reboot
4.5.1. DNS
If you don't know what DNS means or what it does you can go here to read
https://help.ubuntu.com/community/WifiDocs/WirelessTroubleShootingGuide?action... 20.Nov.09
WifiDocs/WirelessTroubleShootingGuide - Community Ubuntu Documentation Page 11 of 22
cat /etc/resolv.conf
search telus.net
nameserver 209.53.4.130
nameserver 209.53.4.150
{You can find your dns settings if you have a working windows
machine
For a Win 95/98 box click start>run then type winipcfg.
Choose the correct adapter and then more. In the sample above,
replace telus.net with what's in the "Host Name" box. name
server will equal what's in the dns server box.
For a Win 2000/xp box click Start>Run...type cmd click ok.
type ipconfig /all. In the sample above, replace telus.net
with what's next to the field Connection-Specific DNS suffix.
For name server look next to the line DNS servers.
{ Your DNS server settings can also be found out by calling your isp
provider and asking them.
You can set up your dns settings so they don't change.
{ StaticDnsWithDhcp:StaticDnsWithDhcp
4.5.2. IPV6
The internet standard is currently considered ipv4. The new standard, ipv6,
is slowly being implemented to replace ipv4. Because it's not widely used at
the moment, ipv6 can cause problems. It is enabled by default in Ubuntu.
This can cause no internet if above seems ok.
{ Firefox specific
https://help.ubuntu.com/community/WifiDocs/WirelessTroubleShootingGuide?action... 20.Nov.09
WifiDocs/WirelessTroubleShootingGuide - Community Ubuntu Documentation Page 12 of 22
5. Config Files
z The following is a list of important config files used with wireless
{ /etc/network/interfaces
This is where your inteface settings for the network are kept sample
1. man interfaces has information about this file.
2. For a little more detailed info on the interfaces file look at the
file in /usr/share/doc/ifupdown/examples/network-interfaces.gz.
You can read through it with the cat command and then adding |
less to the end of the command.
3. For pcmcia users who want to start your card at boot do not use
an auto stanza. add map <ath0> to the file. So here is an
example of what it would look like.
z Check your routers settings to ensure it can accept another connection.
1. Check your /etc/network/intefaces file. You should have something
similar to this:
https://help.ubuntu.com/community/WifiDocs/WirelessTroubleShootingGuide?action... 20.Nov.09
WifiDocs/WirelessTroubleShootingGuide - Community Ubuntu Documentation Page 13 of 22
# map eth0
auto <ath0>
{ /etc/resolv.conf
Where your DNS server settings are kept
{ /etc/modules
If a driver won't load at boot, you can add it to this list so it does
{ /etc/modprobe.d/blacklist
If you don't want a driver to load at boot you add it to this list. Usually
this is used if you have a driver conflict and you want to make sure a
specific driver is used. Note: this method will not work unless it is a
LKM (loadable kernel module) If driver/mod was compiled into the
base kernel, it will still load if on blacklist.
https://help.ubuntu.com/community/WifiDocs/WirelessTroubleShootingGuide?action... 20.Nov.09
WifiDocs/WirelessTroubleShootingGuide - Community Ubuntu Documentation Page 14 of 22
so often as they scan the interfaces, causing the connection to drop. You can
try uninstalling these apps to see if your problem goes away, but doing so
will remove any GUI tools that you may or may not have been using to
configure and monitor your wireless connections. If removing these tools
solves your problem, please file a bug report on the product's launchpad page
to help improve the app's performance.
7. Commands
This section gives a real brief summary of commands used to help you
troubleshoot. There are also examples of the commands discussed. For more
information, consult the man page of the command or do a google search.
7.1. lshw
This command shows information about hardware:
sudo lshw
We can limit the the output to show just specific devices by adding options to
the command:
https://help.ubuntu.com/community/WifiDocs/WirelessTroubleShootingGuide?action... 20.Nov.09
WifiDocs/WirelessTroubleShootingGuide - Community Ubuntu Documentation Page 15 of 22
You can then use a different option to limit output so it shows just your
networking devices.
Find your device in the list and notice it's class then:
*-network
description: Wireless interface
product: AR5212 802.11abg NIC
vendor: Atheros Communications, Inc.
physical id: 1
bus info: pci@03:00.0
logical name: ath0
version: 01
serial: 00:11:95:50:be:62
width: 32 bits
clock: 33MHz
capabilities: bus_master cap_list ethernet physical
wireless
configuration: broadcast=yes '''driver=ath_pci
driverversion=0.9.6.0 (EXPERIMENTAL)''' ip=192.168.1.12
multicast=yes wireless=IEEE 802.11g
resources: iomemory:10800000-1080ffff irq:11
Key Points
1. Notice the configuration line. This area will tell you if there is a driver
loaded for your device. (except devices using orinoco driver, these don't
show here) If you do not see a driver listed here then there is not one loaded
and assigned to the device and it will not show up in iwconfig output or the
nework-admin gui.
2. The businfo line has importance as some devices are recognized and
memory is readable but the device is not physically on the bus. This is rare
but it has been seen. It may seem cryptic but your output will vary greatly
and there needs to be some characters (other then 0) here denoting it's place
in the pci bus.
https://help.ubuntu.com/community/WifiDocs/WirelessTroubleShootingGuide?action... 20.Nov.09
WifiDocs/WirelessTroubleShootingGuide - Community Ubuntu Documentation Page 16 of 22
7.2. lspci
This command lists information about devices on the pci bus:
lspci -v
Lists out pci devices with information about the device. (information is
different then output from lshw)
You can limit the output by piping the output with grep
command:
sudo lspci -n
Key Points
1. This command shows the revision of the card (in above example the revision
of the card is B5 not 01).
2. Using the -n option you can find the PCI ID (168C:0013) of the card and
https://help.ubuntu.com/community/WifiDocs/WirelessTroubleShootingGuide?action... 20.Nov.09
WifiDocs/WirelessTroubleShootingGuide - Community Ubuntu Documentation Page 17 of 22
7.3. lsusb
This command lists information about devices on the usb bus.
sudo lsusb -v
$ lsusb
Bus 005 Device 001: ID 0000:0000
Bus 001 Device 001: ID 0000:0000
Bus 004 Device 002: ID 2001:3700 D-Link Corp. [hex] DWL-122
802.11b
Bus 004 Device 001: ID 0000:0000
Bus 003 Device 001: ID 0000:0000
Bus 002 Device 001: ID 0000:0000
7.4. lsmod
This command simply shows what modules are loaded and running.
sudo lsmod
When the command lshw was run, you saw the name of the driver allocated to
the device. You can pipe this command through grep to limit the output.
ath_pci 78908 0
ath_rate_sample 16776 1 ath_pci
wlan 141532 4
wlan_wep,ath_pci,ath_rate_sample
ath_hal 148432 3 ath_pci,ath_rate_sample
7.5. modprobe
https://help.ubuntu.com/community/WifiDocs/WirelessTroubleShootingGuide?action... 20.Nov.09
WifiDocs/WirelessTroubleShootingGuide - Community Ubuntu Documentation Page 18 of 22
When a recognized device loads, the kernel automatically loads the correct
module for the device. This command is only needed to manually run a module
7.6. iwconfig
This command prints information about a wireless interface and allows you
to configure the network interface from the command line.
sudo iwconfig
Key Points
1. This example shows the interface of ath0. If you do not see anything like this
https://help.ubuntu.com/community/WifiDocs/WirelessTroubleShootingGuide?action... 20.Nov.09
WifiDocs/WirelessTroubleShootingGuide - Community Ubuntu Documentation Page 19 of 22
You can not set the channel(currently with breezy or earlier) via the network
gui. Most drivers are set up as auto so it changes to the corresponding channel of
the ap you're trying to connect to. But if you must make the change then this is the
command to change it.
Channel/Frequency
Chart
Ch 1 2.412
Ch 2 2.417
Ch 3 2.422
Ch 4 2.427
Ch 5 2.432
Ch 6 2.437
Ch 7 2.442
Ch 8 2.447
Ch 9 2.452
Ch 10 2.457
Ch 11 2.462
Ch 12 2.467
Non US Channels
Ch 13 2.472
Ch 14 2.484
7.7. ifconfig
https://help.ubuntu.com/community/WifiDocs/WirelessTroubleShootingGuide?action... 20.Nov.09
WifiDocs/WirelessTroubleShootingGuide - Community Ubuntu Documentation Page 20 of 22
sudo ifconfig
Key Points
7.8. iwlist
This command will give you more detailed information from the wireless
interface such as a scan of all available routers with in range.
https://help.ubuntu.com/community/WifiDocs/WirelessTroubleShootingGuide?action... 20.Nov.09
WifiDocs/WirelessTroubleShootingGuide - Community Ubuntu Documentation Page 21 of 22
Mode: Master
Frequency: 2.437 GHz (Channel 6)
Quality=49/94 Signal level=-46 dBm
Noise level=-95 dBm
Encryption key:on
Bit Rate:1 Mb/s
Bit Rate:2 Mb/s
Bit Rate:5 Mb/s
Bit Rate:6 Mb/s
Bit Rate:9 Mb/s
Bit Rate;11 Mb/s
Bit Rate;12 Mb/s
Bit Rate;18 Mb/s
Bit Rate;24 Mb/s
Bit Rate;36 Mb/s
Bit Rate;48 Mb/s
Bit Rate;54 Mb/s
Extra bcn_int=100
Key Points
1. If you get a completed scan like example, then your device and driver is
probably working properly.
2. Some devices do not support scanning so this command may not work for
you.(such as orinoco cards)
7.9. dhclient
dhclient is simply the program that deals with dhcp if you're dealing with a
router running as a dhcp server.
If you are associated with your router try running this command to get ip and
other information to set up connection.
7.10. ping
ping is a good troubleshooting command to track down where the connection
problem may be: First ping your local loopback device
ping -c 4 127.0.0.1
If this doesn't work then there is a problem in the tcp/ip stack some where.
If the device is assigned an ip address next ping that. use ifconfig to find
the ip address assigned to the device
https://help.ubuntu.com/community/WifiDocs/WirelessTroubleShootingGuide?action... 20.Nov.09
WifiDocs/WirelessTroubleShootingGuide - Community Ubuntu Documentation Page 22 of 22
ping -c 4 <192.168.1.11>
ping -c 4 <192.168.0.1>
ping -c 4 216.239.57.99
ping -c 4 www.google.com
If you can ping an external site with the ip address but not the common name
then there is a dns nameserver problem
7.11. Links
These are sites with information on wireless networking:
CategoryNetworking CategoryWireless
https://help.ubuntu.com/community/WifiDocs/WirelessTroubleShootingGuide?action... 20.Nov.09