document chip options

2024-07-06 14:52:07 -05:00 · 2024-07-06 14:52:07 -05:00 · c6a9277d51
parent 221bc23955
commit c6a9277d51
53 changed files with 457 additions and 6 deletions
--- a/doc/7-systems/5e01.md
+++ b/doc/7-systems/5e01.md
@ -60,3 +60,12 @@ a fantasy sound chip created by Euly, based on the Ricoh 2A03, with some improve
 ## info

 this chip uses the [NES](../4-instrument/nes.md) instrument editor.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Clock rate**: sets the rate at which the chip will run.
+- **DPCM channel mode**: allows you to set which mode to use for the DPCM channel.
+  - DPCM: the default mode, playing 1-bit DPCM samples as supported by the hardware.
+  - PCM: this mode provides crispier samples by writing the delta counter directly. uses a lot of CPU time in console.
--- a/doc/7-systems/amiga.md
+++ b/doc/7-systems/amiga.md
@ -45,3 +45,15 @@ this chip uses the [Generic Sample](../4-instrument/sample.md) instrument editor
 - the maximum rate for sample playback is technically 31469Hz but anything higher than 28867Hz will sound glitchy on hardware.
 - sample lengths and loop will be set to an even number.
 - samples can't be longer than 131070.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Stereo separation**: sets the amount of left/right separation.
+- **Model**: allows you to change the chipset.
+  - Amiga 500 (OCS): has a low-pass filter on top of the user-selectable filter.
+  - Amiga 1200 (AGA): doesn't have the aforementioned low-pass filter.
+- **Chip memory**: more chip memory means more space for samples.
+- **PAL**: run the chip at PAL clock (3.54MHz) instead of NTSC (3.58MHz).
+- **Bypass frequency limits**: when enabled, the ~31KHz frequency limit is disabled, allowing you to play higher notes.
--- a/doc/7-systems/ay8910.md
+++ b/doc/7-systems/ay8910.md
@ -64,3 +64,18 @@ AY-3-810 was an absurdly popular chip that was blessed with many third-party clo
 ## info

 this chip uses the [AY-3-8910](../4-instrument/ay8910.md) instrument editor.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Clock rate**: sets the rate at which the chip will run.
+- **Chip type**: changes the chip model.
+  - AY-3-8910: the original model.
+  - YM2149(F): Yamaha clone with higher envelope resolution and a different volume curve.
+  - Sunsoft 5B: a special model found in one of Sunsoft's Famicom cartridges.
+  - AY-3-8914: scrambled registers. has envelope volume control.
+- **Stereo**: enable stereo output. channel 1 is output left, channel 2 is output center and channel 3 is output right.
+  - **Separation**: allows you to set left/right separation.
+- **Half Clock divider**: pulls the half clock pin, running the chip at half the speed.
+  - only available in YM2149.
--- a/doc/7-systems/ay8930.md
+++ b/doc/7-systems/ay8930.md
@ -59,3 +59,12 @@ Furnace is able to do software PCM on AY8930, where all 3 channels can play 5-bi
 ## info

 this chip uses the [AY8930](../4-instrument/ay8930.md) instrument editor.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Clock rate**: sets the rate at which the chip will run.
+- **Stereo**: enable stereo output. channel 1 is output left, channel 2 is output center and channel 3 is output right.
+  - **Separation**: allows you to set left/right separation.
+- **Half Clock divider**: pulls the half clock pin, running the chip at half the speed.
--- a/doc/7-systems/c140.md
+++ b/doc/7-systems/c140.md
@ -15,3 +15,12 @@ none!
 ## info

 this chip uses the [C140](../4-instrument/c140.md) instrument editor.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Banking style**: change the sample bank scheme. used for VGM export.
