Cleanup
[ikiwiki.git] / docs / howtos / HowToSetUpIpw2200.mdwn
1 "Index"
2
3 [[!toc  levels=3]]
4
5 # Preamble 
6
7 This document is written by a DragonFlyBSD newbie for other newbies, so there may be a better way to setup the ipw2200 wlan adapter. It was tested on a Asus V6800 notebook, but hopefully it should apply to all notebooks with ipw2200 adapters. WPA encryption is not available now (April 2006), and I wasn't unable to get my wlan adapter to establish a WEP connection, so I have only an unprotected WIFI connection, but that may be a problem with my notebook or my router.
8
9
10
11 # Prerequisites 
12
13 You need two things to setup your ipw2200 adapter:
14
15
16 * the if_iwi kernel modules for DragonFlyBSD
17
18 * the firmware for your ipw2200 wlan adapter
19
20
21
22 # Loading the if_iwi kernel module 
23
24 If you've done a fresh install of DragonFlyBSD, the kernel module should already be "ready to use". This is how you can load it:
25
26       # kldload if_iwi 
27     
28     If you don't get an error message, the necessary module is loaded now. If you get this message:
29     
30       kldload: can't load if_iwi: File exists
31     
32     this is ok, too. It means, that the module has already been loaded for you. BTW: you can check, if it's already loaded with this command:
33     
34       # kldstat | grep if_iwi 
35     
36     This should return something similar to this, if the module is loaded:
37     
38       6    1 0xc0759000 c2c8     if_iwi.ko
39     
40     If you don't have the kernel module available, you must build a new kernel. You can find the necessary information to do that in the ["DragonFlyBSD Handbook, chapter 9"](http://leaf.dragonflybsd.org/~justin/handbook/kernelconfig.htm) : (http://leaf.dragonflybsd.org/~justin/handbook/kernelconfig.html) .
41     
42     Later, you can automate loading of the kernel driver by using the /boot/loader.conf file.
43     
44     # Getting the firmware 
45     
46     If you've already set up the pkgsrc system on your machine, you can install it by
47     
48         
49       # cd /usr/pkgsrc/sysutils/iwi-firmware
50       # make install clean
51
52
53 and continue reading at the next section ("Loading the firmware").
54
55 Otherwise, you can  ["download it from" ](http://damien.bergamini.free.fr/iwifw/ipw2200-fw-2.3.tgz) (http://damien.bergamini.free.fr/iwifw/ipw2200-fw-2.3.tgz) and extract to a new directory, e. g. /usr/libdata/iwi_firmware:
56
57     
58       # mkdir /tmp/firmware
59       # cd /tmp/firmware
60       # fetch http://damien.bergamini.free.fr/iwifw/ipw2200-fw-2.3.tgz
61       # tar xvfz ipw2200-fw-2.3.tgz
62       # mkdir /usr/libdata/if_iwi
63       # mv *fw  /usr/libdata/if_iwi
64       # cd ..
65       # rm -fd firmware
66
67
68 Unfortunately, you must rename the files:
69
70     
71       # cd /usr/libdata/if_iwi
72       # mv ipw-2.3-ibss_ucode.fw iwi-ucode-ibss.fw
73       # mv ipw-2.3-sniffer.fw iwi-sniffer.fw
74       # mv ipw-2.3-boot.fw iwi-boot.fw
75       # mv ipw-2.3-bss.fw iwi-bss.fw
76       # mv ipw-2.3-sniffer_ucode.fw iwi-ucode-sniffer.fw
77       # mv ipw-2.3-bss_ucode.fw iwi-ucode-bss.fw
78       # mv ipw-2.3-ibss.fw iwi-ibss.fw
79
80
81 # Loading the firmware 
82
83 Now, you can load the firmware:
84
85     
86       # iwicontrol iwi0 -d /usr/libdata/if_iwi
87
88
89
90 # Configuring the WLAN interface 
91
92 Now, you can configure your ipw2200 adapter.
93
94 First example: without WPA and WEP
95
96     
97       # ifconfig iwi0 inet <ip-address> netmask <netmask> ssid <myssid> wepmode off
98
99 Second example: with WEP
100
101     
102       # ifconfig iwi0 inet <ip-address> netmask <netmask> ssid <myssid> wepmode on wepkey <mywepkey>
103
104
105 (example for a 104/128 bit wepkey hex value: 0xf6fa1c61abc3ca5a3787fdaeae)
106
107 Check your success (example):
108
109     
110       # ifconfig iwi0
111       iwi0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> mtu 1500
112            inet 192.168.2.101 netmask 0xffffff00 broadcast 192.168.2.255
113            inet6 fe80::212:f0ff:fe07:f5c8%iwi0 prefixlen 64 scopeid 0x3
114            ether 00:12:f0:07:f5:c8
115            media: IEEE 802.11 Wireless Ethernet autoselect (OFDM/54Mbps)
116            status: associated
117            ssid catalan 1:catalan
118            channel 6 authmode OPEN powersavemode OFF powersavesleep 100
119            rtsthreshold 2312 protmode CTS txpower 100
120            wepmode OFF weptxkey 1
121
122
123 We have the IP-address 192.168.2.101 with netmask 255.255.255.0 (0xffffff00), and are connected ("associated") to an access point with the name "catalan". We don't use WEP (wepmode OFF) here.
124
125
126 As said at the beginning, I wasn't able to connect to my router/AP with WEP enabled, but it should work (tm). I was only able to make a connection with enabled SSID broadcast, but may be you'll have more luck ;-)