SDCC: Difference between revisions

From OLPC
Jump to navigation Jump to search
Line 65: Line 65:
file with extension .lnk. You can view this file to troubleshoot linking problems such as those arising from missing
file with extension .lnk. You can view this file to troubleshoot linking problems such as those arising from missing
libraries.
libraries.
== Additional Libraries ==

Some reusable routines may be compiled into a library. 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 Exmain.c and a library Exlib.lib in the directory mylib (if that is not the same as your current project):

sdcc Exmain.c Exlib.lib -L mylib

''Note here that mylib must be an absolute path name''.
The most efficient way to use libraries is to keep separate modules in separate 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. (For me <installdir> = /usr)



=== Related Documentation ===
=== Related Documentation ===
Line 71: Line 85:


/usr/share/sdcc/include/mcs51/
/usr/share/sdcc/include/mcs51/

Some .c examples

/usr/share/sdcc/lib/src


== SDCDB ==
== SDCDB ==

Revision as of 23:10, 9 June 2007

SDCC is a small Device C Compiler that was specifically designed to the needs of 8 Bit Micros like Intel 8051, Maxim 80DS390, Zilog Z80 among others. SDCC comes with SDCDB a source level debugger and ucSim a free open source simulator for Intel 8051 and other micro-controllers

Installation

Debian

apt-get install sdcc

Working with SDCC

Compiling a program

Write this in an ASCII editor and call the archive test.c (Or wathever name you want):

char test;
void main(void) {
   test=0;
}

Then:

sdcc -c test.c

The -c option is for disable the linker, the next step is trying without the linker:

sdcc test.c

Final test, modify the test file and include the following (if all goes without warnings SDCC is well instaled):

#include <string.h>
char str1[10];
void main(void) {
 strcpy(str1, "testing");
}

this is needed to test that SDCC supports libraries.

For OLPC we are going to work with the 8051 processor, for single source file 8051 projects you can Compile your programs with the following command:

sdcc sourcefile.c   

When doing this command the 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 or sourcefile.o - Object file created by the assembler, input to Linkage editor
  • sourcefile.map - The memory map for the load module, created by the Linker
  • sourcefile.mem - A file with a summary of the memory usage
  • sourcefile.ihx - The load module in Intel hex format (you can select the Motorola S19 format with --out-fmt-s19. If you need another format you might want to use objdump or srecord).
  • sourcefile.adb - An intermediate file containing debug information needed to create the .cdb file (with --debug)
  • sourcefile.cdb - An optional file (with --debug) containing debug information.
  • sourcefile. - (no extension) An optional AOMF or AOMF51 file containing debug information (generated with option --debug). The (Intel) absolute object module format is a sub-format of the OMF51 format and is commonly used by third party tools (debuggers, simulators, emulators).
  • sourcefile.dump* - Dump file to debug the compiler itself (generated with option --dumpall)

Multiple Source file proyects

SDCC can compile only ONE file at a time. For example assume that you have a project containing the following files:

  • Ex1.c (contains some functions)
  • Ex2.c (contains some more functions)
  • Exmain.c (with more functions and the function main)

The first two files will need to be compiled separately with the commands:

  • sdcc -c Ex1.c
  • sdcc -c Ex2.c

Then compile the source file containing the main() function and link the files together with the following command: sdcc Exmain.c Ex1.rel Ex2.rel Alternatively, Exmain.c can be separately compiled as well:

  • sdcc -c Exmain.c
  • sdcc Exmain.rel Ex1.rel Ex2.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. The linker is invoked from SDCC using a script file with extension .lnk. You can view this file to troubleshoot linking problems such as those arising from missing libraries.

Additional Libraries

Some reusable routines may be compiled into a library. 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 Exmain.c and a library Exlib.lib in the directory mylib (if that is not the same as your current project):

sdcc Exmain.c Exlib.lib -L mylib

Note here that mylib must be an absolute path name. The most efficient way to use libraries is to keep separate modules in separate 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. (For me <installdir> = /usr)


Related Documentation

If you want to see more documentation specifically for the 8051 try this file:

/usr/share/sdcc/include/mcs51/

Some .c examples

/usr/share/sdcc/lib/src

SDCDB

Compilling for Debugging

--debug When this option is used the compiler will generate debug information. The debug information collected in a file with .cdb extension can be used with the SDCDB. Another file with no extension contains debug information in AOMF or AOMF51 format which is commonly used by third party tools.

Ucsim

Links