Program Structure; Ar1688 Program Directory; Bin Directory; Doc Directory - PalmMicro AR1688 Development Manual

C o m m u n i c a t i o n s , I n c .

1 Program Structure

We provide software API for all AR1688 IP phone authorized manufacturers and end
users. The API includes part of source codes and part of object files. Those source codes
are provided under GPL license. Based on the API, users can make their own customized
upgrade binary files for their IP phones. We do not provide fully open source software
because we do not encourage those implementations to be transferred to another chip to
compete with AR1688.
To understand the API better, I am going to list details and add explanations below. The
API is provided as SDCC.rar file. It will decompress SDCC directory and files. We assume
SDCC directory is decompressed to disk C:. If it is not, you will need to change the first
line of sdcc\src\makefile.

AR1688 Program Directory

Currently there are following 6 directories under SDCC.

Bin Directory

The directory includes: SDCC open source compiler binary files and our own special tools
binary files. We are using SDCC 2.7.0 steady version. You can also download those files
directly from SDCC official website (http://sdcc.sourceforge.net/). The SDCC.exe is
smaller than the official website one because we only compiled Z80 part in the .exe file.
GNU make.exe utility is also here.

Doc Directory

.txt files. There are some illustrative files in this directory.

Include Directory

.h files. We only use SDCC compiler, do not use any include and library files from the
official SDCC. All .h files are written by ourselves, there might be small difference of
parameters compared with standard c runtime routines. And not all c runtime routines are
included, only those needed are there. We are doing this for performance.

lib Directory

It is not actually "library" file, instead, there are object files in this directory, those object
files are compiled from those source files which are not in API source code, and are to be
linked together with other files in link stage. Same as "include", there are no standard
SDCC library used in our project.

mcs51 Directory

4
PalmMicro Communications, Inc.
© 2006-2007
Room 0611, Bldg.B Tsinghua Tongfang Technology Plaza, 1 Wangzhuang Road, Beijing, CHINA