SCMODE 1.0 by Mark Fontana
Released June 29, 1992


   Do you have a Roland SCC-1 and hate wading through that buggy Roland
utility just to set your SCC-1 to MT-32 mode?

   Do you have an external SC-55 or SC-155 and hate having to reach over
and do the on/off + hold button routine?


INTRODUCTION

   SCMODE is a command line utility to set your Roland Sound Canvas series
tone module to either GS Standard mode or MT-32 emulation mode.  It is
suitable for use in batch files, ie. when starting games configured for the
MT-32, or resetting to GS mode before starting a sequencer.

   SCMODE has been confirmed to work correctly with the SC-55, SCC-1, and
SC-155 tone modules.  I have not been able to test it on a JV-series
keyboard, but there's a fairly good chance it will work with those too.

   At the moment, SCMODE supports only Roland MPU-compatible MIDI interfaces
(such as MusicQuest's), which covers all SCC-1 owners and a good chunk of
the remaining Sound Canvas user base.  I'll add Soundblaster MIDI support
if enough people ask about it.  As far as other interfaces, if you can
provide me with some (free) information on how to program for them, I'd
be happy to add support for these as well.


COMMAND LINE OPTIONS

   SCMODE is pretty straightforward.  It accepts the following command line
options in any order:

   mt32     ; set MT32 mode
   gs       ; set GS Standard mode
   -i n     ; use IRQ n (where n = 2, 3, 5, or 7)
   -p n     ; use port n (where n is the base address of your MPU
                          interface, specified in hex, ie. "330" for 330h);
   
All options are case insensitive.  If no IRQ is specified, SCMODE will
usually be able to autodetect the correct IRQ level.  If no port is 
specified, SCMODE assumes the default setting of 330h.


ERRORLEVELS

  If SCMODE successfully changed modes, it returns errorlevel 0.  If any
errors were encountered, it returns errorlevel 1.


DISTRIBUTION

  SCMODE is freeware.  You may use SCMODE indefinitely, and no payment or
registration is required.  You may freely distribute SCMODE as long as:

   a) no fee is charged
   b) no changes are made to the program or this documentation file

  I would prefer that SCMODE _NOT_ be distributed by shareware houses
without first contacting me for approval.


DISCLAIMER

   Use SCMODE at your own risk.  I assume no responsibility for damage
or loss resulting from the use of SCMODE.


ABOUT SCMODE

   SCMODE was written using Borland C++ 3.0 and the C library of the
MusicQuest Programmer's Toolkit (which I highly recommend).

MIDI Interface ToolKit Copyright (c) 1987, 1989 by Music Quest, Inc.


   I welcome all comments and bug reports concerning SCMODE.
   Here's where you can reach me, in order of speed and reliability:

       Internet  :  fontana@cis.ohio-state.edu
       Phone     :  1 (614) 261-6117
       FidoNet   :  Mark Fontana at Compu-Link BBS; Columbus, Ohio USA
                    1 (614) 846-1274; Fido address: 1:226/340
       CompuServe:  75566,237 (I rarely log in)


UPCOMING PACKAGES

   SCEDIT - A parameter editor/librarian and custom SYSEX message builder
            for the Sound Canvas series.

   SCANIM - An animation editor for the bitmapped display of external
            Sound Canvas modules.  Overlays animations on Standard MIDI
            files (like the Roland "Stargames" demo).