Documentation/INTEL-MONTEJADE-HOWTO

   1 Intel Monte Jade IXP425 Demonstration Platform
   2 ----------------------------------------------
   3
   4 1. Compiler Tool Chain
   5
   6    Before you can compile the Linux kernel, libraries and applications to
   7    generate a Monte Jade 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). You can
  10    also get this tool chain from the http://www.snapgear.org/downloads web
  11    site. To install this toolchain do:
  12
  13    1. login as root
  14    2. cd /
  15    3. tar xvzf arm-linux-tools-XXXXXXXX.tar.gz
  16
  17    This package contains binaries of the following GNU tools:
  18
  19         binutils (as of this writing version 2.14)
  20         gcc (as of this writing version 3.3.2)
  21         glibc (as of this writing version 2.2.5)
  22
  23 2. Building the Source
  24
  25    Follow these simple steps to compile binary images ready to run on the
  26    Intel Monte Jade board:
  27
  28    1.  tar xvzf uClinux-dist-XXXXXXXX.tar.gz
  29    2.  cd uClinux-dist
  30    3.  make xconfig
  31
  32        . Choose the "Target Platform Selection" menu item
  33        . Select the "Vendor/Product" tab and choose "Intel/MonteJade"
  34        . Select the "Libc version" tab and choose "Glibc"
  35        . "Save and Exit" this configuration
  36
  37    4.  make dep
  38    5.  make
  39
  40    That is it!  The final make step will run through and compile the Linux
  41    kernel, glibc library and a sample application set. It will also package
  42    the result into two files ready to load onto the Monte Jade board, zImage
  43    and ramdisk.gz.
  44
  45    Only the linux-2.4.x kernel can currently be used on the Monte Jade board.
  46    Either glibc or uClibc library can be used. There is no linux-2.6.x kernel,
  47    linux-2.0.x kernel or uC-libc support for this board.
  48
  49
  50 3.  Loading and Running
  51
  52     You will need the Intel Monte Jade board fitted with the RedBoot loader
  53     in flash. You should firstly setup RedBoot configuration with a client
  54     and server IP address (alternatively you can use the builtin DHCP
  55     support).
  56
  57     Copy the binary files from uClinux-dist, images/zImage and
  58     images/ramdisk.gz to the TFTP area of the download server.
  59
  60     To load and run Linux with directly from RAM issue the following commands:
  61
  62         load -r -v -b 0x01600000 zImage
  63         load -r -v -b 0x00800000 ramdisk.gz
  64         go  -n 0x01600000
  65
  66     You should see the Linux boot banner, and then be presented with a
  67     bash shell prompt. A reasonable utility set is in place, mostly using
  68     the busybox tool set.
  69
  70
  71 4. Saving to Flash with RedBoot
  72
  73    You can setup the flash memory to contain the newly build binaries
  74    instead of the pre-installed SnapGear Linux that is included on the
  75    Monte Jade board.
  76
  77    The following procedure describes howto setup and load Linux into
  78    the flash:
  79
  80      load -r -v -b 0x01600000 zImage
  81      fis write -f 0x50080000 -b 0x01600000 -l 0x100000
  82      load -r -v -b 0x00800000 ramdisk.gz
  83      fis write -f 0x50180000 -b 0x00800000 -l 0x600000
  84
  85    The default boot script and other Redboot setup does not need to be
  86    changed. On the next reboot the system will be running the new images.
  87
  88
  89 5. Customizing the Build
  90
  91    Using "make xconfig" in uClinux-dist you can customize the kernel and
  92    application configurations. There is a large selection of packages in
  93    the application configuration.
  94
  95    Consult the README file at the top level of uClinux-dist for some more
  96    information about configuration and building.
  97