@xromdev/apu 0.4.1 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/expansion.js CHANGED
@@ -1,9 +1,9 @@
1
1
  /**
2
- * The two expansion sound chips the Famicom's own games carried most: the Disk
3
- * System's wavetable voice (FDS) and Namco's 163 (N163). Each is a channel the
4
- * 2A03 does not have — a waveform drawn in RAM, played back at a pitch — and
5
- * games that use them put their melody there, so without them a soundtrack is
6
- * its bass and drums.
2
+ * The expansion sound chips the Famicom's own games carried most: the Disk
3
+ * System's wavetable voice (FDS), Namco's 163 (N163) and Konami's VRC6. Each
4
+ * adds channels the 2A03 does not have — a waveform drawn in RAM played back at
5
+ * a pitch, or two more pulses and a sawtooth — and games that use them put
6
+ * their melody there, so without them a soundtrack is its bass and drums.
7
7
  *
8
8
  * Like the APU here they run at the sample rate, not per CPU cycle: each sample
9
9
  * advances the chip by `CPU_HZ / sampleRate` cycles' worth of its counters.
@@ -12,7 +12,9 @@
12
12
  * renderer adds it to the mix. The levels relative to the 2A03 follow the
13
13
  * common reference players: FDS at full gain about as loud as both pulses at
14
14
  * full, an N163 channel at full volume about as loud as one pulse — divided by
15
- * the number of channels it time-shares its one output with, as the chip does.
15
+ * the number of channels it time-shares its one output with, as the chip does —
16
+ * and a VRC6 pulse at full volume one and a half times a 2A03 pulse, as Mesen2
17
+ * mixes it (`VRC6_STEP`).
16
18
  */
17
19
  import { CPU_HZ } from './constants.js';
18
20
  /** Full-scale output of the FDS (wave 63 × gain 32 at master volume 1), in `mixApu` units. */
@@ -23,6 +25,13 @@ const N163_FULL = 0.16;
23
25
  const FDS_MASTER = [1, 2 / 3, 1 / 2, 2 / 5];
24
26
  /** Mod table entries → how far each moves the mod counter; 4 resets it. */
25
27
  const MOD_STEP = [0, 1, 2, 4, 0, -4, -2, -1];
