# Yarns (Mutable Instruments)

Canonical page: https://eurorackref.com/mutable-instruments/yarns/

- id: `mutable-instruments/yarns`
- width: 12 HP; depth: unknown mm
- power: +12 V 60 mA, −12 V 2 mA, +5 V ? mA
- status: current
- functions: MIDI-to-CV Interface, Polyphonic Operation, Step Sequencer, Euclidean rhythm, Master Clock, Clock Divider / Multiplier, Tempo / Clock Sync, Digital / Wavetable Oscillator, Slew Limiter, LFO

## Inputs

| Jack | Signals | Function | Voltage | Polarity | Normalled from / comes from | Source |
|---|---|---|---|---|---|---|
| MIDI IN | midi | MIDI input | not stated | unknown | — | 544 |

## Outputs

| Jack | Signals | Function | Voltage | Polarity | Normalled from / comes from | Source |
|---|---|---|---|---|---|---|
| MIDI OUT | midi | MIDI output / thru | not stated | unknown | MIDI interface, arpeggiator, sequencer | 544 |
| CV1 | pitch, cv, audio, trigger | CV output 1 | -3 to 7 V | not stated | MIDI interface, digital oscillator, vibrato LFO, portamento | 543 |
| CV2 | pitch, cv, audio, trigger | CV output 2 | -3 to 7 V | not stated | MIDI interface, digital oscillator, vibrato LFO, portamento | 543 |
| CV3 | pitch, cv, audio, trigger | CV output 3 | -3 to 7 V | not stated | MIDI interface, digital oscillator, vibrato LFO, portamento | 543 |
| CV4 | pitch, cv, audio, trigger | CV output 4 | -3 to 7 V | not stated | MIDI interface, digital oscillator, vibrato LFO, portamento | 543 |
| Gate 1 | gate, trigger | gate/trigger output 1 | 0 to 5 V | unipolar | MIDI interface | 543 |
| Gate 2 | gate, trigger | gate/trigger output 2 | 0 to 5 V | unipolar | MIDI interface | 543 |
| Gate 3 | gate, trigger, clock | gate/trigger output 3 | 0 to 5 V | unipolar | MIDI interface, clock | 543 |
| Gate 4 | gate, trigger | gate/trigger output 4 | 0 to 5 V | unipolar | MIDI interface, clock | 543 |

## Controls

| Control | Type | Function | Range | Affects | Source |
|---|---|---|---|---|---|
| Encoder | knob | scroll, select, edit settings | — | all settings | 543 |
| REC | button | step recording start/end | — | sequencer | 543 |
| START/STOP | button | starts/stops sequencer | — | sequencer, clock, arpeggiator | 543 |
| TAP | button | tap tempo | — | clock | 543 |
| LA(YOUT) | menu_setting | voices/parts layout | — | MIDI interface | 543 |
| PA(RT) | menu_setting | active part select | — | MIDI interface | 543 |
| CH(ANNEL) | menu_setting | MIDI reception channel | — | MIDI interface | 543 |
| NO(TE) | menu_setting | MIDI reception note | — | MIDI interface | 543 |
| >> (OUTPUT MIDI MODE) | menu_setting | MIDI output routing | — | MIDI OUT | 543 |
| VO(ICING) | menu_setting | voice allocation method | — | MIDI interface | 543 |
| NP (NOTE PRIORITY) | menu_setting | note priority | — | MIDI interface | 543 |
| RC (REMOTE CONTROL CHANNEL) | menu_setting | remote control channel | — | MIDI interface | 543 |
| LG (LEGATO) | menu_setting | legato gate/portamento behavior | — | portamento | 543 |
| PO(RTAMENTO) | menu_setting | portamento speed | — | portamento | 543 |
| BR (BEND RANGE) | menu_setting | pitch bend range | — | MIDI interface | 543 |
| VR (VIBRATO RANGE) | menu_setting | vibrato range | — | vibrato LFO | 543 |
| VS (VIBRATO SPEED) | menu_setting | vibrato speed | — | vibrato LFO | 543 |
| T- (TRIGGER DURATION) | menu_setting | trigger pulse duration | — | Gate 2, CV1, CV2, CV3, CV4 | 543 |
| T* (TRIGGER SCALING) | menu_setting | trigger velocity scaling | — | CV1, CV2, CV3, CV4 | 543 |
| T/\| (TRIGGER WAVESHAPE) | menu_setting | trigger pulse shape | — | CV1, CV2, CV3, CV4 | 543 |
| 3>, 4>, CV | menu_setting | CV output 3/4 source | — | CV3, CV4 | 543 |
| OS(CILLATOR) | menu_setting | oscillator waveform | — | digital oscillator | 543 |
| TT (TRANSPOSE) | menu_setting | coarse transposition | — | MIDI interface | 543 |
| TF (FINE TUNING) | menu_setting | fine tuning | — | CV1, CV2, CV3, CV4 | 543 |
| TS (TUNING SYSTEM) | menu_setting | tuning system | — | MIDI interface | 543 |
| TR (TUNING ROOT) | menu_setting | rotates tuning table | — | MIDI interface | 543 |
| Tx TUNING FACTOR | menu_setting | scales output voltage | — | CV1, CV2, CV3, CV4 | 543 |
| TE(MPO) | menu_setting | tempo | — | clock | 543 |
| SW(ING) | menu_setting | swing amount | — | clock | 543 |
| I/ (INPUT CLK DIV) | menu_setting | tempo divider | — | clock | 543 |
| MS (MANUAL START) | menu_setting | manual clock start | — | clock | 543 |
| C> (CLOCK OUTPUT) | menu_setting | clock on gates 3/4 | — | Gate 3, Gate 4 | 543 |
| O/ (OUTPUT CLK DIV) | menu_setting | clock output division | — | Gate 3 | 543 |
| B- (BAR DURATION) | menu_setting | bar/reset pulse period | — | Gate 4 | 543 |
| NU(DGE FIRST TICK) | menu_setting | reset-to-clock delay | — | Gate 3, Gate 4 | 543 |
| C/ (CLOCK DIV) | menu_setting | arp/sequencer step division | — | arpeggiator, sequencer | 543 |
| G- (GATE LENGTH) | menu_setting | arp/sequencer gate length | — | arpeggiator, sequencer | 543 |
| AR (ARP RANGE) | menu_setting | arpeggiator range | — | arpeggiator | 543 |
| AD (ARP DIRECTION) | menu_setting | arpeggio type | — | arpeggiator | 543 |
| AP (ARP PATTERN) | menu_setting | arpeggiator rhythmic pattern | — | arpeggiator | 543 |
| E- (EUCLIDEAN LENGTH) | menu_setting | euclidean pattern length | — | euclidean generator | 543 |
| EF (EUCLIDEAN FILL) | menu_setting | filled steps | — | euclidean generator | 543 |
| ER (EUCLIDEAN ROTATE) | menu_setting | pattern rotation | — | euclidean generator | 543 |

