9. Reference

IV. Reference

Reference

Every control, key, page, and factory rhythm of the drum machine, in tables the build makes from its code, and the drum machine's state as a song's file holds it.

The voices' controls

Each voice's controls, as the panel's column has them top to bottom, by their names in song files and lanes. A switch's positions are its words. Every knob runs from 0 to 100, and its curve is how its value follows its travel: audio is an audio-taper potentiometer's, slow at first, as the levels have.

Bass drum

NameRangeDefaultCurve
bd_level0% to 100%50%audio
bd_tune0% to 100%50%linear
bd_tone0% to 100%50%linear
bd_decay0% to 100%50%linear
bd_attack0% to 100%0%linear

Snare drum

NameRangeDefaultCurve
sd_level0% to 100%50%audio
sd_tune0% to 100%50%linear
sd_tone0% to 100%50%linear
sd_snappy0% to 100%50%linear

Toms and congas

NameRangeDefaultCurve
lt_level0% to 100%50%audio
lt_tune0% to 100%50%linear
lt_decay0% to 100%50%linear
lt_congatom / congatomswitch
mt_level0% to 100%50%audio
mt_tune0% to 100%50%linear
mt_decay0% to 100%50%linear
mt_congatom / congatomswitch
ht_level0% to 100%50%audio
ht_tune0% to 100%50%linear
ht_decay0% to 100%50%linear
ht_congatom / congatomswitch

Rim shot and claves, hand clap and maracas, cowbell

NameRangeDefaultCurve
rs_level0% to 100%50%audio
rs_clavesrim / clavesrimswitch
cp_level0% to 100%50%audio
cp_maracasclap / maracasclapswitch
cb_level0% to 100%50%audio

Cymbal, hi-hats, and ride

NameRangeDefaultCurve
cy_level0% to 100%50%audio
cy_tune0% to 100%50%linear
cy_tone0% to 100%50%linear
cy_decay0% to 100%50%linear
oh_level0% to 100%50%audio
oh_decay0% to 100%50%linear
ch_level0% to 100%50%audio
ch_decay0% to 100%50%linear
rd_level0% to 100%50%audio
rd_tune0% to 100%50%linear

The machine's controls

NameRangeDefaultCurve
level-60 dB to 6 dB0 dBlinear
pan-100% to 100%0%linear
mutedoff / onoffswitch
accent0% to 100%50%linear
auto_fillmanual / 16 / 12 / 8 / 4 / 2manualswitch
fill1 / 2 / 3 / 41switch
fill_variationA / BAswitch
fill_variationA / BAswitch
runoff / playoffswitch

level and pan are the panel's volume and pan, and muted the track list's mute. run is start/stop, which pattern clips turn on and off; a song doesn't keep it.

How the voices are tuned

The voices' frequencies and decay times are the service notes' table of typical values (page 14), with a decay time read as the time to fall to a tenth, 20 dB. Where the 808 has no knob, the 909's spreads around the 808's value. These are the drum machine's values, from drums/voices.zig and drums/kit.zig, at a knob's 0, 50, and 100:

Voice Frequency Decay to a tenth
bass drum 38.5, 54.5, 77 Hz, by tune 50, 300, 800 ms
snare drum 238 and 476 Hz, ±0.4 octave 68 and 45 ms; snares 150 ms
low tom 80, 90, 100 Hz 81, 200, 492 ms
mid tom 120, 135, 160 Hz 53, 130, 320 ms
hi tom 165, 185, 220 Hz 41, 100, 246 ms
low conga 165, 185, 220 Hz 73, 180, 443 ms
mid conga 250, 280, 310 Hz 41, 100, 246 ms
hi conga 370, 400, 455 Hz 32, 80, 197 ms
rim shot 1667 and 455 Hz 15 ms, gated to about 10
claves 2500 Hz 35 ms
hand clap noise around 1 kHz three strikes 11 ms apart; 120 ms
maracas noise above 5 kHz 25 ms
cowbell 540 and 800 Hz squares 12 ms, then 75 ms
cymbal six squares, ±half an octave 350, 800, 1200 ms
open hi-hat six squares 87, 470, 610 ms
closed hi-hat six squares 20, 50, 160 ms
ride six squares, 1.35 times higher 1.4 s; its bell 80 ms

The six squares are at 205.3, 369.6, 304.4, 522.7, 800, and 540 Hz, after Werner, Abel, and Smith's measurements of the 808's cymbal. A drum's frequency is where it settles: struck, it starts higher and sighs down, by up to 16% for the bass drum, 20% for a tom, and 6% for a conga, at the full accent. Each voice's levels with and without accent are in chapter 5.

