home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / MD / MD009.ZIP / FMPAKA.EXE / lha / FMPAKA.DOC < prev    next >
Text File  |  1990-12-28  |  7KB  |  161 lines
  1.  
  2.                                        
  3.              FM-PAK/A -- FB-01, Music Feature Editor Utilities
  4.                        Copyright 1990,  Kevin Weiner
  5.                             All rights reserved
  6.  
  7.  
  8. Installation
  9. ------------
  10.  
  11. It is suggested that all the included files be copied into a subdirectory
  12. called FMPAK, and that the subdirectory be added to the DOS search path for
  13. ease of use.  If a separate working directory for data files is to be used,
  14. the files CONFIG* and BANK* (27 files total) should be copied there.  These
  15. are used by the FM-Edit program to avoid delays in loading rom data from the
  16. sound module via MIDI.  The working directory name should then be entered on
  17. the FM-Edit "Setup" screen and the setup file "Saved".
  18.  
  19.  
  20. Hardware
  21. --------
  22.  
  23. Requires: 260K of available ram; hard drive recommended; and either an
  24. IBM Music Feature card (MFC), or an external Yamaha FB-01 connected via
  25. one of the following MIDI interfaces: Roland MPU-401 compatible, Key
  26. Electronics MIDIator, or Creative Labs SOUND BLASTER (with MIDI
  27. adapter).  All video display types are supported.  A Microsoft comatible
  28. mouse is optional. 
  29.  
  30. FM-Edit supports 2 local Music Feature cards, and up to 14 remote units. 
  31. The remote units may be either Music Feature cards or Yamaha FB-01
  32. synthesizers.  If a non-MFC MIDI interface is used, up to 16 remote
  33. units may be controlled.  If only one MFC is in use, the unit selection
  34. switch on the card may be set for either card 1 or 2. 
  35.  
  36. If no music interface is present, some of the utilities will still
  37. operate.  FM-Edit, for example, can be used for editing voice and
  38. configuration files on disk. 
  39.  
  40.  
  41. Usage
  42. -----
  43.  
  44. To run any of these programs in default mode, type one of the program
  45. names listed below.  To select special MIDI device options, include the
  46. -d option on the command line.  The -d option identifies the MIDI
  47. interface(s) in use, and optionally, the IRQ and base I/O address:
  48.  
  49.              -dmfc      selects IBM Music Feature
  50.              -dmpu      selects MPU-401 compatible
  51.              -dmidiator selects MIDIator
  52.              -dsbmidi   selects SOUND BLASTER MIDI
  53.  
  54.              (The first 3 letters of the device name are sufficient.)
  55.  
  56.     The MIDIator cannot be detected automatically and the -dmid option
  57.     must always be specified if one is in use.  
  58.  
  59.     Optional IRQ and I/O port address information can be added following
  60.     the device id if necessary:
  61.  
  62.              -dxxx:<irq>:<ioaddr>
  63.  
  64.     For example, to define an MPU-compatible interface using IRQ 5 and I/O
  65.     address 332 (hex), use:
  66.  
  67.              -dMPU:5:332
  68.  
  69.     If only the I/O address is required but the default IRQ is alright,
  70.     use -dMPU::332.
  71.  
  72.     The irq and ioaddr are not relevant to the MIDIator, though the first
  73.     option number can be given to indicate use of the com port 2 instead of
  74.     the default com 1.  (ex: -dmid:2)
  75.  
  76.     To set up a device before hand, define the "opt1" environment variable
  77.     to be the -d option that would be included on the command line.  For
  78.     example:
  79.                   set opt1=-dmpu:5:332
  80.  
  81.     This line would generally be added to the autoexec.bat file to 
  82.     select the option permanently.
  83.  
  84. Other Command line optiions (interactive programs only):  
  85.  
  86.    -m  Forces monochrome display mode.  (Normally detected automatically)
  87.  
  88.    -k  Forces keyboard mode if a mouse is present.
  89.  
  90.    -b  Selects BIOS screen writes, rather than the default direct write
  91.        mode.  May be necessary for proper operation on certain machines.
  92.  
  93.  
  94. All data entry within the interactive programs is self-prompting.  More
  95. complete usage information is contained in the help files.  The names of
  96. each interactive program's help files include the program name and have
  97. the extension '.HLP'.  The help files may be viewed within the programs
  98. via the F1 help option on any screen.  They may also be viewed as normal
  99. text files, or printed.  If using an editor to view them, be careful not
  100. to modify them, since they are specially formatted and may not be
  101. viewable within the programs if modified. 
  102.  
  103.  
  104. Programs
  105. --------
  106.  
  107. The following programs are included in the FM-PAK/A distribution.  Note
  108. that where a file name is required, the current directory is assumed if
  109. none is specified.  <options> refers to the "-" options described above. 
  110. They must follow any other command line items. 
  111.  
  112. FMEDIT   - Configuration and voice editor. 
  113.            Usage: fmedit <options> 
  114.  
  115. FMTUNE   - Allows the FB-01/MFC fractional tuning feature to be used
  116.            by defining arbitrary note frequencies.
  117.            Usage: fmtune <options>
  118.  
  119. PLAYB    - Plays standard MIDI files. 
  120.            Usage: play <file name> <mode> <options>
  121.  
  122.            <mode> =    S   Scan mode - display file info, do not play.
  123.                        X   Dump file contents to screen.
  124.                        n   Channel number (force all output to same channel).
  125.            <mode> is optional; normal play mode is assume if not given. 
  126.  
  127. LOADBANK - Loads a saved bank file to a specified user bank.
  128.            Usage: loadbank <file name> <bank number> <node number> <options>
  129.            Default for bank and node number is 1.
  130.  
  131. LOADCONF - Loads a saved config file to the specified user configuration.
  132.            Usage: loadconf <file name> <config number> <node number> <options>
  133.            Default for config and node number is 1.
  134.  
  135. SETCONF  - Selects the current synth configuration (1-20).
  136.            Usage: setconf <config number> <node number> <options>
  137.            Default for config and node number is 1
  138.  
  139. VOICES   - Lists the names of the voices contained in a bank file.
  140.            Usage: voices <file name>
  141.  
  142. DUMP     - Simple SYSEX dump program.  Sends a file containing MIDI system
  143.            exclusive messages to a device via the MIDI interface.
  144.            Usage: dump <file name> <options>
  145.  
  146. FM2MDX   - Exports FM-Edit bank files to raw bank dump format.
  147.            Usage: fm2mdx <FM bank file> <raw bank file>
  148.  
  149. CHECKMFC - Checks for proper operation of the Music Feature card.
  150.            Usage: checkmfc
  151.  
  152. RESETMFC - Resets the Music Feature card to power-up status.
  153.            Usage: resetmfc
  154.  
  155. RESETCNF - Resets all user configurations to factory defaults.  (batch file)
  156.            Usage: resetcnf <node number> <option>
  157.  
  158. RESETBNK - Resets user banks to factory defaults. (batch file)
  159.            Usage: resetbnk <nodenumber> <option>
  160.  
  161.