SIDPLAY64 V0.7 (c) GRG/SHAPE 2011 
----------------------------------

About the program:
------------------
This is a program that can playback .SID files from the 
HVSC collection (http://hvsc.c64.org/) on a real Commodore 64/128.
It was designed for both PAL and NTSC computers, and will play all sid 
songs at correct system speed.


How to use:
-----------

Welcome to this updated Sidplay64 (SP64) version.
A handful bugfixes was done, alot of code was optimized to make the code shorter,
keyboard scan and irq routines was rewritten. Directory browsing was added. Device detector was added.
You will find 4 different version of SP64 in this package:

Sidplay64_07.prg                 -  The normal version, this will work on all devices.
Sidplay64_07_1541u_netdrive.prg  -  Only for 1541u or netdrive.
sidplay64_07_iec_cmd_ide64.prg   -  Only for iec, cmd or ide64 devices.
sidplay64_07_sd2iec.prg          -  Only for Sd2iec.

When you first start SP64 you will see the drive selector screen.
You can use F1/F2 to select device number 6-30. Press return when done.
If you for any reason want to force the device number you can press CBM+Return.
Both netdrive and 1541u (in iec mode) returns: "@? :31,syntax error,00,00" when
SP64 tries to read the error channel. You just press Return Just press to start the program.

After pressing Return the main screen will show up and SP64 will load the directory.
When a fresh directory is loaded you can only use some of these keys:

Cursor keys   :Select sid tune
Return        :Load a sid tune / open directory / open disk image file
Instdel       :Go back a directory level (Only for the versions that supports directory browsing)
Space         :Load/Reload directory
F1            :Restart song
F7            :Stop song
+ / -         :Select songs  (if any)
< / >         :Set shuffle time
R             :Randomly load sid tune (when shuffle time has been reached)
N             :Load next sid tune (when shuffle time has been reached)
M             :Manually select sid tune
ClrHome       :Top of directory
Shift+ClrHome :Bottom of directory
Restore       :Restart program (inits values and variables and loads directory.)
<-(left arrow):Fast forward (when song is playing)
CBM key       :(left ctrl key in windows) exit an Rsid.

When the sid is playing/present in memory you can use all keys.

SP64 determines if the file is a sid by scanning the sid header of the file. That means the .sid
extension in the filename doesnt need to be present on the disk.
If the file is a wrong format it will exit with a red border (and reload dir incase the disk was swapped).
If the file is a Psid you will see a black border and you can use all keys to control the program.
If the file is a Rsid you will see the border changes to Grey when music starts playing, and you 
will also notice that none of the keys works. Pressing CBM will exit back to my program.


About RSID's:
-------------
Rsids runs with it's own interrupt handler. The play call address is always set to $0000.
And you will see the letters "RSID" in the the top left corner.
The border turns grey when an rsid is playing. (Unless the rsid itself changes the border colors)

To exit an Rsid:
Press the CBM key.
If that doesnt work try pressing spacebar, runstop, ctrl, shift, then the CBM key.
If that still doesnt work, try hitting Restore or Runstop/Restore to trigger a reset of the program.
If that doesnt work. You have to reset and reload the program.

If you sucessfully exited and Rsid the normal way (CBM key) you can select subtunes with +/- and
you can start and stop the song with F1 and F7.


1541U (In IEC mode/Standalone mode):
------------------------------------
You can browse dirs and open .d64 images.
You can load sids from filesystem or from within .d64 images.


Netdrive + The Final Replay 0.8:
--------------------------------
You can browse dirs.
You need to prepare the files you want to use with netdrive:
1) To be able to load files from you pc filesystem you need to convert 
   the .sid extension to .prg ( ren *.sid *.prg )
2) Filenames can have a maximum of 16 letters ( not counting the ".prg" file extension)
3) directory names must no exceed 16 letters.
Once these things are done you can enter the following line to start netdrive:
netdrive -r c:/tmp/sids/
(Note the "/" slash must be correct or you will suffer countless hours of agony and pain...)


SD2IEC:
-------
You can browse directories, and you can open
the the following disk images : .d64, .d71, .d81 and .dnp


IEC(UIEC/IEC-ATA)/CMD FD/CMD HD/CMD RAMLINK/IDE64(+PClink):
-----------------------------------------------------------
You can browse directories.


Unsupported sid files:
----------------------
* Sid files with PSID in the filename.
* Sid files with BASIC in the filneame.


Bugs:
-----
Some sid files will cause bugs or even a crash.
Be sure to help the hvsc crew by identifying those sids.


SIDPLAY 64 v.07 (25/08/2011):
-----------------------------
* Added:     Real PAL/NTSC detector.
* Added:     "D64" detector for long filenames (1541u + netdrive.)
* Added:     "DIR" sorter for directory displayer.
* Added:     Native dir browser and disk image browser (d64,d71 etc.) for netdrive, 1541u, iec, cmd and ide64.
* Added:     Long filenames support (Vice and Windows file system)
* BugFixed:  RunStop key doesnt stop loading. (Jiffydos will stop
* Updated:   Keyboard scanner - key delays works much better now.
* Added:     Keyboard scanner - "Instdel key" goes back a dir level.
* Added:     Device selector - device #6 up to #30
* Updated:   Alot of things in background code was optimized to save memory.
* Updated:   Timer IRQ updated, more available cpu time, its now possible to play Jeff's 12 speed song.
* Updated:   TOD Clock + Shuffle modes  moved out of timer irq and into keyboard scanner subroutine.
* BugFixed:  RunStop+Restore will not crash when hardware IRQ interrupt is running (0314-0315).
* Updated:   "Memory Error" detection:
             Fixed a bug where SP64 code was relocated when loading a file with not enough
             relocation pages.

SIDPLAY64 v.06 beta (01/01/2010):
----------------------------------
* Corrected all text output, when loading sid files from pc dir, and when loading files over netdrive.
  No strange signs on screen now. ( ? )
* Fixed to "Work" with Netdrive, but there is a but: all sid files extensions must end with ".prg"
  For instance "shape.sid" will only work if renamed to "shape.prg" or "shape.sid.prg"
  Netdrive only supports files with the .prg extension.
  Filenames must be equal or less than 16 letters (do not count file extension)
* Fixed the bug with Retro Replay.
  According to Countzer0 it is indeed a bug that shouldnt be there.
* Files with not enough relocation pages for siplay64 and with a built in play mode 
  (see sid files with $0000 as play call) will now be loaded and started.
  Examples here are Pollytracker songs which use all memory.
  Other files where relocation pages doesnt leave enough memory will still give you
  the "out of memory error" message.
* Speeded up the keyboard scanner.
  You can select things faster now.
* Added a display number for number of files in dir.

SIDPLAY64 v.05 beta (20/11/2009):
----------------------------------
Added a long overdue IDE64 fix - Thanks to iAN COOG and Soci.

SIDPLAY64 v.04 beta (23/12/2005):
----------------------------------
First version that was released.