Keys

The voices' keys, which Drum Edit's rows, the letter keys, and a controller's pads play:

KeyNoteName
36C2bass drum
38D2snare drum
41F2low tom
45A2mid tom
48C3hi tom
37C#2rim shot
39D#2hand clap
56G#3cowbell
49C#3cymbal
46A#2open hihat
42F#2closed hihat
51D#3ride

Second keys, as on the 909: 35 plays the bass drum, 40 the snare, 43 the low tom, 44 the closed hi-hat, 47 the mid tom, and 50 the hi tom. The other keys play nothing. A key's velocity is its accent: 64 a plain hit, 96 one at the accent level, growing between, softer below 64, and no more above 96.

The letter keys play from C2 on a drum track: A C2, W C#2, S D2, E D#2, D E2, F F2, T F#2, G G2, Y G#2, H A2, U A#2, J B2, K C3, O C#3, L D3, P D#3, ; E3, and ' F3, at velocity 127. Z and X move them.

Pages

The pages of eight controls a controller's knobs turn, in order:

PageKnobs 1 to 8
1 kick snarebd_tune, bd_tone, bd_decay, bd_attack, sd_tune, sd_tone, sd_snappy, accent
2 tomslt_tune, lt_decay, mt_tune, mt_decay, ht_tune, ht_decay, lt_level, mt_level
3 cymbalscy_tune, cy_tone, cy_decay, oh_decay, ch_decay, rd_tune, cy_level, rd_level
4 levelsht_level, rs_level, cp_level, cb_level, oh_level, ch_level, pan, level

A controller's four faders, on the device's own, are bd_level, sd_level, ch_level, and oh_level.

Factory rhythms

RhythmNameStepsSteps a beatSwing
1-1rock164any
1-2rock 2164any
1-3disco164any
1-4backbeat164any
1-5shuffle123any
1-6bossa164any
1-7march328any
1-12rhythm 12164any
1-F1snare fill164any
1-F2tom fill164any
1-F3triplet fill246any
1-F4crash164any
2-1house164any
2-2deep house164any
2-3techno164any
2-4electro164any
2-5boom bap16458%
2-6breakbeat164any
2-7two-step16456%
2-8dembow164any
2-9trap328any
2-10funk164any
2-11half-time164any
2-12synth-pop164any
2-F1snare roll328any
2-F2tom run164any
2-F3build164any
2-F4stop164any

In song.json

A drum machine is a device of type drums in a song's devices, and its state is its controls, the program selected, and its memory:

{
  "name": "808",
  "type": "drums",
  "state": {
    "level": 0, "pan": 0, "muted": false, "accent": 60,
    "auto_fill": "manual", "fill": "1", "fill_variation": "A",
    "program": "3-1A",
    "voices": {
      "bd": { "level": 70, "tune": 50, "tone": 40, "decay": 60, "attack": 0 },
      "lt": { "conga": "tom" }
    },
    "rhythms": {
      "3-1": {
        "name": "mine", "swing": 54, "scale": 4, "steps": [16, 4], "flam": 3,
        "A": ["BD x...x...x...x...", "SD ....x.......X... xxxX", "CH x.x.x.x.x.x.x.x.", "AC x...x...x...x..."],
        "B": []
      }
    }
  }
}
  • The machine's controls come first, by their names in the table above; a switch takes its position's word, such as "manual" or "A", or for a two-way switch true or false.
  • program is the basic rhythm selected, as "3-1A", "3-1B", or "3-1AB"; a fill can't be.
  • voices holds each voice's controls under its two letters, by the name after the voice's, so bd_decay is "bd": { "decay": ... }.
  • rhythms holds rhythms by their place, 1-1 to 3-12 and 1-F1 to 3-F4. A rhythm has scale, its pre-scale in steps a beat, 3, 4, 6, or 8; steps, the 1st part's, or both parts' as [16, 4]; flam, the flam selector's 1 to 8; and its variations A and B, each a list of rows. name, up to 24 characters, and swing, the swing it wants from 50 to 75, are optional.
  • A row is a voice's two letters, as the panel writes them, or AC, then its steps: . a rest, x a hit, X an accented hit, f a flam, and F an accented flam. The 2nd part follows a space. Steps written past a part's last step follow a |, kept but not played. The AC row takes . and x, and only the drums flam.
  • Leave out what's empty: a voice with no hits has no row, and an empty rhythm no entry. With no rhythms at all, the drum machine holds the factory's; with rhythms, it holds only those. A rhythm without a name that plays as the factory's in its place takes the factory's name and swing.

Next: the studio's manual, of which this book is a part.