diff --git a/atari_bin/MT32-PI.TXT b/atari_bin/MT32-PI.TXT new file mode 100644 index 0000000..3709bbf --- /dev/null +++ b/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 (miniwi font), + Copyright (c) 2002 Todd C. Miller (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. +