<page xmlns="http://projectmallard.org/1.0/"
      type="topic" style="task"
      id="net-wireless-troubleshooting-hardware-check">
  <info>
    <link type="next" xref="net-wireless-troubleshooting-device-drivers"/>
    <link type="guide" xref="net-wireless-troubleshooting"/>
    <revision pkgversion="3.4.0" date="2012-03-05" status="outdated"/>
    <revision version="13.10" date="2013-09-15" status="review"/>

    <credit type="author">
      <name>Contributors to the Ubuntu documentation wiki</name>
    </credit>

    <credit type="author">
      <name>GNOME Documentation Project</name>
      <email>gnome-doc-list@gnome.org</email>
    </credit>

    <desc>Even though your wireless adapter is connected, it may not have been recognized properly by the computer.</desc>
    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
  </info>

<title>Wireless connection troubleshooter</title>
<subtitle>Check that the wireless adapter was recognized</subtitle>

<p>Even though the wireless adapter is connected to the computer, it may not have been recognized as a network device by the computer. In this step, you will check whether the device was recognized properly.</p>

<steps>
 <item>
  <p>Open a Terminal window, type <cmd>sudo lshw -C network</cmd> and press <key>Enter</key>. If this gives an error message, you can install the <app>lshw</app> program on your computer by typing <cmd>sudo apt-get install lshw</cmd> into the terminal.</p>
 </item>
 <item>
  <p>Look through the information that appeared and find the <em>Wireless interface</em> section. If your wireless adapter was detected properly, you should see something similar (but not identical) to this:</p>
   <code><![CDATA[*-network
       description: Wireless interface
       product: PRO/Wireless 3945ABG [Golan] Network Connection
       vendor: Intel Corporation]]></code>
 </item>
 <item>
  <p>If a wireless device is listed, continue on to the <link xref="net-wireless-troubleshooting-device-drivers">Device Drivers step</link>.</p>
  <p>If a wireless device is <em>not</em> listed, the next steps you take will depend on the type of device that you use. Refer to the section below that is relevant to the type of wireless adapter that your computer has (<link xref="#pci">internal PCI</link>, <link xref="#usb">USB</link>, or <link xref="#pcmcia">PCMCIA</link>).</p>
 </item>
</steps>

<section id="pci">
 <title>PCI (internal) wireless adapter</title>
 <p>Internal PCI adapters are the most common, and are found in most laptops made within the past few years. To check if your PCI wireless adapter was recognized:</p>
 <steps>
  <item><p>Open a Terminal, type <cmd>lspci</cmd> and press <key>Enter</key>.</p></item>
  <item>
   <p>Look through the list of devices that is shown and find any that are marked <code>Network controller</code> or <code>Ethernet controller</code>. Several devices may be marked in this way; the one corresponding to your wireless adapter might include words like <code>wireless</code>, <code>WLAN</code>, <code>wifi</code> or <code>802.11</code>. Here is an example of what the entry might look like:</p>
 <code>Network controller: Intel Corporation PRO/Wireless 3945ABG [Golan] Network Connection</code>
 </item>
 <item><p>If you found your wireless adapter in the list, proceed to the <link xref="net-wireless-troubleshooting-device-drivers">Device Drivers step</link>. If you didn't find anything related to your wireless adapter, see <link xref="#not-recognized">the instructions below</link>.</p></item>
 </steps>
</section>

<section id="usb">
 <title>USB wireless adapter</title>
 <p>Wireless adapters that plug into a USB port on your computer are less common. They can plug directly into a USB port, or may be connected by a USB cable. 3G/mobile broadband adapters look quite similar to wireless (wifi) adapters, so if you think you have a USB wireless adapter, double-check that it is not actually a 3G adapter. To check if your USB wireless adapter was recognized:</p>
 <steps>
  <item><p>Open a Terminal, type <cmd>lsusb</cmd> and press <key>Enter</key>.</p></item>
  <item>
   <p>Look through the list of devices that is shown and find any that seem to refer to a wireless or network device. The one corresponding to your wireless adapter might include words like <code>wireless</code>, <code>WLAN</code>, <code>wifi</code> or <code>802.11</code>. Here is an example of what the entry might look like:</p>
   <code><![CDATA[Bus 005 Device 009: ID 12d1:140b Huawei Technologies Co., Ltd. EC1260 Wireless Data Modem HSD USB Card]]></code>
  </item>
  <item><p>If you found your wireless adapter in the list, proceed to the <link xref="net-wireless-troubleshooting-device-drivers">Device Drivers step</link>. If you didn't find anything related to your wireless adapter, see <link xref="#not-recognized">the instructions below</link>.</p></item>
 </steps>
</section>

<section id="pcmcia">
 <title>Checking for a PCMCIA device</title>
 <p>PCMCIA wireless adapters are typically rectangular cards which slot into the side of your laptop. They are more commonly found in older computers. To check if your PCMCIA adapter was recognized:</p>
 <steps>
  <item><p>Start your computer <em>without</em> the wireless adapter plugged in.</p></item>
  <item>
   <p>Open a Terminal and type the following, then press <key>Enter</key>:</p>
   <code>tail -f /var/log/dmesg</code>
   <p>This will display a list of messages related to your computer's hardware, and will automatically update if anything to do with your hardware changes.</p>
  </item>
  <item><p>Insert your wireless adapter into the PCMCIA slot and see what changes in the Terminal window. The changes should include some information about your wireless adapter. Look through them and see if you can identify it.</p></item>
  <item><p>To stop the command from running in the Terminal, press <keyseq><key>Ctrl</key><key>C</key></keyseq>. After you have done that, you can close the Terminal if you like.</p></item>
  <item><p>If you found any information about your wireless adapter, proceed to the <link xref="net-wireless-troubleshooting-device-drivers">Device Drivers step</link>. If you didn't find anything related to your wireless adapter, see <link xref="#not-recognized">the instructions below</link>.</p></item>
 </steps>
</section>

<section id="not-recognized">
 <title>Wireless adapter was not recognized</title>
<p>If your wireless adapter was not recognized, it might not be working properly or the correct drivers may not be installed for it.</p>
<p>To get specific help, look at the support options on your distribution's website. These might include mailing lists and web chats where you can ask about your wireless adapter, for example.</p>
</section>

</page>