Buttons To Press 6.4.1
BTP is an embracement of rc, and meant to be used on Agenda VR3. It begun 
its life as an experiment with FLTK, and has evolved into a pretty usable 
thing. The worst thing about it is the fingerprints on the Agenda display.


Changes, 6.4.1 (Enrique Vidal, March-2003).

- New code for LED flashing (only works with 8.1+ kernels),
- All the string malloc code now in a generic function: getStrMem,
- A new keyword "copyreset" to specify a "copy-without-sending" default:
  Syntax:
           copyreset=<hard-button-name>,<remote-name>,<IR-command>


Changes, 6.4.0 (Enrique Vidal, Martin Samuelson, Sep-2002).

- Improved multiple layouts or "views" using Fl_Group.
- Correct auto-scaling with the new multiple layouts code
- Improved beeping code.
- Fixed a few memory leaks.


Changes, 6.3.3 (Enrique Vidal, Mar-2002).

SUPPORT FOR LONG MACROS:
- Unlimited length for commands and macros.  Only the required length 
  is now malloc'ed for each entry in the table of commands.
- "Copy-without-sending" function added to allow hardbutton re-play 
  (.prev) without first having to actually send the command or macro.
  a "Copy" button has been added to the toolbar to activate this 
  function.  It can also be activated by dragging over (rather than 
  clicking) the desired button.
- Since long macros may take significant time to execute, visual 
  feedback has been added in order to inform the user when BTP is sending: 
  All the buttons, including the new "Copy" toolbar button, change their 
  state and label whenever BTP is actually sending (long) IR commands.
- Code from James Fenn's beep.cxx have been included for acoustic feedback 
  of hardbutton operation.  Upon completion of a hardbutton-launched
  command or macro, a low-freq beep is played.  Long macros are further
  signalled with initial and final high-pitch beeps.  A new toolbar
  button can be used to disable beeps.

MULTIPLE LAYOUTS or "VIEWS":
- If BTP is invoked with several (<=8) .ini files as arguments, it builds 
  a different (window) layout for each file.  Upon invocation, only the 
  first of these layouts is shown (the others are hidden). A new toolbar 
  label (button) shows the identifier (ID) of the current layout; another
  new toolbar button can be used to sequentially display the (cyclically) 
  next layout.  This button also shows the ID of the next layout.
- In addition, the user can define arbitrarily sized and labelled buttons 
  in the .ini file of each layout for direct switching to other specific 
  layouts.  The new syntax is:

    button=<x,y,w,h>,<label>,layout,<layout_ID>

- By default, ID's are just the ordinal numbers of the .ini files in the
  BTP invocation (first ID is 0).  The user can define more informative
  ID's by means of another new primitive on top of each .ini file.  Syntax:

    layout=<layout_ID>


Changes, 6.3.2 (Enrique Vidal, Feb-2002); MINOR THINGS AND HARD-BUTTONS:
- Conditional code (and modified Makefile) so you can now produce
  binaries both for the AgVr3 and for the Host PC.
- The name of the .ini file can mow be given as an optional argument:
  Syntax: btp [<ini-file-name>]   (default: "remote.ini").
- Included code for detecting hard-button events.  All six AgVr3 hard
  buttons are supported: Page_Up, Page_Down (Left-side top buttons),
  Shift_L, Shift_R (large lateral buttons); Left, Right (front buttons).
  Use these very names in the "hardbutton" lines.  Syntax:

    hardbutton=<hard-button-name>,<remote-name>,<IR-command>
    hardbutton=<hard-button-name>,macro,<IR-command>[,<IR-command> ...]
    hardbutton=<hard-button-name>,.prev

  The new reserved word ".prev" associates to its hardbutton the
  function of replaying the last (soft-button) IR command or macro
  issued so far.  In addition, Page_Up, Page_Down, Left and Right are
  auto-repeating; i.e., a single short click issues once the corresponding
  IR command while, pressing the button longer, repeats the command until
  the button is released.  Shift_L, Shift_R are non-autorepeating.  Note
  that assigning the very same command to both buttons results (in practice)
  in having the corresponding IR command issued twice, since it is almost 
  impossible to push simultaneously both buttons.  So, it may be more
  convenient to use only the Right or the Left buttons (not both).


Documentation about lircd and how to build config files for it can be
found at the project's web site: http://www.lirc.org/

Information about the VR3 PDA can be found at Softfield Technologies'
site, http://www.softfield.com

Included in the archive is a SNOW 1.2 binary.

Because of strange permissions, you will have to run /sbin/lircd and btp
as root. With any luck, this will be fixed in later romdisks.

Romdisk 1.2.6:
/sbin/lircd must be run as root. BTP can be started by user "default".
If BTP can't access /dev/lircd, "chmod 777" it.

I hope btp will be of use to you!

/Sam