Buildroot

For information on buildroot see the official site.

Open2x uses a modified version of the buildroot scripts to construct the skeleton environment to create a filesystem image on the GP2X.

Buildroot was heavily modified from the default version to support building a gLibC based filesystem (rather then the default ucLibC). It is also tied to the various Open2x toolchains and uses them to build libraries and applications used in the filesystem image.

Currently, the version of Buildroot stored in the SVN builds only a very basic system using BusyBox and gLibC, and the Open2x kernel toolchain is required for building the system. However, these limitations should be lifted in the near future.

To use buildroot, simply checkout a copy of the latest SVN code, 'cd' into the directory and 'make menuconfig'. This will bring you to a curses-based menu, like those used in the Linux kernel, from which you can select which programs and libraries will be built and what kind of output image will be produced. Once you have selected the desired options, save the configuration as you exit, and 'make'. All the compilation and configuration will be handled automatically and an output image will be generated in the 'build_' directory, ready for flashing to the NAND or booting from SD.

If you want to edit or any files in the image, edit the copy of the filesystem held within 'build_/root' after compilation is complete, delete the old image and re-issue the 'make' command to force a new image to be built.

TODO: Write a complete guide to using buildroot/adding makefiles etc.

NOTES: You must have automake and autoconf installed in order to build SDL out of the SVN! sdl-config is broken. You need to manually open it and tell it where to find the SDL headers (by default it points to /include for a currently unknown reason)

The buildroot/filesystem project is primarily led by User:Orkie.