Silicon Laboratories Si4012, Руководство по программированию

Страница: 10 / 30

A N 7 4 6
10 Rev. 0.1
5. Sample Projects
Several complete sample projects are provided in the AN746SW.zip file available at www.silabs.com .
5.1. General Project Structure
All the sample projects have a unified structure and common driver set. This chapter gives the reader a brief
introduction of the structure of the sample projects.
5.1.1. Prerequisites
The settings in the sample project files assume that some Silicon Labs or third party software tools are already
installed on the PC where the sample project going to be compiled. The tools need to be installed depends on the
functionality to be used. The following list contains a complete set of such programs:
 Silicon Laboratories IDE—
Used to open the preconfigured project files and manage the build process.
 Keil C51 v9.0+
or
SDCC v3.0+—
Compilers to use in accordance with the Silicon Laboratories IDE to
manage build process.
 Silicon Labs Flash Programming Utility (optional)—
Needed only if programming outside the Silicon
Labs IDE is necessary.
 Make (optional)—
This tool is needed in case other compiler is used, or the build process takes place
outside of the SiLabs IDE.
5.1.2. Supported Compilers
The projects come with two SiLabs IDE project file. The one that name ends with “_Keil” contains the settings for
and is appropriate to compile with Keil’s C51 tool chain. The other that ends with “_SDCC” is prepared to use the
SDCC compiler tool chain. Please note, if you use the 2k limited evaluation license for Keil’s C51 compiler, you
may need to unlock it to 4k, as some project's size exceeds the 2k code size limit.
However, the sample projects can be complied not only with the two mentioned compiler, but with almost any ANSI
C compiler for 8051 architecture with little or no modifications.
Each project already contains a “Makefile” in order to provide an easy and convenient way to compile the code
outside the Silicon Labs’ IDE with the toolchain of choice.
Each sample project described in this document contains a compiled version of the source code in Intel hex format
that is widely supported by a variety of programming and debugging tools. The compiled file in the projects has
been generated using the SiLabs IDE and the Keil C51 tool chain.
5.1.3. Directory Structure
All sample project has a common directory structure, with separated source and project files in order to ease the
understanding of the individual modules. For every sample project the following directories and files can be found
in the main directory:
 bin
—Contains the SiLabs project files for Keil and SDCC compilers and the Makefile if the make tool is
used instead.
 doc
—Doxygen generated documentation based on comments inside the source files in html format.
 out
—The outputs of the compilation process come to this folder. After successful compilation, this directory
contains for example the hex file, the linker output and the OMF file.
 src

application

drivers
Directories containing the source files.
 Doxyfile
—In this file, the Doxygen documentation generator settings can be found.
 Cleanup.bat
—Batch file used to delete all files generated during build process.