VRC7 audio

The Konami VRC7, in addition to being a mapper chip, also produces 6 channels of 2-operator FM Synthesis Audio. It is a derivative of the Yamaha YM2413 OPLL, implementing a subset of its features and containing a custom fixed patch set.

VRC7 audio was only used in one game, Lagrange Point. The chip also appears in Tiny Toon Adventures 2, but this cart does not use the audio, and its board lacks required additional audio mixing circuitry.

Registers

Audio Enable ($E000)

7  bit  0
---------
RS.. ..MM
 +-------- Silence expansion sound if set

Bit 6 of this register will silence the expansion audio if set. Other bits in this register control mirroring and WRAM. See VRC7: Mirroring Control ($E000).

Setting this bit will silence the expansion audio, and clears its registers (including LFO state).

Audio Register Select ($9010)

7......0
VVVVVVVV
++++++++- The 8-bit internal register to select for use with $9030

This register is write-only.

After writing to this register, the program must not write to $9030 (or $9010 again) for at least 6 CPU clock cycles while the VRC7 internally sets up the address.

Audio Register Write ($9030)

7......0
VVVVVVVV
++++++++- The 8-bit value to write to the internal register selected with $9010

This register is write-only.

After writing to this register, the program must not write to $9010 (or $9030 again) for at least 42 CPU clock cycles while the VRC7 internally handles the write.

Register Write Delay

Lagrange Point uses the following delay routine after writes to $9010 and $9030 to ensure enough time passes between writes:

wait_9030:          ; JSR to this label immediately after writing to $9030
    STX $82         ; stores X temporarily (address is arbitrary)
    LDX #$08
@wait_loop:
    DEX
    BNE @wait_loop
    LDX $82         ; restores X
wait_9010:          ; JSR to this label immediately after writing to $9010
    RTS

Internal Audio Registers

The VRCVII appears to have 26 internal registers. Registers $00-$07 define a custom patch that can be played on any channel set to use instrument $0. Registers $10-$15, $20-25, and $30-35 control 6 channels for FM synthesis. Other register values appear to be ignored.

Custom Patch

Register	Bitfield	Description
$00	TVSK MMMM	Modulator tremolo (T), vibrato (V), sustain (S), key rate scaling (K), multiplier (M)
$01	TVSK MMMM	Carrier tremolo (T), vibrato (V), sustain (S), key rate scaling (K), multiplier (M)
$02	KKOO OOOO	Modulator key level scaling (K), output level (O)
$03	KK-Q WFFF	Carrier key level scaling (K), unused (-), carrier waveform (Q), modulator waveform (W), feedback (F)
$04	AAAA DDDD	Modulator attack (A), decay (D)
$05	AAAA DDDD	Carrier attack (A), decay (D)
$06	SSSS RRRR	Modulator sustain (S), release (R)
$07	SSSS RRRR	Carrier sustain (S), release (R)

The patch defines a 2-operator FM unit with a single modulator and carrier. The carrier produces the output tone, and the output of the modulator modulates its frequency. The patch has the following parameters:

• $00/$01 T Tremolo applies amplitude modulation at a predefined rate.
• $00/$01 V Vibrato applies pitch modulation at a predefined rate.
• $00/$01 S Sustain determines whether the operator uses the sustain section of the envelope or not.
• $00/$01 K Key rate scaling adjusts the ADSR envelope speed, faster for high frequencies, slower for low ones.
• $00/$01 MMMM Multiplier is a multiplier on the operator's frequency according to a lookup table (see below).
• $02/$03 KK Key level scaling attenuates the operator at higher frequencies $0 = none, $3 = most.
• $02 OOOOOO Modulator output level, this value reduces the modulator volume in 0.75db increments.
• $03 Q/W Operator waveform, 0 = sine, 1 = half-wave rectified sine (where sine values less than 0 are clipped to 0).
• $03 FFF Feedback applied to modulator according to a lookup table (see below).
• $04/$05 AAAA Attack is the speed of the attack fade in after key-on. $0 = halt, $1 = slowest, $F = fastest.
• $04/$05 DDDD Decay is the speed of the decay fade to sustain after attack. $0 = halt, $1 = slowest, $F = fastest.
• $06/$07 SSSS Sustain is the attenuation after decay, in 3db increments. $0 = highest volume, $F = lowest.
• $06/$07 RRRR Release is the speed of the release fade to silent after sustain. $0 = halt, $1 = slowest, $F = fastest.

If a note is released before the attack or decay finishes, release begins from the current volume level. If the sustain bit is not set in $00/$01 S, release begins immediately after decay.

If the sustain bit is set in the channel control register $2X S (see Channels section below), the release value in the patch is ignored and replaced with $5.

The modulator's sustain bit ($00 S) also disables the release section of its envelope. If its sustain bit is set, the Attack, Decay, and Sustain portions of the envelope are used, but when the note is released the modulator will continue to sustain while the carrier releases. The carrier does not behave this way: its envelope always enters release when the note is released.