## Modes

- 1M Monophonic (LA(YOUT) = 1M) [543]
- 2M Dual monophonic (LA(YOUT) = 2M) [543]
- 4M Quad monophonic (LA(YOUT) = 4M) [543]
- 2P Duophonic (LA(YOUT) = 2P) [543]
- 4P Quadraphonic (LA(YOUT) = 4P) [543]
- 2> Duophonic polychaining (LA(YOUT) = 2>) [543]
- 4> Quadraphonic polychaining (LA(YOUT) = 4>) [543]
- 8> Octophonic polychaining (LA(YOUT) = 8>) [543]
- 4T Quad trigger (LA(YOUT) = 4T) [543]
- 4V Raw CC conversion (LA(YOUT) = 4V) [543]
- 3+ Polyphonic + monophonic (LA(YOUT) = 3+) [543]
- Recording [543]
- Latch [543]
- Load/save menu [543]
- Calibration [543]
- Quick setup [543]

## Specs

| Subject | Quantity | Value | Condition | Source |
|---|---|---|---|---|
| module | width | 12 HP | — | 543 |
| power | +12V current | 60 mA | — | 543 |
| power | -12V current | 2 mA | — | 543 |
| MIDI interface | voices / parts | ≤ 4 voices | — | 543 |
| polychaining | voices | ≤ 8 voices | 8> layout | 543 |
| sequencer | steps per part | 64 steps | — | 543 |
| programs | memory slots | 8 slots | — | 543 |
| BR (BEND RANGE) | range | 0 to 24 semitones | — | 543 |
| TF (FINE TUNING) | step | 0.0078125 semitones | — | 543 |
| TF (FINE TUNING) | step | 0.65 mV | — | 543 |
| TE(MPO) | internal clock minimum | 40 BPM | — | 543 |
| PO(RTAMENTO) | T and R settings each | 0 to 50 steps | — | 543 |
| Tx TUNING FACTOR | alpha scale ratio | 0.77965 ratio | — | 543 |
| CV outputs | DAC resolution | 16 bit | — | 543 |
| CV outputs | calibration range | -3 to 7 V | — | 543 |
| calibration | fine increment | 0.2 mV | — | 543 |
| calibration | coarse increment (TAP) | 6 mV | — | 543 |
| calibration | coarse increment (TAP) | 5 mV | v1.1 changelog | 544 |
| gate output | high level | 5 V | — | 543 |
| 4V layout | CC output range | 0 to 5 V | — | 543 |
| O/ (OUTPUT CLK DIV) | default | 16 note division | — | 543 |
| C/ (CLOCK DIV) | default | 16 note division | — | 543 |
| INIT | default tempo | 120 BPM | — | 543 |
| arpeggiator | release hold window | 1 eighth note | — | 543 |
| TS (TUNING SYSTEM) | raga settings | 1 to 27 settings | — | 543 |
| VS (VIBRATO SPEED) | free-running settings | 0 to 99 settings | — | 544 |
| firmware update | SysEx packet delay | ≥ 100 ms | — | 543 |
| firmware | packets | 64 to 100 packets | — | 543 |
| calibration | multimeter precision | ≥ 4.5 digits | — | 543 |

