To support WPA/WPA2 encryption, you need the "wpa supplicant" tool, just install it this way :

To support WPA/WPA2 encryption, you need the "wpa supplicant" tool, just install it this way :

apt-get install wpasupplicant

apt-get install wpasupplicant

Line 49:

Line 49:

ssid="your network SSID"

ssid="your network SSID"

psk="your wpa key (up to 63 characters)"

psk="your wpa key (up to 63 characters)"

+

proto=WPA

priority=5

priority=5

}

}

+

If you are running a WPA2 network, replace "proto=WPA" with "proto=WPA2"

+

Now edit your /etc/network/interfaces file to add the new network interface. You have to put this '''before''' the eth0 configuration or the kurobox will keep trying to use eth0 (wired ethernet link) for all your network communications.

Now edit your /etc/network/interfaces file to add the new network interface. You have to put this '''before''' the eth0 configuration or the kurobox will keep trying to use eth0 (wired ethernet link) for all your network communications.

Introduction

This will describe how to set-up your wireless network connexion using a zd1211 network adapter.
It's describing the method for a debian distribution, but the steps should remain the same for other distributions (only the way to install some applications will change).
The ZD1211 network adapter is natively supported since kernel 2.6.18. For this reason it is the best (and maybe the only ?) choice if you plan to connect your kurobox to your wireless network !
To find what to buy to get a zd1211 chip, check the list here.
I've done my test with a MSI US54SE adapter (Easy to find in France).

Install the zd1211 firmwares

Download the driver file from one of the mirrors on http://sourceforge.net/project/showfiles.php?group_id=129083
Untar the file so you'll have the firmware files in /lib/firmware/zd1211 .
Now, you're ready to plug your USB adapted on your kurobox !
When done, you should see this in the output of dmesg :

If you are running a WPA2 network, replace "proto=WPA" with "proto=WPA2"

Now edit your /etc/network/interfaces file to add the new network interface. You have to put this before the eth0 configuration or the kurobox will keep trying to use eth0 (wired ethernet link) for all your network communications.
Your file may looks like this (if using DHCP configuration) :

Note that the driver currently doesn't (yet) support automatic rate adjustment, so it'll connect at 11mbps speed. You can change this by running this command :

iwconfig eth1 rate 54M fixed

You should add this line in /etc/init.d/networking if you want your adapter to always use 54mbps speed.

Now just shutdown and restart your kurobox (reboot often fails to detect the wireless adapter because of a bug in the driver, so a complete shutdown and restart is better ...) and your kurobox will be on the network even with the ethernet cable unplugged .
With this configuration, the wireless adapter (eth1) will be used if plugged and detected, elseway eth0 (wired ethernet) will be used.

Known bugs/restrictions

The zd1211rw module has limitations/bugs. Limitations are described here
For kernel 2.6.18.2, these limitations are :

No ad-hoc mode

No access point mode

No 802.11a support

No Hardware encryption (using software encryption instead)

Largepacket + TX-burst not supported

No Automatic rate selection/management

No Automatic TX power calibration (using a fixed power for now)

ifconfig/iwconfig are always reporting 0 bytes for RX/TX

TO DO

Add description for "no encryption" and "WEP encryption" networks

Add description to configure the zd1211 chip as an access point (when available in the zd1211rw module)