Mac80211 based open source architecture
From OMAPpedia
| Line 135: | Line 135: | ||
wlan device ethernet | wlan device ethernet | ||
--------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- | ||
| - | 10.0.0.1 Panda 192.168.1.118 <===========> | + | 10.0.0.1 Panda 192.168.1.118 <===========> connected to your network 192.168.1.* |
/\ (As Soft AP) | /\ (As Soft AP) | ||
|| | || | ||
| Line 146: | Line 146: | ||
--------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- | ||
| - | ==== | + | ====Modifications On Soft AP end:==== |
1.Before boot up of Panda used as SoftAP, uncomment '''net.ipv4.ip_forward=1''' in '''/etc/systcl.conf''' file | 1.Before boot up of Panda used as SoftAP, uncomment '''net.ipv4.ip_forward=1''' in '''/etc/systcl.conf''' file | ||
| Line 187: | Line 187: | ||
Location: http://www.google.co.in/ [following] | Location: http://www.google.co.in/ [following] | ||
--2011-08-03 15:04:15-- http://www.google.co.in/ | --2011-08-03 15:04:15-- http://www.google.co.in/ | ||
| - | Connecting to | + | Connecting to xyzproxy.ti.com|10.5.7.45|:80... connected. |
Proxy request sent, awaiting response... 200 OK | Proxy request sent, awaiting response... 200 OK | ||
Length: unspecified [text/html] | Length: unspecified [text/html] | ||
| Line 196: | Line 196: | ||
2011-08-03 15:04:16 (297 KB/s) - `index.html' saved [10735] | 2011-08-03 15:04:16 (297 KB/s) - `index.html' saved [10735] | ||
| - | ==== | + | ====Modifications On Station end:==== |
1. Start wlan in Station mode and try to connect to the SoftAP. | 1. Start wlan in Station mode and try to connect to the SoftAP. | ||
| - | NOTE: MAC address of wlan interface on | + | NOTE: MAC address of wlan interface on Station and SoftAP must be different for successful connection |
root@ubuntu-desktop:/mac802# '''ifconfig wlan0''' | root@ubuntu-desktop:/mac802# '''ifconfig wlan0''' | ||
wlan0 Link encap:Ethernet HWaddr '''de:ad:be:ef:00:00''' | wlan0 Link encap:Ethernet HWaddr '''de:ad:be:ef:00:00''' | ||
| Line 217: | Line 217: | ||
| - | 2. After successful connection, Add a route so that | + | 2. After successful connection, Add a route so that everything is routed via wlan interface ( gateway = ip address of wlan interface on SoftAP end) |
'''route add -net 0.0.0.0 netmask 0.0.0.0 gw 10.0.0.1''' | '''route add -net 0.0.0.0 netmask 0.0.0.0 gw 10.0.0.1''' | ||
| Line 228: | Line 228: | ||
default ubuntu-laptop.l 0.0.0.0 UG 0 0 0 wlan0 | default ubuntu-laptop.l 0.0.0.0 UG 0 0 0 wlan0 | ||
| - | '''Check whether you can ping to | + | '''Check whether you can ping to Ethernet interface of SoftAP from Station''' |
root@ubuntu-desktop:/mac802# '''ping 192.168.1.118''' | root@ubuntu-desktop:/mac802# '''ping 192.168.1.118''' | ||
PING 192.168.1.118 (192.168.1.118) 56(84) bytes of data. | PING 192.168.1.118 (192.168.1.118) 56(84) bytes of data. | ||
| Line 238: | Line 238: | ||
rtt min/avg/max/mdev = 12.512/15.121/17.731/2.612 ms | rtt min/avg/max/mdev = 12.512/15.121/17.731/2.612 ms | ||
| - | '''Check whether you can ping to any other | + | '''Check whether you can ping to any other device of your network from Station''' |
root@ubuntu-desktop:/mac802# '''ping 192.168.1.184''' | root@ubuntu-desktop:/mac802# '''ping 192.168.1.184''' | ||
PING 192.168.1.184 (192.168.1.184) 56(84) bytes of data. | PING 192.168.1.184 (192.168.1.184) 56(84) bytes of data. | ||
| Line 259: | Line 259: | ||
Location: http://www.google.co.in/ [following] | Location: http://www.google.co.in/ [following] | ||
--2011-08-03 15:04:16-- http://www.google.co.in/ | --2011-08-03 15:04:16-- http://www.google.co.in/ | ||
| - | Connecting to | + | Connecting to xyzproxy.com|10.5.7.45|:80... connected. |
Proxy request sent, awaiting response... 200 OK | Proxy request sent, awaiting response... 200 OK | ||
Length: unspecified [text/html] | Length: unspecified [text/html] | ||
Revision as of 10:28, 10 August 2011
Contents
|
mac80211 based WLAN driver: Description
As of April 2011, Linux 2.6.39 RC1 kernel supports WLAN in the 'station mode.' Soft access point (SoftAP) feature is going to be supported from Linux kernel 39 onwards. Alternatively, you can apply just the wireless patches to your present kernel. To do so, you can use compact wireless wl12xx.git to pull the SoftAP patches; and then apply them to your kernel code.
Procedure to build WLAN and test on Ubuntu FS
To enable WLAN on the Panda Board Linux Kernel
- Changes in the Linux Configuration for Kernel Building:
- Enable WLAN on Panda Board in the kernel configuration menu:
Device Drivers --->
[*] Network device support --->
[*] Wireless LAN --->
<M> TI wl12xx driver support --->
<M> TI wl12xx support
<M> TI wl12xx SDIO support
- Enable "nl80211 testmode command" in kernel configuration to use iw tool (needed only if you want use iw)
[*] Networking support --->
--- Wireless
<M> cfg80211 - wireless configuration API
[*] nl80211 testmode command
- Build the uImage and modules and copy them to the Filesystem
make ARCH=arm CROSS_COMPILE=arm-none-linux-gnueabi- uImage make ARCH=arm CROSS_COMPILE=arm-none-linux-gnueabi- modules make ARCH=arm CROSS_COMPILE=arm-none-linux-gnueabi- INSTALL_MOD_PATH=<PATH_TO_FS> modules_install
Firmware and NVS for the WLAN
- Clone the git tree : git.kernel.org/pub/scm/linux/kernel/git/dwmw2/linux-firmware.git
git clone git.kernel.org/pub/scm/linux/kernel/git/dwmw2/linux-firmware.git
- Copy the contents of "ti-connectivity" folder to /lib/firmware/ folder of the filesystem.
Firmware and NVS for station: wl1271-fw.bin & wl1271-nvs.bin Firmware and NVS for SoftAP: wl1271-fw-ap.bin & wl1271-nvs-ap.bin
Testing WLAN in Station mode
TI WLAN interface name will show up as: "wlan0"
To load WLAN modules
Check the list of modules loaded by using:
lsmod
The modules required are: wl12xx.ko and wl12xx_sdio.ko.
If they are not present, load them:
insmod /lib/modules/`uname -r`/kernel/net/wireless/cfg80211.ko insmod /lib/modules/`uname -r`/kernel/net/mac80211/mac80211.ko insmod /lib/modules/`uname -r`/kernel/drivers/net/wireless/wl12xx/wl12xx.ko insmod /lib/modules/`uname -r`/kernel/drivers/net/wireless/wl12xx/wl12xx_sdio.ko
To verify the drivers loaded successfully:
tail -3 /var/log/kern.log
The expected (typical) output is:
cfg80211: Calling CRDA to update world regulatory domain wl1271: loaded wl1271: initialized
To bring WLAN interface UP
To list all the interfaces that are up:
ifconfig
If the interface is not listed, check all the interfaces available:
ifconfig -a
Check whether wlan0 has a valid MAC address. If not assign it:
ifconfig wlan0 hw ether 00:22:33:44:55:66
Bring up the interface:
ifconfig wlan0 up
To verify the drivers loaded successfully:
tail -1 /var/log/kern.log
The expected (typical) output is:
wl1271: firmware booted (Rev 6.1.0.0.343)
To Connect or Disconnect to an AP
Use "iwlist" or "iw" to scan.
iwlist wlan0 scan
or
iw dev wlan0 scan
Connect to an AP listed in open mode:
iwconfig wlan0 essid "AP_NAME"
or
iw wlan0 connect AP_NAME
If AP has the DHCP capability, get the IP address:
dhclient wlan0
or assign it using:
ifconfig wlan0 xx.xx.xx.xx netmask 255.255.255.0
To disconnect from the AP:
iw dev wlan0 disconnect
Testing WLAN in SoftAP mode
Install hostapd and udhcpd packages in the filesystem ,if they are not present.
To install hostapd and udhpcd:
sudo apt-get install hostapd
sudo apt-get install udhcpd
Download SoftAP.tar.gz to the Filesystem and untar it.
mkdir /SoftAP cd /SoftAP tar xvzf SoftAP.tar.gz cp udhcpd.conf /etc/. sudo chmod 755 ap.sh
To bring up WLAN in AP mode:
If it is in station mode, stop wpa_supplicant ./ap.sh sta_stop Now start WLAN in SoftAP mode ./ap.sh ap
The expected (typical) output is:
Starting AP Configuration file: /tmp/hostapd.ap.conf Using interface wlan0 with hwaddr de:ad:be:ef:00:00 and ssid 'blazetest' Could not set DTIM period for kernel driver Starting DHCP server AP start complete
To list all the stations connected to our SoftAP:
hostapd_cli all_sta
To stop WLAN in SoftAP mode:
./ap.sh ap_stop
NOTE: The default configuration of hostapd using the ap.sh is:
Interface: wlan0 BSSID : blazetest Security : WPA2-AES Password : password Ip address: 10.0.0.1
To change Security mode of SoftAP
Change the function generate-hostapd() in ap.sh file accordingly. Refer hospad.conf file for all parameters.
To enable browsing on station when connected to SoftAP
Example Setup
wlan device ethernet
---------------------------------------------------------------------------------
10.0.0.1 Panda 192.168.1.118 <===========> connected to your network 192.168.1.*
/\ (As Soft AP)
||
||
||
||
\/
10.0.0.20 Panda not used
(as Station)
---------------------------------------------------------------------------------
Modifications On Soft AP end:
1.Before boot up of Panda used as SoftAP, uncomment net.ipv4.ip_forward=1 in /etc/systcl.conf file
2.Start the wlan in SoftAP mode
3.Change wlan0 subnet mask form 255.0.0.0 to 255.255.255.0
ifconfig wlan0 netmask 255.255.255.0
4. Copy the following script as nat_start to the Filesystem and execute it.
echo "Stopping firewall and allowing everyone..." iptables -F iptables -X iptables -t nat -F iptables -t nat -X iptables -t mangle -F iptables -t mangle -X iptables -P INPUT ACCEPT iptables -P FORWARD ACCEPT iptables -P OUTPUT ACCEPT echo "Enabling SNAT (MASQUERADE) functionality on eth0" iptables -t nat -A POSTROUTING -o eth0 -s 10.0.0.0/24 -j MASQUERADE iptables -A FORWARD -s 10.0.0.0/8 -d 0/0 -j ACCEPT
chmod 755 nat_start ./nat_start
The expected (typical) output is:
Stopping firewall and allowing everyone... Enabling SNAT (MASQUERADE) functionality on eth0
5. Now cross check whether SoftAP is able to browse a page or not
wget http://www.google.com
The example output is:
--2011-08-03 15:04:15-- http://www.google.com/ Resolving xyzproxy.com... 10.5.7.45 Connecting to xyzproxy.com|10.5.7.45|:80... connected. Proxy request sent, awaiting response... 302 Found Location: http://www.google.co.in/ [following] --2011-08-03 15:04:15-- http://www.google.co.in/ Connecting to xyzproxy.ti.com|10.5.7.45|:80... connected. Proxy request sent, awaiting response... 200 OK Length: unspecified [text/html] Saving to: `index.html' [ <=> ] 10,735 --.-K/s in 0.04s 2011-08-03 15:04:16 (297 KB/s) - `index.html' saved [10735]
Modifications On Station end:
1. Start wlan in Station mode and try to connect to the SoftAP.
NOTE: MAC address of wlan interface on Station and SoftAP must be different for successful connection
root@ubuntu-desktop:/mac802# ifconfig wlan0
wlan0 Link encap:Ethernet HWaddr de:ad:be:ef:00:00
UP BROADCAST MULTICAST MTU:1500 Metric:1
RX packets:359 errors:0 dropped:0 overruns:0 frame:0
TX packets:205 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:85062 (85.0 KB) TX bytes:29082 (29.0 KB)
IF they are same change, change it on station using the following commands and then try to connect
service network-manager stop killall wpa_supplicant ifconfig wlan0 hw ether 00:22:33:44:55:66 wpa_supplicant -Dnl80211 -iwlan0 -C/var/run -u & service network-manager start
2. After successful connection, Add a route so that everything is routed via wlan interface ( gateway = ip address of wlan interface on SoftAP end)
route add -net 0.0.0.0 netmask 0.0.0.0 gw 10.0.0.1
Check whether route is added or not
root@ubuntu-desktop:/mac802# route add -net 0.0.0.0 netmask 0.0.0.0 gw 10.0.0.1 root@ubuntu-desktop:/mac802# route Kernel IP routing table Destination Gateway Genmask Flags Metric Ref Use Iface 10.0.0.0 * 255.255.255.0 U 0 0 0 wlan0 default ubuntu-laptop.l 0.0.0.0 UG 0 0 0 wlan0 Check whether you can ping to Ethernet interface of SoftAP from Station root@ubuntu-desktop:/mac802# ping 192.168.1.118 PING 192.168.1.118 (192.168.1.118) 56(84) bytes of data. 64 bytes from 192.168.1.118: icmp_req=1 ttl=64 time=17.7 ms 64 bytes from 192.168.1.118: icmp_req=2 ttl=64 time=12.5 ms ^C --- 192.168.220.118 ping statistics --- 2 packets transmitted, 2 received, 0% packet loss, time 1001ms rtt min/avg/max/mdev = 12.512/15.121/17.731/2.612 ms Check whether you can ping to any other device of your network from Station root@ubuntu-desktop:/mac802# ping 192.168.1.184 PING 192.168.1.184 (192.168.1.184) 56(84) bytes of data. 64 bytes from 192.168.1.184: icmp_req=1 ttl=63 time=21.4 ms 64 bytes from 192.168.1.184: icmp_req=2 ttl=63 time=12.8 ms ^C --- 192.168.220.184 ping statistics --- 2 packets transmitted, 2 received, 0% packet loss, time 1002ms rtt min/avg/max/mdev = 12.878/17.165/21.453/4.289 ms
3. Now Copy /etc/resolv.conf of SoftAP to the station and we can download the webpage on Station also
4. Now cross check whether station is able to browse a page or not
wget http://www.google.com
The example output is:
--2011-08-03 15:04:16-- http://www.google.com/ Resolving xyzproxy.com... 10.5.7.45 Connecting to xyzproxy.com|10.5.7.45|:80... connected. Proxy request sent, awaiting response... 302 Found Location: http://www.google.co.in/ [following] --2011-08-03 15:04:16-- http://www.google.co.in/ Connecting to xyzproxy.com|10.5.7.45|:80... connected. Proxy request sent, awaiting response... 200 OK Length: unspecified [text/html] Saving to: `index.html' [ <=> ] 10,735 --.-K/s in 0.04s 2011-08-03 15:04:16 (297 KB/s) - `index.html' saved [10735]
To connect to a secured AP use wpa_supplicant
1. First kill the supplicant if it is present:
sudo su service network-manager stop killall wpa_supplicant
2. Start with the following options:
wpa_supplicant -Dwext -iwlan0 -C/var/run -u &
or
wpa_supplicant -Dnl80211 -iwlan0 -C/var/run -u &
3. Use wpa_cli to connect to any network( open or secured)
wpa_cli -p/var/run
No security (OPEN)
To connect to an AP without security:
add_network set_network 0 ssid "name of AP" set_network 0 key_mgmt NONE enable_network 0
With WEP security
To connect to an AP with WEP security:
add_network set_network 0 ssid "name of AP" set_network 0 key_mgmt NONE set_network 0 wep_key0 <key> enable_network 0
NOTE: WEP key must be 10 or 26 characters long according to whether it is WEP40 or WEP128 respectively.
With WPA-TKIP security
To connect to an AP with WPA1 security:
add_network set_network 0 ssid "name of AP" set_network 0 key_mgmt WPA-PSK set_network 0 pairwise TKIP set_network 0 psk "key" enable_network 0
With WPA-AES-CCMP security
To connect to an AP with WPA2 security:
add_network set_network 0 ssid "name of AP" set_network 0 key_mgmt WPA-PSK set_network 0 pairwise CCMP set_network 0 psk "key" enable_network 0
Useful Links
Mainline kernel:
- git clone git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux-2.6.git
Luca kernel:
- git clone git://git.kernel.org/pub/scm/linux/kernel/git/luca/wl12xx.git
Linux Firmware:
- git clone git://git.kernel.org/pub/scm/linux/kernel/git/dwmw2/linux-firmware.git
Ti-Utils:
- git clone git://github.com/gxk/ti-utils.git
iw tool:
- git clone git://git.sipsolutions.net/iw.git
latest wpa_supplicant & hostap:
- git clone git://w1.fi/srv/git/hostap.git
Patches required to add WLAN support on the Panda Board (Linux Kernel version <= 2.6.38)
- Patch series required to enable WLAN on Panda are at Panda: Support for WLAN on WL127x
- Make sure you have the dependent patches for WLAN clock and HWMOD changes for MMC.
- For original patches (of adoptation for HSMMC refer to): OMAP: HSMMC: HWMOD adaptation
Back to Connectivity Home Page