From caef4235d733aab6b04e1467fbf2e093dc847af7 Mon Sep 17 00:00:00 2001 From: johanknol Date: Fri, 13 Jul 2001 15:59:17 +0000 Subject: [PATCH] Reshaped doc's git-svn-id: https://sdcc.svn.sourceforge.net/svnroot/sdcc/trunk/sdcc@1067 4a8a32a2-be11-0410-ad9d-d568d2c75423 --- doc/SDCCUdoc.html | 4516 --------------- doc/SDCCUdoc.lyx | 8640 ----------------------------- doc/SDCCUdoc.pdf | Bin 410400 -> 0 bytes doc/sdccman.pdf | Bin 0 -> 144937 bytes doc/{SDCCUdoc.txt => sdccman.txt} | 720 +-- doc/test_suite_spec.pdf | Bin 0 -> 16017 bytes doc/test_suite_spec.txt | 298 + doc/widearticle.cls | 15 - 8 files changed, 658 insertions(+), 13531 deletions(-) delete mode 100644 doc/SDCCUdoc.html delete mode 100644 doc/SDCCUdoc.lyx delete mode 100644 doc/SDCCUdoc.pdf create mode 100644 doc/sdccman.pdf rename doc/{SDCCUdoc.txt => sdccman.txt} (87%) create mode 100644 doc/test_suite_spec.pdf create mode 100644 doc/test_suite_spec.txt delete mode 100644 doc/widearticle.cls diff --git a/doc/SDCCUdoc.html b/doc/SDCCUdoc.html deleted file mode 100644 index 86a06743..00000000 --- a/doc/SDCCUdoc.html +++ /dev/null @@ -1,4516 +0,0 @@ - - - - - -SDCC Compiler User Guide - - - - - - - - - - - - - - - -

-
-
-
- - -

- -

SDCC Compiler User Guide

-
- -

-Contents -

- - -

- -

-1. Introduction -

- -

-1.1 About SDCC -

- -

- -SDCC is a Freeware, 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 DS80C390 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 and 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
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: - -

- -

char (8 bits, 1 byte),
short and 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 (-cyclomatic) to report the relative -complexity of a function. These functions can then be further optimized, -or hand coded in assembly if needed. -
- -
-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/. - -

- -

-1.2 Open Source -

- -

-All packages used in this compiler system are opensource and -freeware; source code for all the sub-packages (asxxxx assembler/linker, -pre-processor) is 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! - -

- -

-1.3 Typographic conventions -

- -

-Throughout this manual, we will use the following convention. Commands -you have to type in are printed in "sans -serif". Code samples are printed in typewriter -font. Interesting items and new terms are printed in italicised -type. - -

- -

-1.4 Compatibility with previous versions -

- -

-This version has numerous bug fixes compared with the previous version. -But we also introduced some incompatibilities with older versions. -Not just for the fun of it, but to make the compiler more stable, -efficient and ANSI compliant. -
- -

- -

short is now equivalent to int (16 bits), it used to be equivalent -to char (8 bits)
the default directory where include, library and documention files -are stored is no in /usr/local/share
char type parameters to vararg functions are casted to int unless -explicitly casted, e.g.: -
- char a=3; -
- printf ("%d %c\n", -a, (char)a); -
-will push a as an int and as a char resp.
option -regextend has been removed
option -noreparms has been removed

-<pending: more incompatibilities?> - -

- -

-1.5 System Requirements -

- -

-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. - -

- -

-1.6 Other Resources -

- -

-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 cvs.sdcc.sourceforge.net. - -

- -

-1.7 Wishes for the future -

- -

-There are (and always will be) some things that could be done. Here -are some I can think of: -
- -

- -sdcc -c -model-large -o large _atoi.c (where large -could be a different basename or a directory) -
- -

- -char KernelFunction3(char p) at 0x340; -
-
-If you can think of some more, please send them to the list. -
- -
-<pending: And then of course a proper index-table> - -

- -

-2. Installation -

- -

-2.1 Linux/Unix Installation -

- -

Download the source package, it will be named something like sdcc-2.x.x.tgz.
Bring up a command line terminal, such as xterm.
Unpack the file using a command like: "tar --xzf sdcc-2.x.x.tgz", this will create a sub-directory -called sdcc with all of the sources.
Change directory into the main SDCC directory, for example type: "cd -sdcc".
Type "./configure". This configures -the package for compilation on your system.
Type "make". All of the source -packages will compile, this can take a while.
Type "make install" as root. This -copies the binary executables, the include files, the libraries and -the documentation to the install directories.

- -

-2.2 Windows Installation -

- -

- -<pending: is this complete? where is borland, mingw> -
-
-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. - -

- -

-2.2.1 Windows Install Using a Binary Package -

- -

Download the binary package and unpack it using your favorite unpacking -tool (gunzip, WinZip, etc). This should unpack to a group of sub-directories. -An example directory structure after unpacking is: c:\usr\local\bin -for the executables, c:\usr\local\share\sdcc\include -and c:\usr\local\share\sdcc\lib -for the include and libraries.
Adjust your environment PATH to include the location of the bin directory. -For example, make a setsdcc.bat file with the following: set PATH=c:\usr\local\bin;%PATH%
When you compile with sdcc, you may need to specify the location of -the lib and include folders. For example, sdcc -I c:\usr\local\share\sdcc\include --L c:\usr\local\share\sdcc\lib\small -test.c

- -

-2.2.2 Windows Install Using Cygwin -

- -

Download and install the cygwin package from the redhat site http://sources.redhat.com/cygwin/. -Currently, this involved downloading a small install program which -then automates downloading and installing selected parts of the package -(a large 80M byte sized dowload for the whole thing).
Bring up a Unix/Bash command line terminal from the Cygwin menu.
Follow the instructions in the preceding Linux/Unix installation section.

- -

-2.3 Testing out the SDCC Compiler -

- -

-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: -
-
-int test(int t) { -
- return t+3; -
-} -
-
-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 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). - -

- -

-2.4 Install Trouble-shooting -

- -

-2.4.1 SDCC cannot find libraries or header files. -

- -

-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". - -

- -

-2.4.2 SDCC does not compile correctly. -

- -

-A thing to try is starting from scratch by unpacking the .tgz source -package again in an empty directory. Confure it again and build like: -
- -
-make 2SPMamp;>1 | tee make.log -
- -
-After this you can review the make.log file to locate the problem. -Or a relevant part of this be attached to an email that could be helpful -when requesting help from the mailing list. - -

- -

-2.4.3 What the ''./configure'' does -

- -

-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. - -

- -

-2.4.4 What the ''make'' does. -

- -

-This runs the GNU make tool, which automatically compiles all the -source packages into the final installed binary executables. - -

- -

-2.4.5 What the ''make install'' command does. -

- -

-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. - -

- -

-2.5 Additional Information for Windows Users -

- -

- -<pending: is this up to date?> -
-
-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. - -

- -

-2.5.1 Getting started with Cygwin -

- -

-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. - -

- -

-2.5.2 Running SDCC as Native Compiled Executables -

- -

-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. - -

- -

-2.6 SDCC on Other Platforms -

- -

FreeBSD and other non-GNU Unixes - Make sure the GNU make -is installed as the default make tool.
SDCC has been ported to run under a variety of operating systems and -processors. If you can run GNU GCC/make then chances are good SDCC -can be compiled and run on your system.

- -

-2.7 Advanced Install Options -

- -

-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 -(if they do not already exist). -
- -
-bin/ - binary exectables (add to PATH environment variable) -
-bin/share/ -
-bin/share/sdcc/include/ - include header files -
-bin/share/sdcc/lib/ -
-bin/share/sdcc/lib/small/ - Object & library files for small model -library -
-bin/share/sdcc/lib/large/ - Object & library files for large model -library -
-bin/share/sdcc/lib/ds390/ - Object & library files forDS80C390 library -
- -
-The command ''./configure -prefix=/usr/local'' -will configure the compiler to be installed in directory /usr/local. - -

- -

-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. - -

- -

-3. Using SDCC -

- -

-3.1 Compiling -

- -

-3.1.1 Single Source File Projects -

- -

-For single source file 8051 projects the process is very simple. Compile -your programs with the following command "sdcc -sourcefile.c". This will compile, assemble and link your -source file. Output files are as follows -
- -
-sourcefile.asm - Assembler source file created by the compiler -
-sourcefile.lst - Assembler listing file created by the Assembler -
-sourcefile.rst - Assembler listing file updated with linkedit information, -created by linkage editor -
-sourcefile.sym - symbol listing for the sourcefile, created by the -assembler -
-sourcefile.rel - Object file created by the assembler, input to Linkage -editor -
-sourcefile.map - The memory map for the load module, created by the -Linker -
-sourcefile.ihx - The load module in Intel hex format (you can select -the Motorola S19 format with -out-fmt-s19) -
-sourcefile.cdb - An optional file (with -debug) containing debug -information -
- -

- -

-3.1.2 Projects with Multiple Source Files -

- -

-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 the main() function -and link the 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. - -

- -

-3.1.3 Projects with Additional Libraries -

- -

-Some reusable routines may be compiled into a library, see the documentation -for the assembler and linkage editor (which are in <installdir>/share/sdcc/doc) -for how to create a .lib library file. Libraries created in -this manner can be included in the command line. Make sure you include -the -L <library-path> option to tell the linker where to look for -these files if they are not in the current directory. Here is an example, -assuming you have the source file foomain.c and a library foolib.lib -in the directory mylib (if that is not the same as your current -project): -
- -
-sdcc foomain.c foolib.lib -L mylib -
-
-Note here that mylib must be an absolute path name. -
- -
-The most efficient way to use libraries is to keep seperate modules -in seperate source files. The lib file now should name all the modules.rel -files. For an example see the standard library file libsdcc.lib -in the directory <installdir>/share/lib/small. - -

- -

-3.2 Command Line Options -

- -

-3.2.1 Processor Selection Options -

- -

[-mmcs51]Generate code for the MCS51 (8051) family of processors. -This is the default processor target.
[-mds390]Generate code for the DS80C390 processor.
[-mz80]Generate code for the Z80 family of processors.
[-mgbz80]Generate code for the GameBoy Z80 processor.
[-mavr]Generate code for the Atmel AVR processor(In development, -not complete).
[-mpic14]Generate code for the PIC 14-bit processors(In development, -not complete).
[-mtlcs900h]Generate code for the Toshiba TLCS-900H processor(In -development, not complete).

- -

-3.2.2 Preprocessor Options -

- -

[-I<path>]The additional location where the pre processor -will look for <..h> or ``..h'' files.
[-D<macro[=value]>]Command line definition of macros. -Passed to the pre processor.
[-M]Tell the preprocessor to output a rule suitable for make -describing the dependencies of each object file. For each source file, -the preprocessor outputs one make-rule whose target is the object -file name for that source file and whose dependencies are all the -files `#include'd in it. This rule may be a single line or may be -continued with `\'-newline if it is long. The list -of rules is printed on standard output instead of the preprocessed -C program. `-M' implies `-E'.
[-C]Tell the preprocessor not to discard comments. Used with -the `-E' option.
[-MM]Like `-M' but the output mentions only the user header -files included with `#include ``file"'. System header -files included with `#include <file>' are omitted.
[-Aquestion(answer)]Assert the answer answer for question, -in case it is tested with a preprocessor conditional such as `#if -#question(answer)'. `-A-' disables the standard assertions that normally -describe the target machine.
[-Aquestion](answer) Assert the answer answer for question, -in case it is tested with a preprocessor conditional such as `#if -#question(answer)'. `-A-' disables the standard assertions that normally -describe the target machine.
[-Umacro]Undefine macro macro. `-U' options are evaluated -after all `-D' options, but before any `-include' and `-imacros' options.
[-dM]Tell the preprocessor to output only a list of the macro -definitions that are in effect at the end of preprocessing. Used with -the `-E' option.
[-dD]Tell the preprocessor to pass all macro definitions -into the output, in their proper sequence in the rest of the output.
[-dN]Like `-dD' except that the macro arguments and contents -are omitted. Only `#define name' is included in the output.

- -

-3.2.3 Linker Options -

- -

[-L -lib-path]<absolute path to additional libraries> This -option is passed to the linkage editor's additional libraries search -path. The path name must be absolute. Additional library files may -be specified in the command line. See section Compiling programs for -more details.
[-xram-loc<Value>]The start location of the external ram, -default value is 0. The value entered can be in Hexadecimal or Decimal -format, e.g.: -xram-loc 0x8000 or -xram-loc 32768.
[-code-loc<Value>]The start location of the code segment, -default value 0. Note when this option is used the interrupt vector -table is also relocated to the given address. The value entered can -be in Hexadecimal or Decimal format, e.g.: -code-loc 0x8000 or -code-loc -32768.
[-stack-loc<Value>]The initial value of the stack pointer. -The default value of the stack pointer is 0x07 if only register bank -0 is used, if other register banks are used then the stack pointer -is initialized to the location above the highest register bank used. -eg. if register banks 1 & 2 are used the stack pointer will default -to location 0x18. The value entered can be in Hexadecimal or Decimal -format, eg. -stack-loc 0x20 or -stack-loc 32. If all four register -banks are used the stack will be placed after the data segment (equivalent -to -stack-after-data)
[-stack-after-data]This option will cause the stack to be -located in the internal ram after the data segment.
[-data-loc<Value>]The start location of the internal ram -data segment, the default value is 0x30.The value entered can be in -Hexadecimal or Decimal format, eg. -data-loc 0x20 or -data-loc 32.
[-idata-loc<Value>]The start location of the indirectly -addressable internal ram, default value is 0x80. The value entered -can be in Hexadecimal or Decimal format, eg. -idata-loc 0x88 or -idata-loc -136.
[-out-fmt-ihx]The linker output (final object code) is in -Intel Hex format. (This is the default option).
[-out-fmt-s19]The linker output (final object code) is in -Motorola S19 format.

- -

-3.2.4 MCS51 Options -

- -

[-model-large]Generate code for Large model programs see -section Memory Models for more details. If this option is used all -source files in the project should be compiled with this option. In -addition the standard library routines are compiled with small model, -they will need to be recompiled.
[-model-small]Generate code for Small Model programs see -section Memory Models for more details. This is the default model.

- -

-3.2.5 DS390 Options -

- -

[-model-flat24]Generate 24-bit flat mode code. This is the -one and only that the ds390 code generator supports right now and -is default when using -mds390. See section Memory Models for -more details.
[-stack-10bit]Generate code for the 10 bit stack mode of -the Dallas DS80C390 part. This is the one and only that the ds390 -code generator supports right now and is default when using -mds390. -In this mode, the stack is located in the lower 1K of the internal -RAM, which is mapped to 0x400000. Note that the support is incomplete, -since it still uses a single byte as the stack pointer. This means -that only the lower 256 bytes of the potential 1K stack space will -actually be used. However, this does allow you to reclaim the precious -256 bytes of low RAM for use for the DATA and IDATA segments. The -compiler will not generate any code to put the processor into 10 bit -stack mode. It is important to ensure that the processor is in this -mode before calling any re-entrant functions compiled with this option. -In principle, this should work with the -stack-auto option, -but that has not been tested. It is incompatible with the -xstack -option. It also only makes sense if the processor is in 24 bit contiguous -addressing mode (see the -model-flat24 option).

- -

-3.2.6 Optimization Options -

- -

[-nogcse]Will not do global subexpression elimination, this -option may be used when the compiler creates undesirably large stack/data -spaces to store compiler temporaries. A warning message will be generated -when this happens and the compiler will indicate the number of extra -bytes it allocated. It recommended that this option NOT be used, #pragma NOGCSE -can be used to turn off global subexpression elimination for a given -function only.
[-noinvariant]Will not do loop invariant optimizations, -this may be turned off for reasons explained for the previous option. -For more details of loop optimizations performed see section Loop -Invariants.It recommended that this option NOT be used, #pragma NOINVARIANT -can be used to turn off invariant optimizations for a given function -only.
[-noinduction]Will not do loop induction optimizations, -see section strength reduction for more details.It is recommended -that this option is NOT used, #pragma NOINDUCTION can be used to -turn off induction optimizations for a given function only.
[-nojtbound] Will not generate boundary condition check -when switch statements are implemented using jump-tables. See section -Switch Statements for more details. It is recommended that this option -is NOT used, #pragma NOJTBOUND can be used to turn off boundary -checking for jump tables for a given function only.
[-noloopreverse]Will not do loop reversal optimization.

- -

-3.2.7 Other Options -

- -

[-c -compile-only]will compile and assemble the source, -but will not call the linkage editor.
[-E]Run only the C preprocessor. Preprocess all the C source -files specified and output the results to standard output.
[-stack-auto]All functions in the source file will be compiled -as reentrant, i.e. the parameters and local variables will -be allocated on the stack. see section Parameters and Local Variables -for more details. If this option is used all source files in the project -should be compiled with this option.
[-xstack]Uses a pseudo stack in the first 256 bytes in the -external ram for allocating variables and passing parameters. See -section on external stack for more details.
[-callee-saves]function1[,function2][,function3].... -The compiler by default uses a caller saves convention for register -saving across function calls, however this can cause unneccessary -register pushing & popping when calling small functions from larger -functions. This option can be used to switch the register saving convention -for the function names specified. The compiler will not save registers -when calling these functions, no extra code will be generated at the -entry & exit for these functions to save & restore the registers -used by these functions, this can SUBSTANTIALLY reduce code & improve -run time performance of the generated code. In the future the compiler -(with interprocedural analysis) will be able to determine the appropriate -scheme to use for each function call. DO NOT use this option for built-in -functions such as _muluint..., if this option is used for a library -function the appropriate library function needs to be recompiled with -the same option. If the project consists of multiple source files -then all the source file should be compiled with the same -callee-saves -option string. Also see #pragma CALLEE-SAVES.
[-debug]When this option is used the compiler will generate -debug information, that can be used with the SDCDB. The debug information -is collected in a file with .cdb extension. For more information see -documentation for SDCDB.
[-regextend] This option is obsolete and isn't -supported anymore.
[-noregparms]This option is obsolete and isn't -supported anymore.
[-peep-file<filename>]This option can be used to use additional -rules to be used by the peep hole optimizer. See section Peep Hole -optimizations for details on how to write these rules.
[-S]Stop after the stage of compilation proper; do not assemble. -The output is an assembler code file for the input file specified.
[-Wa_asmOption[,asmOption]...]Pass the asmOption to -the assembler.
[-Wl_linkOption[,linkOption]...]Pass the linkOption -to the linker.
[-int-long-reent] Integer (16 bit) and long (32 bit) libraries -have been compiled as reentrant. Note by default these libraries are -compiled as non-reentrant. See section Installation for more details.
[-cyclomatic]This option will cause the compiler to generate -an information message for each function in the source file. The message -contains some important information about the function. The -number of edges and nodes the compiler detected in the control flow -graph of the function, and most importantly the cyclomatic complexity -see section on Cyclomatic Complexity for more details.
[-float-reent] Floating point library is compiled as reentrant.See -section Installation for more details.
[-nooverlay] The compiler will not overlay parameters and -local variables of any function, see section Parameters and local -variables for more details.
[-main-return]This option can be used when the code generated -is called by a monitor program. The compiler will generate a 'ret' -upon return from the 'main' function. The default option is to lock -up i.e. generate a 'ljmp '.
[-no-peep] Disable peep-hole optimization.
[-peep-asm] Pass the inline assembler code through the peep -hole optimizer. This can cause unexpected changes to inline assembler -code, please go through the peephole optimizer rules defined in the -source file tree '<target>/peeph.def' before using this option.
[-iram-size<Value>]Causes the linker to check if the interal -ram usage is within limits of the given value.
[-nostdincl]This will prevent the compiler from passing -on the default include path to the preprocessor.
[-nostdlib]This will prevent the compiler from passing on -the default library path to the linker.
[-verbose]Shows the various actions the compiler is performing.
[-V]Shows the actual commands the compiler is executing.

- -

-3.2.8 Intermediate Dump Options -

- -

-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. - -

- -

[-dumpraw]This option will cause the compiler to dump the -intermediate code into a file of named <source filename>.dumpraw -just after the intermediate code has been generated for a function, -i.e. before any optimizations are done. The basic blocks at this stage -ordered in the depth first number, so they may not be in sequence -of execution.
[-dumpgcse]Will create a dump of iCode's, after global subexpression -elimination, into a file named <source filename>.dumpgcse.
[-dumpdeadcode]Will create a dump of iCode's, after deadcode -elimination, into a file named <source filename>.dumpdeadcode.
[-dumploop]Will create a dump of iCode's, after loop optimizations, -into a file named <source filename>.dumploop.
[-dumprange]Will create a dump of iCode's, after live range -analysis, into a file named <source filename>.dumprange.
[-dumlrange]Will dump the life ranges for all symbols.
[-dumpregassign]Will create a dump of iCode's, after register -assignment, into a file named <source filename>.dumprassgn.
[-dumplrange]Will create a dump of the live ranges of iTemp's
[-dumpall]Will cause all the above mentioned dumps to be -created.

- -

-3.3 MCS51/DS390 Storage Class Language Extensions -

- -

-In addition to the ANSI storage classes SDCC allows the following -MCS51 specific storage classes. - -

- -

-3.3.1 xdata -

- -

-Variables declared with this storage class will be placed in the extern -RAM. This is the default storage class for Large Memory model, -e.g.: -
- -
-xdata unsigned char xduc; - -

- -

-3.3.2 data -

- -

-This is the default storage class for Small Memory model. -Variables declared with this storage class will be allocated in the -internal RAM, e.g.: -
- -
-data int iramdata; - -

- -

-3.3.3 idata -

- -

-Variables declared with this storage class will be allocated into -the indirectly addressable portion of the internal ram of a 8051, -e.g.: -
- -
-idata int idi; - -

- -

-3.3.4 bit -

- -

-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, e.g.: -
- -
-bit iFlag; - -

- -

-3.3.5 sfr / sbit -

- -

-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) */ - -

- -

-3.4 Pointers -

- -

-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 still supported but -will disappear int the near future. -
-
-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 (4-byte for the ds390) -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 and NEW style could have unpredictable results. - -

- -

-3.5 Parameters & Local Variables -

- -

-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). This in fact makes them -static so by default functions are non-reentrant. - -

