VARASYS/metronome
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
metronome/pico-explorer
History
Me Here 9701f49913 Firmware: parse euclid, GM note-numbers, and unknown-sound fallback 
Close three real parser divergences the conformance suite flagged on the device
side (pico-cp + pico-explorer) — cases where the firmware produced a different
groove/sound than the web for the same patch:

- Euclidean (k,n,rot) shorthand (e.g. kick:4(3,8)) — was silently dropped to a
  plain bar; now expands to the same hits as engine.js (added _euclid + parsing).
- GM note-number lane sounds (e.g. 36:4) — now resolve to the voice name (GM_NUM).
- Unknown sound names fall back to beep, matching the web.

vol/cd are NOT carried by the firmware by design: they are web-authoring fields
(the device has a hardware volume knob and no count-in). Documented as an
intentional, permanent host difference rather than a bug; the vol-and-countin
vector stays as expectFail[py] to mark the boundary.

tests/adapters/py_adapter.py: extract the new SOUND_GM/GM_NUM/_euclid nodes.
fixtures: euclid/unknown-sound/gm-note-number now pass on both engines.
docs §6 updated. node tests/run.mjs: 33 pass / 9 known, round-trips stable.
pico-explorer parser spot-checked identical to pico-cp.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-05-31 00:15:25 -05:00
..
app.py Firmware: parse euclid, GM note-numbers, and unknown-sound fallback 2026-05-31 00:15:25 -05:00
boot.py PM_X-1 0.0.1: Pimoroni Explorer sibling firmware + Kit 0.0.23 device-id reply 2026-05-30 20:43:38 -05:00
code.py PM_X-1 0.0.1: Pimoroni Explorer sibling firmware + Kit 0.0.23 device-id reply 2026-05-30 20:43:38 -05:00
programs.json PM_X-1 0.0.1: Pimoroni Explorer sibling firmware + Kit 0.0.23 device-id reply 2026-05-30 20:43:38 -05:00
README.md PM_X-1 0.0.2: portrait flip + Kit-style layout (no more overlapping bits) 2026-05-30 21:37:12 -05:00

README.md

PM_X-1 "Explorer" — CircuitPython edition (Pimoroni Explorer · RP2350)

The CircuitPython firmware for the Pimoroni Explorer Kit (PIM744), set up as a self-contained appliance. Sibling to the PM_K-1 build in ../pico-cp/ (the 52Pi EP-0172 kit) — same engine, same program strings, same programs.json, same web editor.

This board is a 2.8″ ST7789V LCD + 6 user buttons + piezo speaker built around an RP2350B (Pico 2 class chip). No touchscreen, no joystick, no RGB LED. Editing is done in the web editor with Live sync on; the device mirrors changes in real time and emits its own play/stop/bpm/sel deltas back.

Hold the device in portrait with the A/B/C buttons along the top and X/Y/Z along the bottom. The firmware drives the LCD as a 240 × 320 portrait at display.rotation = 270 — same UI shape as the PM_K-1 Kit, just shorter. If the screen comes up upside-down on your unit, change DISPLAY_ROTATION near the top of app.py to 90 (or 180 if rotated 180°) and re-flash.

Controls

Button Action
A play / stop
B tap tempo
C menu (Settings / Help / About / Practice log)
X prev track (hold to repeat)
Y tempo −1 (hold to repeat; after ~1.5 s the step grows to −5)
Z next track (hold to repeat)
X + Z tempo +1 (chord; same hold-repeat as Y)

In a menu: X / Z move the cursor up / down, Y decrements the focused value, A commits or cycles, B = back, C = close.

Install

  1. Flash CircuitPython for Pico 2 / RP2350. Hold BOOTSEL on the Explorer, plug it in over USB-C, drop the Pimoroni Explorer (RP2350) CircuitPython .uf2 onto the RP2350 drive. A CIRCUITPY drive appears.
  2. Copy the bundle onto CIRCUITPY — boot.py, code.py, app.mpy, programs.json, font_s.bin / font_m.bin / font_l.bin, logo.bin / midi.bin / usb.bin, editor.html (offline editor). If an old app.py is on the drive, delete it.
  3. Power-cycle. It boots into appliance mode and runs.

Program it from the web

Open https://metronome.varasys.io in Chrome / Edge / Firefox. The set-list ⋯ menu → 📟 Save to device pushes a programs.json over USB-MIDI; the device persists it and reloads. Click 🔗 Live sync to mirror edits in real time.

Pin reference

The display, buttons, and audio are wired into the board — no jumpers required. CircuitPython's official board definition for pimoroni_explorer2350 exposes board.DISPLAY pre-initialized, so the firmware just uses it.

Function GPIO
Button A GP16
Button B GP15
Button C GP14
Button X GP17
Button Y GP18
Button Z GP19
Piezo audio (PWM) GP12
Piezo amp enable GP13
I²C SDA (QwSTEMMA) GP20
I²C SCL (QwSTEMMA) GP21
Display board.DISPLAY (8080 parallel bus on GP26..GP39, initialized by board.c)

Calibration (flags at the top of app.py)

  • Speaker too loud / quiet: the piezo + amp gain is fixed in hardware. MUTE_SPEAKER silences the click; SPEAKER_AUTO_MUTE auto-mutes when a MIDI host is listening.
  • Buttons feel inverted: the polarity is hard-coded to active-low (pull-up). If a button fires on release instead of press, check the BTN_* pin map at the top of app.py.
  • Display orientation: the board's CircuitPython init mounts the panel landscape (320 × 240). If your screen looks rotated, that's a board.c-level thing — file a CircuitPython bug, don't patch the firmware.

If app.py ever errors, CircuitPython prints the traceback on the screen and over USB serial — send me that.