home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Multimed / Multimed.zip / rio006-2.zip / README < prev    next >
Text File  |  1999-06-28  |  5KB  |  136 lines
  1.  
  2.         RIO utility v1.06 - Ashpool Systems (c) 1999
  3.         --------------------------------------------
  4.  
  5.         Files
  6.         -----
  7.         README          This file
  8.         rio.txt         Protocol information
  9.  
  10.         std.h           standard defines
  11.         binary.h        defines for binary numbers from 0-255
  12.         rioioctl.h      ioctl constants used for WinNT version
  13.         rio.h           rio class header
  14.         rio.cpp         rio class
  15.         app.cpp         utility which uses rio class
  16.  
  17.         playlist.txt    example playlist file
  18.  
  19.         makefile        linux makefile
  20.         winnt.mak       MSVC++ v5.0 makefile for WinNT v4
  21.         win9x.mak       MSVC++ v5.0 makefile for Win9x
  22.         dos.mak         Borland Turbo C++ v1.01 for DOS
  23.  
  24.         rio2.exe        Executable for OS/2
  25.  
  26.         Overview
  27.         --------
  28.         'rio' is a simple command line utility which allows
  29.         you to display and manage files on your Diamond Rio
  30.         portable music player.
  31.  
  32.         At present the Rio utility supports the Diamond Rio PMP300
  33.         with 32M internal flash memory.
  34.         Additional external flash memory is now supported thanks to
  35.         the work done by Guido March (march@pc40.mpier.uni-frankfurt.de).
  36.  
  37.         command line switches available :-
  38.  
  39.         -d  display directory
  40.         -iy initialize with check for bad blocks
  41.         -in initialize without check for bad blocks
  42.         -x  perform operations on external flash ram
  43.         -u  specify file to upload
  44.         -g  specify file to download
  45.         -f  specify text based playlist file which contains files to be upload
  46.         -z  specify file to delete
  47.         -za delete all files
  48.         -o  specify new playlist order in quotes
  49.         -p  specify parallel port base IO address, default=0x378
  50.         -v  enable verbose mode
  51.  
  52.         examples...
  53.  
  54.         ; display directory using parallel port at 0x278
  55.                 rio -p 0x278 -d
  56.         ; initialize (with bad block check) and upload file
  57.                 rio -iy -u song.mp3
  58.         ; delete existing files and upload playlist onto external flash ram
  59.                 rio -za -f playlist.txt -x
  60.         ; initialize, upload files in playlist and then display directory
  61.                 rio -d -in -f playlist.txt
  62.         ; download file then delete it and finally display directory
  63.                 rio -d -g mp3Files/song.mp3 -z song.mp3
  64.         ; reverse playlist order and then display directory
  65.                 rio -o "5 4 3 2 1" -d
  66.  
  67.         Initialization
  68.         --------------
  69.         Initialization should only be performed on new or corrupt cards.
  70.         You can initialize with bad block checking enabled (-iy) which
  71.         will test all blocks on the internal or external flash ram (which
  72.         ever is selected) and note all bad blocks. This process will
  73.         take some time (upto 20 minutes on slow machines).
  74.         You can also initialize with bad block checking disabled (-in)
  75.         which is much quicker but all blocks (even bad blocks) will
  76.         be used.
  77.  
  78.         If you want to delete all files on the device, the (-za) option
  79.         should be used instead of using the initialization options
  80.         mentioned above.
  81.  
  82.         Building and running
  83.         --------------------
  84.  
  85.                 Linux, GCC
  86.                 ----------
  87.                 To build and run the application you must be
  88.                 logged on as root, then use 'make'.
  89.                 (rio utility has been built and tested
  90.                 using gcc compiler v2.7.2.3 under Linux v2.0.34)
  91.  
  92.                 Windows NT v4.0, Visual C++ v5
  93.                 ------------------------------
  94.                 Use 'nmake /fwinnt.mak'.
  95.                 (rio utility has been built and tested using
  96.                 MS Visual C++ compiler v5 under
  97.                 Windows Workstation NT 4.0)
  98.  
  99.                 Windows 95/98, Visual C++ v5
  100.                 ----------------------------
  101.                 Use 'nmake /fwin9x.mak'.
  102.                 (rio utility has been built and tested
  103.                 using MS Visual C++ compiler v5 under Windows 98)
  104.  
  105.                 DOS, Borland Turbo C++ v1.01
  106.                 ----------------------------
  107.                 Use 'make -fdos.mak'
  108.                 (rio utility has been built and tested
  109.                 using Borland Turbo C++ v1.01 under DOS v6.22 and
  110.                 Windows 98).
  111.  
  112.         Known Bugs
  113.         ----------
  114.         Because of the difference in timings between different machines
  115.         it is possible that you may experience problems when downloading
  116.         and displaying the directory.
  117.         If you encounter this problem try one or both of the following...
  118.  
  119.                 Try doubling the value of IODELAY_1 and/or IODELAY_2
  120.                 #define's in mpm.cpp. This will only increase the time
  121.                 it takes to download and will not have an effect on
  122.                 file upload times.
  123.  
  124.                 Use the utility when the device is powered on as this
  125.                 seems to improve IO performance.
  126.  
  127.         Bug Reports
  128.         -----------
  129.         If you encounter any problems using this utility please send
  130.         e-mail outlining the problem along with details about your
  131.         Rio (memory installed, memory remaining and tracks loaded) to...
  132.  
  133.                 sba@tessier-ashpool.cix.co.uk
  134.  
  135.  
  136.