Gumstix User Wiki - User contributions [en]

Thin-firmware driver

2010-08-10T18:17:19Z

Derosier: Created page with "'''This page about the libertas_tf driver is a placeholder and will be filled out shortly''' == Thin-firmware Driver == === Driver === === Firmware === In order to use the thi…"

'''This page about the libertas_tf driver is a placeholder and will be filled out shortly'''

== Thin-firmware Driver ==

=== Driver ===

=== Firmware ===
In order to use the thin-firmware driver, you must have the right firmware. This can be downloaded from the [http://dev.laptop.org/pub/firmware/libertas/thinfirm/lbtf_sdio-9.0.7.p2.bin OLPC site].

The file needs to be placed in /lib/firmware/sd8686tf.bin and you may actually link /lib/firmware/sd8686.bin to it as the thin-firmware retains the full firmware features when used with the regular libertas driver.

Overo Wifi

2010-08-10T18:10:37Z

Derosier: /* Software */

[[Category:How_to_-_wifi]]
[http://www.gumstix.com/store/catalog/product_info.php?cPath=31&products_id=226 Overo Air] and [http://www.gumstix.com/store/catalog/product_info.php?cPath=31&products_id=227 Overo Fire] COMs have a 802.11(g) wireless module "on board". This page gives some details about the hardware and software configuration for this Wifi module.

=Hardware=

This section gives some infos about various hardware related topics regarding Overo Wifi.

==Module==

Overo Wifi solution is based on an [http://www.wi2wi.com/wireless.php Wi2Wi chip] based on Marvell's industry leading 88W8686 which brings 802.11(b/g) wifi.

==MMC==

Overo fire's WiFi port connected to MMC port '''2''' in 4 bit configuration.

==Connector and Antenna==

For 802.11b/g (Wifi) to work on an Overo Air COM or Overo Fire COM, a [http://www.gumstix.com/store/catalog/product_info.php?products_id=173 u.fl antenna] must be connected to '''J2''' on Overo Air or Fire COMs. The location of J2 is shown [http://www.gumstix.net/wiki/images/3/34/J2-J3.jpg here].

Note: J3 is the antenna location when using BlueTooth. J3 also takes a [http://www.gumstix.com/store/catalog/product_info.php?products_id=173 u.fl antenna].

Note that two (2) u.fl antennae come with each Overo Fire COM and with each Overo Air COM.

=Software=

Official Overo [http://www.gumstix.net/Setup-and-Programming/view/Overo-Setup-and-Programming/Downloading-pre-built-images/111.html pre-built Linux images] or [http://www.sakoman.com/feeds/omap3/glibc/images/overo/ developer images] contain already support for Overo Wifi. However, wifi configuration depending on your local wifi environment still has to be done.

There is also a [[thin-firmware driver]] and firmware that permit you to utilize the mac80211 drives in the Linux kernel. This is useful if you want to experiment with running an AP, 802.11s mesh, or other types of experiments on your Overo.

==Boot messages==

At Overo boot, you should get something like

...
libertas_sdio: Libertas SDIO driver
libertas_sdio: Copyright Pierre Ossman
libertas_sdio mmc1:0001:1: firmware: requesting sd8686_helper.bin
libertas_sdio mmc1:0001:1: firmware: requesting sd8686.bin
libertas: 00:19:88:05:b5:31, fw 9.70.3p24, cap 0x00000303
libertas: PREP_CMD: command 0x00a3 failed: 2
libertas: PREP_CMD: command 0x00a3 failed: 2
libertas: eth0: Marvell WLAN 802.11 adapter
...

Note: The two “command 0×00a3 failed” messages are harmless, and have to do with features that are not supported.

==Test==

For test of basic functionality, do the following at command line (after log in as root / no password):

root@overo:~# '''iwconfig wlan0 essid any'''
root@overo:~# '''ifconfig wlan0 up'''
root@overo:~# '''iwlist wlan0 scan'''

what should list the wifi's visible, then.

==Unencypted wifi==

Some default builds do not enable any Wifi. You may need to edit /etc/network/interfaces to include a section which looks like:
<pre>
allow-hotplug wlan0
auto wlan0
iface wlan0 inet dhcp
pre-up /sbin/iwconfig wlan0 essid any
wireless_mode managed
</pre>
The problem is this setup is not reliable! we're waiting for a solution.

==WEP encryption==

* Edit ''/etc/network/interfaces'' to have only for wlan0 (don't touch the other entries):

iwconfig wlan0 essid "My Wireless Network"
iwconfig wlan0 key my-hex-key
ifdown wlan0
ifup wlan0

==WPA encryption==

* Edit ''/etc/network/interfaces'' to have only for wlan0 (don't touch the other entries):

allow-hotplug wlan0
iface wlan0 inet dhcp
pre-up wpa_supplicant -Dwext -iwlan0 -c/etc/wpa_supplicant.conf -B
down killall wpa_supplicant

* Create ''/etc/wpa_supplicant.conf'' containing:

ctrl_interface=/var/run/wpa_supplicant
ctrl_interface_group=0
eapol_version=1
ap_scan=1
fast_reauth=1

network={
ssid="add-your-ascii-ssid"
proto=WPA2
key_mgmt=WPA-PSK
pairwise=CCMP TKIP
group=CCMP TKIP
scan_ssid=1
psk="add-your-ascii-passphrase"
priority=10
}

=Issues=

Many users have reported issues with wifi data throughput being [http://old.nabble.com/Overo-wifi-speed-and-WPA2-connection-issue-td27196711.html#a27231874 limited to about 100kB/second]. It is theorized this is due to lack of SDIO IRQ support in the OMAP3 MMC driver. A patch is being investigated which reportedly [http://marc.info/?l=linux-omap&m=126140067103975&w=2 achieves 13Mbps].

Additionally, the driver does not support power management at present. The use of iwconfig power commands such as the following will fail:
<pre>
iwconfig wlan0 power on
</pre>
Therefore, the wifi module always consumes close to 1 Watt of power when turned on.

=Links=

* [http://bec-systems.com/site/387/wi2wi-wifi-bt-module-review Wi2Wi W2CBW003 Wifi/Bluetooth module review]

Overo Wifi

2010-08-10T18:09:48Z

Derosier: Adding information about thin firmware driver

[[Category:How_to_-_wifi]]
[http://www.gumstix.com/store/catalog/product_info.php?cPath=31&products_id=226 Overo Air] and [http://www.gumstix.com/store/catalog/product_info.php?cPath=31&products_id=227 Overo Fire] COMs have a 802.11(g) wireless module "on board". This page gives some details about the hardware and software configuration for this Wifi module.

=Hardware=

This section gives some infos about various hardware related topics regarding Overo Wifi.

==Module==

Overo Wifi solution is based on an [http://www.wi2wi.com/wireless.php Wi2Wi chip] based on Marvell's industry leading 88W8686 which brings 802.11(b/g) wifi.

==MMC==

Overo fire's WiFi port connected to MMC port '''2''' in 4 bit configuration.

==Connector and Antenna==

For 802.11b/g (Wifi) to work on an Overo Air COM or Overo Fire COM, a [http://www.gumstix.com/store/catalog/product_info.php?products_id=173 u.fl antenna] must be connected to '''J2''' on Overo Air or Fire COMs. The location of J2 is shown [http://www.gumstix.net/wiki/images/3/34/J2-J3.jpg here].

Note: J3 is the antenna location when using BlueTooth. J3 also takes a [http://www.gumstix.com/store/catalog/product_info.php?products_id=173 u.fl antenna].

Note that two (2) u.fl antennae come with each Overo Fire COM and with each Overo Air COM.

=Software=

Official Overo [http://www.gumstix.net/Setup-and-Programming/view/Overo-Setup-and-Programming/Downloading-pre-built-images/111.html pre-built Linux images] or [http://www.sakoman.com/feeds/omap3/glibc/images/overo/ developer images] contain already support for Overo Wifi. However, wifi configuration depending on your local wifi environment still has to be done.

There is also a [thin-firmware driver] and firmware that permit you to utilize the mac80211 drives in the Linux kernel. This is useful if you want to experiment with running an AP, 802.11s mesh, or other types of experiments on your Overo.

==Boot messages==

At Overo boot, you should get something like

...
libertas_sdio: Libertas SDIO driver
libertas_sdio: Copyright Pierre Ossman
libertas_sdio mmc1:0001:1: firmware: requesting sd8686_helper.bin
libertas_sdio mmc1:0001:1: firmware: requesting sd8686.bin
libertas: 00:19:88:05:b5:31, fw 9.70.3p24, cap 0x00000303
libertas: PREP_CMD: command 0x00a3 failed: 2
libertas: PREP_CMD: command 0x00a3 failed: 2
libertas: eth0: Marvell WLAN 802.11 adapter
...

Note: The two “command 0×00a3 failed” messages are harmless, and have to do with features that are not supported.

==Test==

For test of basic functionality, do the following at command line (after log in as root / no password):

root@overo:~# '''iwconfig wlan0 essid any'''
root@overo:~# '''ifconfig wlan0 up'''
root@overo:~# '''iwlist wlan0 scan'''

what should list the wifi's visible, then.

==Unencypted wifi==

Some default builds do not enable any Wifi. You may need to edit /etc/network/interfaces to include a section which looks like:
<pre>
allow-hotplug wlan0
auto wlan0
iface wlan0 inet dhcp
pre-up /sbin/iwconfig wlan0 essid any
wireless_mode managed
</pre>
The problem is this setup is not reliable! we're waiting for a solution.

==WEP encryption==

* Edit ''/etc/network/interfaces'' to have only for wlan0 (don't touch the other entries):

iwconfig wlan0 essid "My Wireless Network"
iwconfig wlan0 key my-hex-key
ifdown wlan0
ifup wlan0

==WPA encryption==

* Edit ''/etc/network/interfaces'' to have only for wlan0 (don't touch the other entries):

allow-hotplug wlan0
iface wlan0 inet dhcp
pre-up wpa_supplicant -Dwext -iwlan0 -c/etc/wpa_supplicant.conf -B
down killall wpa_supplicant

* Create ''/etc/wpa_supplicant.conf'' containing:

ctrl_interface=/var/run/wpa_supplicant
ctrl_interface_group=0
eapol_version=1
ap_scan=1
fast_reauth=1

network={
ssid="add-your-ascii-ssid"
proto=WPA2
key_mgmt=WPA-PSK
pairwise=CCMP TKIP
group=CCMP TKIP
scan_ssid=1
psk="add-your-ascii-passphrase"
priority=10
}

=Issues=

Many users have reported issues with wifi data throughput being [http://old.nabble.com/Overo-wifi-speed-and-WPA2-connection-issue-td27196711.html#a27231874 limited to about 100kB/second]. It is theorized this is due to lack of SDIO IRQ support in the OMAP3 MMC driver. A patch is being investigated which reportedly [http://marc.info/?l=linux-omap&m=126140067103975&w=2 achieves 13Mbps].

Additionally, the driver does not support power management at present. The use of iwconfig power commands such as the following will fail:
<pre>
iwconfig wlan0 power on
</pre>
Therefore, the wifi module always consumes close to 1 Watt of power when turned on.

=Links=

* [http://bec-systems.com/site/387/wi2wi-wifi-bt-module-review Wi2Wi W2CBW003 Wifi/Bluetooth module review]