home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Multimed / Multimed.zip / tmixer13.zip / tmixer.doc < prev    next >
Text File  |  1997-03-20  |  7KB  |  195 lines
  1.  tmixer.doc                                  Copyright (C)1997 Cornel Huth
  2.  release 1.2                                                   20-Mar-1997
  3.  
  4.  
  5. tmixer is a full-function mixer for Creative Labs Sound Blaster soundcards.
  6. It is an OS/2 VIO application (neither PM nor MMPM/2 is required).  Files
  7. included:
  8.  
  9.         1. paradise.sys
  10.         2. tmixer.exe
  11.  
  12. Optionally, if you are running Warp 3 or earlier:
  13.  
  14.         3. clock01.sys  (clock02.sys available by request, for MCA)
  15.  
  16. Also included is tmidi, a wonderful little SMF player for MPUs.
  17.  
  18. No other drivers are needed.  MMPM/2 is not required (but is okay), nor
  19. are any soundcard drivers.  This package includes everything you need
  20. to control your SB mixer.  Specific mixers currently supported are the
  21. 1335 (SB2CD), 1345 (SB Pro), and the 1745 (SB16 and later).
  22.  
  23.  
  24. Installation
  25. ------------
  26.  
  27. Install the (two) SYS driver(s) in your boot drive's root directory and
  28. include a reference for the paradise driver in your config.sys:
  29.  
  30.         DEVICE=G:\PARADISE.SYS     (optional -q for quiet install)
  31.  
  32. CLOCK01.SYS, installed automatically by the boot process and so has no
  33. reference in the config.sys file, is based on the Warp 4.0 driver.  It
  34. can be used in previous OS/2 versions, too.  If you are using Warp 4.0,
  35. your CLOCK driver already has the IDC hook, so you can use the one you
  36. already have.  The included CLOCK01.SYS driver is only for those running
  37. Warp 3 or earlier.
  38.  
  39. If you have the old clock driver installed, paradise.sys will gracefully
  40. tell you so, and not install itself.  If you get this message at boot, use
  41. the included clock01.sys.
  42.  
  43. Note:  Due to a long-standing bug in OS/2, detection of obsolete clock
  44. drivers is not as straight-forward as it should be.  However, if the
  45. obsolete clock is not found during boot, it likely will be found by tmidi
  46. (tmixer doesn't current make use of the clock driver, but the Paradise
  47. system requires that it be installed anyway).  See tmidi.doc for more.
  48.  
  49. The clock01.sys driver in Warp 3's fixpack #26 is -not- an up-to-date
  50. driver.  If the clock01.sys driver is less than 4000 bytes (e.g.,
  51. 3520 bytes, like the fp26 one (date 10-10-96)) you need to install the
  52. clock01.sys driver included in this package.
  53.  
  54. Once you have the driver(s) installed, reboot.
  55.  
  56. Using tmixer
  57. ------------
  58.  
  59. To get a list of possible switches, use tmixer with no options:
  60.  
  61.         [G:\]tmixer
  62.  
  63. the result is:
  64.  
  65.  tmixer 1.2   Copyright (C)1997 Cornel Huth   http://www.40th.com/
  66.  Use: [G:\]tmixer -p:n [-i:n] [-d:n] [-h:n] [-m:n] [-tell] [...]
  67.  
  68.         -p: is the required base port of device (SB usually 220)
  69.         -i: IRQ        (optional - see technical documentation for details)
  70.         -d: 8-bit DMA  (optional - [if both -i & -d, device is initialized])
  71.         -h: 16-bit DMA (optional)
  72.         -m: mixer type (optional) (not all settings available for all mixers)
  73.         -tell shows current mixer settings
  74.  
  75.         -vol:n    n=0-100       -bal:n    n=0-50-100
  76.         -vWave:n  n=0-100       -bWave:n  n=0-50-100
  77.         -vMidi:n  n=0-100       -bMidi:n  n=0-50-100
  78.         -vCD:n    n=0-100       -bCD:n    n=0-50-100
  79.         -vLine:n  n=0-100       -bLine:n  n=0-50-100
  80.         -vMic:n   n=0-100       -bass:n   n=0-50-100
  81.         -vSpkr:n  n=0-100       -treble:n n=0-50-100
  82.  
  83.         -AGC:n    n=0|1         -ciMidi:n n=0|1
  84.         -coLine:n n=0|1         -ciLine:n n=0|1
  85.         -coCD:n   n=0|1         -ciCD:n   n=0|1
  86.         -coMic:n  n=0|1         -ciMic:n  n=0|1
  87.         -gOut:n   n=0-100       -gIn:n    n=0-100
  88.  
  89. To get a list of switches specific to your soundcard's mixer, use the
  90. following:
  91.  
  92.         [G:\]tmixer -p:220 -tell  (use your soundcard's base port for -p:)
  93.  
  94. the result is as shown below, where each list member is a valid switch for
  95. your mixer (the balance switches are implied, to the right of the |; see
  96. above for balance switch names).  The SB16 -tell output looks like this:
  97.  
  98.  Port: 220  IRQ: 10  DMA: 0x0601  Mixer: 1745  DSP: 4.11  Paradise: 1.100
  99.  
  100.     vol: 100 |  50     AGC: 0
  101.   vWave:  40 |  50     gIn: 0
  102.   vMidi:  40 |  50    gOut: 0   ciMidi: 0
  103.     vCD:   0 |  50    coCD: 1     ciCD: 1
  104.   vLine:   0 |  50  coLine: 1   ciLine: 1
  105.    vMic:   0         coMic: 1    ciMic: 1
  106.   vSpkr:   0
  107.    bass:  50
  108.  treble:  50
  109.  
  110. The output is tailored to the mixer, so if you have a SB Pro you would
  111. see fewer settings (e.g., no tone, no connect outs, etc.).  For example,
  112. if you have an SB Pro-compatible mixer, the SB Pro -tell output is:
  113.  
  114.  Port: 220  Mixer: 1345  DSP: 3.01  Paradise: 1.100
  115.  
  116.     vol: 100 |  50
  117.   vWave:  80 |  50
  118.   vMIDI:  80 |  50
  119.     vCD:   0 |  50    ciCD: 0
  120.   vLine:   0 |  50  ciLine: 0
  121.    vMic:   0         ciMic: 1
  122.  
  123.  
  124. The SB2CD has fewer still.  The SB2CD is not too common.  It was the first
  125. SB to include a mixer.  It includes a CD connector interface.
  126.  
  127.  
  128. The technical documentation contains a complete list of what each setting
  129. does and its valid values.  The technical documentation is available only
  130. to licensed users.
  131.  
  132.  
  133. To set a mixer control, use the name as it is shown in the -tell list
  134. (or the list shown when tmixer alone is used), and add a value to it.
  135. For example, to set the volume to maximum, full-left balance, use:
  136.  
  137.         [G:\]tmixer -p:220 -vol:100 -bal:0
  138.  
  139. You may stack as many switches as you want on a command line.
  140.  
  141.  
  142. NOTE:  If tmixer indicates to you that the soundcard needs to be initialized,
  143. you should do the following before using tmixer to set anything:
  144.  
  145.         [G:\]tmixer -p:220 -i:<the IRQ> -d:<the low DMA> -h:<the high DMA>
  146.  
  147. For example,
  148.  
  149.         [G:\]tmixer -p:220 -i:10 -d:1 -h:6
  150.  
  151. The -h: high DMA channel switch is for the SB16 and later; the card WILL
  152. BE PROGRAMMED for those settings.  Once the card is initialized (usually
  153. only required once per power-cycle, and is usually already init'ed if you
  154. are using MMPM/2, or have run any soundcard program), the mixer type is
  155. auto-detected.  To override the mixer type, use the -m: switch. See the
  156. technical documentation for details.
  157.  
  158.  
  159. Limitations
  160. -----------
  161.  
  162. The 1745 connections are always programmed left-to-left, and right-to-right
  163. (e.g., Line-In left always goes to the left channel, and Line-In right
  164. always goes to the right channel).
  165.  
  166. The gain controls are programmed to adjust both channels identically (e.g.,
  167. setting gIn:50 sets both left and right gain-in channels to 50).  Ditto
  168. for the tone controls.
  169.  
  170. Do not leave a space between the switch: and the value (-vol:80).
  171.  
  172. Volume level must be non-zero for its balance change to take effect.
  173.  
  174.  
  175. Tips
  176. ----
  177.  
  178. See the technical documentation file, tmixer.tec (available to licensed
  179. users only).  To get a license, see the README file.
  180.  
  181. See the README file for more.
  182.  
  183. Filename is tmixer12.zip.  At ftp://hobbes.nmsu.edu/os2/mmedia. For the
  184. always-latest release, see the sites listed below.
  185.  
  186.  
  187. Cornel Huth
  188. --
  189.  .                                             .
  190.  :    Quality Toolkits and Applications for    : info@40th.com
  191.  :          DOS - Win16 - Win32 - OS/2         : http://www.40th.com/
  192.  :                                             : BBS:1-210-684-8065
  193.  
  194.  
  195.