Atari ST readme

atari_bin/MT32-PI.TXT

@@ -0,0 +1,76 @@
+#### MT32-PI.TTP (Atari ST) ReadMe ####
+
+MT32-PI.TTP is a control program for the mt32-pi MIDI synthesizer.
+
+Note that this is a CLI/TTP-utility. If you launch it directly from
+TOS a graphical prompt will let you input the parameters. Though for
+more convenience I would recommend a text based shell like EmuCON
+or Okami.
+
+Program source, build instructions and ports to different modern and
+retro platforms available at https://github.com/gmcn42/mt32-pi-control
+
+The mt32-pi synthesizer lives at https://github.com/dwhinham/mt32-pi
+
+
+#### Usage Summary ####
+
+MT32-PI.TTP accepts the following UNIX-style parameters:
+
+USAGE: MT32-PI.TTP [OPTIONS]
+OPTIONS:
+  -h/--help: Print this info.
+  -v/--verbose: Be verbose about what is going on.
+  -r/--reboot: Reboot the Pi. Will block for a few secs to give it time.
+  -m/--mt32: Switch mt32-pi to MT-32 mode.
+  -g/--fluidsynth: Switch mt32-pi to FluidSynth mode.
+  -b/--romset [old, new, cm32l]: Switch MT-32 romset.
+  -s/--soundfont [NUMBER]: Set FluidSynth SoundFont.
+  --mt32-reset: Send an MT-32 reset SysEx message.
+  --gm-reset: Send a GM reset SysEx message.
+  --gs-reset: Send a GS reset SysEx message.
+  '-t/--mt32-txt Some text': Send an MT-32 text display SysEx.
+  '-T/--sc55-txt Some text': Send an SC-55 text display SysEx.
+  -P/--sc55-bmp FILE.BMP: Display a 16x16 1bpp BMP on the screen. (SC-55 SysEx)
+  '-X/--sc55-btxt SomeText': Display a string on the screen as a Bitmap. (SC-55)
+  -N/--negative: Reverse image color. Use with '-P/--sc55-bmp'.
+  '-M/--midi C0 01 C0 DE': Send a list of custom MIDI bytes.
+  -Y/--syx file.syx : Send the contents of a SYX-file.
+ NOTE: If you use quotes in arguments, put those before unquoted ones.
+
+You may specify multiple options, i.e. MT32-PI.EXE '-t Hello, World!' -m will
+first send the MT-32 mode command and then the screen text.
+
+
+#### BSD-License ####
+
+Copyright (C) 2021 Andreas Zdziarstek
+with parts
+	Copyright (C) 2015-2016 Josuah Demangeon <jd at ssh dot bio> (miniwi font),
+	Copyright (c) 2002 Todd C. Miller <Todd.Miller@courtesan.com> (getopt).
+	and Copyright (c) 2000 The NetBSD Foundation, Inc. (getopt)
+
+See the individual source files for details.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice,
+   this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
+