APU Sweep: Difference between revisions

From NESdev Wiki
Jump to navigationJump to search
mNo edit summary
m (note that the reload flag is cleared when clocked)
Line 24: Line 24:
When clocked by the [[APU Frame Counter|frame counter]], one of three things happen:
When clocked by the [[APU Frame Counter|frame counter]], one of three things happen:


* If the reload flag is set, the divider's counter is set to the period P. If the divider's counter was zero before the reload and the sweep is enabled, the pulse's period is also adjusted (if the target period is in range; see below).
* If the reload flag is set, the divider's counter is set to the period P. If the divider's counter was zero before the reload and the sweep is enabled, the pulse's period is also adjusted (if the target period is in range; see below). The reload flag is then cleared.
* If the reload flag is clear and the divider's counter is non-zero, it is decremented.
* If the reload flag is clear and the divider's counter is non-zero, it is decremented.
* If the reload flag is clear and the divider's counter is zero and the sweep is enabled, the counter is set to P and the pulse's period is adjusted (if the target period is in range; see below).
* If the reload flag is clear and the divider's counter is zero and the sweep is enabled, the counter is set to P and the pulse's period is adjusted (if the target period is in range; see below).

Revision as of 14:44, 9 March 2014

A NES APU sweep unit can be made to periodically adjust a pulse channel's period up or down.

Each sweep unit contains the following: divider, reload flag.

$4001 EPPP.NSSS Pulse channel 1 sweep setup (write)
$4005 EPPP.NSSS Pulse channel 2 sweep setup (write)
bit 7 E--- ---- Enabled flag
bits 6-4 -PPP ---- The divider's period is set to P + 1
bit 3 ---- N--- Negate flag
0: add to period, sweeping toward lower frequencies
1: subtract from period, sweeping toward higher frequencies
bits 2-0 ---- -SSS Shift count (number of bits)
Side effects Sets the reload flag

NOTE: The term "target period" used in the following description is equivalent to [shift-result + current period]. That is, it does not mean the result of the right-shift alone.

When clocked by the frame counter, one of three things happen:

  • If the reload flag is set, the divider's counter is set to the period P. If the divider's counter was zero before the reload and the sweep is enabled, the pulse's period is also adjusted (if the target period is in range; see below). The reload flag is then cleared.
  • If the reload flag is clear and the divider's counter is non-zero, it is decremented.
  • If the reload flag is clear and the divider's counter is zero and the sweep is enabled, the counter is set to P and the pulse's period is adjusted (if the target period is in range; see below).

The channel's 11-bit raw timer period is shifted right by the shift count (using a barrel shifter), then either added to or subtracted from the channel's raw period, yielding the target period. When the channel's current period is less than 8 or the target period is greater than $7FF, the channel is silenced (0 is sent to the mixer) but the channel's current period remains unchanged. Otherwise, if the enable flag is set and the shift count is non-zero, when the divider outputs a clock, the channel's period is updated.

If the shift count is zero, the channel's period is never updated, but the channel will still be silenced if the sweep is in add mode and the target period (i.e., the current period added to itself) is greater than $7FF.

The adder computes the next target period immediately after the period is updated by $400x writes or by the frame counter. (Internally, the target period is continuously calculated by the adder.) A target period overflow from the sweep unit's adder can silence a channel even when the enabled flag is clear and even when the sweep divider is not outputting a clock signal. To fully disable a sweep unit, write $08 to turn on the negate flag so that the target period is not greater than the channel's period and therefore not greater than $7FF. (This behavior of silencing the channel even when the sweep unit is disabled is only relevant for adder overflow; the pulse channels are always silenced when the period is less than eight, regardless of whether a sweep period update or an explicit setting of the period was involved.)

For reasons unknown, pulse channel 1 hardwires its adder's carry input rather than using the state of the negate flag, resulting in the subtraction operation adding the one's complement instead of the expected two's complement (as pulse channel 2 does). As a result, a negative sweep on pulse channel 1 will subtract the shifted period value minus 1.