rioutil Supported Players:
 - Rio 600 (all sizes)
 - Rio 800 (all sizes)
 - Rio 900 (all sizes)
 - Rio Riot
 - Nike psa[play (Diamond MM version)
no download support:
 - Rio S-Series (firmware update is not fully working with the S-Series, thought it will recover a ready for update player)
 - Rio Fuse/Chiba/Cali (EXPERIMENTAL)

 - Future flash players ... (REALLY EXPERIMENTAL)

-- All memory expansion should work through -m option --

Unsupported Rio players:
Rio 500 - please try rio500.sf.net.
Rio One - mount as fat filesystem.
Rio Karma - unknown
Rio Nutrus - unknown
Phillips psa[play - unknown

If you have any questions or comments please email:
hjelmn at users dot sourceforge dot net

If you have a patch please email it to:
hjelmn at cs dot unm dot edu

For more information about me my webpage is located at http://www.cs.unm.edu/~hjelmn.

** NOTE **
- If compiling from cvs, use ./autogen.sh instead of ./configure.
- You probably want to install libusb and run configure with --with-libusb

rioutil is free software released under the terms of the LGPL (read LICENCE file).

if you like rioutil you can send me an item off my Amazon wish list :D
http://www.amazon.com/o/registry/2T0HLGZAHALMM

******************************************************************************
** building package                                                         **
******************************************************************************
debian:
% ./configure [options]
% make
% cd debian
% sh build_dpkg.sh

redhat:
% ./configure [options]
% make dist
% cp rioutil-{VERSION}.tar.gz {RPM SOURCE DIRECTORY}
% cd spec
% rpmbuild -bb rioutil-{configuration}.spec

******************************************************************************
** Very likely you will want to use libusb (regardless of your platform).   **
******************************************************************************
% ./configure --with-libusb

*** libusb NOTES **
 - libusb is now the default driver so you no longer need to use this option.
 - to disable libusb use the option --without-libusb
 - For linux see usbdevfs notes becuase it is required before this method will.
work.
 - For darwin 5.x, 6.x or macos 10.x.x you will want libusb 1.6 or newer.

******************************************************************************
** It is highly likely that if you are using linux you will want to compile **
** with usbdevfs support!                                                   **
******************************************************************************
This can be accomplished by running:
% ./configure --with-usbdevfs

*** usbdevfs NOTES *** :
 - Due to permission problems with usbdevfs, you will have to run rioutil as
  superuser (unless using libusb).
 - You cannot use usbdevfs support if the modified rio500 module that comes
  with this distro is installed (check with lsmod).

******************************************************************************
** Instructions if you don't want to use usbdevfs (linux)                   **
** (I'll create a patch one of these days)                                  **
******************************************************************************
% ./configure --without-libusb --without-usbdevfs
% make

(as root)
% cp linux_driver/rio* /usr/src/linux/drivers/usb/
% cd /usr/src/linux/drivers/usb
% mv rios.c rio500.c
% cd /usr/src/linux
(add the rio500 module in configuration)
% make modules
% make modules_install
% insmod rio500

(and if you do not use devfs and the device file does not exist)
% mkdir /dev/usb
% mknod /dev/usb/rio0 c 180 64

The 64 is the base minor, if you have more than one rio add the minor
assigned by the driver (you can see the minor number in /var/log/messages).
i.e. :
<snip from /var/log/messages>
Device assigned minor 1
</snip>
% mknod /dev/usb/rio1 c 180 65

If you want firmware updates, please do not email me. I dont know
the legal issues with mirroring them, so if you want to get a hold of
one and can use stuffit expander (www.aladdinsys.com), you can download
the firmware designed for the mac from www.riohome.com (a .sit.hqx or .zip file).
Once this file is decompressed you should have a .lok file, this is the firmware.

08/27/2003: Current firmware versions:
rio600   : 1.55
rio600-64: 1.55
rio800   : 1.55
Riot     : 1.24

These players work with rioutil's firmware update only from the ready to recieve
firmware screen. Future versions of rioutil will fix this known issue.
S-Series : 1.84
Nitrus   : Unknown
Fuse     : Unknown
Chiba    : Unknown
Cali     : Unknown

As far as I know, if you have any other player you probably have the latest
firmware version (if it was bought recently).

enjoy!

-Nathan Hjelm
