stlc45xx README
Kalle Valo <kalle.valo@nokia.com>

----------------------------------------------------------------------
This is stlc45xx, a mac80211 driver for stlc4550 and stlc4560 WLAN
chips used, for example, in Nokia N800 and N810. This is very much
work in progress and contains a lot of bugs.

----------------------------------------------------------------------

1. Getting linux-omap tree

* Clone latest linux-omap tree:

$ git clone git://git.kernel.org/pub/scm/linux/kernel/git/tmlind/linux-omap-2.6.git
	
2. Kernel configuration

$ make n800_defconfig

Also enable mac80211 with 'make menuconfig'.

3. Compiling

* Compile kernel:
	
$ make

* Compile stlc45xx:
$ make KERNEL_SRC_DIR=../linux-omap-2.6

* Before flashing kernel to device, you should disable three daemons
	Nokia-N810$> update-rc.d -f dsp-init remove
	Nokia-N810$> update-rc.d -f multimediad remove
	Nokia-N810$> update-rc.d -f esd remove

* Enable necessary R&D flags:

$ flasher --set-rd-flags=no-omap-wd,no-retu-wd,no-lifeguard-reset

* Flash kernel:

$ flasher -k arch/arm/boot/zImage -f

4. Setting up usb-network

* Reboot device.

* Enable usb networking:

$ insmod g_ether.ko (you might need to do this twice)
$ ifconfig usb0 10.1.1.11 up
$ ifconfig usb0 10.1.1.10 up

* Setting usb0 to start automatically:

	- copy usbnet script to device's /etc/init.d/ directory (see appendix A)
	- add execution bit for usbnet (chmod +x /etc/init.d/usbnet)
	- set usbnet start at runlevel 2 (update-rc.d usbnet start 99 2)
	- device: add following lines to /etc/network/interface
		allow-hotplug usb0
		iface usb0 inet static
        	address 10.1.1.11
        	netmask 255.255.255.0
        	broadcast 10.1.1.255
	- desktop: add following lines to /etc/network/interface
		allow-hotplug usb0
		iface usb0 inet static
        	address 10.1.1.10
        	netmask 255.255.255.0
        	broadcast 10.1.1.255
	- Add following line to your desktop's /etc/hosts file
		10.1.1.11 n8x0

* Restart device. After restarting you should be able to log in via
  ssh (ssh root@n8x0). Unplug-plug usb cable might needed.
 
5. Setting up stlc45xx module

* Copy stlc45xx.ko and stlc45xx-cal from your desktop to the device.

* Disable automatic WLAN connections from Control Panel or shutdown
  wlancond (/etc/init.d/wlancond stop)

* Unload cx3110x driver from memory (rmmod cx3110x).

* Load mac80211.ko and stlc45xx.ko modules and run stlc45xx-cal:

$ cp stlc45xx-cal /mnt/initfs/tmp/ & chroot /mnt/initfs /tmp/stlc45xx-cal)

Now wlan0 interface is ready to run. Use iwconfig, wpa_supplicant or
whatever you intent to use.

6.1. How roll back to default settings, option 1:

* Just flash the full release you want to use:
$ flasher -F latest_release.bin -f -R

6.2. How roll back to default settings, option 2:

* Enable disabled daemons:

$ update-rc.d dsp-init start 24 2
$ update-rc.d multimediad start 24 2
$ update-rc.d esd start 26 2

* Disable usbnet if you find it necessary (if you want use device's
  memory via USB):

$ update-rc.d -f usbnet remove

* Disable some RD flags

$ flasher --clear-rd-flags=no-omap-wd,no-retu-wd,no-lifeguard-reset

* Flash latest released kernel and initfs:

$ flasher -F latest_release.bin --flash-only kernel,initfs -f -R

7. NOTES:

* MMC do not work
* DSP do not work
* SPI have some bugs, packet loss in SPI bus


Appendix A

filename usbnet
#! /bin/sh
#
# Startup script for USBnet (networking, instead of USB Mass Storage behaviour)
# Author: Michael Mlivoncic

PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
NAME=usbnet
DESC="USB Networking for Nokia 770"
INITFILE=/etc/init.d/$NAME

case "$1" in
start)
		umount /media/mmc1
		umount /media/mmc2
		sleep 2
		USBNET="`lsmod | grep g_ether`"
		KERNEL_VERSION="`uname -r`"
		if [ "$USBNET" = "" ]
		then
		echo "entering Ethernet via USB mode (g_ether)..."
		insmod /mnt/initfs/lib/modules/$KERNEL_VERSION/g_ether.ko
		if [ "$?" != "0" ]; then
			insmod /mnt/initfs/lib/modules/$KERNEL_VERSION/g_ether.ko
		fi
		echo "waiting, then starting up the usb0.."
		sleep 1
		/sbin/ifup usb0
		else
		echo "already in Ethernet-via-USB mode..."
		echo "try ping 192.168.2.15"
		fi
		;;
stop)
		echo "switching back to USB Mass Storage mode..."
		echo "removing module g_ether"
		/sbin/ifdown usb0
		sleep 2
		rmmod g_ether
		;;
*)
		printf "Usage: $INITFILE {start|stop}\n" >&2
		exit 1
		;;
esac

exit 0

Appendix B

Wpa_supplican usage: wpa_supplicant -D wext -i wlan0 -c config_file
optional flags:
-d show debug messages, -dd even more
-B daemonize wpa_supplicant

Example wpa_supplicant configurations:

#OPEN
network={
	ssid="open_ssid"
	key_mgmt=NONE
       }

#WEP
network={
	ssid="test1"
	key_mgmt=NONE
	wep_key0=acdc123456
	wep_tx_keyidx=0
       }

#WPA(1&2) Personal
network={
	ssid="test2"
	proto=WPA RSN
	key_mgmt=WPA-PSK
	group=CCMP TKIP WEP104 WEP40
	pairwise=CCMP TKIP
	#psk="acdc123456"
	psk=bf91ce371ac1eb3617b1f59be5339658c7ea44bf23071bcdd59bbd16d03f2c9f
       }

#WPA Enterprise
network={
	ssid="test3"
	proto=WPA
	key_mgmt=WPA-EAP
	pairwise=TKIP
	identity="test"
	password="test123"	
	}