FreeCalypso > hg > freecalypso-sw
view doc/Compiling @ 812:b522307de6f2
aci: psa_ss?.c done
author | Space Falcon <falcon@ivan.Harhan.ORG> |
---|---|
date | Sun, 05 Apr 2015 07:58:27 +0000 |
parents | aad742029813 |
children | 4fa939eada22 |
line wrap: on
line source
There are 3 parts to the complete FreeCalypso software suite which are built independently of each other: * The tools that run on a GNU/Linux PC or other host system are the most straightforward: there is a top level Makefile (named Makefile.hosttools if you looking at a development source snapshot, will be renamed to just Makefile in packaged releases of the host tools) that coordinates building and installing all of them. * The gsm-fw tree, which will eventually become our main GSM firmware, needs to be built with a GNU cross-compiler toolchain for ARM7. This firmware can be built for several different target devices and with different feature configurations, hence there is no singular build for it - it's more like the Linux kernel in terms of its build configuration management. * We also have a few utilities which need to be compiled to run on Calypso targets, but which are not part of gsm-fw; they are gathered in the target-utils tree. They are built with the same GNU toolchain for ARM7 as gsm-fw, but don't have any fancy configuration system. Building and installing FreeCalypso host tools ============================================== If you are working with a packaged FC host tools release, just run 'make', then 'make install' as root. If you are working with a development source snapshot, do 'make -f Makefile.hosttools' instead. The "standard" install directories are /usr/local/bin for binaries and /usr/local/share/freecalypso for helper files. If you need to change these paths to something else, you'll need to edit a bunch of individual component Makefiles, and possibly also some source files like loadtools/defpath.c - sorry, FreeCalypso is not GNU and does not use autotools. Building and installing the ARM7 toolchain ========================================== The current "official" GNU ARM toolchain for FreeCalypso consists of binutils-2.21.1, gcc-4.5.4 and newlib-2.0.0 with a specific set of patches and build configuration options. Build it as follows: 1. Download these 3 source tarballs for the standard GNU+newlib components: binutils-2.21.1a.tar.bz2 gcc-core-4.5.4.tar.bz2 newlib-2.0.0.tar.gz 2. Run the build+install.sh script in the toolchain directory. Read the comments in the script first for the usage instructions. The toolchain thus built will need to be in your PATH before you can compile gsm-fw or target-utils. Please note: the toolchain that is prescribed for FreeCalypso as above is *believed* to be equivalent to the one used by OsmocomBB, but there are no guarantees. Use any other toolchain at your own risk. Compiling target-utils ====================== Running 'make' in the target-utils tree with the ARM7 toolchain present in your PATH will result in compalstage and loadagent being built; these are the two components needed in order to use FreeCalypso loadtools. Run 'make install' to install these target binaries in /usr/local/share/freecalypso, which is where loadtools will look for them. Run 'make all' in target-utils to build some other components that aren't really needed.