## Behavior

- arpeggiator: when AR setting zero → does not run [543]
- euclidean generator: when E- set to 0 → disabled, arp pattern used [543]
- AP (ARP PATTERN): when euclidean generator enabled → ignored [543]
- arpeggiator: when all keys released → stops after eighth note [543]
- arpeggiator: when latched, keys released → keeps running [543]
- latch: when START/STOP pressed again → unlatched, pattern continues [543]
- sequencer: when START/STOP or MIDI start → sequencer starts [543]
- arpeggiator: when note received, sequencer stopped → arpeggiator starts [543]
- sequence: when keyboard played during playback → transposes sequence [543]
- transposition: when monotimbral modes → relative to first note [543]
- recording: when REC during playback → progressive overwrite, keeps looping [543]
- recording: when past 64th step → back to step 1 [543]
- encoder-entered notes: when recorded without keyboard → full velocity [543]
- internal clock: when tempo below 40 BPM → external MIDI clock expected [543]
- clock: when MS setting active → starts only via START/STOP [543]
- Gate 3/4: when quad layouts, C> enabled → clock and reset outputs [543]
- Gate 4: when B- set to oo → pulse at start only [543]
- Gate 4: when B- set to 0 → high while sequence runs [543]
- Gate 2: when 4T, voice 2 on → voice 1 trigger here [543]
- Gate 1: when 4T, voice 2 off → voice 1 trigger here [543]
- pitch bend: when BR set to 0 → disabled [543]
- vibrato: when VR set to 0 → disabled [543]
- VS (VIBRATO SPEED): when set to clock division → LFO locked to MIDI clock [543]
- T- (TRIGGER DURATION): when 1M or 2> layouts → expressed in milliseconds [543]
- T- (TRIGGER DURATION): when 4T layout → exponential scale, up to seconds [543]
- TR (TUNING ROOT): when equal temperament → no effect [543]
- TT (TRANSPOSE): when any tuning → keyboard transposition, not offset [543]
- OS(CILLATOR): when set to OFF → channel acts as CV output [543]
- oscillator: when 1M layout → on CV4 [543]
- oscillator: when 2M or 2P layouts → on CV3 and CV4 [543]
- oscillator: when 4M or 4P layouts → on CV1-CV4 [543]
- LG (LEGATO): when non-monophonic layouts → not available [543]
- NP (NOTE PRIORITY): when multiple voices per part → not shown [543]
- VO(ICING): when single voice per part → not shown [543]
- U1: when one of two keys released → remaining note to all [543]
- U2: when one of two keys released → no change [543]
- SO(RTED): when key released → no note reassignment [543]
- AR (ARP RANGE): when 4T layout → becomes RG, ON/OFF only [543]
- AP (ARP PATTERN): when 4T layout → becomes RP [543]
- power-up: when module powered on → program P1 loaded [543]
- Quick setup: when one note played → 1M created [543]
- Quick setup: when two notes same channel → 2P created [543]
- Quick setup: when more than two notes → 4P created [543]
- Quick setup: when notes on 2+ channels → 2M or 4M created [543]
- Quick setup: when adjacent notes played → split created [543]
- Quick setup: when all notes channel 10 → 4T created [543]
- swing: when external MIDI clock → still applied [544]
- 2>/4>/8> layouts: when voices beyond outputs → forwarded to MIDI OUT [543]
- firmware update: when transmission error → display shows Er [543]

## Sources

- [543] Yarns Manual (full) (manual): https://pichenettes.github.io/mutable-instruments-documentation/modules/yarns/manual/
- [544] Yarns Firmware changelog (firmware_notes): https://pichenettes.github.io/mutable-instruments-documentation/modules/yarns/firmware/
- [545] Yarns Quickstart Guide (manual): https://pichenettes.github.io/mutable-instruments-documentation/modules/yarns/downloads/yarns_quickstart.pdf
- [546] Yarns Secrets (hidden features) (manual): https://pichenettes.github.io/mutable-instruments-documentation/modules/yarns/secrets/

Full record as JSON: https://eurorackref.com/mutable-instruments/yarns.json