-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, e.g.: -
- -
-unsigned char foo(char i) reentrant -
-{ -
-... -
-} -
- -
-Since stack space on 8051 is limited, the reentrant keyword -or the -stack-auto option should be used sparingly. Note that -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. -
- -
-Local variables can be assigned storage classes and absolute addresses, -e.g.: -
- -
-unsigned char foo() { -
-    xdata unsigned char i; -
-    bit bvar; -
-    data at 0x31 unsiged char 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 -stack-auto or when a function -is declared as reentrant this can only be done for static variables. - -

-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. - -

- -

-3.6 Overlaying -

- -

-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 overlayed. - -

-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. - -

-Also note that the compiler does not do any processing of inline assembler -code, so the compiler might incorrectly assign local variables and -parameters of a function into the overlay segment if the inline assembler -code calls other c-functions that might use the overlay. In that case -the #pragma NOOVERLAY should be used. - -

-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, e.g.: -
- -
-#pragma SAVE -
-#pragma NOOVERLAY -
-void set_error(unsigned char 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 when -called from an ISR. The #pragma NOOVERLAY ensures that the parameters -and local variables for the function are NOT overlayed. - -

- -

-3.7 Interrupt Service Routines -

- -

-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 be 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 or included 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 using 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. -
- -
-Also see the _naked modifier. - -

- -

-3.8 Critical Functions -

- -

-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. -
- -
-int foo () critical -
-{ -
-... -
-... -
-} -
- -
-The critical attribute maybe used with other attributes like reentrant. - -

- -

-3.9 Naked Functions -

- -

-A special keyword may be associated with a function declaring it as -_naked. The _naked function modifier attribute prevents -the compiler from generating prologue and epilogue code for that function. -This means that the user is entirely responsible for such things as -saving any registers that may need to be preserved, selecting the -proper register bank, generating the return instruction at -the end, etc. Practically, this means that the contents of the function -must be written in inline assembler. This is particularly useful for -interrupt functions, which can have a large (and often unnecessary) -prologue/epilogue. For example, compare the code generated by these -two functions: -
- -
-data unsigned char counter; -
-void simpleInterrupt(void) interrupt 1 -
-{ -
-    counter++; -
-} -
-
-void nakedInterrupt(void) interrupt 2 _naked -
-{ -
-    _asm -
-      inc     _counter -
-      reti    ; MUST explicitly include ret in _naked -function. -
-    _endasm; -
-} -
- -
-For an 8051 target, the generated simpleInterrupt looks like: -
- -
-_simpleIterrupt: -
-    push    acc -
-    push    b -
-    push    dpl -
-    push    dph -
-    push    psw -
-    mov     psw,#0x00 -
-    inc     _counter -
-    pop     psw -
-    pop     dph -
-    pop     dpl -
-    pop     b -
-    pop     acc -
-    reti -
- -
-whereas nakedInterrupt looks like: -
- -
-_nakedInterrupt: -
-    inc    _counter -
-    reti   ; MUST explicitly include ret(i) in _naked -function. -
- -
-While there is nothing preventing you from writing C code inside a -_naked function, there are many ways to shoot yourself in the foot -doing this, and is is recommended that you stick to inline assembler. - -

- -

-3.10 Functions using private banks -

- -

-The using attribute (which tells the compiler to use a register -bank other than the default bank zero) should only be applied to interrupt -functions (see note 1 below). This will in most circumstances make -the generated ISR code more efficient since it will not have to save -registers on the stack. - -

-The using attribute will have no effect on the generated code -for a non-interrupt function (but may occasionally be useful -anyway¹). -
-(pending: I don't think this has been done yet) - -

-An interrupt function using a non-zero bank will assume that -it can trash that register bank, and will not save it. Since high-priority -interrupts can interrupt low-priority ones on the 8051 and friends, -this means that if a high-priority ISR using a particular bank -occurs while processing a low-priority ISR using the same bank, -terrible and bad things can happen. To prevent this, no single register -bank should be used by both a high priority and a low priority -ISR. This is probably most easily done by having all high priority -ISRs use one bank and all low priority ISRs use another. If you have -an ISR which can change priority at runtime, you're on your own: I -suggest using the default bank zero and taking the small performance -hit. - -

-It is most efficient if your ISR calls no other functions. If your -ISR must call other functions, it is most efficient if those functions -use the same bank as the ISR (see note 1 below); the next best is -if the called functions use bank zero. It is very inefficient to call -a function using a different, non-zero bank from an ISR. - -

- -

-3.11 Absolute Addressing -

- -

-Data items can be assigned an absolute address with the at <address> -keyword, in addition to a storage class, e.g.: -
- -
-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 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 (.rst) and (.map) are a good places to look for such -overlaps. -
- -
-Absolute address can be specified for variables in all storage classes, -e.g.: -
- -
-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. - -

- -

-3.12 Startup Code -

- -

-The compiler inserts a call to the C routine _sdcc__external__startup() -at the start of the CODE area. This routine is in the runtime library. -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 need to setup hardware -or perform some other critical operation prior to static & global -variable initialization. - -

- -

-3.13 Inline Assembler Code -

- -

-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. -
- -
-_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, e.g.: -
- -
-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 ; -
-    /* some more c code */ -
-} -
-
-In other words inline assembly code can access labels defined in inline -assembly within the scope of the funtion. - -

-The same goes the other way, ie. labels defines in inline assembly -CANNOT be accessed by C statements. - -

- -

-3.14 int(16 bit) and long (32 bit) Support -

- -

-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, although some model specific assembler optimations -are used. The following files contain the described routine, all of -them can be found in <installdir>/share/sdcc/lib. -
- -
-<pending: tabularise this> -
- -
-_mulsint.c - signed 16 bit multiplication (calls _muluint) -
-_muluint.c - unsigned 16 bit multiplication -
-_divsint.c - signed 16 bit division (calls _divuint) -
-_divuint.c - unsigned 16 bit division -
-_modsint.c - signed 16 bit modulus (call _moduint) -
-_moduint.c - unsigned 16 bit modulus -
-_mulslong.c - signed 32 bit multiplication (calls _mululong) -
-_mululong.c - unsigned32 bit multiplication -
-_divslong.c - signed 32 division (calls _divulong) -
-_divulong.c - unsigned 32 division -
-_modslong.c - signed 32 bit modulus (calls _modulong) -
-_modulong.c - unsigned 32 bit modulus -
- -
-Since they are compiled as non-reentrant, interrupt service -routines should not do any of the above operations. If this is unavoidable -then the above routines will need to be compiled with the -stack-auto -option, after which the source program will have to be compiled with --int-long-rent option. - -

- -

-3.15 Floating Point Support -

- -

-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: -
- -
-<pending: tabularise this> -
- -
-_fsadd.c - add floating point numbers -
-_fssub.c - subtract floating point numbers -
-_fsdiv.c - divide floating point numbers -
-_fsmul.c - multiply floating point numbers -
-_fs2uchar.c - convert floating point to unsigned char -
-_fs2char.c - convert floating point to signed char -
-_fs2uint.c - convert floating point to unsigned int -
-_fs2int.c - convert floating point to signed int -
-_fs2ulong.c - convert floating point to unsigned long -
-_fs2long.c - convert floating point to signed long -
-_uchar2fs.c - convert unsigned char to floating point -
-_char2fs.c - convert char to floating point number -
-_uint2fs.c - convert unsigned int to floating point -
-_int2fs.c - convert int to floating point numbers -
-_ulong2fs.c - convert unsigned long to floating point number -
-_long2fs.c - convert long to floating point number -
- -
-Note if all these routines are used simultaneously the data space -might overflow. For serious floating point usage it is strongly recommended -that the large model be used. - -

- -

-3.16 MCS51 Memory Models -

- -

-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. - -

-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. - -

- -

-3.17 DS390 Memory Models -

- -

-The only model supported is Flat 24. This 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. -
- -
-Note that the compiler does not generate any code to place the processor -into 24 bitmode (although tinibios in the ds390 libraries will -do that for you). If you don't use tinibios, the 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. However, currently the linker can not handle -code segments > 64k. - -

- -

-3.18 Defines Created by the Compiler -

- -

-The compiler creates the following #defines. - -

- -

SDCC - this Symbol is always defined.
SDCC_mcs51 or SDCC_ds390 or SDCC_z80, etc - depending on the model -used (e.g.: -mds390)
__mcs51 or __ds390 or __z80, etc - depending on the model used -(e.g. -mz80)
SDCC_STACK_AUTO - this symbol is defined when -stack-auto -option is used.
SDCC_MODEL_SMALL - when -model-small is used.
SDCC_MODEL_LARGE - when -model-large is used.
SDCC_USE_XSTACK - when -xstack option is used.
SDCC_STACK_TENBIT - when -mds390 is used
SDCC_MODEL_FLAT24 - when -mds390 is used

- -

-4. SDCC Technical Data -

- -

-4.1 Optimizations -

- -

-SDCC performs a host of standard optimizations in addition to some -MCU specific optimizations. - -

- -

-4.1.1 Sub-expression Elimination -

- -

-The compiler does local and global common subexpression elimination, -e.g.: -
- -
-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, e.g.: -
- -
-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. - -

- -

-4.1.2 Dead-Code Elimination -

- -

- -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; -
-} - -

- -

-4.1.3 Copy-Propagation -

- -

- -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. - -

- -

-4.1.4 Loop Optimizations -

- -

-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 -using #pragma NOINDUCTION. -
- -
-Loop Invariant: -
- -
-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. -
- -
-Strength Reduction, this optimization substitutes an expression by -a cheaper expression: -
- -
-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. - -

- -

-4.1.5 Loop Reversing -

- -

-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 compilers use data-dependency -analysis to make this determination, SDCC uses a more simple minded -analysis). - -

- -

The 'for' loop is of the form -
- -
-for (<symbol> = <expression> ; <sym> [< | <=] <expression> -; [<sym>++ | <sym> += 1]) -
- <for body>
The <for body> does not contain ``continue'' or 'break''.
All goto's are contained within the loop.
No function calls within the loop.
The loop control variable <sym> is not assigned any value within the -loop
The loop control variable does NOT participate in any arithmetic operation -within the loop.
There are NO switch statements in the loop.

-Note djnz instruction can be used for 8-bit values only, therefore -it is advantageous to declare loop control symbols as char. -Ofcourse this may not be possible on all situations. - -

- -

-4.1.6 Algebraic Simplifications -

- -

-SDCC does numerous algebraic simplifications, the following is a small -sub-set of these optimizations. -
- -
-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. - -

- -

-4.1.7 'switch' Statements -

- -

-SDCC changes switch statements to jump tables when the following conditions -are true. - -

- -

The case labels are in numerical sequence, the labels need not be -in order, and the starting number need not be one or zero. -
- -
-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.
The number of case labels is at least three, since it takes two conditional -statements to handle the boundary conditions.
The number of case labels is less than 84, since each label takes -3 bytes and a jump-table can be utmost 256 bytes long.

-Switch statements which have gaps in the numeric sequence or those -that have more that 84 case labels can be split into more than one -switch statement for efficient code generation, e.g.: -
- -
-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: ... -
-} -
-
-and -
-
-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. - -

- -

-4.1.8 Bit-shifting Operations. -

- -

-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, e.g.: -
-
-unsigned char 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). - -

- -

-4.1.9 Bit-rotation -

- -

-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 */ - -

- -

-4.1.10 Highest Order Bit -

- -

-It is frequently required to obtain the highest order bit of an integral -type (long, int, short or char types). SDCC recognizes the following -expression to yield the highest order bit and generates optimized -code for it, e.g.: -
- -
- 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, e.g.: -
- -
-xyz = gint + ((gint >> 15) & 1); -
- -
-will still be recognized. - -

- -

-4.1.11 Peep-hole Optimizer -

- -

-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 change 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). E.g. some variants of the 8051 MCU allow only ajmp -and acall. The following two rules will change all ljmp -and lcall to ajmp and 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 then 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, but maybe 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 add your own rules in the default set there if you get tired -of specifying the -peep-file option. - -

- -

-4.2 Pragmas -

- -

-SDCC supports the following #pragma directives. This directives are -applicable only at a function level. - -

- -

SAVE - this will save all the current options.
RESTORE - will restore the saved options from the last save. Note -that SAVES & RESTOREs cannot be nested. SDCC uses the same buffer -to save the options each time a SAVE is called.
NOGCSE - will stop global subexpression elimination.
NOINDUCTION - will stop loop induction optimizations.
NOJTBOUND - will not generate code for boundary value checking, when -switch statements are turned into jump-tables.
NOOVERLAY - the compiler will not overlay the parameters and local -variables of a function.
NOLOOPREVERSE - Will not do loop reversal optimization
EXCLUDE NONE | {acc[,b[,dpl[,dph]]] - The exclude pragma -disables generation of pair of push/pop instruction in ISR function -(using interrupt keyword). The directive should be placed immediately -before the ISR function definition and it affects ALL ISR functions -following it. To enable the normal register saving for ISR functions -use #pragma EXCLUDE none.
CALLEE-SAVES function1[,function2[,function3...]] - The compiler -by default uses a caller saves convention for register saving across -function calls, however this can cause unneccessary register pushing -& popping when calling small functions from larger functions. This -option can be used to switch the register saving convention for the -function names specified. The compiler will not save registers when -calling these functions, extra code will be generated at the entry -& exit for these functions to save & restore the registers used -by these functions, this can SUBSTANTIALLY reduce code & improve -run time performance of the generated code. In future the compiler -(with interprocedural analysis) will be able to determine the appropriate -scheme to use for each function call. If -callee-saves command line -option is used, the function names specified in #pragma CALLEE-SAVES -is appended to the list of functions specified inthe command line.

-The pragma's are intended to be used to turn-off certain optimizations -which might cause the compiler to generate extra stack / data space -to store compiler generated temporary variables. This usually happens -in large functions. Pragma directives should be used as shown in the -following example, they are used to control options & optimizations -for a given function; pragmas should be placed before and/or after -a function, placing pragma's inside a function body could have unpredictable -results. -
- -
-#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. - -

- -

-4.3 <pending: this is messy and incomplete> Library Routines -

- -

-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       short/int -
-%ld        decimal       long -
-%hd        decimal       char -
-%x        hexadecimal    short/int -
-%lx       hexadecimal    long -
-%hx       hexadecimal    char -
-%o         octal         short/int -
-%lo        octal         long -
-%ho        octal         char -
-%c        character      char -
-%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); - -

- -

stdarg.h - contains definition for the following macros to be used -for variable parameter list, note that a function can have a variable -parameter list if and only if it is 'reentrant' - -
-va_list, va_start, va_arg, va_end. - -
-
setjmp.h - contains defintion for ANSI setjmp & longjmp routines. -Note in this case setjmp & longjmp can be used between functions -executing within the same register bank, if long jmp is executed from -a function that is using a different register bank from the function -issuing the setjmp function, the results may be unpredictable. The -jump buffer requires 3 bytes of data (the stack pointer & a 16 byte -return address), and can be placed in any address space.
stdlib.h - contains the following functions. - -
-atoi, atol. - -
-
string.h - contains the following functions. - -
-strcpy, strncpy, strcat, strncat, strcmp, strncmp, strchr, strrchr, -strspn, strcspn, strpbrk, strstr, strlen, strtok, memcpy, memcmp, -memset. - -
-
ctype.h - contains the following routines. - -
-iscntrl, isdigit, isgraph, islower, isupper, isprint, ispunct, isspace, -isxdigit, isalnum, isalpha. - -
-
malloc.h - The malloc routines are developed by Dmitry S. Obukhov -(dso@usa.net). These routines will allocate memory from the external -ram. Here is a description on how to use them (as described by the -author). - -
- -//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); -
-     // - -
-
serial.h - Serial IO routines are also developed by Dmitry S. Obukhov -(dso@usa.net). These routines are interrupt driven with a 256 byte -circular buffer, they also expect external ram to be present. Please -see documentation in file SDCCDIR/sdcc51lib/serial.c. Note the header -file ``serial.h'' MUST be included in the file containing the -'main' function.
ser.h - Alternate serial routine provided by Wolfgang Esslinger <wolfgang@WiredMinds.com> -these routines are more compact and faster. Please see documentation -in file SDCCDIR/sdcc51lib/ser.c
ser_ir.h - Another alternate set of serial routines provided by Josef -Wolf <jw@raven.inka.de>, these routines do not use the external ram.
reg51.h - contains register definitions for a standard 8051
float.h - contains min, max and other floating point related stuff.

-All library routines are compiled as -model-small, they are all non-reentrant, -if you plan to use the large model or want to make these routines -reentrant, then they will have to be recompiled with the appropriate -compiler option. - -

-Have not had time to do the more involved routines like printf, will -get to them shortly. - -

- -

-4.4 Interfacing with Assembly Routines -

- -

-4.4.1 Global Registers used for Parameter Passing -

- -

-The compiler always uses the global registers DPL,DPH,B and -ACC to pass the first parameter to a routine. The second parameter -onwards is either allocated on the stack (for reentrant routines or -if -stack-auto is used) or in the internal / external ram (depending -on the memory model). - -

- -

-4.4.2 Assembler Routine(non-reentrant) -

- -

-In the following example the function cfunc calls an assembler routine -asm_func, which takes two parameters. -
- -
-extern int asm_func(unsigned char, unsigned char); -
-
-int c_func (unsigned char i, unsigned char 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 varible 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 - -

- -

-4.4.3 Assembler Routine(reentrant) -

- -

-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 char, unsigned char); -
-
-int c_func (unsigned char i, unsigned char 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. - -

- -

-4.5 External Stack -

- -

-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. - -

- -

-4.6 ANSI-Compliance -

- -

-Deviations from the compliancy. - -

- -

functions are not always reentrant.
structures cannot be assigned values directly, cannot be passed as -function parameters or assigned to each other and cannot be a return -value from a function, e.g.: -
-
-struct s { ... }; -
-struct s s1, s2; -
-foo() -
-{ -
-    ... -
-    s1 = s2 ; /* is invalid in SDCC although allowed -in ANSI */ -
-    ... -
-} -
-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 */ -
-}
'long long' (64 bit integers) not supported.
'double' precision floating point not supported.
No support for setjmp and longjmp (for now).
Old K&R style function declarations are NOT allowed. -
-
-foo(i,j) /* this old style of function declarations */ - -
-int i,j; /* are valid in ANSI but not valid in SDCC */ - -
-{ -
- ... -
-}
functions declared as pointers must be dereferenced during the call. -
-
-int (*foo)(); -
-... -
-/* has to be called like this */ -
-(*foo)(); /* ansi standard allows calls to be made like -'foo()' */

- -

-4.7 Cyclomatic Complexity -

- -

-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 be 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. - -

- -

-5. TIPS -

- -

-Here are a few guidelines that will help the compiler generate more -efficient code, some of the tips are specific to this compiler others -are generally good programming practice. - -

- -

Use the smallest data type to represent your data-value. If it is -known in advance that the value is going to be less than 256 then -use a 'char' instead of a 'short' or 'int'.
Use unsigned when it is known in advance that the value is not going -to be negative. This helps especially if you are doing division or -multiplication.
NEVER jump into a LOOP.
Declare the variables to be local whenever possible, especially loop -control variables (induction).
Since the compiler does not do implicit integral promotion, the programmer -should do an explicit cast when integral promotion is required.
Reducing the size of division, multiplication & modulus operations -can reduce code size substantially. Take the following code for example. -
-
-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 support routine _muduint()), and the result will -be casted to an int. 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).

- -

-5.1 Notes on MCS51 memory layout -

- -

-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) -and 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 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 bit 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. - -

- -

-6. Retargetting for other MCUs. -

- -

-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. - -

- -

Parsing the source and building the annotated parse tree. This phase -is largely MCU independent (except for the language extensions). Syntax -& semantic checks are also done in this phase, along with some initial -optimizations like back patching labels and the pattern matching optimizations -like bit-rotation etc.
The second phase involves generating an intermediate code which can -be easy manipulated during the later phases. This phase is entirely -MCU independent. The intermediate code generation assumes the target -machine has unlimited number of registers, and designates them with -the name iTemp. The compiler can be made to dump a human readable -form of the code generated by using the -dumpraw option.
This phase does the bulk of the standard optimizations and is also -MCU independent. This phase can be broken down into several sub-phases: -
- -
-Break down intermediate code (iCode) into basic blocks. -
-Do control flow & data flow analysis on the basic blocks. -
-Do local common subexpression elimination, then global subexpression -elimination -
-Dead code elimination -
-Loop optimizations -
-If loop optimizations caused any changes then do 'global subexpression -elimination' and 'dead code elimination' again.
This phase determines the live-ranges; by live range I mean those -iTemp variables defined by the compiler that still survive after all -the optimizations. Live range analysis is essential for register allocation, -since these computation determines which of these iTemps will be assigned -to registers, and for how long.
Phase five is register allocation. There are two parts to this process. -
- -
-The first part I call 'register packing' (for lack of a better term). -In this case several MCU specific expression folding is done to reduce -register pressure. -
- -
-The second part is more MCU independent and deals with allocating -registers to the remaining live ranges. A lot of MCU specific code -does creep into this phase because of the limited number of index -registers available in the 8051.
The Code generation phase is (unhappily), entirely MCU dependent and -very little (if any at all) of this code can be reused for other MCU. -However the scheme for allocating a homogenized assembler operand -for each iCode operand may be reused.
As mentioned in the optimization section the peep-hole optimizer is -rule based system, which can reprogrammed for other MCUs.

- -

-7. SDCDB - Source Level Debugger -

- -

-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. - -

- -

-7.1 Compiling for Debugging -

- -

-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. - -

- -

-7.2 How the Debugger Works -

- -

-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. - -

- -

-7.3 Starting the Debugger -

- -

-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. - -

- -

foo.c - the source file.
foo.cdb - the debugger symbol information file.
foo.ihx - the intel hex format object file.

- -

-7.4 Command Line Options. -

- -

-directory=<source file directory> this option can used to specify -the directory search list. The debugger will look into the directory -list specified for source, cdb & ihx files. The items in the directory -list must be separated by ':', e.g. if the source files can be in -the directories /home/src1 and /home/src2, the -directory option -should be -directory=/home/src1:/home/src2. Note there can be no -spaces in the option.
-cd <directory> - change to the <directory>.
-fullname - used by GUI front ends.
-cpu <cpu-type> - this argument is passed to the simulator please -see the simulator docs for details.
-X <Clock frequency > this options is passed to the simulator please -see the simulator docs for details.
-s <serial port file> passed to simulator see the simulator docs for -details.
-S <serial in,out> passed to simulator see the simulator docs for -details.

- -

-7.5 Debugger Commands. -

- -

-As mention earlier the command interface for the debugger has been -deliberately kept as close the GNU debugger gdb, as possible. This -will help the integration with existing graphical user interfaces -(like ddd, xxgdb or xemacs) existing for the GNU debugger. - -

- -

-7.5.1 break [line | file:line | function | file:function] -

- -

-Set breakpoint at specified line or function: -
- -
-sdcdb>break 100 -
-sdcdb>break foo.c:100 -
-sdcdb>break funcfoo -
-sdcdb>break foo.c:funcfoo - -

- -

-7.5.2 clear [line | file:line | function | file:function ] -

- -

-Clear breakpoint at specified line or function: -
- -
-sdcdb>clear 100 -
-sdcdb>clear foo.c:100 -
-sdcdb>clear funcfoo -
-sdcdb>clear foo.c:funcfoo - -

- -

-7.5.3 continue -

- -

-Continue program being debugged, after breakpoint. - -

- -

-7.5.4 finish -

- -

-Execute till the end of the current function. - -

- -

-7.5.5 delete [n] -

- -

-Delete breakpoint number 'n'. If used without any option clear ALL -user defined break points. - -

- -

-7.5.6 info [break | stack | frame | registers ] -

- -

info break - list all breakpoints
info stack - show the function call stack.
info frame - show information about the current execution frame.
info registers - show content of all registers.

- -

-7.5.7 step -

- -

-Step program until it reaches a different source line. - -

- -

-7.5.8 next -

- -

-Step program, proceeding through subroutine calls. - -

- -

-7.5.9 run -

- -

-Start debugged program. - -

- -

-7.5.10 ptype variable -

- -

-Print type information of the variable. - -

- -

-7.5.11 print variable -

- -

-print value of variable. - -

- -

-7.5.12 file filename -

- -

-load the given file name. Note this is an alternate method of loading -file for debugging. - -

- -

-7.5.13 frame -

- -

-print information about current frame. - -

- -

-7.5.14 set srcmode -

- -

-Toggle between C source & assembly source. - -

- -

-7.5.15 ! simulator command -

- -

-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. - -

- -

-7.5.16 quit. -

- -

- -"Watch me now. Iam going Down. My name is Bobby Brown" - -

- -

-7.6 Interfacing with XEmacs. -

- -

