So you want to compile iRogue...

I assume you're here because you've seen on the iRogue page that source code is available, and for some twisted reason you want it.

Here's the source: iRogue-src.tar.gz

Here's what you need to compile it...

I'll assume you have a computer running Linux with some space to put all this development stuff. (If this is not the case, you may have to do some extra work. I will not be able to help you with it.) Here are links to the stuff you need to install.

Install the regular GNU Pilot SDK

You can pretty much follow the instructions at http://elf.org/pilot/develop.html. They are still up to date. (Download three tarballs... uncompress the prc-tools tarball... edit PREFIX and GNUARCH in the prc-tools Makefile...)

However, the PilRC included with prc-tools-0.5.0 is an old version. You will want the most recent version (2.3a the last time I checked) available at http://www.scumby.com/scumbysoft/pilot/pilrc/index.htm.

Download the PilRC source code, which should compile "as is" for Linux. You can put it in prc-tools-0.5.0/pilrc2.3a and change the prc-tools Makefile

PILRCDIR = pilrc2.3a
and also
$(PILRCDIR)/pilrc:
	cd $(PILRCDIR) ; make pilrc

(Ok, now you can "make doeverything" using the prc-tools Makefile.)

Note: If you install somewhere other than /usr/local/pilot, you should change a couple of lines in the iRogue Makefile that refer to that location, e.g.

CRT0 = /usr/local/pilot/m68k-palmos-coff/lib/crt0.o

Because iRogue is kinda bloated...

- iRogue.prc contains two 32k code segments

You must increase the coderes size in pilot.ld! Change it to read LENGTH = 65535. (This will allow you enough space for the two up-to-32k segments instead of one.)

(I installed to /usr/local/pilot, so mine is located at /usr/local/pilot/lib/gcc-lib/m68k-palmos-coff/2.7.2.2-kgpd-071097/pilot.ld)

You can read about how the two-32k-segments trick works at http://www.geocities.com/SiliconValley/Lab/9981/gcctech.htm.

- it also has a GLib shared library

The GLib page is at http://www.isaac.cs.berkeley.edu/pilot/GLib/GLib.html. You don't need to do anything, but it is there if you want to read about it.

Two more things to install

xcopilot is a Unix/X11 PalmPilot emulator. The xcopilot page is at http://xcopilot.cuspy.com/; it should have everything you need. Version was 0.6.6 last time I checked. (I hear that it is now a PITA to download a ROM from palm.com; an alternative is to use the pilot-link tools to read the ROM from your own PalmPilot.)

You'll probably want the pilot-link tools also, to allow you to install files on an actual PalmPilot. (Perhaps you have them already.) Version was up to 0.9.3 last time I checked. There should be a link you can follow from http://elf.org/pilot/develop.html.

Download iRogue source code

Ok. You can download the iRogue source code and try to compile it now. (First 'make' in the Lib directory, then 'make' in the main directory. This should produce a new iRogue_Library.prc and iRogue.prc. Try loading them in xcopilot and see if the application works. As I noted on the main iRogue page, you'll probably need to start up xcopilot with a "serial port" to load iRogue.prc.)

Bridget Spitznagel
Last modified: Thu Jun 24 19:52:34 EDT 1999