1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
3 <!--Converted with LaTeX2HTML 99.1 release (March 30, 1999)
4 original version by: Nikos Drakos, CBLU, University of Leeds
5 * revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
6 * with significant contributions from:
7 Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
10 <TITLE>2.8 Components of SDCC</TITLE>
11 <META NAME="description" CONTENT="2.8 Components of SDCC">
12 <META NAME="keywords" CONTENT="sdccman">
13 <META NAME="resource-type" CONTENT="document">
14 <META NAME="distribution" CONTENT="global">
16 <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
17 <META NAME="Generator" CONTENT="LaTeX2HTML v99.1 release">
18 <META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
20 <LINK REL="STYLESHEET" HREF="sdccman.css">
22 <LINK REL="previous" HREF="node17.html">
23 <LINK REL="up" HREF="node10.html">
24 <LINK REL="next" HREF="node19.html">
28 <!--Navigation Panel-->
31 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next_motif.gif"></A>
34 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up_motif.gif"></A>
37 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="previous_motif.gif"></A>
40 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents_motif.gif"></A>
43 <IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index_motif.gif"></A>
45 <B> Next:</B> <A NAME="tex2html474"
46 HREF="node19.html">3. Using SDCC</A>
47 <B> Up:</B> <A NAME="tex2html468"
48 HREF="node10.html">2. Installation</A>
49 <B> Previous:</B> <A NAME="tex2html464"
50 HREF="node17.html">2.7 Advanced Install Options</A>
51   <B> <A NAME="tex2html470"
52 HREF="node1.html">Contents</A></B>
53   <B> <A NAME="tex2html472"
54 HREF="node61.html">Index</A></B>
57 <!--End of Navigation Panel-->
58 <!--Table of Child-Links-->
59 <A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
62 <LI><A NAME="tex2html475"
63 HREF="node18.html#SECTION00038100000000000000">2.8.1 sdcc - The Compiler</A>
64 <LI><A NAME="tex2html476"
65 HREF="node18.html#SECTION00038200000000000000">2.8.2 sdcpp (C-Preprocessor)</A>
66 <LI><A NAME="tex2html477"
67 HREF="node18.html#SECTION00038300000000000000">2.8.3 asx8051, as-z80, as-gbz80, aslink, link-z80, link-gbz80 (The Assemblers
68 and Linkage Editors)</A>
69 <LI><A NAME="tex2html478"
70 HREF="node18.html#SECTION00038400000000000000">2.8.4 s51 - Simulator</A>
71 <LI><A NAME="tex2html479"
72 HREF="node18.html#SECTION00038500000000000000">2.8.5 sdcdb - Source Level Debugger</A>
74 <!--End of Table of Child-Links-->
77 <H2><A NAME="SECTION00038000000000000000">
78 2.8 Components of SDCC</A>
82 SDCC is not just a compiler, but a collection of tools by various
83 developers. These include linkers, assemblers, simulators and other
84 components. Here is a summary of some of the components. Note that
85 the included simulator and assembler have separate documentation which
86 you can find in the source package in their respective directories.
87 As SDCC grows to include support for other processors, other packages
88 from various developers are included and may have their own sets of
93 You might want to look at the files which are installed in <installdir>.
94 At the time of this writing, we find the following programs:
98 In <installdir>/bin:
103 <LI>sdcc - The compiler.</LI>
104 <LI>sdcpp - The C preprocessor.</LI>
105 <LI>asx8051 - The assembler for 8051 type processors.</LI>
106 <LI>as-z80<B>,</B> as-gbz80 - The Z80 and GameBoy Z80 assemblers.</LI>
107 <LI>aslink -The linker for 8051 type processors.</LI>
108 <LI>link-z80<B>,</B> link-gbz80 - The Z80 and GameBoy Z80 linkers.</LI>
109 <LI>s51 - The ucSim 8051 simulator.</LI>
110 <LI>sdcdb - The source debugger.</LI>
111 <LI>packihx - A tool to pack Intel hex files.</LI>
113 In <installdir>/share/sdcc/include
118 <LI>the include files</LI>
120 In <installdir>/share/sdcc/lib
125 <LI>the sources of the runtime library and the subdirs small large and
126 ds390 with the precompiled relocatables.</LI>
128 In <installdir>/share/sdcc/doc
133 <LI>the documentation</LI>
135 As development for other processors proceeds, this list will expand
136 to include executables to support processors like AVR, PIC, etc.
140 <H3><A NAME="SECTION00038100000000000000">
141 2.8.1 sdcc - The Compiler</A>
145 This is the actual compiler, it in turn uses the c-preprocessor and
146 invokes the assembler and linkage editor.
150 <H3><A NAME="SECTION00038200000000000000">
151 2.8.2 sdcpp (C-Preprocessor)</A>
155 The preprocessor is a modified version of the GNU preprocessor. The
156 C preprocessor is used to pull in #include sources, process #ifdef
157 statements, #defines and so on.
161 <H3><A NAME="SECTION00038300000000000000">
162 2.8.3 asx8051, as-z80, as-gbz80, aslink, link-z80, link-gbz80 (The Assemblers
163 and Linkage Editors)</A>
167 This is retargettable assembler & linkage editor, it was developed
168 by Alan Baldwin. John Hartman created the version for 8051, and I
169 (Sandeep) have made some enhancements and bug fixes for it to work
170 properly with the SDCC.
174 <H3><A NAME="SECTION00038400000000000000">
175 2.8.4 s51 - Simulator</A>
179 S51 is a freeware, opensource simulator developed by Daniel Drotos
180 ( mailto:drdani@mazsola.iit.uni-miskolc.hu). The simulator is
181 built as part of the build process. For more information visit Daniel's
182 website at: http://mazsola.iit.uni-miskolc.hu/ drdani/embedded/s51
187 <H3><A NAME="SECTION00038500000000000000">
188 2.8.5 sdcdb - Source Level Debugger</A>
192 Sdcdb is the companion source level debugger. The current version
193 of the debugger uses Daniel's Simulator S51, but can be easily changed
194 to use other simulators.
198 <!--Navigation Panel-->
199 <A NAME="tex2html473"
201 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next_motif.gif"></A>
202 <A NAME="tex2html467"
204 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up_motif.gif"></A>
205 <A NAME="tex2html463"
207 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="previous_motif.gif"></A>
208 <A NAME="tex2html469"
210 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents_motif.gif"></A>
211 <A NAME="tex2html471"
213 <IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index_motif.gif"></A>
215 <B> Next:</B> <A NAME="tex2html474"
216 HREF="node19.html">3. Using SDCC</A>
217 <B> Up:</B> <A NAME="tex2html468"
218 HREF="node10.html">2. Installation</A>
219 <B> Previous:</B> <A NAME="tex2html464"
220 HREF="node17.html">2.7 Advanced Install Options</A>
221   <B> <A NAME="tex2html470"
222 HREF="node1.html">Contents</A></B>
223   <B> <A NAME="tex2html472"
224 HREF="node61.html">Index</A></B>
225 <!--End of Navigation Panel-->
228 <BR><I>2001-07-13</I>