+  - Namco System 2: 2MB available for samples.
+  - Namco System 21: 4MB available for samples.
+  - Raw: 16MB, but not supported by the VGM format!
--- a/doc/7-systems/c64.md
+++ b/doc/7-systems/c64.md
@ -79,3 +79,19 @@ the following icons are displayed when channel status is enabled in the pattern
  - ![gate bit disabled and test bit enabled](status-C64-gate-off-test-on.png) gate bit disabled and test bit enabled
  - ![text bit enabled](status-C64-test-on.png) test bit enabled
  - ![ch3off enabled in filter mode](status-C64-ch3off.png) ch3off enabled in filter mode
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Clock rate**: sets the rate at which the chip will run.
+- **Global parameter priority**: change the priority of macros which control global parameters, such as volume and filter.
+  - Left to right: process channels from 1 to 3. the last one to run macros will take effect.
+  - Last used channel: process channels from oldest to newest (since last note). the one which had the latest note on will take a effect.
+- **Hard reset envelope**: configure the envelope parameters used during the short reset before a note.
+- **Envelope reset time**: set how long will the pre-note reset last, in ticks.
+  - 0 disables reset, which prevents notes from triggering.
+  - 1 is short, but may exhibit SID envelope bugs.
+  - 2 is a good value.
+
+the other options are for compatibility with old Furnace and DefleMask, so they won't be documented here.
--- a/doc/7-systems/dac.md
+++ b/doc/7-systems/dac.md
@ -11,3 +11,13 @@ none yet.
 ## info

 this chip uses the [Generic Sample](../4-instrument/sample.md) instrument editor.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Output rate**: sets the output sample rate of the DAC.
+- **Output bit depth**: sets the bit depth of the DAC. higher values provide more resolution.
+- **Maximum volume**: sets the max value in the volume column.
+- **Stereo**: when enabled, you may use panning effects.
+- **Interpolation**: "softens" samples played back at lower rates.
--- a/doc/7-systems/es5506.md
+++ b/doc/7-systems/es5506.md
@ -44,3 +44,13 @@ it has a whopping 32 channels of 16-bit PCM and:
 ## info

 this chip uses the [ES5506](../4-instrument/es5506.md) instrument editor.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Initial channel limit**: sets how many channels are available for use. if reduced, output rate increases.
