SDCC is a Free ware, retargettable, optimizing ANSI-C compiler by Sandeep Dutta designed for 8 bit Microprocessors. The current version targets Intel MCS51 based Microprocessors(8051,8052, etc), Zilog Z80 based MCUs, and the Dallas 80C390 MCS51 variant. It can be retargetted for other microprocessors, support for PIC, AVR and 186 is under development. The entire source code for the compiler is distributed under GPL. SDCC uses ASXXXX & ASLINK, a Freeware, retargettable assembler & linker. SDCC has extensive language extensions suitable for utilizing various microcontrollers underlying hardware effectively. In addition to the MCU specific optimizations SDCC also does a host of standard optimizations like global sub expression elimination, loop optimizations (loop invariant, strength reduction of induction variables and loop reversing), constant folding & propagation, copy propagation, dead code elimination and jumptables for 'switch' statements. For the back-end SDCC uses a global register allocation scheme which should be well suited for other 8 bit MCUs. The peep hole optimizer uses a rule based substitution mechanism which is MCU independent. Supported data-types are short (8 bits, 1 byte), char (8 bits, 1 byte), int (16 bits, 2 bytes ), long (32 bit, 4 bytes) & float (4 byte IEEE). The compiler also allows inline assembler code to be embedded anywhere in a function. In addition routines developed in assembly can also be called. SDCC also provides an option to report the relative complexity of a function, these functions can then be further optimized, or hand coded in assembly if need be. SDCC also comes with a companion source level debugger SDCDB, the debugger currently uses ucSim a freeware simulator for 8051 and other micro-controllers. The latest version can be downloaded from http://sdcc.sourceforge.net/.
All packages used in this compiler system are opensource(freeware); source code for all the sub-packages (asxxxx assembler/linker, pre-processor) are distributed with the package. This documentation is maintained using a freeware word processor (LYX).
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. In other words, you are welcome to use, share and improve this program. You are forbidden to forbid anyone else to use, share and improve what you give them. Help stamp out software-hoarding!
What do you need before you start installation of SDCC? A computer, and a desire to compute. The preferred method of installation is to compile SDCC from source using GNU GCC and make. For Windows some pre-compiled binary distributions are available for your convenience. You should have some experience with command line tools and compiler use.
The SDCC home page at http://sdcc.sourceforge.net/ is a great place to find distribution sets. You can also find links to the user mailing lists that offer help or discuss SDCC with other SDCC users. Web links to other SDCC related sites can also be found here. This document can be found in the DOC directory of the source package as a text or HTML file. Some of the other tools(simulator and assembler) included with SDCC contain their own documentation and can be found in the source distribution. If you want the latest unreleased software, the complete source package is available directly by anonymous CVS on www.sourceforge.net.
For installation under Windows you first need to pick between a pre-compiled binary package, or installing the source package along with the Cygwin package. The binary package is the quickest to install, while the Cygwin package includes all of the open source power tools used to compile the complete SDCC source package in the Windows environment. If you are not familiar with the Unix command line environment, you may want to read the section on additional information for Windows users prior to your initial installation.
The first thing you should do after installing your SDCC compiler is to see if it runs. Type ``sdcc -version'' at the prompt, and the program should run and tell you the version. If it doesn't run, or gives a message about not finding sdcc program, then you need to check over your installation. Make sure that the sdcc bin directory is in your executable search path defined by the PATH environment setting(see the Trouble-shooting section for suggestions). Make sure that the sdcc program is in the bin folder, if not perhaps something did not install correctly.
SDCC binaries are commonly installed in a directory arrangement like this:
/usr/local/bin | Holds executables(sdcc, s51, aslink, ...) |
/usr/local/share/sdcc/lib | Holds common C libraries |
/usr/local/share/sdcc/include | Holds common C header files |
Make sure the compiler works on a very simple example. Type in the following test.c program using your favorite editor:
main()
{ int i;
i = 0;
i += 10;
}
Compile this using the following command: ``sdcc -c test.c''. If all goes well, the compiler will generate a test.asm and test.rel file. Congratulations, you've just compiled your first program with SDCC. We used the -c option to tell SDCC not to link the generated code, just to keep things simple for this step.
The next step is to try it with the linker. Type in ``sdcc test.c''. If all goes well the compiler will link with the libraries and produce a test.ihx output file. If this step fails(no test.ihx, and the linker generates warnings), then the problem is most likely that sdcc cannot find the usr/local/share/sdcc/lib/small directory(see the Install trouble-shooting section for suggestions).
The final test is to ensure sdcc can use the standard header files and libraries. Edit test.c and change it to the following:
#include <string.h>
main()
{ char str1[10];
strcpy(str1, ``testing'');
}
Compile this by typing: ``sdcc test.c''. This should generate a test.ihx output file, and it should give no warnings such as not finding the string.h file. If it cannot find the string.h file, then the problem is that sdcc cannot find the /usr/local/share/sdcc/include directory(see the Install trouble-shooting section for suggestions).
The default installation assumes the libraries and header files are located at ``/usr/local/share/sdcc/lib'' and ``/usr/local/share/sdcc/include''. An alternative is to specify these locations as compiler options like this: sdcc -L /usr/local/sdcc/lib/small -I /usr/local/sdcc/include test.c
A few things to try include starting from scratch by unpacking the .tgz source package again in an empty directory. If this doesn't work, you could try downloading a different version. If this doesn't work, you can re-direct the install messages by doing the following:
$./make > dump.txt 2>&1
After this you can examine the dump.txt files to locate the problem. Or these messages can be attached to an email that could be helpful when requesting help from the mailing list.
The ``./configure'' command is a script that analyzes your system and performs some configuration to ensure the source package compiles on your system. It will take a few minutes to run, and will compile a few tests to determine what compiler features are installed.
This runs the GNU make tool, which automatically compiles all the source packages into the final installed binary executables.
This will install the compiler, other executables and libraries in to the appropriate system directories. The default is to copy the executables to /usr/local/bin and the libraries and header files to /usr/local/share/sdcc/lib and /usr/local/share/sdcc/include.
The standard method of installing on a Unix system involves compiling the source package. This is easily done under Unix, but under Windows it can be a more difficult process. The Cygwin is a large package to download, and the compilation runs considerably slower under Windows due to the overhead of the Cygwin tool set. An alternative is to install a pre-compiled Windows binary package. There are various trade-offs between each of these methods.
The Cygwin package allows a Windows user to run a Unix command line interface(bash shell) and also implements a Unix like file system on top of Windows. Included are many of the famous GNU software development tools which can augment the SDCC compiler.This is great if you have some experience with Unix command line tools and file system conventions, if not you may find it easier to start by installing a binary Windows package. The binary packages work with the Windows file system conventions.
SDCC is typically distributed as a tarred/gzipped file(.tgz). This is a packed file similar to a .zip file. Cygwin includes the tools you will need to unpack the SDCC distribution(tar and gzip). To unpack it, simply follow the instructions under the Linux/Unix install section. Before you do this you need to learn how to start a cygwin shell and some of the basic commands used to move files, change directory, run commands and so on. The change directory command is ``cd'', the move command is ``mv''. To print the current working directory, type ``pwd''. To make a directory, use ``mkdir''.
There are some basic differences between Unix and Windows file systems you should understand. When you type in directory paths, Unix and the Cygwin bash prompt uses forward slashes '/' between directories while Windows traditionally uses '\' backward slashes. So when you work at the Cygwin bash prompt, you will need to use the forward '/' slashes. Unix does not have a concept of drive letters, such as ``c:``, instead all files systems attach and appear as directories.
If you use the pre-compiled binaries, the install directories for the libraries and header files may need to be specified on the sdcc command line like this: sdcc -L c:\usr\local\sdcc\lib\small -I c:\usr\local\sdcc\include test.c if you are running outside of a Unix bash shell.
If you have successfully installed and compiled SDCC with the Cygwin package, it is possible to compile into native .exe files by using the additional makefiles included for this purpose. For example, with the Borland 32-bit compiler you would run make -f Makefile.bcc. A command line version of the Borland 32-bit compiler can be downloaded from the Inprise web site.
The ``configure'' command has several options. The most commonly used option is -prefix=<directory name>, where <directory name> is the final location for the sdcc executables and libraries, (default location is /usr/local). The installation process will create the following directory structure under the <directory name> specified.
bin/ - binary exectables (add to PATH environment variable)
share/
sdcc/include/ - include header files
sdcc/lib/ -
small/ - Object & library files for small
model library
large/ - Object & library files for large
model library
ds390/ - Object & library files forDS80C390
library
The command
'./configure -prefix=/usr/local''
will configure the compiler to be installed in directory /usr/local/bin.
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 various executables which are installed in the bin directory. At the time of this writing, we find the following programs:
sdcc - The compiler.
aslink -The linker for 8051 type processors.
asx8051 - The assembler for 8051 type processors.
sdcpp - The C preprocessor.
sdcpd - The source debugger.
s51 - The ucSim 8051 simulator.
linkz80, linkgbz80 - The Z80 and GameBoy Z80 linkers.
as-z80, as-gbz80 - The Z80 and GameBoy Z80 assemblers.
packihx - A tool to pack Intel hex files.
As development for other processors proceeds, this list will expand to include executables to support processors like AVR, PIC, etc.
The preprocessor is extracted into the directory SDCCDIR/cpp, it 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.
This is retargettable assembler & linkage editor, it was developed by Alan Baldwin, John Hartman created the version for 8051, and I (Sandeep) have some enhancements and bug fixes for it to work properly with the SDCC. This component is extracted into the directory SDCCDIR/asxxxx.
This is the actual compiler, it in turn uses the c-preprocessor and invokes the assembler and linkage editors. All files with the prefix SDCC are part of the compiler and are extracted into the the directory SDCCDIR.
s51 is a freeware, opensource simulator developed by Daniel Drotos <drdani@mazsola.iit.uni-miskolc.hu>. The executable 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/>.
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.
For single source file 8051 projects the process is very simple. Compile your programs with the following command
sdcc sourcefile.c
The above command will compile ,assemble and link your source file. Output files are as follows.
SDCC can compile only ONE file at a time. Let us for example assume that you have a project containing the following files.
foo1.c ( contains some functions )
foo2.c (contains some more functions)
foomain.c (contains more functions and the function main)
The first two files will need to be compiled separately with the commands
sdcc -c foo1.c
sdcc -c foo2.c
Then compile the source file containing main and link the other files together with the following command.
sdcc foomain.c foo1.rel foo2.rel
Alternatively foomain.c can be separately compiled as well
sdcc -c foomain.c
sdcc foomain.rel foo1.rel foo2.rel
The file containing the main function MUST be the FIRST file specified in the command line , since the linkage editor processes file in the order they are presented to it.
Some reusable routines may be compiled into a library, see the documentation for the assembler and linkage editor in the directory SDCCDIR/asxxxx/asxhtm.htm this describes how to create a .lib library file, the libraries created in this manner may be included using the command line, make sure you include the -L <library-path> option to tell the linker where to look for these files. Here is an example, assuming you have the source file 'foomain.c' and a library 'foolib.lib' in the directory 'mylib'.
sdcc foomain.c foolib.lib -L mylib
Note here that 'mylib' must be an absolute path name.
The view of the way the linkage editor processes the library files, it is recommended that you put each source routine in a separate file and combine them using the .lib file. For an example see the standard library file 'libsdcc.lib' in the directory SDCCDIR/sdcc51lib.
The following options are provided for the purpose of retargetting and debugging the compiler . These provided a means to dump the intermediate code (iCode) generated by the compiler in human readable form at various stages of the compilation process.
When reporting bugs, it can be helpful to include these dumps along with the portion of the code that is causing the problem.
In addition to the ANSI storage classes SDCC allows the following MCS51 specific storage classes.
Variables declared with this storage class will be placed in the extern RAM. This is the default storage class for Large Memory model .
eg. xdata unsigned char xduc;
This is the default storage class for Small Memory model. Variables declared with this storage class will be allocated in the internal RAM.
eg. data int iramdata;
Variables declared with this storage class will be allocated into the indirectly addressable portion of the internal ram of a 8051 .
eg.idata int idi;
This is a data-type and a storage class specifier. When a variable is declared as a bit , it is allocated into the bit addressable memory of 8051.
eg.bit iFlag;
Like the bit keyword, sfr / sbit signifies both a data-type and storage class, they are used to describe the special function registers and special bit variables of a 8051.
eg.
sfr at 0x80 P0; /* SPECIAL FUNCTION REGISTER P0 AT LOCATION 0X80 */
sbit at 0xd7 CY; /* CY (CARRY FLAG) */
SDCC allows (via language extensions) pointers to explicitly point to any of the memory spaces of the 8051. In addition to the explicit pointers, the compiler also allows a _generic class of pointers which can be used to point to any of the memory spaces.
Pointer declaration examples.
/* pointer physically in xternal ram pointing to object
in internal ram */
data unsigned char * xdata p;
/* pointer physically in code rom pointing to data in xdata
space */
xdata unsigned char * code p;
/* pointer physically in code space pointing to data in
code space */
code unsigned char * code p;
/* the folowing is a generic pointer physically located
in xdata space */
char * xdata p;
Well you get the idea. For compatibility with the previous version of the compiler, the following syntax for pointer declaration is also supported. Note the above examples will be portable to other commercially available compilers.
unsigned char _xdata *ucxdp; /* pointer to data in external
ram */
unsigned char _data *ucdp ; /* pointer to data in internal
ram */
unsigned char _code *uccp ; /* pointer to data in R/O
code space */
unsigned char _idata *uccp; /* pointer to upper 128
bytes of ram */
All unqualified pointers are treated as 3 - byte '_generic' pointers. These type of pointers can also to be explicitly declared.
unsigned char _generic *ucgp;
The highest order byte of the generic pointers contains the data space information. Assembler support routines are called whenever data is stored or retrieved using _generic pointers. These are useful for developing reusable library routines. Explicitly specifying the pointer type will generate the most efficient code. Pointers declared using a mixture of OLD/NEW style could have unpredictable results.
Automatic (local) variables and parameters to functions can either be placed on the stack or in data-space. The default action of the compiler is to place these variables in the internal RAM ( for small model) or external RAM (for Large model). They can be placed on the stack either by using the -stack-auto compiler option or by using the 'reentrant' keyword in the function declaration.
eg
unsigned short foo( short i) reentrant {
...
}
Note that when the parameters & local variables are declared in the internal/external ram the functions are non-reentrant. Since stack space on 8051 is limited the 'reentrant' keyword or the -stack-auto option should be used sparingly. Note the reentrant keyword just means that the parameters & local variables will be allocated to the stack, it DOES NOT mean that the function is register bank independent.
When compiled with the default option (i.e. non-reentrant ), local variables can be assigned storage classes and absolute addresses.
eg
unsigned short foo() {
xdata unsigned short i;
bit bvar;
data at 0x31 unsiged short j;
...
}
In the above example the variable i will be allocated in the external ram, bvar in bit addressable space and j in internal ram. When compiled with the -stack-auto or when a function is declared as 'reentrant' local variables cannot be assigned storage classes or absolute addresses.
Parameters however are not allowed any storage class, (storage classes for parameters will be ignored), their allocation is governed by the memory model in use , and the reentrancy options.
For non-reentrant functions SDCC will try to reduce internal ram space usage by overlaying parameters and local variables of a function (if possible). Parameters and local variables of a function will be allocated to an overlayable segment if the function has no other function calls and the function is non-reentrant and the memory model is small. If an explicit storage class is specified for a local variable , it will NOT be overplayed.
Note that the compiler (not the linkage editor) makes the decision for overlaying the data items. Functions that are called from an interrupt service routine should be preceded by a #pragma NOOVERLAY if they are not reentrant Along the same lines the compiler does not do any processing with the inline assembler code so the compiler might incorrectly assign local variables and parameters of a function into the overlay segment if the only function call from a function is from inline assembler code, it is safe to use the #pragma NOOVERLAY for functions which call other functions using inline assembler code.
Parameters and Local variables of functions that contain 16 or 32 bit multiplication or division will NOT be overlayed since these are implemented using external functions.
eg.
#pragma SAVE
#pragma NOOVERLAY
void set_error( unsigned short errcd)
{
P3 = errcd;
}
#pragma RESTORE
void some_isr () interrupt 2 using 1
{
...
set_error(10);
...
}
In the above example the parameter errcd for the function set_error would be assigned to the overlayable segment (if the #pragma NOOVERLAY was not present) , this could cause unpredictable runtime behavior. The pragma NOOVERLAY ensures that the parameters and local variables for the function are NOT overlayed.
A special keyword may be associated with a function declaring it as 'critical'. SDCC will generate code to disable all interrupts upon entry to a critical function and enable them back before returning . Note that nesting critical functions may cause unpredictable results.
eg
int foo () critical
{
...
...
}
The critical attribute maybe used with other attributes like reentrant.
Data items can be assigned an absolute address with the at <address> keyword, in addition to a storage class.
eg.
xdata at 0x8000 unsigned char PORTA_8255 ;
In the above example the PORTA_8255 will be allocated to the location 0x8000 of the external ram.
Note that is this feature is provided to give the programmer access to memory mapped devices attached to the controller. The compiler does not actually reserve any space for variables declared in this way (they are implemented with an equate in the assembler), thus it is left to the programmer to make sure there are no overlaps with other variables that are declared without the absolute address, the assembler listing file (.lst) and the linker output files (<filename>.rst) and (<filename>.map) are a good places to look for such overlaps.
Absolute address can be specified for variables in all storage classes.
eg.
bit at 0x02 bvar;
The above example will allocate the variable at offset 0x02 in the bit-addressable space. There is no real advantage to assigning absolute addresses to variables in this manner , unless you want strict control over all the variables allocated.
SDCC allows interrupt service routines to be coded in C, with some extended keywords.
void timer_isr (void) interrupt 2 using 1
{
..
}
The number following the 'interrupt' keyword is the interrupt number this routine will service. The compiler will insert a call to this routine in the interrupt vector table for the interrupt number specified. The 'using' keyword is used to tell the compiler to use the specified register bank (8051 specific) when generating code for this function. Note that when some function is called from an interrupt service routine it should be preceded by a #pragma NOOVERLAY (if it is not reentrant) . A special note here, int (16 bit) and long (32 bit) integer division, multiplication & modulus operations are implemented using external support routines developed in ANSI-C, if an interrupt service routine needs to do any of these operations then the support routines (as mentioned in a following section) will have to recompiled using the -stack-auto option and the source file will need to be compiled using the -int-long-rent compiler option.
If you have multiple source files in your project, interrupt service routines can be present in any of them, but a prototype of the isr MUST be present in the file that contains the function 'main'.
Interrupt Numbers and the corresponding address & descriptions for the Standard 8051 are listed below. SDCC will automatically adjust the interrupt vector table to the maximum interrupt number specified.
Interrupt # | Description | Vector Address |
0 | External 0 | 0x0003 |
1 | Timer 0 | 0x000B |
2 | External 1 | 0x0013 |
3 | Timer 1 | 0x001B |
4 | Serial | 0x0023 |
If the interrupt service routine is defined without a register bank or with register bank 0 (using 0), the compiler will save the registers used by itself on the stack (upon entry and restore them at exit), however if such an interrupt service routine calls another function then the entire register bank will be saved on the stack. This scheme may be advantageous for small interrupt service routines which have low register usage.
If the interrupt service routine is defined to be using a specific register bank then only ``a'',''b'' & ``dptr'' are save and restored, if such an interrupt service routine calls another function (using another register bank) then the entire register bank of the called function will be saved on the stack. This scheme is recommended for larger interrupt service routines.
Calling other functions from an interrupt service routine is not recommended avoid it if possible.
The compiler inserts a jump to the C routine _sdcc__external__startup() at the start of the CODE area. This routine can be found in the file SDCCDIR/sdcc51lib/_startup.c, by default this routine returns 0, if this routine returns a non-zero value , the static & global variable initialization will be skipped and the function main will be invoked, other wise static & global variables will be initialized before the function main is invoked. You could add a _sdcc__external__startup() routine to your program to override the default if you needed to setup hardware or perform some other critical operation prior to static & global variable initialization.
SDCC allows the use of in-line assembler with a few restriction as regards labels. All labels defined within inline assembler code HAS TO BE of the form nnnnn$ where nnnn is a number less than 100 (which implies a limit of utmost 100 inline assembler labels PER FUNCTION). It is strongly recommended that each assembly instruction (including labels) be placed in a separate line ( as the example shows). When the -peep-asm command line option is used, the inline assembler code will be passed through the peephole optimizer, this might cause some unexpected changes in the inline assembler code, please go throught the peephole optimizer rules defined in file 'SDCCpeeph.def' carefully before using this option.
eg
_asm
mov b,#10
00001$:
djnz b,00001$
_endasm ;
The inline assembler code can contain any valid code understood by the assembler (this includes any assembler directives and comment lines ) . The compiler does not do any validation of the code within the _asm ... _endasm; keyword pair.
Inline assembler code cannot reference any C-Labels however it can reference labels defined by the inline assembler.
eg
foo() {
... /* some c code */
_asm
; some assembler code
ljmp $0003
_endasm ;
... /* some more c code */
clabel: /* inline assembler cannot reference this label
*/
_asm
$0003: ;label (can be reference by inline assembler
only)
_endasm ;
...
}
In other words inline assembly code can access labels defined in inline assembly. The same goes the other way, ie. labels defines in inline assembly CANNOT be accessed by C statements.
For signed & unsigned int (16 bit) and long (32 bit) variables, division, multiplication and modulus operations are implemented by support routines. These support routines are all developed in ANSI-C to facilitate porting to other MCUs. The following files contain the described routine, all of them can be found in the directory SDCCDIR/sdcc51lib
SDCC supports IEEE (single precision 4bytes) floating point numbers.The floating point support routines are derived from gcc's floatlib.c and consists of the following routines.
SDCC allows two memory models for MCS51 code, small and large. Modules compiled with different memory models should never be combined together or the results would be unpredictable. The library routines supplied with the compiler are compiled as both small and large. The compiled library modules are contained in seperate directories as small and large so that you can link to either set. In general the use of the large model is discouraged.
When the large model is used all variables declared without a storage class will be allocated into the external ram, this includes all parameters and local variables (for non-reentrant functions). When the small model is used variables without storage class are allocated in the internal ram.
Judicious usage of the processor specific storage classes and the 'reentrant' function type will yield much more efficient code, than using the large-model. Several optimizations are disabled when the program is compiled using the large model, it is therefore strongly recommdended that the small model be used unless absolutely required.
This option generates code for the 24 bit contiguous addressing mode of the Dallas DS80C390 part. In this mode, up to four meg of external RAM or code space can be directly addressed. See the data sheets at www.dalsemi.com for further information on this part.
In older versions of the compiler, this option was used with the MCS51 code generator (-mmcs51). Now, however, the '390 has it's own code generator, selected by the -mds390 switch. This code generator currently supports only the flat24 model, but the -model-flat24 switch is still required, in case later versions of the code generator support other models (such as the paged mode of the '390). The combination of -mmcs51 and -model-flat24 is now depracated.
Note that the compiler does not generate any code to place the processor into24 bitmode (it defaults to 8051 compatible mode). Boot loader or similar code must ensure that the processor is in 24 bit contiguous addressing mode before calling the SDCC startup code.
Like the -model-large option, variables will by default be placed into the XDATA segment.
Segments may be placed anywhere in the 4 meg address space using the usual -*-loc options. Note that if any segments are located above 64K, the -r flag must be passed to the linker to generate the proper segment relocations, and the Intel HEX output format must be used. The -r flag can be passed to the linker by using the option -Wl-r on the sdcc command line.
The compiler creates the following #defines .
SDCC performs a a host of standard optimizations in addition to some MCU specific optimizations.
The compiler does local and global common subexpression elimination.
eg.
i = x + y + 1;
j = x + y;
will be translated to
iTemp = x + y
i = iTemp + 1
j = iTemp
Some subexpressions are not as obvious as the above example.
eg.
a->b[i].c = 10;
a->b[i].d = 11;
In this case the address arithmetic a->b[i] will be computed only once; the equivalent code in C would be.
iTemp = a->b[i];
iTemp.c = 10;
iTemp.d = 11;
The compiler will try to keep these temporary variables in registers.
eg.
int global;
void f () {
int i;
i = 1; /* dead store */
global = 1; /* dead store */
global = 2;
return;
global = 3; /* unreachable */
}
will be changed to
int global; void f ()
{
global = 2;
return;
}
eg.
int f() {
int i, j;
i = 10;
j = i;
return j;
}
will be changed to
int f() {
int i,j;
i = 10;
j = 10;
return 10;
}
Note: the dead stores created by this copy propagation will be eliminated by dead-code elimination .
Two types of loop optimizations are done by SDCC loop invariant lifting and strength reduction of loop induction variables.In addition to the strength reduction the optimizer marks the induction variables and the register allocator tries to keep the induction variables in registers for the duration of the loop. Because of this preference of the register allocator , loop induction optimization causes an increase in register pressure, which may cause unwanted spilling of other temporary variables into the stack / data space . The compiler will generate a warning message when it is forced to allocate extra space either on the stack or data space. If this extra space allocation is undesirable then induction optimization can be eliminated either for the entire source file ( with -noinduction option) or for a given function only (#pragma NOINDUCTION).
for (i = 0 ; i < 100 ; i ++)
f += k + l;
changed to
itemp = k + l;
for ( i = 0; i < 100; i++ ) f += itemp;
As mentioned previously some loop invariants are not as apparent, all static address computations are also moved out of the loop.
eg.
for (i=0;i < 100; i++) ar[i*5] = i*3;
changed to
itemp1 = 0;
itemp2 = 0;
for (i=0;i< 100;i++) {
ar[itemp1] = itemp2;
itemp1 += 5;
itemp2 += 3;
}
The more expensive multiplication is changed to a less expensive addition.
This optimization is done to reduce the overhead of checking loop boundaries for every iteration. Some simple loops can be reversed and implemented using a ``decrement and jump if not zero'' instruction. SDCC checks for the following criterion to determine if a loop is reversible (note: more sophisticated compiers use data-dependency analysis to make this determination, SDCC uses a more simple minded analysis).
SDCC does numerous algebraic simplifications, the following is a small sub-set of these optimizations.
eg
i = j + 0 ; /* changed to */ i = j;
i /= 2; /* changed to */ i >>= 1;
i = j - j ; /* changed to */ i = 0;
i = j / 1 ; /* changed to */ i = j;
Note the subexpressions given above are generally introduced by macro expansions or as a result of copy/constant propagation.
SDCC changes switch statements to jump tables when the following conditions are true.
switch(i) { switch (i)
{
case 4:... case 1: ...
case 5:... case 2: ...
case 3:... case 3: ...
case 6:... case 4: ...
} }
Both the above switch statements will be implemented using a jump-table.
eg
switch (i) {
case 1: ...
case 2: ...
case 3: ...
case 4: ...
case 9: ...
case 10: ...
case 11: ...
case 12: ...
}
If the above switch statement is broken down into two switch statements
switch (i) {
case 1: ...
case 2: ...
case 3: ...
case 4: ...
}
switch (i) {
case 9: ...
case 10: ...
case 11: ...
case 12:...
}
then both the switch statements will be implemented using jump-tables whereas the unmodified switch statement will not be .
Bit shifting is one of the most frequently used operation in embedded programming . SDCC tries to implement bit-shift operations in the most efficient way possible.
eg.
unsigned short i;
...
i>>= 4;
..
generates the following code.
mov a,_i
swap a
anl a,#0x0f
mov _i,a
In general SDCC will never setup a loop if the shift count is known. Another example
unsigned int i;
...
i >>= 9;
...
will generate
mov a,(_i + 1)
mov (_i + 1),#0x00
clr c
rrc a
mov _i,a
Note that SDCC stores numbers in LITTLE-ENDIAN format (i.e. lowest order first)
A special case of the bit-shift operation is bit rotation, SDCC recognizes the following expression to be a left bit-rotation.
unsigned char i;
...
i = ( ( i << 1) | ( i >>
7));
...
will generate the following code.
mov a,_i
rl a
mov _i,a
SDCC uses pattern matching on the parse tree to determine this operation .Variations of this case will also be recognized as bit-rotation i.e i = ((i >> 7) | (i << 1)); /* left-bit rotation */
It is frequently required to obtain the highest order bit of an integral type (int,long,short or char types). SDCC recognizes the following expression to yield the highest order bit and generates optimized code for it.
eg
unsigned int gint;
foo () {
unsigned char hob;
...
hob = (gint >> 15) & 1;
..
}
Will generate the following code.
61
; hob.c 7
000A E5*01 62
mov a,(_gint + 1)
000C 33 63
rlc a
000D E4 64
clr a
000E 13 65
rrc a
000F F5*02 66
mov _foo_hob_1_1,a
Variations of this case however will NOT be recognized . It is a standard C expression , so I heartily recommend this be the only way to get the highest order bit, (it is portable). Of course it will be recognized even if it is embedded in other expressions.
eg.
xyz = gint + ((gint >> 15) & 1);
will still be recognized.
The compiler uses a rule based , pattern matching and re-writing mechanism for peep-hole optimization . It is inspired by 'copt' a peep-hole optimizer by Christopher W. Fraser (cwfraser@microsoft.com). A default set of rules are compiled into the compiler, additional rules may be added with the -peep-file <filename> option. The rule language is best illustrated with examples.
replace {
mov %1,a
mov a,%1 } by { mov %1,a }
The above rule will the following assembly sequence
mov r1,a
mov a,r1
to
mov r1,a
Note: All occurrences of a '%n' ( pattern variable ) must denote the same string. With the above rule, the assembly sequence
mov r1,a
mov a,r2
will remain unmodified. Other special case optimizations may be added by the user (via -peep-file option), eg. some variants of the 8051 MCU allow only 'AJMP' and 'ACALL' , the following two rules will change all 'LJMP' & 'LCALL' to 'AJMP' & 'ACALL'.
replace { lcall %1 } by { acall %1 }
replace { ljmp %1 } by { ajmp %1 }
The inline-assembler' code is also passed through the peep hole optimizer, thus the peephole optimizer can also be used as an assembly level macro expander. The rules themselves are MCU dependent whereas the rule language infra-structure is MCU independent. Peephole optimization rules for other MCU can be easily programmed using the rule language.
The syntax for a rule is as follows ,
rule := replace [ restart ] '{' <assembly sequence> '\n'
'}' by '{' '\n'
<assembly
sequence> '\n'
'}' [if <functionName>
] '\n'
<assembly sequence> := assembly instruction (each instruction
including labels must be on a separate line).
The optimizer will apply to the rules one by one from the top in the sequence of their appearance, it will terminate when all rules are exhausted. If the 'restart' option is specified, then the optimizer will start matching the rules again from the top, this option for a rule is expensive (performance), it is intended to be used in situations where a transformation will trigger the same rule again. A good example of this the following rule.
replace restart {
pop %1
push %1 } by {
; nop
}
Note that the replace pattern cannot be a blank, but can be a comment line. Without the 'restart' option only the inner most 'pop' 'push' pair would be eliminated. i.e.
pop ar1
pop ar2
push ar2
push ar1
would result in
pop ar1
; nop
push ar1
with the 'restart' option the rule will be applied again to the resulting code and the all the 'pop' 'push' pairs will be eliminated to yield
; nop
; nop
A conditional function can be attached to a rule. Attaching rules are somewhat more involved, let me illustrate this with an example.
replace {
ljmp %5
%2:} by {
sjmp %5
%2:} if labelInRange
The optimizer does a look-up of a function name table defined in function 'callFuncByName' in the source file SDCCpeeph.c , with the name 'labelInRange', if it finds a corresponding entry the function is called. Note there can be no parameters specified for these functions, in this case the use of '%5' is crucial, since the function labelInRange expects to find the label in that particular variable (the hash table containing the variable bindings is passed as a parameter). If you want to code more such functions , take a close look at the function labelInRange and the calling mechanism in source file SDCCpeeph.c. I know this whole thing is a little kludgey , may be some day we will have some better means. If you are looking at this file, you will also see the default rules that are compiled into the compiler, you can your own rules in the default set there if you get tired of specifying the -peep-file option.
SDCC supports the following #pragma directives. This directives are applicable only at a function level.
eg
#pragma SAVE /* save the current settings */
#pragma NOGCSE /* turnoff global subexpression elimination
*/
#pragma NOINDUCTION /* turn off induction optimizations
*/
int foo ()
{
...
/* large code */
...
}
#pragma RESTORE /* turn the optimizations back on
*/
The compiler will generate a warning message when extra space is allocated. It is strongly recommended that the SAVE and RESTORE pragma's be used when changing options for a function.
The following library routines are provided for your convenience.
stdio.h - Contains the following functions printf & sprintf these routines are developed by Martijn van Balen <balen@natlab.research.philips.com>.
%[flags][width][b|B|l|L]type
flags: - left justify
output in specified field width
+ prefix
output with +/- sign if output is signed type
space prefix output
with a blank if it's a signed positive value
width: specifies
minimum number of characters outputted for numbers
or
strings.
-
For numbers, spaces are added on the left when needed.
If width starts with a zero character, zeroes and used
instead of spaces.
-
For strings, spaces are are added on the left or right (when
flag '-' is used) when needed.
b/B: byte argument
(used by d, u, o, x, X)
l/L: long argument
(used by d, u, o, x, X)
type: d decimal number
u unsigned
decimal number
o unsigned
octal number
x unsigned
hexadecimal number (0-9, a-f)
X unsigned
hexadecimal number (0-9, A-F)
c character
s string
(generic pointer)
p generic
pointer (I:data/idata, C:code, X:xdata, P:paged)
f float
(still to be implemented)
Also contains a very simple version of printf (printf_small). This simplified version of printf supports only the following formats.
format output type argument-type
%d decimal int
%ld decimal long
%hd decimal short/char
%x hexadecimal int
%lx hexadecimal long
%hx hexadecimal short/char
%o octal int
%lo octal long
%ho octal short/char
%c character char/short
%s character _generic pointer
The routine is very stack intesive , -stack-after-data parameter should be used when using this routine, the routine also takes about 1K of code space .It also expects an external function named putchar(char ) to be present (this can be changed). When using the %s format the string / pointer should be cast to a generic pointer. eg.
printf_small(``my str %s, my int %d\n'',(char _generic *)mystr,myint);
va_list, va_start, va_arg, va_end.
atoi, atol.
strcpy, strncpy, strcat, strncat, strcmp, strncmp, strchr, strrchr, strspn, strcspn, strpbrk, strstr, strlen, strtok, memcpy, memcmp, memset.
iscntrl, isdigit, isgraph, islower, isupper, isprint, ispunct, isspace, isxdigit, isalnum, isalpha.
//Example:
// #define DYNAMIC_MEMORY_SIZE 0x2000
// .....
// unsigned char xdata dynamic_memory_pool[DYNAMIC_MEMORY_SIZE];
// unsigned char xdata * current_buffer;
// .....
// void main(void)
// {
// ...
// init_dynamic_memory(dynamic_memory_pool,DYNAMIC_MEMORY_SIZE);
// //Now it's possible to use
malloc.
// ...
// current_buffer = malloc(0x100);
//
Have not had time to do the more involved routines like printf, will get to them shortly.
By default the compiler uses the global registers ``DPL,DPH,B,ACC'' to pass the first parameter to a routine, the second parameter onwards is either allocated on the stack (for reentrant routines or -stack-auto is used) or in the internal / external ram (depending on the memory model).
In the following example the function cfunc calls an assembler routine asm_func, which takes two parameters.
extern int asm_func( unsigned short, unsigned short);
int c_func (unsigned short i, unsigned short j)
{
return asm_func(i,j);
}
int main()
{
return c_func(10,9);
}
The corresponding assembler function is:-
.globl _asm_func_PARM_2
.globl _asm_func
.area OSEG
_asm_func_PARM_2: .ds 1
.area CSEG
_asm_func:
mov a,dpl
add a,_asm_func_PARM_2
mov dpl,a
mov dpl,#0x00
ret
Note here that the return values are placed in 'dpl' - One byte return value, 'dpl' LSB & 'dph' MSB for two byte values. 'dpl', 'dph' and 'b' for three byte values (generic pointers) and 'dpl','dph','b' & 'acc' for four byte values.
The parameter naming convention is _<function_name>_PARM_<n>, where n is the parameter number starting from 1, and counting from the left. The first parameter is passed in ``dpl'' for One bye parameter, ``dptr'' if two bytes, ``b,dptr'' for three bytes and ``acc,b,dptr'' for four bytes, the varaible name for the second parameter will be _<function_name>_PARM_2.
Assemble the assembler routine with the following command.
asx8051 -losg asmfunc.asm
Then compile and link the assembler routine to the C source file with the following command,
sdcc cfunc.c asmfunc.rel
In this case the second parameter onwards will be passed on the stack , the parameters are pushed from right to left i.e. after the call the left most parameter will be on the top of the stack. Here is an example.
extern int asm_func( unsigned short, unsigned short);
int c_func (unsigned short i, unsigned short j) reentrant
{
return asm_func(i,j);
}
int main()
{
return c_func(10,9);
}
The corresponding assembler routine is.
.globl _asm_func
_asm_func:
push _bp
mov _bp,sp
mov r2,dpl
mov a,_bp
clr c
add a,#0xfd
mov r0,a
add a,#0xfc
mov r1,a
mov a,@r0
add a,r2
mov dpl,a
mov dph,#0x00
mov sp,_bp
pop _bp
ret
The compiling and linking procedure remains the same, however note the extra entry & exit linkage required for the assembler code, _bp is the stack frame pointer and is used to compute the offset into the stack for parameters and local variables.
When the source is compiled with -noregparms option , space is allocated for each of the parameters passed to a routine.
In the following example the function cfunc calls an assembler routine asm_func, which takes two parameters.
extern int asm_func( unsigned short, unsigned short);
int c_func (unsigned short i, unsigned short j)
{
return asm_func(i,j);
}
int main()
{
return c_func(10,9);
}
The corresponding assembler function is:-
.globl _asm_func_PARM_1
.globl _asm_func_PARM_2
.globl _asm_func
.area OSEG
_asm_func_PARM_1: .ds 1
_asm_func_PARM_2: .ds 1
.area CSEG
_asm_func:
mov a,_asm_func_PARM_1
add a,_asm_func_PARM_2
mov dpl,a
mov dpl,#0x00
ret
Note here that the return values are placed in 'dpl' - One byte return value, 'dpl' LSB & 'dph' MSB for two byte values. 'dpl', 'dph' and 'b' for three byte values (generic pointers) and 'dpl','dph','b' & 'acc' for four byte values.
The parameter naming convention is _<function_name>_PARM_<n>, where n is the parameter number starting from 1, and counting from the left. i.e. the left-most parameter name will be _<function_name>_PARM_1.
Assemble the assembler routine with the following command.
asx8051 -losg asmfunc.asm
Then compile and link the assembler routine to the C source file with the following command,
sdcc cfunc.c asmfunc.rel
In this case the parameters will be passed on the stack , the parameters are pushed from right to left i.e. after the call the left most parameter will be on the top of the stack. Here is an example.
extern int asm_func( unsigned short, unsigned short);
int c_func (unsigned short i, unsigned short j) reentrant
{
return asm_func(i,j);
}
int main()
{
return c_func(10,9);
}
The corresponding assembler routine is.
.globl _asm_func
_asm_func:
push _bp
mov _bp,sp
mov a,_bp
clr c
add a,#0xfd
mov r0,a
mov a,_bp
clr c
add a,#0xfc
mov r1,a
mov a,@r0
add a,@r1
mov dpl,a
mov dph,#0x00
mov sp,_bp
pop _bp
ret
The compiling and linking procedure remains the same, however note the extra entry & exit linkage required for the assembler code, _bp is the stack frame pointer and is used to compute the offset into the stack for parameters and local variables.
The external stack is located at the start of the external ram segment , and is 256 bytes in size. When -xstack option is used to compile the program, the parameters and local variables of all reentrant functions are allocated in this area. This option is provided for programs with large stack space requirements. When used with the -stack-auto option, all parameters and local variables are allocated on the external stack (note support libraries will need to be recompiled with the same options).
The compiler outputs the higher order address byte of the external ram segment into PORT P2, therefore when using the External Stack option, this port MAY NOT be used by the application program.
Deviations from the compliancy.
eg
struct s foo1 (struct s parms) /* is invalid in SDCC although
allowed in ANSI */
{
struct s rets;
...
return rets;/* is invalid in SDCC although allowed in ANSI
*/
}
int (*foo)();
Cyclomatic complexity of a function is defined as the number of independent paths the program can take during execution of the function. This is an important number since it defines the number test cases you have to generate to validate the function . The accepted industry standard for complexity number is 10, if the cyclomatic complexity reported by SDCC exceeds 10 you should think about simplification of the function logic.
Note that the complexity level is not related to the number of lines of code in a function. Large functions can have low complexity, and small functions can have large complexity levels. SDCC uses the following formula to compute the complexity.
complexity = (number of edges in control flow graph) -
(number of nodes in control flow graph)
+ 2;
Having said that the industry standard is 10, you should be aware that in some cases it may unavoidable to have a complexity level of less than 10. For example if you have switch statement with more than 10 case labels, each case label adds one to the complexity level. The complexity level is by no means an absolute measure of the algorithmic complexity of the function, it does however provide a good starting point for which functions you might look at for further optimization.
Here are a few guide-lines that will help the compiler generate more efficient code, some of the tips are specific to this compiler others are generally good programming practice.
foobar( unsigned int p1, unsigned char ch)
{
unsigned char ch1 = p1 % ch ;
....
}
For the modulus operation the variable ch will be promoted to unsigned int first then the modulus operation will be performed (this will lead to a call to a support routine). If the code is changed to
foobar( unsigned int p1, unsigned char ch)
{
unsigned char ch1 = (unsigned char)p1 % ch
;
....
}
It would substantially reduce the code generated (future versions of the compiler will be smart enough to detect such optimization oppurtunities).
The 8051 family of micro controller have a minimum of 128 bytes of internal memory which is structured as follows
- Bytes 00-1F - 32 bytes to hold up to 4 banks of the registers R7 to R7
- Bytes 20-2F - 16 bytes to hold 128 bit variables and
- Bytes 30-7F - 60 bytes for general purpose use.
Normally the SDCC compiler will only utilise the first bank of registers, but it is possible to specify that other banks of registers should be used in interrupt routines. By default, the compiler will place the stack after the last bank of used registers, i.e. if the first 2 banks of registers are used, it will position the base of the internal stack at address 16 (0X10). This implies that as the stack grows, it will use up the remaining register banks, and the 16 bytes used by the 128 bit variables, and 60 bytes for general purpose use.
By default, the compiler uses the 60 general purpose bytes to hold "near data". The compiler/optimiser may also declare some Local Variables in this area to hold local data.
If any of the 128 bit variables are used, or near data is being used then care needs to be taken to ensure that the stack does not grow so much that it starts to over write either your bit variables or "near data". There is no runtime checking to prevent this from happening.
The amount of stack being used is affected by the use of the "internal stack" to save registers before a subroutine call is made, - -stack-auto will declare parameters and local variables on the stack - the number of nested subroutines.
If you detect that the stack is over writing you data, then the following can be done. -xstack will cause an external stack to be used for saving registers and (if -stack-auto is being used) storing parameters and local variables. However this will produce more and code which will be slower to execute.
-stack-loc will allow you specify the start of the stack, i.e. you could start it after any data in the general purpose area. However this may waste the memory not used by the register banks and if the size of the "near data" increases, it may creep into the bottom of the stack.
-stack-after-data, similar to the -stack-loc, but it automatically places the stack after the end of the "near data". Again this could waste any spare register space.
-data-loc allows you to specify the start address of the near data. This could be used to move the "near data" further away from the stack giving it more room to grow. This will only work if no bit variables are being used and the stack can grow to use the bit variable space.
Conclusion.
If you find that the stack is over writing your bit variables or "near data" then the approach which best utilised the internal memory is to position the "near data" after the last bank of used registers or, if you use bit variables, after the last bit variable by using the -data-loc, e.g. if two register banks are being used and no data variables, -data-loc 16, and - use the -stack-after-data option.
If bit variables are being used, another method would be to try and squeeze the data area in the unused register banks if it will fit, and start the stack after the last bit variable.
The issues for retargetting the compiler are far too numerous to be covered by this document. What follows is a brief description of each of the seven phases of the compiler and its MCU dependency.
SDCC is distributed with a source level debugger. The debugger uses a command line interface, the command repertoire of the debugger has been kept as close to gdb ( the GNU debugger) as possible. The configuration and build process is part of the standard compiler installation, which also builds and installs the debugger in the target directory specified during configuration. The debugger allows you debug BOTH at the C source and at the ASM source level.
The -debug option must be specified for all files for which debug information is to be generated. The complier generates a .cdb file for each of these files. The linker updates the .cdb file with the address information. This .cdb is used by the debugger .
When the -debug option is specified the compiler generates extra symbol information some of which are put into the the assembler source and some are put into the .cdb file, the linker updates the .cdb file with the address information for the symbols. The debugger reads the symbolic information generated by the compiler & the address information generated by the linker. It uses the SIMULATOR (Daniel's S51) to execute the program, the program execution is controlled by the debugger. When a command is issued for the debugger, it translates it into appropriate commands for the simulator .
The debugger can be started using the following command line. (Assume the file you are debugging has
the file name foo).
>sdcdb foo
The debugger will look for the following files.
As mention earlier the command interface for the debugger has been deliberately kept as close the GNU debugger gdb , as possible, this will help int integration with existing graphical user interfaces (like ddd, xxgdb or xemacs) existing for the GNU debugger.
Set breakpoint at specified line or function.
sdcdb>break 100
sdcdb>break foo.c:100
sdcdb>break funcfoo
sdcdb>break foo.c:funcfoo
Clear breakpoint at specified line or function.
sdcdb>clear 100
sdcdb>clear foo.c:100
sdcdb>clear funcfoo
sdcdb>clear foo.c:funcfoo
Continue program being debugged, after breakpoint.
Execute till the end of the current function.
Delete breakpoint number 'n'. If used without any option clear ALL user defined break points.
Step program until it reaches a different source line.
Step program, proceeding through subroutine calls.
Start debugged program.
Print type information of the variable.
print value of variable.
load the given file name. Note this is an alternate method of loading file for debugging.
print information about current frame.
Toggle between C source & assembly source.
Send the string following '!' to the simulator, the simulator response is displayed. Note the debugger does not interpret the command being sent to the simulator, so if a command like 'go' is sent the debugger can loose its execution context and may display incorrect values.
"Watch me now. Iam going Down. My name is Bobby Brown"
Two files are (in emacs lisp) are provided for the interfacing with XEmacs, sdcdb.el and sdcdbsrc.el. These two files can be found in the $(prefix)/bin directory after the installation is complete. These files need to be loaded into XEmacs for the interface to work, this can be done at XEmacs startup time by inserting the following into your '.xemacs' file (which can be found in your HOME directory) (load-file sdcdbsrc.el) [ .xemacs is a lisp file so the () around the command is REQUIRED), the files can also be loaded dynamically while XEmacs is running, set the environment variable 'EMACSLOADPATH' to the installation bin directory [$(prefix)/bin], then enter the following command ESC-x load-file sdcdbsrc . To start the interface enter the following command ESC-x sdcdbsrc , you will prompted to enter the file name to be debugged.
The command line options that are passed to the simulator directly are bound to default values in the file sdcdbsrc.el the variables are listed below these values maybe changed as required.
;; Current Listing ::
;;key binding Comment
;;-- ---- ----
;;
;; n sdcdb-next-from-src SDCDB
next command
;; b sdcdb-back-from-src SDCDB
back command
;; c sdcdb-cont-from-src SDCDB
continue command
;; s sdcdb-step-from-src SDCDB
step command
;; ? sdcdb-whatis-c-sexp SDCDB
ptypecommand for data at
;;
buffer point
;; x sdcdbsrc-delete SDCDB
Delete all breakpoints if no arg
;; given
or delete arg (C-u arg x)
;; m sdcdbsrc-frame SDCDB
Display current frame if no arg,
;; given
or display frame arg
;; buffer
point
;; ! sdcdbsrc-goto-sdcdb Goto
the SDCDB output buffer
;; p sdcdb-print-c-sexp SDCDB
print command for data at
;;
buffer point
;; g sdcdbsrc-goto-sdcdb Goto
the SDCDB output buffer
;; t sdcdbsrc-mode Toggles
Sdcdbsrc mode (turns it off)
;;
;; C-c C-f sdcdb-finish-from-src SDCDB
finish command
;;
;; C-x SPC sdcdb-break Set
break for line with point
;; ESC t sdcdbsrc-mode Toggle
Sdcdbsrc mode
;; ESC m sdcdbsrc-srcmode
Toggle list mode
;;
SDCC can target both the Zilog Z80 and the Nintendo Gameboy's Z80-like gbz80. The port is incomplete - long support is incomplete (mul, div and mod are unimplimented), and both float and bitfield support is missing, but apart from that the code generated is correct.
As always, the code is the authoritave reference - see z80/ralloc.c and z80/gen.c. The stack frame is similar to that generated by the IAR Z80 compiler. IX is used as the base pointer, HL is used as a temporary register, and BC and DE are available for holding varibles. IY is currently unusued. Return values are stored in HL. One bad side effect of using IX as the base pointer is that a functions stack frame is limited to 127 bytes - this will be fixed in a later version.
SDCC has grown to be large project, the compiler alone (without the Assembler Package, Preprocessor) is about 40,000 lines of code (blank stripped). The open source nature of this project is a key to its continued growth and support. You gain the benefit and support of many active software developers and end users. Is SDCC perfect? No, that's why we need your help. The developers take pride in fixing reported bugs. You can help by reporting the bugs and helping other SDCC users. There are lots of ways to contribute, and we encourage you to take part in making SDCC a great software package.
Send an email to the mailing list at 'user-sdcc@sdcc.sourceforge.net' or 'devel-sdcc@sdcc.sourceforge.net'. Bugs will be fixed ASAP. When reporting a bug, it is very useful to include a small test program which reproduces the problem. If you can isolate the problem by looking at the generated assembly code, this can be very helpful. Compiling your program with the -dumpall option can sometimes be useful in locating optimization problems.
Sandeep Dutta(sandeep.dutta@usa.net) - SDCC, the compiler, MCS51 code
generator, Debugger, AVR port
Alan Baldwin (baldwin@shop-pdp.kent.edu) - Initial version of ASXXXX
& ASLINK.
John Hartman (jhartman@compuserve.com) - Porting ASXXX & ASLINK for
8051
Dmitry S. Obukhov (dso@usa.net) - malloc & serial i/o routines.
Daniel Drotos <drdani@mazsola.iit.uni-miskolc.hu> - for his Freeware
simulator
Malini Dutta(malini_dutta@hotmail.com) - my wife for her patience
and support.
Unknown - for the GNU C - preprocessor.
Michael Hope - The Z80 and Z80GB port, 186 development
Kevin Vigor - The DS390 port.
Johan Knol - DS390/TINI libs, lots of fixes and enhancements.
Scott Datallo - PIC port.
(Thanks to all the other volunteer developers who have helped with
coding, testing, web-page creation, distribution sets, etc. You know
who you are :-)
This document initially written by Sandeep Dutta
All product names mentioned herein may be trademarks of their respective companies.
This document was generated using the LaTeX2HTML translator Version 2K.1beta (1.47)
Copyright © 1993, 1994, 1995, 1996,
Nikos Drakos,
Computer Based Learning Unit, University of Leeds.
Copyright © 1997, 1998, 1999,
Ross Moore,
Mathematics Department, Macquarie University, Sydney.
The command line arguments were:
latex2html -no_subdir -split 0 -show_section_numbers /tmp/lyx_tmpdir72816uWRHo/lyx_tmpbuf7281E6F6dg/SDCCUdoc.tex
The translation was initiated by Karl Bongers on 2001-07-02