Documentation/Ovislink-HOWTO.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2
   3 <HTML>
   4     <HEAD>
   5         <META http-equiv="Content-Type" content="text/html; charset=utf-8">
   6         <META name="GENERATOR" content="vim">
   7         <META name="PUBLISHER" content="Wolfgang Fuschlberger">
   8         <META name="LANGUAGE" content="en">
   9         <META name="KEYWORDS" content="wireless, lan, wlan, ovislink, pcmcia, access, point, linux, wep, encryption, radio, wlan-ng, wlan-ng.conf, manual">
  10         <META name="AUTHOR" content="Wolfgang Fuschlberger">
  11         <META name="COPYRIGHT" content="Wolfgang Fuschlberger">
  12         <META name="ROBOTS" content="all">
  13         <META name="revisit-after" content="10 days">
  14         <TITLE>Linux and Wireless Ovislink Airlive WL-1100AP/WL-1100PCM with Intersil Prism2 Chipset</TITLE>
  15         <SCRIPT type="text/javascript" language="JavaScript">
  16             <!--
  17             if (parent.frames.length) parent.location.href = location.href;
  18             //-->
  19         </SCRIPT>
  20
  21 </HEAD>
  22
  23 <BODY bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#AA00BA" alink="#FF0000">
  24 <BR>
  25 <H1 align="center">Ovislink Airlive WL-1100AP Access Point<BR>Ovislink Airlive WL-1100PCM PCMCIA Adapter</H1>
  26
  27 <BR><BR>
  28
  29
  30 <P>
  31 <hr>
  32 <em>
  33 On this page you will a find a short guide on how to set up this wireless hardware under Linux.<BR>
  34 I wrote it because when I searched google I found <span style="font-weight:bold">nothing</span> about this Hardware.
  35 </em>
  36 <hr>
  37 </P>
  38
  39 <P>
  40 All comments, suggestions etc. are welcome. Please contact me at <A HREF="mailto:wf-hp&#64;gmx.net">wf-hp&#64;gmx.net</A>.
  41 </P>
  42
  43 <hr width="40%" align="center">
  44
  45 <P>
  46 A few days ago I decided to get me a new toy. I bought a wireless LAN-Card together with an access-point (short AP) to avoid 20 metres of Twisted-Pair Cable lying through the corridors of my home.</P>
  47
  48 <P>I chose the Ovislink hardware, because on the box of the PCMCIA-card Linux was listed as an OS which supported the card. The manual of the AP which they allowed me to read in the shop said it had to be configured over SNMP. After doing a little research on google I found out, that chances were good this could be done with one of the programs from ap-utils. I hoped it would work, but I have to confess I would have also used Windows for the configuration, since the price was rather low and I badly wanted to have that thing.
  49 </P>
  50
  51 <P>
  52 I own a HP Omnibook XE3-GC (the old variant with the Savage-Chip) running Debian/sarge at the moment (in stable/woody the package ap-utils was not included) and a router running Debian/woody, which now got a second NIC (network interface card) to attach the AP.
  53 </P>
  54
  55 <hr width="80%" align="center">
  56
  57 <BR>
  58
  59 <H3>
  60 Setting up the PCMCIA-Card
  61 </H3>
  62
  63 <P>
  64 The WLAN-Card has a Prism2-Chip which is supported by linux-wlan-ng.
  65 <BR>
  66 In this file I will only cover the relevant details for WLAN-Configuration. For the basics please refer to the <A HREF="http://www.tldp.org/HOWTO/PCMCIA-HOWTO.html"><U>PCMCIA-HOWTO</U></A>.
  67 </P>
  68
  69 <P>
  70 I heard reports that this card also worked with orinoco_cs. I will continue to use prism2_cs since it is the 'official' driver-module offered by Ovislink, but I am interested in reports about using orinoco_cs, especially the differences to prism2_cs.
  71 </P>
  72
  73 <P>
  74 Things you need for compiling linux-wlan-ng:<BR>
  75 - sources of linux-wlan-ng from <A HREF="http://www.linux-wlan.com"><U>http://www.linux-wlan.com</U></A><BR>
  76 - sources of pcmcia-cs from <A HREF="http://pcmcia-cs.sourceforge.net"><U>http://pcmcia-cs.sourceforge.net</U></A><BR>
  77 - sources of your linux kernel from <A HREF="http://www.kernel.org"><U>http://www.kernel.org</U></A>
  78 </P>
  79
  80 <P>
  81 For Debian-users: <code>apt-get source linux-wlan-ng pcmcia-cs kernel-source-`uname -r`</code>
  82 </P>
  83
  84 <P>
  85 Run <code>./Configure</code> in the source-directory of pcmcia-cs.
  86 </P>
  87 <P>
  88 Run <code>./Configure</code> in the source-directory of linux-wlan-ng and answer the following question with yes:<BR>
  89 <code>
  90 Build Prism2.x PCMCIA Card Services (_cs) driver? (y/n) [y]: y
  91 </code>
  92 </P>
  93 <P>
  94 The other modules (PCI- and USB-drivers) are not needed.
  95 </P>
  96
  97 <P>
  98 Compile and install (as root) pcmcia-cs (if it is not installed yet) and linux-wlan-ng by running in both of the source-directories:<BR>
  99 <code>make && make install</code>.
 100 </P>
 101
 102 <P>
 103 Add the following lines to the file <code>/etc/pcmcia/config.opts</code>. In case you are using Debian you can add it to <code>/etc/pcmcia/wlan-ng.conf</code>, since all *.conf-files in <code>/etc/pcmcia/</code> are sourced from <code>/etc/pcmcia/config.opts</code>:
 104 </P>
 105
 106 <P>
 107 <code>
 108 card "Intersil PRISM2 11 Mbps Wireless Adapter"<BR>
 109 &nbsp;&nbsp;&nbsp;manfid 0x0156, 0x0002<BR>
 110 &nbsp;&nbsp;&nbsp;bind "prism2_cs"
 111 </code>
 112 </P>
 113
 114 <P>
 115 With this card-definition the card will be recognized correctly by cardmgr when it is inserted into the PCMCIA-slot and the module <code>/lib/modules/`uname -r`/pcmcia/prism2_cs.o</code> will be loaded.
 116 </P>
 117
 118 <P>
 119 Next you have to configure the files <code>/etc/pcmcia/network.opts</code> for the network-parameters of the WLAN-interface <code>/dev/wlan0</code> and <code>/etc/pcmcia/wlan-ng.opts</code> for the WLAN-configuration itself. Both files are commented thoroughly and the names of the variables are rather self-explaining.
 120 </P>
 121
 122 <BR>
 123
 124 <P>
 125 This is my <code>/etc/pcmcia/wlan-ng.opts</code> without the Comment-lines:<BR>
 126 (YES, I changed my WEP-keys :-) )
 127 </P>
 128
 129 <P>
 130 <code>
 131 ============ Begin of File /etc/pcmcia/wlan-ng.opts ============<BR>
 132 WLAN_VERSION=0<BR>
 133 WLAN_PATCHLEVEL=1<BR>
 134 WLAN_SUBLEVEL=15<BR>
 135 WLAN_EXTRAVERSION=<BR>
 136 <BR>
 137 case "$ADDRESS" in<BR>
 138 wlannoenable,*,*,*)<BR>
 139 &nbsp;&nbsp;&nbsp;&nbsp;WLAN_ENABLE=n<BR>
 140 ;;<BR>
 141 *,*,*,*)<BR>
 142 &nbsp;&nbsp;&nbsp;&nbsp;#=======WEP===========================================<BR>
 143 &nbsp;&nbsp;&nbsp;&nbsp;lnxreq_hostWEPEncrypt=true<BR>
 144 &nbsp;&nbsp;&nbsp;&nbsp;lnxreq_hostWEPDecrypt=true<BR>
 145 &nbsp;&nbsp;&nbsp;&nbsp;dot11PrivacyInvoked=true<BR>
 146 &nbsp;&nbsp;&nbsp;&nbsp;dot11WEPDefaultKeyID=0<BR>
 147 &nbsp;&nbsp;&nbsp;&nbsp;dot11ExcludeUnencrypted=true<BR>
 148 &nbsp;&nbsp;&nbsp;&nbsp;dot11WEPDefaultKey0=01:23:45:67:89:AB:CD:EF:00:00:00:00:00<BR>
 149 &nbsp;&nbsp;&nbsp;&nbsp;dot11WEPDefaultKey1=CC:CC:CC:CC:CC:CC:CC:CC:CC:CC:CC:CC:CC<BR>
 150 &nbsp;&nbsp;&nbsp;&nbsp;dot11WEPDefaultKey2=FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:FF:F0<BR>
 151 &nbsp;&nbsp;&nbsp;&nbsp;dot11WEPDefaultKey3=00:00:00:00:00:00:00:00:00:00:00:00:0F<BR>
 152 <BR>
 153 &nbsp;&nbsp;&nbsp;&nbsp;#=======SELECT STATION MODE===================<BR>
 154 &nbsp;&nbsp;&nbsp;&nbsp;IS_ADHOC=n          # y|n, y - adhoc, n - infrastructure<BR>
 155 <BR>
 156 &nbsp;&nbsp;&nbsp;&nbsp;#=======INFRASTRUCTURE STATION START===================<BR>
 157 &nbsp;&nbsp;&nbsp;&nbsp;AuthType="sharedkey"<BR>
 158 &nbsp;&nbsp;&nbsp;&nbsp;DesiredSSID="wlan"<BR>
 159 <BR>
 160 &nbsp;&nbsp;&nbsp;&nbsp;#=======ADHOC STATION START============================<BR>
 161 &nbsp;&nbsp;&nbsp;&nbsp;SSID="adhoc-wlan"<BR>
 162 &nbsp;&nbsp;&nbsp;&nbsp;BCNINT=100<BR>
 163 &nbsp;&nbsp;&nbsp;&nbsp;CHANNEL=6<BR>
 164 &nbsp;&nbsp;&nbsp;&nbsp;BASICRATES="2 4"<BR>
 165 &nbsp;&nbsp;&nbsp;&nbsp;OPRATES="2 4 11 22"<BR>
 166 &nbsp;&nbsp;&nbsp;&nbsp;;;<BR>
 167 esac<BR>
 168 ============ End of File /etc/pcmcia/wlan-ng.opts ============
 169 </code>
 170 </P>
 171
 172 <P>
 173 The settings for ad-hoc-mode are untested, since I have not yet found anybody for testing.
 174 </P>
 175
 176 <P>
 177 The nickname of the card can be set with the following command:<BR>
 178 <code>
 179 wlancfg set wlan0<BR>
 180 p2CnfOwnName=mynewnickname
 181 </code>
 182 </P>
 183
 184 <BR>
 185
 186 <P>
 187 This is my <code>/etc/pcmcia/networks.opts</code> without the Comment-lines:
 188 </P>
 189
 190 <P>
 191 <code>
 192 ============ Begin of File /etc/pcmcia/networks.opts ============<BR>
 193 case "$ADDRESS" in<BR>
 194 *,*,*,*)<BR>
 195 &nbsp;&nbsp;&nbsp;&nbsp;BOOTP="n"<BR>
 196 &nbsp;&nbsp;&nbsp;&nbsp;DHCP="n"<BR>
 197 &nbsp;&nbsp;&nbsp;&nbsp;PPPOE="n"<BR>
 198 &nbsp;&nbsp;&nbsp;&nbsp;WHEREAMI="n"<BR>
 199 &nbsp;&nbsp;&nbsp;&nbsp;IPADDR="192.168.1.1"<BR>
 200 &nbsp;&nbsp;&nbsp;&nbsp;NETMASK="255.255.255.0"<BR>
 201 &nbsp;&nbsp;&nbsp;&nbsp;IPMASQ="n"<BR>
 202 &nbsp;&nbsp;&nbsp;&nbsp;start_fn () { return; }<BR>
 203 &nbsp;&nbsp;&nbsp;&nbsp;stop_fn () { return; }<BR>
 204 &nbsp;&nbsp;&nbsp;&nbsp;NO_CHECK=n<BR>
 205 &nbsp;&nbsp;&nbsp;&nbsp;NO_FUSER=n<BR>
 206 &nbsp;&nbsp;&nbsp;&nbsp;;;<BR>
 207 esac<BR>
 208 ============ End of File /etc/pcmcia/networks.opts ============
 209 </code>
 210 </P>
 211
 212 <P>
 213 In my case I did not have to set a gateway because I am running a 1024bit-encrypted VPN (from <A HREF="http://www.tinc.org"><U>www.tinc.org</U></A>) over the radio-connection which is my default route.
 214 </P>
 215
 216 <hr width="80%" align="center">
 217
 218 <BR>
 219
 220
 221 <H3>
 222 <A name="accesspoint">
 223 Setting up the Access-Point
 224 </A>
 225 </H3>
 226
 227 <P>
 228 <span style="font-weight:bold">Important Note:</span> You can configure everything under Linux. No need to boot Windows.
 229 </P>
 230
 231 <P>
 232 Some interesting facts (which took me quite some time to find in the manual):<BR>
 233 Default-IP-address: 192.168.0.1<BR>
 234 Default-password: public<BR>
 235 Needed Cable: straight TwistedPair-Cable when connected to a switch or hub, a crossover cable when connecting directly to a NIC (network interface card)
 236 </P>
 237
 238 <P>
 239 Download ap-utils from <A HREF="http://ap-utils.polesye.net/"><U>http://ap-utils.polesye.net/</U></A>.
 240 </P>
 241
 242 <P>
 243 Compile the programs:<BR>
 244 <code>
 245 ./configure<BR>
 246 make && make install
 247 </code>
 248 </P>
 249
 250 <P>
 251 Start the program <code>ap-config</code>.
 252 </P>
 253
 254 <P>
 255 Enter the default-IP-address of the AP (192.168.0.1), the default-password ('public') and choose 'AP type: ATMEL'<BR>
 256 This should connect you to the AP.<BR>
 257 If this does not work check your network and routing settings, especially the netmask
 258 </P>
 259
 260 <P>
 261 The configuration is explained in the manual that came with the AP.
 262 </P>
 263
 264 <BR>
 265
 266 <H5>
 267 Some oddities you may encounter:
 268 </H5>
 269
 270 <P>
 271 The WEP saved in the AP will never displayed, even though they were entered and saved correctly. The only thing you can to ensure encryption works is testing it with a WLAN-card and checking it with <code>wlancfg show wlan0</code>
 272 </P>
 273
 274 <BR>
 275
 276 <P>
 277 One really interesting feature of ap-config is the possibility of changing the radio power output of the AP:
 278 </P>
 279
 280 <P>
 281 This scale is everything I guessed so far. If you have any more details please let me know:
 282 </P>
 283
 284 <table border="0" cellspacing="5" cellpadding="0">
 285 <tr>
 286 <td>
 287 <P align="center">
 288 decimal number in ap-config
 289 </P>
 290 </td>
 291 <td>
 292 <P align="center">
 293 power output
 294 </P>
 295 </td>
 296 </tr>
 297 <tr>
 298 <td>
 299 <P align="center">
 300 128
 301 </P>
 302 </td>
 303 <td>
 304 <P align="center">
 305 100% (whatever this means in W)
 306 </P>
 307 </td>
 308 </tr>
 309 <tr>
 310 <td>
 311 <P align="center">
 312 255/0
 313 </P>
 314 </td>
 315 <td>
 316 <P align="center">
 317 50%
 318 </P>
 319 </td>
 320 </tr>
 321 <tr>
 322 <td>
 323 <P align="center">
 324 127
 325 </P>
 326 </td>
 327 <td>
 328 <P align="center">
 329 0%/off
 330 </P>
 331 </td>
 332 </tr>
 333 </table>
 334
 335 <BR>
 336 <P>
 337 Have fun!
 338 </P>
 339
 340 <BR>
 341 <BR>
 342 <BR>
 343 <BR>
 344
 345 <P align="center">
 346 &copy; 2002 by <A HREF="mailto:wf-hp&#64;gmx.net">Wolfgang Fuschlberger</A><BR>
 347 last update: 2002-11-24
 348 </P>
 349
 350 <center>
 351 <!--WEBBOT bot="HTMLMarkup" startspan ALT="Site Meter" -->
 352 <script type="text/javascript" language="JavaScript">var site="s14wlanguide"</script>
 353 <script type="text/javascript" language="JavaScript1.2" src="http://s14.sitemeter.com/js/counter.js?site=s14wlanguide">
 354 </script>
 355 <noscript>
 356 <a href="http://s14.sitemeter.com/stats.asp?site=s14wlanguide" target="_top">
 357 <img src="http://s14.sitemeter.com/meter.asp?site=s14wlanguide" alt="Site Meter" border=0></a>
 358 </noscript>
 359 <!-- Copyright (c)2002 Site Meter -->
 360 <!--WEBBOT bot="HTMLMarkup" Endspan -->
 361 </center
 362
 363 </BODY>
 364 </HTML>
 365
 366        <!--(c) 2002 by Wolfgang Fuschlberger-->
 367