+- **Volume scale**: allows you to lower the overall volume to prevent clipping/distortion when using too many channels.
+- **Amiga channel volumes**: makes volume linear, from 0 to 64 (40 in hex). used in S3M, XM and IT import.
+- **Amiga-like pitch**: pretends to be an Amiga, with periodic slides. used in S3M, XM and IT import (the latter two when linear slides are disabled).
+  - only effective when pitch linearity is None.
--- a/doc/7-systems/fds.md
+++ b/doc/7-systems/fds.md
@ -29,3 +29,9 @@ it also offers an additional 6-bit, 64-byte wavetable sound channel with (somewh
 ## info

 this chip uses the [FDS](../4-instrument/fds.md) instrument editor.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Clock rate**: sets the rate at which the chip will run.
--- a/doc/7-systems/game-boy.md
+++ b/doc/7-systems/game-boy.md
@ -25,6 +25,21 @@ it has stereo sound, two pulse channels, a wave channel and a noise channel.

 this chip uses the [Game Boy](../4-instrument/game-boy.md) instrument editor.

+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Disable anti-click**: waveform switching requires a phase reset, which may cause clicks. Furnace uses a wave-position predicting algorithm to minimize these clicks. enable this option to disable it.
+- **Chip revision**: sets the chip model to use. most of these lack audible difference, but Game Boy Advance fixed the wave channel's inversion.
+- **Wave channel orientation**: allows you to set how is wave data written.
+  - in Game Boy:
+    - Exact data: wave data is written as-is. it will appear inverted in the output.
+    - Exact output: wave data is inverted so it appears correctly in the output.
+  - in Game Boy Advance:
+    - Normal: wave data is written as-is.
+    - Inverted: guess!
+- **Pretty please**: only for compatibility with Synchronize.dmf. do not use.
+
 ## links

 - [Gameboy sound hardware](https://gbdev.gg8.se/wiki/articles/Gameboy_sound_hardware) - detailed technical information
--- a/doc/7-systems/gba.md
+++ b/doc/7-systems/gba.md
@ -28,3 +28,16 @@ it features echo and up to 16 voices.
 ## info

 this chip uses the [GBA DMA](../4-instrument/gbadma.md) and [GBA MinMod](../4-instrument/gbaminmod.md) instrument editors.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **DAC bit depth**: sets the bit depth.
+
+these options are available when using MinMod:
+
+- **Volume scale**: scale volumes to prevent clipping/distortion.
+- **Mix buffers**: sets how many mix buffers will be stored in memory. higher values result in longer echo.
+- **Channel limit**: sets the number of channels that will be available. higher values use more CPU.
+- **Sample rate**: sets the mixing rate. higher values use more CPU.
--- a/doc/7-systems/genesis.md
+++ b/doc/7-systems/genesis.md
@ -59,3 +59,7 @@ CSM is beyond the scope of this documentation. for more information, see this [b
 ## Sega CD

 this isn't a mode so much as a chip configuration. it adds the [Ricoh RF5C68](ricoh.md) found in the Sega CD add-on, providing 8 channels of PCM.
+
+## chip config
+
+see [YM2612](ym2612.md) and [SN76489](sms.md) for respective configuration.
--- a/doc/7-systems/k007232.md
+++ b/doc/7-systems/k007232.md
@ -15,3 +15,9 @@ yeah.
 ## info

 this chip uses the [K007232](../4-instrument/k007232.md) instrument editor.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Stereo**: enable use of panning effects.
--- a/doc/7-systems/k056320.md
+++ b/doc/7-systems/k056320.md
@ -11,3 +11,9 @@ this chip is a sample-based chip that featured in a number of Konami arcade game
 ## info

 this chip uses the [K053260](../4-instrument/k053260.md) instrument editor.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Clock rate**: sets the rate at which the chip will run.
--- a/doc/7-systems/lynx.md
+++ b/doc/7-systems/lynx.md
@ -23,3 +23,10 @@ the Atari Lynx has a 6502-based CPU with a sound part (this chip is known as MIK
 ## info

 this chip uses the [Atari Lynx](../4-instrument/lynx.md) instrument editor.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Consistent frequency across all duties**: uses an algorithm to calculate frequency depending on duty.
+  - make sure you reset phase on each note. otherwise sudden changes in the LFSR may make this option less effective.
--- a/doc/7-systems/mmc5.md
+++ b/doc/7-systems/mmc5.md
@ -14,3 +14,9 @@ additionally, it offers an 8-bit DAC which can be used to play samples. only one
 ## info

 this chip uses the [NES](../4-instrument/nes.md) and [Generic Sample](../4-instrument/sample.md) instrument editors.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Clock rate**: sets the rate at which the chip will run.
--- a/doc/7-systems/msm5232.md
+++ b/doc/7-systems/msm5232.md
@ -28,3 +28,13 @@ Furnace implements this chip in a way that allows the following features:
 ## info

 this chip uses the [MSM5232](../4-instrument/msm5232.md) instrument editor.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Detune**: sets detune in 128ths of a semitone.
+- **Capacitor values**: allows you to change the capacitance of the 8 capacitors connected to the chip. longer values increase envelope length.
+- **Initial part volume**: sets the initial volume of each "part" (octave) in a group.
+- **Envelope mode**: sets whether to use an external volume input (in this case, macros) or the built-in envelope generator.
+- **Global vibrato**: nudges the clock to simulate vibrato.
--- a/doc/7-systems/msm6258.md
+++ b/doc/7-systems/msm6258.md
@ -24,6 +24,10 @@ MSM6258 is an extremely basic ADPCM sound codec. it has no variable frequency ra
 | 8 MHz              | 15625 Hz      |
 | 8.192 MHz          | 16000 Hz      |

+the following options are available in the Chip Manager window:
+
+- **Clock rate**: sets the rate at which the chip will run.
+
 ## info

 this chip uses the [MSM6258](../4-instrument/msm6258.md) instrument editor.
--- a/doc/7-systems/msm6295.md
+++ b/doc/7-systems/msm6295.md
@ -39,3 +39,11 @@ like MSM6258, MSM6295 is an extremely basic ADPCM sound codec. it has no variabl
 MSM6295 clock rate could be divided by 132 (resulting sample rates above), or by 165.
 to get a clock rate using divisor of 165, formula is clock rate (in Hz) / 165.
 example: 1 MHz MSM6295 in 165 divisor mode results in output rate of 6060 Hz.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Clock rate**: sets the rate at which the chip will run.
+- **Output rate**: sets the chip clock divider.
+- **Bankswitched**: add an NMK112 chip to increase sample memory.
--- a/doc/7-systems/n163.md
+++ b/doc/7-systems/n163.md
@ -39,13 +39,17 @@ if the waveform changes (e.g. ins change, wave macro or wave synth), or the **lo
  - make sure to use `21xx` first!
 - `21xx`: **set position for 20xx.**

-## chip options
+## info

+this chip uses the [Namco 163](../4-instrument/n163.md) instrument editor.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Clock rate**: sets the rate at which the chip will run.
 - **Initial channel limit**: sets the number of channels that will be active. higher values reduce volume and make TDM artifacts more noticeable.
 - **Disable hissing**: remove TDM artifacts by mixing. sacrifices some accuracy!
 - **Scale frequency to wave length**: automatically adjusts note frequency to account for differing waveform lengths.
  - if disabled, note frequencies ignore waveveform length. this is how FamiTracker behaves.

-## info
-
-this chip uses the [Namco 163](../4-instrument/n163.md) instrument editor.
--- a/doc/7-systems/namco.md
+++ b/doc/7-systems/namco.md
@ -12,3 +12,15 @@ everything starts with Namco WSG, which is a simple 3-channel wavetable with no
 ## info

 this chip uses the [Namco WSG](../4-instrument/wsg.md) instrument editor.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Waveform storage mode**: selects whether RAM or ROM is connected to the chip.
+  - RAM: connects RAM for unlimited waves.
+  - ROM: connects ROM. authentic to hardware, but only the first 8 waves are loaded.
+
+Namco C30 does not have the aforementioned option as it always uses RAM for waveforms. instead, it has this option:
+
+- **Compatible noise frequencies**: for compatibility with old Furnace.
--- a/doc/7-systems/nds.md
+++ b/doc/7-systems/nds.md
@ -16,3 +16,8 @@ additionally, the last 8 channels may be put in "PSG mode", featuring 6 channels

 this chip uses the [Nintendo DS](../4-instrument/nds.md) instrument editor.

+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Model**: set the amount of memory available for samples.
--- a/doc/7-systems/nes.md
+++ b/doc/7-systems/nes.md
@ -63,6 +63,15 @@ the console is powered by the Ricoh 2A03, a CPU with sound generator built-in. i

 this chip uses the [NES](../4-instrument/nes.md) instrument editor.

+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Clock rate**: sets the rate at which the chip will run.
+- **DPCM channel mode**: allows you to set which mode to use for the DPCM channel.
+  - DPCM: the default mode, playing 1-bit DPCM samples as supported by the hardware.
+  - PCM: this mode provides crispier samples by writing the delta counter directly. uses a lot of CPU time in console.
+
 ## short noise frequencies (NTSC)

 note  | arpeggio | fundamental | MIDI note | pitch
--- a/doc/7-systems/opl.md
+++ b/doc/7-systems/opl.md
@ -84,3 +84,14 @@ afterwards everyone moved to Windows and software mixed PCM streaming...
 this chip uses the [FM (OPL)](../4-instrument/fm-opl.md) instrument editor.

 when two channels are joined for 4-op mode, the channel bar will show `4OP` on a bracket tying them together.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Clock rate**: sets the rate at which the chip will run.
+
+additionally, in OPL3:
+
+- **Chip type**: sets the chip model. OPL3-L uses resampling.
+- **Compatible panning**: for compatibility with old Furnace.
--- a/doc/7-systems/opll.md
+++ b/doc/7-systems/opll.md
@ -69,7 +69,14 @@ the YM2413 is equipped with the following features:

 this chip uses the [FM (OPLL)](../4-instrument/fm-opll.md) instrument editor.

-## chip options
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Clock rate**: sets the rate at which the chip will run.
+- **Patch set**: changes the chip model, providing different built-in sounds.
+
+the following options are visible in drums mode:

 - **Ignore top/hi-hat frequency changes**: in drums mode, makes the top/hi-hat channels not write frequency since they share it with snare and tom.
 - **Apply fixed frequency to all drums at once**: sets the frequency of all drums to that of a fixed frequency OPLL drums instrument when one note with it is reached.
--- a/doc/7-systems/opz.md
+++ b/doc/7-systems/opz.md
@ -117,3 +117,10 @@ no plans have been made for TX81Z MIDI passthrough, because:
 ## info

 this chip uses the [FM (OPZ)](../4-instrument/fm-opz.md) instrument editor.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Pseudo-PAL**: run the chip on a PAL clock. such a configuration has never been used in hardware.
+- **Broken pitch macro/slides**: due to an oversight, pitch slides were twice as fast in older versions of Furnace. this option exists for compatibility.
--- a/doc/7-systems/pce.md
+++ b/doc/7-systems/pce.md
@ -32,3 +32,11 @@ the following icons are displayed when channel status is enabled in the pattern
 - noise mode (channels 5 and 6 only):
  - ![noise mode off](status-PCE-noise-off.png) off
  - ![noise mode on](status-PCE-noise-on.png) on
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Pseudo-PAL**: run the chip on a PAL clock. such a configuration has (probably) never existed, despite a planned official PAL version of the PC Engine.
+- **Disable anti-click**: waveform switching requires a phase reset, which may cause clicks. Furnace uses a wave-position predicting algorithm to minimize these clicks. enable this option to disable it.
+- **Chip revision**: sets the chip revision. HuC6280A has less pops.
--- a/doc/7-systems/pcspkr.md
+++ b/doc/7-systems/pcspkr.md
@ -33,3 +33,15 @@ ha! effects...
 ## info

 this chip uses the [Beeper](../4-instrument/beeper.md) instrument editor.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Clock rate**: sets the rate at which the chip will run.
+- **Speaker type**: select which speaker to use:
+  - **Unfiltered**: raw square wave.
+  - **Cone**: filter it to simulate the sound of a cone speaker.
+  - **Piezo**: simulate the tiny speaker present in most PCs from the 2000s.
+  - **Use system beeper**: use the actual PC speaker in your machine for output. only works on Linux!
+- **Reset phase on frequency change**: reset phase every time the frequency changes. many modern motherboards tend to do this.
--- a/doc/7-systems/pokey.md
+++ b/doc/7-systems/pokey.md
@ -43,3 +43,9 @@ this chip uses the [POKEY](../4-instrument/pokey.md) instrument editor.
 when two channels are joined for filtered output, the channel bar will show `filter` on a bracket tying them together.

 when two channels are joined for wide period range, the channel bar will show `16-bit` on a bracket tying them together.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **PAL**: run the chip at PAL clock (1.77MHz) instead of NTSC (1.79MHz).
--- a/doc/7-systems/qsound.md
+++ b/doc/7-systems/qsound.md
@ -22,3 +22,10 @@ there are also 3 ADPCM channels. ADPCM samples are fixed to 8012Hz.
 ## info

 this chip uses the [QSound](../4-instrument/qsound.md) instrument editor.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Echo delay**: sets the length of the echo buffer.
+- **Echo feedback**: sets the amount of feedback on the echo.
--- a/doc/7-systems/ricoh.md
+++ b/doc/7-systems/ricoh.md
@ -9,3 +9,10 @@ none so far.
 ## info

 this chip uses the [RF5C68](../4-instrument/rf5c68.md) instrument editor.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Clock rate**: sets the rate at which the chip will run.
+- **Chip type**: changes the chip model.
--- a/doc/7-systems/saa1099.md
+++ b/doc/7-systems/saa1099.md
@ -31,3 +31,9 @@ this was used by the Game Blaster and SAM Coupé. it's pretty similar to the AY-
 ## info

 this chip uses the [SAA1099](../4-instrument/saa.md) instrument editor.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- sets the rate at which the chip will run.
--- a/doc/7-systems/scc.md
+++ b/doc/7-systems/scc.md
@ -13,3 +13,9 @@ the SCC+ fixes this issue though (while being compatible with SCC games).
 ## info

 this chip uses the [Konami SCC/Bubble System WSG](../4-instrument/scc.md) instrument editor.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Clock rate**: sets the rate at which the chip will run.
--- a/doc/7-systems/sm8521.md
+++ b/doc/7-systems/sm8521.md
@ -25,3 +25,9 @@ the sound-related features and quirks of the SM8521 are as follows:
 ## info

 this chip uses the [SM8521](../4-instrument/sm8521.md) instrument editor.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Clock rate**: sets the rate at which the chip will run.
--- a/doc/7-systems/sms.md
+++ b/doc/7-systems/sms.md
@ -34,3 +34,12 @@ SN7 was extremely popular due to low cost. therefore, it was cloned and copied t
 ## info

 this chip uses the [SN76489/Sega PSG](../4-instrument/psg.md) instrument editor.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Clock rate**: sets the rate at which the chip will run.
+- **Chip type**: changes the chip type. see above for more details.
+- **Disable noise period change phase reset**: when enabled, the noise channel won't be reset every time its frequency changes. very useful.
+- **Disable easy period to note mapping on upper octaves**: Furnace maps the notes in the upper octaves to periods, for easier noise tuning. this option allows you to disable this feature.
--- a/doc/7-systems/snes.md
+++ b/doc/7-systems/snes.md
@ -82,6 +82,18 @@ the following icons are displayed when channel status is enabled in the pattern
  - ![envelope sustain](status-SNES-env-S.png) envelope sustain
  - ![envelope release](status-SNES-env-R.png) envelope release

+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Volume scale**: scale volumes to prevent clipping/distortion.
+- **Enable echo**: enables the echo buffer.
+- **Initial echo state**: selects which channels will have echo applied.
+- **Delay**: sets echo length.
+- **Feedback**: sets how much of the echo output will be fed back into the buffer.
+- **Echo volume**: sets echo volume.
+- **Echo filter**: adjusts echo filter.
+
 ## ADSR

 | attack | 0→1 time | decay | 1→S time | sustain | ratio | release | S→0 time
--- a/doc/7-systems/soundunit.md
+++ b/doc/7-systems/soundunit.md
@ -58,3 +58,17 @@ it has the following capabilities:
 ## info

 this chip uses the [Sound Unit](../4-instrument/su.md) instrument editor.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **CPU rate**: sets the rate at which the chip will run.
+- **Sample memory**: sets the amount of memory available for samples.
+- **DAC resolution**: sets output resolution.
+- **Enable echo**: guess.
+- **Swap echo channels**: puts left into right and vice-versa.
+- **Echo delay**: set echo time.
+- **Echo resolution**: set echo resolution. sacrifices quality for time.
+- **Echo feedback**: guess.
+- **Echo volume**: yep, guess again.
--- a/doc/7-systems/t6w28.md
+++ b/doc/7-systems/t6w28.md
@ -13,3 +13,9 @@ this chip was used in Neo Geo Pocket.
 ## info

 this chip uses the [T6W28](../4-instrument/t6w28.md) instrument editor.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Disable easy period to note mapping on upper octaves**: Furnace maps the notes in the upper octaves to periods, for easier noise tuning. this option allows you to disable this feature.
--- a/doc/7-systems/ted.md
+++ b/doc/7-systems/ted.md
@ -12,3 +12,12 @@ none so far.
 ## info

 this chip uses the [TED](../4-instrument/ted.md) instrument editor.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Clock rate**: sets the rate at which the chip will run.
+- **Global parameter priority**: change the priority of macros which control global parameters, such as volume.
+  - Left to right: process channels from 1 to 3. the last one to run macros will take effect.
+  - Last used channel: process channels from oldest to newest (since last note). the one which had the latest note on will take a effect.
--- a/doc/7-systems/tia.md
+++ b/doc/7-systems/tia.md
@ -35,6 +35,18 @@ this chip uses the [TIA](../4-instrument/tia.md) instrument editor.

 the arp macro's fixed mode operates differently, writing the direct pitch to the chip. here's a list of pitches.

+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Software pitch driver**: use TIunA, a software pitch driver similar to TIATune. it increases pitch precision by rapidly switching between two pitches.
+- **Old pitch table**: use an older method to calculate pitch. only for compatibility.
+- **Mixing mode**: changes mixing mode.
+  - **Mono**: normal output.
+  - **Mono (no distortion)**: process each channel separately to eliminate distortion.
+  - **Stereo**: output two channels on left and right.
+- **PAL**: run slower blah blah blah
+
 ### shape 1

 | pitch |    NTSC | note | cent |    PAL  | note | cent
--- a/doc/7-systems/vera.md
+++ b/doc/7-systems/vera.md
@ -20,3 +20,10 @@ currently Furnace does not support the PCM channel's stereo mode, though (except
 ## info

 this chip uses the [VERA](../4-instrument/vera.md) and [Generic Sample](../4-instrument/sample.md) instrument editors.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Chip revision**: sets which revision of the chip to use.
+  - V 47.0.0 introduces a slightly different volume table.
--- a/doc/7-systems/vic20.md
+++ b/doc/7-systems/vic20.md
@ -20,3 +20,9 @@ these channels are not referred as "square" wave channels since a technique to p
 ## info

 this chip uses the [VIC](../4-instrument/vic.md) instrument editor.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **PAL**: 1.10MHz instead of 1.02MHz.
--- a/doc/7-systems/virtual-boy.md
+++ b/doc/7-systems/virtual-boy.md
@ -45,3 +45,11 @@ additionally, channel 5 offers a modulation/sweep unit. the former is similar to
 ## info

 this chip uses the [Virtual Boy](../4-instrument/virtual-boy.md) instrument editor.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Waveform storage mode**: selects how will waveforms be loaded.
+  - Dynamic: allows switching between many waves, but it is not confirmed whether this really works on hardware.
+  - Static: loads the first 5 waves only.
--- a/doc/7-systems/vrc6.md
+++ b/doc/7-systems/vrc6.md
@ -21,3 +21,9 @@ these effects only are effective in the pulse channels.
 ## info

 this chip uses the [VRC6](../4-instrument/vrc6.md) and [VRC6 (saw)](../4-instrument/vrc6.md) instrument editors.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Clock rate**: sets the rate at which the chip will run.
--- a/doc/7-systems/x1-010.md
+++ b/doc/7-systems/x1-010.md
@ -40,3 +40,11 @@ this chip was the inspiration for Organya/PxTone (the former being used in a wel
 ## info

 this chip uses the [X1-010](../4-instrument/x1_010.md) instrument editor.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Clock rate**: sets the rate at which the chip will run.
+- **Stereo**: enables stereo output. the chip supports this, but none of the actual boards use it.
+- **Bankswitched**: don't worry about it for now...
--- a/doc/7-systems/ym2151.md
+++ b/doc/7-systems/ym2151.md
@ -72,3 +72,9 @@ in most arcade boards the chip was used in combination with a PCM chip, like [Se
 ## info

 this chip uses the [FM (OPM)](../4-instrument/fm-opm.md) instrument editor.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Broken pitch macro/slides**: due to an oversight, pitch slides were twice as fast in older versions of Furnace. this option exists for compatibility.
--- a/doc/7-systems/ym2203.md
+++ b/doc/7-systems/ym2203.md
@ -110,4 +110,11 @@ all four operators are still combined according to the algorithm in use. for exa

 this chip uses the [FM (OPN)](../4-instrument/fm-opn.md) and [AY-3-8910/SSG](../4-instrument/ay8910.md) instrument editor.

+## chip config

+the following options are available in the Chip Manager window:
+
+- **Clock rate**: sets the rate at which the chip will run.
+- **Output rate**: sets the "prescale" parameter of the chip. allows you to run at a lower clock rate.
+- **SSG Volume**: sets volume of SSG part.
+- **FM Volume**: sets volume of FM part.
--- a/doc/7-systems/ym2608.md
+++ b/doc/7-systems/ym2608.md
@ -109,3 +109,12 @@ all four operators are still combined according to the algorithm in use. for exa
 ## info

 this chip uses the [FM (OPN)](../4-instrument/fm-opn.md), [AY-3-8910/SSG](../4-instrument/ay8910.md), [ADPCM-A](../4-instrument/adpcm-a.md) and [ADPCM-B](../4-instrument/adpcm-b.md) instrument editors.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Clock rate**: sets the rate at which the chip will run.
+- **Output rate**: sets the "prescale" parameter of the chip. allows you to run at a lower clock rate.
+- **SSG Volume**: sets volume of SSG part.
+- **FM Volume**: sets volume of FM part.
--- a/doc/7-systems/ym2610.md
+++ b/doc/7-systems/ym2610.md
@ -107,3 +107,11 @@ all four operators are still combined according to the algorithm in use. for exa
 ## info

 this chip uses the [FM (OPN)](../4-instrument/fm-opn.md), [AY-3-8910/SSG](../4-instrument/ay8910.md), [ADPCM-A](../4-instrument/adpcm-a.md) and [ADPCM-B](../4-instrument/adpcm-b.md) instrument editors.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- sets the rate at which the chip will run.
+- **SSG Volume**: sets volume of SSG part.
+- **FM Volume**: sets volume of FM part.
--- a/doc/7-systems/ym2610b.md
+++ b/doc/7-systems/ym2610b.md
@ -106,3 +106,11 @@ all four operators are still combined according to the algorithm in use. for exa
 ## info

 this chip uses the [FM (OPN)](../4-instrument/fm-opn.md), [AY-3-8910/SSG](../4-instrument/ay8910.md), [ADPCM-A](../4-instrument/adpcm-a.md) and [ADPCM-B](../4-instrument/adpcm-b.md) instrument editors.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- sets the rate at which the chip will run.
+- **SSG Volume**: sets volume of SSG part.
+- **FM Volume**: sets volume of FM part.
--- a/doc/7-systems/ym2612.md
+++ b/doc/7-systems/ym2612.md
@ -86,3 +86,15 @@ thanks to the Z80 sound CPU, DualPCM can play two samples at once! this mode spl
 ## info

 this chip uses the [FM (OPN)](../4-instrument/fm-opn.md) and [Generic Sample](../4-instrument/sample.md) instrument editors.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Clock rate**: sets the rate at which the chip will run.
+- **Chip type**: sets the chip type.
+  - YM3438: found in Model 2 and 3 Genesis. integrated version which fixes DAC distortion present in YM2612.
+  - YM2612: found in Model 1 Genesis. has DAC distortion.
+  - YMF276: found in FM Towns. uses external DAC and has higher output resolution.
+- **DAC interrupt simulation**: simulates the short interrupts that occur on each frame with quirky drivers (e.g. as found in Sonic 2 and 3).
+  - not supported in VGM export!
--- a/doc/7-systems/ymz280b.md
+++ b/doc/7-systems/ymz280b.md
@ -11,3 +11,9 @@ none so far.
 ## info

 this chip uses the [YMZ280B](../4-instrument/ymz280b.md) instrument editor.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Clock rate**: sets the rate at which the chip will run.
--- a/doc/7-systems/zxbeep.md
+++ b/doc/7-systems/zxbeep.md
@ -18,3 +18,13 @@ not really - very soon talented programmers found out ways to output much more t
 ## info

 this chip uses the [Beeper](../4-instrument/beeper.md) or [Pokémon Mini/QuadTone](../4-instrument/pokemini.md) instrument editor.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **PAL**: run at 3.54MHz instead of 3.58MHz.
+
+QuadTone provides this additional option:
+
+- **Disable hissing**: disables TDM hissing.