summaryrefslogtreecommitdiff
path: root/README
blob: ab8936a59bf40d14ea5311f61383e68974ab7971 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
at76c503 - linux driver for Atmel at76c503 based usb wlan adapters
------------------------------------------------------------------

This is a another driver for the Atmel based USB WLAN adaptors. I am
developing this driver in private. I am not associated with Atmel, or
any cooperation that builds devices with this chip. My only
information source is the driver from
http://atmelwlandriver.sourceforge.net.

Known devices with this chip are:
- Belkin F5D6050
- Dynalink/Askey WLL013
- Linksys WUSB11 v2.6
- Netgear MA101B

It is early in development. Currently, it has some limitations:

- to change the essid or channel, the network has to be restarted
  (with ifconfig)

If you are looking for a more complete driver, look at
http://atmelwlandriver.sourceforge.net.

Reqirements:
------------

- Kernel 2.4.x. I am developing the driver on 2.4.20, but it
  reportedly also works on 2.4.19, 2.4.18 and 2.4.16. I am not sure
  about 2.5.x.

Installation:
-------------

make
make install

Running:
--------

Plug in the adapter. If you already used it under Windows or with the
driver from atmelwlandriver.sourceforge.net, replug the device
(ie. plug out and in again).

If you have hotplug installed, the drivers should now be loaded. If not,
load them by hand:

modprobe -v at76c503-rfmd
or
insmod usbdfu.o; insmod at76c503.o; insmod at76c503-rfmd.o

You can give the network device another name than wlan by giving
the module the netdev_name parameter. Eg.
insmod at76c503-rfmd.o netdev_name=eth%d
would give the first device the name eth0, the second eth1 etc...

Check if the modules are loaded with lsmod. It should look like this:

...
at76c503-rfmd          38656   0  (unused)
at76c503               34004   0  [at76c503-rfmd]
usbdfu                  9144   0  [at76c503-rfmd]
...

setup networking (replace <iface> with wlan0, wlan1, ..., <ch> with a
channel number (1..14) <essid> with your network id (a string), <ip>
with an IP address)

iwconfig <iface> channel <ch> mode ad-hoc essid <essid>
ifonfig <iface> <ip> up

Example:
iwconfig wlan2 mode ad-hoc channel 10 essid okuwlan
ifconfig wlan2 192.168.3.1 up

Test it by pinging another host with a wlan adaptor.

To change a parameter with iwconfig, do:
ifconfig <iface> down
iwconfig ...
ifconfig <iface> up

Note that the firmware survives reboots of the computer, but not
unplugging the device.

If you get problems:
Look with dmesg, if there are error messages

Thanks to:
- the authors of the usbvnet driver (atmelwlandriver.sourceforge.net)
- Joerg Albert for lots of patches
- Brad Hards and Bas Vermeulen for the firmeware code, which I ported to kernel space
- David Gibson, I used his orinoco driver for learning
- the author(s) of the usbnet driver
- the author(s) of the rtl8150 driver
- lots of other authors of usb and wlan drivers, where I stole code from

Oliver Kurth <oku@masqmail.cx>, Mon,  6 Jan 2003 22:39:47 +0100