
    PlayDirP 1.07 - UART-Controlled Audio Player with Dual Volume Control
    ---------------------------------------------------------------------
                         for VSOS 3.57 or higher
                        2020-09-24  VLSI Solution



PlayDirP plays all the files of the current directory, in alphabetical order.
It can be controlled through stdin, which, if the UARTIN driver is used,
is the UART.

For options, run:
S:>playdir -h
Usage: PlayDirP [-v|+v|-p|+p|-s|+s|-ddriv|-h]
-v      Verbose
+v      Not verbose
-p      Start in pause mode
+p      Start in play mode
-s      Shuffle mode on
+s      Shuffle mode off
-ddriv	Use audio driver driv for secondary volume control (e.g. -dauospda)
-h      Show this help

To use, either compile the VSIDE Solution, or simply copy PlayDirP.dl3 to
your VS1005 Evaluation Board's SYS/ folder.

For more information on the command line options, as well as the input
and output of PlayDirP (which are essentially the same as for PlayDir,
except for changes mentioned in Version History for v1.06 below),
refer to the PDF document VS1005 VSOS Shell, Chapter Using the UART
Controlled Player.




License:
This code may be used freely in any product containing one or more ICs
by VLSI Solution.




Disclaimer:
No guarantee is given for the usability of this code.




Version History:
2020-09-24 HH v1.07 - Slightly modified documentation.
2020-08-07 HH v1.06 - Added commands 'z' = loop off, 'x' = loop song, and
                      'c' = loop all.                     
2020-08-07 HH v1.05 - Added -d option for secondary volume control with keys
                      'u' and 'd', or with command ~0x0206=vol+1024, e.g.
		      ~0x0206=1024 for full volume and ~0x0206=1044 for
                      -10 dB volume.
2019-07-09 HH v1.04 - Changed order in which seconds and percent are displayed.
2017-12-05 HH v1.03 - Ported to VS1005h.
2017-03-14 HH v1.02 - Can now also control pitch / speed shifter with UART
                      characters '+', '-', '=', 'f', 's', 'b'.
2016-02-10 HH v1.01 - Tells buffer size to Dir to avoid buffer overflow.
2015-08-28 HH v1.00 - First release.
