======WLAN======

On STOUT the nano WLAN module (EW-7811Un) with Chip Set Realtek RTL818x can be embedded.
{{:tech:ew-7811un.jpg?nolink&100|}}

The kernel has to be prepared for ''readyForModuleRTL8192CU''.

Load the module ''wlan.ko'' and start the interface by \\
''insmod wlan.ko''\\
''ifconfig wlan0 up''\\
</code>
Where wlan0 is the name of your wireless device (this is most often the default). The above command will bring your wireless device up so it is ready to use.
''ifconfig'' shows your devices already:
<code>
wlan0     Link encap:Ethernet  HWaddr 80:1F:02:F1:DF:A9  
          UP BROADCAST MULTICAST  MTU:1500  Metric:1
          RX packets:0 errors:0 dropped:2 overruns:0 frame:0
          TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:1000 
          RX bytes:0 (0.0 B)  TX bytes:0 (0.0 B)
</code>
The next phase is to scan for any wireless access points with the command\\
''iwlist wlan0 scan''\\
From the output of the scan you should see a line (or lines) like:
<code>
wlan0     Scan completed :
          Cell 01 - Address: 28:37:37:48:EF:2C
                    ESSID:"WLAN_RB"
                    Protocol:IEEE 802.11bgn
                    Mode:Master
                    Frequency:2.437 GHz (Channel 6)
                    Encryption key:on
                    Bit Rates:144 Mb/s
                    Extra:rsn_ie=30140100000fac040100000fac040100000fac020000
                    IE: IEEE 802.11i/WPA2 Version 1
                        Group Cipher : CCMP
                        Pairwise Ciphers (1) : CCMP
                        Authentication Suites (1) : PSK
                    Quality=78/100  Signal level=51/100  
</code>

For non-WP-based Networks do the following: 

From the output of the scan you should see a line (or lines) like:

''ESSID: "NETWORK_NAME"''

Where NETWORK_NAME is the name of an available wireless network.

Now that you have your network name (and you know it's available) you can connect to that network with the command:

''iwconfig wlan0 essid NETWORK_NAME key WIRELESS_KEY''

Where NETWORK_NAME is the name of the network you want to connect to and WIRELESS_KEY is the security key for that network. NOTE: The iwconfig command defaults to HEX values for wireless keys. If you need to use ascii you have to prepend the "s" prefix to your key like so:

''iwconfig wlan0 essid NETWORK_NAME key s:WIRELESS_KEY''

With your connection made, you now have to get an IP address for your machine using the dhclient command like:

''dhclient wlan0''


For WPA-based networks you will need to spend some effort. Do the following:

1. Issue the command \\
''wpa_passphrase SSID PASSWORD''\\
(Where SSID is your network ID and PASSWORD is your wireless password). This will generate a psk string that you will use in the configuration file. Output is:
<code>
network={
	ssid="SSID"
	#psk="PASSWORD"
	psk=c2161655c6ba444d8df94cbbf4e9c5c4c61fc37702b9c66ed37aee1545a5a333
}
</code>

2. Edit the ''/etc/wpa_supplicant.conf'' file to reflect:

<code>
Network={ 
    ssid=SSID
    psk=PSK
}
</code>

Where SSID is the actual ID of your wireless network and PSK is the string generated by the wpa_passphrase command.

3. Run the wpa_supplicant daemon with the command:\\

''wpa_supplicant -B -i wlan0 -Dwext -c /etc/wpa_supplicant.conf''\\

Where ''wlan0'' is the name of your wireless interface.

4. Start the wlan0 again by
''ifup wlan0''
and you should get a similar output:
<code>
udhcpc (v1.22.1) started
Sending discover...
Sending discover...
Sending discover...
Sending select for 192.168.1.47...
Lease of 192.168.1.47 obtained, lease time 864000
/etc/udhcpc.d/50default: Adding DNS 192.168.1.1
</code>

5. Now make sure you are associated with your network with the command \\
''ifconfig wlan0''\\
(Where ''wlan0'' is the name of your wireless interface).

You should now be on the wireless network.
You can automate this by creating an entry in ''/etc/network/interfaces'' like this:

<code>
auto wlan0

iface wlan0 inet dhcp
	wireless_mode managed
	wireless_essid any
	wpa-driver wext
	wpa-conf /etc/wpa_supplicant.conf
</code>

Where INTERFACE is the name of your wireless interface.