git.gag.com Git - fw/sdcc/blob - doc/sdccman.html/node18.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
   2
   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 -->
   8 <HTML>
   9 <HEAD>
  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">
  15
  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">
  19
  20 <LINK REL="STYLESHEET" HREF="sdccman.css">
  21
  22 <LINK REL="previous" HREF="node17.html">
  23 <LINK REL="up" HREF="node10.html">
  24 <LINK REL="next" HREF="node19.html">
  25 </HEAD>
  26
  27 <BODY >
  28 <!--Navigation Panel-->
  29 <A NAME="tex2html473"
  30  HREF="node19.html">
  31 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next_motif.gif"></A>
  32 <A NAME="tex2html467"
  33  HREF="node10.html">
  34 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up_motif.gif"></A>
  35 <A NAME="tex2html463"
  36  HREF="node17.html">
  37 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="previous_motif.gif"></A>
  38 <A NAME="tex2html469"
  39  HREF="node1.html">
  40 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents_motif.gif"></A>
  41 <A NAME="tex2html471"
  42  HREF="node61.html">
  43 <IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index_motif.gif"></A>
  44 <BR>
  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  &nbsp <B>  <A NAME="tex2html470"
  52  HREF="node1.html">Contents</A></B>
  53  &nbsp <B>  <A NAME="tex2html472"
  54  HREF="node61.html">Index</A></B>
  55 <BR>
  56 <BR>
  57 <!--End of Navigation Panel-->
  58 <!--Table of Child-Links-->
  59 <A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
  60
  61 <UL>
  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>
  73 </UL>
  74 <!--End of Table of Child-Links-->
  75 <HR>
  76
  77 <H2><A NAME="SECTION00038000000000000000">
  78 2.8 Components of SDCC</A>
  79 </H2>
  80
  81 <P>
  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
  89 documentation.
  90 <BR>
  91
  92 <BR>
  93 You might want to look at the files which are installed in &lt;installdir&gt;.
  94 At the time of this writing, we find the following programs:
  95 <BR>
  96
  97 <BR>
  98 In &lt;installdir&gt;/bin:
  99
 100 <P>
 101
 102 <UL>
 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>
 112 </UL>
 113 In &lt;installdir&gt;/share/sdcc/include
 114
 115 <P>
 116
 117 <UL>
 118 <LI>the include files</LI>
 119 </UL>
 120 In &lt;installdir&gt;/share/sdcc/lib
 121
 122 <P>
 123
 124 <UL>
 125 <LI>the sources of the runtime library and the subdirs small large and
 126 ds390 with the precompiled relocatables.</LI>
 127 </UL>
 128 In &lt;installdir&gt;/share/sdcc/doc
 129
 130 <P>
 131
 132 <UL>
 133 <LI>the documentation</LI>
 134 </UL>
 135 As development for other processors proceeds, this list will expand
 136 to include executables to support processors like AVR, PIC, etc.
 137
 138 <P>
 139
 140 <H3><A NAME="SECTION00038100000000000000">
 141 2.8.1 sdcc - The Compiler</A>
 142 </H3>
 143
 144 <P>
 145 This is the actual compiler, it in turn uses the c-preprocessor and
 146 invokes the assembler and linkage editor.
 147
 148 <P>
 149
 150 <H3><A NAME="SECTION00038200000000000000">
 151 2.8.2 sdcpp (C-Preprocessor)</A>
 152 </H3>
 153
 154 <P>
 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.
 158
 159 <P>
 160
 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>
 164 </H3>
 165
 166 <P>
 167 This is retargettable assembler &amp; 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.
 171
 172 <P>
 173
 174 <H3><A NAME="SECTION00038400000000000000">
 175 2.8.4 s51 - Simulator</A>
 176 </H3>
 177
 178 <P>
 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/&nbsp;drdani/embedded/s51
 183 .
 184
 185 <P>
 186
 187 <H3><A NAME="SECTION00038500000000000000">
 188 2.8.5 sdcdb - Source Level Debugger</A>
 189 </H3>
 190
 191 <P>
 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.
 195
 196 <P>
 197 <HR>
 198 <!--Navigation Panel-->
 199 <A NAME="tex2html473"
 200  HREF="node19.html">
 201 <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next_motif.gif"></A>
 202 <A NAME="tex2html467"
 203  HREF="node10.html">
 204 <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up_motif.gif"></A>
 205 <A NAME="tex2html463"
 206  HREF="node17.html">
 207 <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="previous_motif.gif"></A>
 208 <A NAME="tex2html469"
 209  HREF="node1.html">
 210 <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents_motif.gif"></A>
 211 <A NAME="tex2html471"
 212  HREF="node61.html">
 213 <IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index_motif.gif"></A>
 214 <BR>
 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  &nbsp <B>  <A NAME="tex2html470"
 222  HREF="node1.html">Contents</A></B>
 223  &nbsp <B>  <A NAME="tex2html472"
 224  HREF="node61.html">Index</A></B>
 225 <!--End of Navigation Panel-->
 226 <ADDRESS>
 227 <I>Johan Knol</I>
 228 <BR><I>2001-07-13</I>
 229 </ADDRESS>
 230 </BODY>
 231 </HTML>