VU Coding Contest Harness
Release: February 10, 2003
==============================================================

This package contains the VU Coding Contest Harness for the 2003 SCEE 
Developers Conference, DevStation, and the entries for the 2002 SCEA DevCon.
The object of the competition is to create the most graphically impressive 
and unique demo program using only the 16K of instruction memory and 16K of 
data memory of the EE Vector Unit 1. 


------Contents
readme.txt                              this file
DevStation2003_vu_coding_contest.doc    2003 contest rules, MS word format
DevStation2003_vu_coding_contest.txt    2003 contest rules, text format

linux_for_ps2                           files to develop on Linux for PlayStation 2
linux_for_ps2/demodata                  binary files for the 2002 demo competition
linux_for_ps2/demosrc                   source for a few demos, includes a basic sample
linux_for_ps2/harness_src               sources for the harness



----------Launching the demos

cd linux_for_ps2
./harness -h


---------Writing your own demo
There is a basic framework provided in the sources that can be used as a starting
point for your own demo. To take a look at this, do:

cd linux_for_ps2
cd demosrc
cd basic
make

---------Adding demos

To make a demo for the demo harness:

-  Write  VCL code and run the VCL preprocessor on it, or write the VU code 
by hand, or use a compiler, etc.
-- Assemble the VU source code into an object file with an assembler.
-- Convert the object file to a .bin binary code file.  This file will be 
loaded into VU1 instruction memory at address 0.
-- Make any binary .dat data file needed by your demo using a VU assembler or 
another program.  This file will be loaded into VU1  data memory at address 
0.
-- Write a plain text .hlp help file containing the controller usage and any 
other user information that will be displayed when the user presses the help 
button.
-- Write a plain text .inf file containing the name of the demo and the 
author, to be displayed at the bottom of the screen while the demo is 
running.
-- Put your demo files in the demo directory (demodata).
-- Modify the ini file to include your files.
-- Run the demo harness.

Note that the VU code and data are loaded by a direct copy operation so no 
dma or vif information should be embedded in the data.
Please refer to the official contest rules for complete file specifications 
and entry requirements.
The source code for the Marionette demo is included.

----------Linux for PlayStation 2

A binary of the harness is included, and the sources are provided for reference.
Write and compile your VU code in the same way as described for the t10k and
modify the demodata/demotest.ini file to include your binary. Keep the same
format as the other lines and do not put spaces around the commas.

------  Changes
13 Feb 2003  LLemarie, SCEE     First version for PlayStation 2 Linux

