furnace/doc/7-systems/fds.md

# Famicom Disk System

the Famicom Disk System is an expansion device for the Famicom (known as NES outside Japan), a popular console from the '80s.
as it name implies, it allowed people to play games on specialized floppy disks that could be rewritten on vending machines, therefore reducing the cost of ownership and manufacturing.

it also offers an additional 6-bit, 64-byte wavetable sound channel with (somewhat limited) FM capabilities, which is what Furnace supports.

## effects

- `10xx`: **change wave.**
- `11xx`: **set modulation depth.**
- `12xy`: **set modulation speed high byte and toggle on/off.**
  - `x` is the toggle. a value of `1` turns on the modulator.
  - `y` is the speed.
- `13xx`: **set modulation speed low byte.**
- `14xx`: **set modulator position.**
- `15xx`: **set modulator wave.**
  - `xx` points to a wavetable. it should (preferably) have a height of 7 with the values mapping to:
    - 0: +0
    - 1: +1
    - 2: +2
    - 3: +3
    - 4: reset
    - 5: -3
    - 6: -2
    - 7: -1
  - **do not use this effect.** it only exists for compatibility reasons

## 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.
FDS: possibly final work the last thing left to do is the filter, but everything works now 2022-04-05 23:18:14 +00:00			`# Famicom Disk System`

Lots of little cleanup. Trying for more consistency and clarity, especially for quick reference. 2023-06-25 07:05:30 +00:00			`the Famicom Disk System is an expansion device for the Famicom (known as NES outside Japan), a popular console from the '80s.`
FDS: possibly final work the last thing left to do is the filter, but everything works now 2022-04-05 23:18:14 +00:00			`as it name implies, it allowed people to play games on specialized floppy disks that could be rewritten on vending machines, therefore reducing the cost of ownership and manufacturing.`

slightly improve fds docs 2022-04-08 20:34:13 +00:00			`it also offers an additional 6-bit, 64-byte wavetable sound channel with (somewhat limited) FM capabilities, which is what Furnace supports.`
FDS: possibly final work the last thing left to do is the filter, but everything works now 2022-04-05 23:18:14 +00:00
only one header per doc file 2023-09-11 00:34:13 +00:00			`## effects`
FDS: possibly final work the last thing left to do is the filter, but everything works now 2022-04-05 23:18:14 +00:00
Lots of little cleanup. Trying for more consistency and clarity, especially for quick reference. 2023-06-25 07:05:30 +00:00			- `10xx`: change wave.
			- `11xx`: set modulation depth.
			- `12xy`: set modulation speed high byte and toggle on/off.
			- `x` is the toggle. a value of `1` turns on the modulator.
FDS: possibly final work the last thing left to do is the filter, but everything works now 2022-04-05 23:18:14 +00:00			- `y` is the speed.
Lots of little cleanup. Trying for more consistency and clarity, especially for quick reference. 2023-06-25 07:05:30 +00:00			- `13xx`: set modulation speed low byte.
			- `14xx`: set modulator position.
			- `15xx`: set modulator wave.
FDS: possibly final work the last thing left to do is the filter, but everything works now 2022-04-05 23:18:14 +00:00			- `xx` points to a wavetable. it should (preferably) have a height of 7 with the values mapping to:
			`- 0: +0`
			`- 1: +1`
			`- 2: +2`
			`- 3: +3`
			`- 4: reset`
			`- 5: -3`
			`- 6: -2`
			`- 7: -1`
doc finalization: systems 2023-09-10 06:44:29 +00:00			`- do not use this effect. it only exists for compatibility reasons`
Documentation stuff! New page for the effect list, updates to chanOsc, and links to instrument types from every "system" page. 2023-08-04 16:11:53 +00:00
only one header per doc file 2023-09-11 00:34:13 +00:00			`## info`
Documentation stuff! New page for the effect list, updates to chanOsc, and links to instrument types from every "system" page. 2023-08-04 16:11:53 +00:00
Teensy formatting change. None of these should be list items. It was a bad idea. 2023-08-04 16:38:05 +00:00			`this chip uses the [FDS](../4-instrument/fds.md) instrument editor.`
document chip options 2024-07-06 19:52:07 +00:00
			`## chip config`

			`the following options are available in the Chip Manager window:`

			`- Clock rate: sets the rate at which the chip will run.`