haiku/userguide
1
0
Fork 0
mirror of https://review.haiku-os.org/userguide synced 2026-02-04 07:53:42 +01:00
Code Issues Packages Projects Releases Wiki Activity

Updated user guide plus translations. Thanks everyone. +alpha3

Browse Source 
git-svn-id: file:///srv/svn/repos/haiku/haiku/trunk@41656 a95241bf-73f2-0310-859d-f6bbb57e9c96
This commit is contained in:
Joachim Seemer
2011-05-22 18:01:43 +00:00
parent aed9565e10
commit 78b5f2bcba
1143 changed files with 5581 additions and 4702 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
welcome/en/bugreports.html
View File

@@ -33,7 +33,7 @@
<li><a href="../it/bugreports.html"><img src="../images/flags/it.png" alt="" />Italiano</a></li>
<li><a href="../ru/bugreports.html"><img src="../images/flags/ru.png" alt="" />Русский</a></li>
<li><a href="../es/bugreports.html"><img src="../images/flags/es.png" alt="" />Español</a></li>
<li><a href="../sv_SE/bugreports.html"><img src="../images/flags/sv_SE.png" alt="" />Svensk</a></li>
<li><a href="../sv_SE/bugreports.html"><img src="../images/flags/sv_SE.png" alt="" />Svenska</a></li>
<li><a href="../jp/bugreports.html"><img src="../images/flags/jp.png" alt="" />日本語</a></li>
<li><a href="../uk/bugreports.html"><img src="../images/flags/uk.png" alt="" />Українська</a></li>
<li><a href="../zh_CN/bugreports.html"><img src="../images/flags/zh_CN.png" alt="" /> 中文 ［中文］</a></li>

57
welcome/en/wifi.html
View File

