initial web page
[libicd-wpa] / www / index.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"\r
2     "">\r
3 <html xmlns="">\r
4 <head>\r
5 <meta name="generator" content=\r
6 "HTML Tidy for Linux (vers 6 November 2007), see" />\r
7 <title>libicd-network-wpa</title></head>\r
8 <body>\r
9 <h1>libicd-network-wpa</h1>\r
10 <p>This is libicd-network-wpa, an experimental icd plugin that uses\r
11 wpa_supplicant to connect to (not only WPA) Wi-Fi access\r
12 points.</p>\r
13 <p>This is still an alpha, and probably it will ever remain as such\r
14 since I can't think of a better, cleaner way to do what it tries to\r
15 achieve, unless you add new hardware or drivers to the mix. So, I'm of course happy to accept patches or ideas. </p>\r
16 <p>The following assumes you have OS2008 and the Diablo SDK. </p>\r
17 <h2>Installation instructions</h2>\r
18 <p>My suggestion is that you clone the git repo (preferrably a <em>stable </em>tag), and read each of the following steps carefully: </p>\r
19 <h3>Modified cx3110</h3>\r
20 <p>This patch was not done by me (search maemo-developers list to find the author); I just adapted some of wireless extensions functions to match what the original libicd-network-wlan (which is closed source) expects. This allows both a patched wpa_supplicant and the standard Maemo utilities to <em>cooperate</em> on the same system, with nearly full functionality.</p>\r
21 <ol>\r
22   <li>Download source package cx3110-module-src and apply patch <em>patches/cx3110-module-src.</em></li>\r
23   <li>Build the module and test (rmmod cx3110; insmod /path/to/cx3110.ko; chroot /mnt/initfs wlan-cal). The device should still be able to connect to Wi-Fi networks. </li>\r
24   <li>If it works, you can move it to rootfs for it to be automatically loaded at boot time. </li>\r
25 </ol>\r
26 <h3>Modified wpasupplicant</h3>\r
27 <ol>\r
28   <li>Download source package wpasupplicant and apply patch <em>patches/wpasupplicant</em>.</li>\r
29   <li>Build the package and install it on the device. It should not (well, it can't) affect connectivity to Wi-Fi networks. </li>\r
30 </ol>\r
31 <h3>Modified wlancond</h3>\r
32 <p>This implements a special dumbed down mode in wlancond used by libicd-network-wpa. I don't know why I did this. Probably because I though I would get free powersaving and other nice features, but I didn't. So I guess a future version may remove this, or may not. Either way, for now, you'll need to patch. </p>\r
33 <ol>\r
34   <li>Download source package osso-wlan, and apply patch <em>patches/osso-wlan</em>.</li>\r
35   <li>Build the package and install.</li>\r
36   <li>Test it does not break Wi-Fi connectivity.</li>\r
37 </ol>\r
38 <h3>libicd-network-wpa itself</h3>\r
39 <p>The library should hopefully  build with a simple <em>make</em>. </p>\r
40 <h3>GConf settings</h3>\r
41 <p>TBD</p>\r
42 </body>\r
43 </html>\r