$00/$01 MMMM	$0	$1	$2	$3	$4	$5	$6	$7	$8	$9	$A	$B	$C	$D	$E	$F
Multiplier	1/2	1	2	3	4	5	6	7	8	9	10	10	12	12	15	15

$03 FFF	$0	$1	$2	$3	$4	$5	$6	$7
Modulation Index	0	π/16	π/8	π/4	π/2	π	2π	4π

Channels

Register	Bitfield	Description
$10-$15	LLLL LLLL	Channel low 8 bits of frequency
$20-$25	--ST OOOH	Channel sustain (S), trigger (T), octave (O), high bit of frequency (H)
$30-$35	IIII VVVV	Channel instrument (I), volume (V)

Each channel X is controlled by three registers at $1X, $2X, and $3X.

The 8 bits of $1X with a 9th bit from bit 0 of $2X create a 9-bit frequency value (freq). This is combined with a 3-bit octave value from $2X (octave) to define the output frequency (F):

     49716 Hz * freq
F = -----------------
     2^(19 - octave)

The VRC7 is clocked by an external ceramic oscillator running at 3.58 MHz (roughly twice the NTSC NES CPU clock rate, but not synchronized with it), and it takes 72 internal clock cycles to update all of its channels, which means each channel is updated with a frequency of 49716 Hz (or roughly 36 NES CPU clocks). During these 72 cycles, the channels are output in series rather than mixed (like Namco's 163), but because the frequency is so high it is not audibly different from mixed output.

Writing to register $2X can begin a key-on or key-off event, depending on the value in the trigger bit (T). If the trigger bit changes from 0 to 1 (key-on), a new note begins. If it changes from 1 to 0 (key-off), it will begin the release portion of its envelope which will eventually silence the channel (unless release is $0). If the trigger bit does not change, no new key-on or key-off will be generated.

Using the sustain bit (S) in $2X overrides the normal release value for the patch with a value of $5.

Register $3X selects the instrument patch to use, and chooses a volume. Note that volume value is inverted: $F is the lowest volume and $0 is the highest. There is no silent volume value; its output scale is logarithmic in 3db increments.

Internal patch set

There are 16 different instrument patches available on the VRC7. With the exception of instrument $0, which can be controlled by registers $00-$07 (see above), these are hardwired into the chip and cannot be altered.

Exact values for the fixed patch set are not known, but the following table is very close:

     00 01 02 03 04 05 06 07
     -----------------------
 0 | -- -- -- -- -- -- -- --
 1 | 03 21 05 06 B8 81 42 27
 2 | 13 41 13 0D D8 D6 23 12
 3 | 31 11 08 08 FA 9A 22 02
 4 | 31 61 18 07 78 64 30 27
 5 | 22 21 1E 06 F0 76 08 28
 6 | 02 01 06 00 F0 F2 03 F5
 7 | 21 61 1D 07 82 81 16 07
 8 | 23 21 1A 17 CF 72 25 17
 9 | 15 11 25 00 4F 71 00 11
 A | 85 01 12 0F 99 A2 40 02
 B | 07 C1 69 07 F3 F5 A7 12
 C | 71 23 0D 06 67 75 23 16
 D | 01 02 D3 05 A3 92 F7 52
 E | 61 63 0C 00 94 AF 34 06
 F | 21 72 0D 00 C1 A0 54 16

Differences from OPLL

The synthesis core is related to the Yamaha YM2413 OPLL, which is itself a cost-reduced version of the YM3182 OPL2 chip made popular by AdLib and SoundBlaster sound cards.

• Register layout is the same.
• VRC7 has 6 channels, OPLL has 9.
• VRC7 has no rhythm channels, OPLL does (the last 3 channels are either FM or Rhythm on OPLL).
• VRC7 built-in instruments are not the same as OPLL instruments.
• VRC7 has no readily-accessible status register, under normal circumstances it is write-only; OPLL has an undocumented, 2-bit 'internal state' register.
• VRC7 has an internal state output pin (may be serial version of the 2 bit internal state register) and has one output pin for audio, multiplexed for all 6 channels; OPLL has two output pins, one for FM and one for Rhythm, and has no special status pin.

References

• VRC7 chip info by Kevin Horton: http://kevtris.org/nes/vrcvii.txt
• YM2413 datasheets: http://www.datasheetarchive.com/YM2413-datasheet.html
• VRC7 audio test program: http://zzo38computer.org/nes_program/vrc7test.zip
• VRC7 patch set revisions 2012, 2017, 2018: http://forums.nesdev.org/viewtopic.php?f=6&t=9141
• Discussion of modulator sustain: http://famitracker.com/forum/posts.php?id=6804

External links

• Programmer's guide to the YM2413 from SMSPower
• How logsin and exp tables work in OPL2
• Yamaha FM internal bit depths
• VRC7 discussion on NESdev BBS
• OPL emulator in DOSBox