joyofrexx

Short:        Control Apps using a CD32 controller
Author:       richard.munn@bigfoot.com
Uploader:     richard munn bigfoot com
Type:         util/rexx
Architecture: m68k-amigaos

---

JoyOfRex V0.2
© 3/6/1999 Richard Munn / RAMTronics Software

---

Requirements:

lowlevel.library (is included as part of Workbench 3.1 and above)
a CD³² controller (although limited usage can be had with a standard joystick)

---

This is a simple little program that lets you assign rexx / AmigaDos commands
to buttons (or combinations of buttons) on a controller (joystick or CD³² pad)
connected to your Amiga

Suggested uses:
* Remote control for CD / MP3 player
* Remote control for Paloma TV Card
* Renote control for Scala scripts

---

Installation:
Copy the JoyOfRexx program to your C: drawer, or anywhere else in your system's
path

---

Usage:

[run <>NIL:] joyofrexx <configfilename>

The program can be quit by sending it a CtrlC, or by making it monitor the
existance of an Arexx port (see below)

---

The config file:

The easiest way to create a config file is to use the supplied get32code program.
You can paste the output of this to create a skeleton config file.

The file's format:

Most of the lines will consist of the following format:

C "$000008" "PORT" "COMMAND" "-1" ; comment

C          means that this is a command line
$000008    is the hex code for the combination of keys pressed for this command
PORT       here is where you enter the Arexx port of the app to control
COMMAND    here is where you put the Arexx command to be executed
-1         put a delay time here (50ths of a second) This causes a delay after the command
; comment  You can add a comment to the line to explain what the command does


You can also make the program monitor the existance of an Arexx port, and quit when it
dissappears.

This is done by adding the following line to the top of the config file:

P "PORT"

Where PORT is the portname to monitor.

---

Tips:

When parsing the config file, the first line that matches any of the buttons
currently pressed will be used.  This means if you have two lines, one with red
pressed and one with red and blue pressed, make sure the red+blue line is above
the red line in the config file.

You can execute a normal AmigaDOS command by setting the PORT in a C line as
"COMMAND" and entering the command to execute in the COMMAND part (enclosed in
 ' quotes)  e.g.

C "$000008" "COMMAND" "'SAY Up'" "-1" ; Up

Uses the WB2 Say command to say "UP" when you press up on the joypad (see
speakpad.config for a full example)

---

History:

V0.1 - Initial test version designed as a remote for the Paloma TV Card software
V0.2 - Updated to allow it to work with any rexx commands

have fun!

Richard

richard.munn@bigfoot.com