Gabrielle

This is Gabrielle, the companion to Xena.

DESCRIPTION
The AmigaONE X1000 and X5000 comes with the Xena XMOS XS-1 chip. The set of
tools included in this archive will help you utilize the chip.

Gabrielle is the main tool to compile .xc files using a remote server.

Included in this archive is also the latest version of the XTools toolset. This
set of tools was orignally written by Segher Boessenkool, and then adapted to
AmigaOS by Lyle Hazelwood. The included version 1.6 is based on the sources
found in the XTools Source drawer (GPL) supplied by AEon with the X1000 and has
been further developed by Joakim Nordström.

USAGE
You can compile and the run your Xena binaries like this:

  1> gabrielle TARGET=joyboard.xe joyboard.xc
  Saved to joyboard.xe

  1> XRunXE joyboard.xe
  Opening filejoyboard.xe...
  Setting up PLL...
  Loading core: 0...
  Loading core: 1...
  Loading core: 0...
  Loading core: 1...

  1> XReset

Make sure to run XReset when you're done with your program.

CHANGES
1.6 - Fixed unclosed resources when exiting early
1.5 - Highly improved speed when uploading binaries (only takes the necessary
number of bytes)
    - Finally managed to setup PLL values to get full speed and get localbus
examples running
    - Added experimental X5000 support
1.4 - Support for XE binaries v 2 (as created by XTC Toools v 13)
    - Added check for correct platform (exists when run on unsupported platform)
    - Updated to new SDK, no use of deprecated functions
    - Without optimizations it runs with newer SDK
    - A 1.3 version binary has been seen in the wild, bumpreving to avoid
confusion
1.1 - Bumped version with minor fixes
1.0 - Initial version from 2010

DISCLAIMER
This software is to be regarded as in beta state. The authors are not liable for
any damages resulting from the use of this software, whether direct, indirect,
incidental, or consequential.

NOTES
The tools have been tested successfully on AmigaOne X1000.

There exists code to test for X5000. Help is needed to test this! Please read
the XTools/XTools.txt for more information on how to test on X5000.

The compilation server is running on a free-tier cloud provider. No guarantee
this will stay online forever. The server code can be made available to allow
local usage.