Sunsoft 5B audio: Difference between revisions

From NESdev Wiki
Jump to navigationJump to search
(→‎Envelope: more info about envelope pitch)
(→‎Sound: formula formatting)
Line 63: Line 63:
The tone generators produce a square wave with a period controlled by the [[Clock rate|CPU clock]] (1.78977267 MHz) and the 12-bit period value in registers $00-05.
The tone generators produce a square wave with a period controlled by the [[Clock rate|CPU clock]] (1.78977267 MHz) and the 12-bit period value in registers $00-05.


Frequency = Clock / (16 * Period)
* Frequency = Clock / (16 * Period)
* Period = Clock / (16 * Frequency)


Register $07 controls the mixing of tone and noise components of each channel. A bit of 0 enables the noise/tone on the specified channel, and a bit of 1 disables it. If both bits are 1, the channel outputs a constant signal at the specified volume. If both bits are 0, the result is the logical and of noise and tone.
Register $07 controls the mixing of tone and noise components of each channel. A bit of 0 enables the noise/tone on the specified channel, and a bit of 1 disables it. If both bits are 1, the channel outputs a constant signal at the specified volume. If both bits are 0, the result is the logical and of noise and tone.
Line 72: Line 73:
The noise generator produces a 1-bit random wave with a period controlled by the CPU clock and the 5-bit period value in register $06.
The noise generator produces a 1-bit random wave with a period controlled by the CPU clock and the 5-bit period value in register $06.


Frequency = Clock / (16 * Period)
* Frequency = Clock / (16 * Period)
* Period = Clock / (16 * Frequency)


=== Envelope ===
=== Envelope ===
==== Period ====
The envelope produces a 4-bit ramp that can be directed up or down, or to oscillate by various shape parameters listed below. The ramp has 16 steps in it, and the steps are advanced with a frequency controlled by the CPU clock and the 16-bit period value in registers $0B-0C. Note this formula is the frequency of a single ramp, not of the complete ramp.
The envelope produces a 4-bit ramp that can be directed up or down, or to oscillate by various shape parameters listed below. The ramp has 16 steps in it, and the steps are advanced with a frequency controlled by the CPU clock and the 16-bit period value in registers $0B-0C. Note this formula is the frequency of a single ramp, not of the complete ramp.


* Frequency = Clock / (256 * Period)
* Frequency = Clock / (256 * Period)
 
* Period = Clock / (256 * Frequency)
* Period = Clock / (256 * Frequency)


The AY-3-8910 divides each ramp into 16 steps, whereas the YM2149F variant has a 32 step ramp. Both are functionally equivalent, since the length of the ramp is the same, but the YM2149F has double the output resolution. Note that where alternating envelope shapes are used (triangle wave), the resulting pitch of the envelope is one octave down, since one wave cycle requires two ramps (up and down). Because the envelope is primarily intended for low (sub-audio) frequencies, its pitch control is not as accurate in audio frequency ranges as the tone channels.
The AY-3-8910 divides each ramp into 16 steps, whereas the YM2149F variant has a 32 step ramp. Both are functionally equivalent, since the length of the ramp is the same, but the YM2149F has double the output resolution. Note that where alternating envelope shapes are used (triangle wave), the resulting pitch of the envelope is one octave down, since one wave cycle requires two ramps (up and down). Because the envelope is primarily intended for low (sub-audio) frequencies, its pitch control is not as accurate in audio frequency ranges as the tone channels.
 
==== Shape ====
Writing register $0D resets the envelope and chooses its shape. The shape has four parameters: continue, attack, alternate, and hold.
Writing register $0D resets the envelope and chooses its shape. The shape has four parameters: continue, attack, alternate, and hold.


Revision as of 21:47, 10 March 2012

The Sunsoft 5B is a superset of the Sunsoft FME-7. It is identical to the FME-7 except it contains extra audio hardware. This audio hardware was only used in one game, Gimmick! Because this game did not use many features of the chip (e.g. noise, envelope), its features are often only partially implemented by emulators.

Registers

The audio hardware is a type of the General Instrument AY-3-8910 PSG, or Yamaha's YM2149F variant.

Audio Register Select ($C000)

7......0
----RRRR
    ++++- The 4-bit internal register to select for use with $E000

Audio Register Write ($E000)

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

Internal audio registers

