Skip to content

Patternflow v2.1.0 — the v2.x consolidation release

Latest
Latest

Choose a tag to compare

View all tags
@engmung engmung released this 17 Jul 03:08
v2.1.0
4333b5f
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

This is the final consolidation release of the v2.x line before v3.0. If you're building a Patternflow today, this release is your baseline: grab it and everything — board, case, firmware, docs — is pinned to a known-good state.

Building one? Start here → BUILD_GUIDE.md

What to order / print

Part Use this Notes
PCB hardware/pcb/gerber/patternflow_v2.1_gerber.zip The recommended board. Reworked HUB75 routing + silkscreen fixes over v2.0.
Case (256 mm bed, P1S-class) hardware/case/print-ready/ standard plates ~10 h total on default P1S settings
Case (330 mm+ bed, H2S-class) print-ready/variants/oneshot_v2_1/2.stl One-piece snap-fit body — no gluing. New in this release.
Firmware Browser flasher at patternflow.work or firmware/patternflow/

⚠️ Anything under an experiment/ folder (v3.0 test Gerbers, divided-bed case STLs) or oneshot_v3-wip/ is unverified — do not order or print from those.

⚠️ Ordering the PCB: ignore the PCBWay shared-project link inside the tagged guide — that listing has since moved to the v3.0 board, which does not fit v2 cases. For a v2 build, download patternflow_v2.1_gerber.zip (attached below) and upload it to your fab yourself.

Highlights since v2.0.0

Hardware

  • PCB v2.1 is now the pinned board revision: ESP32↔HUB75 routing reworked, silkscreen cleaned up.
  • One-piece snap-fit enclosure for large-format printers (#113) — prints as a single body plus a snap-fit closing part, wall-mount hanger hole included.
  • A divided version of the snap-fit design for 256 mm beds is modeled and staged in experiment/ (including the new v2.1_divided.stl) — print-testing is next.

Firmware

  • Foundation refactor: patterns now render through PFCanvas with shared core_math / core_color / core_noise libraries — custom patterns are cleaner to write and port.
  • Looks better on camera: gamma LUT, per-channel white balance, saturation boost, and ~240 Hz panel refresh (kills phone-camera flicker bands).
  • Better knobs: encoder acceleration, K1 long-press brightness mode, K3 knob-map screen, fixed K1/K2 mapping and Bourns PEC11R direction.
  • Two-way OSC with a versioned wire spec: knob/pattern/content control, ping/announce, auto-learned remote host.
  • Wireless workflows: ArduinoOTA flashing and Improv-Serial Wi-Fi provisioning from the browser.

Ableton Live integration (new)

A Max for Live bridge device (integrations/ableton/) maps the four hardware knobs to any Live parameters over OSC — relative encoder deltas, per-slot sweep sensitivity, mappings saved with your Live set.

Web — patternflow.work

  • Pattern Lab: in-app AI pattern generation (bring your own Gemini key), color ramp + v-field mode, and an Experiment tab that compiles a layer-stack patch straight to pattern code.
  • Live Editor: much stronger C++ conversion prompt, preset library, pattern sharing links.
  • Build globe: community builds from around the world, shown inside the 3D viewer.

Docs

  • Build guide moved to the repo root with an all-through-hole BOM.
  • Breadboard-only build path documented — you can try Patternflow with no PCB at all.

Full details in the CHANGELOG.

Known issues

  • easyfit main plate STL is missing the LED-matrix divider slot — don't print it as-is (#154).
  • Divided (256 mm bed) snap-fit enclosure is not print-tested yet.
  • LED matrix alignment bumps still need manual trimming (#4).

What's next: v3.0

v3.0 is in active development: a new snap-fit enclosure designed around a revised board with USB-C power (plus a beginner-friendly screw-terminal bypass), a rebuilt build guide, and a proper BOM. Early previews already live in this repo (gerber/experiment/, oneshot_v3-wip/) — follow #114 for the board.

Assets

Everything a v2.x builder needs, independent of repo state (the repo has since pivoted toward v3.0 — see #177):

  • patternflow_v2_case_stl_pack.zip — all known-good case STLs: standard plates, both knob sets, and the one-piece oneshot_v2 body. (Excludes the defective easyfit variant — #154 — and the untested divided prototypes.)
  • patternflow_v2.1_gerber.zip — the last validated v2.x board.
  • patternflow_v2_firmware.zip — prebuilt ESP32-S3 binaries (the browser-flasher image) with esptool offsets in the included README.
  • patternflow_v1.blend — Blender source for the case (stored in Git LFS; attached here so Download ZIP users get the real file).

Firmware & web: MIT · Hardware & designs: CC-BY-SA 4.0

Assets 6
Loading