workbench/devs/networks/atheros5000/hal/readme

   1 $Id: README,v 1.1.1.1 2008/08/20 04:41:19 sam Exp $
   2
   3 Atheros Hardware Access Layer (HAL)
   4 ===================================
   5
   6 Read the file COPYRIGHT for the complete copyright.
   7
   8 This code manages much of the chip-specific operation of the Atheros
   9 driver.
  10
  11 Atheros Hardware
  12 ================
  13 There are many generations of Atheros 802.11 wireless devices that
  14 are typically referred to by their programming model:
  15
  16 5210    supports 11a only
  17 5211    supports both 11a and 11b
  18 5212    supports 11a, 11b, and 11g
  19
  20 These parts have been incorporated in a variety of retail products
  21 including cardbus cards and mini-pci cards.  In addition many laptop
  22 vendors use Atheros mini-pci cards for their builtin wireless
  23 support.
  24
  25 The Atheros PCI vendor id is 0x168c.  The file ah_devid.h lists most
  26 known PCI device id's but is not exhaustive.  Some vendors program
  27 their own vendor and/or device id's to aid in BIOS-locking mini-pci
  28 cards in laptops.
  29
  30 Atheros SoC Hardware
  31 ====================
  32 In addition to the cardbus/pci devices Atheros makes System on Chip
  33 (SoC) parts that integrate a MIPS cpu core and one or more MAC and
  34 radio parts. Support for these parts is necessarily built
  35 for the embedded MIPS processor where the code is to be run.
  36
  37 Caveats
  38 =======
  39 The binary hal builds provided here include no floating point and
  40 are operating system-independent.  However due to toolchain
  41 peculiarities the .o files may be wrongly rejected by development
  42 tools.  If that happens it may be possible to patch the file header
  43 so that the native toolchain will accept the files.  In particular
  44 this has been observed for various Linux MIPS installations for the
  45 SoC parts.  If you have issues consult the associated .inc file in
  46 the public directory; it explains exactly how the binary file was
  47 created (e.g. toolchain and compilation options).