drivers/net/wireless/acx/README

   1 This tarball is targeted at 2.6 inclusion only.
   2 Not designed to work or even compile with 2.4.
   3
   4 Contact:
   5 netdev@vger.kernel.org
   6 acx100-devel@lists.sourceforge.net
   7 acx100-users@lists.sourceforge.net
   8
   9 Bug reports:
  10
  11 Visit http://www.catb.org/~esr/faqs/smart-questions.html
  12
  13 Please describe your wireless setup, manufacturer and type
  14 (acx100/acx100usb/acx111?) of your hardware. Which firmware image(s)
  15 are you using? If problem is reproducible, #define ACX_DEBUG 2
  16 in acx_config.h and modprobe driver with debug=0xffff.
  17 Post resulting kernel log (bzipped). It is large but very useful
  18 for bug hunting. Try older versions of the driver.
  19
  20 Firmware images:
  21
  22 You should not supply firmware_dir= parameter anymore. Driver will try
  23 to load the following images via hotplug (not from /usr/share/acx
  24 directory as older driver did, hotplug firmware directory location
  25 varies for different distros, try /lib/firmware or
  26 /usr/lib/hotplug/firmware):
  27
  28 PCI driver:
  29 'tiacxNNNcMM' (NNN=100/111, MM=radio module ID (in uppercase hex)):
  30 combined firmware for specified chipset and radio.
  31 Failing that, it will try to load images named 'tiacxNNN'
  32 (main firmware for specified chipset) and 'tiacxNNNrMM' (corresponding
  33 radio module). For example, my firmware is in file named 'tiacx111c16'.
  34 Alternatively, I may remove it and use pair of files 'tiacx111' and
  35 'tiacx111r16' instead.
  36 USB driver:
  37 image is named 'tiacxNNNusbcMM'
  38
  39 Build instructions:
  40
  41 * Create drivers/net/wireless/acx subdirectory inside
  42   your kernel tree.
  43 * BTW, if your kernel has drivers/net/wireless/tiacx directory,
  44   you already may have acx driver (some different version).
  45   Decide which one do you want.
  46 * Unpack tarball into drivers/net/wireless/acx directory.
  47 * Add a line to drivers/net/wireless/Makefile:
  48         obj-m += acx/
  49 * Build your modules as usual (perhaps "make modules modules_install").
  50
  51 This will create acx module.
  52
  53 Remove "acx-obj-y += usb.o" line in Makefile
  54 and "#define CONFIG_ACX_USB 1" line in acx_config.h
  55 if you want PCI-only driver. Ditto for USB-only one.
  56
  57 USB snooping:
  58
  59 If you are an USB driver developer and need to see USB traffic,
  60 http://benoit.papillault.free.fr/usbsnoop/ may be useful.
  61 Another very good way to snoop the USB frames is under Linux if your
  62 driver happens to run under ndiswrapper (which is often the case),
  63 either by savage printk's, or by using the USB snooping facilities from
  64 Pete Zaitcev.
  65
  66
  67 From: Per Bjornsson <perbj@stanford.edu>
  68 To: ACX100 user mailing list <acx100-users@lists.sourceforge.net>
  69 Date: Fri, 08 Jul 2005 13:44:26 -0700
  70
  71 Hi,
  72
  73 Just a note for those who, like me, prefer not to bother recompiling
  74 their whole kernel: It's not at all difficult to compile Denis's
  75 snapshots out of tree, despite what the readme file says! At least in
  76 somewhat recent 2.6.x kernels, there's a special syntax for compiling
  77 modules in a particular directory (as noted in the kernel docs in
  78 Documentation/kbuild/modules.txt):
  79
  80       * Unpack Denis's tarball in a new directory (note that the
  81         tarballs currently don't contain a root directory, just the
  82         files, so you want to do the untarring in an empty directory)
  83       * If you're building for the currently running kernel, build the
  84         modules with the command
  85         make -C /lib/modules/`uname -r`/build M=`pwd`
  86       * Install the modules (must be root for this step, so use
  87         'su' if that's your preferred method of doing root stuff) with
  88         make -C /lib/modules/`uname -r`/build M=`pwd` modules_install
  89
  90 I figured that the snapshots might get more testing if more people know
  91 that they don't have to muck around with the whole kernel source in
  92 order to build this. I tested this on Fedora Core 4; sane distributions
  93 should be using this setup for accessing the kernel build files (if they
  94 listened to Linus's suggestions anyways). The one trick is that you
  95 might need a special "kernel development files" package; on Fedora Core,
  96 the files are included in the regular kernel package for FC2 and 3 but
  97 you need the 'kernel-devel' package for FC4.
  98
  99 And finally, the kernel won't figure out that the module has been
 100 installed until you run 'depmod -ae' as root. You can check that
 101 something useful got picked up with 'modinfo'. (Both of these commands
 102 are likely installed in /sbin so you might need the full path unless
 103 you're fully logged in as root.)
 104
 105 The latest snapshot (acx-20050708.tar.bz2) generally seems to work well
 106 for me, except that it's somewhat noisy and reports a lot of DUPs in the
 107 system log. However, it appears to associate more consistently with my
 108 access point that the old versions (when I had those modprobed on boot
 109 and brought up by the system network scripts, the card would often just
 110 sit and scan around and never actually associate until I manually
 111 restarted the connection) - admittedly I've only tried a couple of times
 112 yet so I don't know just how consistent this is. My hardware is a
 113 Netgear WG311v2, using the firmware from the latest Netgear Windows
 114 driver. (Can't check the details right now since I'm not at that
 115 computer, sorry - it got too late when I was mucking with this and other
 116 stuff yesterday for me to get a message sent...)
 117
 118 Cheers,
 119 Per
 120 --
 121 Per Bjornsson <perbj@stanford.edu>
 122 Ph.D. Candidate, Department of Applied Physics, Stanford University