|Tollos – directory structure|
Tollos code and libraries are held in a simple directory structure, where all applications and libraries have a unique name and are held at the same ‘level’ in a common directory (typically called ‘tollos’).
Each application or library directory contains:
There may also be additional material (notes, documentation, link scripts, etc.).
Keeping both the .c and .h files in the same directory is somewhat unconventional, but is convenient because they often have to be edited at the same time, and they form a logical unit.
Some devices also require manufacturer-supplied header or source code files (for example, for definitions of register names, addresses, and bits). These are always held in a subdirectory named ‘public’. The header files for a library can therefore be found by adding to the include path (a) the name of the directory and (b) a subdirectory of it called public.
The name of the final application binary or library archive is always the same as the name of the directory in which it is constructed; this similarly allows easy location of any libraries needed at link time.
In the sample application distribution, each directory has a short script that can be used to build it (on Windows, XP or later). This script is called churn.bat, and simply sets a few environment variables to indicate
The charm.bat script (in the tollos directory) is then called to effect the build. This compiles all the modules specified, combines the object files as requested to form the final binary or archive, and then deletes the object files. This approach keeps the directories uncluttered and avoids any need to specify dependencies.
Please see the start of charm.bat for the environment variables that may be used to affect its operation.
|Tollos and these web pages were written by Mike Cowlishaw; Please send me any corrections, suggestions, etc.|
All content © Mike Cowlishaw, 2010–2012, except where marked
otherwise. All rights reserved. The pages here are for non-commercial
use only (see the separate licence for Tollos source code).
records no personal information and sets no ‘cookies’.
However, statistics, etc. might be recorded by the web hosting
This page was last updated on 2011-10-07 by mfc.