@@ -4,7 +4,7 @@
<head>
<!--
*
* Copyright 2010, Haiku. All rights reserved.
* Copyright 2010-2011, Haiku. All rights reserved.
* Distributed under the terms of the MIT License.
*
* Authors:
@@ -33,7 +33,7 @@
<li><a href="../it/wifi.html"><img src="../images/flags/it.png" alt="" />Italiano</a></li>
<li><a href="../ru/wifi.html"><img src="../images/flags/ru.png" alt="" />Русский</a></li>
<li><a href="../es/wifi.html"><img src="../images/flags/es.png" alt="" />Español</a></li>
<li><a href="../sv_SE/wifi.html"><img src="../images/flags/sv_SE.png" alt="" />Svensk</a></li>
<li><a href="../sv_SE/wifi.html"><img src="../images/flags/sv_SE.png" alt="" />Svenska</a></li>
<li><a href="../jp/wifi.html"><img src="../images/flags/jp.png" alt="" />日本語</a></li>
<li><a href="../uk/wifi.html"><img src="../images/flags/uk.png" alt="" />Українська</a></li>
<li><a href="../zh_CN/wifi.html"><img src="../images/flags/zh_CN.png" alt="" /> 中文 ［中文］</a></li>
@@ -65,14 +65,14 @@ Aironet PCI4800<br />
<li><p><i>broadcom43xx</i> supporting<br />
BCM4301, BCM4306, BCM4307, BCM4309, BCM4311, BCM4312 and BCM4318
</p></li>
<li><p><i>iprowifi2100</i> supporting the 2100 chips</p></li>
<li><p><i>iprowifi2200</i> supporting<br />
<li><p><i>ipw2100</i> supporting Intel Pro Wireless 2100 chips</p></li>
<li><p><i>iprowifi2200</i> supporting Intel Pro Wireless<br />
2200BG<br />
2225BG<br />
2915ABG
</p></li>
<li><p><i>iprowifi3945</i> supporting the 3945 chips</p></li>
<li><p><i>iprowifi4965</i> supporting the 4965 chips</p></li>
<li><p><i>iprowifi3945</i> supporting Intel Pro Wireless 3945 chips</p></li>
<li><p><i>iprowifi4965</i> supporting Intel Pro Wireless 4965 chips</p></li>
<li><p><i>marvell88w8335</i> supporting<br />
Marvell Libertas 88W8310<br />
Marvell Libertas 88W8335
@@ -84,6 +84,7 @@ RT2561S<br />
RT2561<br />
RT2661
</p></li>
<li><p>ralink2860 supporting Ralink RT2860</p></li>
<li><p><i>wavelanwifi</i> supporting at least<br />
3Com Airconnect<br />
GLPRISM2 WaveLAN<br />
@@ -98,38 +99,48 @@ Us Robotics 2415<br />
Addtron AWA-100 PCI
</p></li>
</ul>
<h3><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
<a name="connect" rel="nofollow" id="connect">Connecting to a wireless network</a></h3>
<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>
<p>You can list available networks, join and leave them with the command <span class="cli">ifconfig</span> from Terminal:</p>
<pre class="terminal">ifconfig [wifi_device_path] [list|join|leave] (key)</pre>
<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>
<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>
<h4>Listing wireless networks:</h4>
<pre class="terminal">ifconfig /dev/net/iprowifi3945/0 list</pre>
<h4>Joining unsecured wireless network:</h4>
<pre class="terminal">ifconfig /dev/net/iprowifi3945/0 join wifitopia</pre>
<h4>Joining <a href="#wep-notes">WEP secured</a> wireless network: (ascii password)</h4>
<pre class="terminal">ifconfig /dev/net/iprowifi3945/0 join wifitopia mypassword</pre>
<h4>Joining <a href="#wep-notes">WEP secured</a> wireless network: (64-bit hex password)</h4>
<pre class="terminal">ifconfig /dev/net/iprowifi3945/0 join wifitopia 0x4010FABEEF</pre>
<h4>Leaving a wireless network:</h4>
<pre class="terminal">ifconfig /dev/net/iprowifi3945/0 leave wifitopia</pre>
<h3>
<a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
<a name="wep" rel="nofollow" id="wep">WEP encryption</a></h3>
<p>WEP encryption is available through a command-line application <span class="cli">setwep</span>. It is a temporary means for joining an unencrypted or WEP encrypted wifi network. <span class="cli">setwep</span> works with 64- and 128-bit WEP and supports both text keys as well as hex digit keys (see <a href="#wep-notes" rel="nofollow">WEP notes</a> below).
</p>
<p>The usage is: <span class="cli">setwep device_path [ssid] [key]</span></p>
<p>Below are two examples. Let us assume your wifi network card is "/dev/net/iprowifi3945/0" and the wireless network is named "haikuwifi".</p>
<h4>Example 1: Connect with 64-bit WEP encryption using a hex digit key</h4>
<pre class="terminal">setwep /dev/net/iprowifi3945/0 haikuwifi 0x3456789abc
</pre><h4>Example 2: Connect to an unencrypted wireless network</h4>
<pre class="terminal">setwep /dev/net/iprowifi3945/0 haikuwifi
</pre><div class="box-info">
<li>To find out what your device_path is, have a look in Preferences -&gt; Network</li>
<li>To make your wifi device connect to a given SSID at each boot, add the <tt>setwep</tt> command to your <tt>home/config/boot/UserBootscript</tt></li>
</div>
<a name="auto-connect" rel="nofollow" id="auto-connect">Automatically connecting to a wireless network</a></h3>
<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>
<pre>network wifitopia {
   password mypassword
}</pre>
<p>If you don't create this configuration file, the system will connect to the first unencrypted network it finds.</p>
<p><a name="wep-notes" rel="nofollow" id="wep-notes"><strong>WEP notes</strong></a></p>
<ul>
<li>64-bit WEP uses a 40-bit key, which means 5 text characters or 10 hex digits</li>
<li>128-bit WEP uses a 104-bit key, which means 13 text characters or 26 hex digits</li>
<li>hexadecimal digits = characters 0-9 and A through F (prepended with "0x" in <tt>setwep</tt>)</li>
<li>hexadecimal digits = characters 0-9 and A through F (prepended with "0x" in <tt>ifconfig</tt>)</li>
</ul>
<h3>
<a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
<a name="wpa" rel="nofollow" id="wpa">WPA encryption</a></h3>
<p>At the moment there is no WPA encryption available in Haiku. However, there is some <a target="_blank" class="ext" href="http://alexbl.net/%7Ealexbl/haiku-wpa/" rel="nofollow">preliminary and unfinished code for implementing WPA</a><span class="ext"></span> available. Some tasks for improving this is to plug it into the wpa_supplicant build process and then fixing compile &amp; runtime issues.</p>
<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>
<h3>
<a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
<a name="install_script" rel="nofollow" id="install_script">install-wifi-firmwares.sh</a></h3>
<p>To install the firmware for Intel ipw2100, Intel ipw2200/2225/2915, Broadcom 43xx &amp; Marvell 88W8335, you need to run</p>
<p>To install the firmware for Intel ipw2100, Intel iprowifi2200/2225/2915, Broadcom 43xx &amp; Marvell 88W8335, you need to run</p>
<pre class="terminal">install-wifi-firmwares.sh
</pre>
<p>The Intel ipw2100 and ipw22xx 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>
<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>
<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>
<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>
</div>