28
+ /**
29
+ * One step of the VRC6's output (pulse 0..15 + pulse 0..15 + saw 0..31), in `mixApu` units. From
30
+ * Mesen2, which adds the chip's summed output × 15 (Core/NES/Mappers/Audio/Vrc6Audio.h) × 5
31
+ * (Core/NES/NesSoundMixer.cpp, GetOutputVolume) to a 2A03 mix whose `mixApu` 1.0 is 5000 there:
32
+ * 75 / 5000. A VRC6 pulse at volume 15 is so 0.225, about one and a half 2A03 pulses at 15.
33
+ */
34
+ const VRC6_STEP = 75 / 5000;
26
35
  export class FdsChip {
27
36
  constructor(sampleRate) {
28
37
  this.wave = new Uint8Array(64);
@@ -263,21 +272,25 @@ export class N163Chip {
263
272
  this.address = (this.address + 1) & 0x7f;
264
273
  return v;
265
274
  }
275
+ /** The address port as it stands — the next RAM byte the data port reaches, with bit 7 for auto-increment. */
276
+ get port() {
277
+ return this.address | (this.autoIncrement ? 0x80 : 0);
278
+ }
266
279
  get channels() {
267
280
  return ((this.ram[0x7f] >> 4) & 7) + 1;
268
281
  }
269
282
  /**
270
- * A channel's eight bytes: frequency low, middle, and high two bits with the wave length above
271
- * them; three bytes of phase; the wave's address; the volume. (Read off what Namco's own drivers
272
- * write — Erika to Satoru and Mappy Kids both put `$E0`/`$F0`, a 32- or 16-sample wave, in the
273
- * third byte.)
283
+ * A channel's eight bytes, interleaved as on the chip: frequency low, phase low, frequency
284
+ * middle, phase middle, the frequency's high two bits with the wave length above them, phase
285
+ * high, the wave's address, the volume. (Namco's drivers write the frequency bytes and step over
286
+ * the phase ones by READING the data port — auto-increment counts reads too.)
274
287
  */
275
288
  channel(slot) {
276
289
  const base = 0x40 + slot * 8;
277
290
  const r = this.ram;
278
291
  return {
279
- frequency: r[base] | (r[base + 1] << 8) | ((r[base + 2] & 3) << 16),
280
- length: 256 - (r[base + 2] & 0xfc),
292
+ frequency: r[base] | (r[base + 2] << 8) | ((r[base + 4] & 3) << 16),
293
+ length: 256 - (r[base + 4] & 0xfc),
281
294
  waveAddress: r[base + 6],
282
295
  volume: r[base + 7] & 0x0f,
283
296
  };
@@ -330,8 +343,191 @@ export class N163Chip {
330
343
  return { channels: this.disabled ? 0 : n, active: this.disabled ? [] : active };
331
344
  }
332
345
  }
346
+ /**
347
+ * Konami's VRC6: two pulses with eight duties and a sawtooth, beside the 2A03 (Akumajou Densetsu,
348
+ * Madara, Esper Dream 2). The registers are at the addresses the NSF format gives them —
349
+ * `$9000`–`$9003`, `$A000`–`$A002`, `$B000`–`$B002`; the cartridges themselves differ in which of
350
+ * A0/A1 they wire to the chip, which a player maps before here.
351
+ *
352
+ * Each channel counts down `(period >> shift) + 1` CPU cycles a step, as Mesen2's Vrc6Pulse/Vrc6Saw
353
+ * do. Output is the average over each sample of what the chip puts out, so a high note at a low
354
+ * sample rate keeps its level.
355
+ */
356
+ export class Vrc6Chip {
357
+ static newPulse() {
358
+ return { volume: 0, duty: 0, constant: false, period: 0, enabled: false, timer: 1, step: 0 };
359
+ }
360
+ constructor(sampleRate) {
361
+ this.pulses = [Vrc6Chip.newPulse(), Vrc6Chip.newPulse()];
362
+ this.sawRate = 0;
363
+ this.sawPeriod = 0;
364
+ this.sawEnabled = false;
365
+ this.sawTimer = 1;
366
+ this.sawStep = 0;
367
+ this.sawAccumulator = 0;
368
+ this.halted = false;
369
+ this.shift = 0;
370
+ this.cyclesPerSample = CPU_HZ / sampleRate;
371
+ }
372
+ /** A write to `$9000`–`$9003`, `$A000`–`$A002` or `$B000`–`$B002`. Returns false for any other address. */
373
+ write(address, value) {
374
+ const v = value & 0xff;
375
+ if (address === 0x9003) {
376
+ this.halted = (v & 1) !== 0;
377
+ this.shift = v & 4 ? 8 : v & 2 ? 4 : 0;
378
+ return true;
379
+ }
380
+ if ((address >= 0x9000 && address <= 0x9002) || (address >= 0xa000 && address <= 0xa002)) {
381
+ const p = this.pulses[address >> 12 === 0x9 ? 0 : 1];
382
+ switch (address & 3) {
383
+ case 0:
384
+ p.volume = v & 0x0f;
385
+ p.duty = (v >> 4) & 7;
386
+ p.constant = (v & 0x80) !== 0;
387
+ break;
388
+ case 1:
389
+ p.period = (p.period & 0xf00) | v;
390
+ break;
391
+ case 2:
392
+ p.period = (p.period & 0x0ff) | ((v & 0x0f) << 8);
393
+ p.enabled = (v & 0x80) !== 0;
394
+ // Clearing E resets the duty step; the divider runs on.
395
+ if (!p.enabled)
396
+ p.step = 0;
397
+ break;
398
+ }
399
+ return true;
400
+ }
401
+ if (address >= 0xb000 && address <= 0xb002) {
402
+ switch (address & 3) {
403
+ case 0:
404
+ this.sawRate = v & 0x3f;
405
+ break;
406
+ case 1:
407
+ this.sawPeriod = (this.sawPeriod & 0xf00) | v;
408
+ break;
409
+ case 2:
410
+ this.sawPeriod = (this.sawPeriod & 0x0ff) | ((v & 0x0f) << 8);
411
+ this.sawEnabled = (v & 0x80) !== 0;
412
+ if (!this.sawEnabled) {
413
+ this.sawStep = 0;
414
+ this.sawAccumulator = 0;
415
+ }
416
+ break;
417
+ }
418
+ return true;
419
+ }
420
+ return false;
421
+ }
422
+ static pulseLevel(p) {
423
+ if (!p.enabled)
424
+ return 0;
425
+ if (p.constant)
426
+ return p.volume;
427
+ return p.step <= p.duty ? p.volume : 0;
428
+ }
429
+ /**
430
+ * Advance `count` samples, ADDING each channel's output to `outs[0]` (pulse 1), `outs[1]` (pulse
431
+ * 2) and `outs[2]` (saw) — or, for a channel without a buffer of its own, to `outs[3]` if given —
432
+ * from `offset`.
433
+ */
434
+ render(count, outs, offset = 0) {
435
+ const cps = this.cyclesPerSample;
436
+ const scale = VRC6_STEP / cps;
437
+ const running = !this.halted;
438
+ for (let c = 0; c < 2; c++) {
439
+ const out = outs[c] ?? outs[3];
440
+ const p = this.pulses[c];
441
+ const reload = (p.period >> this.shift) + 1;
442
+ // Not stepping, or stepping makes no difference: one level for the whole run.
443
+ if (!running || !p.enabled || p.constant || p.volume === 0) {
444
+ if (out) {
445
+ const level = Vrc6Chip.pulseLevel(p) * VRC6_STEP;
446
+ if (level !== 0)
447
+ for (let k = 0; k < count; k++)
448
+ out[offset + k] += level;
449
+ }
450
+ if (running && p.enabled) {
451
+ // The duty step moves on all the same, for when the level comes back.
452
+ const cycles = count * cps;
453
+ if (cycles >= p.timer) {
454
+ const steps = 1 + Math.floor((cycles - p.timer) / reload);
455
+ p.step = (p.step + steps) & 15;
456
+ p.timer = reload - ((cycles - p.timer) % reload);
457
+ }
458
+ else
459
+ p.timer -= cycles;
460
+ }
461
+ continue;
462
+ }
463
+ for (let k = 0; k < count; k++) {
464
+ let left = cps;
465
+ let sum = 0;
466
+ while (left >= p.timer) {
467
+ sum += (p.step <= p.duty ? p.volume : 0) * p.timer;
468
+ left -= p.timer;
469
+ p.step = (p.step + 1) & 15;
470
+ p.timer = reload;
471
+ }
472
+ sum += (p.step <= p.duty ? p.volume : 0) * left;
473
+ p.timer -= left;
474
+ if (out)
475
+ out[offset + k] += sum * scale;
476
+ }
477
+ }
478
+ {
479
+ const out = outs[2] ?? outs[3];
480
+ const reload = (this.sawPeriod >> this.shift) + 1;
481
+ if (!running || !this.sawEnabled) {
482
+ const level = this.sawEnabled ? (this.sawAccumulator >> 3) * VRC6_STEP : 0;
483
+ if (out && level !== 0)
484
+ for (let k = 0; k < count; k++)
485
+ out[offset + k] += level;
486
+ return;
487
+ }
488
+ for (let k = 0; k < count; k++) {
489
+ let left = cps;
490
+ let sum = 0;
491
+ while (left >= this.sawTimer) {
492
+ sum += (this.sawAccumulator >> 3) * this.sawTimer;
493
+ left -= this.sawTimer;
494
+ this.sawTimer = reload;
495
+ // Fourteen steps a cycle: the accumulator grows on every other one and starts over on the 14th.
496
+ this.sawStep = (this.sawStep + 1) % 14;
497
+ if (this.sawStep === 0)
498
+ this.sawAccumulator = 0;
499
+ else if ((this.sawStep & 1) === 0)
500
+ this.sawAccumulator = (this.sawAccumulator + this.sawRate) & 0xff;
501
+ }
502
+ sum += (this.sawAccumulator >> 3) * left;
503
+ this.sawTimer -= left;
504
+ if (out)
505
+ out[offset + k] += sum * scale;
506
+ }
507
+ }
508
+ }
509
+ snapshot() {
510
+ const pulse = (p) => ({
511
+ period: p.period,
512
+ volume: p.volume,
513
+ duty: p.duty,
514
+ constant: p.constant,
515
+ enabled: p.enabled,
516
+ });
517
+ return {
518
+ pulse: [pulse(this.pulses[0]), pulse(this.pulses[1])],
519
+ saw: { period: this.sawPeriod, rate: this.sawRate, enabled: this.sawEnabled },
520
+ halted: this.halted,
521
+ shift: this.shift,
522
+ };
523
+ }
524
+ }
333
525
  /** Hz of an FDS frequency register value. */
334
526
  export const fdsHz = (frequency) => (CPU_HZ * frequency) / 4194304;
335
527
  /** Hz of an N163 channel, from its frequency, wave length and the number of channels on. */
336
528
  export const n163Hz = (frequency, length, channels) => (CPU_HZ * frequency) / (15 * 65536 * channels * length);
529
+ /** Hz of a VRC6 pulse period (with `$9003`'s shift, if any): 16 steps of `(period >> shift) + 1` cycles. */
530
+ export const vrc6PulseHz = (period, shift = 0) => CPU_HZ / (16 * ((period >> shift) + 1));
531
+ /** Hz of the VRC6 sawtooth's period (with `$9003`'s shift, if any): 14 steps of `(period >> shift) + 1` cycles. */
532
+ export const vrc6SawHz = (period, shift = 0) => CPU_HZ / (14 * ((period >> shift) + 1));
337
533
  //# sourceMappingURL=expansion.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"expansion.js","sourceRoot":"","sources":["../src/expansion.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The two expansion sound chips the Famicom's own games carried most: the Disk\n * System's wavetable voice (FDS) and Namco's 163 (N163). Each is a channel the\n * 2A03 does not have — a waveform drawn in RAM, played back at a pitch — and\n * games that use them put their melody there, so without them a soundtrack is\n * its bass and drums.\n *\n * Like the APU here they run at the sample rate, not per CPU cycle: each sample\n * advances the chip by `CPU_HZ / sampleRate` cycles' worth of its counters.\n *\n * Output is in the units `mixApu` returns (0..~1 for the whole 2A03), so a\n * renderer adds it to the mix. The levels relative to the 2A03 follow the\n * common reference players: FDS at full gain about as loud as both pulses at\n * full, an N163 channel at full volume about as loud as one pulse — divided by\n * the number of channels it time-shares its one output with, as the chip does.\n */\n\nimport { CPU_HZ } from './constants.js';\n\n/** Full-scale output of the FDS (wave 63 × gain 32 at master volume 1), in `mixApu` units. */\nconst FDS_FULL = 0.25;\n/** Full-scale output of one N163 sample step (|sample - 8| = 8 at volume 15), in `mixApu` units. */\nconst N163_FULL = 0.16;\n/** The FDS master volume, `$4089` bits 0–1: 1, 2/3, 1/2, 2/5. */\nconst FDS_MASTER = [1, 2 / 3, 1 / 2, 2 / 5];\n/** Mod table entries → how far each moves the mod counter; 4 resets it. */\nconst MOD_STEP = [0, 1, 2, 4, 0, -4, -2, -1];\n\nexport interface FdsSnapshot {\n /** 12-bit wave frequency; Hz = CPU_HZ * frequency / 4194304. */\n frequency: number;\n /** Volume gain as the chip uses it, 0..32. */\n gain: number;\n /** `$4089` bits 0–1. */\n master: number;\n /** The 64 wave samples, 0..63. */\n wave: number[];\n /** Wave unit halted (`$4083` bit 7) or the wave being written (`$4089` bit 7). */\n halted: boolean;\n /** Modulation depth (mod gain, 0..63) and frequency: a vibrato when both are above 0. */\n modGain: number;\n modFrequency: number;\n}\n\nexport class FdsChip {\n private readonly cyclesPerSample: number;\n readonly wave = new Uint8Array(64);\n private readonly modTable = new Uint8Array(64);\n private modWritePos = 0;\n private frequency = 0;\n private haltWave = true;\n private envelopesOff = true;\n private waveWrite = false;\n private master = 0;\n private envSpeed = 0xe8;\n // Volume envelope.\n private volDirect = true;\n private volIncrease = false;\n private volSpeed = 0;\n private volGain = 0;\n private volCounter = 0;\n // Mod envelope and unit.\n private modDirect = true;\n private modIncrease = false;\n private modSpeed = 0;\n private modGain = 0;\n private modCounterEnv = 0;\n private modFrequency = 0;\n private modHalt = true;\n private modCounter = 0;\n private modPos = 0;\n private modAcc = 0;\n private waveAcc = 0;\n private wavePos = 0;\n /** Gain latched at the start of each wave cycle, as the chip does: a level change waits for the cycle. */\n private latchedGain = 0;\n\n constructor(sampleRate: number) {\n this.cyclesPerSample = CPU_HZ / sampleRate;\n }\n\n /** A write to `$4040`–`$408A`. Returns false for any other address. */\n write(address: number, value: number): boolean {\n const v = value & 0xff;\n if (address >= 0x4040 && address <= 0x407f) {\n if (this.waveWrite) this.wave[address - 0x4040] = v & 0x3f;\n return true;\n }\n switch (address) {\n case 0x4080:\n this.volDirect = (v & 0x80) !== 0;\n this.volIncrease = (v & 0x40) !== 0;\n this.volSpeed = v & 0x3f;\n if (this.volDirect) this.volGain = v & 0x3f;\n this.volCounter = 0;\n return true;\n case 0x4082:\n this.frequency = (this.frequency & 0xf00) | v;\n return true;\n case 0x4083:\n this.frequency = (this.frequency & 0x0ff) | ((v & 0x0f) << 8);\n this.haltWave = (v & 0x80) !== 0;\n this.envelopesOff = (v & 0x40) !== 0;\n if (this.haltWave) {\n this.waveAcc = 0;\n this.wavePos = 0;\n }\n return true;\n case 0x4084:\n this.modDirect = (v & 0x80) !== 0;\n this.modIncrease = (v & 0x40) !== 0;\n this.modSpeed = v & 0x3f;\n if (this.modDirect) this.modGain = v & 0x3f;\n this.modCounterEnv = 0;\n return true;\n case 0x4085:\n this.modCounter = ((v & 0x7f) << 25) >> 25; // 7-bit signed\n return true;\n case 0x4086:\n this.modFrequency = (this.modFrequency & 0xf00) | v;\n return true;\n case 0x4087:\n this.modFrequency = (this.modFrequency & 0x0ff) | ((v & 0x0f) << 8);\n this.modHalt = (v & 0x80) !== 0;\n if (this.modHalt) this.modAcc = 0;\n return true;\n case 0x4088:\n // Only while the mod unit is halted; each write fills two steps.\n if (this.modHalt) {\n this.modTable[this.modWritePos] = v & 7;\n this.modTable[(this.modWritePos + 1) & 63] = v & 7;\n this.modWritePos = (this.modWritePos + 2) & 63;\n }\n return true;\n case 0x4089:\n this.waveWrite = (v & 0x80) !== 0;\n this.master = v & 3;\n return true;\n case 0x408a:\n this.envSpeed = v;\n return true;\n }\n return address >= 0x4040 && address <= 0x4097;\n }\n\n /** The pitch the wave unit runs at this moment, after modulation (the chip's own arithmetic). */\n private modulatedFrequency(): number {\n if (this.modHalt || this.modGain === 0) return this.frequency;\n let temp = this.modCounter * this.modGain;\n const rem = temp & 0x0f;\n temp >>= 4;\n if (rem > 0 && (temp & 0x80) === 0) temp += this.modCounter < 0 ? -1 : 2;\n if (temp >= 192) temp -= 256;\n else if (temp < -64) temp += 256;\n temp *= this.frequency;\n const rem2 = temp & 0x3f;\n temp >>= 6;\n if (rem2 >= 32) temp += 1;\n return Math.max(0, this.frequency + temp);\n }\n\n /**\n * Advance `count` samples, ADDING the output to `out` from `offset` (in `mixApu` units, centred\n * by the renderer's filters like the rest).\n */\n render(count: number, out: Float64Array, offset = 0) {\n const cps = this.cyclesPerSample;\n const masterScale = (FDS_MASTER[this.master] * FDS_FULL) / (63 * 32);\n for (let k = 0; k < count; k++) {\n // Envelopes: one step every 8 × envSpeed × (speed + 1) cycles.\n if (!this.envelopesOff && this.envSpeed > 0 && !this.haltWave) {\n if (!this.volDirect) {\n this.volCounter += cps;\n const period = 8 * this.envSpeed * (this.volSpeed + 1);\n while (this.volCounter >= period) {\n this.volCounter -= period;\n if (this.volIncrease) {\n if (this.volGain < 32) this.volGain++;\n } else if (this.volGain > 0) this.volGain--;\n }\n }\n if (!this.modDirect) {\n this.modCounterEnv += cps;\n const period = 8 * this.envSpeed * (this.modSpeed + 1);\n while (this.modCounterEnv >= period) {\n this.modCounterEnv -= period;\n if (this.modIncrease) {\n if (this.modGain < 32) this.modGain++;\n } else if (this.modGain > 0) this.modGain--;\n }\n }\n }\n // Mod unit: steps through its table as its accumulator overflows 16 bits.\n if (!this.modHalt && this.modFrequency > 0) {\n this.modAcc += this.modFrequency * cps;\n while (this.modAcc >= 0x10000) {\n this.modAcc -= 0x10000;\n const step = this.modTable[this.modPos];\n this.modPos = (this.modPos + 1) & 63;\n if (step === 4) this.modCounter = 0;\n else {\n this.modCounter += MOD_STEP[step];\n if (this.modCounter > 63) this.modCounter -= 128;\n else if (this.modCounter < -64) this.modCounter += 128;\n }\n }\n }\n // Wave unit: 64 steps a cycle, the accumulator 16 bits a step.\n if (!this.haltWave && !this.waveWrite) {\n this.waveAcc += this.modulatedFrequency() * cps;\n while (this.waveAcc >= 0x10000) {\n this.waveAcc -= 0x10000;\n this.wavePos = (this.wavePos + 1) & 63;\n if (this.wavePos === 0) this.latchedGain = Math.min(32, this.volGain);\n }\n if (this.latchedGain === 0 && this.volGain > 0 && this.wavePos === 0) this.latchedGain = Math.min(32, this.volGain);\n }\n const level = this.waveWrite ? 0 : this.wave[this.wavePos] * this.latchedGain;\n out[offset + k] += level * masterScale;\n }\n }\n\n snapshot(): FdsSnapshot {\n return {\n frequency: this.frequency,\n gain: Math.min(32, this.volGain),\n master: this.master,\n wave: Array.from(this.wave),\n halted: this.haltWave || this.waveWrite,\n modGain: this.modHalt ? 0 : this.modGain,\n modFrequency: this.modHalt ? 0 : this.modFrequency,\n };\n }\n}\n\nexport interface N163ChannelSnapshot {\n /** 0..7 — the register slot, `$40 + 8·slot` in the chip's RAM; slot 7 ($78) is always on. */\n slot: number;\n /** 18-bit frequency; Hz = CPU_HZ * frequency / (15 · 65536 · channels · length). */\n frequency: number;\n /** Wave length in 4-bit samples. */\n length: number;\n /** Where the wave starts, in 4-bit samples. */\n waveAddress: number;\n volume: number;\n /** The wave as it stands in RAM, `length` samples 0..15. */\n wave: number[];\n}\n\nexport interface N163Snapshot {\n /** How many channels are on, 1..8 — the top ones, from slot 7 down. */\n channels: number;\n active: N163ChannelSnapshot[];\n}\n\nexport class N163Chip {\n private readonly cyclesPerSample: number;\n readonly ram = new Uint8Array(128);\n private address = 0;\n private autoIncrement = false;\n private disabled = false;\n private readonly phase = new Float64Array(8);\n\n constructor(sampleRate: number) {\n this.cyclesPerSample = CPU_HZ / sampleRate;\n }\n\n /** A write to the address port (`$F800`), data port (`$4800`) or `$E000`. Returns false for others. */\n write(address: number, value: number): boolean {\n const v = value & 0xff;\n if (address >= 0xf800 && address <= 0xffff) {\n this.address = v & 0x7f;\n this.autoIncrement = (v & 0x80) !== 0;\n return true;\n }\n if (address >= 0x4800 && address <= 0x4fff) {\n this.ram[this.address] = v;\n if (this.autoIncrement) this.address = (this.address + 1) & 0x7f;\n return true;\n }\n if (address >= 0xe000 && address <= 0xe7ff) {\n this.disabled = (v & 0x40) !== 0;\n return true;\n }\n return false;\n }\n\n /** A read of the data port, as the CPU makes it — auto-increment included. */\n read(): number {\n const v = this.ram[this.address];\n if (this.autoIncrement) this.address = (this.address + 1) & 0x7f;\n return v;\n }\n\n get channels(): number {\n return ((this.ram[0x7f] >> 4) & 7) + 1;\n }\n\n /**\n * A channel's eight bytes: frequency low, middle, and high two bits with the wave length above\n * them; three bytes of phase; the wave's address; the volume. (Read off what Namco's own drivers\n * write — Erika to Satoru and Mappy Kids both put `$E0`/`$F0`, a 32- or 16-sample wave, in the\n * third byte.)\n */\n private channel(slot: number) {\n const base = 0x40 + slot * 8;\n const r = this.ram;\n return {\n frequency: r[base] | (r[base + 1] << 8) | ((r[base + 2] & 3) << 16),\n length: 256 - (r[base + 2] & 0xfc),\n waveAddress: r[base + 6],\n volume: r[base + 7] & 0x0f,\n };\n }\n\n private sample(index: number): number {\n const byte = this.ram[(index >> 1) & 0x7f];\n return index & 1 ? byte >> 4 : byte & 0x0f;\n }\n\n /**\n * Advance `count` samples, ADDING each active channel's output to `outs[slot]` (or, when a\n * channel has no buffer of its own, to `outs[8]` if given) from `offset`.\n */\n render(count: number, outs: readonly (Float64Array | undefined)[], offset = 0) {\n if (this.disabled) return;\n const n = this.channels;\n // Each channel is updated once every 15·n cycles, and the one DAC is shared n ways.\n const updatesPerSample = this.cyclesPerSample / (15 * n);\n const scale = N163_FULL / (8 * 15 * n);\n for (let slot = 8 - n; slot < 8; slot++) {\n const out = outs[slot] ?? outs[8];\n if (!out) continue;\n const c = this.channel(slot);\n if (c.volume === 0 || c.frequency === 0) continue;\n const step = c.frequency * updatesPerSample;\n const wrap = c.length * 0x10000;\n let phase = this.phase[slot];\n for (let k = 0; k < count; k++) {\n phase += step;\n if (phase >= wrap) phase %= wrap;\n const s = this.sample(((phase / 0x10000) | 0) + c.waveAddress);\n out[offset + k] += (s - 8) * c.volume * scale;\n }\n this.phase[slot] = phase;\n }\n }\n\n snapshot(): N163Snapshot {\n const n = this.channels;\n const active: N163ChannelSnapshot[] = [];\n for (let slot = 8 - n; slot < 8; slot++) {\n const c = this.channel(slot);\n const wave: number[] = [];\n for (let i = 0; i < Math.min(c.length, 256); i++) wave.push(this.sample(c.waveAddress + i));\n active.push({ slot, ...c, wave });\n }\n return { channels: this.disabled ? 0 : n, active: this.disabled ? [] : active };\n }\n}\n\n/** Hz of an FDS frequency register value. */\nexport const fdsHz = (frequency: number) => (CPU_HZ * frequency) / 4194304;\n\n/** Hz of an N163 channel, from its frequency, wave length and the number of channels on. */\nexport const n163Hz = (frequency: number, length: number, channels: number) =>\n (CPU_HZ * frequency) / (15 * 65536 * channels * length);\n"]}
1
+ {"version":3,"file":"expansion.js","sourceRoot":"","sources":["../src/expansion.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The expansion sound chips the Famicom's own games carried most: the Disk\n * System's wavetable voice (FDS), Namco's 163 (N163) and Konami's VRC6. Each\n * adds channels the 2A03 does not have — a waveform drawn in RAM played back at\n * a pitch, or two more pulses and a sawtooth — and games that use them put\n * their melody there, so without them a soundtrack is its bass and drums.\n *\n * Like the APU here they run at the sample rate, not per CPU cycle: each sample\n * advances the chip by `CPU_HZ / sampleRate` cycles' worth of its counters.\n *\n * Output is in the units `mixApu` returns (0..~1 for the whole 2A03), so a\n * renderer adds it to the mix. The levels relative to the 2A03 follow the\n * common reference players: FDS at full gain about as loud as both pulses at\n * full, an N163 channel at full volume about as loud as one pulse — divided by\n * the number of channels it time-shares its one output with, as the chip does —\n * and a VRC6 pulse at full volume one and a half times a 2A03 pulse, as Mesen2\n * mixes it (`VRC6_STEP`).\n */\n\nimport { CPU_HZ } from './constants.js';\n\n/** Full-scale output of the FDS (wave 63 × gain 32 at master volume 1), in `mixApu` units. */\nconst FDS_FULL = 0.25;\n/** Full-scale output of one N163 sample step (|sample - 8| = 8 at volume 15), in `mixApu` units. */\nconst N163_FULL = 0.16;\n/** The FDS master volume, `$4089` bits 0–1: 1, 2/3, 1/2, 2/5. */\nconst FDS_MASTER = [1, 2 / 3, 1 / 2, 2 / 5];\n/** Mod table entries → how far each moves the mod counter; 4 resets it. */\nconst MOD_STEP = [0, 1, 2, 4, 0, -4, -2, -1];\n/**\n * One step of the VRC6's output (pulse 0..15 + pulse 0..15 + saw 0..31), in `mixApu` units. From\n * Mesen2, which adds the chip's summed output × 15 (Core/NES/Mappers/Audio/Vrc6Audio.h) × 5\n * (Core/NES/NesSoundMixer.cpp, GetOutputVolume) to a 2A03 mix whose `mixApu` 1.0 is 5000 there:\n * 75 / 5000. A VRC6 pulse at volume 15 is so 0.225, about one and a half 2A03 pulses at 15.\n */\nconst VRC6_STEP = 75 / 5000;\n\nexport interface FdsSnapshot {\n /** 12-bit wave frequency; Hz = CPU_HZ * frequency / 4194304. */\n frequency: number;\n /** Volume gain as the chip uses it, 0..32. */\n gain: number;\n /** `$4089` bits 0–1. */\n master: number;\n /** The 64 wave samples, 0..63. */\n wave: number[];\n /** Wave unit halted (`$4083` bit 7) or the wave being written (`$4089` bit 7). */\n halted: boolean;\n /** Modulation depth (mod gain, 0..63) and frequency: a vibrato when both are above 0. */\n modGain: number;\n modFrequency: number;\n}\n\nexport class FdsChip {\n private readonly cyclesPerSample: number;\n readonly wave = new Uint8Array(64);\n private readonly modTable = new Uint8Array(64);\n private modWritePos = 0;\n private frequency = 0;\n private haltWave = true;\n private envelopesOff = true;\n private waveWrite = false;\n private master = 0;\n private envSpeed = 0xe8;\n // Volume envelope.\n private volDirect = true;\n private volIncrease = false;\n private volSpeed = 0;\n private volGain = 0;\n private volCounter = 0;\n // Mod envelope and unit.\n private modDirect = true;\n private modIncrease = false;\n private modSpeed = 0;\n private modGain = 0;\n private modCounterEnv = 0;\n private modFrequency = 0;\n private modHalt = true;\n private modCounter = 0;\n private modPos = 0;\n private modAcc = 0;\n private waveAcc = 0;\n private wavePos = 0;\n /** Gain latched at the start of each wave cycle, as the chip does: a level change waits for the cycle. */\n private latchedGain = 0;\n\n constructor(sampleRate: number) {\n this.cyclesPerSample = CPU_HZ / sampleRate;\n }\n\n /** A write to `$4040`–`$408A`. Returns false for any other address. */\n write(address: number, value: number): boolean {\n const v = value & 0xff;\n if (address >= 0x4040 && address <= 0x407f) {\n if (this.waveWrite) this.wave[address - 0x4040] = v & 0x3f;\n return true;\n }\n switch (address) {\n case 0x4080:\n this.volDirect = (v & 0x80) !== 0;\n this.volIncrease = (v & 0x40) !== 0;\n this.volSpeed = v & 0x3f;\n if (this.volDirect) this.volGain = v & 0x3f;\n this.volCounter = 0;\n return true;\n case 0x4082:\n this.frequency = (this.frequency & 0xf00) | v;\n return true;\n case 0x4083:\n this.frequency = (this.frequency & 0x0ff) | ((v & 0x0f) << 8);\n this.haltWave = (v & 0x80) !== 0;\n this.envelopesOff = (v & 0x40) !== 0;\n if (this.haltWave) {\n this.waveAcc = 0;\n this.wavePos = 0;\n }\n return true;\n case 0x4084:\n this.modDirect = (v & 0x80) !== 0;\n this.modIncrease = (v & 0x40) !== 0;\n this.modSpeed = v & 0x3f;\n if (this.modDirect) this.modGain = v & 0x3f;\n this.modCounterEnv = 0;\n return true;\n case 0x4085:\n this.modCounter = ((v & 0x7f) << 25) >> 25; // 7-bit signed\n return true;\n case 0x4086:\n this.modFrequency = (this.modFrequency & 0xf00) | v;\n return true;\n case 0x4087:\n this.modFrequency = (this.modFrequency & 0x0ff) | ((v & 0x0f) << 8);\n this.modHalt = (v & 0x80) !== 0;\n if (this.modHalt) this.modAcc = 0;\n return true;\n case 0x4088:\n // Only while the mod unit is halted; each write fills two steps.\n if (this.modHalt) {\n this.modTable[this.modWritePos] = v & 7;\n this.modTable[(this.modWritePos + 1) & 63] = v & 7;\n this.modWritePos = (this.modWritePos + 2) & 63;\n }\n return true;\n case 0x4089:\n this.waveWrite = (v & 0x80) !== 0;\n this.master = v & 3;\n return true;\n case 0x408a:\n this.envSpeed = v;\n return true;\n }\n return address >= 0x4040 && address <= 0x4097;\n }\n\n /** The pitch the wave unit runs at this moment, after modulation (the chip's own arithmetic). */\n private modulatedFrequency(): number {\n if (this.modHalt || this.modGain === 0) return this.frequency;\n let temp = this.modCounter * this.modGain;\n const rem = temp & 0x0f;\n temp >>= 4;\n if (rem > 0 && (temp & 0x80) === 0) temp += this.modCounter < 0 ? -1 : 2;\n if (temp >= 192) temp -= 256;\n else if (temp < -64) temp += 256;\n temp *= this.frequency;\n const rem2 = temp & 0x3f;\n temp >>= 6;\n if (rem2 >= 32) temp += 1;\n return Math.max(0, this.frequency + temp);\n }\n\n /**\n * Advance `count` samples, ADDING the output to `out` from `offset` (in `mixApu` units, centred\n * by the renderer's filters like the rest).\n */\n render(count: number, out: Float64Array, offset = 0) {\n const cps = this.cyclesPerSample;\n const masterScale = (FDS_MASTER[this.master] * FDS_FULL) / (63 * 32);\n for (let k = 0; k < count; k++) {\n // Envelopes: one step every 8 × envSpeed × (speed + 1) cycles.\n if (!this.envelopesOff && this.envSpeed > 0 && !this.haltWave) {\n if (!this.volDirect) {\n this.volCounter += cps;\n const period = 8 * this.envSpeed * (this.volSpeed + 1);\n while (this.volCounter >= period) {\n this.volCounter -= period;\n if (this.volIncrease) {\n if (this.volGain < 32) this.volGain++;\n } else if (this.volGain > 0) this.volGain--;\n }\n }\n if (!this.modDirect) {\n this.modCounterEnv += cps;\n const period = 8 * this.envSpeed * (this.modSpeed + 1);\n while (this.modCounterEnv >= period) {\n this.modCounterEnv -= period;\n if (this.modIncrease) {\n if (this.modGain < 32) this.modGain++;\n } else if (this.modGain > 0) this.modGain--;\n }\n }\n }\n // Mod unit: steps through its table as its accumulator overflows 16 bits.\n if (!this.modHalt && this.modFrequency > 0) {\n this.modAcc += this.modFrequency * cps;\n while (this.modAcc >= 0x10000) {\n this.modAcc -= 0x10000;\n const step = this.modTable[this.modPos];\n this.modPos = (this.modPos + 1) & 63;\n if (step === 4) this.modCounter = 0;\n else {\n this.modCounter += MOD_STEP[step];\n if (this.modCounter > 63) this.modCounter -= 128;\n else if (this.modCounter < -64) this.modCounter += 128;\n }\n }\n }\n // Wave unit: 64 steps a cycle, the accumulator 16 bits a step.\n if (!this.haltWave && !this.waveWrite) {\n this.waveAcc += this.modulatedFrequency() * cps;\n while (this.waveAcc >= 0x10000) {\n this.waveAcc -= 0x10000;\n this.wavePos = (this.wavePos + 1) & 63;\n if (this.wavePos === 0) this.latchedGain = Math.min(32, this.volGain);\n }\n if (this.latchedGain === 0 && this.volGain > 0 && this.wavePos === 0) this.latchedGain = Math.min(32, this.volGain);\n }\n const level = this.waveWrite ? 0 : this.wave[this.wavePos] * this.latchedGain;\n out[offset + k] += level * masterScale;\n }\n }\n\n snapshot(): FdsSnapshot {\n return {\n frequency: this.frequency,\n gain: Math.min(32, this.volGain),\n master: this.master,\n wave: Array.from(this.wave),\n halted: this.haltWave || this.waveWrite,\n modGain: this.modHalt ? 0 : this.modGain,\n modFrequency: this.modHalt ? 0 : this.modFrequency,\n };\n }\n}\n\nexport interface N163ChannelSnapshot {\n /** 0..7 — the register slot, `$40 + 8·slot` in the chip's RAM; slot 7 ($78) is always on. */\n slot: number;\n /** 18-bit frequency; Hz = CPU_HZ * frequency / (15 · 65536 · channels · length). */\n frequency: number;\n /** Wave length in 4-bit samples. */\n length: number;\n /** Where the wave starts, in 4-bit samples. */\n waveAddress: number;\n volume: number;\n /** The wave as it stands in RAM, `length` samples 0..15. */\n wave: number[];\n}\n\nexport interface N163Snapshot {\n /** How many channels are on, 1..8 — the top ones, from slot 7 down. */\n channels: number;\n active: N163ChannelSnapshot[];\n}\n\nexport class N163Chip {\n private readonly cyclesPerSample: number;\n readonly ram = new Uint8Array(128);\n private address = 0;\n private autoIncrement = false;\n private disabled = false;\n private readonly phase = new Float64Array(8);\n\n constructor(sampleRate: number) {\n this.cyclesPerSample = CPU_HZ / sampleRate;\n }\n\n /** A write to the address port (`$F800`), data port (`$4800`) or `$E000`. Returns false for others. */\n write(address: number, value: number): boolean {\n const v = value & 0xff;\n if (address >= 0xf800 && address <= 0xffff) {\n this.address = v & 0x7f;\n this.autoIncrement = (v & 0x80) !== 0;\n return true;\n }\n if (address >= 0x4800 && address <= 0x4fff) {\n this.ram[this.address] = v;\n if (this.autoIncrement) this.address = (this.address + 1) & 0x7f;\n return true;\n }\n if (address >= 0xe000 && address <= 0xe7ff) {\n this.disabled = (v & 0x40) !== 0;\n return true;\n }\n return false;\n }\n\n /** A read of the data port, as the CPU makes it — auto-increment included. */\n read(): number {\n const v = this.ram[this.address];\n if (this.autoIncrement) this.address = (this.address + 1) & 0x7f;\n return v;\n }\n\n /** The address port as it stands — the next RAM byte the data port reaches, with bit 7 for auto-increment. */\n get port(): number {\n return this.address | (this.autoIncrement ? 0x80 : 0);\n }\n\n get channels(): number {\n return ((this.ram[0x7f] >> 4) & 7) + 1;\n }\n\n /**\n * A channel's eight bytes, interleaved as on the chip: frequency low, phase low, frequency\n * middle, phase middle, the frequency's high two bits with the wave length above them, phase\n * high, the wave's address, the volume. (Namco's drivers write the frequency bytes and step over\n * the phase ones by READING the data port — auto-increment counts reads too.)\n */\n private channel(slot: number) {\n const base = 0x40 + slot * 8;\n const r = this.ram;\n return {\n frequency: r[base] | (r[base + 2] << 8) | ((r[base + 4] & 3) << 16),\n length: 256 - (r[base + 4] & 0xfc),\n waveAddress: r[base + 6],\n volume: r[base + 7] & 0x0f,\n };\n }\n\n private sample(index: number): number {\n const byte = this.ram[(index >> 1) & 0x7f];\n return index & 1 ? byte >> 4 : byte & 0x0f;\n }\n\n /**\n * Advance `count` samples, ADDING each active channel's output to `outs[slot]` (or, when a\n * channel has no buffer of its own, to `outs[8]` if given) from `offset`.\n */\n render(count: number, outs: readonly (Float64Array | undefined)[], offset = 0) {\n if (this.disabled) return;\n const n = this.channels;\n // Each channel is updated once every 15·n cycles, and the one DAC is shared n ways.\n const updatesPerSample = this.cyclesPerSample / (15 * n);\n const scale = N163_FULL / (8 * 15 * n);\n for (let slot = 8 - n; slot < 8; slot++) {\n const out = outs[slot] ?? outs[8];\n if (!out) continue;\n const c = this.channel(slot);\n if (c.volume === 0 || c.frequency === 0) continue;\n const step = c.frequency * updatesPerSample;\n const wrap = c.length * 0x10000;\n let phase = this.phase[slot];\n for (let k = 0; k < count; k++) {\n phase += step;\n if (phase >= wrap) phase %= wrap;\n const s = this.sample(((phase / 0x10000) | 0) + c.waveAddress);\n out[offset + k] += (s - 8) * c.volume * scale;\n }\n this.phase[slot] = phase;\n }\n }\n\n snapshot(): N163Snapshot {\n const n = this.channels;\n const active: N163ChannelSnapshot[] = [];\n for (let slot = 8 - n; slot < 8; slot++) {\n const c = this.channel(slot);\n const wave: number[] = [];\n for (let i = 0; i < Math.min(c.length, 256); i++) wave.push(this.sample(c.waveAddress + i));\n active.push({ slot, ...c, wave });\n }\n return { channels: this.disabled ? 0 : n, active: this.disabled ? [] : active };\n }\n}\n\n/** One of the VRC6's two pulses, `$9000`–`$9002` or `$A000`–`$A002`. */\nexport interface Vrc6PulseSnapshot {\n /** 12-bit period; Hz = CPU_HZ / (16 · (period + 1)) — see `vrc6PulseHz`. */\n period: number;\n volume: number;\n /** 0..7: high for duty + 1 of every 16 steps. */\n duty: number;\n /** The mode bit (`$x000` bit 7): the volume put out as it is, the duty ignored. */\n constant: boolean;\n enabled: boolean;\n}\n\nexport interface Vrc6Snapshot {\n pulse: [Vrc6PulseSnapshot, Vrc6PulseSnapshot];\n saw: {\n /** 12-bit period; Hz = CPU_HZ / (14 · (period + 1)) — see `vrc6SawHz`. */\n period: number;\n /** The accumulator rate, 0..63; past 42 the 8-bit accumulator wraps and the wave breaks up. */\n rate: number;\n enabled: boolean;\n };\n /** `$9003` bit 0: every oscillator stopped where it is. */\n halted: boolean;\n /** `$9003`: the periods shifted right by 4 (bit 1) or 8 (bit 2, which wins) — ×16 / ×256 pitch. */\n shift: number;\n}\n\ninterface Vrc6Pulse {\n volume: number;\n duty: number;\n constant: boolean;\n period: number;\n enabled: boolean;\n /** CPU cycles until the next step, fractional. */\n timer: number;\n step: number;\n}\n\n/**\n * Konami's VRC6: two pulses with eight duties and a sawtooth, beside the 2A03 (Akumajou Densetsu,\n * Madara, Esper Dream 2). The registers are at the addresses the NSF format gives them —\n * `$9000`–`$9003`, `$A000`–`$A002`, `$B000`–`$B002`; the cartridges themselves differ in which of\n * A0/A1 they wire to the chip, which a player maps before here.\n *\n * Each channel counts down `(period >> shift) + 1` CPU cycles a step, as Mesen2's Vrc6Pulse/Vrc6Saw\n * do. Output is the average over each sample of what the chip puts out, so a high note at a low\n * sample rate keeps its level.\n */\nexport class Vrc6Chip {\n private readonly cyclesPerSample: number;\n private readonly pulses: [Vrc6Pulse, Vrc6Pulse] = [Vrc6Chip.newPulse(), Vrc6Chip.newPulse()];\n private sawRate = 0;\n private sawPeriod = 0;\n private sawEnabled = false;\n private sawTimer = 1;\n private sawStep = 0;\n private sawAccumulator = 0;\n private halted = false;\n private shift = 0;\n\n private static newPulse(): Vrc6Pulse {\n return { volume: 0, duty: 0, constant: false, period: 0, enabled: false, timer: 1, step: 0 };\n }\n\n constructor(sampleRate: number) {\n this.cyclesPerSample = CPU_HZ / sampleRate;\n }\n\n /** A write to `$9000`–`$9003`, `$A000`–`$A002` or `$B000`–`$B002`. Returns false for any other address. */\n write(address: number, value: number): boolean {\n const v = value & 0xff;\n if (address === 0x9003) {\n this.halted = (v & 1) !== 0;\n this.shift = v & 4 ? 8 : v & 2 ? 4 : 0;\n return true;\n }\n if ((address >= 0x9000 && address <= 0x9002) || (address >= 0xa000 && address <= 0xa002)) {\n const p = this.pulses[address >> 12 === 0x9 ? 0 : 1];\n switch (address & 3) {\n case 0:\n p.volume = v & 0x0f;\n p.duty = (v >> 4) & 7;\n p.constant = (v & 0x80) !== 0;\n break;\n case 1:\n p.period = (p.period & 0xf00) | v;\n break;\n case 2:\n p.period = (p.period & 0x0ff) | ((v & 0x0f) << 8);\n p.enabled = (v & 0x80) !== 0;\n // Clearing E resets the duty step; the divider runs on.\n if (!p.enabled) p.step = 0;\n break;\n }\n return true;\n }\n if (address >= 0xb000 && address <= 0xb002) {\n switch (address & 3) {\n case 0:\n this.sawRate = v & 0x3f;\n break;\n case 1:\n this.sawPeriod = (this.sawPeriod & 0xf00) | v;\n break;\n case 2:\n this.sawPeriod = (this.sawPeriod & 0x0ff) | ((v & 0x0f) << 8);\n this.sawEnabled = (v & 0x80) !== 0;\n if (!this.sawEnabled) {\n this.sawStep = 0;\n this.sawAccumulator = 0;\n }\n break;\n }\n return true;\n }\n return false;\n }\n\n private static pulseLevel(p: Vrc6Pulse): number {\n if (!p.enabled) return 0;\n if (p.constant) return p.volume;\n return p.step <= p.duty ? p.volume : 0;\n }\n\n /**\n * Advance `count` samples, ADDING each channel's output to `outs[0]` (pulse 1), `outs[1]` (pulse\n * 2) and `outs[2]` (saw) — or, for a channel without a buffer of its own, to `outs[3]` if given —\n * from `offset`.\n */\n render(count: number, outs: readonly (Float64Array | undefined)[], offset = 0) {\n const cps = this.cyclesPerSample;\n const scale = VRC6_STEP / cps;\n const running = !this.halted;\n for (let c = 0; c < 2; c++) {\n const out = outs[c] ?? outs[3];\n const p = this.pulses[c];\n const reload = (p.period >> this.shift) + 1;\n // Not stepping, or stepping makes no difference: one level for the whole run.\n if (!running || !p.enabled || p.constant || p.volume === 0) {\n if (out) {\n const level = Vrc6Chip.pulseLevel(p) * VRC6_STEP;\n if (level !== 0) for (let k = 0; k < count; k++) out[offset + k] += level;\n }\n if (running && p.enabled) {\n // The duty step moves on all the same, for when the level comes back.\n const cycles = count * cps;\n if (cycles >= p.timer) {\n const steps = 1 + Math.floor((cycles - p.timer) / reload);\n p.step = (p.step + steps) & 15;\n p.timer = reload - ((cycles - p.timer) % reload);\n } else p.timer -= cycles;\n }\n continue;\n }\n for (let k = 0; k < count; k++) {\n let left = cps;\n let sum = 0;\n while (left >= p.timer) {\n sum += (p.step <= p.duty ? p.volume : 0) * p.timer;\n left -= p.timer;\n p.step = (p.step + 1) & 15;\n p.timer = reload;\n }\n sum += (p.step <= p.duty ? p.volume : 0) * left;\n p.timer -= left;\n if (out) out[offset + k] += sum * scale;\n }\n }\n {\n const out = outs[2] ?? outs[3];\n const reload = (this.sawPeriod >> this.shift) + 1;\n if (!running || !this.sawEnabled) {\n const level = this.sawEnabled ? (this.sawAccumulator >> 3) * VRC6_STEP : 0;\n if (out && level !== 0) for (let k = 0; k < count; k++) out[offset + k] += level;\n return;\n }\n for (let k = 0; k < count; k++) {\n let left = cps;\n let sum = 0;\n while (left >= this.sawTimer) {\n sum += (this.sawAccumulator >> 3) * this.sawTimer;\n left -= this.sawTimer;\n this.sawTimer = reload;\n // Fourteen steps a cycle: the accumulator grows on every other one and starts over on the 14th.\n this.sawStep = (this.sawStep + 1) % 14;\n if (this.sawStep === 0) this.sawAccumulator = 0;\n else if ((this.sawStep & 1) === 0) this.sawAccumulator = (this.sawAccumulator + this.sawRate) & 0xff;\n }\n sum += (this.sawAccumulator >> 3) * left;\n this.sawTimer -= left;\n if (out) out[offset + k] += sum * scale;\n }\n }\n }\n\n snapshot(): Vrc6Snapshot {\n const pulse = (p: Vrc6Pulse): Vrc6PulseSnapshot => ({\n period: p.period,\n volume: p.volume,\n duty: p.duty,\n constant: p.constant,\n enabled: p.enabled,\n });\n return {\n pulse: [pulse(this.pulses[0]), pulse(this.pulses[1])],\n saw: { period: this.sawPeriod, rate: this.sawRate, enabled: this.sawEnabled },\n halted: this.halted,\n shift: this.shift,\n };\n }\n}\n\n/** Hz of an FDS frequency register value. */\nexport const fdsHz = (frequency: number) => (CPU_HZ * frequency) / 4194304;\n\n/** Hz of an N163 channel, from its frequency, wave length and the number of channels on. */\nexport const n163Hz = (frequency: number, length: number, channels: number) =>\n (CPU_HZ * frequency) / (15 * 65536 * channels * length);\n\n/** Hz of a VRC6 pulse period (with `$9003`'s shift, if any): 16 steps of `(period >> shift) + 1` cycles. */\nexport const vrc6PulseHz = (period: number, shift = 0) => CPU_HZ / (16 * ((period >> shift) + 1));\n\n/** Hz of the VRC6 sawtooth's period (with `$9003`'s shift, if any): 14 steps of `(period >> shift) + 1` cycles. */\nexport const vrc6SawHz = (period: number, shift = 0) => CPU_HZ / (14 * ((period >> shift) + 1));\n"]}
package/dist/index.d.ts CHANGED
@@ -14,7 +14,7 @@
14
14
  export { CPU_HZ, DMC_PERIODS, DUTY_SEQUENCES, FRAME_HZ, LENGTH_TABLE, NOISE_PERIODS, QUARTER_FRAME_HZ, TRIANGLE_STEPS, } from './constants.js';
15
15
  export { Apu, type ApuChipOptions, type ApuMemory, type ApuSnapshot, type ChannelBuffers, } from './chip.js';
16
16
  export { mixApu, OutputFilters } from './mixer.js';
17
- export { FdsChip, N163Chip, fdsHz, n163Hz, type FdsSnapshot, type N163ChannelSnapshot, type N163Snapshot, } from './expansion.js';
17
+ export { FdsChip, N163Chip, Vrc6Chip, fdsHz, n163Hz, vrc6PulseHz, vrc6SawHz, type FdsSnapshot, type N163ChannelSnapshot, type N163Snapshot, type Vrc6PulseSnapshot, type Vrc6Snapshot, } from './expansion.js';
18
18
  export { SWEEP_HZ, decodeSweep, sweepMutes, sweepTarget, sweepTrace, type SweepConfig, } from './sweep.js';
19
19
  export { expansionOf, renderWrites, type Click, type RegisterWrite, type Render, type RenderOptions, } from './render.js';
20
20
  export { bendAt, EXPANSION_CHANNELS, levelAt, notesToWrites, renderNotes, sampleMemory, sampleSeconds, type DmcSample, type SampleRow, type ApuInput, type ApuOptions, type ApuRender, type BendCurve, type LevelCurve, type DrumRow, type PitchedRow, secondsToTick, tickToSeconds, type TempoChange, } from './notes.js';
package/dist/index.js CHANGED
@@ -14,7 +14,7 @@
14
14
  export { CPU_HZ, DMC_PERIODS, DUTY_SEQUENCES, FRAME_HZ, LENGTH_TABLE, NOISE_PERIODS, QUARTER_FRAME_HZ, TRIANGLE_STEPS, } from './constants.js';
15
15
  export { Apu, } from './chip.js';
16
16
  export { mixApu, OutputFilters } from './mixer.js';
17
- export { FdsChip, N163Chip, fdsHz, n163Hz, } from './expansion.js';
17
+ export { FdsChip, N163Chip, Vrc6Chip, fdsHz, n163Hz, vrc6PulseHz, vrc6SawHz, } from './expansion.js';
18
18
  export { SWEEP_HZ, decodeSweep, sweepMutes, sweepTarget, sweepTrace, } from './sweep.js';
19
19
  export { expansionOf, renderWrites, } from './render.js';
20
20
  export { bendAt, EXPANSION_CHANNELS, levelAt, notesToWrites, renderNotes, sampleMemory, sampleSeconds, secondsToTick, tickToSeconds, } from './notes.js';
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,MAAM,EACN,WAAW,EACX,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,GAAG,GAKJ,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EACL,OAAO,EACP,QAAQ,EACR,KAAK,EACL,MAAM,GAIP,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,QAAQ,EACR,WAAW,EACX,UAAU,EACV,WAAW,EACX,UAAU,GAEX,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,WAAW,EACX,YAAY,GAKb,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,MAAM,EACN,kBAAkB,EAClB,OAAO,EACP,aAAa,EACb,WAAW,EACX,YAAY,EACZ,aAAa,EAUb,aAAa,EACb,aAAa,GAEd,MAAM,YAAY,CAAC","sourcesContent":["/**\n * @xrom/apu — the NES sound chip (2A03 APU) in TypeScript.\n *\n * Two layers, usable separately:\n *\n * - **The chip.** `renderWrites(writes, seconds)` plays a list of register\n * writes — `{ time, address: 0x4000..0x4017, value }` — and returns samples.\n * Every NES game's music reaches the speaker as writes like these, so this\n * plays any game's music once its writes are known (from an emulator trace,\n * say). `Apu` is the same chip one sample at a time, for live use.\n * - **The note adapter.** `renderNotes(input)` takes music already decoded into\n * notes and writes what a driver would have written to sound them.\n */\n\nexport {\n CPU_HZ,\n DMC_PERIODS,\n DUTY_SEQUENCES,\n FRAME_HZ,\n LENGTH_TABLE,\n NOISE_PERIODS,\n QUARTER_FRAME_HZ,\n TRIANGLE_STEPS,\n} from './constants.js';\nexport {\n Apu,\n type ApuChipOptions,\n type ApuMemory,\n type ApuSnapshot,\n type ChannelBuffers,\n} from './chip.js';\nexport { mixApu, OutputFilters } from './mixer.js';\nexport {\n FdsChip,\n N163Chip,\n fdsHz,\n n163Hz,\n type FdsSnapshot,\n type N163ChannelSnapshot,\n type N163Snapshot,\n} from './expansion.js';\nexport {\n SWEEP_HZ,\n decodeSweep,\n sweepMutes,\n sweepTarget,\n sweepTrace,\n type SweepConfig,\n} from './sweep.js';\nexport {\n expansionOf,\n renderWrites,\n type Click,\n type RegisterWrite,\n type Render,\n type RenderOptions,\n} from './render.js';\nexport {\n bendAt,\n EXPANSION_CHANNELS,\n levelAt,\n notesToWrites,\n renderNotes,\n sampleMemory,\n sampleSeconds,\n type DmcSample,\n type SampleRow,\n type ApuInput,\n type ApuOptions,\n type ApuRender,\n type BendCurve,\n type LevelCurve,\n type DrumRow,\n type PitchedRow,\n secondsToTick,\n tickToSeconds,\n type TempoChange,\n} from './notes.js';\n"]}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,MAAM,EACN,WAAW,EACX,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,GAAG,GAKJ,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EACL,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,MAAM,EACN,WAAW,EACX,SAAS,GAMV,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,QAAQ,EACR,WAAW,EACX,UAAU,EACV,WAAW,EACX,UAAU,GAEX,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,WAAW,EACX,YAAY,GAKb,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,MAAM,EACN,kBAAkB,EAClB,OAAO,EACP,aAAa,EACb,WAAW,EACX,YAAY,EACZ,aAAa,EAUb,aAAa,EACb,aAAa,GAEd,MAAM,YAAY,CAAC","sourcesContent":["/**\n * @xrom/apu — the NES sound chip (2A03 APU) in TypeScript.\n *\n * Two layers, usable separately:\n *\n * - **The chip.** `renderWrites(writes, seconds)` plays a list of register\n * writes — `{ time, address: 0x4000..0x4017, value }` — and returns samples.\n * Every NES game's music reaches the speaker as writes like these, so this\n * plays any game's music once its writes are known (from an emulator trace,\n * say). `Apu` is the same chip one sample at a time, for live use.\n * - **The note adapter.** `renderNotes(input)` takes music already decoded into\n * notes and writes what a driver would have written to sound them.\n */\n\nexport {\n CPU_HZ,\n DMC_PERIODS,\n DUTY_SEQUENCES,\n FRAME_HZ,\n LENGTH_TABLE,\n NOISE_PERIODS,\n QUARTER_FRAME_HZ,\n TRIANGLE_STEPS,\n} from './constants.js';\nexport {\n Apu,\n type ApuChipOptions,\n type ApuMemory,\n type ApuSnapshot,\n type ChannelBuffers,\n} from './chip.js';\nexport { mixApu, OutputFilters } from './mixer.js';\nexport {\n FdsChip,\n N163Chip,\n Vrc6Chip,\n fdsHz,\n n163Hz,\n vrc6PulseHz,\n vrc6SawHz,\n type FdsSnapshot,\n type N163ChannelSnapshot,\n type N163Snapshot,\n type Vrc6PulseSnapshot,\n type Vrc6Snapshot,\n} from './expansion.js';\nexport {\n SWEEP_HZ,\n decodeSweep,\n sweepMutes,\n sweepTarget,\n sweepTrace,\n type SweepConfig,\n} from './sweep.js';\nexport {\n expansionOf,\n renderWrites,\n type Click,\n type RegisterWrite,\n type Render,\n type RenderOptions,\n} from './render.js';\nexport {\n bendAt,\n EXPANSION_CHANNELS,\n levelAt,\n notesToWrites,\n renderNotes,\n sampleMemory,\n sampleSeconds,\n type DmcSample,\n type SampleRow,\n type ApuInput,\n type ApuOptions,\n type ApuRender,\n type BendCurve,\n type LevelCurve,\n type DrumRow,\n type PitchedRow,\n secondsToTick,\n tickToSeconds,\n type TempoChange,\n} from './notes.js';\n"]}
package/dist/notes.d.ts CHANGED
@@ -39,6 +39,11 @@ import { type RegisterWrite, type RenderOptions } from './render.js';
39
39
  * those `period` is the frequency in hundredths of a hertz (their registers depend on the wave's
40
40
  * length and the chip's channel count, which the adapter chooses itself), `volume` is 0..15, and
41
41
  * `waveIndex` (the 14th field) points into `ApuInput.waves`: the waveform the note plays.
42
+ *
43
+ * 14 and 15 are the VRC6's pulses, 16 its sawtooth. There too `period` is hundredths of a hertz
44
+ * and `volume` 0..15; on a pulse `duty` is the chip's 0..7 (high for duty + 1 of 16 steps), or 8
45
+ * for its mode bit — the volume put out flat; on the saw `volume` stands for the accumulator rate
46
+ * on a 0..15 scale, written as rate = round(volume · 42 / 15) (42 is the loudest clean saw).
42
47
  */
43
48
  export type PitchedRow = readonly [
44
49
  number,
@@ -56,10 +61,11 @@ export type PitchedRow = readonly [
56
61
  number?,
57
62
  number?
58
63
  ];
59
- /** Pitched-row channels past the 2A03's: the FDS, then the N163's eight. */
64
+ /** Pitched-row channels past the 2A03's: the FDS, the N163's eight, then the VRC6's pulse, pulse, saw. */
60
65
  export declare const EXPANSION_CHANNELS: {
61
66
  readonly fds: 5;
62
67
  readonly n163: readonly [6, 7, 8, 9, 10, 11, 12, 13];
68
+ readonly vrc6: readonly [14, 15, 16];
63
69
  };
64
70
  /**
65
71
  * A level curve: `[position 0..1, level 0..15]` at each change of level, in order. The level holds
package/dist/notes.js CHANGED
@@ -25,8 +25,8 @@
25
25
  */
26
26
  import { CPU_HZ, DMC_PERIODS, FRAME_HZ, LENGTH_TABLE } from './constants.js';
27
27
  import { renderWrites } from './render.js';
28
- /** Pitched-row channels past the 2A03's: the FDS, then the N163's eight. */
29
- export const EXPANSION_CHANNELS = { fds: 5, n163: [6, 7, 8, 9, 10, 11, 12, 13] };
28
+ /** Pitched-row channels past the 2A03's: the FDS, the N163's eight, then the VRC6's pulse, pulse, saw. */
29
+ export const EXPANSION_CHANNELS = { fds: 5, n163: [6, 7, 8, 9, 10, 11, 12, 13], vrc6: [14, 15, 16] };
30
30
  /** The level a curve holds at `position`: the last point at or before it. */
31
31
  export function levelAt(curve, position) {
32
32
  let level = curve[0]?.[1] ?? 0;
@@ -364,7 +364,7 @@ export function notesToWrites(input, lead = 0) {
364
364
  }
365
365
  const hzOf = (row) => row[5] / 100;
366
366
  /**
367
- * The expansion channels' notes as writes: what a driver for the FDS or the N163 would write to
367
+ * The expansion channels' notes as writes: what a driver for the FDS, the VRC6 or the N163 would write to
368
368
  * sound them — the waveform when it changes, then the frequency and level, and once a frame the
369
369
  * level while it ramps and the frequency while it bends.
370
370
  */
@@ -431,6 +431,59 @@ function expansionWrites(input, lead, voicesOf, frames, put) {
431
431
  put(voice.end, 0x4080, 0x80);
432
432
  });
433
433
  }
434
+ // VRC6: two pulses and the saw, each its three registers; the period counts CPU cycles.
435
+ {
436
+ let started = false;
437
+ EXPANSION_CHANNELS.vrc6.forEach((channel, k) => {
438
+ const voices = voicesOf(input.pitched, ((row) => row[3] === channel && row[5] > 0));
439
+ if (voices.length === 0)
440
+ return;
441
+ if (!started)
442
+ put(0, 0x9003, 0x00); // running, no frequency shift
443
+ started = true;
444
+ const base = 0x9000 + k * 0x1000;
445
+ const saw = k === 2;
446
+ const periodOf = (hz) => Math.min(0xfff, Math.max(0, Math.round(CPU_HZ / ((saw ? 14 : 16) * hz)) - 1));
447
+ voices.forEach((voice, i) => {
448
+ const row = voice.row;
449
+ const level = levelAtOf(row);
450
+ const control = saw
451
+ ? (l) => Math.min(0x3f, Math.round((l * 42) / 15))
452
+ : (l) => (row[6] >= 8 ? 0x80 : (Math.max(0, row[6]) & 7) << 4) | l;
453
+ const period = periodOf(hzOf(row));
454
+ put(voice.start, base, control(level(0)));
455
+ put(voice.start, base + 1, period & 0xff);
456
+ put(voice.start, base + 2, 0x80 | (period >> 8));
457
+ const curve = curveOf(row);
458
+ const ramps = levelsOf(row) !== null || row[4] !== row[7];
459
+ if (curve || ramps) {
460
+ let lastLevel = level(0);
461
+ let lastPeriod = period;
462
+ for (const { time, position } of frames(voice.start, voice.end)) {
463
+ if (ramps) {
464
+ const now = level(position);
465
+ if (now !== lastLevel)
466
+ put(time, base, control(now));
467
+ lastLevel = now;
468
+ }
469
+ if (curve) {
470
+ const now = periodOf(hzOf(row) * Math.pow(2, bendAt(curve, position) / 12));
471
+ if (now !== lastPeriod) {
472
+ put(time, base + 1, now & 0xff);
473
+ // With E kept set: clearing it would restart the wave.
474
+ if (now >> 8 !== lastPeriod >> 8)
475
+ put(time, base + 2, 0x80 | (now >> 8));
476
+ }
477
+ lastPeriod = now;
478
+ }
479
+ }
480
+ }
481
+ const next = voices[i + 1];
482
+ if (!next || next.start > voice.end + 1e-9)
483
+ put(voice.end, base + 2, period >> 8);
484
+ });
485
+ });
486
+ }
434
487
  // N163: as many channels on as the piece uses, each with its own stretch of the chip's RAM.
435
488
  const n163Voices = EXPANSION_CHANNELS.n163.map((channel) => voicesOf(input.pitched, ((row) => row[3] === channel && row[5] > 0)));
436
489
  const used = n163Voices.reduce((most, voices, k) => (voices.length > 0 ? k + 1 : most), 0);
@@ -500,10 +553,10 @@ function expansionWrites(input, lead, voicesOf, frames, put) {
500
553
  const freqOf = (hz) => Math.min(0x3ffff, Math.max(1, Math.round((hz * 15 * 65536 * count * length) / CPU_HZ)));
501
554
  const regs = (freq, volume) => [
502
555
  freq & 0xff,
503
- (freq >> 8) & 0xff,
504
- ((256 - length) & 0xfc) | ((freq >> 16) & 3),
505
556
  0,
557
+ (freq >> 8) & 0xff,
506
558
  0,
559
+ ((256 - length) & 0xfc) | ((freq >> 16) & 3),
507
560
  0,
508
561
  start & 0xff,
509
562
  volumeByte(volume),
@@ -521,7 +574,9 @@ function expansionWrites(input, lead, voicesOf, frames, put) {
521
574
  const nowFreq = curve ? freqOf(hzOf(row) * Math.pow(2, bendAt(curve, position) / 12)) : lastFreq;
522
575
  if (nowFreq !== lastFreq) {
523
576
  // The frequency bytes alone, not the phase after them: that is the chip's running count.
524
- ramWrite(time, base, [nowFreq & 0xff, (nowFreq >> 8) & 0xff, ((256 - length) & 0xfc) | ((nowFreq >> 16) & 3)]);
577
+ ramWrite(time, base, [nowFreq & 0xff]);
578
+ ramWrite(time, base + 2, [(nowFreq >> 8) & 0xff]);
579
+ ramWrite(time, base + 4, [((256 - length) & 0xfc) | ((nowFreq >> 16) & 3)]);
525
580
  }
526
581
  if (nowLevel !== lastLevel)
527
582
  ramWrite(time, base + 7, [volumeByte(nowLevel)]);