Micro ST - a SNDH-files player for Win95.
Beta version 4 from 02-02-02.
(c)2001-2002 S.V. Bulba.

		---=== I do not know what is Atari ST, but I can
						emulate it to understand ===---

The version features:

Emulating sound chip:	YM2149F
Emulating MC68000:	Starscream 680x0 emulation library by Neill Corlett
			(corlett@elwha.nrrc.ncsu.edu)
Atari ST emulation:	YM2149 and MFP ports are supported
Channels allocation:	ABC-stereo
YM clock frequency:	User defined
MC68000 clock frequency:User defined
MFP clock frequency:	User defined
VBL period:		User defined
SNDH files:		uncompressed or compressed with PACK-ICE
MUS files:		header format:+0 - init, +6 - play VBL
DRAG&DROP function:	supported
Sound mode:		44100 Hz, 16 bit, stereo

Send any comments to Sergey Bulba, vorobey@mail.khstu.ru
Visit http://bulba.at.kz/ for the latest version and other AY/YM programs.

Note:
- Command line using

             MicroST.exe [FileName]

  for start playing from command line. For playing SNDH and MUS files by
  double-clicking in Windows Explorer or Far Manager you must manually
  register files with extension .SND and .MUS in system register (don't
  warry about it for now, because Micro ST is very bad yet).

- You can drug and drop file to main window of Micro ST for playing it.

- For emulating MC68000 "Starscream 680x0 emulation library by Neill Corlett"
  is used.

- YM ports (from FF8800 to FF88FF) are emulated by next scheme.

  a) if (address and 3 = 0) then written data is register number
  b) if (address and 3 = 0) then readen data is current register value
  c) if (address and 3 = 2) then written data is current register new value

  If you see errors in described port interpritation, please, report me.

  Officially Atari ST has only two ports for YM2149: FF8800 and FF8802. And
  new Atari ST compatible computers support only these two ports, so some SNDHs
  can't be played correctly on such machines.

- MFP ports (from FFFA00 to FFFA2F) are very simplified emulated. I did not
  understand MFP chip for now, so its timers are emulated very badly. If you
  can help me, please, contact with me. The most MFP-based tunes (SID,
  Sinus-SID, DigiDrum and Digital sound) are playing OK.

- Timers can generate five interrupts:
  a) VBL:
     level 4, autovectored
  b) Timer A
     level 6, vector 77
  c) Timer B
     level 5, vector 72
  d) Timer C
     level 4, vector 69
  e) Timer D
     level 3, vector 68

  If you see errors, please, report to me.

- Atari ST memory size is 128k (from 000000 to 01FFFF), all RAM.

- Errors during MC68000 code execution are not correctly processed, so if error
  message will popup, close Micro ST and then restart it.

Thanks to:
- Neill Corlett. Your MC68000 emulation is very cool!
- Sledge Hammer of Grinder. Thank you for MUS-files, sources, techinfo and other
  about Atari ST.

Links:
- Micro ST supporting site http://bulba.at.kz/
- Micro ST author Sergey Bulba, vorobey@mail.khstu.ru
- SNDH files http://www.brainbug.ch/stsound

Sources:
- You can download sources of Micro ST at http:/bulba.at.kz/. Feel free to
  report me about all my errors.

Appendix:
- Several SNDHs from STSound archive.
- MUS-files, which are sent to me by Sledge Hammer.
