C Language Development Kit/Getting started/Installation of the development system

From OptiWiki

Jump to: navigation, search


System requirements

The development system runs on Intel and AMD platforms, with modest system requirements. In order to use the C development system you need:

  • PC with Microsoft Windows 95, 98, NT, 2000 or XP operating system.
  • Free Hard disk space required: 5 MB minimum for C-library
  • For OPH100x, an additional 250MB is required for the compiler, for the other terminals this is just 10MB.
  • CD-ROM drive

Start the installation program

Insert the CD into the CD-ROM player and wait for a welcome message. If this message does not pop up, then you have to manually execute the install program. To do this, follow the steps below:

  • Press the start button.
  • Press "Run..."
  • The following dialog box will appear, where you have to type the drive-name of your CD-ROM player (i.e. 'D:\') and the name of the installation program, which is called "autostart".
  • Note that in this example the CD-ROM drive is D: When your CD drive is not the D: drive, then you have to change this accordingly.

The install program lets you install the various tools and utilities that are required for developing your terminal applications. The program allows you to select the tools to be installed. What you normally need is the program called 'Appload' and the 'Opticon C-Development system', but the user is free to install whatever packages he prefers. Simply follow the instructions on your screen to install the selected packages.

In case of the OPH100x development system, the compiler is also installed with the install program. The compiler package is a slightly modified version of the WinARM package. The only difference is the stdio.h include file, which is optimized for the OPH100x operating system. For the other development systems, you have to specify where the compiler is located, so make sure that you install the compiler first.
In case of the Toshiba compiler, you have to select the location of the T900 directory, this is the 'root' of the compiler package, and not the 'BIN' directory. For the Microtec compiler, you must select the directory where the MCCM77.EXE file is located.

Appload is a windows program that is required for loading the applications onto the terminal. The so called 'Opticon C-Development system' is a collection of MS-DOS batch files and C-language header files that allows you to compile and link your applications for the target terminal that you have selected.

Batch file that builds the applications

The 'Opticon C-development system' installation creates a batch file that you can call to build an application. The name of the batch file depends on the handheld terminal type that you have selected during the installation of the development system. The name will be: Mxxx.BAT, where xxx represents the three or four letter code of the terminal type. (See the table below)

For example, for the PHL1700 1 MB (three letter code CBG), the batch file will be named: MCBG.BAT. Similarly, for the PHL2700 RF/DC the batch file will be named MRFDC.BAT. By giving different names to the batch file for each terminal, it is possible to make one directory in which you develop applications for several handheld terminals. If you have only one type of terminal, it might be more convenient to rename the file into M.BAT.

The following three or four letter codes of the terminal type are defined:

Code Terminal
XBC OPH1004 and H13
CBG PHL1700-1Mb
CBH PHL1700-2Mb
RFDC PHL2700 with RFDC module
RFID PHL2700 with RFID module
LBB OPL97xx and DCL153x


The development system supports three compilers. One for the OPH100x and H13, one for PHL and DWT terminals and one for the OPL97xx and DCL153x terminals.

Compiler for OPH100x and H13 terminals

Applications for these terminals can be developed with the ARM version of the open source gcc compiler. This compiler is part of the WinARM package, that is included in this development system. You can find the documentation for this compiler in the C:\WinARM\doc directory.

Compiler for PHL and DWT terminals

Applications for these terminals can be developed with the Microtec™ Research's Software Development Tools MCCM77 C Compiler package version 2.2. Please read the documentation supplied with this package to see how to install it.

Compiler for OPL97xx and DCL153x terminals

Applications for these terminals can be developed with the Toshiba Development Tool TMS900 C Compiler package. Please read the documentation supplied with this package to see how to install it.

Personal tools