docs/welcome/en/wifi.html

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
   4 <head>
   5 <!--
   6  *
   7  * Copyright 2010-2011, Haiku. All rights reserved.
   8  * Distributed under the terms of the MIT License.
   9  *
  10  * Authors:
  11 *               Matt Madia who wrote http://www.haiku-os.org/guides/wifi
  12  *              Humdinger <humdingerb@gmail.com>
  13  *
  14 -->
  15         <meta http-equiv="content-type" content="text/html; charset=utf-8" />
  16         <meta http-equiv="Content-Style-Type" content="text/css" />
  17         <meta name="robots" content="all" />
  18         <title>Wifi</title>
  19         <link rel="stylesheet" type="text/css" href="../Haiku-doc.css" />
  20 </head>
  21 <body>
  22
  23 <div id="banner">
  24 <div><span>User guide</span></div>
  25 </div>
  26
  27 <div class="nav">
  28 <div class="inner">
  29 <ul class="lang-menu">
  30 <li class="now"><img src="../images/flags/gb.png" alt="" /> English</li>
  31 <li><a href="../fr/wifi.html"><img src="../images/flags/fr.png" alt="" />Français</a></li>
  32 <li><a href="../de/wifi.html"><img src="../images/flags/de.png" alt="" />Deutsch</a></li>
  33 <li><a href="../it/wifi.html"><img src="../images/flags/it.png" alt="" />Italiano</a></li>
  34 <li><a href="../ru/wifi.html"><img src="../images/flags/ru.png" alt="" />Русский</a></li>
  35 <li><a href="../es/wifi.html"><img src="../images/flags/es.png" alt="" />Español</a></li>
  36 <li><a href="../sv_SE/wifi.html"><img src="../images/flags/sv_SE.png" alt="" />Svenska</a></li>
  37 <li><a href="../jp/wifi.html"><img src="../images/flags/jp.png" alt="" />日本語</a></li>
  38 <li><a href="../uk/wifi.html"><img src="../images/flags/uk.png" alt="" />Українська</a></li>
  39 <li><a href="../zh_CN/wifi.html"><img src="../images/flags/zh_CN.png" alt="" /> 中文 ［中文］</a></li>
  40 <li><a href="../pt_PT/wifi.html"><img src="../images/flags/pt_PT.png" alt="" />Português</a></li>
  41 <li><a href="../fi/wifi.html"><img src="../images/flags/fi.png" alt="" />Suomi</a></li>
  42 <li><a href="../sk/wifi.html"><img src="../images/flags/sk.png" alt="" />Slovenčina</a></li>
  43 </ul>
  44
  45 <span>
  46    <a href="../welcome_en.html" class="uplink">Welcome</a>
  47 </span></div>
  48 </div>
  49
  50 <div id="content">
  51 <div>
  52
  53 <h2>Wifi in Haiku</h2>
  54 <h3>
  55 <a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
  56 <a name="hardware" rel="nofollow" id="hardware">Expected supported hardware</a></h3>
  57 <p>All of FreeBSD 8 wlan drivers should be working. Any PCMCIA, CardBus, ExpressCard, USB or ISA based cards will not work. Only PCI, miniPCI, PCI-Express, miniPci-Express and PCI-X are supposed to work.<br />
  58 This includes:
  59 </p>
  60 <ul>
  61 <li><p><i>aironetwifi</i> supporting at least<br />
  62 Cisco Aironet 350 Series<br />
  63 Aironet PCI4500<br />
  64 Aironet PCI4800<br />
  65 </p></li>
  66 <li><p><i>atheroswifi</i> supporting almost every chipset outthere (though no AR9285 chips)</p></li>
  67 <li><p><i>broadcom43xx</i> supporting<br />
  68 BCM4301, BCM4306, BCM4307, BCM4309, BCM4311, BCM4312 and BCM4318
  69 </p></li>
  70 <li><p><i>ipw2100</i> supporting Intel Pro Wireless 2100 chips</p></li>
  71 <li><p><i>iprowifi2200</i> supporting Intel Pro Wireless<br />
  72 2200BG<br />
  73 2225BG<br />
  74 2915ABG
  75 </p></li>
  76 <li><p><i>iprowifi3945</i> supporting Intel Pro Wireless 3945 chips</p></li>
  77 <li><p><i>iprowifi4965</i> supporting Intel Pro Wireless 4965 chips</p></li>
  78 <li><p><i>marvell88w8335</i> supporting<br />
  79 Marvell Libertas 88W8310<br />
  80 Marvell Libertas 88W8335
  81 </p></li>
  82 <li><p><i>marvell88w8363</i> supporting the 88W8363 chips</p></li>
  83 <li><p><i>ralinkwifi</i> supporting<br />
  84 RT2560<br />
  85 RT2561S<br />
  86 RT2561<br />
  87 RT2661
  88 </p></li>
  89 <li><p>ralink2860 supporting Ralink RT2860</p></li>
  90 <li><p><i>wavelanwifi</i> supporting at least<br />
  91 3Com Airconnect<br />
  92 GLPRISM2 WaveLAN<br />
  93 Intersil Prism3<br />
  94 Intersil Prism2.5<br />
  95 Linksys WDT11<br />
  96 Netgear MA301<br />
  97 PRISM2STA WaveLAN<br />
  98 Siemens SpeedStream<br />
  99 SMC 2602W<br />
 100 Us Robotics 2415<br />
 101 Addtron AWA-100 PCI
 102 </p></li>
 103 </ul>
 104 <h3><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
 105 <a name="connect" rel="nofollow" id="connect">Connecting to a wireless network</a></h3>
 106 <p>Besides of course unencrypted networks, Haiku has preliminary support for accessing wireless networks via <a href="#wep-notes" rel="nofollow">WEP encryption keys</a>. WEP is an early encryption method, although not the most secure.</p>
 107 <p>You can list available networks, join and leave them with the command <span class="cli">ifconfig</span> from Terminal:</p>
 108 <pre class="terminal">ifconfig [wifi_device_path] [list|join|leave] (key)</pre>
 109 <p>You can find your <tt>wifi_device_path</tt> in the <span class="app">Network</span> preferences applet, or by executing <span class="cli">ifconfig -a</span>.</p>
 110 <p>Below are a few examples of connecting to a wireless network named <i>wifitopia</i>. For these examples we are assuming your wifi network card is <tt>/dev/net/iprowifi3945/0</tt>.</p>
 111 <h4>Listing wireless networks:</h4>
 112 <pre class="terminal">ifconfig /dev/net/iprowifi3945/0 list</pre>
 113 <h4>Joining unsecured wireless network:</h4>
 114 <pre class="terminal">ifconfig /dev/net/iprowifi3945/0 join wifitopia</pre>
 115 <h4>Joining <a href="#wep-notes">WEP secured</a> wireless network: (ascii password)</h4>
 116 <pre class="terminal">ifconfig /dev/net/iprowifi3945/0 join wifitopia mypassword</pre>
 117 <h4>Joining <a href="#wep-notes">WEP secured</a> wireless network: (64-bit hex password)</h4>
 118 <pre class="terminal">ifconfig /dev/net/iprowifi3945/0 join wifitopia 0x4010FABEEF</pre>
 119 <h4>Leaving a wireless network:</h4>
 120 <pre class="terminal">ifconfig /dev/net/iprowifi3945/0 leave wifitopia</pre>
 121 <h3>
 122 <a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
 123 <a name="auto-connect" rel="nofollow" id="auto-connect">Automatically connecting to a wireless network</a></h3>
 124 <p>To make your system connect to a given SSID at each boot automatically, you can specify your wireless networks and passwords in <tt>/boot/common/settings/network/wireless_networks</tt> with the following format:</p>
 125 <pre>network wifitopia {
 126    password mypassword
 127 }</pre>
 128 <p>If you don't create this configuration file, the system will connect to the first unencrypted network it finds.</p>
 129 <p><a name="wep-notes" rel="nofollow" id="wep-notes"><strong>WEP notes</strong></a></p>
 130 <ul>
 131 <li>64-bit WEP uses a 40-bit key, which means 5 text characters or 10 hex digits</li>
 132 <li>128-bit WEP uses a 104-bit key, which means 13 text characters or 26 hex digits</li>
 133 <li>hexadecimal digits = characters 0-9 and A through F (prepended with "0x" in <tt>ifconfig</tt>)</li>
 134 </ul>
 135 <h3>
 136 <a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
 137 <a name="wpa" rel="nofollow" id="wpa">WPA encryption</a></h3>
 138 <p><p>At the moment there is no WPA encryption available in Haiku, though there have been <a target="blank" href="http://haiku-os.org/blog/axeld/2010-10-13_wpa_encryption_progress">some efforts</a> bringing it significantly closer.</p></p>
 139 <h3>
 140 <a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
 141 <a name="install_script" rel="nofollow" id="install_script">install-wifi-firmwares.sh</a></h3>
 142 <p>To install the firmware for Intel ipw2100, Intel iprowifi2200/2225/2915, Broadcom 43xx &amp; Marvell 88W8335, you need to run</p>
 143 <pre class="terminal">install-wifi-firmwares.sh
 144 </pre>
 145 <p>The Intel ipw2100 and iprowifi22xx will install without an internet connection, as the licensing terms allow Haiku to distribute the original firmware archives. However, they do require acknowledgment by the end-user prior to their installation. The Broadcom 43xx and Marvell 88W8335 will require an active internet connection, as the files containing their respective firmwares cannot be distributed with Haiku.</p>
 146 <p>People building their own Haiku image can modify their <span class="cli">build/jam/UserBuildConfig</span> accordingly. Details for that and general updates on the wifi topic are found at the <a href="http://www.haiku-os.org/guides/wifi">online version of this document</a>.</p>
 147 <p>If you have to download the firmware, but don't have a working internet connection under Haiku, the online version offers a <a href="http://www.haiku-os.org/files/download-data-for-wlan-firmwares.txt" rel="nofollow">shell script</a>, which will create a zip file for you to extract to Haiku's <tt>/boot</tt>. After that you'll have all files needed by install-wifi-firmwares.sh.</p>
 148 </div>
 149 </div>
 150
 151 <div class="nav">
 152 <div class="inner"><span>
 153    <a href="../welcome_en.html" class="uplink">Welcome</a>
 154 </span></div>
 155 </div>
 156
 157 </body>
 158 </html>