Home      About      News      FAQ      Documentation      Download      Buy      Link

Documentation

Documentation is included with the src packages, but this page will help you get up and running quickly.

Instructions for compiling:

  1. Install a tool chain. If you are using a binary tool chain package then install that now. If you are building your own tool chain, then do that now.

  2. Un-archive the source package. It is a gziped tar image, so do:
            tar xvzf snapgear-XXXXXXXX.tar.gz
    
    This will dump the source into a snapgear directory. Typically you would do this somewhere in your local user directory. (Good practice dictactes that you don't build things like this as root :-)
  3. Cd into the source tree:
            cd snapgear
    
  4. Configure the Linux kernel. Configure the build for your specific target. Do the following:
            make xconfig
    
    Or you can use the menuconfig or config make target if you are not running the X windows system on your development machine.

    The top level selection is strait forward if you know the vendor of the board you want to compile for. You can choose also to modify the underlying default kernel and application configuration if you want.

    At first I suggest using the default configuration for your vendors board. It will almost certainly work as is on your board.

  5. Build the dependencies:
            make dep
    
  6. Build the image:
            make
    

Thats it!

The exact binary files produced depends on your target. The binaries files generated will be in the images directory.

Instructions for running

This is totally dependant on your target board. They are all different.

Check in the Documentation directory at the top level of the source tree for a HOWTO file for your specific board. If present it will list exactly how to load and run images generated from this source.

Otherwise you will need to consult the documentation supplied with your board.

Notes

Console output is generally from the primary serial port. The baud rate is typically the default for that board.

You should see the Linux kernel startup messages come out. The shell is interactive, a reasonable set of tools is available and can be executed.