PV32.txt                                                    October 29, 1999

This file documents the steps typically required when developing applications
for the Xplor-52 controllers using the Advanced Development System from
Franklin Software, Inc.

Also included are installation, pathname, filename, etc., assumptions and
hints so you can build your projects with the same parameters as the examples
published by Blue Earth Research.

-------------------------------------------------------------------------------

GETTING STARTED:

First install the Franklin Software, Inc., development tools. The default
installation will put all of the tools, examples, etc., in the C:\FSI\
directory. The executables will be in the \BIN\ directory, the include files
will be in the \INC\ directory, etc. The sample projects and source files are
all located in the \PROJECTS\ directory. If you want your setup to be the same
as the examples included here, you should create the \PROJECTS\ directory and
put all your source files and project files there.

-------------------------------------------------------------------------------

PROJECT FILES:

All of the C51 projects are built using a Project file (filename.PRJ) that
keeps track of the source files, memory map, compiler settings, etc. The
default settings can be used for most projects. However, the examples shown
here include the following changes:

C51:

    Memory Model = Small
    ROM = Small

These settings assume that the files and functions use a minimum of code
space. If your projects require more space, you can always bump these up.

    Pagewidth = 96

This makes the list files easier to read and format for printing.

A51:

    Pagewidth = 96

This makes the list files easier to read and format for printing.

L51:

    Ramsize = 256

Since we are using the 80C32 or 89C52 (or equivalent), the default of 128 can
be changed to 256 bytes.

    IntelHex = 1

Selecting this box causes the linker to create an Intel Hex file as part of
the process of building the project. If this box is not checked, the linker
will stop after creating an absolute object module. This file can be used for
debugging with a simulator, but you need to create a hex file to program
your Xplor controller.

    Pagewidth = 96

This makes the map files easier to read and format for printing.

-------------------------------------------------------------------------------

CREATING A PROJECT:

The following steps are required to build a project for your Xplor PDC. You
can follow these steps to create your own project. You may want to start out
by using the Hello52 project and then trying it on your own after you are
comfortable with the process.

1.  Run the ProView (PV32) program.
2.  Select the PROJECT menu and then NEW.
3.  Type or select a name and directory for your project. You may want to
    create a new directory for your project files, e.g., C:\FSI\PROJECT\.
4.  Select the PROJECT menu and then ADD FILE.
5.  Select the file HELLO52.C.

Now that you have created and edited your project, you may want to SAVE your
project file at this point. You could also edit the project options to specify
the options documented above.

After you are satisfied with the option settings,

6.  Select PROJECT and then MAKE.

You should now have a hex file that you can load to your Xplor controller.

7.  Establish serial communications with your Xplor controller. You may want
to open a DOS window and run the TB-QComm program.

8.  Upload the hex file to the controller.

Since the Xplor-52 controllers have TB52 in the CPU ROM, hex files may be
loaded to any valid EEPROM address.

9.  Remove power from the Xplor controller, move the EA jumper from the 1-2
    position to the 2-3 position, and restore power to the unit.

TB52 is now gone and you program will be executed on reset. To return to TB52
in the standard configuration, remove power and move the EA jumper back to the
1-2 position.