The AY-3-8910 has 16 internal audio registers, selected with $C000 and written to with $E000.

Register Bitfield Description
$00 LLLL LLLL Channel A low period
$01 ---- HHHH Channel A high period
$02 LLLL LLLL Channel B low period
$03 ---- HHHH Channel B high period
$04 LLLL LLLL Channel C low period
$05 ---- HHHH Channel C high period
$06 ---P PPPP Noise period
$07 --CB Acba Noise disable on channels C/B/A, Tone disable on channels c/b/a
$08 ---E VVVV Channel A envelope enable (E), volume (V)
$09 ---E VVVV Channel B envelope enable (E), volume (V)
$0A ---E VVVV Channel C envelope enable (E), volume (V)
$0B LLLL LLLL Envelope low period
$0C HHHH HHHH Envelope high period
$0D ---- CAaH Envelope reset and shape: continue (C), attack (A), alternate (a), hold (H)
$0E ---- ---- I/O port A (unused)
$0F ---- ---- I/O port B (unused)

Sound

There are three channels that output a square wave tone. In addition there is one noise generator, and one envelope generator, both of which may be shared by any of the three channels.

Tone

The tone generators produce a square wave with a period controlled by the CPU clock (1.78977267 MHz) and the 12-bit period value in registers $00-05.

  • Frequency = Clock / (16 * Period)
  • Period = Clock / (16 * Frequency)

Register $07 controls the mixing of tone and noise components of each channel. A bit of 0 enables the noise/tone on the specified channel, and a bit of 1 disables it. If both bits are 1, the channel outputs a constant signal at the specified volume. If both bits are 0, the result is the logical and of noise and tone.

If bit 4 of registers $08-$0A is set, the volume of the channel is controlled by the envelope generator. Otherwise, it is controlled by the 4-bit value in bits 3-0 of the same register.

Noise

The noise generator produces a 1-bit random wave with a period controlled by the CPU clock and the 5-bit period value in register $06.

  • Frequency = Clock / (16 * Period)
  • Period = Clock / (16 * Frequency)

Envelope

Period

The envelope produces a 4-bit ramp that can be directed up or down, or to oscillate by various shape parameters listed below. The ramp has 16 steps in it, and the steps are advanced with a frequency controlled by the CPU clock and the 16-bit period value in registers $0B-0C. Note this formula is the frequency of a single ramp, not of the complete ramp.

  • Frequency = Clock / (256 * Period)
  • Period = Clock / (256 * Frequency)

The AY-3-8910 divides each ramp into 16 steps, whereas the YM2149F variant has a 32 step ramp. Both are functionally equivalent, since the length of the ramp is the same, but the YM2149F has double the output resolution. Note that where alternating envelope shapes are used (triangle wave), the resulting pitch of the envelope is one octave down, since one wave cycle requires two ramps (up and down). Because the envelope is primarily intended for low (sub-audio) frequencies, its pitch control is not as accurate in audio frequency ranges as the tone channels.

Shape

Writing register $0D resets the envelope and chooses its shape. The shape has four parameters: continue, attack, alternate, and hold.

  • Continue specifies whether the envelope continues to oscillate after the attack. If it is 0, the alternate and hold parameters have no effect.
  • Attack specifies whether the attack goes from high to low (0) or low to high (1).
  • Alternate specifies whether the signal continues to alternate up and down after the attack. If combined with hold it provides an immediate flip after the attack followed by the hold.
  • Hold specifies that the value shall be held after the attack. If combined with alternate, the value at the end of the attack will be immediately flipped before holding.
Value Continue Attack Alternate Hold Shape
$00 - $03 0 0 x x \_______
$04 - $07 0 1 x x /_______
$08 1 0 0 0 \\\\\\\\
$09 1 0 0 1 \_______
$0A 1 0 1 0 \/\/\/\/
$0B 1 0 1 1 \¯¯¯¯¯¯¯
$0C 1 1 0 0 ////////
$0D 1 1 0 1 /¯¯¯¯¯¯¯
$0E 1 1 1 0 /\/\/\/\
$0F 1 1 1 1 /_______

Output

The tone channels each produce a 4-bit signal which is then converted to analog with a logarithmic DAC.

References

Retrieved from "https://www.nesdev.org/w/index.php?title=Sunsoft_5B_audio&oldid=11370"