2.8 Components of SDCC

SDCC is not just a compiler, but a collection of tools by various developers. These include linkers, assemblers, simulators and other components. Here is a summary of some of the components. Note that the included simulator and assembler have separate documentation which you can find in the source package in their respective directories. As SDCC grows to include support for other processors, other packages from various developers are included and may have their own sets of documentation.

You might want to look at the files which are installed in <installdir>. At the time of this writing, we find the following programs:

In <installdir>/bin:

• sdcc - The compiler.
• sdcpp - The C preprocessor.
• asx8051 - The assembler for 8051 type processors.
• as-z80, as-gbz80 - The Z80 and GameBoy Z80 assemblers.
• aslink -The linker for 8051 type processors.
• link-z80, link-gbz80 - The Z80 and GameBoy Z80 linkers.
• s51 - The ucSim 8051 simulator.
• sdcdb - The source debugger.
• packihx - A tool to pack Intel hex files.

In <installdir>/share/sdcc/include

• the include files

In <installdir>/share/sdcc/lib

• the sources of the runtime library and the subdirs small large and ds390 with the precompiled relocatables.

In <installdir>/share/sdcc/doc

• the documentation

As development for other processors proceeds, this list will expand to include executables to support processors like AVR, PIC, etc.

2.8.1 sdcc - The Compiler

This is the actual compiler, it in turn uses the c-preprocessor and invokes the assembler and linkage editor.

2.8.2 sdcpp (C-Preprocessor)

The preprocessor is a modified version of the GNU preprocessor. The C preprocessor is used to pull in #include sources, process #ifdef statements, #defines and so on.

2.8.3 asx8051, as-z80, as-gbz80, aslink, link-z80, link-gbz80 (The Assemblers and Linkage Editors)

This is retargettable assembler & linkage editor, it was developed by Alan Baldwin. John Hartman created the version for 8051, and I (Sandeep) have made some enhancements and bug fixes for it to work properly with the SDCC.

2.8.4 s51 - Simulator

S51 is a freeware, opensource simulator developed by Daniel Drotos ( mailto:drdani@mazsola.iit.uni-miskolc.hu). The simulator is built as part of the build process. For more information visit Daniel's website at: http://mazsola.iit.uni-miskolc.hu/ drdani/embedded/s51 .

2.8.5 sdcdb - Source Level Debugger

Sdcdb is the companion source level debugger. The current version of the debugger uses Daniel's Simulator S51, but can be easily changed to use other simulators.