Skip to content

web: the guide has a fourth part, Audio - #477

Merged
engmung merged 3 commits into
devfrom
guide-audio
Oct 4, 2026
Merged

engmung merged 3 commits into
devfrom
guide-audio

Conversation

@engmung

@engmung engmung commented Oct 4, 2026

Copy link
Copy Markdown
Owner

/guide/audio (Korean at /guide/audio/ko), after Build, Play and Make.

Structure

  • One prerequisite: getting the Audio edition onto the board.
  • Then three sections with names, no numbers and no order between them:
    • A browser tab. The extension, its popup states (captured against a real board), and the extension's real editor running live in the page, driving the 3D board's knobs. A hand on a 3D knob wins for five seconds.
    • The microphone. What to buy, five leads on four places (GND takes two), the switch, the /audio-in page.
    • MIDI & your DAW. rtpMIDI, Ableton's Remote and mapping, channel 1 and the numbers each way, the console's MIDI page, "Use this computer". Network MIDI only.
  • OSC, the phone app and the Director's .mid export are links at the end.

What else changed

  • The hub has four cards (04 Audio). Play's and Make's closings link the new guide.
  • The simulated board learns the Audio edition: OSC/AUD rows on NETWORK, toggled by K2/K3 as the firmware does. Lanes are an overlay that never writes into the stored knob values.
  • firmware/toolchain/editor_demo.py generates web/public/guide/audio-editor/ from the extension's editor.
  • AUDIO_GUIDE.md and the Audio card on /editions said four leads; they now say five on four places.
  • The console's MIDI page no longer says MIDI has a row on the NETWORK screen (it has none). Only that page's header changed in the firmware.
  • The "From the maker" notes on three steps are the owner's own sentences from his journal posts.

Checked

  • npm run typecheck, lint (0 errors), 390 tests, next build.
  • editor_demo.py --check, console_demo.py --check, console_pages.py check, check_boundaries.py.
  • build.sh all and the footprint pins.
  • Walked with headless Chrome (GPU on) at 1440×900 and 390×844, English and Korean, by three reviewers; their findings are fixed.

Not checked / known

  • No real phone.
  • On a phone the editor step's card covers the board while the editor is in view.
  • At 1280×720 the rtpMIDI card runs slightly past the fold.
  • The rtpMIDI and Ableton screenshots are the existing ones from docs/images/midi and show the owner's PC name.
  • The guide describes the /audio-in page and extension 0.2.0 that ship with the next release, so it should go live together with it.

🤖 Generated with Claude Code

… the microphone, MIDI and your DAW

/guide/audio (and /ko): getting the Audio edition onto the board first,
then three sections with names and no order between them.

- A browser tab: the extension, its popup's states, and the extension's
  real editor running in the page in its demo mode, driving the 3D
  board's knobs; a hand on a knob wins for five seconds, as on the board.
- The microphone: what to buy, five leads on four places (GND takes two),
  the switch, and the /audio-in page. AUDIO_GUIDE.md and the editions card
  said four leads and now agree.
- MIDI and your DAW: connecting with rtpMIDI, Ableton's Remote and
  mapping, channel 1 and the numbers each way, the console's MIDI page.
- OSC, the phone app and the Director's .mid export are links at the end.

The hub has four cards. The simulated board learns the Audio edition
(OSC and AUD rows on NETWORK, toggled by K2/K3) and lanes as an overlay
that never writes into the stored knob values. editor_demo.py generates
web/public/guide/audio-editor from the extension's editor. The console's
MIDI page no longer says MIDI has a row on the NETWORK screen.

Checked: typecheck, lint, 390 tests, next build, build.sh all and the
footprint pins; walked in headless Chrome at 1440 and 390 wide, English
and Korean. Not checked on a real phone.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vercel

vercel Bot commented Oct 4, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
pattern-flow_origin Building Building Preview Oct 4, 2026 1:23pm UTC
pattern-flow-open Ready Ready Preview Oct 4, 2026 1:23pm UTC

Text and guards, no behaviour change beyond one link.

- /update on the site says it installs the standard firmware and sends an
  edition's owner to its card; the panel's own Update page now links an
  edition to patternflow.work/editions#<variant> instead of /update, which
  would have replaced it with the core.
- The Audio card no longer claims a raised Wi-Fi transmit power (the core
  has been at full power since 3.10.5).
- The Basics pack card says it needs firmware 3.5.1 or later.
- AUDIO_GUIDE and the changelog say that a knob pinned from the console,
  MIDI CC 20-23 or /api/params outranks sound until its encoder is turned;
  the changelog's /audio-in size and its "same or smaller" line are
  corrected, and a restart is named as what gives a pattern a fresh start.
- shelf.sh puts back a credentials file left aside by a killed run and
  refuses to build with composition files left in features/; the aside
  name is gitignored.
- RELEASING.md gains two steps: regenerate the guide's console demo after
  the cut, and redeploy the community host after main deploys.

build.sh all and the footprint pins pass.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
bundles/audio/overrides.h pinned 17 dBm. That was a raise while the core
shipped 13 dBm; since 3.10.5 the core is at 19.5 and the pin made Audio
the one build with less. The override is gone, so v0.7.0 follows the
core. Checked on a panel: /api/status txDbm reads 19.5 on the Audio image.
Not checked: the microphone's noise floor at the higher power (the board
with the microphone was not on the bench).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@engmung
engmung merged commit efc413c into dev Oct 4, 2026
11 checks passed
@engmung engmung mentioned this pull request Oct 4, 2026
@engmung
engmung deleted the guide-audio branch October 8, 2026 13:22

This branch was successfully deployed

1 active deployment
Preview – pattern-flow-open — 721a8c37 Deployed Oct 4, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant