Porting Libse To A New Target Platform - Epson S1D13506 Technical Manual

Page 150

14.3 Porting LIBSE to a new target platform

HelloApp
S1D13506
X25B-G-003-04
Building Epson applications like a simple HelloApp for a new target platform requires 3
things, the HelloApp code, the 13506HAL library, and a some standard C functions
(portable ones are encapsulated in our mini C library LIBSE).
Figure 14-1: Components needed to build 13506 HAL application
For example, when building HELLOAPP.EXE for the x86 16-bit platform, you need the
HELLOAPP source files, the 13506HAL library and its include files, and some Standard C
library functions (which in this case would be supplied by the compiler as part of its run-
time library). As this is a DOS .EXE application, you do not need to supply start-up code
that sets up the chip selects or interrupts, etc... What if you wanted to build the application
for an SH-3 target, one not running DOS?
Before you can build that application to load onto the target, you need to build a C library
for the target that contains enough of the Standard C functions (like sprintf and strcpy) to
let you build the application. Epson supplies the LIBSE for this purpose, but your compiler
may come with one included. You also need to build the 13506HAL library for the target.
This library is the graphics chip dependent portion of the code. Finally, you need to build
the final application, linked together with the libraries described earlier. The following
examples assume that you have a copy of the complete source code for the S1D13506
utilities, including the nmake makefiles, as well as a copy of the GNU Compiler v2.7-96q3a
for Hitachi SH3. These are available on the Epson Electronics America Website at
http://www.eea.epson.com.
HelloApp Source code
C Library Functions (LIBSE for embedded platforms)
13506HAL Library
Epson Research and Development
Vancouver Design Center
Programming Notes and Examples
Issue Date: 02/03/21