diff --git a/doc/7-systems/watarasv.md b/doc/7-systems/watarasv.md
new file mode 100644
index 000000000..84bc052d6
--- /dev/null
+++ b/doc/7-systems/watarasv.md
@@ -0,0 +1,19 @@
+# Watara Supervision
+
+a failed competitor of Game Boy, straight from Taiwan. released in 1992, it had a tilting screen, $50 price tag, very fast 4 MHz 6502-like CPU, framebuffer graphics and sound capabilities similia to Game Boy.
+
+these are 2 pulse wave channels (same as on GB), barely working PCM channel and noise channel, also not unlike Game Boy. no hardware envelopes or zombie mode, though
+## effects
+
+- `12xx`: **set duty cycle/noise mode.**
+  - range is `0` to `3 ` for pulses and `0` to `1` for noise.
+## info
+
+this chip uses the [Watara Supervision](../4-instrument/vatarasv.md) and [Generic Sample](../4-instrument/sample.md) instrument editors.
+
+## chip config
+
+the following options are available in the Chip Manager window:
+
+- **Swap noise duty cycles**: enabled by default. when enabled, short noise is on odd-indexed duty cycles, like on Game Boy, rather than even.
+- **Stereo pulse waves**: disabled by default. when enabled, it forces pulse channel 1 to the right output channel and second pulse to the left output channel.