Skip to content

Patternflow v3.8.0 — one instrument, three editions

Choose a tag to compare

View all tags
@engmung engmung released this 31 Aug 02:40
· 213 commits to main since this release
v3.8.0
b85bc3b
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

The firmware split into editions: compositions of features over one unchanged core, installable in one click from patternflow.work/variants, switchable any time — patterns, networks and settings stay.

  • Patternflow (core) — patterns, four knobs, and the most contiguous memory a pattern can get, because nothing else is aboard.
  • Patternflow Audio — the panel hears: on-board PDM microphone, OSC, the browser and phone paths.
  • Patternflow Performance — sequences, MQTT in every role, FlowLocal and the Director, weather. Simone Majocchi's work, running as a composition of this tree.

Build your own

The refactor is the release. The core names no feature — every feature lives in firmware/patternflow/features/<name>/ behind one hook struct, an edition is two small files in firmware/bundles/<name>/, and ./firmware/bundles/build.sh <name> builds it (all builds every edition and scans each binary for exactly its own features). What stays put is written down and machine-enforced: docs/EDITIONS.md ("What is promised"), a CI check that the core references no feature, and a frozen module ABI behind a checksum lock. Fork a bundle, add a feature directory — the core underneath stays the core everyone else runs.

Audio, this cycle

  • On-board PDM microphone (four wires to GPIO43/44), auto-ranged bands over a measured noise gate, input gain for the S3's quiet PDM path.
  • The mapping editor: bands are boxes drawn on the live spectrum; response curves — rise, fall, gate, steps, arch, hand-drawn — bake to 33-point tables the firmware only interpolates. The same editor runs on the device console (/audio-in) and in the Chrome extension.
  • Glide ballistics (attack and damping, set separately) and an in-editor preview that runs test signals through your chain.
  • An Android capture app (tools/patternflow-audio-android): what the phone plays drives the panel, with the mapping fetched from the device.

Guides

Written: the Audio Guide (the extension, the editor, building the on-board microphone, OSC) and the Feature Guide (how the editions architecture works and how to build your own feature on it — written so you can hand it to an AI coding agent).

Installing

Already running Patternflow: pick an edition at patternflow.work/variants — one click, over Wi-Fi. Or drop patternflow.ino.bin (the core) on http://patternflow.local/update.

A new board, or recovery over USB: all four images with offsets in FLASHING.md, or the browser flasher at https://patternflow.work/flash.

Assets 10
Loading