RIO utility v1.07 - The Snowblind Alliance (c) 1999
---------------------------------------------------
Files
-----
README This file
CREDITS Credits for contributors to this version
rio.txt Protocol information
gpl.txt Copy of licence
std.h standard defines
binary.h defines for binary numbers from 0-255
rioioctl.h ioctl constants used for WinNT version
iopl32.h low-level port i/o function declarations for OS/2
rio.h rio class header
rio.cpp rio class
app.cpp utility which uses rio class
io.obj low-level port i/o functions for OS/2
os2.def linker def file for OS/2
playlist.txt example playlist file
makefile linux makefile
os2.mak IVMVAC+ v3.0 makefile for OS/2 v4
winnt.mak MSVC++ v5.0 makefile for WinNT v4
win9x.mak MSVC++ v5.0 makefile for Win9x
dos.mak Borland Turbo C++ v1.01 for DOS
Overview
--------
'rio' is a simple command line utility which allows
you to display and manage files on your Diamond Rio
portable music player.
At present the Rio utility supports the Diamond Rio PMP300
with 32M internal flash memory.
Additional external flash memory is now supported thanks to
the work done by Guido March (march@pc40.mpier.uni-frankfurt.de).
command line switches available :-
-d display directory
-iy initialize with check for bad blocks
-in initialize without check for bad blocks
-x perform operations on external flash ram
-u specify file(s) to upload
-g specify file to download
-f specify text based playlist file which contains files to be upload
-z specify file to delete
-za delete all files
-o specify new playlist order in quotes
-p specify parallel port base IO address, default=0x378
-v enable verbose mode
-di specify initialization delay
-dt specify tx delay
-dr specify rx delay
examples...
; display directory using parallel port at 0x278
rio -p 0x278 -d
; initialize (with bad block check) and upload files
rio -iy -u *.mp3
; delete existing files and upload playlist onto external flash ram
rio -za -f playlist.txt -x
; initialize, upload files in playlist and then display directory
rio -d -in -f playlist.txt
; download file then delete it and finally display directory
rio -d -g mp3Files/song.mp3 -z song.mp3
; reverse playlist order and display directory, also change rx iodelay
rio -o "5 4 3 2 1" -d -dr 4
Initialization
--------------
Initialization should only be performed on new or corrupt cards.
You can initialize with bad block checking enabled (-iy) which
will test all blocks on the internal or external flash ram (which
ever is selected) and note all bad blocks. This process will
take some time (upto 20 minutes on slow machines).
You can also initialize with bad block checking disabled (-in)
which is much quicker but all blocks (even bad blocks) will
be used.
If you want to delete all files on the device, the (-za) option
should be used instead of using the initialization options
mentioned above.
Building and running
--------------------
Linux, GCC
----------
To build and run the application you must be
logged on as root, then use 'make'.
(rio utility has been built and tested
using gcc compiler v2.7.2.3 under Linux v2.0.34)
Windows NT v4.0, Visual C++ v5
------------------------------
Use 'nmake /fwinnt.mak'.
(rio utility has been built and tested using
MS Visual C++ compiler v5 under
Windows Workstation NT 4.0)
Windows 95/98, Visual C++ v5
----------------------------
Use 'nmake /fwin9x.mak'.
(rio utility has been built and tested
using MS Visual C++ compiler v5 under Windows 98)
OS/2 v4.0, VisualAge C++ v3
------------------------------
Use 'nmake /f os2.mak'.
(rio utility has been built and tested using
IBM VisualAge C++ compiler v3 under OS/2 v4.0)
DOS, Borland Turbo C++ v1.01
----------------------------
Use 'make -fdos.mak'
(rio utility has been built and tested
using Borland Turbo C++ v1.01 under DOS v6.22 and
Windows 98).
Known Bugs
----------
Because of the difference in timings between different machines
it is possible that you may experience problems when downloading
and displaying the directory.
If you encounter this problem try one or both of the following...
Try increasing one or more of the command line
delay parameters (-di, -dt, -dr). Type 'rio' without
any command line parameters to display the default settings.
Use the utility when the device is powered on as this
seems to improve IO performance.
Bug Reports
-----------
If you encounter any problems using this utility please send
e-mail outlining the problem along with details about your
Rio (memory installed, memory remaining and tracks loaded) to...
sba@tessier-ashpool.cix.co.uk
Licence Terms
-------------
This software is released under the terms of the GPL. Please see
the file gpl.txt for further information.