Documentation/ATHEROS-PB42-HOWTO

   1 Atheros PB42
   2 ------------
   3
   4 1. Compiler Tool Chain
   5
   6    Before you can compile the Linux kernel, libraries and applications to
   7    generate a PB42 image you must install an appropriate compiler tool
   8    chain. I suggest you use the mips-linux tool chain that accompanies this
   9    source distribution (the mips-linux-tools-XXXXXXXX.tar.gz package). To
  10    install this toolchain do:
  11
  12    1. login as root
  13    2. cd /
  14    3. tar xvzf mips-linux-tools-XXXXXXXX.tar.gz
  15
  16    This package contains binaries of the following tools:
  17
  18         binutils-2.17
  19         gcc-3.4.4
  20         glibc-2.3.6
  21
  22 2. Building the Source
  23
  24    Follow these simple steps to compile binary images ready to run on the
  25    Atheros PB42 board:
  26
  27    1.  tar xvzf uClinux-dist-XXXXXXXX.tar.gz
  28    2.  cd uClinux-dist
  29    3.  make menuconfig
  30
  31        . Choose the "Target Platform Selection" menu item
  32        . Select the "Vendor/Product" tab and choose "Atheros/PB42"
  33        . Select the "Libc version" tab and choose "uClibc"
  34        . "Save and Exit" this configuration
  35
  36    4.  make dep
  37    5.  make
  38
  39    That is it!  The final make step will run through and compile the Linux
  40    kernel, uClibc library and a sample application set. It will also package
  41    the result into two files ready to load onto the PB42 board, vmlinux
  42    and ramdisk.gz.
  43
  44    The currently only support kernel is 2.6.x and only library is uClibc.
  45    Don't choose any of the other kernels or libraries for this platform.
  46
  47
  48 3. Loading and Running
  49
  50    You will need a Atheros PB42 board fitted with the RedBoot loader in
  51    flash. You should firstly setup RedBoot configuration with a client
  52    and server IP address (alternatively you can use the builtin DHCP
  53    support).
  54
  55    Copy the binary files from uClinux-dist, images/vmlinux and
  56    images/ramdisk.gz to the TFTP area of the download server.
  57
  58    To load and run Linux with RedBoot issue the following commands:
  59
  60         load -r -b 0x80800000 ramdisk.gz
  61         load -b 0x80060000 vmlinux
  62         exec -c "console=ttyS0,115200 rd_start=0x80800000 rd_size=4M root=/dev/ram0"
  63
  64    You should see the Linux boot banner, and then be presented with a
  65    bash shell prompt. A reasonable utility set is in place, mostly using
  66    the busybox tool set. By default the rc script will run a dhcp client,
  67    and so with a local dhcp server in place Linux will acquire an IP
  68    address.
  69
  70
  71 4. Saving to Flash with RedBoot
  72
  73    You can setup the flash memory from within RedBoot to directly load
  74    and run linux.
  75
  76    The following procedure describes howto setup and load Linux into
  77    the flash:
  78
  79      fis init
  80      load -r -v -b 0x01600000 zImage
  81      fis create -b 0x01600000 -l 0xb0000 zImage
  82      load -r -v -b 0x00800000 ramdisk.gz
  83      fis create -b 0x00800000 -l 0x1d0000 ramdisk
  84
  85    Then create a boot script to automatically load and run:
  86
  87      fconfig
  88
  89         >> fis load -b 0x00800000 ramdisk
  90         >> fis load -b 0x01600000 zImage
  91         >> go 0x01600000
  92
  93 5. Customizing the Build
  94
  95    Using "make menuconfig" in uClinux-dist you can customize the kernel and
  96    application configurations. There is a large selection of packages in
  97    the application configuration.
  98
  99    Consult the README file at the top level of uClinux-dist for some more
 100    information about configuration and building.
 101