-Two files (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 -(<installdir>/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. - -

- -

sdcdbsrc-cpu-type '51
sdcdbsrc-frequency '11059200
sdcdbsrc-serial nil

-The following is a list of key mapping for the debugger interface. - -

- -   -
-;; 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 -
-;; -
- -

- -

-8. Other Processors -

- -

-8.1 The Z80 and gbz80 port -

- -

-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. 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. - -

- -

-9. Support -

- -

-SDCC has grown to be a large project. The compiler alone (without -the preprocessor, assembler and linker) 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. - -

- -

-9.1 Reporting Bugs -

- -

-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. - -

- -

-10. Acknowledgments -

- -

-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 - Lots of fixes and enhancements, DS390/TINI libs. -
-Scott Datallo - The 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 was initially written by Sandeep Dutta - -

-All product names mentioned herein may be trademarks of their respective -companies. - -

-
- -

-Index -

index -: 1.7 Wishes for the - -

- -

-About this document ... -

- SDCC Compiler User Guide

-This document was generated using the -LaTeX2HTML translator Version 99.1 release (March 30, 1999) -

-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 -split 0 -show_section_numbers -dir fullhtml SDCCUdoc -

-The translation was initiated by Johan Knol on 2001-07-07 -

Footnotes

... -anyway ¹ -: possible exception: if a function is called ONLY from 'interrupt' -functions using a particular bank, it can be declared with the same -'using' attribute as the calling 'interrupt' functions. For instance, -if you have several ISRs using bank one, and all of them call memcpy(), -it might make sense to create a specialized version of memcpy() 'using -1', since this would prevent the ISR from having to save bank zero -to the stack on entry and switch to bank zero before calling the function - - -

- -

-
- -

-Johan Knol -
2001-07-07 -

- - diff --git a/doc/SDCCUdoc.lyx b/doc/SDCCUdoc.lyx deleted file mode 100644 index d615fcbe..00000000 --- a/doc/SDCCUdoc.lyx +++ /dev/null @@ -1,8640 +0,0 @@ -#LyX 1.1 created this file. For more info see http://www.lyx.org/ -\lyxformat 218 -\textclass article -\language english -\inputencoding default -\fontscheme default -\graphics default -\paperfontsize default -\spacing single -\papersize Default -\paperpackage a4 -\use_geometry 0 -\use_amsmath 0 -\paperorientation portrait -\secnumdepth 3 -\tocdepth 3 -\paragraph_separation indent -\defskip medskip -\quotes_language swedish -\quotes_times 2 -\papercolumns 1 -\papersides 1 -\paperpagestyle fancy - -\layout Title - -SDCC Compiler User Guide -\layout Standard - - -\begin_inset LatexCommand \tableofcontents{} - -\end_inset - - -\layout Section - -Introduction -\layout Subsection - -About SDCC -\layout Standard - - -\series bold -SDCC -\series default - is a Freeware, retargettable, optimizing ANSI-C compiler by -\series bold -Sandeep Dutta -\series default - designed for 8 bit Microprocessors. - The current version targets Intel MCS51 based Microprocessors(8051,8052, - etc), Zilog Z80 based MCUs, and the Dallas DS80C390 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 microcont -rollers and underlying hardware effectively. - -\newline - -\newline -In addition to the MCU specific optimizations SDCC also does a host of standard - optimizations like: -\layout Itemize - -global sub expression elimination, -\layout Itemize - -loop optimizations (loop invariant, strength reduction of induction variables - and loop reversing), -\layout Itemize - -constant folding & propagation, -\layout Itemize - -copy propagation, -\layout Itemize - -dead code elimination -\layout Itemize - -jumptables for -\emph on -switch -\emph default - statements. -\layout Standard - -For the back-end SDCC uses a global register allocation scheme which should - be well suited for other 8 bit MCUs. - -\newline - -\newline -The peep hole optimizer uses a rule based substitution mechanism which is - MCU independent. - -\newline - -\newline -Supported data-types are: -\layout Itemize - -char (8 bits, 1 byte), -\layout Itemize - -short and int (16 bits, 2 bytes), -\layout Itemize - -long (32 bit, 4 bytes) -\layout Itemize - -float (4 byte IEEE). - -\layout Standard - -The compiler also allows -\emph on -inline assembler code -\emph default - to be embedded anywhere in a function. - In addition, routines developed in assembly can also be called. -\newline - -\newline -SDCC also provides an option (--cyclomatic) to report the relative complexity - of a function. - These functions can then be further optimized, or hand coded in assembly - if needed. - -\newline - -\newline -SDCC also comes with a companion source level debugger SDCDB, the debugger - currently uses ucSim a freeware simulator for 8051 and other micro-controllers. - -\newline - -\newline -The latest version can be downloaded from -\begin_inset LatexCommand \htmlurl{http://sdcc.sourceforge.net/} - -\end_inset - - -\series bold -. -\layout Subsection - -Open Source -\layout Standard - -All packages used in this compiler system are -\emph on -opensource -\emph default - and -\emph on -freeware -\emph default -; source code for all the sub-packages (asxxxx assembler/linker, pre-processor) - is distributed with the package. - This documentation is maintained using a freeware word processor (LyX). - -\layout Standard - -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! -\layout Subsection - -Typographic conventions -\layout Standard - -Throughout this manual, we will use the following convention. - Commands you have to type in are printed in -\family sans -\series bold -"sans serif" -\series default -. - -\family default - Code samples are printed in -\family typewriter -typewriter font. - -\family default - Interesting items and new terms are printed in -\emph on -italicised type. -\layout Subsection - -Compatibility with previous versions -\layout Standard - -This version has numerous bug fixes compared with the previous version. - But we also introduced some incompatibilities with older versions. - Not just for the fun of it, but to make the compiler more stable, efficient - and ANSI compliant. - -\newline - -\layout Itemize - -short is now equivalent to int (16 bits), it used to be equivalent to char - (8 bits) -\layout Itemize - -the default directory where include, library and documention files are stored - is no in /usr/local/share -\layout Itemize - -char type parameters to vararg functions are casted to int unless explicitly - casted, e.g.: -\newline - -\family typewriter -\SpecialChar ~ -\SpecialChar ~ -char a=3; -\newline -\SpecialChar ~ -\SpecialChar ~ -printf ("%d %c -\backslash -n", a, (char)a); -\family default - -\newline - will push a as an int and as a char resp. -\layout Itemize - -option --regextend has been removed -\layout Itemize - -option --noreparms has been removed -\layout Standard - - -\emph on - -\layout Subsection - -System Requirements -\layout Standard - -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. -\layout Subsection - -Other Resources -\layout Standard - -The SDCC home page at -\begin_inset LatexCommand \htmlurl{http://sdcc.sourceforge.net/} - -\end_inset - - 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 cvs.sdcc.sourceforge.net. -\layout Subsection - -Wishes for the future -\layout Standard - -There are (and always will be) some things that could be done. - Here are some I can think of: -\newline - -\layout Standard - - -\family sans -\series bold -sdcc -c --model-large -o large _atoi.c -\family default -\series default - (where large could be a different basename or a directory) -\newline - -\layout Standard - - -\family typewriter -char KernelFunction3(char p) at 0x340; -\newline - -\newline - -\family default -If you can think of some more, please send them to the list. -\newline - -\newline - -\emph on - -\layout Section - -Installation -\layout Subsection - -Linux/Unix Installation -\layout Enumerate - - -\series medium -Download the source package, it will be named something like sdcc-2.x.x.tgz. -\layout Enumerate - - -\series medium -Bring up a command line terminal, such as xterm. -\layout Enumerate - - -\series medium -Unpack the file using a command like: -\family sans -\series bold -"tar -xzf sdcc-2.x.x.tgz -\family default -\series default -" -\series medium -, this will create a sub-directory called sdcc with all of the sources. -\layout Enumerate - -Change directory into the main SDCC directory, for example type: -\family sans -\series bold -"cd sdcc -\series default -". -\layout Enumerate - - -\series medium -Type -\family sans -\series bold -"./configure -\family default -\series default -". - This configures the package for compilation on your system. -\layout Enumerate - - -\series medium -Type -\family sans -\series bold -"make -\family default -\series default -" -\series medium -. - -\series default - All of the source packages will compile, this can take a while. -\layout Enumerate - - -\series medium -Type -\family sans -\series bold -"make install" -\family default -\series default - as root -\series medium -. - -\series default - This copies the binary executables, the include files, the libraries and - the documentation to the install directories. -\layout Subsection - -Windows Installation -\layout Standard - - -\emph on - -\newline - -\newline - -\emph default -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. -\layout Subsubsection - -Windows Install Using a Binary Package -\layout Enumerate - -Download the binary package and unpack it using your favorite unpacking - tool (gunzip, WinZip, etc). - This should unpack to a group of sub-directories. - An example directory structure after unpacking is: c: -\backslash -usr -\backslash -local -\backslash -bin for the executables, c: -\backslash -usr -\backslash -local -\backslash -share -\backslash -sdcc -\backslash -include and c: -\backslash -usr -\backslash -local -\backslash -share -\backslash -sdcc -\backslash -lib for the include and libraries. -\layout Enumerate - -Adjust your environment PATH to include the location of the bin directory. - For example, make a setsdcc.bat file with the following: set PATH=c: -\backslash -usr -\backslash -local -\backslash -bin;%PATH% -\layout Enumerate - -When you compile with sdcc, you may need to specify the location of the - lib and include folders. - For example, sdcc -I c: -\backslash -usr -\backslash -local -\backslash -share -\backslash -sdcc -\backslash -include -L c: -\backslash -usr -\backslash -local -\backslash -share -\backslash -sdcc -\backslash -lib -\backslash -small test.c -\layout Subsubsection - -Windows Install Using Cygwin -\layout Enumerate - - -\series medium -Download and install the cygwin package from the redhat site -\series default - -\begin_inset LatexCommand \htmlurl{http://sources.redhat.com/cygwin/} - -\end_inset - - -\series medium -. - Currently, this involved downloading a small install program which then - automates downloading and installing -\series default -selected parts of -\series medium - the package -\series default - (a large 80M byte sized dowload for the whole thing) -\series medium -. - -\series default - -\layout Enumerate - - -\series medium -Bring up a -\series default -Unix/Bash -\series medium -command line terminal from the Cygwin menu. -\layout Enumerate - - -\series medium -Follow the instructions in the preceding Linux/Unix installation section. -\layout Subsection - -Testing out the SDCC Compiler -\layout Standard - -The first thing you should do after installing your SDCC compiler is to - see if it runs. - Type -\family sans -\series bold -"sdcc --version" -\family default -\series default - 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. -\newline - -\newline - -\series medium -SDCC binaries are commonly installed in a directory arrangement like this: -\series default - -\newline - -\newline - -\begin_inset Tabular - - - - - - -\begin_inset Text - -\layout Standard - -/ -\series medium -usr/local/bin -\end_inset - - -\begin_inset Text - -\layout Standard - - -\series medium -Holds executables(sdcc, s51, aslink, -\series default -... -\series medium -) -\end_inset - - - - -\begin_inset Text - -\layout Standard - -/ -\series medium -usr/local/share/sdcc/lib -\end_inset - - -\begin_inset Text - -\layout Standard - - -\series medium -Holds common C -\series default -libraries -\end_inset - - - - -\begin_inset Text - -\layout Standard - -/ -\series medium -usr/local/share/sdcc/include -\end_inset - - -\begin_inset Text - -\layout Standard - - -\series medium -Holds common C header files -\end_inset - - - - -\end_inset - - -\newline - -\newline - -\series medium -Make sure the compiler works on a very simple example. - Type in the following test.c program using your favorite editor: -\series default - -\newline - -\emph on - -\newline - -\family typewriter -\emph default -int test(int t) { -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -return t+3; -\newline -} -\family default - -\newline - -\emph on - -\newline - -\series medium -\emph default -Compile this using the following command: -\family sans -\series bold -"sdcc -c test.c". - -\family default -\series default - -\series medium -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. -\series default - -\newline - -\newline - -\series medium -The next step is to try it with the linker. - Type in -\family sans -\series bold -"sdcc test.c -\family default -\series default -" -\series medium -. - If all goes well the compiler will link with the libraries and produce - a test.ihx output file. - If this step fails -\series default - -\series medium -(no test.ihx, and the linker generates warnings), then the problem is most - likely that sdcc cannot find the -\series default -/ -\series medium -usr/local/share/sdcc/lib directory -\series default - -\series medium -(see the Install trouble-shooting section for suggestions). -\series default - -\newline - -\newline - -\series medium -The final test is to ensure sdcc can use the -\series default -standard -\series medium - header files and libraries. - Edit test.c and change it to the following: -\series default - -\newline - -\newline -#include -\newline -main() { -\newline - -\family typewriter -char str1[10]; -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -strcpy(str1, "testing"); -\newline -} -\newline - -\newline - -\family default -\series medium -Compile this by typing -\family sans -\series bold -"sdcc test.c" -\family default -\series medium -. - 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 -\series default - -\series medium -(see the Install trouble-shooting section for suggestions). -\layout Subsection - -Install Trouble-shooting -\layout Subsubsection - -SDCC cannot find libraries or header files. -\layout Standard - -The default installation assumes the libraries and header files are located - at -\begin_inset Quotes eld -\end_inset - -/usr/local/share/sdcc/lib -\begin_inset Quotes erd -\end_inset - - and -\begin_inset Quotes eld -\end_inset - -/usr/local/share/sdcc/include -\begin_inset Quotes erd -\end_inset - -. - An alternative is to specify these locations as compiler options like this: - -\family sans -\series bold -"sdcc\SpecialChar ~ --L\SpecialChar ~ -/usr/local/sdcc/lib/small\SpecialChar ~ --I\SpecialChar ~ -/usr/local/sdcc/include\SpecialChar ~ -test.c" -\family default -\series default -. -\layout Subsubsection - -SDCC does not compile correctly. -\layout Standard - -A thing to try is starting from scratch by unpacking the .tgz source package - again in an empty directory. - Confure it again and build like: -\newline - -\newline - -\family sans -\series bold -make 2&>1 | tee make.log -\family default -\series default - -\newline - -\newline -After this you can review the make.log file to locate the problem. - Or a relevant part of this be attached to an email that could be helpful - when requesting help from the mailing list. -\layout Subsubsection - -What the -\begin_inset Quotes sld -\end_inset - -./configure -\begin_inset Quotes srd -\end_inset - - does -\layout Standard - -The -\begin_inset Quotes sld -\end_inset - -./configure -\begin_inset Quotes srd -\end_inset - - 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. -\layout Subsubsection - -What the -\begin_inset Quotes sld -\end_inset - -make -\begin_inset Quotes srd -\end_inset - - does. -\layout Standard - -This runs the GNU make tool, which automatically compiles all the source - packages into the final installed binary executables. -\layout Subsubsection - -What the -\begin_inset Quotes sld -\end_inset - -make install -\begin_inset Quotes erd -\end_inset - - command does. -\layout Standard - -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. -\layout Subsection - -Additional Information for Windows Users -\layout Standard - - -\emph on - -\newline - -\newline - -\emph default -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 considerabl -y 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. - -\layout Standard - -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. -\layout Subsubsection - -Getting started with Cygwin -\layout Standard - -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 -\family sans -\series bold - -\begin_inset Quotes eld -\end_inset - -cd -\begin_inset Quotes erd -\end_inset - - -\family default -\series default -, the move command is -\family sans -\series bold - -\begin_inset Quotes eld -\end_inset - -mv -\begin_inset Quotes erd -\end_inset - - -\family default -\series default -. - To print the current working directory, type -\family sans -\series bold - -\begin_inset Quotes eld -\end_inset - -pwd -\begin_inset Quotes erd -\end_inset - - -\family default -\series default -. - To make a directory, use -\family sans -\series bold - -\begin_inset Quotes eld -\end_inset - -mkdir -\begin_inset Quotes erd -\end_inset - - -\family default -\series default -. -\layout Standard - -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 - ' -\backslash -' 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 -\begin_inset Quotes eld -\end_inset - -c: -\begin_inset Quotes eld -\end_inset - -, instead all files systems attach and appear as directories. -\layout Subsubsection - -Running SDCC as Native Compiled Executables -\layout Standard - -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: -\family sans -\series bold -"sdcc -L c: -\backslash -usr -\backslash -local -\backslash -sdcc -\backslash -lib -\backslash -small -I c: -\backslash -usr -\backslash -local -\backslash -sdcc -\backslash -include test.c" -\family default -\series default - if you are running outside of a Unix bash shell. -\layout Standard - -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 -\family sans -\series bold -"make -f Makefile.bcc" -\family default -\series default -. - A command line version of the Borland 32-bit compiler can be downloaded - from the Inprise web site. -\layout Subsection - -SDCC on Other Platforms -\layout Itemize - - -\series bold -FreeBSD and other non-GNU Unixes -\series default -- Make sure the GNU make is installed as the default make tool. -\layout Itemize - -SDCC has been ported to run under a variety of operating systems and processors. - If you can run GNU GCC/make then chances are good SDCC can be compiled - and run on your system. -\layout Subsection - -Advanced Install Options -\layout Standard - -The -\begin_inset Quotes eld -\end_inset - -configure -\begin_inset Quotes erd -\end_inset - - command has several options. - The most commonly used option is --prefix=, where 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 specified (if they do not already exist). - -\newline - -\newline -bin/ - binary exectables (add to PATH environment variable) -\newline -bin/share/ -\newline -bin/share/sdcc/include/ - include header files -\newline -bin/share/sdcc/lib/ -\newline -bin/share/sdcc/lib/small/ - Object & library files for small model library -\newline -bin/share/sdcc/lib/large/ - Object & library files for large model library -\newline -bin/share/sdcc/lib/ds390/ - Object & library files forDS80C390 library -\newline - -\newline -The command -\family sans -\series bold - -\begin_inset Quotes sld -\end_inset - -./configure --prefix=/usr/local -\begin_inset Quotes erd -\end_inset - - -\family default -\series default -will configure the compiler to be installed in directory /usr/local. -\layout Subsection - -Components of SDCC -\layout Standard - -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. -\newline - -\newline -You might want to look at the files which are installed in . - At the time of this writing, we find the following programs: -\newline - -\newline -In /bin: -\layout Itemize - -sdcc - The compiler. -\layout Itemize - -sdcpp - The C preprocessor. -\layout Itemize - -asx8051 - The assembler for 8051 type processors. -\layout Itemize - -as-z80 -\series bold -, -\series default -as-gbz80 - The Z80 and GameBoy Z80 assemblers. -\layout Itemize - -aslink -The linker for 8051 type processors. -\layout Itemize - -link-z80 -\series bold -, -\series default -link-gbz80 - The Z80 and GameBoy Z80 linkers. -\layout Itemize - -s51 - The ucSim 8051 simulator. -\layout Itemize - -sdcdb - The source debugger. -\layout Itemize - -packihx - A tool to pack Intel hex files. -\layout Standard - -In /share/sdcc/include -\layout Itemize - -the include files -\layout Standard - -In /share/sdcc/lib -\layout Itemize - -the sources of the runtime library and the subdirs small large and ds390 - with the precompiled relocatables. -\layout Standard - -In /share/sdcc/doc -\layout Itemize - -the documentation -\layout Standard - -As development for other processors proceeds, this list will expand to include - executables to support processors like AVR, PIC, etc. -\layout Subsubsection - -sdcc - The Compiler -\layout Standard - -This is the actual compiler, it in turn uses the c-preprocessor and invokes - the assembler and linkage editor. -\layout Subsubsection - -sdcpp (C-Preprocessor) -\layout Standard - -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. -\layout Subsubsection - -asx8051, as-z80, as-gbz80, aslink, link-z80, link-gbz80 (The Assemblers - and Linkage Editors) -\layout Standard - -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. -\layout Subsubsection - -s51 - Simulator -\layout Standard - -S51 is a freeware, opensource simulator developed by Daniel Drotos ( -\begin_inset LatexCommand \url{mailto:drdani@mazsola.iit.uni-miskolc.hu} - -\end_inset - -). - The simulator is built as part of the build process. - For more information visit Daniel's website at: -\begin_inset LatexCommand \url{http://mazsola.iit.uni-miskolc.hu/~drdani/embedded/s51} - -\end_inset - - . -\layout Subsubsection - -sdcdb - Source Level Debugger -\layout Standard - -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. -\layout Section - -Using SDCC -\layout Subsection - -Compiling -\layout Subsubsection - -Single Source File Projects -\layout Standard - -For single source file 8051 projects the process is very simple. - Compile your programs with the following command -\family sans -\series bold -"sdcc sourcefile.c". - -\family default -\series default - This will compile, assemble and link your source file. - Output files are as follows -\newline - -\newline -sourcefile.asm - Assembler source file created by the compiler -\newline -sourcefile.lst - Assembler listing file created by the Assembler -\newline -sourcefile.rst - Assembler listing file updated with linkedit information, - created by linkage editor -\newline -sourcefile.sym - symbol listing for the sourcefile, created by the assembler -\newline -sourcefile.rel - Object file created by the assembler, input to Linkage editor -\newline -sourcefile.map - The memory map for the load module, created by the Linker -\newline -sourcefile.ihx - The load module in Intel hex format (you can select the - Motorola S19 format with --out-fmt-s19) -\newline -sourcefile.cdb - An optional file (with --debug) containing debug information -\newline - -\layout Subsubsection - -Projects with Multiple Source Files -\layout Standard - -SDCC can compile only ONE file at a time. - Let us for example assume that you have a project containing the following - files: -\newline - -\newline -foo1.c (contains some functions) -\newline -foo2.c (contains some more functions) -\newline -foomain.c (contains more functions and the function main) -\newline - -\size footnotesize - -\newline - -\size default -The first two files will need to be compiled separately with the commands: -\size footnotesize - -\size default - -\newline - -\newline - -\family sans -\series bold -sdcc\SpecialChar ~ --c\SpecialChar ~ -foo1.c -\family default -\series default -\size footnotesize - -\newline - -\family sans -\series bold -\size default -sdcc\SpecialChar ~ --c\SpecialChar ~ -foo2.c -\family default -\series default - -\newline - -\newline -Then compile the source file containing the -\emph on -main() -\emph default - function and link the files together with the following command: -\newline - -\newline - -\family sans -\series bold -sdcc\SpecialChar ~ -foomain.c\SpecialChar ~ -foo1.rel\SpecialChar ~ -foo2.rel -\family default -\series default - -\newline - -\newline -Alternatively, -\emph on -foomain.c -\emph default -can be separately compiled as well: -\family sans -\series bold - -\newline - -\newline -sdcc\SpecialChar ~ --c\SpecialChar ~ -foomain.c -\newline -sdcc foomain.rel foo1.rel foo2.rel -\newline - -\newline - -\family default -\series default -The file containing the -\emph on -main() -\emph default - function -\emph on - -\emph default -\noun on -must -\noun default - be the -\noun on -first -\noun default - file specified in the command line, since the linkage editor processes - file in the order they are presented to it. -\layout Subsubsection - -Projects with Additional Libraries -\layout Standard - -Some reusable routines may be compiled into a library, see the documentation - for the assembler and linkage editor (which are in /share/sdcc/doc) - for how to create a -\emph on -.lib -\emph default - library file. - Libraries created in this manner can be included in the command line. - Make sure you include the -L option to tell the linker where - to look for these files if they are not in the current directory. - Here is an example, assuming you have the source file -\emph on -foomain.c -\emph default - and a library -\emph on - foolib.lib -\emph default - in the directory -\emph on -mylib -\emph default - (if that is not the same as your current project): -\newline - -\newline - -\family sans -\series bold -sdcc foomain.c foolib.lib -L mylib -\newline - -\newline - -\family default -\series default -Note here that -\emph on - mylib -\emph default - must be an absolute path name. -\newline - -\newline -The most efficient way to use libraries is to keep seperate modules in seperate - source files. - The lib file now should name all the modules.rel files. - For an example see the standard library file -\emph on -libsdcc.lib -\emph default - in the directory /share/lib/small. -\layout Subsection - -Command Line Options -\layout Subsubsection - -Processor Selection Options -\layout List -\labelwidthstring 00.00.0000 - - -\series bold --mmcs51 -\series default - Generate code for the MCS51 (8051) family of processors. - This is the default processor target. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold --mds390 -\series default - Generate code for the DS80C390 processor. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold --mz80 -\series default - Generate code for the Z80 family of processors. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold --mgbz80 -\series default - Generate code for the GameBoy Z80 processor. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold --mavr -\series default - Generate code for the Atmel AVR processor(In development, not complete). -\layout List -\labelwidthstring 00.00.0000 - - -\series bold --mpic14 -\series default - Generate code for the PIC 14-bit processors(In development, not complete). -\layout List -\labelwidthstring 00.00.0000 - - -\series bold --mtlcs900h -\series default - Generate code for the Toshiba TLCS-900H processor(In development, not complete). -\layout Subsubsection - -Preprocessor Options -\layout List -\labelwidthstring 00.00.0000 - - -\series bold --I -\series default - The additional location where the pre processor will look for <..h> or -\begin_inset Quotes eld -\end_inset - -..h -\begin_inset Quotes erd -\end_inset - - files. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold --D -\series default - Command line definition of macros. - Passed to the pre processor. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold --M -\series default - Tell the preprocessor to output a rule suitable for make describing the - dependencies of each object file. - For each source file, the preprocessor outputs one make-rule whose target - is the object file name for that source file and whose dependencies are - all the files `#include'd in it. - This rule may be a single line or may be continued with ` -\backslash -'-newline if it is long. - The list of rules is printed on standard output instead of the preprocessed - C program. - `-M' implies `-E'. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold --C -\series default - Tell the preprocessor not to discard comments. - Used with the `-E' option. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold --MM -\size large -\bar under - -\series default -\size default -\bar default -Like `-M' but the output mentions only the user header files included with - `#include -\begin_inset Quotes eld -\end_inset - -file"'. - System header files included with `#include ' are omitted. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold --Aquestion(answer) -\series default - Assert the answer answer for question, in case it is tested with a preprocessor - conditional such as `#if #question(answer)'. - `-A-' disables the standard assertions that normally describe the target - machine. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold --Aquestion -\series default - (answer) Assert the answer answer for question, in case it is tested with - a preprocessor conditional such as `#if #question(answer)'. - `-A-' disables the standard assertions that normally describe the target - machine. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold --Umacro -\series default - Undefine macro macro. - `-U' options are evaluated after all `-D' options, but before any `-include' - and `-imacros' options. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold --dM -\series default - Tell the preprocessor to output only a list of the macro definitions that - are in effect at the end of preprocessing. - Used with the `-E' option. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold --dD -\series default - Tell the preprocessor to pass all macro definitions into the output, in - their proper sequence in the rest of the output. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold --dN -\size large -\bar under - -\series default -\size default -\bar default -Like `-dD' except that the macro arguments and contents are omitted. - Only `#define name' is included in the output. -\layout Subsubsection - -Linker Options -\layout List -\labelwidthstring 00.00.0000 - - -\series bold --L\SpecialChar ~ ---lib-path -\bar under - -\series default -\bar default - This option is passed to the linkage - editor's additional libraries search path. - The path name must be absolute. - Additional library files may be specified in the command line. - See section Compiling programs for more details. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---xram-loc -\series default - The start location of the external ram, default value is 0. - The value entered can be in Hexadecimal or Decimal format, e.g.: --xram-loc - 0x8000 or --xram-loc 32768. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---code-loc -\series default - The start location of the code segment, default value 0. - Note when this option is used the interrupt vector table is also relocated - to the given address. - The value entered can be in Hexadecimal or Decimal format, e.g.: --code-loc - 0x8000 or --code-loc 32768. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---stack-loc -\series default - The initial value of the stack pointer. - The default value of the stack pointer is 0x07 if only register bank 0 - is used, if other register banks are used then the stack pointer is initialized - to the location above the highest register bank used. - eg. - if register banks 1 & 2 are used the stack pointer will default to location - 0x18. - The value entered can be in Hexadecimal or Decimal format, eg. - --stack-loc 0x20 or --stack-loc 32. - If all four register banks are used the stack will be placed after the - data segment (equivalent to --stack-after-data) -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---stack-after-data -\series default - This option will cause the stack to be located in the internal ram after - the data segment. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---data-loc -\series default - The start location of the internal ram data segment, the default - value is 0x30.The value entered can be in Hexadecimal or Decimal format, - eg. - --data-loc 0x20 or --data-loc 32. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---idata-loc -\series default - The start location of the indirectly addressable internal ram, default - value is 0x80. - The value entered can be in Hexadecimal or Decimal format, eg. - --idata-loc 0x88 or --idata-loc 136. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---out-fmt-ihx -\bar under - -\series default -\bar default -The linker output (final object code) is in Intel Hex format. - (This is the default option). -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---out-fmt-s19 -\bar under - -\series default -\bar default -The linker output (final object code) is in Motorola S19 format. -\layout Subsubsection - -MCS51 Options -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---model-large -\series default - Generate code for Large model programs see section Memory Models for more - details. - If this option is used all source files in the project should be compiled - with this option. - In addition the standard library routines are compiled with small model, - they will need to be recompiled. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---model-small -\series default -\size large -\emph on - -\size default -\emph default -Generate code for Small Model programs see section Memory Models for more - details. - This is the default model. -\layout Subsubsection - -DS390 Options -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---model-flat24 -\series default -\size large -\emph on - -\size default -\emph default -Generate 24-bit flat mode code. - This is the one and only that the ds390 code generator supports right now - and is default when using -\emph on --mds390 -\emph default -. - See section Memory Models for more details. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---stack-10bit -\series default - Generate code for the 10 bit stack mode of the Dallas DS80C390 part. - This is the one and only that the ds390 code generator supports right now - and is default when using -\emph on --mds390 -\emph default -. - In this mode, the stack is located in the lower 1K of the internal RAM, - which is mapped to 0x400000. - Note that the support is incomplete, since it still uses a single byte - as the stack pointer. - This means that only the lower 256 bytes of the potential 1K stack space - will actually be used. - However, this does allow you to reclaim the precious 256 bytes of low RAM - for use for the DATA and IDATA segments. - The compiler will not generate any code to put the processor into 10 bit - stack mode. - It is important to ensure that the processor is in this mode before calling - any re-entrant functions compiled with this option. - In principle, this should work with the -\emph on ---stack-auto -\emph default - option, but that has not been tested. - It is incompatible with the -\emph on ---xstack -\emph default - option. - It also only makes sense if the processor is in 24 bit contiguous addressing - mode (see the -\emph on ---model-flat24 option -\emph default -). -\layout Subsubsection - -Optimization Options -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---nogcse -\series default - Will not do global subexpression elimination, this option may be used when - the compiler creates undesirably large stack/data spaces to store compiler - temporaries. - A warning message will be generated when this happens and the compiler - will indicate the number of extra bytes it allocated. - It recommended that this option NOT be used, #pragma\SpecialChar ~ -NOGCSE can be used - to turn off global subexpression elimination for a given function only. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---noinvariant -\series default - Will not do loop invariant optimizations, this may be turned off for reasons - explained for the previous option. - For more details of loop optimizations performed see section Loop Invariants.It - recommended that this option NOT be used, #pragma\SpecialChar ~ -NOINVARIANT can be used - to turn off invariant optimizations for a given function only. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---noinduction -\series default - Will not do loop induction optimizations, see section strength reduction - for more details.It is recommended that this option is NOT used, #pragma\SpecialChar ~ -NOINDUCT -ION can be used to turn off induction optimizations for a given function - only. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---nojtbound -\size large -\bar under - -\series default -\size default -\bar default - Will not generate boundary condition check when switch statements are implement -ed using jump-tables. - See section Switch Statements for more details. - It is recommended that this option is NOT used, #pragma\SpecialChar ~ -NOJTBOUND can be - used to turn off boundary checking for jump tables for a given function - only. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---noloopreverse -\series default -\size large - -\size default -Will not do loop reversal optimization. -\layout Subsubsection - -Other Options -\layout List -\labelwidthstring 00.00.0000 - - -\series bold --c\SpecialChar ~ ---compile-only -\series default - will compile and assemble the source, but will not call the linkage editor. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold --E -\series default - Run only the C preprocessor. - Preprocess all the C source files specified and output the results to standard - output. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---stack-auto -\series default -\size large -\emph on - -\size default -\emph default -All functions in the source file will be compiled as -\emph on -reentrant -\emph default -, i.e. - the parameters and local variables will be allocated on the stack. - see section Parameters and Local Variables for more details. - If this option is used all source files in the project should be compiled - with this option. - -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---xstack -\series default - Uses a pseudo stack in the first 256 bytes in the external ram for allocating - variables and passing parameters. - See section on external stack for more details. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---callee-saves function1[,function2][,function3].... - -\series default - The compiler by default uses a caller saves convention for register saving - across function calls, however this can cause unneccessary register pushing - & popping when calling small functions from larger functions. - This option can be used to switch the register saving convention for the - function names specified. - The compiler will not save registers when calling these functions, no extra - code will be generated at the entry & exit for these functions to save - & restore the registers used by these functions, this can SUBSTANTIALLY - reduce code & improve run time performance of the generated code. - In the future the compiler (with interprocedural analysis) will be able - to determine the appropriate scheme to use for each function call. - DO NOT use this option for built-in functions such as _muluint..., if this - option is used for a library function the appropriate library function - needs to be recompiled with the same option. - If the project consists of multiple source files then all the source file - should be compiled with the same --callee-saves option string. - Also see #pragma\SpecialChar ~ -CALLEE-SAVES. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---debug -\bar under - -\series default -\bar default -When this option is used the compiler will generate debug information, that - can be used with the SDCDB. - The debug information is collected in a file with .cdb extension. - For more information see documentation for SDCDB. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold -\emph on ---regextend -\bar under - -\series default -\bar default - This option is obsolete and isn't supported anymore. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold -\emph on ---noregparms -\series default - This option is obsolete and isn't supported anymore. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---peep-file -\series default - This option can be used to use additional rules to be used by - the peep hole optimizer. - See section Peep Hole optimizations for details on how to write these rules. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold --S -\size large -\bar under - -\series default -\size default -\bar default -Stop after the stage of compilation proper; do not assemble. - The output is an assembler code file for the input file specified. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold --Wa_asmOption[,asmOption] -\series default -... - Pass the asmOption to the assembler. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold --Wl_linkOption[,linkOption] -\series default -... - Pass the linkOption to the linker. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---int-long-reent -\series default -\size large - -\size default - Integer (16 bit) and long (32 bit) libraries have been compiled as reentrant. - Note by default these libraries are compiled as non-reentrant. - See section Installation for more details. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---cyclomatic -\bar under - -\series default -\bar default -This option will cause the compiler to generate an information message for - each function in the source file. - The message contains some -\emph on -important -\emph default - information about the function. - The number of edges and nodes the compiler detected in the control flow - graph of the function, and most importantly the -\emph on -cyclomatic complexity -\emph default - see section on Cyclomatic Complexity for more details. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---float-reent -\bar under - -\series default -\bar default - Floating point library is compiled as reentrant.See section Installation - for more details. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---nooverlay -\series default - The compiler will not overlay parameters and local variables of any function, - see section Parameters and local variables for more details. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---main-return -\series default - This option can be used when the code generated is called by a monitor - program. - The compiler will generate a 'ret' upon return from the 'main' function. - The default option is to lock up i.e. - generate a 'ljmp '. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---no-peep -\series default - Disable peep-hole optimization. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---peep-asm -\series default - Pass the inline assembler code through the peep hole optimizer. - This can cause unexpected changes to inline assembler code, please go through - the peephole optimizer rules defined in the source file tree '/peeph.def -' before using this option. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---iram-size -\series default - Causes the linker to check if the interal ram usage is within limits - of the given value. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---nostdincl -\series default - This will prevent the compiler from passing on the default include path - to the preprocessor. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---nostdlib -\series default - This will prevent the compiler from passing on the default library path - to the linker. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---verbose -\series default - Shows the various actions the compiler is performing. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold --V -\series default - Shows the actual commands the compiler is executing. -\layout Subsubsection - -Intermediate Dump Options -\layout Standard - -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. - -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---dumpraw -\series default - This option will cause the compiler to dump the intermediate code into - a file of named -\emph on -.dumpraw -\emph default - just after the intermediate code has been generated for a function, i.e. - before any optimizations are done. - The basic blocks at this stage ordered in the depth first number, so they - may not be in sequence of execution. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---dumpgcse -\series default - Will create a dump of iCode's, after global subexpression elimination, - into a file named -\emph on -.dumpgcse. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---dumpdeadcode -\series default - Will create a dump of iCode's, after deadcode elimination, into a file - named -\emph on -.dumpdeadcode. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---dumploop -\series default -\size large - -\size default -Will create a dump of iCode's, after loop optimizations, into a file named - -\emph on -.dumploop. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---dumprange -\series default -\size large - -\size default -Will create a dump of iCode's, after live range analysis, into a file named - -\emph on -.dumprange. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---dumlrange -\series default - Will dump the life ranges for all symbols. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---dumpregassign -\bar under - -\series default -\bar default -Will create a dump of iCode's, after register assignment, into a file named - -\emph on -.dumprassgn. -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---dumplrange -\series default - Will create a dump of the live ranges of iTemp's -\layout List -\labelwidthstring 00.00.0000 - - -\series bold ---dumpall -\size large -\bar under - -\series default -\size default -\bar default -Will cause all the above mentioned dumps to be created. -\layout Subsection - -MCS51/DS390 Storage Class Language Extensions -\layout Standard - -In addition to the ANSI storage classes SDCC allows the following MCS51 - specific storage classes. -\layout Subsubsection - -xdata -\layout Standard - -Variables declared with this storage class will be placed in the extern - RAM. - This is the -\series bold -default -\series default - storage class for Large Memory model, e.g.: -\newline - -\newline - -\family typewriter -xdata unsigned char xduc; -\layout Subsubsection - -data -\layout Standard - -This is the -\series bold -default -\series default - storage class for Small Memory model. - Variables declared with this storage class will be allocated in the internal - RAM, e.g.: -\newline - -\newline - -\family typewriter -data int iramdata; -\layout Subsubsection - -idata -\layout Standard - -Variables declared with this storage class will be allocated into the indirectly - addressable portion of the internal ram of a 8051, e.g.: -\newline - -\newline - -\family typewriter -idata int idi; -\layout Subsubsection - -bit -\layout Standard - -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, e.g.: -\newline - -\newline - -\family typewriter -bit iFlag; -\layout Subsubsection - -sfr / sbit -\layout Standard - -Like the bit keyword, -\emph on -sfr / sbit -\emph default -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: -\newline - -\newline - -\family typewriter -sfr at 0x80 P0; /* special function register P0 at location 0x80 */ -\newline -sbit at 0xd7 CY; /* CY (Carry Flag) */ -\layout Subsection - -Pointers -\layout Standard - -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 -\emph on -_generic -\emph default - class of pointers which can be used to point to any of the memory spaces. -\newline - -\newline -Pointer declaration examples: -\newline - -\size small - -\newline - -\family typewriter -\size default -/* pointer physically in xternal ram pointing to object in internal ram - */ -\newline -data unsigned char * xdata p; -\newline - -\newline -/* pointer physically in code rom pointing to data in xdata space */ -\newline -xdata unsigned char * code p; -\newline - -\newline -/* pointer physically in code space pointing to data in code space */ -\newline -code unsigned char * code p; -\newline - -\newline -/* the folowing is a generic pointer physically located in xdata space */ -\newline -char * xdata p; -\family default -\size small - -\newline - -\newline - -\size default -Well you get the idea. - -\newline - -\newline - -\emph on -For compatibility with the previous version of the compiler, the following - syntax for pointer declaration is still supported but will disappear int - the near future. - -\newline - -\newline - -\family typewriter -unsigned char _xdata *ucxdp; /* pointer to data in external ram */ -\newline -unsigned char _data \SpecialChar ~ -*ucdp ; /* pointer to data in internal ram */ -\newline -unsigned char _code \SpecialChar ~ -*uccp ; /* pointer to data in R/O code space */ -\newline -unsigned char _idata *uccp; \SpecialChar ~ -/* pointer to upper 128 bytes of ram */ -\family default -\size small -\emph default - -\newline - -\newline - -\size default -All unqualified pointers are treated as 3-byte (4-byte for the ds390) -\emph on -generic -\emph default - pointers. - These type of pointers can also to be explicitly declared. -\newline - -\newline - -\family typewriter -unsigned char _generic *ucgp; -\family default -\size small - -\newline - -\newline - -\size default -The highest order byte of the -\emph on -generic -\emph default - pointers contains the data space information. - Assembler support routines are called whenever data is stored or retrieved - using -\emph on -generic -\emph default - 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 and NEW style could have unpredictable - results. -\layout Subsection - -Parameters & Local Variables -\layout Standard - -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). - This in fact makes them -\emph on -static -\emph default - so by default functions are non-reentrant. -\layout Standard - -They can be placed on the stack either by using the -\emph on - --stack-auto -\emph default - compiler option or by using the -\emph on -reentrant -\emph default - keyword in the function declaration, e.g.: -\newline - -\size small - -\newline - -\family typewriter -\size default -unsigned char foo(char i) reentrant -\newline -{ -\newline -... - -\newline -} -\newline - -\family default - -\newline -Since stack space on 8051 is limited, the -\emph on -reentrant -\emph default -keyword or the -\emph on - --stack-auto -\emph default - option should be used sparingly. - Note that the reentrant keyword just means that the parameters & local - variables will be allocated to the stack, it -\emph on -does not -\emph default - mean that the function is register bank independent. -\newline - -\newline -Local variables can be assigned storage classes and absolute addresses, - e.g.: -\newline - -\newline - -\family typewriter -unsigned char foo() { -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -xdata unsigned char i; -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -bit bvar; -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -data at 0x31 unsiged char j; -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -... - -\newline -} -\newline - -\newline - -\family default -In the above example the variable -\emph on -i -\emph default - will be allocated in the external ram, -\emph on -bvar -\emph default - in bit addressable space and -\emph on - j -\emph default - in internal ram. - When compiled with -\emph on ---stack-auto -\emph default - or when a function is declared as -\emph on -reentrant -\emph default - this can only be done for static variables. -\layout Standard - -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. -\layout Subsection - -Overlaying -\layout Standard - -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 overlayabl -e segment if the function has -\emph on -no other function calls and the function is non-reentrant and the memory - model is small. - -\emph default - If an explicit storage class is specified for a local variable, it will - NOT be overlayed. -\layout Standard - -Note that the compiler (not the linkage editor) makes the decision for overlayin -g the data items. - Functions that are called from an interrupt service routine should be preceded - by a #pragma\SpecialChar ~ -NOOVERLAY if they are not reentrant. -\layout Standard - -Also note that the compiler does not do any processing of inline assembler - code, so the compiler might incorrectly assign local variables and parameters - of a function into the overlay segment if the inline assembler code calls - other c-functions that might use the overlay. - In that case the #pragma\SpecialChar ~ -NOOVERLAY should be used. -\layout Standard - -Parameters and Local variables of functions that contain 16 or 32 bit multiplica -tion or division will NOT be overlayed since these are implemented using - external functions, e.g.: -\newline - -\newline - -\family typewriter -#pragma SAVE -\newline -#pragma NOOVERLAY -\newline -void set_error(unsigned char errcd) -\newline -{ -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -P3 = errcd; -\newline -} -\newline -#pragma RESTORE -\newline - -\newline -void some_isr () interrupt 2 using 1 -\newline -{ -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -... -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -set_error(10); -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -... - -\newline -} -\newline - -\newline - -\family default -In the above example the parameter -\emph on -errcd -\emph default - for the function -\emph on -set_error -\emph default - would be assigned to the overlayable segment if the #pragma\SpecialChar ~ -NOOVERLAY was - not present, this could cause unpredictable runtime behavior when called - from an ISR. - The #pragma\SpecialChar ~ -NOOVERLAY ensures that the parameters and local variables for - the function are NOT overlayed. -\layout Subsection - -Interrupt Service Routines -\layout Standard - -SDCC allows interrupt service routines to be coded in C, with some extended - keywords. -\newline - -\newline - -\family typewriter -void timer_isr (void) interrupt 2 using 1 -\newline -{ -\newline -.. - -\newline -} -\newline - -\newline - -\family default -The number following the -\emph on -interrupt -\emph default - 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 -\emph on -using -\emph default - 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\SpecialChar ~ -NOOVERLAY if it is not reentrant. - A special note here, int (16 bit) and long (32 bit) integer division, multiplic -ation & 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 be recompiled using the -\emph on - --stack-auto -\emph default - option and the source file will need to be compiled using the -\emph on ---int-long-ren -\emph default -t compiler option. -\layout Standard - -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 - or included in the file that contains the function -\emph on -main -\emph default -. -\layout Standard - -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. -\newline - -\layout Standard - - -\begin_inset Tabular - - - - - - - -\begin_inset Text - -\layout Standard - -Interrupt # -\end_inset - - -\begin_inset Text - -\layout Standard - -Description -\end_inset - - -\begin_inset Text - -\layout Standard - -Vector Address -\end_inset - - - - -\begin_inset Text - -\layout Standard - -0 -\end_inset - - -\begin_inset Text - -\layout Standard - -External 0 -\end_inset - - -\begin_inset Text - -\layout Standard - -0x0003 -\end_inset - - - - -\begin_inset Text - -\layout Standard - -1 -\end_inset - - -\begin_inset Text - -\layout Standard - -Timer 0 -\end_inset - - -\begin_inset Text - -\layout Standard - -0x000B -\end_inset - - - - -\begin_inset Text - -\layout Standard - -2 -\end_inset - - -\begin_inset Text - -\layout Standard - -External 1 -\end_inset - - -\begin_inset Text - -\layout Standard - -0x0013 -\end_inset - - - - -\begin_inset Text - -\layout Standard - -3 -\end_inset - - -\begin_inset Text - -\layout Standard - -Timer 1 -\end_inset - - -\begin_inset Text - -\layout Standard - -0x001B -\end_inset - - - - -\begin_inset Text - -\layout Standard - -4 -\end_inset - - -\begin_inset Text - -\layout Standard - -Serial -\end_inset - - -\begin_inset Text - -\layout Standard - -0x0023 -\end_inset - - - - -\end_inset - - -\newline - -\newline -If the interrupt service routine is defined without -\emph on -using -\emph default - 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. -\layout Standard - -If the interrupt service routine is defined to be using a specific register - bank then only -\emph on -a, b & dptr -\emph default - 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. -\layout Standard - -Calling other functions from an interrupt service routine is not recommended, - avoid it if possible. -\newline - -\newline -Also see the _naked modifier. -\layout Subsection - -Critical Functions -\layout Standard - -A special keyword may be associated with a function declaring it as -\emph on -critical -\emph default -. - 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. -\newline - -\size small - -\newline - -\family typewriter -\size default -int foo () critical -\newline -{ -\newline -... - -\newline -... - -\newline -} -\newline - -\family default - -\newline -The critical attribute maybe used with other attributes like -\emph on -reentrant. -\layout Subsection - -Naked Functions -\layout Standard - -A special keyword may be associated with a function declaring it as -\emph on -_naked. - -\emph default -The -\emph on -_naked -\emph default - function modifier attribute prevents the compiler from generating prologue - and epilogue code for that function. - This means that the user is entirely responsible for such things as saving - any registers that may need to be preserved, selecting the proper register - bank, generating the -\emph on -return -\emph default - instruction at the end, etc. - Practically, this means that the contents of the function must be written - in inline assembler. - This is particularly useful for interrupt functions, which can have a large - (and often unnecessary) prologue/epilogue. - For example, compare the code generated by these two functions: -\newline - -\newline - -\family typewriter -data unsigned char counter; -\newline -void simpleInterrupt(void) interrupt 1 -\newline -{ -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -counter++; -\newline -} -\newline - -\newline -void nakedInterrupt(void) interrupt 2 _naked -\newline -{ -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -_asm -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -inc\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -_counter -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -reti\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -; MUST explicitly include ret in _naked function. -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -_endasm; -\newline -} -\family default - -\newline - -\newline -For an 8051 target, the generated simpleInterrupt looks like: -\newline - -\newline - -\family typewriter -_simpleIterrupt: -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -push\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -acc -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -push\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -b -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -push\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -dpl -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -push\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -dph -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -push\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -psw -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -mov\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -psw,#0x00 -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -inc\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -_counter -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -pop\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -psw -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -pop\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -dph -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -pop\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -dpl -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -pop\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -b -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -pop\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -acc -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -reti -\family default - -\newline - -\newline -whereas nakedInterrupt looks like: -\newline - -\newline - -\family typewriter -_nakedInterrupt: -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -inc\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -_counter -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -reti\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -; MUST explicitly include ret(i) in _naked function. -\family default - -\newline - -\newline -While there is nothing preventing you from writing C code inside a _naked - function, there are many ways to shoot yourself in the foot doing this, - and is is recommended that you stick to inline assembler. -\layout Subsection - -Functions using private banks -\layout Standard - -The -\emph on -using -\emph default - attribute (which tells the compiler to use a register bank other than the - default bank zero) should only be applied to -\emph on -interrupt -\emph default - functions (see note 1 below). - This will in most circumstances make the generated ISR code more efficient - since it will not have to save registers on the stack. -\layout Standard - -The -\emph on -using -\emph default - attribute will have no effect on the generated code for a -\emph on -non-interrupt -\emph default - function (but may occasionally be useful anyway -\begin_float footnote -\layout Standard - -possible exception: if a function is called ONLY from 'interrupt' functions - using a particular bank, it can be declared with the same 'using' attribute - as the calling 'interrupt' functions. - For instance, if you have several ISRs using bank one, and all of them - call memcpy(), it might make sense to create a specialized version of memcpy() - 'using 1', since this would prevent the ISR from having to save bank zero - to the stack on entry and switch to bank zero before calling the function -\end_float -). -\newline - -\emph on -(pending: I don't think this has been done yet) -\layout Standard - -An -\emph on -interrupt -\emph default - function using a non-zero bank will assume that it can trash that register - bank, and will not save it. - Since high-priority interrupts can interrupt low-priority ones on the 8051 - and friends, this means that if a high-priority ISR -\emph on -using -\emph default - a particular bank occurs while processing a low-priority ISR -\emph on -using -\emph default - the same bank, terrible and bad things can happen. - To prevent this, no single register bank should be -\emph on -used -\emph default - by both a high priority and a low priority ISR. - This is probably most easily done by having all high priority ISRs use - one bank and all low priority ISRs use another. - If you have an ISR which can change priority at runtime, you're on your - own: I suggest using the default bank zero and taking the small performance - hit. -\layout Standard - -It is most efficient if your ISR calls no other functions. - If your ISR must call other functions, it is most efficient if those functions - use the same bank as the ISR (see note 1 below); the next best is if the - called functions use bank zero. - It is very inefficient to call a function using a different, non-zero bank - from an ISR. - -\layout Subsection - -Absolute Addressing -\layout Standard - -Data items can be assigned an absolute address with the -\emph on -at

-\emph default - keyword, in addition to a storage class, e.g.: -\newline - -\newline - -\family typewriter -xdata at 0x8000 unsigned char PORTA_8255 ; -\newline - -\family default - -\newline -In the above example the PORTA_8255 will be allocated to the location 0x8000 - of the external ram. - Note that this feature is provided to give the programmer access to -\emph on -memory mapped -\emph default - 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 (.rst) and - (.map) are a good places to look for such overlaps. -\newline - -\newline -Absolute address can be specified for variables in all storage classes, - e.g.: -\newline - -\newline - -\family typewriter -bit at 0x02 bvar; -\newline - -\newline - -\family default -The above example will allocate the variable at offset 0x02 in the bit-addressab -le 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. -\layout Subsection - -Startup Code -\layout Standard - -The compiler inserts a call to the C routine -\emph on -_sdcc__external__startup() -\series bold -\emph default - -\series default -at the start of the CODE area. - This routine is in the runtime library. - 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 -\emph on -_sdcc__external__startup() -\emph default - routine to your program to override the default if you need to setup hardware - or perform some other critical operation prior to static & global variable - initialization. -\layout Subsection - -Inline Assembler Code -\layout Standard - -SDCC allows the use of in-line assembler with a few restriction as regards - labels. - All labels defined within inline assembler code -\emph on -has to be -\emph default - of the form -\emph on -nnnnn$ -\emph default - where nnnn is a number less than 100 (which implies a limit of utmost 100 - inline assembler labels -\emph on -per function -\emph default -\noun on -) -\noun default -. - It is strongly recommended that each assembly instruction (including labels) - be placed in a separate line (as the example shows). - When the -\emph on ---peep-asm -\emph default - 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 -\emph on -SDCCpeeph.def -\emph default - carefully before using this option. -\newline - -\newline - -\family typewriter -_asm -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -mov\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -b,#10 -\newline -00001$: -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -djnz\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -b,00001$ -\newline -_endasm ; -\family default -\size small - -\newline - -\newline - -\size default -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 -\family typewriter -_asm ... - _endasm; -\family default - keyword pair. - -\newline - -\newline -Inline assembler code cannot reference any C-Labels, however it can reference - labels defined by the inline assembler, e.g.: -\newline - -\newline - -\family typewriter -foo() { -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -/* some c code */ -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -_asm -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -; some assembler code -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -ljmp $0003 -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -_endasm; -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -/* some more c code */ -\newline -clabel:\SpecialChar ~ -\SpecialChar ~ -/* inline assembler cannot reference this label */ -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -_asm -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -$0003: ;label (can be reference by inline assembler only) -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -_endasm ; -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -/* some more c code */ -\newline -} -\newline - -\newline - -\family default -In other words inline assembly code can access labels defined in inline - assembly within the scope of the funtion. - -\layout Standard - -The same goes the other way, ie. - labels defines in inline assembly CANNOT be accessed by C statements. -\layout Subsection - -int(16 bit) and long (32 bit) Support -\layout Standard - -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, although some model specific assembler optimations are used. - The following files contain the described routine, all of them can be found - in /share/sdcc/lib. -\newline - -\newline - -\emph on - -\emph default - -\newline - -\newline -_mulsint.c - signed 16 bit multiplication (calls _muluint) -\newline -_muluint.c - unsigned 16 bit multiplication -\newline -_divsint.c - signed 16 bit division (calls _divuint) -\newline -_divuint.c - unsigned 16 bit division -\newline -_modsint.c - signed 16 bit modulus (call _moduint) -\newline -_moduint.c - unsigned 16 bit modulus -\newline -_mulslong.c - signed 32 bit multiplication (calls _mululong) -\newline -_mululong.c - unsigned32 bit multiplication -\newline -_divslong.c - signed 32 division (calls _divulong) -\newline -_divulong.c - unsigned 32 division -\newline -_modslong.c - signed 32 bit modulus (calls _modulong) -\newline -_modulong.c - unsigned 32 bit modulus -\size footnotesize - -\newline - -\newline - -\size default -Since they are compiled as -\emph on -non-reentrant -\emph default -, interrupt service routines should not do any of the above operations. - If this is unavoidable then the above routines will need to be compiled - with the -\emph on ---stack-auto -\emph default - option, after which the source program will have to be compiled with -\emph on ---int-long-rent -\emph default - option. -\layout Subsection - -Floating Point Support -\layout Standard - -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: -\newline - -\newline - -\emph on - -\emph default - -\newline - -\newline -_fsadd.c - add floating point numbers -\newline -_fssub.c - subtract floating point numbers -\newline -_fsdiv.c - divide floating point numbers -\newline -_fsmul.c - multiply floating point numbers -\newline -_fs2uchar.c - convert floating point to unsigned char -\newline -_fs2char.c - convert floating point to signed char -\newline -_fs2uint.c - convert floating point to unsigned int -\newline -_fs2int.c - convert floating point to signed int -\newline -_fs2ulong.c - convert floating point to unsigned long -\newline -_fs2long.c - convert floating point to signed long -\newline -_uchar2fs.c - convert unsigned char to floating point -\newline -_char2fs.c - convert char to floating point number -\newline -_uint2fs.c - convert unsigned int to floating point -\newline -_int2fs.c - convert int to floating point numbers -\newline -_ulong2fs.c - convert unsigned long to floating point number -\newline -_long2fs.c - convert long to floating point number -\size footnotesize - -\newline - -\newline - -\size default -Note if all these routines are used simultaneously the data space might - overflow. - For serious floating point usage it is strongly recommended that the large - model be used. -\layout Subsection - -MCS51 Memory Models -\layout Standard - -SDCC allows two memory models for MCS51 code, small and large. - Modules compiled with different memory models should -\emph on -never -\emph default - 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. - -\layout Standard - -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. -\layout Standard - -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. -\layout Subsection - -DS390 Memory Models -\layout Standard - -The only model supported is Flat 24. - This 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. -\newline - -\newline -In older versions of the compiler, this option was used with the MCS51 code - generator ( -\emph on --mmcs51 -\emph default -). - Now, however, the '390 has it's own code generator, selected by the -\emph on --mds390 -\emph default - switch. - -\newline - -\newline -Note that the compiler does not generate any code to place the processor - into 24 bitmode (although -\emph on -tinibios -\emph default - in the ds390 libraries will do that for you). - If you don't use -\emph on -tinibios -\emph default -, the boot loader or similar code must ensure that the processor is in 24 - bit contiguous addressing mode before calling the SDCC startup code. -\newline - -\newline -Like the -\emph on ---model-large -\emph default - option, variables will by default be placed into the XDATA segment. - -\newline - -\newline -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 -\emph on --Wl-r -\emph default - on the sdcc command line. - However, currently the linker can not handle code segments > 64k. -\layout Subsection - -Defines Created by the Compiler -\layout Standard - -The compiler creates the following #defines. -\layout Itemize - -SDCC - this Symbol is always defined. -\layout Itemize - -SDCC_mcs51 or SDCC_ds390 or SDCC_z80, etc - depending on the model used - (e.g.: -mds390) -\layout Itemize - -__mcs51 or __ds390 or __z80, etc - depending on the model used (e.g. - -mz80) -\layout Itemize - -SDCC_STACK_AUTO - this symbol is defined when -\emph on ---stack-auto -\emph default - option is used. -\layout Itemize - -SDCC_MODEL_SMALL - when -\emph on ---model-small -\emph default - is used. -\layout Itemize - -SDCC_MODEL_LARGE - when -\emph on ---model-large -\emph default - is used. -\layout Itemize - -SDCC_USE_XSTACK - when -\emph on ---xstack -\emph default - option is used. -\layout Itemize - -SDCC_STACK_TENBIT - when -\emph on --mds390 -\emph default - is used -\layout Itemize - -SDCC_MODEL_FLAT24 - when -\emph on --mds390 -\emph default - is used -\layout Section - -SDCC Technical Data -\layout Subsection - -Optimizations -\layout Standard - -SDCC performs a host of standard optimizations in addition to some MCU specific - optimizations. - -\layout Subsubsection - -Sub-expression Elimination -\layout Standard - -The compiler does local and global common subexpression elimination, e.g.: - -\newline - -\newline - -\family typewriter -i = x + y + 1; -\newline -j = x + y; -\family default - -\newline - -\newline -will be translated to -\newline - -\newline - -\family typewriter -iTemp = x + y -\newline -i = iTemp + 1 -\newline -j = iTemp -\newline - -\family default - -\newline -Some subexpressions are not as obvious as the above example, e.g.: -\newline - -\newline - -\family typewriter -a->b[i].c = 10; -\newline -a->b[i].d = 11; -\family default - -\newline - -\newline -In this case the address arithmetic a->b[i] will be computed only once; - the equivalent code in C would be. -\newline - -\newline - -\family typewriter -iTemp = a->b[i]; -\newline -iTemp.c = 10; -\newline -iTemp.d = 11; -\family default - -\newline - -\newline -The compiler will try to keep these temporary variables in registers. -\layout Subsubsection - -Dead-Code Elimination -\layout Standard - - -\family typewriter -int global; -\newline -void f () { -\newline -\SpecialChar ~ -\SpecialChar ~ -int i; -\newline -\SpecialChar ~ -\SpecialChar ~ -i = 1; \SpecialChar ~ -/* dead store */ -\newline -\SpecialChar ~ -\SpecialChar ~ -global = 1;\SpecialChar ~ -/* dead store */ -\newline -\SpecialChar ~ -\SpecialChar ~ -global = 2; -\newline -\SpecialChar ~ -\SpecialChar ~ -return; -\newline -\SpecialChar ~ -\SpecialChar ~ -global = 3;\SpecialChar ~ -/* unreachable */ -\newline -} -\family default - -\newline - -\newline -will be changed to -\newline - -\newline - -\family typewriter -int global; void f () -\newline -{ -\newline -\SpecialChar ~ -\SpecialChar ~ -global = 2; -\newline -\SpecialChar ~ -\SpecialChar ~ -return; -\newline -} -\layout Subsubsection - -Copy-Propagation -\layout Standard - - -\family typewriter -int f() { -\newline -\SpecialChar ~ -\SpecialChar ~ -int i, j; -\newline -\SpecialChar ~ -\SpecialChar ~ -i = 10; -\newline -\SpecialChar ~ -\SpecialChar ~ -j = i; -\newline -\SpecialChar ~ -\SpecialChar ~ -return j; -\newline -} -\family default - -\newline - -\newline -will be changed to -\newline - -\newline - -\family typewriter -int f() { -\newline -\SpecialChar ~ - \SpecialChar ~ - int i,j; -\newline -\SpecialChar ~ - \SpecialChar ~ - i = 10; -\newline -\SpecialChar ~ - \SpecialChar ~ - j = 10; -\newline -\SpecialChar ~ - \SpecialChar ~ - return 10; -\newline -} -\newline - -\newline - -\family default -Note: the dead stores created by this copy propagation will be eliminated - by dead-code elimination. -\layout Subsubsection - -Loop Optimizations -\layout Standard - -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 optimizati -on 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 using #pragma\SpecialChar ~ -NOINDUCTION. -\newline - -\newline -Loop Invariant: -\newline - -\newline - -\family typewriter -for (i = 0 ; i < 100 ; i ++) -\newline - \SpecialChar ~ - \SpecialChar ~ -f += k + l; -\family default - -\newline - -\newline -changed to -\newline - -\newline - -\family typewriter -itemp = k + l; -\newline -for (i = 0; i < 100; i++) -\newline -\SpecialChar ~ -\SpecialChar ~ -f += itemp; -\family default - -\newline - -\newline -As mentioned previously some loop invariants are not as apparent, all static - address computations are also moved out of the loop. -\newline - -\newline -Strength Reduction, this optimization substitutes an expression by a cheaper - expression: -\newline - -\newline - -\family typewriter -for (i=0;i < 100; i++) -\newline -\SpecialChar ~ -\SpecialChar ~ -ar[i*5] = i*3; -\family default - -\newline - -\newline -changed to -\newline - -\newline - -\family typewriter -itemp1 = 0; -\newline -itemp2 = 0; -\newline -for (i=0;i< 100;i++) { -\newline - \SpecialChar ~ - \SpecialChar ~ -ar[itemp1] = itemp2; -\newline - \SpecialChar ~ - \SpecialChar ~ -itemp1 += 5; -\newline - \SpecialChar ~ - \SpecialChar ~ -itemp2 += 3; -\newline -} -\family default - -\newline - -\newline -The more expensive multiplication is changed to a less expensive addition. -\layout Subsubsection - -Loop Reversing -\layout Standard - -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 -\begin_inset Quotes eld -\end_inset - -decrement and jump if not zero -\begin_inset Quotes erd -\end_inset - - instruction. - SDCC checks for the following criterion to determine if a loop is reversible - (note: more sophisticated compilers use data-dependency analysis to make - this determination, SDCC uses a more simple minded analysis). -\layout Itemize - -The 'for' loop is of the form -\newline - -\newline - -\family typewriter -for ( = ; [< | <=] ; [++ | - += 1]) -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - -\layout Itemize - -The does not contain -\begin_inset Quotes eld -\end_inset - -continue -\begin_inset Quotes erd -\end_inset - - or 'break -\begin_inset Quotes erd -\end_inset - -. -\layout Itemize - -All goto's are contained within the loop. -\layout Itemize - -No function calls within the loop. -\layout Itemize - -The loop control variable is not assigned any value within the loop -\layout Itemize - -The loop control variable does NOT participate in any arithmetic operation - within the loop. -\layout Itemize - -There are NO switch statements in the loop. -\layout Standard - -Note djnz instruction can be used for 8-bit values -\emph on -only -\emph default -, therefore it is advantageous to declare loop control symbols as -\emph on -char -\emph default -. - Ofcourse this may not be possible on all situations. -\layout Subsubsection - -Algebraic Simplifications -\layout Standard - -SDCC does numerous algebraic simplifications, the following is a small sub-set - of these optimizations. -\newline - -\newline - -\family typewriter -i = j + 0 ; /* changed to */ i = j; -\newline -i /= 2; /* changed to */ i >>= 1; -\newline -i = j - j ; /* changed to */ i = 0; -\newline -i = j / 1 ; /* changed to */ i = j; -\family default - -\newline - -\newline -Note the subexpressions given above are generally introduced by macro expansions - or as a result of copy/constant propagation. -\layout Subsubsection - -'switch' Statements -\layout Standard - -SDCC changes switch statements to jump tables when the following conditions - are true. - -\layout Itemize - -The case labels are in numerical sequence, the labels need not be in order, - and the starting number need not be one or zero. -\newline - -\newline - -\family typewriter -switch(i) {\SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ -switch (i) { -\newline -case 4:... - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ -case 1: ... - -\newline -case 5:... - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ -case 2: ... - -\newline -case 3:... - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ -case 3: ... - -\newline -case 6:... - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ -case 4: ... - -\newline -}\SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ -} -\newline - -\newline - -\family default -Both the above switch statements will be implemented using a jump-table. -\layout Itemize - -The number of case labels is at least three, since it takes two conditional - statements to handle the boundary conditions. -\layout Itemize - -The number of case labels is less than 84, since each label takes 3 bytes - and a jump-table can be utmost 256 bytes long. - -\layout Standard - -Switch statements which have gaps in the numeric sequence or those that - have more that 84 case labels can be split into more than one switch statement - for efficient code generation, e.g.: -\newline - -\newline - -\family typewriter -switch (i) { -\newline -case 1: ... - -\newline -case 2: ... - -\newline -case 3: ... - -\newline -case 4: ... - -\newline -case 9: ... - -\newline -case 10: ... - -\newline -case 11: ... - -\newline -case 12: ... - -\newline -} -\family default - -\newline - -\newline -If the above switch statement is broken down into two switch statements -\newline - -\newline - -\family typewriter -switch (i) { -\newline -case 1: ... - -\newline -case 2: ... - -\newline -case 3: ... - -\newline -case 4: ... - -\newline -} -\newline - -\newline - -\family default -and -\family typewriter - -\newline - -\newline -switch (i) { -\newline -case 9: \SpecialChar ~ -... - -\newline -case 10: ... - -\newline -case 11: ... - -\newline -case 12:\SpecialChar ~ -... - -\newline -} -\newline - -\newline - -\family default -then both the switch statements will be implemented using jump-tables whereas - the unmodified switch statement will not be. -\layout Subsubsection - -Bit-shifting Operations. -\layout Standard - -Bit shifting is one of the most frequently used operation in embedded programmin -g. - SDCC tries to implement bit-shift operations in the most efficient way - possible, e.g.: -\newline - -\family typewriter - -\newline -unsigned char i; -\newline -... - -\newline -i>>= 4; -\newline -... -\newline - -\family default - -\newline -generates the following code: -\newline - -\family typewriter - -\newline -mov a,_i -\newline -swap a -\newline -anl a,#0x0f -\newline -mov _i,a -\family default - -\newline - -\newline -In general SDCC will never setup a loop if the shift count is known. - Another example: -\newline - -\newline - -\family typewriter -unsigned int i; -\newline -... - -\newline -i >>= 9; -\newline -... -\family default - -\newline - -\newline -will generate: -\newline - -\newline - -\family typewriter -mov a,(_i + 1) -\newline -mov (_i + 1),#0x00 -\newline -clr c -\newline -rrc a -\newline -mov _i,a -\family default - -\newline - -\newline -Note that SDCC stores numbers in little-endian format (i.e. - lowest order first). -\layout Subsubsection - -Bit-rotation -\layout Standard - -A special case of the bit-shift operation is bit rotation, SDCC recognizes - the following expression to be a left bit-rotation: -\newline - -\newline - -\family typewriter -unsigned char i; -\newline -... - -\newline -i = ((i << 1) | (i >> 7)); -\family default - -\newline -... -\newline - -\newline -will generate the following code: -\newline - -\newline - -\family typewriter -mov a,_i -\newline -rl a -\newline -mov _i,a -\family default - -\newline - -\newline -SDCC uses pattern matching on the parse tree to determine this operation.Variatio -ns of this case will also be recognized as bit-rotation, i.e.: -\newline - -\newline - -\family typewriter -i = ((i >> 7) | (i << 1)); /* left-bit rotation */ -\layout Subsubsection - -Highest Order Bit -\layout Standard - -It is frequently required to obtain the highest order bit of an integral - type (long, int, short or char types). - SDCC recognizes the following expression to yield the highest order bit - and generates optimized code for it, e.g.: -\newline - -\newline - -\family typewriter -unsigned int gint; -\newline - -\newline -foo () { -\newline -unsigned char hob; -\newline -\SpecialChar ~ -\SpecialChar ~ -... - -\newline -\SpecialChar ~ -\SpecialChar ~ -hob = (gint >> 15) & 1; -\newline -\SpecialChar ~ -\SpecialChar ~ -.. - -\newline -} -\family default - -\newline - -\newline -will generate the following code: -\newline - -\family typewriter - -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - 61 ;\SpecialChar ~ - hob.c 7 -\newline -\SpecialChar ~ -\SpecialChar ~ - 000A E5*01\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - 62\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - mov\SpecialChar ~ - a,(_gint + 1) -\newline -\SpecialChar ~ -\SpecialChar ~ - 000C 33\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - 63\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - rlc\SpecialChar ~ - a -\newline -\SpecialChar ~ -\SpecialChar ~ - 000D E4\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - 64\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - clr\SpecialChar ~ - a -\newline -\SpecialChar ~ -\SpecialChar ~ - 000E 13\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - 65\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - rrc\SpecialChar ~ - a -\newline -\SpecialChar ~ -\SpecialChar ~ - 000F F5*02\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - 66\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - mov\SpecialChar ~ - _foo_hob_1_1,a -\newline - -\newline - -\family default -Variations of this case however will -\emph on -not -\emph default - 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, - e.g.: -\newline - -\newline - -\family typewriter -xyz = gint + ((gint >> 15) & 1); -\family default - -\newline - -\newline -will still be recognized. -\layout Subsubsection - -Peep-hole Optimizer -\layout Standard - -The compiler uses a rule based, pattern matching and re-writing mechanism - for peep-hole optimization. - It is inspired by -\emph on -copt -\emph default - 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 -\emph on ---peep-file -\emph default - option. - The rule language is best illustrated with examples. -\newline - -\newline - -\family typewriter -replace { -\newline -\SpecialChar ~ -\SpecialChar ~ -mov %1,a -\newline -\SpecialChar ~ -\SpecialChar ~ -mov a,%1 -\newline -} by { -\newline -\SpecialChar ~ -\SpecialChar ~ -mov %1,a -\newline -} -\family default - -\newline - -\newline -The above rule will change the following assembly sequence: -\newline - -\newline - -\family typewriter -\SpecialChar ~ -\SpecialChar ~ -mov r1,a -\newline -\SpecialChar ~ -\SpecialChar ~ -mov a,r1 -\family default - -\newline - -\newline -to -\newline - -\newline - -\family typewriter -mov r1,a -\family default - -\newline - -\newline -Note: All occurrences of a -\emph on -%n -\emph default - (pattern variable) must denote the same string. - With the above rule, the assembly sequence: -\newline - -\newline - -\family typewriter -\SpecialChar ~ -\SpecialChar ~ -mov r1,a -\newline -\SpecialChar ~ -\SpecialChar ~ -mov a,r2 -\family default - -\newline - -\newline -will remain unmodified. -\newline - -\newline -Other special case optimizations may be added by the user (via -\emph on ---peep-file option -\emph default -). - E.g. - some variants of the 8051 MCU allow only -\family typewriter -ajmp -\family default - and -\family typewriter -acall -\family default -. - The following two rules will change all -\family typewriter -ljmp -\family default - and -\family typewriter -lcall -\family default - to -\family typewriter -ajmp -\family default - and -\family typewriter -acall -\family default - -\newline - -\newline - -\family typewriter -replace { lcall %1 } by { acall %1 } -\newline -replace { ljmp %1 } by { ajmp %1 } -\family default - -\newline - -\newline -The -\emph on -inline-assembler code -\emph default - 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-structur -e is MCU independent. - Peephole optimization rules for other MCU can be easily programmed using - the rule language. -\newline - -\newline -The syntax for a rule is as follows: -\newline - -\newline - -\family typewriter -rule := replace [ restart ] '{' ' -\backslash -n' -\newline -\SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - '}' by '{' ' -\backslash -n' -\newline -\SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - ' -\backslash -n' -\newline -\SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ - '}' [if ] ' -\backslash -n' -\newline - -\family default - -\newline - := assembly instruction (each instruction including - labels must be on a separate line). -\newline - -\newline -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: -\newline - -\newline - -\family typewriter -replace restart { -\newline -\SpecialChar ~ -\SpecialChar ~ -pop %1 -\newline -\SpecialChar ~ -\SpecialChar ~ -push %1 } by { -\newline -\SpecialChar ~ -\SpecialChar ~ -; nop -\newline -} -\family default - -\newline - -\newline -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.: -\newline - -\newline - -\family typewriter -\SpecialChar ~ -\SpecialChar ~ -pop ar1 -\newline -\SpecialChar ~ -\SpecialChar ~ -pop ar2 -\newline -\SpecialChar ~ -\SpecialChar ~ -push ar2 -\newline -\SpecialChar ~ -\SpecialChar ~ -push ar1 -\family default - -\newline - -\newline -would result in: -\newline - -\newline - -\family typewriter -\SpecialChar ~ -\SpecialChar ~ -pop ar1 -\newline -\SpecialChar ~ -\SpecialChar ~ -; nop -\newline -\SpecialChar ~ -\SpecialChar ~ -push ar1 -\family default - -\newline - -\newline - -\emph on -with -\emph default - the restart option the rule will be applied again to the resulting code - and then all the pop-push pairs will be eliminated to yield: -\newline - -\newline - -\family typewriter -\SpecialChar ~ -\SpecialChar ~ -; nop -\newline -\SpecialChar ~ -\SpecialChar ~ -; nop -\family default - -\newline - -\newline -A conditional function can be attached to a rule. - Attaching rules are somewhat more involved, let me illustrate this with - an example. -\newline - -\newline - -\family typewriter -replace { -\newline -\SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ -ljmp %5 -\newline -%2: -\newline -} by { -\newline -\SpecialChar ~ - \SpecialChar ~ - \SpecialChar ~ -sjmp %5 -\newline -%2: -\newline -} if labelInRange -\family default - -\newline - -\newline -The optimizer does a look-up of a function name table defined in function - -\emph on -callFuncByName -\emph default - in the source file SDCCpeeph.c, with the name -\emph on -labelInRange -\emph default -. - 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 -\emph on -%5 -\emph default - is crucial, since the function -\emph on -labelInRange -\emph default - expects to find the label in that particular variable (the hash table containin -g 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, but maybe 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 add your own rules in the default - set there if you get tired of specifying the --peep-file option. -\layout Subsection - -Pragmas -\layout Standard - -SDCC supports the following #pragma directives. - This directives are applicable only at a function level. -\layout Itemize - -SAVE - this will save all the current options. -\layout Itemize - -RESTORE - will restore the saved options from the last save. - Note that SAVES & RESTOREs cannot be nested. - SDCC uses the same buffer to save the options each time a SAVE is called. -\layout Itemize - -NOGCSE - will stop global subexpression elimination. -\layout Itemize - -NOINDUCTION - will stop loop induction optimizations. -\layout Itemize - -NOJTBOUND - will not generate code for boundary value checking, when switch - statements are turned into jump-tables. -\layout Itemize - -NOOVERLAY - the compiler will not overlay the parameters and local variables - of a function. -\layout Itemize - -NOLOOPREVERSE - Will not do loop reversal optimization -\layout Itemize - -EXCLUDE NONE | {acc[,b[,dpl[,dph]]] - The exclude pragma disables generation - of pair of push/pop instruction in ISR function (using interrupt keyword). - The directive should be placed immediately before the ISR function definition - and it affects ALL ISR functions following it. - To enable the normal register saving for ISR functions use #pragma\SpecialChar ~ -EXCLUDE\SpecialChar ~ -none. -\layout Itemize - -CALLEE-SAVES function1[,function2[,function3...]] - The compiler by default - uses a caller saves convention for register saving across function calls, - however this can cause unneccessary register pushing & popping when calling - small functions from larger functions. - This option can be used to switch the register saving convention for the - function names specified. - The compiler will not save registers when calling these functions, extra - code will be generated at the entry & exit for these functions to save - & restore the registers used by these functions, this can SUBSTANTIALLY - reduce code & improve run time performance of the generated code. - In future the compiler (with interprocedural analysis) will be able to - determine the appropriate scheme to use for each function call. - If --callee-saves command line option is used, the function names specified - in #pragma\SpecialChar ~ -CALLEE-SAVES is appended to the list of functions specified inthe - command line. -\layout Standard - -The pragma's are intended to be used to turn-off certain optimizations which - might cause the compiler to generate extra stack / data space to store - compiler generated temporary variables. - This usually happens in large functions. - Pragma directives should be used as shown in the following example, they - are used to control options & optimizations for a given function; pragmas - should be placed before and/or after a function, placing pragma's inside - a function body could have unpredictable results. -\newline - -\newline - -\family typewriter -#pragma SAVE /* save the current settings */ -\newline -#pragma NOGCSE /* turnoff global subexpression elimination */ -\newline -#pragma NOINDUCTION /* turn off induction optimizations */ -\newline -int foo () -\newline -{ -\newline -\SpecialChar ~ - \SpecialChar ~ - ... - -\newline -\SpecialChar ~ - \SpecialChar ~ - /* large code */ -\newline -\SpecialChar ~ - \SpecialChar ~ - ... - -\newline -} -\newline -#pragma RESTORE /* turn the optimizations back on */ -\family default - -\newline - -\newline -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. -\layout Subsection - - -\emph on - -\emph default - Library Routines -\layout Standard - -The following library routines are provided for your convenience. -\layout Standard - -stdio.h - Contains the following functions printf & sprintf these routines - are developed by Martijn van Balen . - -\layout Standard - -%[flags][width][b|B|l|L]type -\layout Standard - -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - flags: -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - left justify output in specified field width -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - +\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - prefix output with +/- sign if output is signed type -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - space\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - prefix output with a blank if it's a signed positive value -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - width:\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - specifies minimum number of characters outputted for numbers -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - or strings. - -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - - For numbers, spaces are added on the left when needed. - -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - If width starts with a zero character, zeroes and used -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - instead of spaces. - -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - - For strings, spaces are are added on the left or right (when -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - flag '-' is used) when needed. - -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - b/B:\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - byte argument (used by d, u, o, x, X) -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - l/L:\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - long argument (used by d, u, o, x, X) -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - type:\SpecialChar ~ - d\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - decimal number -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - u\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - unsigned decimal number -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - o\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - unsigned octal number -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - x\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - unsigned hexadecimal number (0-9, a-f) -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - X\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - unsigned hexadecimal number (0-9, A-F) -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - c\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - character -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - s\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - string (generic pointer) -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - p\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - generic pointer (I:data/idata, C:code, X:xdata, P:paged) -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - f\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - float (still to be implemented) -\layout Standard - -Also contains a very simple version of printf (printf_small). - This simplified version of printf supports only the following formats. -\layout Standard - -format\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -output\SpecialChar ~ -type\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -argument-type -\newline -%d \SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -decimal \SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - short/int -\newline -%ld\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -decimal\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -long -\newline -%hd\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -decimal\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -char -\newline -%x\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -hexadecimal\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -short/int -\newline -%lx\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -hexadecimal\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -long -\newline -%hx\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -hexadecimal\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -char -\newline -%o\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -octal\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -short/int -\newline -%lo\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -octal\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -long -\newline -%ho\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -octal\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -char -\newline -%c\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -character\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -char -\newline -%s\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -character\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -_generic pointer -\layout Standard - -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. -\layout Standard - -printf_small( -\begin_inset Quotes eld -\end_inset - -my str %s, my int %d -\backslash -n -\begin_inset Quotes erd -\end_inset - -,(char _generic *)mystr,myint); -\layout Itemize - -stdarg.h - contains definition for the following macros to be used for variable - parameter list, note that a function can have a variable parameter list - if and only if it is 'reentrant' -\begin_deeper -\layout Standard - -va_list, va_start, va_arg, va_end. -\end_deeper -\layout Itemize - -setjmp.h - contains defintion for ANSI setjmp & longjmp routines. - Note in this case setjmp & longjmp can be used between functions executing - within the same register bank, if long jmp is executed from a function - that is using a different register bank from the function issuing the setjmp - function, the results may be unpredictable. - The jump buffer requires 3 bytes of data (the stack pointer & a 16 byte - return address), and can be placed in any address space. -\layout Itemize - -stdlib.h - contains the following functions. -\begin_deeper -\layout Standard - -atoi, atol. -\end_deeper -\layout Itemize - -string.h - contains the following functions. -\begin_deeper -\layout Standard - -strcpy, strncpy, strcat, strncat, strcmp, strncmp, strchr, strrchr, strspn, - strcspn, strpbrk, strstr, strlen, strtok, memcpy, memcmp, memset. -\end_deeper -\layout Itemize - -ctype.h - contains the following routines. -\begin_deeper -\layout Standard - -iscntrl, isdigit, isgraph, islower, isupper, isprint, ispunct, isspace, - isxdigit, isalnum, isalpha. -\end_deeper -\layout Itemize - -malloc.h - The malloc routines are developed by Dmitry S. - Obukhov (dso@usa.net). - These routines will allocate memory from the external ram. - Here is a description on how to use them (as described by the author). -\begin_deeper -\layout Standard - -//Example: -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - //\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - #define DYNAMIC_MEMORY_SIZE 0x2000 -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - //\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - ..... - -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - //\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - unsigned char xdata dynamic_memory_pool[DYNAMIC_MEMORY_SIZE]; -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - //\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - unsigned char xdata * current_buffer; -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - //\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - ..... - -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - //\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - void main(void) -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - //\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - { -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - //\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - ... - -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -//\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - init_dynamic_memory(dynamic_memory_pool,DYNAMIC_MEMORY_SIZE); -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - //\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - //Now it's possible to use malloc. - -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - //\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - ... - -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - //\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - current_buffer = malloc(0x100); -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - // -\end_deeper -\layout Itemize - -serial.h - Serial IO routines are also developed by Dmitry S. - Obukhov (dso@usa.net). - These routines are interrupt driven with a 256 byte circular buffer, they - also expect external ram to be present. - Please see documentation in file SDCCDIR/sdcc51lib/serial.c. - Note the header file -\begin_inset Quotes eld -\end_inset - -serial.h -\begin_inset Quotes erd -\end_inset - - MUST be included in the file containing the 'main' function. -\layout Itemize - -ser.h - Alternate serial routine provided by Wolfgang Esslinger these routines are more compact and faster. - Please see documentation in file SDCCDIR/sdcc51lib/ser.c -\layout Itemize - -ser_ir.h - Another alternate set of serial routines provided by Josef Wolf - , these routines do not use the external ram. -\layout Itemize - -reg51.h - contains register definitions for a standard 8051 -\layout Itemize - -float.h - contains min, max and other floating point related stuff. -\layout Standard - -All library routines are compiled as --model-small, they are all non-reentrant, - if you plan to use the large model or want to make these routines reentrant, - then they will have to be recompiled with the appropriate compiler option. -\layout Standard - -Have not had time to do the more involved routines like printf, will get - to them shortly. -\layout Subsection - -Interfacing with Assembly Routines -\layout Subsubsection - -Global Registers used for Parameter Passing -\layout Standard - -The compiler always uses the global registers -\emph on -DPL,DPH,B -\emph default -and -\emph on - ACC -\emph default - to pass the first parameter to a routine. - The second parameter onwards is either allocated on the stack (for reentrant - routines or if --stack-auto is used) or in the internal / external ram - (depending on the memory model). - -\layout Subsubsection - -Assembler Routine(non-reentrant) -\layout Standard - -In the following example the function cfunc calls an assembler routine asm_func, - which takes two parameters. -\newline - -\newline - -\family typewriter -extern int asm_func(unsigned char, unsigned char); -\newline - -\newline -int c_func (unsigned char i, unsigned char j) -\newline -{ -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -return asm_func(i,j); -\newline -} -\newline - -\newline -int main() -\newline -{ -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -return c_func(10,9); -\newline -} -\newline - -\newline - -\family default -The corresponding assembler function is: -\newline - -\newline - -\family typewriter -.globl _asm_func_PARM_2 -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -.globl _asm_func -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -.area OSEG -\newline -_asm_func_PARM_2: -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -.ds 1 -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -.area CSEG -\newline -_asm_func: -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -mov a,dpl -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -add a,_asm_func_PARM_2 -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -mov dpl,a -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -mov dpl,#0x00 -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -ret -\newline - -\newline - -\family default -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. -\layout Standard - -The parameter naming convention is __PARM_, where n is - the parameter number starting from 1, and counting from the left. - The first parameter is passed in -\begin_inset Quotes eld -\end_inset - -dpl -\begin_inset Quotes erd -\end_inset - - for One bye parameter, -\begin_inset Quotes eld -\end_inset - -dptr -\begin_inset Quotes erd -\end_inset - - if two bytes, -\begin_inset Quotes eld -\end_inset - -b,dptr -\begin_inset Quotes erd -\end_inset - - for three bytes and -\begin_inset Quotes eld -\end_inset - -acc,b,dptr -\begin_inset Quotes erd -\end_inset - - for four bytes, the varible name for the second parameter will be __PARM_2. -\newline - -\newline -Assemble the assembler routine with the following command: -\newline - -\newline - -\family sans -\series bold -asx8051 -losg asmfunc.asm -\newline - -\newline - -\family default -\series default -Then compile and link the assembler routine to the C source file with the - following command: -\newline - -\newline - -\family sans -\series bold -sdcc cfunc.c asmfunc.rel -\layout Subsubsection - -Assembler Routine(reentrant) -\layout Standard - -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: -\newline - -\newline - -\family typewriter -extern int asm_func(unsigned char, unsigned char); -\newline - -\newline -int c_func (unsigned char i, unsigned char j) reentrant -\newline -{ -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -return asm_func(i,j); -\newline -} -\newline - -\newline -int main() -\newline -{ -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -return c_func(10,9); -\newline -} -\newline - -\family default - -\newline -The corresponding assembler routine is: -\newline - -\newline - -\family typewriter -.globl _asm_func -\newline -_asm_func: -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -push _bp -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -mov _bp,sp -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -mov r2,dpl -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -mov a,_bp -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -clr c -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -add a,#0xfd -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -mov r0,a -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -add a,#0xfc -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -mov r1,a -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -mov a,@r0 -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -add a,r2 -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -mov dpl,a -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -mov dph,#0x00 -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -mov sp,_bp -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -pop _bp -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -ret -\newline - -\newline - -\family default -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. -\layout Subsection - -External Stack -\layout Standard - -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). -\layout Standard - -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. -\layout Subsection - -ANSI-Compliance -\layout Standard - -Deviations from the compliancy. -\layout Itemize - -functions are not always reentrant. -\layout Itemize - -structures cannot be assigned values directly, cannot be passed as function - parameters or assigned to each other and cannot be a return value from - a function, e.g.: -\family typewriter - -\newline - -\newline -struct s { ... - }; -\newline -struct s s1, s2; -\newline -foo() -\newline -{ -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -... - -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -s1 = s2 ; /* is invalid in SDCC although allowed in ANSI */ -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -... - -\newline -} -\newline -struct s foo1 (struct s parms) /* is invalid in SDCC although allowed in - ANSI */ -\newline -{ -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -struct s rets; -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -... - -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -return rets;/* is invalid in SDCC although allowed in ANSI */ -\newline -} -\layout Itemize - -'long long' (64 bit integers) not supported. -\layout Itemize - -'double' precision floating point not supported. -\layout Itemize - -No support for setjmp and longjmp (for now). -\layout Itemize - -Old K&R style function declarations are NOT allowed. -\newline - -\family typewriter - -\newline -foo(i,j) /* this old style of function declarations */ -\newline -int i,j; /* are valid in ANSI but not valid in SDCC */ -\newline -{ -\newline -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -... - -\newline -} -\layout Itemize - -functions declared as pointers must be dereferenced during the call. -\newline - -\family typewriter - -\newline -int (*foo)(); -\newline -... - -\newline -/* has to be called like this */ -\newline -(*foo)(); /* ansi standard allows calls to be made like 'foo()' */ -\layout Subsection - -Cyclomatic Complexity -\layout Standard - -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. - -\newline - -\newline -SDCC uses the following formula to compute the complexity: -\newline - -\layout Standard - -complexity = (number of edges in control flow graph) - (number of nodes - in control flow graph) + 2; -\newline - -\newline -Having said that the industry standard is 10, you should be aware that in - some cases it be 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. -\layout Section - -TIPS -\layout Standard - -Here are a few guidelines that will help the compiler generate more efficient - code, some of the tips are specific to this compiler others are generally - good programming practice. -\layout Itemize - -Use the smallest data type to represent your data-value. - If it is known in advance that the value is going to be less than 256 then - use a 'char' instead of a 'short' or 'int'. -\layout Itemize - -Use unsigned when it is known in advance that the value is not going to - be negative. - This helps especially if you are doing division or multiplication. -\layout Itemize - -NEVER jump into a LOOP. -\layout Itemize - -Declare the variables to be local whenever possible, especially loop control - variables (induction). -\layout Itemize - -Since the compiler does not do implicit integral promotion, the programmer - should do an explicit cast when integral promotion is required. -\layout Itemize - -Reducing the size of division, multiplication & modulus operations can reduce - code size substantially. - Take the following code for example. -\family typewriter - -\newline - -\newline -foobar(unsigned int p1, unsigned char ch) -\newline -{ -\newline - unsigned char ch1 = p1 % ch ; -\newline - .... - -\newline -} -\newline - -\family default - -\newline -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 support routine _muduint()), and the result will be casted to an - int. - If the code is changed to -\newline - -\family typewriter - -\newline -foobar(unsigned int p1, unsigned char ch) -\newline -{ -\newline - unsigned char ch1 = (unsigned char)p1 % ch ; -\newline - .... - -\newline -} -\newline - -\family default - -\newline -It would substantially reduce the code generated (future versions of the - compiler will be smart enough to detect such optimization oppurtunities). -\layout Subsection - -Notes on MCS51 memory layout -\layout Standard - -The 8051 family of micro controller have a minimum of 128 bytes of internal - memory which is structured as follows -\newline - -\newline -- Bytes 00-1F - 32 bytes to hold up to 4 banks of the registers R7 to R7 - -\newline -- Bytes 20-2F - 16 bytes to hold 128 bit variables and -\newline -- Bytes 30-7F - 60 bytes for general purpose use. -\newline - -\newline -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. -\layout Standard - -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. - -\layout Standard - -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. -\layout Standard - -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) and the number of nested subroutin -es. -\layout Standard - -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 code which will be slower to execute. - -\layout Standard - ---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. -\layout Standard - ---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. -\layout Standard - ---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. -\newline - -\newline -Conclusion. -\newline - -\newline -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 bit variables, --data-loc 16, - and use the --stack-after-data option. -\layout Standard - -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. -\layout Section - -Retargetting for other MCUs. -\layout Standard - -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. -\layout Itemize - -Parsing the source and building the annotated parse tree. - This phase is largely MCU independent (except for the language extensions). - Syntax & semantic checks are also done in this phase, along with some initial - optimizations like back patching labels and the pattern matching optimizations - like bit-rotation etc. -\layout Itemize - -The second phase involves generating an intermediate code which can be easy - manipulated during the later phases. - This phase is entirely MCU independent. - The intermediate code generation assumes the target machine has unlimited - number of registers, and designates them with the name iTemp. - The compiler can be made to dump a human readable form of the code generated - by using the --dumpraw option. -\layout Itemize - -This phase does the bulk of the standard optimizations and is also MCU independe -nt. - This phase can be broken down into several sub-phases: -\newline - -\newline -Break down intermediate code (iCode) into basic blocks. -\newline -Do control flow & data flow analysis on the basic blocks. -\newline -Do local common subexpression elimination, then global subexpression elimination -\newline -Dead code elimination -\newline -Loop optimizations -\newline -If loop optimizations caused any changes then do 'global subexpression eliminati -on' and 'dead code elimination' again. -\layout Itemize - -This phase determines the live-ranges; by live range I mean those iTemp - variables defined by the compiler that still survive after all the optimization -s. - Live range analysis is essential for register allocation, since these computati -on determines which of these iTemps will be assigned to registers, and for - how long. -\layout Itemize - -Phase five is register allocation. - There are two parts to this process. -\newline - -\newline -The first part I call 'register packing' (for lack of a better term). - In this case several MCU specific expression folding is done to reduce - register pressure. -\newline - -\newline -The second part is more MCU independent and deals with allocating registers - to the remaining live ranges. - A lot of MCU specific code does creep into this phase because of the limited - number of index registers available in the 8051. -\layout Itemize - -The Code generation phase is (unhappily), entirely MCU dependent and very - little (if any at all) of this code can be reused for other MCU. - However the scheme for allocating a homogenized assembler operand for each - iCode operand may be reused. -\layout Itemize - -As mentioned in the optimization section the peep-hole optimizer is rule - based system, which can reprogrammed for other MCUs. -\layout Section - -SDCDB - Source Level Debugger -\layout Standard - -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 installati -on, 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. -\layout Subsection - -Compiling for Debugging -\layout Standard - -The \SpecialChar \- -\SpecialChar \- -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. -\layout Subsection - -How the Debugger Works -\layout Standard - -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. -\layout Subsection - -Starting the Debugger -\layout Standard - -The debugger can be started using the following command line. - (Assume the file you are debugging has the file name foo). -\newline - -\newline - -\family sans -\series bold -sdcdb foo -\newline - -\family default -\series default - -\newline -The debugger will look for the following files. -\layout Itemize - -foo.c - the source file. -\layout Itemize - -foo.cdb - the debugger symbol information file. -\layout Itemize - -foo.ihx - the intel hex format object file. -\layout Subsection - -Command Line Options. -\layout Itemize - ---directory= this option can used to specify the - directory search list. - The debugger will look into the directory list specified for source, cdb - & ihx files. - The items in the directory list must be separated by ':', e.g. - if the source files can be in the directories /home/src1 and /home/src2, - the --directory option should be --directory=/home/src1:/home/src2. - Note there can be no spaces in the option. - -\layout Itemize - --cd - change to the . -\layout Itemize - --fullname - used by GUI front ends. -\layout Itemize - --cpu - this argument is passed to the simulator please see the - simulator docs for details. -\layout Itemize - --X this options is passed to the simulator please see - the simulator docs for details. -\layout Itemize - --s passed to simulator see the simulator docs for details. -\layout Itemize - --S passed to simulator see the simulator docs for details. -\layout Subsection - -Debugger Commands. -\layout Standard - -As mention earlier the command interface for the debugger has been deliberately - kept as close the GNU debugger gdb, as possible. - This will help the integration with existing graphical user interfaces - (like ddd, xxgdb or xemacs) existing for the GNU debugger. -\layout Subsubsection - -break [line | file:line | function | file:function] -\layout Standard - -Set breakpoint at specified line or function: -\newline - -\newline - -\family sans -\series bold -sdcdb>break 100 -\newline -sdcdb>break foo.c:100 -\newline -sdcdb>break funcfoo -\newline -sdcdb>break foo.c:funcfoo -\layout Subsubsection - -clear [line | file:line | function | file:function ] -\layout Standard - -Clear breakpoint at specified line or function: -\newline - -\newline - -\family sans -\series bold -sdcdb>clear 100 -\newline -sdcdb>clear foo.c:100 -\newline -sdcdb>clear funcfoo -\newline -sdcdb>clear foo.c:funcfoo -\layout Subsubsection - -continue -\layout Standard - -Continue program being debugged, after breakpoint. -\layout Subsubsection - -finish -\layout Standard - -Execute till the end of the current function. -\layout Subsubsection - -delete [n] -\layout Standard - -Delete breakpoint number 'n'. - If used without any option clear ALL user defined break points. -\layout Subsubsection - -info [break | stack | frame | registers ] -\layout Itemize - -info break - list all breakpoints -\layout Itemize - -info stack - show the function call stack. -\layout Itemize - -info frame - show information about the current execution frame. -\layout Itemize - -info registers - show content of all registers. -\layout Subsubsection - -step -\layout Standard - -Step program until it reaches a different source line. -\layout Subsubsection - -next -\layout Standard - -Step program, proceeding through subroutine calls. -\layout Subsubsection - -run -\layout Standard - -Start debugged program. -\layout Subsubsection - -ptype variable -\layout Standard - -Print type information of the variable. -\layout Subsubsection - -print variable -\layout Standard - -print value of variable. -\layout Subsubsection - -file filename -\layout Standard - -load the given file name. - Note this is an alternate method of loading file for debugging. -\layout Subsubsection - -frame -\layout Standard - -print information about current frame. -\layout Subsubsection - -set srcmode -\layout Standard - -Toggle between C source & assembly source. -\layout Subsubsection - -! simulator command -\layout Standard - -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. -\layout Subsubsection - -quit. -\layout Standard - -"Watch me now. - Iam going Down. - My name is Bobby Brown" -\layout Subsection - -Interfacing with XEmacs. -\layout Standard - -Two files (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 installat -ion 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): -\newline - -\newline - -\family typewriter -(load-file sdcdbsrc.el) -\family default - -\newline - -\newline -.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 - (/bin), then enter the following command ESC-x load-file sdcdbsrc. - To start the interface enter the following command: -\newline - -\newline - -\family sans -\series bold -ESC-x sdcdbsrc -\family default -\series default - -\newline - -\newline -You will prompted to enter the file name to be debugged. - -\newline - -\newline -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. -\layout Itemize - -sdcdbsrc-cpu-type '51 -\layout Itemize - -sdcdbsrc-frequency '11059200 -\layout Itemize - -sdcdbsrc-serial nil -\layout Standard - -The following is a list of key mapping for the debugger interface. -\layout Standard - -\SpecialChar ~ - -\family typewriter - -\newline -;; Current Listing :: -\newline -;;key\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -binding\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -Comment -\newline -;;---\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ --------\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -------- -\newline -;; -\newline -;; n\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - sdcdb-next-from-src\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -SDCDB next command -\newline -;; b\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - sdcdb-back-from-src\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -SDCDB back command -\newline -;; c\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - sdcdb-cont-from-src\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -SDCDB continue command -\newline -;; s\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - sdcdb-step-from-src\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -SDCDB step command -\newline -;; ?\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - sdcdb-whatis-c-sexp\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -SDCDB ptypecommand for data at -\newline -;;\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - buffer point -\newline -;; x\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - sdcdbsrc-delete\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -SDCDB Delete all breakpoints if no arg -\newline -;;\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -given or delete arg (C-u arg x) -\newline -;; m\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - sdcdbsrc-frame\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -SDCDB Display current frame if no arg, -\newline -;;\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -given or display frame arg -\newline -;;\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -buffer point -\newline -;; !\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - sdcdbsrc-goto-sdcdb\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -Goto the SDCDB output buffer -\newline -;; p\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - sdcdb-print-c-sexp\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -SDCDB print command for data at -\newline -;;\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - buffer point -\newline -;; g\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - sdcdbsrc-goto-sdcdb\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -Goto the SDCDB output buffer -\newline -;; t\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - sdcdbsrc-mode\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -Toggles Sdcdbsrc mode (turns it off) -\newline -;; -\newline -;; C-c C-f\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - sdcdb-finish-from-src\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -SDCDB finish command -\newline -;; -\newline -;; C-x SPC\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - sdcdb-break\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -Set break for line with point -\newline -;; ESC t\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - sdcdbsrc-mode\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -Toggle Sdcdbsrc mode -\newline -;; ESC m\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - sdcdbsrc-srcmode\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ -\SpecialChar ~ - Toggle list mode -\newline -;; -\family default - -\newline - -\layout Section - -Other Processors -\layout Subsection - -The Z80 and gbz80 port -\layout Standard - -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. - Apart from that the code generated is correct. -\layout Standard - -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. -\layout Section - -Support -\layout Standard - -SDCC has grown to be a large project. - The compiler alone (without the preprocessor, assembler and linker) 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. -\layout Subsection - -Reporting Bugs -\layout Standard - -Send an email to the mailing list at 'user-sdcc@sdcc.sourceforge.net' or 'devel-sd -cc@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. -\layout Section - -Acknowledgments -\layout Standard - -Sandeep Dutta (sandeep.dutta@usa.net) - SDCC, the compiler, MCS51 code generator, - Debugger, AVR port -\newline -Alan Baldwin (baldwin@shop-pdp.kent.edu) - Initial version of ASXXXX & ASLINK. - -\newline -John Hartman (jhartman@compuserve.com) - Porting ASXXX & ASLINK for 8051 -\newline -Dmitry S. - Obukhov (dso@usa.net) - malloc & serial i/o routines. - -\newline -Daniel Drotos (drdani@mazsola.iit.uni-miskolc.hu) - for his Freeware simulator -\newline -Malini Dutta(malini_dutta@hotmail.com) - my wife for her patience and support. -\newline -Unknown - for the GNU C - preprocessor. -\newline -Michael Hope - The Z80 and Z80GB port, 186 development -\newline -Kevin Vigor - The DS390 port. -\newline -Johan Knol - Lots of fixes and enhancements, DS390/TINI libs. -\newline -Scott Datallo - The PIC port. -\newline - -\newline - -\emph on -Thanks to all the other volunteer developers who have helped with coding, - testing, web-page creation, distribution sets, etc. - You know who you are :-) -\emph default - -\newline - -\layout Standard - -This document was initially written by Sandeep Dutta -\layout Standard - -All product names mentioned herein may be trademarks of their respective - companies. - -\layout Standard - - -\begin_inset LatexCommand \printindex{} - -\end_inset - - -\the_end diff --git a/doc/SDCCUdoc.pdf b/doc/SDCCUdoc.pdf deleted file mode 100644 index 1d950edae244b176fe29b772647491b62d6c360d..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 410400 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 o_8Nl%wHl5`)}s%)_VVN@br@C0&s%D@ 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%0AoTp8os%Vup-eUL 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
MJ5gZR4gz7R0EQfX95K%NPr;6!tqJ`$ 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 diff --git a/doc/sdccman.pdf b/doc/sdccman.pdf new file mode 100644 index 0000000000000000000000000000000000000000..8e130df30549383995134e3f641fada894d63770 GIT binary patch literal 144937 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
APJ@u#-D+p`jDO|W$^|uLD!5x?aE)p|y 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 Library Routines - 4.4 Interfacing with Assembly Routines - 4.4.1 Global Registers used for Parameter Passing - 4.4.2 Assembler Routine(non-reentrant) - 4.4.3 Assembler Routine(reentrant) - 4.5 External Stack - 4.6 ANSI-Compliance - 4.7 Cyclomatic Complexity -5 TIPS - 5.1 Notes on MCS51 memory layout -6 Retargetting for other MCUs. -7 SDCDB - Source Level Debugger - 7.1 Compiling for Debugging - 7.2 How the Debugger Works - 7.3 Starting the Debugger - 7.4 Command Line Options. - 7.5 Debugger Commands. - 7.5.1 break [line | file:line | function | file:function] - 7.5.2 clear [line | file:line | function | file:function ] - 7.5.3 continue - 7.5.4 finish - 7.5.5 delete [n] - 7.5.6 info [break | stack | frame | registers ] - 7.5.7 step - 7.5.8 next - 7.5.9 run - 7.5.10 ptype variable - 7.5.11 print variable - 7.5.12 file filename - 7.5.13 frame - 7.5.14 set srcmode - 7.5.15 ! simulator command - 7.5.16 quit. - 7.6 Interfacing with XEmacs. -8 Other Processors - 8.1 The Z80 and gbz80 port -9 Support - 9.1 Reporting Bugs -10 Acknowledgments - - - -1 Introduction - -1.1 About SDCC +Introduction + About SDCC + Open Source + Typographic conventions + Compatibility with previous versions + System Requirements + Other Resources + Wishes for the future +Installation + Linux/Unix Installation + Windows Installation + Windows Install Using a Binary Package + Windows Install Using Cygwin + Testing out the SDCC Compiler + Install Trouble-shooting + SDCC cannot find libraries or header files. + SDCC does not compile correctly. + What the ./configure does + What the make does. + What the make install command does. + Additional Information for Windows Users + Getting started with Cygwin + Running SDCC as Native Compiled Executables + SDCC on Other Platforms + Advanced Install Options + Components of SDCC + sdcc - The Compiler + sdcpp (C-Preprocessor) + asx8051, as-z80, as-gbz80, aslink, link-z80, link-gbz80 (The Assemblers and Linkage Editors) + s51 - Simulator + sdcdb - Source Level Debugger +Using SDCC + Compiling + Single Source File Projects + Projects with Multiple Source Files + Projects with Additional Libraries + Command Line Options + Processor Selection Options + Preprocessor Options + Linker Options + MCS51 Options + DS390 Options + Optimization Options + Other Options + Intermediate Dump Options + MCS51/DS390 Storage Class Language Extensions + xdata + data + idata + bit + sfr / sbit + Pointers + Parameters & Local Variables + Overlaying + Interrupt Service Routines + Critical Functions + Naked Functions + Functions using private banks + Absolute Addressing + Startup Code + Inline Assembler Code + int(16 bit) and long (32 bit) Support + Floating Point Support + MCS51 Memory Models + DS390 Memory Models + Defines Created by the Compiler +SDCC Technical Data + Optimizations + Sub-expression Elimination + Dead-Code Elimination + Copy-Propagation + Loop Optimizations + Loop Reversing + Algebraic Simplifications + 'switch' Statements + Bit-shifting Operations. + Bit-rotation + Highest Order Bit + Peep-hole Optimizer + Pragmas + Library Routines + Interfacing with Assembly Routines + Global Registers used for Parameter Passing + Assembler Routine(non-reentrant) + Assembler Routine(reentrant) + External Stack + ANSI-Compliance + Cyclomatic Complexity +TIPS + Notes on MCS51 memory layout +Retargetting for other MCUs. +SDCDB - Source Level Debugger + Compiling for Debugging + How the Debugger Works + Starting the Debugger + Command Line Options. + Debugger Commands. + break [line | file:line | function | file:function] + clear [line | file:line | function | file:function ] + continue + finish + delete [n] + info [break | stack | frame | registers ] + step + next + run + ptype variable + print variable + file filename + frame + set srcmode + ! simulator command + quit. + Interfacing with XEmacs. +Other Processors + The Z80 and gbz80 port +Support + Reporting Bugs +Acknowledgments + + + + Introduction + + About SDCC SDCC is a Freeware, retargettable, optimizing ANSI-C compiler by Sandeep Dutta designed for 8 bit Microprocessors. The @@ -145,18 +145,18 @@ various microcontrollers and underlying hardware effectively. In addition to the MCU specific optimizations SDCC also does a host of standard optimizations like: -* global sub expression elimination, + global sub expression elimination, -* loop optimizations (loop invariant, strength reduction + loop optimizations (loop invariant, strength reduction of induction variables and loop reversing), -* constant folding & propagation, + constant folding & propagation, -* copy propagation, + copy propagation, -* dead code elimination + dead code elimination -* jumptables for switch statements. + 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. @@ -166,13 +166,13 @@ which is MCU independent. Supported data-types are: -* char (8 bits, 1 byte), + char (8 bits, 1 byte), -* short and int (16 bits, 2 bytes), + short and int (16 bits, 2 bytes), -* long (32 bit, 4 bytes) + long (32 bit, 4 bytes) -* float (4 byte IEEE). + float (4 byte IEEE). The compiler also allows inline assembler code to be embedded anywhere in a function. In addition, routines developed @@ -189,7 +189,7 @@ the debugger currently uses ucSim a freeware simulator for The latest version can be downloaded from [http://sdcc.sourceforge.net/]. -1.2 Open Source + Open Source All packages used in this compiler system are opensource and freeware; source code for all the sub-packages (asxxxx @@ -213,14 +213,14 @@ this program. You are forbidden to forbid anyone else to use, share and improve what you give them. Help stamp out software-hoarding! -1.3 Typographic conventions + Typographic conventions Throughout this manual, we will use the following convention. Commands you have to type in are printed in "sans serif". Code samples are printed in typewriter font. Interesting items and new terms are printed in italicised type. -1.4 Compatibility with previous versions + Compatibility with previous versions This version has numerous bug fixes compared with the previous version. But we also introduced some incompatibilities with @@ -228,25 +228,25 @@ older versions. Not just for the fun of it, but to make the compiler more stable, efficient and ANSI compliant. -* short is now equivalent to int (16 bits), it used to be + short is now equivalent to int (16 bits), it used to be equivalent to char (8 bits) -* the default directory where include, library and documention + the default directory where include, library and documention files are stored is no in /usr/local/share -* char type parameters to vararg functions are casted to + char type parameters to vararg functions are casted to int unless explicitly casted, e.g.: char a=3; printf ("%d %c\n", a, (char)a); will push a as an int and as a char resp. -* option --regextend has been removed + option --regextend has been removed -* option --noreparms has been removed + option --noreparms has been removed -1.5 System Requirements + System Requirements What do you need before you start installation of SDCC? A computer, and a desire to compute. The preferred method @@ -255,7 +255,7 @@ 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. -1.6 Other Resources + Other Resources The SDCC home page at [http://sdcc.sourceforge.net/] is a great place to find distribution sets. You can also @@ -269,7 +269,7 @@ 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 cvs.sdcc.sourceforge.net. -1.7 Wishes for the future + Wishes for the future There are (and always will be) some things that could be done. Here are some I can think of: @@ -285,33 +285,33 @@ If you can think of some more, please send them to the list. -2 Installation + Installation -2.1 Linux/Unix Installation + Linux/Unix Installation -1. Download the source package, it will be named something + Download the source package, it will be named something like sdcc-2.x.x.tgz. -2. Bring up a command line terminal, such as xterm. + Bring up a command line terminal, such as xterm. -3. Unpack the file using a command like: "tar -xzf sdcc-2.x.x.tgz", + Unpack the file using a command like: "tar -xzf sdcc-2.x.x.tgz", this will create a sub-directory called sdcc with all of the sources. -4. Change directory into the main SDCC directory, for example + Change directory into the main SDCC directory, for example type: "cd sdcc". -5. Type "./configure". This configures the package for compilation + Type "./configure". This configures the package for compilation on your system. -6. Type "make". All of the source packages will compile, this + Type "make". All of the source packages will compile, this can take a while. -7. Type "make install" as root. This copies the binary executables, + Type "make install" as root. This copies the binary executables, the include files, the libraries and the documentation to the install directories. -2.2 Windows Installation + Windows Installation @@ -325,40 +325,40 @@ 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. -2.2.1 Windows Install Using a Binary Package + Windows Install Using a Binary Package -1. Download the binary package and unpack it using your favorite + Download the binary package and unpack it using your favorite unpacking tool (gunzip, WinZip, etc). This should unpack to a group of sub-directories. An example directory structure after unpacking is: c:\usr\local\bin for the executables, c:\usr\local\share\sdcc\include and c:\usr\local\share\sdcc\lib for the include and libraries. -2. Adjust your environment PATH to include the location of + Adjust your environment PATH to include the location of the bin directory. For example, make a setsdcc.bat file with the following: set PATH=c:\usr\local\bin;%PATH% -3. When you compile with sdcc, you may need to specify the + When you compile with sdcc, you may need to specify the location of the lib and include folders. For example, sdcc -I c:\usr\local\share\sdcc\include -L c:\usr\local\share\sdcc\lib\small test.c -2.2.2 Windows Install Using Cygwin + Windows Install Using Cygwin -1. Download and install the cygwin package from the redhat + Download and install the cygwin package from the redhat site[http://sources.redhat.com/cygwin/]. Currently, this involved downloading a small install program which then automates downloading and installing selected parts of the package (a large 80M byte sized dowload for the whole thing). -2. Bring up a Unix/Bash command line terminal from the Cygwin + Bring up a Unix/Bash command line terminal from the Cygwin menu. -3. Follow the instructions in the preceding Linux/Unix installation + Follow the instructions in the preceding Linux/Unix installation section. -2.3 Testing out the SDCC Compiler + Testing out the SDCC Compiler The first thing you should do after installing your SDCC compiler is to see if it runs. Type "sdcc --version" at @@ -422,9 +422,9 @@ 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). -2.4 Install Trouble-shooting + Install Trouble-shooting -2.4.1 SDCC cannot find libraries or header files. + SDCC cannot find libraries or header files. The default installation assumes the libraries and header files are located at "/usr/local/share/sdcc/lib" @@ -432,7 +432,7 @@ 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". -2.4.2 SDCC does not compile correctly. + SDCC does not compile correctly. A thing to try is starting from scratch by unpacking the .tgz source package again in an empty directory. Confure @@ -445,7 +445,7 @@ problem. Or a relevant part of this be attached to an email that could be helpful when requesting help from the mailing list. -2.4.3 What the "./configure" + What the "./configure" does The "./configure" command is a script @@ -454,13 +454,13 @@ 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. -2.4.4 What the "make" does. + What the "make" does. This runs the GNU make tool, which automatically compiles all the source packages into the final installed binary executables. -2.4.5 What the "make install" + What the "make install" command does. This will install the compiler, other executables and libraries @@ -468,7 +468,7 @@ 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. -2.5 Additional Information for Windows Users + Additional Information for Windows Users @@ -491,7 +491,7 @@ 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. -2.5.1 Getting started with Cygwin + Getting started with Cygwin SDCC is typically distributed as a tarred/gzipped file (.tgz). This is a packed file similar to a .zip file. Cygwin includes @@ -514,7 +514,7 @@ 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. -2.5.2 Running SDCC as Native Compiled Executables + Running SDCC as Native Compiled Executables If you use the pre-compiled binaries, the install directories for the libraries and header files may need to be specified @@ -530,17 +530,17 @@ 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. -2.6 SDCC on Other Platforms + SDCC on Other Platforms -* FreeBSD and other non-GNU Unixes - Make sure the GNU make + FreeBSD and other non-GNU Unixes - Make sure the GNU make is installed as the default make tool. -* SDCC has been ported to run under a variety of operating + SDCC has been ported to run under a variety of operating systems and processors. If you can run GNU GCC/make then chances are good SDCC can be compiled and run on your system. -2.7 Advanced Install Options + Advanced Install Options The "configure" command has several options. The most commonly used option is --prefix=, @@ -565,7 +565,7 @@ The command "./configure --prefix=/usr/local" will configure the compiler to be installed in directory /usr/local. -2.8 Components of SDCC + Components of SDCC SDCC is not just a compiler, but a collection of tools by various developers. These include linkers, assemblers, simulators @@ -582,53 +582,53 @@ programs: In /bin: -* sdcc - The compiler. + sdcc - The compiler. -* sdcpp - The C preprocessor. + sdcpp - The C preprocessor. -* asx8051 - The assembler for 8051 type processors. + asx8051 - The assembler for 8051 type processors. -* as-z80, as-gbz80 - The Z80 and GameBoy Z80 assemblers. + as-z80, as-gbz80 - The Z80 and GameBoy Z80 assemblers. -* aslink -The linker for 8051 type processors. + aslink -The linker for 8051 type processors. -* link-z80, link-gbz80 - The Z80 and GameBoy Z80 linkers. + link-z80, link-gbz80 - The Z80 and GameBoy Z80 linkers. -* s51 - The ucSim 8051 simulator. + s51 - The ucSim 8051 simulator. -* sdcdb - The source debugger. + sdcdb - The source debugger. -* packihx - A tool to pack Intel hex files. + packihx - A tool to pack Intel hex files. In /share/sdcc/include -* the include files + the include files In /share/sdcc/lib -* the sources of the runtime library and the subdirs small + the sources of the runtime library and the subdirs small large and ds390 with the precompiled relocatables. In /share/sdcc/doc -* the documentation + 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 + 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) + 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 + asx8051, as-z80, as-gbz80, aslink, link-z80, link-gbz80 (The Assemblers and Linkage Editors) This is retargettable assembler & linkage editor, it was @@ -636,24 +636,24 @@ 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 - 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 - 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. -3 Using SDCC + Using SDCC -3.1 Compiling + Compiling -3.1.1 Single Source File Projects + Single Source File Projects For single source file 8051 projects the process is very simple. Compile your programs with the following command @@ -676,7 +676,7 @@ sourcefile.cdb - An optional file (with --debug) containing debug information -3.1.2 Projects with Multiple Source Files + Projects with Multiple Source Files SDCC can compile only ONE file at a time. Let us for example assume that you have a project containing the following @@ -708,7 +708,7 @@ 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. -3.1.3 Projects with Additional Libraries + Projects with Additional Libraries Some reusable routines may be compiled into a library, see the documentation for the assembler and linkage editor (which @@ -730,9 +730,9 @@ modules in seperate source files. The lib file now should name all the modules.rel files. For an example see the standard library file libsdcc.lib in the directory /share/lib/small. -3.2 Command Line Options + Command Line Options -3.2.1 Processor Selection Options + Processor Selection Options -mmcs51 Generate code for the MCS51 (8051) family of processors. This is the default processor target. @@ -752,7 +752,7 @@ not complete). -mtlcs900h Generate code for the Toshiba TLCS-900H processor(In development, not complete). -3.2.2 Preprocessor Options + Preprocessor Options -I The additional location where the pre processor will look for <..h> or "..h" @@ -804,7 +804,7 @@ output. -dN Like `-dD' except that the macro arguments and contents are omitted. Only `#define name' is included in the output. -3.2.3 Linker Options + Linker Options -L --lib-path This option is passed to the linkage editor's additional libraries @@ -853,7 +853,7 @@ Intel Hex format. (This is the default option). --out-fmt-s19 The linker output (final object code) is in Motorola S19 format. -3.2.4 MCS51 Options + MCS51 Options --model-large Generate code for Large model programs see section Memory Models for more details. If this option is @@ -865,7 +865,7 @@ are compiled with small model, they will need to be recompiled. section Memory Models for more details. This is the default model. -3.2.5 DS390 Options + DS390 Options --model-flat24 Generate 24-bit flat mode code. This is the one and only that the ds390 code generator supports right @@ -892,7 +892,7 @@ option. It also only makes sense if the processor is in 24 bit contiguous addressing mode (see the --model-flat24 option). -3.2.6 Optimization Options + Optimization Options --nogcse Will not do global subexpression elimination, this option may be used when the compiler creates undesirably @@ -926,7 +926,7 @@ for a given function only. --noloopreverse Will not do loop reversal optimization. -3.2.7 Other Options + Other Options -c --compile-only will compile and assemble the source, but will not call the linkage editor. @@ -1036,7 +1036,7 @@ the default library path to the linker. -V Shows the actual commands the compiler is executing. -3.2.8 Intermediate Dump Options + Intermediate Dump Options The following options are provided for the purpose of retargetting and debugging the compiler. These provided a means to dump @@ -1073,12 +1073,12 @@ assignment, into a file named .dumprassgn. --dumpall Will cause all the above mentioned dumps to be created. -3.3 MCS51/DS390 Storage Class Language Extensions + MCS51/DS390 Storage Class Language Extensions In addition to the ANSI storage classes SDCC allows the following MCS51 specific storage classes. -3.3.1 xdata + xdata Variables declared with this storage class will be placed in the extern RAM. This is the default storage class for @@ -1086,7 +1086,7 @@ Large Memory model, e.g.: xdata unsigned char xduc; -3.3.2 data + data This is the default storage class for Small Memory model. Variables declared with this storage class will be allocated @@ -1094,7 +1094,7 @@ in the internal RAM, e.g.: data int iramdata; -3.3.3 idata + idata Variables declared with this storage class will be allocated into the indirectly addressable portion of the internal @@ -1102,7 +1102,7 @@ ram of a 8051, e.g.: idata int idi; -3.3.4 bit + bit This is a data-type and a storage class specifier. When a variable is declared as a bit, it is allocated into the @@ -1110,7 +1110,7 @@ bit addressable memory of 8051, e.g.: bit iFlag; -3.3.5 sfr / sbit + sfr / sbit Like the bit keyword, sfr / sbit signifies both a data-type and storage class, they are used to describe the special @@ -1121,7 +1121,7 @@ sfr at 0x80 P0; /* special function register P0 at location 0x80 */ sbit at 0xd7 CY; /* CY (Carry Flag) */ -3.4 Pointers + Pointers SDCC allows (via language extensions) pointers to explicitly point to any of the memory spaces of the 8051. In addition @@ -1176,7 +1176,7 @@ Explicitly specifying the pointer type will generate the most efficient code. Pointers declared using a mixture of OLD and NEW style could have unpredictable results. -3.5 Parameters & Local Variables + Parameters & Local Variables Automatic (local) variables and parameters to functions can either be placed on the stack or in data-space. The default @@ -1221,7 +1221,7 @@ classes for parameters will be ignored), their allocation is governed by the memory model in use, and the reentrancy options. -3.6 Overlaying + Overlaying For non-reentrant functions SDCC will try to reduce internal ram space usage by overlaying parameters and local variables @@ -1271,7 +1271,7 @@ ISR. The #pragma NOOVERLAY ensures that the parameters and local variables for the function are NOT overlayed. -3.7 Interrupt Service Routines + Interrupt Service Routines SDCC allows interrupt service routines to be coded in C, with some extended keywords. @@ -1347,7 +1347,7 @@ is not recommended, avoid it if possible. Also see the _naked modifier. -3.8 Critical Functions + Critical Functions A special keyword may be associated with a function declaring it as critical. SDCC will generate code to disable all interrupts @@ -1364,7 +1364,7 @@ int foo () critical The critical attribute maybe used with other attributes like reentrant. -3.9 Naked Functions + Naked Functions A special keyword may be associated with a function declaring it as _naked. The _naked function modifier attribute prevents @@ -1423,7 +1423,7 @@ inside a _naked function, there are many ways to shoot yourself in the foot doing this, and is is recommended that you stick to inline assembler. -3.10 Functions using private banks + Functions using private banks The using attribute (which tells the compiler to use a register bank other than the default bank zero) should only be applied @@ -1465,7 +1465,7 @@ if those functions use the same bank as the ISR (see note zero. It is very inefficient to call a function using a different, non-zero bank from an ISR. -3.11 Absolute Addressing + Absolute Addressing Data items can be assigned an absolute address with the at
keyword, in addition to a storage class, e.g.: @@ -1494,7 +1494,7 @@ 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. -3.12 Startup Code + Startup Code The compiler inserts a call to the C routine _sdcc__external__startup() at the start of the CODE area. This routine is in the runtime @@ -1507,7 +1507,7 @@ routine to your program to override the default if you need to setup hardware or perform some other critical operation prior to static & global variable initialization. -3.13 Inline Assembler Code + Inline Assembler Code SDCC allows the use of in-line assembler with a few restriction as regards labels. All labels defined within inline assembler @@ -1561,7 +1561,7 @@ in inline assembly within the scope of the funtion. The same goes the other way, ie. labels defines in inline assembly CANNOT be accessed by C statements. -3.14 int(16 bit) and long (32 bit) Support + int(16 bit) and long (32 bit) Support For signed & unsigned int (16 bit) and long (32 bit) variables, division, multiplication and modulus operations are implemented @@ -1592,7 +1592,7 @@ is unavoidable then the above routines will need to be compiled with the --stack-auto option, after which the source program will have to be compiled with --int-long-rent option. -3.15 Floating Point Support + Floating Point Support SDCC supports IEEE (single precision 4bytes) floating point numbers.The floating point support routines are derived @@ -1621,7 +1621,7 @@ Note if all these routines are used simultaneously the data space might overflow. For serious floating point usage it is strongly recommended that the large model be used. -3.16 MCS51 Memory Models + MCS51 Memory Models SDCC allows two memory models for MCS51 code, small and large. Modules compiled with different memory models should never @@ -1644,7 +1644,7 @@ 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. -3.17 DS390 Memory Models + DS390 Memory Models The only model supported is Flat 24. This generates code for the 24 bit contiguous addressing mode of the Dallas @@ -1677,39 +1677,39 @@ passed to the linker by using the option -Wl-r on the sdcc command line. However, currently the linker can not handle code segments > 64k. -3.18 Defines Created by the Compiler + Defines Created by the Compiler The compiler creates the following #defines. -* SDCC - this Symbol is always defined. + SDCC - this Symbol is always defined. -* SDCC_mcs51 or SDCC_ds390 or SDCC_z80, etc - depending on + SDCC_mcs51 or SDCC_ds390 or SDCC_z80, etc - depending on the model used (e.g.: -mds390) -* __mcs51 or __ds390 or __z80, etc - depending on the model + __mcs51 or __ds390 or __z80, etc - depending on the model used (e.g. -mz80) -* SDCC_STACK_AUTO - this symbol is defined when --stack-auto + SDCC_STACK_AUTO - this symbol is defined when --stack-auto option is used. -* SDCC_MODEL_SMALL - when --model-small is used. + SDCC_MODEL_SMALL - when --model-small is used. -* SDCC_MODEL_LARGE - when --model-large is used. + SDCC_MODEL_LARGE - when --model-large is used. -* SDCC_USE_XSTACK - when --xstack option is used. + SDCC_USE_XSTACK - when --xstack option is used. -* SDCC_STACK_TENBIT - when -mds390 is used + SDCC_STACK_TENBIT - when -mds390 is used -* SDCC_MODEL_FLAT24 - when -mds390 is used + SDCC_MODEL_FLAT24 - when -mds390 is used -4 SDCC Technical Data + SDCC Technical Data -4.1 Optimizations + Optimizations SDCC performs a host of standard optimizations in addition to some MCU specific optimizations. -4.1.1 Sub-expression Elimination + Sub-expression Elimination The compiler does local and global common subexpression elimination, e.g.: @@ -1739,7 +1739,7 @@ iTemp.d = 11; The compiler will try to keep these temporary variables in registers. -4.1.2 Dead-Code Elimination + Dead-Code Elimination int global; void f () { @@ -1759,7 +1759,7 @@ int global; void f () return; } -4.1.3 Copy-Propagation + Copy-Propagation int f() { int i, j; @@ -1780,7 +1780,7 @@ int f() { Note: the dead stores created by this copy propagation will be eliminated by dead-code elimination. -4.1.4 Loop Optimizations + Loop Optimizations Two types of loop optimizations are done by SDCC loop invariant lifting and strength reduction of loop induction variables. @@ -1832,7 +1832,7 @@ for (i=0;i< 100;i++) { The more expensive multiplication is changed to a less expensive addition. -4.1.5 Loop Reversing + Loop Reversing This optimization is done to reduce the overhead of checking loop boundaries for every iteration. Some simple loops can @@ -1843,32 +1843,32 @@ is reversible (note: more sophisticated compilers use data-dependency analysis to make this determination, SDCC uses a more simple minded analysis). -* The 'for' loop is of the form + The 'for' loop is of the form for ( = ; [< | <=] ; [++ | += 1]) -* The does not contain "continue" + The does not contain "continue" or 'break". -* All goto's are contained within the loop. + All goto's are contained within the loop. -* No function calls within the loop. + No function calls within the loop. -* The loop control variable is not assigned any value + The loop control variable is not assigned any value within the loop -* The loop control variable does NOT participate in any arithmetic + The loop control variable does NOT participate in any arithmetic operation within the loop. -* There are NO switch statements in the loop. + There are NO switch statements in the loop. Note djnz instruction can be used for 8-bit values only, therefore it is advantageous to declare loop control symbols as char. Ofcourse this may not be possible on all situations. -4.1.6 Algebraic Simplifications + Algebraic Simplifications SDCC does numerous algebraic simplifications, the following is a small sub-set of these optimizations. @@ -1881,12 +1881,12 @@ 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. -4.1.7 'switch' Statements + 'switch' Statements SDCC changes switch statements to jump tables when the following conditions are true. -* The case labels are in numerical sequence, the labels need + The case labels are in numerical sequence, the labels need not be in order, and the starting number need not be one or zero. @@ -1912,10 +1912,10 @@ conditions are true. Both the above switch statements will be implemented using a jump-table. -* The number of case labels is at least three, since it takes + The number of case labels is at least three, since it takes two conditional statements to handle the boundary conditions. -* The number of case labels is less than 84, since each label + The number of case labels is less than 84, since each label takes 3 bytes and a jump-table can be utmost 256 bytes long. @@ -1958,7 +1958,7 @@ then both the switch statements will be implemented using jump-tables whereas the unmodified switch statement will not be. -4.1.8 Bit-shifting Operations. + Bit-shifting Operations. Bit shifting is one of the most frequently used operation in embedded programming. SDCC tries to implement bit-shift @@ -1995,7 +1995,7 @@ mov _i,a Note that SDCC stores numbers in little-endian format (i.e. lowest order first). -4.1.9 Bit-rotation + Bit-rotation A special case of the bit-shift operation is bit rotation, SDCC recognizes the following expression to be a left bit-rotation: @@ -2017,7 +2017,7 @@ as bit-rotation, i.e.: i = ((i >> 7) | (i << 1)); /* left-bit rotation */ -4.1.10 Highest Order Bit + Highest Order Bit It is frequently required to obtain the highest order bit of an integral type (long, int, short or char types). SDCC @@ -2063,7 +2063,7 @@ xyz = gint + ((gint >> 15) & 1); will still be recognized. -4.1.11 Peep-hole Optimizer + Peep-hole Optimizer The compiler uses a rule based, pattern matching and re-writing mechanism for peep-hole optimization. It is inspired by @@ -2193,38 +2193,38 @@ rules that are compiled into the compiler, you can add your own rules in the default set there if you get tired of specifying the --peep-file option. -4.2 Pragmas + Pragmas SDCC supports the following #pragma directives. This directives are applicable only at a function level. -* SAVE - this will save all the current options. + SAVE - this will save all the current options. -* RESTORE - will restore the saved options from the last + RESTORE - will restore the saved options from the last save. Note that SAVES & RESTOREs cannot be nested. SDCC uses the same buffer to save the options each time a SAVE is called. -* NOGCSE - will stop global subexpression elimination. + NOGCSE - will stop global subexpression elimination. -* NOINDUCTION - will stop loop induction optimizations. + NOINDUCTION - will stop loop induction optimizations. -* NOJTBOUND - will not generate code for boundary value checking, + NOJTBOUND - will not generate code for boundary value checking, when switch statements are turned into jump-tables. -* NOOVERLAY - the compiler will not overlay the parameters + NOOVERLAY - the compiler will not overlay the parameters and local variables of a function. -* NOLOOPREVERSE - Will not do loop reversal optimization + NOLOOPREVERSE - Will not do loop reversal optimization -* EXCLUDE NONE | {acc[,b[,dpl[,dph]]] - The exclude pragma + EXCLUDE NONE | {acc[,b[,dpl[,dph]]] - The exclude pragma disables generation of pair of push/pop instruction in ISR function (using interrupt keyword). The directive should be placed immediately before the ISR function definition and it affects ALL ISR functions following it. To enable the normal register saving for ISR functions use #pragma EXCLUDE none. -* CALLEE-SAVES function1[,function2[,function3...]] - The + CALLEE-SAVES function1[,function2[,function3...]] - The compiler by default uses a caller saves convention for register saving across function calls, however this can cause unneccessary register pushing & popping when calling @@ -2269,7 +2269,7 @@ 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. -4.3 Library Routines + Library Routines The following library routines are provided for your convenience. @@ -2375,14 +2375,14 @@ should be cast to a generic pointer. eg. printf_small("my str %s, my int %d\n",(char _generic *)mystr,myint); -* stdarg.h - contains definition for the following macros + stdarg.h - contains definition for the following macros to be used for variable parameter list, note that a function can have a variable parameter list if and only if it is 'reentrant' va_list, va_start, va_arg, va_end. -* setjmp.h - contains defintion for ANSI setjmp & longjmp + setjmp.h - contains defintion for ANSI setjmp & longjmp routines. Note in this case setjmp & longjmp can be used between functions executing within the same register bank, if long jmp is executed from a function that is using @@ -2392,22 +2392,22 @@ _generic *)mystr,myint); & a 16 byte return address), and can be placed in any address space. -* stdlib.h - contains the following functions. + stdlib.h - contains the following functions. atoi, atol. -* string.h - contains the following functions. + string.h - contains the following functions. strcpy, strncpy, strcat, strncat, strcmp, strncmp, strchr, strrchr, strspn, strcspn, strpbrk, strstr, strlen, strtok, memcpy, memcmp, memset. -* ctype.h - contains the following routines. + ctype.h - contains the following routines. iscntrl, isdigit, isgraph, islower, isupper, isprint, ispunct, isspace, isxdigit, isalnum, isalpha. -* malloc.h - The malloc routines are developed by Dmitry + malloc.h - The malloc routines are developed by Dmitry S. Obukhov (dso@usa.net). These routines will allocate memory from the external ram. Here is a description on how to use them (as described by the author). @@ -2441,7 +2441,7 @@ _generic *)mystr,myint); current_buffer = malloc(0x100); // -* serial.h - Serial IO routines are also developed by Dmitry + serial.h - Serial IO routines are also developed by Dmitry S. Obukhov (dso@usa.net). These routines are interrupt driven with a 256 byte circular buffer, they also expect external ram to be present. Please see documentation in @@ -2449,18 +2449,18 @@ _generic *)mystr,myint); "serial.h" MUST be included in the file containing the 'main' function. -* ser.h - Alternate serial routine provided by Wolfgang Esslinger + ser.h - Alternate serial routine provided by Wolfgang Esslinger these routines are more compact and faster. Please see documentation in file SDCCDIR/sdcc51lib/ser.c -* ser_ir.h - Another alternate set of serial routines provided + ser_ir.h - Another alternate set of serial routines provided by Josef Wolf , these routines do not use the external ram. -* reg51.h - contains register definitions for a standard + reg51.h - contains register definitions for a standard 8051 -* float.h - contains min, max and other floating point related + float.h - contains min, max and other floating point related stuff. All library routines are compiled as --model-small, they @@ -2471,9 +2471,9 @@ have to be recompiled with the appropriate compiler option. Have not had time to do the more involved routines like printf, will get to them shortly. -4.4 Interfacing with Assembly Routines + Interfacing with Assembly Routines -4.4.1 Global Registers used for Parameter Passing + Global Registers used for Parameter Passing The compiler always uses the global registers DPL,DPH,B and ACC to pass the first parameter to a routine. The second @@ -2481,7 +2481,7 @@ parameter onwards is either allocated on the stack (for reentrant routines or if --stack-auto is used) or in the internal / external ram (depending on the memory model). -4.4.2 Assembler Routine(non-reentrant) + Assembler Routine(non-reentrant) In the following example the function cfunc calls an assembler routine asm_func, which takes two parameters. @@ -2537,7 +2537,7 @@ file with the following command: sdcc cfunc.c asmfunc.rel -4.4.3 Assembler Routine(reentrant) + Assembler Routine(reentrant) In this case the second parameter onwards will be passed on the stack, the parameters are pushed from right to left @@ -2582,7 +2582,7 @@ 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. -4.5 External Stack + External Stack The external stack is located at the start of the external ram segment, and is 256 bytes in size. When --xstack option @@ -2599,13 +2599,13 @@ external ram segment into PORT P2, therefore when using the External Stack option, this port MAY NOT be used by the application program. -4.6 ANSI-Compliance + ANSI-Compliance Deviations from the compliancy. -* functions are not always reentrant. + functions are not always reentrant. -* structures cannot be assigned values directly, cannot be + structures cannot be assigned values directly, cannot be passed as function parameters or assigned to each other and cannot be a return value from a function, e.g.: @@ -2627,13 +2627,13 @@ Deviations from the compliancy. allowed in ANSI */ } -* 'long long' (64 bit integers) not supported. + 'long long' (64 bit integers) not supported. -* 'double' precision floating point not supported. + 'double' precision floating point not supported. -* No support for setjmp and longjmp (for now). + No support for setjmp and longjmp (for now). -* Old K&R style function declarations are NOT allowed. + Old K&R style function declarations are NOT allowed. foo(i,j) /* this old style of function declarations */ @@ -2643,7 +2643,7 @@ Deviations from the compliancy. ... } -* functions declared as pointers must be dereferenced during + functions declared as pointers must be dereferenced during the call. int (*foo)(); @@ -2652,7 +2652,7 @@ Deviations from the compliancy. (*foo)(); /* ansi standard allows calls to be made like 'foo()' */ -4.7 Cyclomatic Complexity + Cyclomatic Complexity Cyclomatic complexity of a function is defined as the number of independent paths the program can take during execution @@ -2682,31 +2682,31 @@ of the function, it does however provide a good starting point for which functions you might look at for further optimization. -5 TIPS + TIPS Here are a few guidelines that will help the compiler generate more efficient code, some of the tips are specific to this compiler others are generally good programming practice. -* Use the smallest data type to represent your data-value. + Use the smallest data type to represent your data-value. If it is known in advance that the value is going to be less than 256 then use a 'char' instead of a 'short' or 'int'. -* Use unsigned when it is known in advance that the value + Use unsigned when it is known in advance that the value is not going to be negative. This helps especially if you are doing division or multiplication. -* NEVER jump into a LOOP. + NEVER jump into a LOOP. -* Declare the variables to be local whenever possible, especially + Declare the variables to be local whenever possible, especially loop control variables (induction). -* Since the compiler does not do implicit integral promotion, + Since the compiler does not do implicit integral promotion, the programmer should do an explicit cast when integral promotion is required. -* Reducing the size of division, multiplication & modulus + Reducing the size of division, multiplication & modulus operations can reduce code size substantially. Take the following code for example. @@ -2732,7 +2732,7 @@ compiler others are generally good programming practice. versions of the compiler will be smart enough to detect such optimization oppurtunities). -5.1 Notes on MCS51 memory layout + Notes on MCS51 memory layout The 8051 family of micro controller have a minimum of 128 bytes of internal memory which is structured as follows @@ -2805,21 +2805,21 @@ 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. -6 Retargetting for other MCUs. + Retargetting for other MCUs. 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. -* Parsing the source and building the annotated parse tree. + Parsing the source and building the annotated parse tree. This phase is largely MCU independent (except for the language extensions). Syntax & semantic checks are also done in this phase, along with some initial optimizations like back patching labels and the pattern matching optimizations like bit-rotation etc. -* The second phase involves generating an intermediate code + The second phase involves generating an intermediate code which can be easy manipulated during the later phases. This phase is entirely MCU independent. The intermediate code generation assumes the target machine has unlimited @@ -2827,7 +2827,7 @@ and its MCU dependency. iTemp. The compiler can be made to dump a human readable form of the code generated by using the --dumpraw option. -* This phase does the bulk of the standard optimizations + This phase does the bulk of the standard optimizations and is also MCU independent. This phase can be broken down into several sub-phases: @@ -2841,14 +2841,14 @@ and its MCU dependency. subexpression elimination' and 'dead code elimination' again. -* This phase determines the live-ranges; by live range I + This phase determines the live-ranges; by live range I mean those iTemp variables defined by the compiler that still survive after all the optimizations. Live range analysis is essential for register allocation, since these computation determines which of these iTemps will be assigned to registers, and for how long. -* Phase five is register allocation. There are two parts + Phase five is register allocation. There are two parts to this process. The first part I call 'register packing' (for lack of a @@ -2861,17 +2861,17 @@ and its MCU dependency. of the limited number of index registers available in the 8051. -* The Code generation phase is (unhappily), entirely MCU + The Code generation phase is (unhappily), entirely MCU dependent and very little (if any at all) of this code can be reused for other MCU. However the scheme for allocating a homogenized assembler operand for each iCode operand may be reused. -* As mentioned in the optimization section the peep-hole + As mentioned in the optimization section the peep-hole optimizer is rule based system, which can reprogrammed for other MCUs. -7 SDCDB - Source Level Debugger + SDCDB - Source Level Debugger SDCC is distributed with a source level debugger. The debugger uses a command line interface, the command repertoire of @@ -2882,7 +2882,7 @@ 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. -7.1 Compiling for Debugging + Compiling for Debugging The debug option must be specified for all files for which debug information is to be generated. The complier @@ -2890,7 +2890,7 @@ 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. -7.2 How the Debugger Works + How the Debugger Works When the --debug option is specified the compiler generates extra symbol information some of which are put into the @@ -2903,7 +2903,7 @@ 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. -7.3 Starting the Debugger + Starting the Debugger The debugger can be started using the following command line. (Assume the file you are debugging has the file name foo). @@ -2912,15 +2912,15 @@ sdcdb foo The debugger will look for the following files. -* foo.c - the source file. + foo.c - the source file. -* foo.cdb - the debugger symbol information file. + foo.cdb - the debugger symbol information file. -* foo.ihx - the intel hex format object file. + foo.ihx - the intel hex format object file. -7.4 Command Line Options. + Command Line Options. -* --directory= this option can used + --directory= this option can used to specify the directory search list. The debugger will look into the directory list specified for source, cdb & ihx files. The items in the directory list must be separated @@ -2929,23 +2929,23 @@ The debugger will look for the following files. be --directory=/home/src1:/home/src2. Note there can be no spaces in the option. -* -cd - change to the . + -cd - change to the . -* -fullname - used by GUI front ends. + -fullname - used by GUI front ends. -* -cpu - this argument is passed to the simulator + -cpu - this argument is passed to the simulator please see the simulator docs for details. -* -X this options is passed to the simulator + -X this options is passed to the simulator please see the simulator docs for details. -* -s passed to simulator see the simulator + -s passed to simulator see the simulator docs for details. -* -S passed to simulator see the simulator + -S passed to simulator see the simulator docs for details. -7.5 Debugger Commands. + Debugger Commands. As mention earlier the command interface for the debugger has been deliberately kept as close the GNU debugger gdb, @@ -2953,7 +2953,7 @@ as possible. This will help the integration with existing graphical user interfaces (like ddd, xxgdb or xemacs) existing for the GNU debugger. -7.5.1 break [line | file:line | function | file:function] + break [line | file:line | function | file:function] Set breakpoint at specified line or function: @@ -2962,7 +2962,7 @@ sdcdb>break foo.c:100 sdcdb>break funcfoo sdcdb>break foo.c:funcfoo -7.5.2 clear [line | file:line | function | file:function ] + clear [line | file:line | function | file:function ] Clear breakpoint at specified line or function: @@ -2971,64 +2971,64 @@ sdcdb>clear foo.c:100 sdcdb>clear funcfoo sdcdb>clear foo.c:funcfoo -7.5.3 continue + continue Continue program being debugged, after breakpoint. -7.5.4 finish + finish Execute till the end of the current function. -7.5.5 delete [n] + delete [n] Delete breakpoint number 'n'. If used without any option clear ALL user defined break points. -7.5.6 info [break | stack | frame | registers ] + info [break | stack | frame | registers ] -* info break - list all breakpoints + info break - list all breakpoints -* info stack - show the function call stack. + info stack - show the function call stack. -* info frame - show information about the current execution + info frame - show information about the current execution frame. -* info registers - show content of all registers. + info registers - show content of all registers. -7.5.7 step + step Step program until it reaches a different source line. -7.5.8 next + next Step program, proceeding through subroutine calls. -7.5.9 run + run Start debugged program. -7.5.10 ptype variable + ptype variable Print type information of the variable. -7.5.11 print variable + print variable print value of variable. -7.5.12 file filename + file filename load the given file name. Note this is an alternate method of loading file for debugging. -7.5.13 frame + frame print information about current frame. -7.5.14 set srcmode + set srcmode Toggle between C source & assembly source. -7.5.15 ! simulator command + ! simulator command Send the string following '!' to the simulator, the simulator response is displayed. Note the debugger does not interpret @@ -3036,11 +3036,11 @@ 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. -7.5.16 quit. + quit. "Watch me now. Iam going Down. My name is Bobby Brown" -7.6 Interfacing with XEmacs. + Interfacing with XEmacs. Two files (in emacs lisp) are provided for the interfacing with XEmacs, sdcdb.el and sdcdbsrc.el. These two files can @@ -3069,11 +3069,11 @@ directly are bound to default values in the file sdcdbsrc.el. The variables are listed below, these values maybe changed as required. -* sdcdbsrc-cpu-type '51 + sdcdbsrc-cpu-type '51 -* sdcdbsrc-frequency '11059200 + sdcdbsrc-frequency '11059200 -* sdcdbsrc-serial nil + sdcdbsrc-serial nil The following is a list of key mapping for the debugger interface. @@ -3144,9 +3144,9 @@ Toggle list mode ;; -8 Other Processors + Other Processors -8.1 The Z80 and gbz80 port + The Z80 and gbz80 port SDCC can target both the Zilog Z80 and the Nintendo Gameboy's Z80-like gbz80. The port is incomplete - long support is @@ -3163,7 +3163,7 @@ 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. -9 Support + Support SDCC has grown to be a large project. The compiler alone (without the preprocessor, assembler and linker) is about @@ -3177,7 +3177,7 @@ SDCC users. There are lots of ways to contribute, and we encourage you to take part in making SDCC a great software package. -9.1 Reporting Bugs + Reporting Bugs Send an email to the mailing list at 'user-sdcc@sdcc.sourceforge.net' or 'devel-sdcc@sdcc.sourceforge.net'. Bugs will be fixed @@ -3188,7 +3188,7 @@ code, this can be very helpful. Compiling your program with the --dumpall option can sometimes be useful in locating optimization problems. -10 Acknowledgments + Acknowledgments Sandeep Dutta (sandeep.dutta@usa.net) - SDCC, the compiler, MCS51 code generator, Debugger, AVR port diff --git a/doc/test_suite_spec.pdf b/doc/test_suite_spec.pdf new file mode 100644 index 0000000000000000000000000000000000000000..4e79e9891212e95b2f15187d5f372b462fbeae7a GIT binary patch literal 16017 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 literal 0 HcmV?d00001 diff --git a/doc/test_suite_spec.txt b/doc/test_suite_spec.txt new file mode 100644 index 00000000..47bf4965 --- /dev/null +++ b/doc/test_suite_spec.txt @@ -0,0 +1,298 @@ + + +Proposed Test Suite Design + +Michael Hope (michaelh@juju.net.nz) + + + +Abstract + +This article describes the goals, requirements, and suggested +specification for a test suite for the output of the Small +Device C Compiler (sdcc). Also included is a short list +of existing works. + + Goals + +The main goals of a test suite for sdcc are + + To allow developers to run regression tests to check that + core changes do not break any of the many ports. + + To verify the core. + + To allow developers to verify individual ports. + + To allow developers to test port changes. + +This design only covers the generated code. It does not cover +a test/unit test framework for the sdcc application itself, +which may be useful. + +One side effect of (1) is that it requires that the individual +ports pass the tests originally. This may be too hard. See +the section on Exceptions below. + + Requirements + + Coverage + +The suite is intended to cover language features only. Hardware +specific libraries are explicitly not covered. + + Permutations + +The ports often generate different code for handling different +types (Byte, Word, DWord, and the signed forms). Meta information +could be used to permute the different test cases across +the different types. + + Exceptions + +The different ports are all at different levels of development. +Test cases must be able to be disabled on a per port basis. +Permutations also must be able to be disabled on a port +level for unsupported cases. Disabling, as opposed to enabling, +on a per port basis seems more maintainable. + + Running + +The tests must be able to run unaided. The test suite must +run on all platforms that sdcc runs on. A good minimum may +be a subset of Unix command set and common tools, provided +by default on a Unix host and provided through cygwin on +a Windows host. + +The tests suits should be able to be sub-divided, so that +the failing or interesting tests may be run separately. + + Artifcats + +The test code within the test cases should not generate artifacts. +An artifact occurs when the test code itself interferes +with the test and generates an erroneous result. + + Emulators + +sdcc is a cross compiling compiler. As such, an emulator +is needed for each port to run the tests. + + Existing works + + DejaGnu + +DejaGnu is a toolkit written in Expect designed to test an +interactive program. It provides a way of specifying an +interface to the program, and given that interface a way +of stimulating the program and interpreting the results. +It was originally written by Cygnus Solutions for running +against development boards. I believe the gcc test suite +is written against DejaGnu, perhaps partly to test the Cygnus +ports of gcc on target systems. + + gcc test suite + +I don't know much about the gcc test suite. It was recently +removed from the gcc distribution due to issues with copyright +ownership. The code I saw from older distributions seemed +more concerned with esoteric features of the language. + + xUnit + +The xUnit family, in particular JUnit, is a library of in +test assertions, test wrappers, and test suite wrappers +designed mainly for unit testing. PENDING: More. + + CoreLinux++ Assertion framework + +While not a test suite system, the assertion framework is +an interesting model for the types of assertions that could +be used. They include pre-condition, post-condition, invariants, +conditional assertions, unconditional assertions, and methods +for checking conditions. + + Specification + +This specification borrows from the JUnit style of unit testing +and the CoreLinux++ style of assertions. The emphasis is +on maintainability and ease of writing the test cases. + + Terms + +PENDING: Align these terms with the rest of the world. + + An assertion is a statement of how things should be. PENDING: + Better description, an example. + + A test point is the smallest unit of a test suite, and + consists of a single assertion that passes if the test + passes. + + A test case is a set of test points that test a certain + feature. + + A test suite is a set of test cases that test a certain + set of features. + + Test cases + +Test cases shall be contained in their own C file, along +with the meta data on the test. Test cases shall be contained +within functions whose names start with 'test' and which +are descriptive of the test case. Any function that starts +with 'test' will be automatically run in the test suite. + +To make the automatic code generation easier, the C code +shall have this format + + Test functions shall start with 'test' to allow automatic + detection. + + Test functions shall follow the K&R intention style for + ease of detection. i.e. the function name shall start + in the left column on a new line below the return specification. + + Assertions + +All assertions shall log the line number, function name, +and test case file when they fail. Most assertions can have +a more descriptive message attached to them. Assertions +will be implemented through macros to get at the line information. +This may cause trouble with artifacts. + +The following definitions use C++ style default arguments +where optional messages may be inserted. All assertions +use double opening and closing brackets in the macros to +allow them to be compiled out without any side effects. +While this is not required for a test suite, they are there +in case any of this code is incorporated into the main product. + +Borrowing from JUnit, the assertions shall include + + FAIL((String msg = "Failed")). + Used when execution should not get here. + + ASSERT((Boolean cond, String msg = "Assertion + failed"). Fails if cond is false. Parent to REQUIRE + and ENSURE. + +JUnit also includes may sub-cases of ASSERT, such as assertNotNull, +assertEquals, and assertSame. + +CoreLinux++ includes the extra assertions + + REQUIRE((Boolean cond, String msg = "Precondition + failed"). Checks preconditions. + + ENSURE((Boolean cond, String msg = "Postcondition + failed"). Checks post conditions. + + CHECK((Boolean cond, String msg = "Check + failed")). Used to call a function and to check + that the return value is as expected. i.e. CHECK((fread(in, + buf, 10) != -1)). Very similar to ASSERT, but the function + still gets called in a release build. + + FORALL and EXISTS. Used to check conditions within part + of the code. For example, can be used to check that a + list is still sorted inside each loop of a sort routine. + +All of FAIL, ASSERT, REQUIRE, ENSURE, and CHECK shall be +available. + + Meta data + +PENDING: It's not really meta data. + +Meta data includes permutation information, exception information, +and permutation exceptions. + +Meta data shall be global to the file. Meta data names consist +of the lower case alphanumerics. Test case specific meta +data (fields) shall be stored in a comment block at the +start of the file. This is only due to style. + +A field definition shall consist of + + The field name + + A colon. + + A comma separated list of values. + +The values shall be stripped of leading and trailing white +space. + +Permutation exceptions are by port only. Exceptions to a +field are specified by a modified field definition. An exception +definition consists of + + The field name. + + An opening square bracket. + + A comma separated list of ports the exception applies for. + + A closing square bracket. + + A colon. + + The values to use for this field for these ports. + +An instance of the test case shall be generated for each +permutation of the test case specific meta data fields. + +The runtime meta fields are + + port - The port this test is running on. + + testcase - The name of this test case. + + function - The name of the current function. + +Most of the runtime fields are not very usable. They are +there for completeness. + +Meta fields may be accessed inside the test case by enclosing +them in curly brackets. The curly brackets will be interpreted +anywhere inside the test case, including inside quoted strings. +Field names that are not recognised will be passed through +including the brackets. Note that it is therefore impossible +to use some strings within the test case. + +Test case function names should include the permuted fields +in the name to reduce name collisions. + + An example + +I don't know how to do pre-formatted text in LaTeX. Sigh. + +The following code generates a simple increment test for +all combinations of the storage classes and all combinations +of the data sizes. This is a bad example as the optimiser +will often remove most of this code. + +/** Test for increment. + +type: char, int, long + +Z80 port does not fully support longs (4 byte) + +type[z80]: char, int + +class: "", register, static */ + +static void + +testInc{class}{types}(void) + +{ + +{class} {type} i = 0; + +i = i + 1; + +ASSERT((i == 1)); + +} diff --git a/doc/widearticle.cls b/doc/widearticle.cls deleted file mode 100644 index 36e74c3c..00000000 --- a/doc/widearticle.cls +++ /dev/null @@ -1,15 +0,0 @@ -% Simple extension of atricle which wides the margins. -% $Id$ -\NeedsTeXFormat{LaTeX2e} -\ProvidesClass{widearticle} -\LoadClass{article} - -\setlength{\oddsidemargin}{0pt} -\setlength{\evensidemargin}{0pt} - -\setlength{\textwidth}{\paperwidth} -\addtolength{\textwidth}{-2in} -\setlength{\textheight}{\paperheight} -\addtolength{\textheight}{-2in} - -\setlength{\parindent}{0pt} -- 2.47.2

/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

Interrupt #	Description	Vector Address
0	External 0	0x0003
1	Timer 0	0x000B
2	External 1	0x0013
3	Timer 1	0x001B
4	Serial	0x0023