Ross has worked really hard on the latest release of his Catalina C compiler for the Propeller.
He added FULL support for Morpheus with XMM, and even modified Chip’s text driver for 128×64 / 100×50 / 80×40 characters/lines!
You can find a link to his official repository for Catalina on the Downloads page.
Included below is his announcement:
Here is Catalina 2.2. Catalina is a FREE ANSI compliant C compiler for the Propeller.
This release of Catalina adds significantly improved support for Multi-CPU Propeller systems. It adds support for Morpheus, and adds proxy driver support for all multi-CPU systems (currently supported are Morpheus and the TriBladeProp).
In multi-CPU systems, proxy drivers allow all devices to be used by a Catalina program as if they were local devices – even if those devices are physically connected to another CPU. For example, on Morpehus CPU 1 has a keyboard, mouse and SD Card interface, while CPU 2 has XMM RAM and a VGA display. You can now run a Catalina LMM program on CPU 1 and give it access to the VGA display on CPU 2, or (probably more common) you can run an XMM program on CPU 2 and give it access to the SD card, keyboard and mouse attached to CPU 1. Catalina provides a proxy device server to run on the CPU that has the devices physically attached.
The commands to build proxy programs are slightly more complex than normal, but not too difficult once you get used to it. Here is an example:
To compile a client program for Morpheus that will run on CPU 2 but use the devices connected to CPU 1, the command would be something like:
To compile a proxy device server program to run on CPU 1, the command would be something like:
Loading the resulting programs can be complex, but the Catalina SD Card and Serial I/O program loaders can be used to do this. The Catalina documentation has been updated and the tutorial now includes examples of using proxy devices.
Here is a summary of recent fixes/improvements to Catalina.
The main changes in this release are Morpheus and proxy driver support:
- Added Morpheus support. XMM is supported on CPU #2. The Mem+ board is also supported, but Morpheus and the Mem+ have to be configured to provide a contiguous block of XMM RAM for Catalina to use.
- Added support for a HiRes VGA display on Morpheus CPU #2. This is identical to the HiRes VGA display on other platforms except that on Morpheus it supports 256 colours (only 64 on other platforms). Also, note that this driver uses 3 cogs on Morpheus, whereas it requires only 2 cogs on other platforms – this may affect some programs that need to use other plugins as well.
- Added error messages if you try to specify incompatible HMI options. For example, on Morpheus, you cannot use the TV HMI plugins, and Catalina will now generate an error messages if you try to compile programs that try to do so. Note that this is not guaranteed to detect all incompatible options.
- Implemented the fseek options SEEK_CUR and SEEK_END (this was actually fixed by a patch to Release 2.1).
- Fixed a bug that caused Catalina to crash if a command line option that required a value was not followed by one (e.g. -D at the end of the line).
- The XMM support code in all files that need it is now identical – the particular XMM functions required are now specified using #defines instead of commenting out parts of the code.
- Added an XMM memory tester – see the ‘ram_test’ subdirectory. Useful for testing ports to new XMM hardware – this is a normal SPIN/PASM program which tests out XMM RAM – if this program runs ok, chances are good that Catalina XMM support will work fine.
- Catalina can now initialize and run all 8 cogs on startup. Previous versions could only initialize and run 7 cogs on startup – the 8th cog could only be used by starting it manually from within the C program.
- Individual CPUs are now called “CPU_1”, “CPU_2”, “CPU_3” (etc) on all multi-CPU systems. Previously on the TriBladeProp they were called “BLADE_1”, “BLADE_2” etc, but this makes less sense on other platforms so Catalina now uses a consistent terminology across all multi-CPU systems. The CPU should now be specified on all compiles on multi-CPU systems – this will help reduce confusion, and also allow Catalina to detect and report incompatible options.
- Added proxy drivers for all HMI devices (keyboard, mouse and screen) as well as the SD Card on multi-CPU systems. This allows programs running on one CPU to use the HMI devices or SD card attached to another CPU. A proxy server program must be run on the CPU with the physical devices connected, and proxy drivers must be used on the client CPU. The use of these proxy drivers is documented in the Catalina Reference Manual.
- Some of the TriBladeProp documentation (e.g. the README.TriBladeProp file in the target directory) was out of date and has been rewritten.
- Fixed a problem in the keyboard support that could cause a program to read incorrect data from the keyboard, or crash.