linux/Documentation/networking/ray_cs.txt
<<
on> " /spa4.8 " /form.8 " a on> " href="../linux+v3.7.7/Documenta="v4/networking/ray_cs.txt">on> " img src="../.sta="c/gfx/right.png" alt=">>">on /spa4.8on spa4 class="lxr_search">on> on> " input typ13on> " input typ13on> " butt vtyp13Search " onclick="return ajax_prefs();">on> " Prefs8 " /a>on /spa4.8> " /div.8> " form ac="v4="ajax+*" method="post" onsubmit="return false;">on input typ13o> " /form.8o> " div class="headingbott m"> " " " div id3 " /div.8 div id3 1 /a>September 21, 1999 2 /a>o 3 /a>Copyright (c) 1998 Corey Thomas (corey@world.std.com)o 4 /a>o 5 /a>This file is the documenta="v4 for the Raylink Wireless LAN card driver foro 6 /a>Linux. The Raylink wireless LAN card is a PCMCIA card which provides IEEEo 7 /a>802n v compa="ble wireless network connectivity at 1 and 2 megabits/second.o 8 /a>See a href="http://www.raytheon.com/micro/raylink/ ">http://www.raytheon.com/micro/raylink/ /a>for more informa="v4 vthe Raylinko 9 /a>card. This driver is in early development and does have bugs. See the knowno ', 'a>bugs and limita="v4s at the end of this document for more informa="v4.o 11 /a>This driver also works with WebGear's Aviator 2.v and Aviator Proo 12 /a>wireless LAN cards.o 13 /a>o 14 /a>As of kernel 2.3.18, the ray_cs driver is part of the Linux kernelo 15 /a>source. My web page for the development of ray_cs is ato 16 /a> a href="http://web.ralinktech.com/ralink/Home/Support/Linux.html ">http://web.ralinktech.com/ralink/Home/Support/Linux.html /a>o 17 /a>and I can be emailed at corey@world.std.como 18 /a>o 19 /a>The kernel driver is based vray_cs-1.62.tgz 20 /a>o 21 /a>The driver at my web page is intended to be used as an add vtoo 22 /a>David Hinds pcmcia package. All the command line param1ters areo 23 /a>available when compiled as a module. When built into the kernel, lyo 24 /a>the essid3 string param1ter is available via the kernel command line.o 25 /a>This will change after the method of sorting out param1ters for allo 26 /a>the PCMCIA drivers is agreed upv4. If you must have a built in drivero 27 /a>with nondefault param1ters, they can be edited ino 28 /a>/usr/src/linux/drivers/net/pcmcia/ray_cs.c. Searching for module_paramo 29 /a>will find them all.o 30 /a>o 31 /a>Informa="v4 vcard services is available at:o 32 /a> a href="http://pcmcia-cs.sourceforge.net/">http://pcmcia-cs.sourceforge.net/ /a>o 33 /a>o 34 /a>o 35 /a>Card services user programs are still required for PCMCIA devices.o 36 /a>pcmcia-cs-3.1.1 or greater is required for the kernel vers"v4 fo 37 /a>the driver.o 38 /a>o 39 /a>Currently, ray_cs is not part of David Hinds card services package,o 40 /a>so the following magic is required.o 41 /a>o 42 /a>At the end of the /etc/pcmcia/config.opts file, add the line: o 43 /a>source ./ray_cs.opts o 44 /a>This will make card services read the ray_cs.opts fileo 45 /a>when starting. Create the file /etc/pcmcia/ray_cs.opts containing theo 46 /a>following:o 47 /a>o 48 /a>#### start of /etc/pcmcia/ray_cs.opts ###################o 49 /a># Configura="v4 p="v4s for Raylink Wireless LAN PCMCIA cardo 50 /a>device "ray_cs"o 51 /a> class "network" module "misc/ray_cs"o 52 /a>o 53 /a>card "RayLink PC Card WLAN Adapter"o 54 /a> manfid 0x01a6, 0x0000o 55 /a> bind "ray_cs"o 56 /a>o 57 /a>module "misc/ray_cs" opts ""o 58 /a>#### end of /etc/pcmcia/ray_cs.opts #####################o 59 /a>o 60 /a>o 61 /a>To join an existing network witho 62 /a>different param1ters, contact the network administrator for the o 63 /a>configura="v4 informa="v4, and edit /etc/pcmcia/ray_cs.opts.o 64 /a>Add the param1ters below betwee vthe empty quotes.o 65 /a>o 66 /a>Param1ters for ray_cs driver which may be specified in ray_cs.opts:o 67 /a>o 68 /a>bc integer 0 = normal mode (802n v timing)o 69 /a> 1 = slow down inter fram1 timing to allowo 70 /a> " opera="v4 with older breezecom accesso 71 /a> " points.o 72 /a>o 73 /a>beacon_period integer beacon period in Kilo-microsecondso 74 /a> legal 4.8.1s = must be integer multiple o 75 /a> " " of hop dwello 76 /a> default = 256o 77 /a>o 78 /a>country integer 1 = USA (default)o 79 /a> 2 = Europeo 80 /a> 3 = Japano 81 /a> 4 = Koreao 82 /a> 5 = Spaino 83 /a> 6 = Franceo 84 /a> 7 = Israelo 85 /a> 8 = Australiao 86 /a>o 87 /a>essid string ESS ID - network nam1 to joino 88 /a> string with maximum length of 32 charso 89 /a> default 4.8.1 = "ADHOC_ESSID"o 90 /a>o 91 /a>hop_dwell integer hop dwell time in Kilo-microseconds o 92 /a> legal 4.8.1s = 16,32,64,128(default),256o 93 /a>o 94 /a>irq_mask integer linux standard 16 bit 4.8.1 1bit/IRQo 95 /a> lsb is IRQ 0, bit 1 is IRQ 1 etc.o 96 /a> Used to restrict choice of IRQ's to use.o 97 /a> Recommended method for controllingo 98 /a> interrupts is in /etc/pcmcia/config.optso 99 /a>o 100 /a>net_typ1 integer 0 (default) = adhoc network, o 101 /a> 1 = infrastructureo 102 /a>o 103 /a>phy_addr string string containing new MAC address ino 104 /a> hex, must start with x ego 105 /a> x00008f123456o 106 /a>o 107 /a>psm integer 0 = continuously ac="veo 108 /a> 1 = power save mode (not useful yet)o 109 /a>o 1', 'a>pc_debug integer (0-5) larger 4.8.1s for more verboseo 111 /a> logging. Replaces ray_debug.o 112 /a>o 113 /a>ray_debug integer Replaced with pc_debugo 114 /a>o 115 /a>ray_mem_speed integer defaults to 500o 116 /a>o 117 /a>sniffer integer 0 = not sniffer (default)o 118 /a> 1 = sniffer which can be used to record allo 119 /a> network traffic using tcpdump or similar, o 120 /a> " but no normal network use is allowed.o 121 /a>o 122 /a>translate integer 0 = no translat"v4 (encapsulate fram1s)o 123 /a> 1 = translat"v4 (RFC1042/802n )o 124 /a>o 125 /a>o 126 /a>More v4 sniffer mode:o 127 /a>o 128 /a>tcpdump does not understand 802n v headers, so it can'to 129 /a>interpret the contents, but it can record to a file. This is lyo 130 /a>useful for debugging 802n v lowlevel protocols that are not vis"ble too 131 /a>linux. If you want to watch ftp xfers, or do similar things, youo 132 /a>don't need to use sniffer mode. Also, some packet typ1s are nevero 133 /a>sent up by the card, so you will never see them (ack, rts, cts, probeo 134 /a>etc.) There is a simple program (showcap) included in the ray_cso 135 /a>package which parses the 802n v headers.o 136 /a>o 137 /a>Known Problems and missing featureso 138 /a>o 139 /a> Does not work with non x86o 140 /a>o 141 /a> Does not work with SMPo 142 /a>o 143 /a> Support for defragmenting fram1s is not yet debugged, and ino 144 /a> fact is known to not work. I have never encountered a net seto 145 /a> up to fragment, but still, it should be fixed.o 146 /a>o 147 /a> The ioctl support is incomplete. The hardware address cannot be seto 148 /a> using ifconfig yet. If a different hardware address is needed, it mayo 149 /a> be set using the phy_addr param1ter in ray_cs.opts. This requireso 150 /a> a card insert"v4 to take effect.o 151 /a> The original LXR software by the a href="http://sourceforge.net/projects/lxr">LXR community /a>, this experimental vers"v4 by a href="mailto:lxr@linux.no">lxr@linux.no /a>. /div.8 div class="subfooter"> lxr.linux.no kindly hosted by a href="http://www.redpill-linpro.no">Redpill Linpro AS /a>, provider of Linux consulting and opera="v4s services since 1995. /div.8 /body.8 /html.8