Topic       : The GFA-Basic Compendium
Author      : GFA Systemtechnik GmbH
Version     : GFABasic.HYP v2.98 (12/31/2023)
Subject     : Documentation/Programming
Nodes       : 899
Index Size  : 28056
HCP-Version : 3
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Document not found
@help       : Help
@options    : +g -i -s +z
@width      : 75
@hostname   : STRNGSRV
@hostname   : CAB     
@hostname   : HIGHWIRE
@hostname   : THING   
View Ref-FileMW_OUT mask,data

mask, data: iexp

This command controls the STE Internal Micro Wire Interface, and is used for
controlling sound.

MW_OUT &H7FF,x

    x=&X10 011 ddd ddd  Set Master Volume
               000 000  -80 dB
               010 100  -40 dB
               101 xxx    0 dB

    The value of the last 5 Bits is equivalent to Half of the volume in dB.

    x=&X10 101 xdd ddd  Set Front Left Channel
    x=&X10 100 xdd ddd  Set Front Right Channel
    x=&X10 111 xdd ddd  Set Rear Left Channel (reserved)
    x=&X10 110 xdd ddd  Set Rear Right Channel (reserved)
                00 000  -40 dB
                01 010  -20 dB
                10 1xx    0 dB

    The last 4 Bits*2 = dB

    x=&X10 010 xxd ddd  Set Treble
    x=&X10 001 xxd ddd  Set Bass
                 0 000  -12 dB
                 0 110    0 dB (flat)
                 1 100  +12 dB

    x=&X10 000 xxx xdd  Set Mix (input select)
                    00  -12 dB
                    01  Mix GI sound (normal ST)
                    10  Reserved
                    11  Reserved

Example:

    MW_OUT &H7FF,&X10000000010 !Switches the ST's sound off.

Memo: This command seems to be fatal (locks up) from the editor if used
      on non-STE hardware. Internally it does not check the hardware at all.
      The library version does check the hardware.