Make your own free website on Tripod.com

prc-tools 20 installation

Step Description Directory structure after step
Prepare system for installation.
  • If you have prc-tools 0.5.0 installed, it would probably be wise to remove it. The version of cygwin1.dll in that version may conflict with the one needed for this version. Version 0.5.0 also defined a GCC_EXEC_PREFIX environment variable, which will cause the GCC in this version to fail, so you should ensure this variable is not set.
  • On Win9x Systems please add the following command to your config.sys.
    SHELL=c:\dos\command.com /E:2048 /P
    You will increase the environmental space for environment variables you will get during the installation. Please reset your PC after this change !!
  • Select drive for installation (it could be any C,D,...). In our example we will use C. Create directory C:\PalmDev. This directory will be our main directory, and all things we install will be in.
C:\PalmDev
Install Cygwin Prc-tools uses Cygwin b20.1, and you need to install this before installing prc-tools. You have a couple of options here:
  • A full Cygwin install (14 Mb) gives you the DLL you need and a number of Windows development tools, including a native Cygwin GCC. (If you are using Handspring's GCC tools, this is the same as the cygwin_b20.1.exe you have already installed for those.)
  • If you don't need all those tools and don't want to waste the space, a user tools only Cygwin (3 Mb) contains the basic tools you need. The only tool missing compared to the full install is make (55 Kb), which you may want to add to your Cygwin H-i586-cygwin32\bin directory.
(If you're interested, Cygwin source code is available.)

Download: cygwin-b20.1-full.exe
Install to:  C:\PalmDev\cygwin

Add to Autoexec.bat PATH:
c:\PalmDev\cygwin\cygwin-b20\H-i586-cygwin32\BIN

C:\PalmDev
C:\PalmDev\cygwin
Install prc-tools You are now ready to install prc-tools 2.0 (7 Mb). You have options to install the tool chain itself, tools documentation in HTML format, and some sample applications

Download: prc-tools-2.0.exe
Install to: C:\PalmDev\PRC-Tools

During installation install all components, and select destination directory to C:\PalmDev\PRC-Tools but, please accept all defaults during the rest of the setup process.

Add to Autoexec.bat PATH:
c:\PalmDev\PRC-Tools\H-i586-cygwin32\BIN
C:\PalmDev
C:\PalmDev\cygwin
C:\PalmDev\PRC-Tools
C:\PalmDev\doc
C:\PalmDev\include
C:\PalmDev\lib
C:\PalmDev\samples
Install SDK 3.5 You will also need a Palm OS SDK. You should install whichever SDKs you wish to use into our main directory.

Download: sdk35-prc.zip
Install to: C:\PalmDev 
C:\PalmDev
C:\PalmDev\cygwin
C:\PalmDev\PRC-Tools
C:\PalmDev\doc
C:\PalmDev\include
C:\PalmDev\lib
C:\PalmDev\samples
C:\PalmDev\sdk-3.5
Optional install earlier SDKs (1, 2, 3.1) 
(Optional)
In addition to installing the compiler and other tools, you'll need to install a Palm OS SDK to compile applications. SDK version 3.5 works with this version of prc-tools.

However, earlier SDKs require slight modifications to work with prc-tools. You can download suitably modified version 1, 2, and 3.1 SDKs here, formatted for Windows

Download: palmos-1-2-3.1-sdks-1.zip
Unzip to: C:\PalmDev

C:\PalmDev
C:\PalmDev\cygwin
C:\PalmDev\PRC-Tools
...
C:\PalmDev\sdk-3.5
C:\PalmDev\sdk-1
C:\PalmDev\sdk-2
C:\PalmDev\sdk-3.1
Install PilRC You will need PilRC for compiling resources.

Download: pilrc_w32.zip
Unzip to: C:\PalmDev 
Rename: C:\PalmDev\pilrc_w32 to C:\PalmDev\pilrc

Add to Autoexec.bat PATH:
c:\PalmDev\pilrc
C:\PalmDev
C:\PalmDev\cygwin
C:\PalmDev\PRC-Tools
...
C:\PalmDev\sdk-3.5
C:\PalmDev\sdk-1
C:\PalmDev\sdk-2
C:\PalmDev\sdk-3.1
C:\PalmDev\pilrc
Install Emulator POSE
(Optional)
This options is not necessary for start, but you will need POSE for debugging. 

Download: emulator-win.zip for Windows
unzip to: C:\PalmDev\Emulator

Download: emulator_skins_14.zip for Windows
Unzip to: C:\PalmDev\Emulator\Skins_v1.4

Obtain ROM Image Files
For legal reasons, you must sign an agreement with Palm Inc. to download ROM images. To obtain the Prototype License and Confidentiality Agreement, you must be a member of the Alliance Program. After joining the Alliance Program, we recommend that you join the Developer Seeding Program, which requires that you return a signed agreement to us. This allows you to access ROM images and other valuable prerelease information. If you are based in the USA, you may also obtain images using a "clickwrap" agreement that does not require a signed agreement.
C:\PalmDev
C:\PalmDev\cygwin
C:\PalmDev\PRC-Tools
...
C:\PalmDev\pilrc
...
C:\PalmDev\Emulator
C:\PalmDev\Emulator\Skins_v14
Install SDK Documentation
(Optional)
Downloadable Documentation
Acrobat Reader 4.x is required for downloadable documentation unless otherwise specified. Choose the Search option if you want faster searches.

Browsable Documentation
Browse Palm OS documentation or the "Palm Programming: The Developer's Guide" web preview. See below for other web-based documentation. For fast web-based searching of developer information, use the Knowledge Base.

Palm OSŪ Software Documentation
Download for Windows  The reference of all Palm OSŪ functions and data structures, conceptual and "how-to" development information, and search index files. Covers Palm OS software versions up to and including 3.5. See the instructions for search indexes. You can also browse or download HTML versions.

Download: palmos35docs.zip
Unzip to:
C:\PalmDev\Palm OS 3.5 SDK Documentation

C:\PalmDev
C:\PalmDev\cygwin
C:\PalmDev\PRC-Tools
C:\PalmDev\doc
C:\PalmDev\include
C:\PalmDev\lib
C:\PalmDev\samples
C:\PalmDev\sdk-3.5
C:\PalmDev\sdk-1
C:\PalmDev\sdk-2
C:\PalmDev\sdk-3.1
C:\PalmDev\pilrc
C:\PalmDev\Emulator
C:\PalmDev\Emulator\Skins_v14
C:\PalmDev\Palm OS 3.5 SDK Documentation
Install SDK Examples (Optional) Examples

Source code for: Memo, MineHunt, NetSample, Puzzle, Reptoids, RockMusic, SampleCalc, SampleLib, SubHunt, ToDo, Address, Beamer, Datebook, DotDotTwo, DrMcCoy, Expense, Finger, Formats, HardBall, and Mail. Note: there is an error in Puzzle's GCC Makefile: remove refs to PuzzleRsc.c and .o.

Download: sdk35-examples.zip
Unzip to:
C:\PalmDev\Palm OS 3.5 SDK Examples
C:\PalmDev
C:\PalmDev\cygwin
C:\PalmDev\PRC-Tools
...
C:\PalmDev\Palm OS 3.5 SDK Examples
Installing PilotMAG
Steps Description Directory
Install PilotMAG Now, you are ready to install PilotMAG. We will follow our start up logic and install PilotMAG in our main directory C:\PalmDev\PilotMAG.

Download: pmag_37.zip
Install to:
C:\PalmDev\PilotMAG
C:\PalmDev
C:\PalmDev\cygwin
C:\PalmDev\PRC-Tools
...
C:\PalmDev\PilotMAG
Set PilotMAG Environment Options. Start PilotMAG and from tool menu choice: Environment options.
  • Select Tools tab:
    - Enter path to Emulator: C:\PalmDev\Emulator\Emulator.exe
  • Select gcc... tab:
    - Enter -Os -palmos3.5 -g in Parameters (Pass 1) ***
    - Select "prc-tools 2.0"
    - Uncheck "Multiple code resource". This you may need later.
  • Select API Help tab:
    - For Help location use: "C:\PalmDev\PilotMAG\Palm1.hlp"
    - For PDF location use: "C:\PalmDev\Palm OS 3.5 Dev Documentation\"

Now you are ready to create a first Palm program.

*** This parameters is for SDK-35/prc-tools 20. If you want to use any of earlier version of SDK enter in (Pass 1) -Palmos1, -Palmos2 or -Palmos3.1 for desired SDK version

 
Quick Start From PilotMAG Menu|File open project and select directory:
C:\PalmDev\PilotMAG\Samples\Sample1 and open project: GotoForm.ppp

or follow steps to new simple project.
 
Tips
Problem Solution
installation problem, cannot exec `cpp' installation problem, cannot exec `cpp'

Probably this problem is produced from one of your previous installation or by your system specific. To solve this problem try to properly mount your directory's.

- Type "mount" on your MS-DOS command line. Assuming the above setup they should look like this:

Device                                            Directory    Type    Flags
C:\PalmDev\PRC-Tools                              /prc-tools   native  text!=binary
C:\PalmDev\cygwin\cygwin-b20\H-i586-cygwin32\bin  /bin         native  text!=binary
C:\PalmDev                                        /PalmDev     native  text!=binary
C:                                                /            native  text!=binary

If any of the mount points don't match up, use umount to remove the bad mount point then remount (ignore any missing directory errors). This is probably what broke in your setup. 

Example how to "mount" and "umount":

u
mount /prc-tools
mount C:\PalmDev\PRC-Tools /prc-tools

Tip: In PilotMAG 4.0 user can exactly specify a path for executables (PILRC, GCC) so, user can by pass Autoexec.bat PATH set. The PATH environment value in Autoexec.bat could be changed (remove any item associated to prc-tools or Cygwin). Be caerfull still this PATH is needed for make and any calls to GCC out PilotMAG.