Connect
Plug this computer into the Workshop Computer's front USB-C port instead of the Launchpad, then power-cycle the card (Reset alone may not be enough). The card chooses its USB role at power-up: a computer means editor, a Launchpad means sequencer. Use Chrome or Edge (they have WebMIDI); this page works opened straight from disk. When connected, the status line shows the firmware version, e.g. Blocks 1.0.0+a1b2c3d (a release build is plain 1.0.0).
Backup
A backup is one file with all 16 patterns and the shared settings (BPM, swing, transpose, mutes, chain, the eight editor settings). It holds what the card has now, including edits not saved to flash yet.
Restore
After a restore or a settings write, wait a few seconds before unplugging: the card saves to flash within a few seconds (3 s, or 10 s with that Auto-save setting).
Settings
Eight settings that have no Launchpad gesture. The card must be stopped to write them. They are saved with the rest of the card's settings.
Manual
What Blocks is ↑ contents
Blocks is a program card for the Workshop Computer. A Launchpad on the front USB-C port is the editor; the Computer's knobs are the fine controls. Four tracks run at once: CV1 and CV2 play notes (pitch on CV Out, gate on Pulse Out), AU1 and AU2 output voltages or triggers on Audio Out. Each step has a gate, five lanes and a microtiming nudge. Main is always BPM, and swing is live on a knob. Sixteen patterns can be switched or chained (up to 32 entries) while playing; a switch waits for the end of the longest track loop, so tracks of different lengths make polyrhythms. Everything is saved to the card's flash. The Novation logo pulses to the beat.
Without a Launchpad the card still runs: hold the Z switch down for 1 second to play or stop.
The Launchpad Mini MK3 is verified. The Launchpad X and Pro MK3 are supported but not yet tested on hardware.
Quick start ↑ contents
- Plug the Launchpad into the Computer's front USB-C port and press the Computer's Reset button. BLOCKS scrolls across the pads, then the grid appears.
- Patch CV Out 1 to a VCO's pitch input and Pulse Out 1 to an envelope or gate input.
- Tap a few pads on the top row: each lights a step (its gate). Tap pads lower down in the same column to set that step's note; the higher the pad, the higher the note.
- Press Play (top-left button). The white pad is the playhead; the Main knob sets the BPM.
- Try the CV2 button for a second melody, or Shift + View for patterns. Stop, wait a few seconds, and your work is saved. The editor (Connect, Backup, Settings tabs) needs the computer connected instead of the Launchpad, see Connect.
Gesture cheat-sheet ↑ contents
| Do this | To |
|---|---|
| Main knob (any Z) | BPM |
| Z middle: X / Y knob | note / microtiming of the selected step |
| Z up: X / Y knob | transpose / swing |
| Hold Z down 1 s | play / stop, no Launchpad needed (a quick tap of Z down rewinds) |
| Tap a step on row 1 | gate on/off and select it |
| Tap a pad in rows 2-8 | set the shown lane's level for that step |
| Shift + step | clear that step to its defaults |
| Shift + CV1/CV2/AU1/AU2 | clear that track's steps |
| OCT / Shift + OCT | view one octave up / down (CV tracks, note lane) |
| Shift + View | open Patterns (View returns to Focus) |
| Tap a slot (Patterns) | queue that pattern for the end of the longest track loop |
| Hold a slot, tap others, release | build a chain |
| Shift + slot | copy the playing pattern into that slot |
| Hold D (red pad), tap slots | delete those patterns and their chain entries |
| Tap / Shift + tap a chain entry | jump to it / remove it |
| Shift + hold a chain entry 1 s | delete the whole chain |
| Shift + Play (stopped) | save now, when auto-save is set to manual |
| Overview, side buttons 1, 3, 5, 7 | mute CV1, CV2, AU1, AU2 |
Panel ↑ contents
| Row | In 1 | In 2 | Out 1 | Out 2 |
|---|---|---|---|---|
| Audio | unused | unused | AU1 (track 3) | AU2 (track 4) |
| CV | transpose track 1 | transpose track 2 | track 1 pitch | track 2 pitch |
| Pulse | clock | reset (rewind) | track 1 gate | track 2 gate |
- Clock: a cable in Pulse In 1 switches the card to the external clock, one pulse per 1/16 note (changeable in the editor's Settings tab, see Editor settings below). Pull the cable out to return to the internal BPM. If the pulses stop, the card waits.
- Reset: a pulse in Pulse In 2 rewinds all tracks to step 1 on the next tick. A queued pattern switch happens if the reset arrives during the last step of the longest track loop (see Patterns); otherwise the reset just restarts the current pattern and the switch keeps waiting.
- CV In 1 / 2 transpose track 1 / 2 at 1 V per octave, kept in that track's scale (in major, +2 semitones moves the note one scale step).
- LEDs (three rows of two; left = Out 1, right = Out 2): the Audio row shows the AU1/AU2 level (dark at 0 V, bright at ±5 V); the CV row shows the pitch of track 1/2 (brighter = higher, dark while stopped); the Pulse row lights with the gates.
Knobs and the Z switch ↑ contents
| Z switch | Main | X | Y |
|---|---|---|---|
| Up (perform) | BPM, 80-180 by default (range set in the editor) | transpose −12…+12 semitones (CV tracks) | swing 50-71 % (the eight Settings values) |
| Middle (edit) | BPM, the same as in perform | the pitch lane (NTE/VAL) of the selected step | microtiming of the selected step, −11…+11 |
| Down (springs back) | tap = rewind; hold 1 second = play / stop | ||
- Main is always BPM. In the edit bank the X and Y knobs work only in Focus, on a selected step that is on the current page and inside the track's length. Setting a note with X also turns that step's gate on; Y (microtiming) changes neither the note nor the gate. Length, probability, ratchet and condition are set only by tapping their level rows on the pads.
- Pickup guard: after you change bank, track, lane or step, a knob does nothing until it reaches or passes the stored value, so nothing jumps. BPM and transpose work the same way, including right after power-up, so the saved BPM and transpose are kept until you turn past them.
- Knob numbers appear on the pads. Turning X switches the shown lane to pitch.
- BPM, transpose, mutes and swing are shared by all patterns.
Launchpad layout ↑ contents
Colours: hue means state. Track colours are orange (CV1), yellow (CV2), cyan (AU1), blue (AU2). Pink is the selection (the selected step, track, lane, or setting). White is the playhead. Dark grey is a step that is off but inside the length; no light is beyond the length. A lit Play button is green.
The Novation logo LED pulses to the beat: a short flash on every quarter note while playing (following the BPM or the external clock), dim while stopped. Its colour is picked at random at each power-up.
| Button | Does |
|---|---|
| Play | Play / stop (flashes a play or stop icon). Starting always begins on step 1 (the last step when reversed). |
| View | Focus ⇄ Overview. From Settings or Patterns it returns to Focus. Shift + View opens Patterns (from Focus or Settings). |
| ◄ ► | Previous / next page of 8 steps (8 pages = 64 steps). Flashes P1-P8. |
| CV1 CV2 AU1 AU2 | Choose the track being edited (flashes its name and the jacks it drives). Shift + track clears that track's steps (its length, div, scale etc. stay). |
| Shift | Held with another button or pad: clear / copy gestures (below). |
| Settings | Toggles Settings ⇄ Focus for the current track. From Patterns it goes to Settings. |
| NTE LEN PRB RTG CND | Choose the lane to edit; always lands in Focus (from Settings or Patterns). In Overview the side column is the mute buttons instead (see Overview), so press View first. |
| OCT | Bottom side button, active only in Focus on CV1/CV2 in the NTE lane (lit there, dark elsewhere). Tap = view one octave up; Shift + tap = one down. Flashes the track's root note and octave, e.g. E1-E5 with root E (the base octave is 3; C3 with root C). The button's colour shows the octave: darkest orange at octave 1, lightest at octave 5. Each CV track remembers its own view; it is not saved and resets at power-up. |
Focus view (the main editor) ↑ contents
Picture above: row 1 is the 8 gates of the page, rows 2-8 are bars for levels 6 (top) down to 0 (bottom).
- Row 1 holds the 8 gates of the current page (8 pages of 8 steps = 64 steps). Tap a step to switch its gate on or off and select it. Shift + tap clears the step to its defaults. Steps beyond the track's length are dark and ignored. A new or cleared step starts at the root note on CV tracks and at level 3 (0 V) on AU tracks.
- Rows 2-8 show the selected lane for those 8 steps, 7 levels (0-6). Each step with a gate shows a bar. Tap a pad to set that level: the top pad (row 2) is level 6, the bottom pad (row 8) is level 0. Tapping also turns the gate on. On the note lane the 7 rows are 7 consecutive scale degrees: one octave in a 7-note scale at range x1. Pentatonic scales and larger ranges span more.
- Octaves (CV tracks): each step is in one of 5 octaves (−2 … +2 around the base octave 3, e.g. E3 with root E) and the OCT button moves which one the note rows show. Each step's bar is drawn in its own octave's colour, the same darkest-to-lightest scale as the OCT button (pink if selected), so a bar whose colour differs from the OCT button is in another octave. Tapping a pad or turning the X knob moves that step into the octave you are viewing. Shift + tap (one step) and Shift + track button (the whole track) reset steps to the base octave, as does restoring a backup made before octaves. AU tracks have no octaves.
- Bars grow from the bottom, except the AU value lane, where bipolar bars grow from the centre row (row 5, level 3 = 0 V) and trigger tracks show no bars.
Lanes and their levels ↑ contents
Every step has a gate and five lanes, each with a level from 0 to 6, plus its microtiming (below). A new or cleared step has pitch 0, length level 3 (50 %), probability level 6 (100 %), ratchet level 0 (1 hit), condition 0 (always).
| Lane (label) | Level 0 → 6 |
|---|---|
| NTE pitch (CV tracks) | Scale degree above the root. The degree is the level × the track's range (x1-x4), so x2 gives degrees 0, 2, 4, 6, 8, 10, 12. Degrees wrap into octaves. The root C is note 48 (C3), plus the root setting, the X-knob transpose (Z switch up) and the CV-in transpose, plus the step's octave (−2 … +2, 12 semitones each). |
| VAL value (AU tracks) | Bipolar: −5, −3.3, −1.7, 0, +1.7, +3.3, +5 V (about; level 3 is 0 V). Unipolar: 0, 0.8, 1.7, 2.5, 3.3, 4.2, 5 V (about). Trigger: no value; the step fires a +5 V pulse. The level holds until the next step that plays. |
| LEN gate length | 5, 10, 25, 50, 75, 90, 98 % of each hit |
| PRB probability | 14, 29, 43, 57, 71, 86, 100 % chance the step plays |
| RTG ratchet | 1 to 7 equal hits inside the step |
| CND condition | 0 always · 1 even loops (1:2) · 2 odd loops (2:2) · 3 every 3rd loop (1:3) · 4 every 4th loop (1:4) · 5 first loop only · 6 every loop but the first. A loop is one pass through the track's length, counted from 0 at play start, in any direction. |
Microtiming ↑ contents
Push a step early or late for feel, flams and laid-back hi-hats. With Z in the middle, select a step and turn Y: the pads flash the offset from −11 (earliest) through 0 (on the grid, the default) to +11 (latest). One unit is 1/24 of a step at the track's own division, so ±11 is just under half a step (rounded toward zero, so on fast divisions the smallest values can round to nothing). The whole hit moves: gate length and every ratchet hit. Swing and microtiming add up.
- A gated step that is off the grid tints its gate pad: one colour for early, another for late. Pink (selected) and white (playhead) still show over it.
- Early steps work in every direction. After a pattern switch the early step is the first step of the new pattern. The first step after Play or a rewind can't play early.
- A step with its gate off ignores its microtiming. Shift + tap on a step and Shift + track reset it; copying a pattern keeps it.
Order of checks when a step comes up: gate on and track not muted → condition → probability → output (ratchet and length shape the gate).
Overview ↑ contents
- All four tracks at once, two rows each, 16 steps of the current page pair (◄ ► change page: P1-P2 show steps 1-16, P3-P4 steps 17-32, P5-P6 steps 33-48, P7-P8 steps 49-64). Tap a step to toggle its gate. White is each track's playhead; the playheads drift apart when tracks have different lengths or dividers (polymeter).
- The side column turns into mutes: the 1st, 3rd, 5th and 7th buttons (Shift, NTE, PRB, CND positions) mute CV1, CV2, AU1, AU2. A muted track shows dark gates and its gate is cut at once. Shift and the lane buttons do nothing here; press View to go back to Focus.
Settings view (for the current track) ↑ contents
Choose a track with its top-row button, then press Settings. Row 1 is the top row of pads.
| Row | Pads |
|---|---|
| 1 | Clock divider, pads 1-8: x2 · x1 · /2 · /3 · /4 · /6 · /8 · /16. x1 plays one step per 1/16 note. |
| 2 | Pads 1-4: direction FWD, REV, PNG (ping-pong: 0 1 2 3 2 1 0 1 …), RND (random). Pads 5-8: on CV tracks the pitch range x1-x4; on AU tracks pads 5-7 choose the type BIP (bipolar −5…+5 V), UNI (unipolar 0…+5 V), TRG (trigger pulses). |
| 3 | Scale, pads 1-8: major · minor · dorian · mixolydian · pentatonic major · pentatonic minor · harmonic minor · chromatic. |
| 4-5 | Root as a piano. Row 4 black keys (columns 2, 3, 5, 6, 7 = C♯ D♯ F♯ G♯ A♯), row 5 white keys (columns 1-7 = C D E F G A B). Root is pink, notes in the scale are the track colour, others dark. |
| 6 | Swing, pads 1-8: 50 · 53 · 56 · 59 · 62 · 65 · 68 · 71 %. Global; delays the second 1/16 of each pair. Internal clock only. The Y knob (Z up) sets the same value live. |
| 7-8 | Length: tap the pad of the track's last step in the current page pair (the 16 pads are steps 1-16 of P1-P2, 17-32 of P3-P4, and so on; pink = last step). Use ◄ ► to reach up to 64. |
Each track keeps its own divider, direction, range or type, scale, root and length. Swing is the same for all.
Patterns ↑ contents
Sixteen patterns, each holding all four tracks (up to 64 steps each). The editor always shows and edits the playing pattern. Open the Patterns screen with Shift + View (from Focus or Settings); View returns to Focus.
The top two pad rows hold slots 1-8 and 9-16:
| Colour | Meaning |
|---|---|
| Pink | playing |
| Blinking pink | queued: switches at the end of the longest track loop |
| Green | in the current chain (or the chain you are tapping) |
| Orange | has steps |
| Dark | empty |
- Queue: tap a slot. It switches the moment the longest track loop ends. A track's loop is its length in steps times its clock division, so the switch waits for the slowest or longest track: with CV1 at 16 steps and CV2 at 8 steps of the same division, CV2 plays its loop twice and then all four tracks switch together. A shorter track whose loop doesn't divide that point is cut mid-loop. All four tracks restart together on step 1 (last step when reversed) and loop counts reset.
- Chain (hold + tap): hold a slot, tap other slots in order (up to 32, repeats allowed, but not the held slot itself), release the held slot. Playback goes through the list, advancing at each end of the longest track loop and wrapping to the start. Releasing without tapping just queues that slot.
- N, A, I pads (third row, left: green, orange, blue): hold one, tap slots in order, release it. Releasing without tapping does nothing.
- N (new): the chain becomes exactly the tapped slots, repeats and a repeated first slot included.
- A (append): the tapped slots go on the end of the chain, up to 32 entries.
- I (insert): the tapped slots go in after the selected entry, or after the playing entry when none is selected. Nothing is added past 32 entries.
- The chain page: the bottom four pad rows show the chain, entry 1 at the top left, 8 entries a row, up to 32. Entries are dim, the playing one white, the selected one pink (pink shows over white when an entry is both). A chain of one slot shows nothing. While you hold an entry, its slot lights white in the top rows.
- Tap an entry: selects it and jumps to it at the next end of the longest track loop (at once while stopped).
- Shift + tap an entry: removes it; the rest close up and playback carries on. If it was the playing entry, that pattern finishes its loop and the next entry follows.
- Shift + hold an entry for 1 second: deletes the whole chain. It becomes the playing pattern on its own, and playback goes on.
- Copy: Shift + tap a slot copies the playing pattern into it, replacing what was there, and flashes
C+ the slot number (e.g. C3, C12). Copying onto the playing slot does nothing. - D pad (Delete) (third row, fourth pad, red): hold it and tap one or more slots; release it. Each tapped pattern is emptied, the same as Shift + each of the four track buttons (its lengths, dividers, scales and other track settings stay), and every chain entry for it is removed: the rest close up, and if the playing entry goes, the next entry plays at the next loop end. If no entries are left, the playing pattern plays on its own. The slot then shows as empty. Deleting the playing pattern is allowed: it is cleared at once and keeps running, silent. The pads flash
D+ the slot number (D3, D12). Releasing D without a tap does nothing. - Clear one pattern's steps without deleting its slot's chain entries: Shift + each of the four track buttons clears the playing pattern.
- While stopped, a queue or chain switches at once. Pressing Stop applies a queued switch, or a new chain's first entry; a running chain stays on its current pattern. A new chain made while playing starts at its first entry at the next loop end; if that is the pattern already playing it carries on.
- Change a track's length or divider and the switch point follows it. A queue, jump or chain edit made in the last few ticks before the switch point, after an early (microtiming) step has already played, takes effect one switch later; a late step of a shorter track that would land after the switch point is dropped. Play, Z-down tap and Pulse In 2 rewind the current pattern only; the chain position is kept.
- The chain is saved with the settings and resumes at the last pattern played after power-up.
Labels the pads show ↑ contents
| Group | Labels |
|---|---|
| Lanes | NTE LEN PRB RTG CND (VAL for the AU value lane) |
| Direction | FWD REV PNG RND |
| AU type | BIP UNI TRG |
| Scale | MAJ MIN DOR MIX PMA PMI HMI CHR (major, minor, dorian, mixolydian, pentatonic major/minor, harmonic minor, chromatic) |
| Root | C C# D D# E F F# G G# A A# B |
| Pages | P1 P2 P3 P4 P5 P6 P7 P8 |
| Divider | x2 x1 /2 /3 /4 /6 /8 /16 |
| Range | x1 x2 x3 x4 |
| Tracks | CV1 CV2 AU1 AU2 (also shows the jacks the track drives) |
| Numbers | BPM, transpose (+/−), swing %, length |
| Copy | C1 … C16 |
| Delete | D1 … D16 |
| Save | OK (manual save) |
Play, stop, Focus and Overview flash an icon. Three-letter labels slide across the pads. On power-up, and when you replug the Launchpad, BLOCKS scrolls once; any pad skips it.
Saving, backup and restore ↑ contents
- Automatic (default): 3 seconds after you press Stop, and every 3 seconds while stopped, any changed pattern or the shared settings is written to the top 68 KB of the card's flash. Playing is never interrupted. Switching the card off while playing loses edits since the last Stop.
- 10 s or manual: in the editor's Settings tab. With manual, stop the card and press Shift + Play to save now; the pads flash
OK. With the other modes Shift + Play is just Play. - Flashing new firmware keeps your patterns unless the new program grows into the top 68 KB.
- Backup / restore: use the Backup tab. Restore writes all 17 blocks (16 patterns and the settings) and tells you which were accepted. A backup from before 16 slots has only 9 blocks: it restores patterns 1-8 and the settings and leaves patterns 9-16 as they are. A block from a newer format, or a damaged one, is rejected, never half-loaded. A backup from before the editor settings existed restores fine; those settings then keep their defaults. Patterns from a backup made before 8-step pages are converted as they load, so they sound the same. Backups made before microtiming restore with every step on the grid.
Editor settings (defaults keep the behaviour above) ↑ contents
| Setting | Options (default first) |
|---|---|
| External clock rate | 4 PPQN (one pulse = 1/16) · 1 · 2 · 24 · 48 PPQN |
| CV In 1 / CV In 2 transpose | in-scale · off · chromatic (plain semitones) |
| Auto-save | 3 s after Stop · 10 s · manual |
| AU output range | ±5 V · ±2.5 V · ±1 V (bipolar, unipolar and trigger all scale) |
| CV1 / CV2 gate mode | length lane · trigger (fixed 10 ms, shortened when the step is shorter) |
| BPM range (Main knob) | 80-180 · 60-160 · 40-140 · 100-250. If the current BPM is outside the new range, the knob takes over at once. |
Troubleshooting ↑ contents
| Problem | Try |
|---|---|
| The Launchpad stays dark | The USB role is chosen at power-up. Plug the Launchpad into the front USB-C port, then press the Computer's Reset button or power-cycle. Expect BLOCKS about 1 second later. |
| Nothing plays | Press Play, or hold Z down for 1 second. Check the track isn't muted (Overview) and has steps with gates. If a cable is in Pulse In 1, the card follows that clock and waits when it stops. |
| A knob does nothing | Check the Z position (Main is BPM in both; X and Y need the middle position), that you are in Focus, and that the selected step is on the current page and within the length. Then turn the knob past the stored value (pickup guard). |
| Wrong notes | Check scale, root, range (x1-x4) and the X transpose; CV In 1/2 transposes tracks 1/2. |
| A queued pattern doesn't switch | It waits for the longest track loop to finish (length × divider); a long track means a long wait. While stopped it switches at once. |
| Edits lost after power-off | Saving happens after Stop (3 s or 10 s, or Shift + Play in manual mode). Stop, wait longer than the auto-save time, then power off. |
| A Launchpad X or Pro MK3 stays dark | These are supported but not yet tested on hardware. Plug it into the front USB-C and press Reset; if it still stays dark, please report it (the Mini MK3 is the verified model). |
| Which firmware is on the card? | Connect in the editor: the status line shows the version, e.g. Blocks 1.0.0. |
| This page can't find the card | Use Chrome or Edge, allow MIDI access, and plug this computer into the card's front USB-C instead of the Launchpad, then power-cycle the Workshop System (Reset alone may not bring up the computer connection). macOS may list the card under an older name (such as MTWS); the page finds it anyway. Close other programs using that MIDI port. |
| Write refused: busy | The card is playing. Press Stop and try again. |
Credits ↑ contents
Blocks is MIT-licensed. It builds on ComputerCard (Chris Johnson, MIT), usb_midi_host (rppicomidi, MIT),
TinyUSB (Ha Thach, MIT) and the Raspberry Pi Pico SDK (BSD-3-Clause), and adapts drumdrum (Moses Hoyt, MIT),
Simple MIDI (Tom Whitwell and Chris Johnson, MIT) and the ComputerCard web_interface example. Full list:
CREDITS.md in the repository.
Firmware
Back up first (Backup tab). Flashing keeps your patterns unless the new program grows into the top 68 KB of flash, but a backup is cheap.
- Connect this computer to the Workshop Computer's front USB-C port.
- Hold the card's boot button while powering it on, then release. The chip shows up as "RP2 Boot".
- From the project folder run
firmware/flash.sh(orfirmware/flash.sh path/to/card.uf2). It runspicotool load -v -x: load, verify, run. If the RPI-RP2 drive mounts instead, it copies the UF2 there. - To play with the Launchpad: unplug the computer, plug the Launchpad into the same front USB-C port, and press the Computer's Reset button (a power-cycle also works). To edit again: plug the computer in and power-cycle (Reset alone may not bring up the computer connection).
To build the UF2 yourself: cmake -S firmware -B build -G Ninja && ninja -C build (see firmware/README.md for the toolchain).