Documentation/INTEL-IXDP425-HOWTO

   1 Intel IXDP425
   2 -------------
   3
   4 1. Compiler Tool Chain
   5
   6    Before you can compile the Linux kernel, libraries and applications to
   7    generate an IXP425 image you must install an appropriate compiler tool
   8    chain. I suggest you use the arm-linux tool chain that accompanies this
   9    source distribution (the arm-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 arm-linux-tools-XXXXXXXX.tar.gz
  15
  16    This package contains binaries of the following tools:
  17
  18         binutils-2.14
  19         gcc-3.3.2
  20         glibc-2.2.5
  21
  22 2. Building the Source
  23
  24    Follow these simple steps to compile binary images ready to run on the
  25    Intel IXDP425 board:
  26
  27    1.  tar xvzf uClinux-dist-XXXXXXXX.tar.gz
  28    2.  cd uClinux-dist
  29    3.  make xconfig
  30
  31        . Choose the "Target Platform Selection" menu item
  32        . Select the "Vendor/Product" tab and choose "Intel/IXP425"
  33        . Select the "Libc version" tab and choose "Glibc"
  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, glibc library and a sample application set. It will also package
  41    the result into two files ready to load onto the IXDP425 board, zImage
  42    and ramdisk.gz.
  43
  44    Most often linux-2.4.x and glibc are used on this target, but uClibc
  45    and linux-2.6.x are also supported on this board.
  46
  47
  48 3. Loading and Running
  49
  50    You will need an Intel IXDP425 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/zImage and
  56    images/ramdisk.gz to the TFTP area of the download server.
  57
  58    To load and run Linux with RedBoot v1.92, issue the following commands:
  59
  60         load -r -v -b 0x01600000 zImage
  61         load -r -v -b 0x00800000 ramdisk.gz
  62         go  -n 0x01600000
  63
  64    To load and run Linux with RedBoot v2.0, issue the following commands:
  65
  66         load -r -v -b 0x11600000 zImage
  67         load -r -v -b 0x10800000 ramdisk.gz
  68         go 0x11600000
  69
  70
  71    You should see the Linux boot banner, and then be presented with a
  72    bash shell prompt. A reasonable utility set is in place, mostly using
  73    the busybox tool set. By default the rc script will run a dhcp client,
  74    and so with a local dhcp server in place Linux will acquire an IP
  75    address.
  76
  77
  78 4. Saving to Flash with RedBoot
  79
  80    You can setup the flash memory from within RedBoot to directly load
  81    and run linux.
  82
  83    The following procedure describes howto setup and load Linux into
  84    the flash:
  85
  86      fis init
  87      load -r -v -b 0x01600000 zImage
  88      fis create -b 0x01600000 -l 0xb0000 zImage
  89      load -r -v -b 0x00800000 ramdisk.gz
  90      fis create -b 0x00800000 -l 0x1d0000 ramdisk
  91
  92    Then create a boot script to automatically load and run:
  93
  94      fconfig
  95
  96         >> fis load -b 0x00800000 ramdisk
  97         >> fis load -b 0x01600000 zImage
  98         >> go -n 0x01600000
  99
 100    Note: the go "-n" argument is used to halt the NPE's BEFORE control is
 101          passed to kernel loaded as the NPE's can be in use by RedBoot.
 102
 103
 104 5. Customizing the Build
 105
 106    Using "make xconfig" in uClinux-dist you can customize the kernel and
 107    application configurations. There is a large selection of packages in
 108    the application configuration.
 109
 110    Consult the README file at the top level of uClinux-dist for some more
 111    information about configuration and building.
 112
 113    Note also that uClinux-dist does not contain the Intel Access Library or
 114    Drivers patch. So only the external PCI EEPRO 10/100 ethernet board can
 115    be used by default, neither of the builtin ethernet ports are active.
 116    To build with the Intel AccessLibrary to get the ethernet support goto
 117    Rob Ranslam's sourceforge project site:
 118
 119        http://ixp4xx-osdg.sourceforge.net
 120
 121    The "uClinux on the IXDP425 and IXP400 Access Library v1.2.2 Integration
 122    HOWTO" provides instructions and a script to integrate the Access Library
 123    with uClinux. There is also general information un using the IXDP425 and
 124    uClinux.
 125