docs update (#519)

* docs update

mentions of fractal, new chips documentation, and other minor stuff

* add a link to the Fractal repo

as suggested by @breakthetargets

* better wording, less typos

papers/doc/7-systems/c64.md

@@ -1,9 +1,11 @@
 # Commodore 64
 
-a home computer with a synthesizer-grade sound chip of which people took decades to master.
+a home computer with a synthesizer-grade sound chip of which people took decades to master. Three oscillators with four selectable waveforms, ring modulation, oscillator sync, multimode filter, ADSR envelope...
 
 very popular in Europe and mostly due to the demoscene, which stretched the machine's limbs to no end.
 
+Two revisions do exist - 6581 (original chip) and 8580 (improved version with working waveform mixing and somewhat more consistent filter curves)
+
 # effects
 
 - `10xx`: change wave. the following values are accepted:

papers/doc/7-systems/namco.md

@@ -0,0 +1,13 @@
+# Namco WSG | Namco C15 | Namco C30
+
+a family of wavetable synth sound chips used by Namco in their arcade machines (Pacman and later). Waveforms are 4-bit, with 32-byte sample length.
+
+Everything starts with Namco WSG, simple 3ch wavetable with no extra frills. C15 is much more advanced sound source with 8 channels. C30 adds stereo output and noise mode.
+
+# effects
+
+-`10xx`: change waveform
+-`11xx`: toggle noise mode WARNING: only on C30
+
+
+

papers/doc/7-systems/oki.md

@@ -0,0 +1,9 @@
+# OKI MSM6258 | OKI MSM6295
+
+MSM6258 is a single-channel ADPCM sound source developed by OKI. It allows max sample rate of 15.6 kHz... with no variable pitch. Most prominent use of this chip was Sharp X68000 computer, where it was paired with Yamaha YM2151.
+
+MSM6295 is an upgrade from 6258 - it provides 4 ADPCM channels, at max 32 kHz (still no variable pitch though). Between late 80s and late 90s, it was one of the most common, if not THE most common soundchip used in arcade machines (Capcom, Toaplan, Kaneko, Atari, Tecmo, the list can go on and on...)
+
+# effects
+
+- `20xx`: set chip output rate

papers/doc/7-systems/ricoh.md

@@ -0,0 +1,8 @@
+# Ricoh RF5C68
+
+YM2612's sidekick - poor man's SPC-700. 8ch PCM sample-based synthesizer used in Sega Mega CD, Fujitsu FM Towns and some of Sega's arcade machines. Supports up to 64 Kbytes of external PCM data.
+
+# effects
+
+none so far.
+

papers/doc/7-systems/ym2612.md

@@ -2,6 +2,8 @@
 
 one of two chips that powered the Sega Genesis. It is a six-channel, four-operator FM synthesizer. Channel #6 can be turned into 8-bit PCM player.
 
+For 0.6pre1, Furnace can now support advanced YM2612 features that  [Fractal](https://gitlab.com/Natsumi/Fractal-Sound) sound driver adds: two software-mixed PCM channels (variable pitch, sample offsets, max 13.7 khz rate) and CSM - ch3 special mode feature that can be abused to produce rudimentary speech synthesis.
+
 # effects
 
 - `10xy`: set LFO parameters.
@@ -64,4 +66,4 @@ one of two chips that powered the Sega Genesis. It is a six-channel, four-operat
 - `5Cxx`: set D2R/SR of operator 1.
 - `5Dxx`: set D2R/SR of operator 2.
 - `5Exx`: set D2R/SR of operator 3.
-- `5Fxx`: set D2R/SR of operator 4.
+- `5Fxx`: set D2R/SR of operator 4.

papers/doc/7-systems/ymz280b.md

@@ -0,0 +1,7 @@
+# Yamaha YMZ280B (PCMD8)
+
+8ch PCM/ADPCM sample-based synthesizer designed for use with arcade machines. Lived throughout mid to late 90s. It has 16-level stereo panning, up to 16-bit PCM and up to 16Mbytes of external PCM data.
+
+# effects
+
+none so far.

papers/doc/7-systems/zxbeep.md

@@ -0,0 +1,10 @@
+# ZX Spectrum Speaker
+
+Rather than having a dedicated sound synthesizer, early ZX Spectrum models had one piezo beeper, controlled by Z80 CPU and ULA chip. It's capabilities should be on par with an IBM PC speaker... right?
+
+Not really - very soon talented programmers found out ways to output much more than one square wave channel. A lot of ZX beeper routines do exist, as of 0.6pre1 Furnace supports only one - Follin-like engine with 6 channels of narrow pulse wave and click drums.
+
+# effects
+
+- `12xx`: set pulse width
+- `17xx`: trigger overlay drums.