Step

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": umount /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.