# WLAN

User Guide

## WLAN in Haiku

### Wahrscheinlich unterstützte Hardware

Alle FreeBSD 8 WLAN Treiber sollten funktionieren. Jedoch keine PCMCIA, CardBus, ExpressCard, USB oder ISA basierte Karten. Unterstützt wird nur PCI, miniPCI, PCI-Express, miniPci-Express und PCI-X.
Darunter:

- aironetwifi unterstützt zumindest
  Cisco Aironet 350 Serie
  Aironet PCI4500
  Aironet PCI4800

- atheroswifi unterstützt fast alle Chipsets (allerdings keine AR9285 Chips)

- broadcom43xx unterstützt
  BCM4301, BCM4306, BCM4307, BCM4309, BCM4311, BCM4312 und BCM4318

- ipw2100 unterstützt Intel Pro Wireless 2100 Chips

- iprowifi2200 unterstützt Intel Pro Wireless
  2200BG
  2225BG
  2915ABG

- iprowifi3945 unterstützt Intel Pro Wireless Chips 3945

- iprowifi4965 unterstützt Intel Pro Wireless 4965 Chips

- marvell88w8335 unterstützt
  Marvell Libertas 88W8310
  Marvell Libertas 88W8335

- marvell88w8363 unterstützt 88W8363 Chips

- ralinkwifi unterstützt
  RT2560
  RT2561S
  RT2561
  RT2661

- ralink2860 unterstützt Ralink RT2860

- wavelanwifi unterstützt zumindest
  3Com Airconnect
  GLPRISM2 WaveLAN
  Intersil Prism3
  Intersil Prism2.5
  Linksys WDT11
  Netgear MA301
  PRISM2STA WaveLAN
  Siemens SpeedStream
  SMC 2602W
  Us Robotics 2415
  Addtron AWA-100 PCI

### Verbindung zum Funknetzwerk

Neben unverschlüsselten Netzwerken unterstützt Haiku auch mittels WEP Schlüssel verschlüsselte Netze. WEP ist allerdings eine bereits veraltete Verschlüsselungsmethode, also nicht wirklich sicher.

Vom Terminal aus lassen sich mit dem Befehl ifconfig vorhandene Funknetze auflisten und mit einem Verbindung aufnehmen ("join") oder wieder trennen ("leave"):

    ifconfig [Wifi_Geräte_Pfad] [list|join|leave] (Schlüssel)

Der `Wifi_Geräte_Pfad` wird in den Netzwerk Einstellungen angezeigt oder mit dem Befehl ifconfig -a im Terminal.

Nachfolgend einige Beispiele wie mit einem Funknetzwerk namens wifitopia eine Verbindung hergestellt wird. Als Netzwerkkarte wird `/dev/net/iprowifi3945/0` angenommen.

#### Alle Funknetzwerke auflisten:

    ifconfig /dev/net/iprowifi3945/0 list

#### Verbindung mit einem unverschlüsselten Funknetzwerk:

    ifconfig /dev/net/iprowifi3945/0 join wifitopia

#### Verbindung mit einem WEP verschlüsselten Funknetzwerk: (ASCII Passwort)

    ifconfig /dev/net/iprowifi3945/0 join wifitopia DasPasswort

#### Verbindung mit einem WEP verschlüsselten Funknetzwerk: (64 Bit Hex-Passwort)

    ifconfig /dev/net/iprowifi3945/0 join wifitopia 0x4010FABEEF

#### Verbindung zum Funknetzwerk trennen:

    ifconfig /dev/net/iprowifi3945/0 leave wifitopia

### Automatische Verbindung zu einem Funknetzwerk

Nach dem Hochfahren kann man sich auch automatisch mit einem durch seine SSID benannten Netzwerk verbinden. Dazu müssen Funknetzwerke und die entsprechenden Passwörter in der Datei `/boot/Allgemein/settings/network/wireless_networks` in folgendem Format abgelegt werden:

    network wifitopia {
       password DasPasswort
    }

Legt man diese Konfigurationsdatei nicht an, verbindet sich das System automatisch mit dem ersten unverschlüsselten Netzwerk, das es findet.

WEP Info

- 64-bit WEP benutzt ein 40-bit Passwort, das sind 5 Buchstaben oder 10 Hex-Werte
- 128-bit WEP benutzt ein 104-bit Passwort, das sind 13 Buchstaben oder 26 Hex-Werte
- Hex-Werte sind die Zahlen 0-9 und Buchstaben A bis F (in `ifconfig` mit einem vorangestellten '0x')

### WPA Verschlüsselung

Momentan gibt es noch keine WPA Verschlüsselung unter Haiku. Ein großer Schritt in diese Richtung wurde allerdings bereits unternommen.

### install-wifi-firmwares.sh

Um die Firmware für Intel ipw2100, Intel iprowifi2200/2225/2915, Broadcom 43xx & Marvell 88W8335 zu installieren, startet man

    ~> install-wifi-firmwares.sh

Die Intel ipw2100 und iprowifi22xx benötigen zur Installation keine Internetverbindung, da es die Lizenzbestimmungen erlauben, die Original-Firmware gleich mitzuliefern. Sie verlangen jedoch eine Zustimmung des Benutzers vor ihrer Installtion. Für Broadcom 43xx & Marvell 88W8335 ist hingegen eine funktionierende Internetverbindung nötig, da die entsprechenden Dateien mit der Firmware Haiku nicht beiliegen dürfen.

Leute, die ihr eigenes Haiku Image bauen, können ihre build/jam/UserBuildConfig entsprechend anpassen. Details dazu und eventuelle Updates zum WLAN-Thema finden sich in der Online-Version dieses Dokuments (Englisch).

Wer die Firmware runterladen muss, aber unter Haiku keine Internetverbindung hat, kann das in diesem Online Dokument angebotene Shell Skript benutzen. Damit werden alle nötigen Dateien heruntergeladen und in ein Zip gepackt, das man unter Haiku in `/boot` entpacken kann. Dann stehen alle Dateien zur Verfügung, die von install-wifi-firmwares.sh benötigt werden.