ReMID.lv2

This is a MIDI implementation of a MOS8580 6581 SID chip using the reSID library. It includes support for scripted instruments that allow complex sonic control of the chip.

Dependencies: libglib-2.0 libjack-dev (standalone version) liblv2-dev (plugin version) libasound2-dev pkg-config

Once the dependencies are fulfilled return to this folder and run: mkdir build cd build cmake .. make sudo make install

Currently this will build and install the standalone and the lv2 plugin. At some point I hope it will allow just one or just the other if you want.

reMID has scripting capabilities so that you can create instruments and files containing banks of instruments. You cannot actually get any sound out of reMID without an instrument file (so naturally we include and install a default and several others can be found in instruments/). See instruments.conf for examples and more info on instrument parameters.

Note that the original design was intended to allow a sequencer to control a single instance of reMID and perform an entire chiptune piece through use of midi channels and program changes. That capability remains, but the more modern use of each instance having a sound is also available.

full documentation for the instrument programming is at http://gp2x.org/remid/inst_config.php A full datasheet of the SID is pretty helpful too if you aren't familiar with it. See http://archive.6502.org/datasheets/mos_6581_sid.pdf

Here are the basics for setting the registers. Usually working in hex is easier, though you can use decimal numbers if you really want. Note that the * for voice parameters is 1-3 (e.g. v2_control).

v*_control 0x80 - noise 0x40 - pulse (square/rectangle) 0x20 - saw 0x10 - triangle 0x04 - ring mod with voice(N-1) (where 1-1 == 3) 0x02 - sync with voice(N-1) (where 1-1 == 3)

v*_detune [-1000,1000] voice detune in cents/10

v*_pulse [0x000,0xfff]==[0,4095] pulse width when pulse waveform selected in control reg. 0x800 is a square wave. 0 is DC 0, 0xfff is DC 1

v_ad [0x00,0xff] 0xXY - X is attack, Y decay. They aren't linear, but larger is longer. The link above has tables. v_sr [0x00,0xff] 0xXY - same idea as ad register but sustain and release for each nibble

fltr_cutoff [0x000,0x7ff]==[0,2047] cutoff frequency which ranges linearly from about 30Hz to 12kHz (f=N*11970/2048+30) fltr_res_vic [0x00,0xf7] 0xXY - X sets filter resonance, Y sets filter voice input connections 0xX7 - filter all 3 voices 0xX4 - filter only voice3 0xX2 - filter only voice2 0xX1 - filter only voice1 0xX0 - bypass filter

fltr_mode 0x4 - highpass 0x2 - bandpass 0x1 - lowpass

There are some other options, but those are the most common. For scripting I recommend you look at some examples. The files in the instruments directory has many examples to look at. Each line starts with a '.' and line number and then one of the following commands:

OPCODE__|Argument_|Description___ nop | - | no operation wait | cycles | do nothing for N cycles goto | line, jumps | jump to line N in script, if 2nd arg provided, it will only jump M times stop | - | end script v_freq | hertz | set voice frequency directly in hz v_freq_pct | percent | change voice freq by N percent v_freq_hs | half-steps | change voice freq by N semitones v_detune | .1 cents | change voice freq by N/10 cents (semitone/1000) v_pulse | register | set pulse width register v_control | register | set control register v_ad | register | set attack and decay register v_sr | register | set sustain and release v_pulsemod | reg./cycle | add N to pulse width register each cycle v_gate | gate state | start (1) or stop (0) voice from sounding fltr_cutoff | register | set filter cutoff register fltr_cut_pct| percent | change filter cutoff register by N percent fltr_cutmod | .1 percent | each cycle change filter cutoff by N/10 percent fltr_res_vic| register | set filter resonance and voice input connections reg. fltr_mode | register | set filter mode (note this is shifted up into the upper nibble) env3_2fltr | - | modulate filter cutoff with output of v3's envelope, call this once and it starts modulation | | to stop modulation call fltr_cutmod 0 osc3_2fltr | - | modulate filter cutoff with output of v3's oscillator (use for LFO)