TI-Android-guide

TI-Android-ICS-PortingGuide

1

TI-Android-ICS-PortingGuide

This page is currently under construction. The content of this page is due to change quite frequently and thus the quality and accuracy are

not guaranteed until this message has been removed. Please feel free to contribute to this page while construction is in progress.

About this manual

The goal of Porting Guide is to provide valuable information and instructions to people who want to run Android OS

on their (new) HW. Information covered here will mainly be useful to port Android ICS DevKit Sitara-based

devices.

WiFi work in a custom Android build like Rowboat.

Features Overview

• WLAN (802.11 b/g/n)

• Core IP pre-tested against WiFi specifications.

• Station mode is fully supported.

• Initial support for SoftAP/WiFi hotspot and WiFi Direct is available

TI-Android-ICS-PortingGuide

2

Android WLAN Sub-System Overview

Diagram explains WLAN event flow from application to h/w with respect to rowboat android source tree.

Application

• Settings/Connection

• wpa_supplicant (Daemon):<android-src>/external/hostap/wpa_supplicant

• Higher level network management is done in <android-src>/frameworks/base/core/java/android/net.

TI-Android-ICS-PortingGuide

3

Driver Configuration

In this Devkit release we are using WL12XX Compat wireless SDK. The drivers and firmwares of WL12XX

Compat release are at hardware/ti/wlan

To enable WLAN support in kernel the following settings need to be enabled:

• First enable Wireless LAN device driver as shown below:

Device Drivers --->

[*] Network device support --->

[*] Wireless LAN --->

• Enable WLAN Networking support as shown below:

CONFIG_WEXT_CORE=y

CONFIG_WEXT_PROC=y

CONFIG_WEXT_PRIV=y

• The following additional options need to be enabled in kernel for WLAN to operate

CONFIG_KEYS=y

CONFIG_SECURITY=y

CONFIG_CRYPTO=y

CONFIG_CRYPTO_ARC4=y

CONFIG_CRYPTO_ECB=y

CONFIG_CRYPTO_AES=y

Android WiFi HAL Configuration

• Enable building of wpa_supplicant 0.8.x in your BoardConfig.mk (e.g. device/ti/am335xevm/BoardConfig.mk

for AM335xevm and device/ti/omap3evm/BoardConfig.mk for AM37xevm)

This is by simply adding following options in BoardConfig.mk:

BOARD_WPA_SUPPLICANT_DRIVER := NL80211

WPA_SUPPLICANT_VERSION := VER_0_8_X

BOARD_WLAN_DEVICE := wl12xx_mac80211

BOARD_SOFTAP_DEVICE := wl12xx_mac80211

BOARD_WPA_SUPPLICANT_PRIVATE_LIB := lib_driver_cmd_wl12xx

TI-Android-ICS-PortingGuide

4

WIFI_DRIVER_MODULE_PATH := "/system/lib/modules/wl12xx_sdio.ko"

• Set the correct permissions and paths created from init.rc

# give system access to wpa_supplicant.conf for backup and restore

mkdir /system/etc/wifi 0770 system wifi

chmod 0770 /system/etc/wifi

chmod 0660 /system/etc/wifi/wpa_supplicant.conf

chown system wifi /system/etc/wifi/wpa_supplicant.conf

mkdir /data/misc/wifi 0770 system wifi

mkdir /data/misc/wifi/sockets 0770 system wifi

chmod 0770 /data/misc/wifi

chmod 0660 /data/misc/wifi/wpa_supplicant.conf

• Set the wifi interface name in device.mk

PRODUCT_PROPERTY_OVERRIDES := \

wifi.interface=wlan0

• Start wpa_supplicant and dhcpcd from init.rc.

# wpa_supplicant and dhcp daemon

service wpa_supplicant /system/bin/wpa_supplicant -Dnl80211 -iwlan0

class main

socket wpa_wlan0 dgram 660 wifi wifi

disabled

oneshot

disabled

oneshot

The following entries are required to configure SoftAP/hotspot and WiFi Direct functions:

TI-Android-ICS-PortingGuide

5

• Register hostap service for SoftAP/hotspot:

service hostapd_bin /system/bin/hostapd -d /data/misc/wifi/hostapd.conf

socket wpa_wlan1 dgram 660 wifi wifi

disabled

oneshot

• Register dhcp hooks for WiFi Direct:

service dhcpcd_p2p /system/bin/dhcpcd -aABKL

disabled

Ensure that similar additions are done to support WiFi on your platform.

• Enable SoftAP commit

• Enable WiFi Direct commit