This commit is contained in:
gferg 2002-08-20 13:14:21 +00:00
parent a15b69c460
commit ecf71d9926
2 changed files with 457 additions and 433 deletions

View File

@ -5,15 +5,26 @@
<!-- Header -->
<articleinfo>
<title>PCTel HSP MicroModem Configuration mini-HOWTO</title><author>
<title>PCTel HSP MicroModem Configuration mini-HOWTO</title>
<author>
<firstname>
Sayamindu</firstname> <surname>Dasgupta</surname> <affiliation>
<address> <email>unmadindu_NO_SPAM_@Softhome.net</email> </address>
</affiliation> </author> <author> <firstname>Jan</firstname> <surname>Stifter</surname>
</affiliation> </author>
<author> <firstname>Jan</firstname> <surname>Stifter</surname>
<affiliation>
<address> <email>j.stifter_NO_SPAM_@medres.ch</email> </address>
</affiliation> </author>
<revhistory>
<revision>
<revnumber> 2.5.5 </revnumber>
<date> August 17th 2002 </date>
<revremark> Made changes in driver section, and other additions </revremark>
</revision>
</revhistory>
<revhistory>
<revision>
<revnumber> 2.5.1 </revnumber>
@ -21,13 +32,15 @@ Sayamindu</firstname> <surname>Dasgupta</surname> <affiliation>
<revremark> Made changes in driver section, and misc. additions </revremark>
</revision>
</revhistory>
<revhistory>
<revhistory>
<revision>
<revnumber> 2.5 </revnumber>
<date> June 6th 2002</date>
<revremark> Made changes in the drivers and FAQ section, added the database info, other corrections </revremark>
</revision>
</revhistory>
<revhistory>
<revision>
<revnumber> 2.00 </revnumber>
@ -35,6 +48,7 @@ Sayamindu</firstname> <surname>Dasgupta</surname> <affiliation>
<revremark> Made changes in the drivers section, other corrections </revremark>
</revision>
</revhistory>
<revhistory>
<revision>
<revnumber>1.10</revnumber>
@ -42,6 +56,7 @@ Sayamindu</firstname> <surname>Dasgupta</surname> <affiliation>
<revremark>Cleaning up of sgml by Greg Ferguson, Relicensed under the GFDL, minor corrections</revremark>
</revision>
</revhistory>
<revhistory>
<revision>
<revnumber>1.00</revnumber>
@ -304,6 +319,9 @@ Mr. Jack Seller of PCTel's Public Relation department at <ulink url='mailto: jac
address asking PCTel to release the source code of their drivers.
</emphasis>
</para>
<para>
Remember that when you are using proprietary drivers, you are giving up your freedom.
</para>
</note>
</para>
<para>
@ -351,12 +369,12 @@ the <ulink url="http://modems.dewback.cl/pctel-2.2.tar.gz">pctel 2.2x </ulink> d
</para>
<para>
If you see something like 2.4x, go to <ulink url="http://linmodems.technion.ac.il/pctel-linux/">http://linmodems.technion.ac.il/pctel-linux/</ulink>
and download the pctel 0.9.3 (pctel-0.9.3.tar.gz) drivers from that site.
and download the pctel 0.9.4 (pctel-0.9.4.tar.gz) drivers from that site.
</para>
<para>
<important>
<para>
Also note that only the pctel 0.9.3 drivers have support for the new <link linkend='amr'>AMR</link> modems.
Also note that only the pctel 0.9.4 drivers have support for the new <link linkend='amr'>AMR</link> modems.
</para>
</important>
</para>
@ -415,14 +433,14 @@ the script, but once you reboot, you will have to load the modules by</para><par
<para><command>bash$ insmod ptserial.o </command>)</para>
</sect2>
<sect2>
<title>Installing the pctel-0.9.3 driver</title>
<title>Installing the pctel-0.9.4 driver</title>
<para>Make sure that you have kernel 2.4.0 or greater by the command</para>
<para><command>bash$ uname -r</command></para>
<para>Unpack the downloaded files with the commands</para>
<para><command>bash$ tar -xzvf 0.9.3.tar</command></para>
<para>Now you will have a pctel-0.9.3 directory</para>
<para><command>bash$ tar -xzvf 0.9.4.tar.gz</command></para>
<para>Now you will have a pctel-0.9.4 directory</para>
<para>cd into that with the command</para>
<para><command>bash$ cd pctel-0.9.3/</command></para>
<para><command>bash$ cd pctel-0.9.4/</command></para>
<para>Now comes the complicated part.</para>
<para>To proceed further you will have to know what chip set your modem has.See section <link linkend="identify"> 9.4 </link>for more information on this.</para>
<para>Once you have got the name of the chip set, just type one of the following commands (depending on the chip set)
@ -441,16 +459,10 @@ If you have a CM8738 chip set,
./configure -with-hal=cm8738</command>
</para>
<para>
If you have a chip set integrated with an Intel 810 chip set based motherboard from Intel,
If you have a chip set integrated with an 810 chip set based box,
</para>
<para> <command>bash$
./configure --with-hal=i810 </command>
</para>
<para>
If you have a chip set integrated in a motherboard from SIS,
</para>
<para> <command>bash$
./configure --with-hal=sis </command>
./configure --with-hal=i81x </command>
</para>
<para>
If you have a chip set integrated with an VIA 686a chip set based motherboard ,
@ -499,14 +511,14 @@ NOTE: If you get a message that says <computeroutput> configure: error: You must
</para>
<para>
However, if you have an <link linkend='amr'>AMR</link> modem, then you will have to
use the 0.9.3 drivers.
use the 0.9.4 drivers.
</para>
</sect2>
<sect2>
<title>Installing the pctel-0.8.6 driver</title>
<caution>
<para>
Use this driver only if you experience problems with the pctel-0.9.3 drivers
Use this driver only if you experience problems with the pctel-0.9.4 drivers
</para>
</caution>
<para>Make sure that you have kernel 2.4.0 or greater by the command</para>
@ -578,7 +590,7 @@ Then just load the drivers with the commands
<command>bash$ insmod ptserial</command>
</para>
<para>
(these too, like in the case of the pctel-0.9.3 drivers, can be issued from any directory as the <application>insmod</application> program will automatically find
(these too, like in the case of the pctel-0.9.4 drivers, can be issued from any directory as the <application>insmod</application> program will automatically find
the drivers <application>pctel.o</application> and <application>ptserial.o</application> in <filename>/lib/modules/`your kernel version`/misc/ </filename>)
</para>
</sect2>
@ -1028,7 +1040,7 @@ rmmod pctel
</sect2>
<sect2>
<title>
Bugs in the pctel-0.9.3 and the 0.8.6 versions.
Bugs in the pctel-0.9.4 and the 0.8.6 versions.
</title>
<para>
<anchor id="bug">
@ -1123,7 +1135,7 @@ AMR modems
<para>
There are certain PCTel chip set based internal modems that go into AMR slots instead of the normal PCI slots. They are
usually identified as <computeroutput> HSP MR </computeroutput> by the <command>bash$ lspci </command> command. These modems
are supported by the pctel-0.9.3 drivers only.
are supported by the pctel-0.9.4 drivers only.
</para>
</sect2>
<sect2 id="sound">
@ -1171,7 +1183,7 @@ cat configure.patch | patch -p0
</command>
<tip>
<para>
NOTE: I am supposing that you are in the pctel-0.9.3 directory, and the <filename>configure.patch</filename> is also in that directory
NOTE: I am supposing that you are in the pctel-0.9.4 directory, and the <filename>configure.patch</filename> is also in that directory
</para>
</tip>
</para>

View File

@ -1,410 +1,422 @@
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
<article>
<articleinfo>
<title>Debian Link-sys WPC11 Mini-HOWTO</title>
<author>
<firstname>Gerardo</firstname>
<surname>Arnaez</surname>
<affiliation>
<address>
<email>garnaez_((AT))_yahoo.com</email>
</address>
</affiliation>
</author>
<revhistory>
<revision>
<revnumber>1.1.4</revnumber>
<date>2002-08-10</date>
<authorinitials>gea</authorinitials>
</revision>
<revision>
<revnumber>1.1.3</revnumber>
<date>2002-06-09</date>
<authorinitials>gea</authorinitials>
<revremark>Made clear what version on linux-wlan I actually used.</revremark>
</revision>
<revision>
<revnumber>1.1.2</revnumber>
<date>2002-05-26</date>
<authorinitials>gea</authorinitials>
<revremark>In part 2 of the HOWTO, the last item says make-kpkg --revision-custom.1.0 kernel_image when later on you used the correct one make-kpkg --revision=custom.1.0 kernel_image . Where there is an equal sign before the word custom and not a dash. This has been corrected. thanks to Raj Prakash, raj@rajeshprakash.com</revremark>
</revision>
<revision>
<revnumber>1.1.1</revnumber>
<date>2002-04-27</date>
<authorinitials>gea</authorinitials>
<revremark>some more grammer improvements, and highlighting to make things clearer</revremark>
</revision>
<revision>
<revnumber>1.1</revnumber>
<date>2002-04-13</date>
<authorinitials>gea</authorinitials>
<revremark>Correct grammar, made things a little more clearer, made software requirements more explicit.</revremark>
</revision>
<revision>
<revnumber>1.0</revnumber>
<date>2002-03-24</date>
<authorinitials>gea</authorinitials>
<revremark>Written because I spent enough figuring this out that I wanted to store "how I did it" somewhere I wouldn't lose it and figure you all might like it too.</revremark>
</revision>
<revision>
<revnumber>1.1.4</revnumber>
<date>2002-8-10</date>
<authorinitials>gea</authorinitials>
<revremark>I attempted to follow my own instruction on re-installing on the same laptop and found my how-to a little lacking. Have made things a bit clearer on what I am using. Also made a table to two</revremark>
</revision>
</revhistory>
<abstract>
<indexterm>
<primary>Abstract</primary>
</indexterm>
<para>This is a Cookbook on how to set up a Wireless Link-Sys WPC11 card using a Link-SYS Wireless Access Point/DSL/Switch on a Debian system .
</para>
</abstract>
</articleinfo>
<sect1>
<TITLE>Link-sys WPC11 install on Debian</TITLE>
<sect2>
<title>Why Debian and why just this card?</title>
<para>I have been trying for months to get wireless working on Debian and after reading far and wide and getting help from irc.debian.org, I realized that there really is no Cookbook in getting wireless set up. Thus having just done it I want to commit to 'paper' so that you all can use it and I can refer to it knowing it is safe somewhere. :)
</para>
</sect2>
<sect2><title>Required Hardware</title>
<para>By required I mean, here is what I used to get this to work, and may serve as guide to anyone who wants to know what really works.</para>
<para>
BEFW11S4- EtherFast? Wireless AP + Cable/DSL Router w/4-Port Switch. I really really like this WAP (Wireless Access Point). It is OS independent (read, linux friendly) and is configured using a browser so no need to touch Microsoft software at all, even to configure it. And if you don't know what a switch is, let me tell ya, they rock. Essentially they allow the NIC to communicate in both directions at the same time. I highly recommend one.
</para>
<para>Link-sys WPC11. I have a version 3.0 and don't recommend any thing less than a version 2.5 Cost about 80 dollars</para>
</Sect2>
<sect2><title>Software Requirements</title>
<para>
<table frame=all>
<title>Software Requirements</title>
<tgroup cols=4 align=left colsep=1 rowsep=1>
<thead>
<row>
<entry>Software</entry>
<entry>Version</entry>
<entry>URL link</entry>
<entry>notes</entry>
</row>
</thead>
<tbody>
<row>
<!-- one of (ENTRYTBL ENTRY) -->
<entry>Debian Distribution</entry>
<entry>Stable ("Woody")</entry>
<entry><ulink url="http://www.debian.org">www.debian.org</ulink></entry>
<entry>linux-2.4.19.tar, patched with patch-2.4.20-pre1.bz </entry>
</row>
<row>
<!-- one of (ENTRYTBL ENTRY) -->
<entry>Absolute Systems</entry>
<entry>0.1.14</entry>
<entry><ulink url="http://www.linux-wlan.com/linux-wlan/">Abosulte systems</ulink></entry>
<entry>Make sure you download the <emphasis>11Mbps</emphasis> version. Works for 0.1.14, erros with 0.1.15</entry>
</row>
<row>
<!-- one of (ENTRYTBL ENTRY) -->
<entry>pcmcia-source</entry>
<entry>Stable</entry>
<entry><screen>apt-get install pcmcia-source</screen></entry>
<entry><---type this</entry>
</row>
<row>
<!-- one of (ENTRYTBL ENTRY) -->
<entry>pcmcia-cs</entry>
<entry>stable</entry>
<entry><screen>apt-get install pcmcia-cs</screen></entry>
<entry><---type this</entry>
</row>
<row>
<!-- one of (ENTRYTBL ENTRY) -->
<entry>wireless-tools</entry>
<entry>Stable</entry>
<entry><screen>apt-get install wireless-tools</screen></entry>
<entry><--type this</entry>
</row>
<row>
<!-- one of (ENTRYTBL ENTRY) -->
<entry>pump</entry>
<entry>stable</entry>
<entry><screen>apt-get install pump</screen></entry>
<entry>Useful to see if card works</entry>
</row>
<row>
<!-- one of (ENTRYTBL ENTRY) -->
<entry>kernel-package</entry>
<entry>stable</entry>
<entry><screen>apt-get install kernel-package</screen></entry>
<entry>Good way to build kernel and the one I describe.</entry>
</row>
<row>
<!-- one of (ENTRYTBL ENTRY) -->
<entry>Kernel</entry>
<entry>2.4.19, patched with patch-2.4.20-pre1.bz2 </entry>
<entry><ulink url="http://www.kernel.org">www.kernel.org</ulink></entry>
<entry>You must know how to build and patch a kernel to do this. Its not hard and I will show you</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<para>You will also need some way to setup you IP address on your wireless card, I recommend either <screen>apt-get install DHCP-client</screen> to install the DHCP-client that will automatically configure your IP address, if you have a DHCP server. The WAP-11 hardware does provide DHCP server capabilities</para>
<para>Or at least have the <emphasis>pump</emphasis> application, which also will query a DHCP server and get you an IP address from the DHCP server. Note I tend to use <emphasis>pump</emphasis> when I am trying out new hardware to see if there is a connection, since to test a particular device, say <emphasis>eth0</emphasis> I would type <screen>pump -i eth0</screen> where the option <emphasis>-i</emphasis> tells <emphasis>pump</emphasis> what device to try to get an IP address. In this particular case, when I could not get Debian to automatically set up my wireless card, which was device <emphasis>wlan0</emphasis>, I would type <screen>pump -i wlan0</screen> and <emphasis>pump</emphasis> would try to set up the device. Anyway, the point is, that it is a good trouble shooting command, and you should know about it, and I talk more about it later.</para>
<para>I also recommend you use the "kernel-package" package when you want to build your new kernel, which I will get to. This tool is very good and you should be using it anyway when you are building new kernel for the Debian distribution. You can install it by typing <screen>apt-get install kernel-package</screen> Also, be sure to read the documentation it comes with, in case I don't do a good job explaining how to use it, later in this document
</para>
</sect2>
<sect2><title>Kernel Configuration</title>
<sect3><title>What TO enable</title>
<para>In order to use the wireless tools, like <emphasis>iwconfig</emphasis>, which will allow you tell how good your connection is, you need to enable support for <emphasis>Wireless LAN (Non-Ham Rasio)</emphasis>.</para>
<para>In these examples, I use <screen>make menuconfig</screen> to configure my kernel.</para>
<para>You can do this by:</para>
<literallayout>
Go to:
Network Device support -->
then Select:
Wireless LAN (non-hamradio) --->
</literallayout>
<para>
Then Choose the options,
so that it looks like below, or something
as close to this.
Note I am uing 'make menuconfig'
to configure my kernel
</para>
<literallayout>
[*] Wireless LAN (non-hamradio)
< > STRIP (Metricom starmode radio IP)
< > AT T WaveLAN & DEC RoamAbout DS support
< > Aironet Arlan 655 & IC2200 DS support
< > Aironet 4500/4800 series adapters
< > Cisco/Aironet 34X/35X/4500/4800 ISA and PCI cards
<*> Hermes chipset 802.11b support (Orinoco/Prism2/Symbol)
< > Hermes in PLX9052 based PCI adaptor support
<*> Prism 2.5 PCI 802.11b adaptor support
</literallayout>
</sect3>
<sect3><title>What <emphasis>NOT</emphasis> to Enable</title>
<para>One of the main stumbling blocks was to realize that the <emphasis>pcmcia support in the kernel is not as good as the pcmcia-source support</emphasis> that one gets when you build it from pcmcia-source.
</para>
<para>I use either <screen>make xconfig</screen> or <screen>make menuconfig</screen> to configure my kernel, so when you configure your kernel, be sure to not have pcmcia support enabled under <screen>General setup</screen>
</para>
<para>Nor do you want to select any particular pcmcia card under <screen>Network device support</screen>. I repeat you do not want this under the kernel and you will be building it when you download pcmcia-source.</para> <caution><para>Be sure to download all the necessary components before you take pcmcia support out of the kernel, otherwise, if you were using a pcmcia card for net access, you will not be able to connect to the Internet using the new kernel, until you have built both pcmcia support and module drivers for the wireless card</para></caution>
</sect3>
</sect2>
</sect1>
<sect1>
<title>Using make-kpkg to build kernels</title>
<caution><para>Note: <emphasis>make-kpkg</emphasis> was installed when you installed <emphasis>kernel-package</emphasis></para></caution>
<para>Once you have configured your kernel just save and exit, and don't use make-kpkg yet! I will show you a good way to make sure sure everything builds well.</para>
<para>Follow the instruction in the make-kpkg documentation but essentially:</para>
<para>You need to be in the <screen>/usr/src/linux</screen> directory, then </para>
<screen>make-kpkg clean</screen>
<para>to clean all the binaries out and prepare to build a new kernel, then:</para>
<screen>make-kpkg --revision=custom.1.0 kernel_image</screen>
<caution><para>Don't Do this Yet!</para></caution>
<para>We need to get the pcmcia-source ready to be built at the same time as the kernel is built. This is a very neat feature of make-kpkg!</para>
</sect1>
<sect1><title>Building PCMCIA-SOURCE</title>
<para>First, be sure to download pcmcia-source, by typing <screen>apt-get install pcmcia-source</screen> This will download the source into <screen>/usr/src</screen> as <screen>pcmcia-source.tar.gz</screen></para>
<para>You now need to gunzip the file by <screen>gunzip pcmcia-source.tar.gz</screen> and then untar the file by <screen>tar xvf pcmcia-source.tar</screen></para>
<para>You should see pcmcia-source unpacked into the directory <screen>/usr/src/modules/pcmcia-cs</screen></para>
</sect1>
<sect1><title>Using make-kpkg to build the new kernel and pcmcia-source modules</title>
<para>Be sure the pcmcia-source is under /usr/src/modules.</para>
<para>Go ahead and configure your kernel and be sure that pcmcia support IS NOT compiled in as an option in the kernel.</para>
<para>To build the kernel and pcmcia-source, be sure you are under the <screen>/usr/src/linux</screen> or have a symbolic link from /usr/src/linux to whatever kernel source you have set up. Then type <screen>make-kpkg --revision=custom.1.0 kernel_image modules_image</screen></para>
<para>The <emphasis>kernel_image</emphasis> option will build the kernel while the <emphasis>modules_image</emphasis> option will build all modules located under <screen>/usr/src/modules/</screen>. So be sure that you do indeed want to rebuild any other modules that are located in source when you are ready to build your new kernel.</para>
<para>After some chugging, go up one level to <screen>/usr/src</screen> and you should see two new Debian packages that should look something like this:
<literallayout>
kernel-image-2.4.19-pre4_custom.1.0_i386.deb
pcmcia-modules-2.4.19-pre4_3.1.31-7+custom.1.0_i386.deb
</literallayout>
</para>
<para>You first want to install the kernel image so you would type <screen>dpkg -i kernel-image-etc....</screen></para>
<para>Now install the modules by typing <screen>dpkg -i pcmcia-modules.etc...</screen></para>
<caution><para>There are a couple of assumptions that make-kpkg makes about your lilo.conf file. One is that you have not radically changed it. Make-kpgk will make make symbolics links from '/boot' where the actual kernel resides to 'vmlinuz' which is under '/'. In other words, under '/', you will see <emphasis>vmlinuz</emphasis> and <emphasis>vmlinuz.old</emphasis> which are symbolic links to the real kernel images under <emphasis>/boot/</emphasis>. Anyway if you have any questions ask me.</para></caution>
</sect1>
<sect1><title>Wlan Drivers for You Link-Sys Card</title>
<para>You have downloaded the 11 Wlan project. Go a head and read the instruction, and put it under modules. Follow the instructions when you <screen>make config</screen> The one key is to make sure you specify the pcmcia-source as under <screen>/usr/src/modules/pcmcia-cs</screen> and not choose the default it gives you.</para>
<para>Go ahead and <screen>make all</screen> and <screen>make install</screen></para>
<para>I suggest you read the documentation that comes with it, but essentially, <emphasis>if you have a WAP that is connected to your DSL or cable modem then you have a <emphasis>infrastructure set up.</emphasis></emphasis> I found that it was best to edit the <screen>networks.opt</screen> under the <screen>/etc/pcmcia</screen> directory.</para>
<para>To make things easier edit the option
<literallayout># Use DHCP (via /sbin/dhcpcd, /sbin/dhclient, or /sbin/pump)? [y/n]
DHCP="y"</literallayout> to what I have, i.e., set it to yes.
</para>
<para>The documentation talks about setting ESSID but when you edit the <screen>wlan-ng.opts</screen> you will only see
<literallayout>
#=======INFRASTRUCTURE STATION START===================
# SSID is all we have for now
AuthType="opensystem" # opensystem | sharedkey (requires WEP)
DesiredSSID="howardnet"
</literallayout>
</para>
<para>From what I can gather,DesiredSSID means ESSID and it works when the WAP and link-sys pcmcia card share the same name.</para>
<para>At this point, you should reboot and should have a working link-sys card that gets its address via DHCP.</para>
</sect1>
<sect1><title>Checking things in case they don't work</title>
<para>1. Be sure to type <screen>ifconfig</screen></para>
<para>You should something like this</para>
<literallayout>
lo Link encap:Local Loopback
inet addr:127.0.0.1 Mask:255.0.0.0
UP LOOPBACK RUNNING MTU:16436 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:0 (0.0 b) TX bytes:0 (0.0 b)
wlan0 Link encap:Ethernet HWaddr 00:06:25:A8:AE:64
inet addr:192.168.1.104 Bcast:192.168.1.255 Mask:255.255.255.0
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:35197 errors:0 dropped:0 overruns:0 frame:0
TX packets:57676 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:100
RX bytes:43386657 (41.3 MiB) TX bytes:2670811 (2.5 MiB)
Interrupt:3 Base address:0x100
</literallayout>
<para>The keys point here are that <emphasis>inet addr:</emphasis>has a real IP address, and that <emphasis>Bcast</emphasis> and <emphasis>Netmask</emphasis> are set up such that they are on the same "wave-length" as your Wireless Access Point.</para>
<para>2. If you don't, you might have had the same problem i did which was that there was no easy script to initiate the wlan0 device setup. That is to say, if the card was recognized but you still did not get a connection and say that ifconfig showed wlan0 present but with no IP address. In other words, you might see something like this:</para>
<para><literallayout>
text:/home/dude# ifconfig
lo Link encap:Local Loopback
inet addr:127.0.0.1 Mask:255.0.0.0
UP LOOPBACK RUNNING MTU:16436 Metric:1
RX packets:14 errors:0 dropped:0 overruns:0 frame:0
TX packets:14 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:700 (700.0 b) TX bytes:700 (700.0 b)
wlan0 Link encap:Ethernet HWaddr 00:06:25:A8:AE:64
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:1 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:100
RX bytes:46 (46.0 b) TX bytes:0 (0.0 b)
Interrupt:3 Base address:0x100
</literallayout></para>
<para>As you can see, the interface device, the Wireless pcmcia card, is noted, but there is no <emphasis>inet addr</emphasis>. The pcmcia software recognized the card, but it has not successfully connected with the Wireless Access Point.</para>
<para>I used the command,<emphasis>pump</emphasis> to send a simple DHCP request to the DHCP server for the device in question. I used<screen>pump -i wlan0</screen> which essentially runs a simple DHCP request to set up that card, wlan0, in this case.</para>
<para>You can get the <emphasis>pump</emphasis> by <screen>apt-get install pump</screen></para>
<para>While I needed to use <screen>pump -i wlan0</screen> on my laptop, I did not need this when I set up the link-sys wireless WPC11 card on my girlfriend's laptop. She has a Link-Sys WPC11 version 2.5 pcmcia card.</para>
</sect1>
<sect1><title>Wireless tools</title>
<para>While it is not necessary to include this in your kernel configuration, you can enable Wireless tool extensions by going (i assume you use xconfig or menuconfig) to <screen>Network device support</screen> and then go to <screen>Wireless LAN (non-hamradio)</screen> and enable support for the <screen>Hermes chipset 802.11b support (Orinoco/Prism2/Symbol)</screen>. This will let you use the Wireless Tools like <screen>iwconfig</screen>, <screen>iwspy</screen> and such.</para>
<para>The one thing I found this good for is that by repeated typing iwconfig, you can see your Link Quality. Its quite good</para>
</sect1>
<sect1>
<title>Wireless Access Point</title>
<para>Perhaps its it missing the forest for the trees, but I did not spend any discussion setting up the actual Wireless Access Point. The reason is that the documentation that comes with the WAP is well written. The only thing I haven't spoken about is enabling Wireless Encryption Protocol in the WAP (Wireless Access Point) which I really don't suggest as I don't think WEP has been properly set up in the drivers for the Pcmcia Wireless Cards. However, let me know if you have any problems and I will be glad to help.
</para>
</sect1>
<sect1><title>Request for comments</title>
<para>I will be glad to help anyone out and if things are a bit confusing in this quite mini how to, please tell me how I can fix it to make it better.</para>
<para>Thanks!</para></sect1>
</Article>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
<article>
<articleinfo>
<title>Debian Link-sys WPC11 Mini-HOWTO</title>
<author>
<firstname>Gerardo</firstname>
<surname>Arnaez</surname>
<affiliation>
<address>
<email>garnaez_((AT))_yahoo.com</email>
</address>
</affiliation>
</author>
<revhistory>
<revision>
<revnumber>1.2</revnumber>
<date>2002-8-13</date>
<authorinitials>gea</authorinitials>
<revremark>Jim Bowlin suggested "minor" gramatical corrections. Too numerous to list in detail</revremark>
</revision>
<revision>
<revnumber>1.1.4</revnumber>
<date>2002-8-10</date>
<authorinitials>gea</authorinitials>
<revremark>I attempted to follow my own instruction on re-installing on the same laptop and found my how-to a little lacking. Have made things a bit clearer on what I am using. Also made a table to two</revremark>
</revision>
<revision>
<revnumber>1.1.3</revnumber>
<date>2002-06-09</date>
<authorinitials>gea</authorinitials>
<revremark>Made clear what version on linux-wlan I actually used.</revremark>
</revision>
<revision>
<revnumber>1.1.2</revnumber>
<date>2002-05-26</date>
<authorinitials>gea</authorinitials>
<revremark>In part 2 of the HOWTO, the last item says make-kpkg --revision-custom.1.0 kernel_image when later on you used the correct one make-kpkg --revision=custom.1.0 kernel_image . Where there is an equal sign before the word custom and not a dash. This has been corrected. thanks to Raj Prakash, raj@rajeshprakash.com</revremark>
</revision>
<revision>
<revnumber>1.1.1</revnumber>
<date>2002-04-27</date>
<authorinitials>gea</authorinitials>
<revremark>some more grammer improvements, and highlighting to make things clearer</revremark>
</revision>
<revision>
<revnumber>1.1</revnumber>
<date>2002-04-13</date>
<authorinitials>gea</authorinitials>
<revremark>Correct grammar, made things a little more clearer, made software requirements more explicit.</revremark>
</revision>
<revision>
<revnumber>1.0</revnumber>
<date>2002-03-24</date>
<authorinitials>gea</authorinitials>
<revremark>Written because I spent enough figuring this out that I wanted to store "how I did it" somewhere I wouldn't lose it and figure you all might like it too.</revremark>
</revision>
</revhistory>
<abstract>
<indexterm>
<primary>Abstract</primary>
</indexterm>
<para>This is a Cookbook on how to set up a Wireless Link-Sys WPC11 card using a Link-SYS Wireless Access Point/DSL/Switch on a Debian system .
</para>
</abstract>
</articleinfo>
<sect1>
<TITLE>Link-sys WPC11 install on Debian</TITLE>
<sect2>
<title>Why Debian and why just this card?</title>
<para>I have been trying for months to get wireless working on Debian and after reading far and wide and getting help from irc.debian.org, I realized that there really is no Cookbook for getting wireless set up. Thus having just done it I want to commit to 'paper' so that you all can use it and I can refer to it knowing it is safe somewhere. :)
</para>
</sect2>
<sect2><title>Required Hardware</title>
<para>By required I mean, here is what I used to get this to work, and may serve as guide to anyone who wants to know what really works.</para>
<para>
BEFW11S4- EtherFast? Wireless AP + Cable/DSL Router w/4-Port Switch. I really really like this WAP (Wireless Access Point). It is OS independent (read, linux friendly) and is configured using a browser so no need to touch Microsoft software at all, even to configure it. And if you don't know what a switch is, let me tell ya, they rock. Essentially they allow the NIC to communicate in both directions at the same time. I highly recommend one.
</para>
<para>Link-sys WPC11. I have a version 3.0 and don't recommend any thing less than a version 2.5 Cost about 80 dollars</para>
</Sect2>
<sect2><title>Software Requirements</title>
<para>
<table frame=all>
<title>Software Requirements</title>
<tgroup cols=4 align=left colsep=1 rowsep=1>
<thead>
<row>
<entry>Software</entry>
<entry>Version</entry>
<entry>URL link</entry>
<entry>notes</entry>
</row>
</thead>
<tbody>
<row>
<!-- one of (ENTRYTBL ENTRY) -->
<entry>Debian Distribution</entry>
<entry>Stable ("Woody")</entry>
<entry><ulink url="http://www.debian.org">www.debian.org</ulink></entry>
<entry>linux-2.4.19.tar, patched with patch-2.4.20-pre1.bz </entry>
</row>
<row>
<!-- one of (ENTRYTBL ENTRY) -->
<entry>Absolute Systems</entry>
<entry>0.1.14</entry>
<entry><ulink url="http://www.linux-wlan.com/linux-wlan/">Abosulte systems</ulink></entry>
<entry>Make sure you download the <emphasis>11Mbps</emphasis> version. Works for 0.1.14, erros with 0.1.15</entry>
</row>
<row>
<!-- one of (ENTRYTBL ENTRY) -->
<entry>pcmcia-source</entry>
<entry>Stable</entry>
<entry><screen>apt-get install pcmcia-source</screen></entry>
<entry><---type this</entry>
</row>
<row>
<!-- one of (ENTRYTBL ENTRY) -->
<entry>pcmcia-cs</entry>
<entry>stable</entry>
<entry><screen>apt-get install pcmcia-cs</screen></entry>
<entry><---type this</entry>
</row>
<row>
<!-- one of (ENTRYTBL ENTRY) -->
<entry>wireless-tools</entry>
<entry>Stable</entry>
<entry><screen>apt-get install wireless-tools</screen></entry>
<entry><--type this</entry>
</row>
<row>
<!-- one of (ENTRYTBL ENTRY) -->
<entry>pump</entry>
<entry>stable</entry>
<entry><screen>apt-get install pump</screen></entry>
<entry>Useful to see if card works</entry>
</row>
<row>
<!-- one of (ENTRYTBL ENTRY) -->
<entry>kernel-package</entry>
<entry>stable</entry>
<entry><screen>apt-get install kernel-package</screen></entry>
<entry>Good way to build kernel and the one I describe.</entry>
</row>
<row>
<!-- one of (ENTRYTBL ENTRY) -->
<entry>Kernel</entry>
<entry>2.4.19, patched with patch-2.4.20-pre1.bz2 </entry>
<entry><ulink url="http://www.kernel.org">www.kernel.org</ulink></entry>
<entry>You must know how to build and patch a kernel to do this. Its not hard and I will show you</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<para>You will also need some way to setup you IP address on your wireless card, I recommend either <screen>apt-get install DHCP-client</screen> to install the DHCP-client that will automatically configure your IP address, if you have a DHCP server. The WAP-11 hardware does provide DHCP server capabilities</para>
<para>Or at least have the <emphasis>pump</emphasis> application, which will also query a DHCP server and get you an IP address from the DHCP server. Note I tend to use <emphasis>pump</emphasis> when I am trying out new hardware to see if there is a connection. To test a particular device, say <emphasis>eth0</emphasis> I would type <screen>pump -i eth0</screen> where the option <emphasis>-i</emphasis> tells <emphasis>pump</emphasis> what device to try to get an IP address for. In this particular case, when I could not get Debian to automatically set up my wireless card, which was device <emphasis>wlan0</emphasis>, I would type <screen>pump -i wlan0</screen> and <emphasis>pump</emphasis> would try to set up the device. Pump is useful for troubleshooting. Examples of its usage are given later.</para>
<para>I also recommend you use the "kernel-package" package when you want to build your new kernel, which I will get to. This tool is very good and you should be using it anyway when you are building new kernel for the Debian distribution. You can install it by typing <screen>apt-get install kernel-package</screen> Also, be sure to read the documentation it comes with, in case I don't do a good job explaining how to use it, later in this document
</para>
</sect2>
<sect2><title>Kernel Configuration</title>
<sect3><title>What TO enable</title>
<para>In order to use the wireless tools, like <emphasis>iwconfig</emphasis>, which will allow you tell how good your connection is, you need to enable support for <emphasis>Wireless LAN (Non-Ham Rasio)</emphasis>.</para>
<para>In these examples, I use <screen>make menuconfig</screen> to configure my kernel.</para>
<para>You can do this by:</para>
<literallayout>
Go to:
Network Device support -->
then Select:
Wireless LAN (non-hamradio) --->
</literallayout>
<para>
Then Choose the options,
so that it looks like below, or something
as close to this.
Note I am uing 'make menuconfig'
to configure my kernel
</para>
<literallayout>
[*] Wireless LAN (non-hamradio)
< > STRIP (Metricom starmode radio IP)
< > AT T WaveLAN & DEC RoamAbout DS support
< > Aironet Arlan 655 & IC2200 DS support
< > Aironet 4500/4800 series adapters
< > Cisco/Aironet 34X/35X/4500/4800 ISA and PCI cards
<*> Hermes chipset 802.11b support (Orinoco/Prism2/Symbol)
< > Hermes in PLX9052 based PCI adaptor support
<*> Prism 2.5 PCI 802.11b adaptor support
</literallayout>
</sect3>
<sect3><title>What <emphasis>NOT</emphasis> to Enable</title>
<para>One of the main stumbling blocks was to realize that the <emphasis>pcmcia support in the kernel is not as good as the pcmcia-source support</emphasis> that one gets when you build it from pcmcia-source.
</para>
<para>I use either <screen>make xconfig</screen> or <screen>make menuconfig</screen> to configure my kernel, so when you configure your kernel, be sure to not have pcmcia support enabled under <screen>General setup</screen>
</para>
<para>Nor do you want to select any particular pcmcia card under <screen>Network device support</screen>. I repeat you do not want this under the kernel and you will be building it when you download pcmcia-source.</para> <caution><para>Be sure to download all the necessary components before you take pcmcia support out of the kernel, otherwise, if you were using a pcmcia card for net access, you will not be able to connect to the Internet using the new kernel, until you have built both pcmcia support and module drivers for the wireless card</para></caution>
</sect3>
</sect2>
</sect1>
<sect1>
<title>Using make-kpkg to build kernels</title>
<caution><para>Note: <emphasis>make-kpkg</emphasis> was installed when you installed <emphasis>kernel-package</emphasis></para></caution>
<para>Once you have configured your kernel just save and exit, and don't use make-kpkg yet! I will show you a good way to make sure sure everything builds well.</para>
<para>Follow the instruction in the make-kpkg documentation but essentially:</para>
<para>You need to be in the <screen>/usr/src/linux</screen> directory, then </para>
<screen>make-kpkg clean</screen>
<para>to clean all the binaries out and prepare to build a new kernel, then:</para>
<screen>make-kpkg --revision=custom.1.0 kernel_image</screen>
<caution><para>Don't Do this Yet!</para></caution>
<para>We need to get the pcmcia-source ready to be built at the same time as the kernel is built. This is a very neat feature of make-kpkg!</para>
</sect1>
<sect1><title>Building PCMCIA-SOURCE</title>
<para>First, be sure to download pcmcia-source, by typing <screen>apt-get install pcmcia-source</screen> This will download the source into <screen>/usr/src</screen> as <screen>pcmcia-source.tar.gz</screen></para>
<para>You now need to gunzip the file by <screen>gunzip pcmcia-source.tar.gz</screen> and then untar the file by <screen>tar xvf pcmcia-source.tar</screen></para>
<para>You should see pcmcia-source unpacked into the directory <screen>/usr/src/modules/pcmcia-cs</screen></para>
</sect1>
<sect1><title>Using make-kpkg to build the new kernel and pcmcia-source modules</title>
<para>Be sure the pcmcia-source is under /usr/src/modules.</para>
<para>Go ahead and configure your kernel and be sure that pcmcia support IS NOT compiled in as an option in the kernel.</para>
<para>To build the kernel and pcmcia-source, be sure you are under the <screen>/usr/src/linux</screen> or have a symbolic link from /usr/src/linux to whatever kernel source you have set up. Then type <screen>make-kpkg --revision=custom.1.0 kernel_image modules_image</screen></para>
<para>The <emphasis>kernel_image</emphasis> option will build the kernel while the <emphasis>modules_image</emphasis> option will build all modules located under <screen>/usr/src/modules/</screen>. So be sure that you do indeed want to rebuild any other modules that are located in source when you are ready to build your new kernel.</para>
<para>After some chugging, go up one level to <screen>/usr/src</screen> and you should see two new Debian packages that should look something like this:
<literallayout>
kernel-image-2.4.19-pre4_custom.1.0_i386.deb
pcmcia-modules-2.4.19-pre4_3.1.31-7+custom.1.0_i386.deb
</literallayout>
</para>
<para>You first want to install the kernel image so you would type <screen>dpkg -i kernel-image-etc....</screen></para>
<para>Now install the modules by typing <screen>dpkg -i pcmcia-modules.etc...</screen></para>
<caution><para>There are a couple of assumptions that make-kpkg makes about your lilo.conf file. One is that you have not radically changed it. Make-kpkg will make make symbolics links from '/boot' where the actual kernel resides to 'vmlinuz' which is under '/'. In other words, under '/', you will see <emphasis>vmlinuz</emphasis> and <emphasis>vmlinuz.old</emphasis> which are symbolic links to the real kernel images under <emphasis>/boot/</emphasis>. Anyway if you have any questions ask me.</para></caution>
</sect1>
<sect1><title>Wlan Drivers for You Link-Sys Card</title>
<para>You have downloaded the 11 Wlan project. Go a head and read the instruction, and put it under modules. Follow the instructions when you <screen>make config</screen> The one key is to make sure you specify the pcmcia-source as under <screen>/usr/src/modules/pcmcia-cs</screen> and not choose the default it gives you.</para>
<para>Go ahead and <screen>make all</screen> and <screen>make install</screen></para>
<para>I suggest you read the documentation that comes with it, but essentially, <emphasis>if you have a WAP that is connected to your DSL or cable modem then you have an <emphasis>infrastructure set up.</emphasis></emphasis> I found that it was best to edit the <screen>networks.opt</screen> under the <screen>/etc/pcmcia</screen> directory.</para>
<para>To make things easier edit the option
<literallayout># Use DHCP (via /sbin/dhcpcd, /sbin/dhclient, or /sbin/pump)? [y/n]
DHCP="y"</literallayout> to what I have, i.e., set it to yes.
</para>
<para>The documentation talks about setting ESSID but when you edit the <screen>wlan-ng.opts</screen> you will only see
<literallayout>
#=======INFRASTRUCTURE STATION START===================
# SSID is all we have for now
AuthType="opensystem" # opensystem | sharedkey (requires WEP)
DesiredSSID="howardnet"
</literallayout>
</para>
<para>From what I can gather,DesiredSSID means ESSID and it works when the WAP and link-sys pcmcia card share the same name.</para>
<para>At this point, you should reboot and should have a working link-sys card that gets its address via DHCP.</para>
</sect1>
<sect1><title>Checking things in case they don't work</title>
<para>1. Be sure to type <screen>ifconfig</screen></para>
<para>You should something like this</para>
<literallayout>
lo Link encap:Local Loopback
inet addr:127.0.0.1 Mask:255.0.0.0
UP LOOPBACK RUNNING MTU:16436 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:0 (0.0 b) TX bytes:0 (0.0 b)
wlan0 Link encap:Ethernet HWaddr 00:06:25:A8:AE:64
inet addr:192.168.1.104 Bcast:192.168.1.255 Mask:255.255.255.0
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:35197 errors:0 dropped:0 overruns:0 frame:0
TX packets:57676 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:100
RX bytes:43386657 (41.3 MiB) TX bytes:2670811 (2.5 MiB)
Interrupt:3 Base address:0x100
</literallayout>
<para>The keys point here are that <emphasis>inet addr:</emphasis>has a real IP address, and that <emphasis>Bcast</emphasis> and <emphasis>Netmask</emphasis> are set up such that they are on the same "wave-length" as your Wireless Access Point.</para>
<para>2. If you don't, you might have had the same problem I did which was that there was no easy script to initiate the wlan0 device setup. That is to say, if the card was recognized but you still did not get a connection and say that ifconfig showed wlan0 present but with no IP address. In other words, you might see something like this:</para>
<para><literallayout>
text:/home/dude# ifconfig
lo Link encap:Local Loopback
inet addr:127.0.0.1 Mask:255.0.0.0
UP LOOPBACK RUNNING MTU:16436 Metric:1
RX packets:14 errors:0 dropped:0 overruns:0 frame:0
TX packets:14 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:700 (700.0 b) TX bytes:700 (700.0 b)
wlan0 Link encap:Ethernet HWaddr 00:06:25:A8:AE:64
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:1 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:100
RX bytes:46 (46.0 b) TX bytes:0 (0.0 b)
Interrupt:3 Base address:0x100
</literallayout></para>
<para>As you can see, the interface device, the Wireless pcmcia card, is noted, but there is no <emphasis>inet addr</emphasis>. The pcmcia software recognized the card, but it has not successfully connected with the Wireless Access Point.</para>
<para>I used the <emphasis>pump</emphasis> command to send a simple DHCP request to the DHCP server for the device in question. I used<screen>pump -i wlan0</screen> which essentially runs a simple DHCP request to set up that card, wlan0, in this case.</para>
<para>You can get the <emphasis>pump</emphasis> by <screen>apt-get install pump</screen></para>
<para>While I needed to use <screen>pump -i wlan0</screen> on my laptop, I did not need this when I set up the link-sys wireless WPC11 card on my girlfriend's laptop. She has a Link-Sys WPC11 version 2.5 pcmcia card.</para>
</sect1>
<sect1><title>Wireless tools</title>
<para>While it is not necessary to include this in your kernel configuration, you can enable Wireless tool extensions by going (i assume you use xconfig or menuconfig) to <screen>Network device support</screen> and then go to <screen>Wireless LAN (non-hamradio)</screen> and enable support for the <screen>Hermes chipset 802.11b support (Orinoco/Prism2/Symbol)</screen>. This will let you use the Wireless Tools like <screen>iwconfig</screen>, <screen>iwspy</screen> and such.</para>
<para>The one thing I found this good for is that by repeated typing iwconfig, you can see your Link Quality. Its quite good</para>
</sect1>
<sect1>
<title>Wireless Access Point</title>
<para>The documentation that comes with the WAP is well written.
</para>
<para>
The only thing I haven't spoken about is enabling Wireless Encryption Protocol in the WAP (Wireless Access Point) which I really don't suggest as I don't think WEP has been properly set up in the drivers for the Pcmcia Wireless Cards. However, let me know if you have any problems and I will be glad to help.
</para>
</sect1>
<sect1><title>Request for comments</title>
<para>I will be glad to help anyone out and if things are a bit confusing in this quite mini how to, please tell me how I can fix it to make it better.</para>
<para>Thanks!</para></sect1>
</Article>