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">
7 * Copyright 2010-2011, Haiku. All rights reserved.
8 * Distributed under the terms of the MIT License.
11 * Matt Madia who wrote http://www.haiku-os.org/guides/wifi
12 * Humdinger <humdingerb@gmail.com>
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" />
19 <link rel=
"stylesheet" type=
"text/css" href=
"../Haiku-doc.css" />
24 <div><span>User guide
</span></div>
29 <ul class=
"lang-menu">
30 <li class=
"now"><img src=
"../images/flags/pt_PT.png" alt=
"" /> Português
</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=
"../fi/wifi.html"><img src=
"../images/flags/fi.png" alt=
"" />Suomi
</a></li>
41 <li><a href=
"../sk/wifi.html"><img src=
"../images/flags/sk.png" alt=
"" />Slovenčina
</a></li>
42 <li><a href=
"../en/wifi.html"><img src=
"../images/flags/gb.png" alt=
"" />English
</a></li>
46 <a href=
"../welcome_pt_PT.html" class=
"uplink">Welcome
</a>
52 <div class=
"box-info">The translation of this page isn't yet complete. Until it is, unfinished parts use the English original.
</div>
54 <h2>Wifi in Haiku
</h2>
56 <a href=
"#"><img src=
"../images/up.png" style=
"border:none;float:right" alt=
"index" /></a>
57 <a name=
"hardware" rel=
"nofollow" id=
"hardware">Expected supported hardware
</a></h3>
58 <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 />
62 <li><p><i>aironetwifi
</i> supporting at least
<br />
63 Cisco Aironet
350 Series
<br />
67 <li><p><i>atheroswifi
</i> supporting almost every chipset outthere (though no AR9285 chips)
</p></li>
68 <li><p><i>broadcom43xx
</i> supporting
<br />
69 BCM4301, BCM4306, BCM4307, BCM4309, BCM4311, BCM4312 and BCM4318
71 <li><p><i>ipw2100
</i> supporting Intel Pro Wireless
2100 chips
</p></li>
72 <li><p><i>iprowifi2200
</i> supporting Intel Pro Wireless
<br />
77 <li><p><i>iprowifi3945
</i> supporting Intel Pro Wireless
3945 chips
</p></li>
78 <li><p><i>iprowifi4965
</i> supporting Intel Pro Wireless
4965 chips
</p></li>
79 <li><p><i>marvell88w8335
</i> supporting
<br />
80 Marvell Libertas
88W8310
<br />
81 Marvell Libertas
88W8335
83 <li><p><i>marvell88w8363
</i> supporting the
88W8363 chips
</p></li>
84 <li><p><i>ralinkwifi
</i> supporting
<br />
90 <li><p>ralink2860 supporting Ralink RT2860
</p></li>
91 <li><p><i>wavelanwifi
</i> supporting at least
<br />
93 GLPRISM2 WaveLAN
<br />
95 Intersil Prism2.5
<br />
98 PRISM2STA WaveLAN
<br />
99 Siemens SpeedStream
<br />
101 Us Robotics
2415<br />
105 <h3><a href=
"#"><img src=
"../images/up.png" style=
"border:none;float:right" alt=
"index" /></a>
106 <a name=
"connect" rel=
"nofollow" id=
"connect">Connecting to a wireless network
</a></h3>
107 <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>
108 <p>You can list available networks, join and leave them with the command
<span class=
"cli">ifconfig
</span> from Terminal:
</p>
109 <pre class=
"terminal">ifconfig [wifi_device_path] [list|join|leave] (key)
</pre>
110 <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>
111 <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>
112 <h4>Listing wireless networks:
</h4>
113 <pre class=
"terminal">ifconfig /dev/net/iprowifi3945/
0 list
</pre>
114 <h4>Joining unsecured wireless network:
</h4>
115 <pre class=
"terminal">ifconfig /dev/net/iprowifi3945/
0 join wifitopia
</pre>
116 <h4>Joining
<a href=
"#wep-notes">WEP secured
</a> wireless network: (ascii password)
</h4>
117 <pre class=
"terminal">ifconfig /dev/net/iprowifi3945/
0 join wifitopia mypassword
</pre>
118 <h4>Joining
<a href=
"#wep-notes">WEP secured
</a> wireless network: (
64-bit hex password)
</h4>
119 <pre class=
"terminal">ifconfig /dev/net/iprowifi3945/
0 join wifitopia
0x4010FABEEF</pre>
120 <h4>Leaving a wireless network:
</h4>
121 <pre class=
"terminal">ifconfig /dev/net/iprowifi3945/
0 leave wifitopia
</pre>
123 <a href=
"#"><img src=
"../images/up.png" style=
"border:none;float:right" alt=
"index" /></a>
124 <a name=
"auto-connect" rel=
"nofollow" id=
"auto-connect">Automatically connecting to a wireless network
</a></h3>
125 <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>
126 <pre>network wifitopia {
129 <p>If you don't create this configuration file, the system will connect to the first unencrypted network it finds.
</p>
130 <p><a name=
"wep-notes" rel=
"nofollow" id=
"wep-notes"><strong>WEP notes
</strong></a></p>
132 <li>64-bit WEP uses a
40-bit key, which means
5 text characters or
10 hex digits
</li>
133 <li>128-bit WEP uses a
104-bit key, which means
13 text characters or
26 hex digits
</li>
134 <li>hexadecimal digits = characters
0-
9 and A through F (prepended with
"0x" in
<tt>ifconfig
</tt>)
</li>
137 <a href=
"#"><img src=
"../images/up.png" style=
"border:none;float:right" alt=
"index" /></a>
138 <a name=
"wpa" rel=
"nofollow" id=
"wpa">WPA encryption
</a></h3>
139 <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>
141 <a href=
"#"><img src=
"../images/up.png" style=
"border:none;float:right" alt=
"index" /></a>
142 <a name=
"install_script" rel=
"nofollow" id=
"install_script">install-wifi-firmwares.sh
</a></h3>
143 <p>To install the firmware for Intel ipw2100, Intel iprowifi2200/
2225/
2915, Broadcom
43xx
& Marvell
88W8335, you need to run
</p>
144 <pre class=
"terminal">install-wifi-firmwares.sh
146 <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>
147 <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>
148 <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>
153 <div class=
"inner"><span>
154 <a href=
"../welcome_pt_PT.html" class=
"uplink">Welcome
</a>