400d896518
New form factor: a plain RP2040 Pico + Pico Scroll Pack (PIM545) -- a 17x7 single-colour LED matrix + 4 buttons. The 7x17 matrix maps onto the editor's lane x step pad grid. - pico-scroll/: CircuitPython firmware (DEVICE_ID "G"). Engine/scheduler/SysEx/ live-sync copied verbatim from pico-explorer (engine byte-identical, so it stays on the track-format conformance lineage); vendored bulk-framebuffer IS31FL3731 driver (pins/map verified from pimoroni-pico); three LED views (Grid/Pendulum/BPM); 4-button input. Audio over USB-MIDI (no onboard speaker); optional P_BUZZER. - grid.html + info-grid.html: widget page (canvas mirrors the 3 LED views) + spec page with a ~$29 BOM. - Registered in build.sh (precompile + ASCII assert + pm_g1_circuitpy.zip), deploy.sh, embed.js, embed.html, index.html gallery, and both editors' FW_PATHS (device id G). - docs/rust-port.md: core/driver architecture (pm-core no_std engine+protocol; per-board drivers behind embedded-hal/embedded-graphics traits). CLAUDE.md + livesync-protocol.md note the new edition + device id. Python firmware stays in parallel with Rust (no abandonment yet). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
174 lines
12 KiB
HTML
174 lines
12 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="UTF-8" />
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
<title>VARASYS PM_G-1 Grid - wiring, parts & firmware (Pimoroni Pico Scroll Pack / RP2040)</title>
|
|
<meta name="description" content="PM_G-1 Grid - the Pimoroni Pico Scroll Pack (PIM545, 17x7 LED matrix + 4 buttons) on a Raspberry Pi Pico as a polymeter metronome with live-sync to the web editor. Pinout, parts list, and the precompiled CircuitPython firmware bundle." />
|
|
<link rel="icon" type="image/svg+xml" href="data:image/svg+xml;base64,@BUILD:favicon@">
|
|
<script>
|
|
/* ?embed=1 -> strip site chrome (base.css [data-embed]) + auto-size to the host iframe */
|
|
(function(){ if(!/[?&]embed=1/.test(location.search)) return;
|
|
document.documentElement.dataset.embed="1";
|
|
function ph(){ try{ parent.postMessage({type:"varasys-h",h:Math.ceil(document.documentElement.getBoundingClientRect().height)},"*"); }catch(e){} }
|
|
addEventListener("load",ph); addEventListener("resize",ph); setTimeout(ph,300); setTimeout(ph,1000);
|
|
})();
|
|
</script>
|
|
<script>
|
|
(function(){ try{ var p = localStorage.getItem("metronome.theme");
|
|
if (p!=="light" && p!=="dark" && p!=="system") p = "system";
|
|
document.documentElement.dataset.theme = p==="system" ? (matchMedia("(prefers-color-scheme: light)").matches ? "light" : "dark") : p;
|
|
} catch(e){ document.documentElement.dataset.theme = "dark"; } })();
|
|
</script>
|
|
<style>
|
|
/*@BUILD:include:src/base.css@*/
|
|
:root{ --bg1:#12151c; --bg2:#05070a; --txt:#c7d0db; --muted:#7f8b9a; --link:#6cb6ff;
|
|
--panel-bg:#161b22; --panel-bd:#2a313c; --field-bg:#0e1116; --field-bd:#2a313c; --silk:#aab2bc; }
|
|
:root[data-theme="light"]{ --bg1:#f5f8fc; --bg2:#dde4ec; --txt:#1e2630; --muted:#5c6776; --link:#1769c4;
|
|
--panel-bg:#ffffff; --panel-bd:#d2dae4; --field-bg:#f1f4f8; --field-bd:#d2dae4; }
|
|
body{ margin:0; min-height:100vh; padding:22px 16px 56px; color:var(--txt);
|
|
background:radial-gradient(circle at 50% -8%, var(--bg1), var(--bg2)); }
|
|
a{ color:var(--link); }
|
|
main{ width:100%; max-width:980px; margin:0 auto; }
|
|
.info-hero{ text-align:center; padding:16px 8px 2px; }
|
|
.info-hero h1{ font-size:clamp(24px,5vw,36px); margin:0; letter-spacing:-.01em; }
|
|
.info-hero .sub{ margin:9px auto 0; max-width:64ch; font-size:14.5px; }
|
|
.steps{ width:100%; max-width:760px; margin:8px auto 0; color:var(--muted); font-size:14px; line-height:1.6; }
|
|
.steps li{ margin:5px 0; }
|
|
.steps code, .about code, .sub code { background:var(--field-bg); border:1px solid var(--field-bd); border-radius:5px; padding:1px 5px; font-size:12.5px; }
|
|
.dl{ display:inline-flex; align-items:center; gap:7px; margin:4px 10px 4px 0; padding:9px 14px; border-radius:10px;
|
|
background:linear-gradient(180deg,#34c6ff,var(--cyan)); color:#04121b; font-weight:700; text-decoration:none; font-size:13.5px; }
|
|
.dl.alt{ background:var(--field-bg); color:var(--txt); border:1px solid var(--field-bd); font-weight:600; }
|
|
</style>
|
|
</head>
|
|
<body>
|
|
|
|
/*@BUILD:include:src/header.html@*/
|
|
|
|
<main>
|
|
<section class="info-hero">
|
|
<h1>PM_G-1 Grid</h1>
|
|
<p class="sub">The off-the-shelf <b>Pimoroni Pico Scroll Pack</b> (a 17×7 white LED matrix + 4 buttons) on a plain <b>Raspberry Pi Pico</b> - sibling to the PM_K-1 Kit and PM_X-1 Explorer, sharing the engine, program-string grammar, and live-sync protocol with the web editor.</p>
|
|
</section>
|
|
|
|
<section class="about">
|
|
<h2>What it is</h2>
|
|
<div class="ff-tags"><span class="hw">Buildable now</span><span>RP2040 (Raspberry Pi Pico)</span><span>Pimoroni Pico Scroll Pack PIM545</span><span>~$30</span></div>
|
|
<p>The <a href="https://shop.pimoroni.com/products/pico-scroll-pack" target="_blank" rel="noopener">Pico Scroll Pack (PIM545)</a>
|
|
plugs straight onto a Raspberry Pi Pico's headers: <b>119 white LEDs in a 17×7 matrix</b> driven by an
|
|
<b>IS31FL3731</b> over I²C (individually brightness-controlled), and <b>4 buttons</b> (A / B / X / Y).
|
|
No soldering, no touchscreen, no joystick, no RGB - and <b>no onboard speaker</b>. About 65 × 25 × 10 mm
|
|
on top of the Pico. Power is over VSYS (USB or battery).</p>
|
|
<p>It runs the same <b>polymeter engine</b> and <b>program strings</b> as the web editor. The 7-row × 17-column
|
|
matrix maps directly onto the editor's <b>lane × step</b> pad grid: each lane is a row, each step a column, and
|
|
LED brightness encodes accent / normal / ghost. Beat editing is done in the browser; <b>Live sync</b> mirrors edits
|
|
to the device in real time (HELLO/FULL/DELTA over USB-MIDI) and the device mirrors play/stop/tempo/track back.
|
|
<b>Audio is over USB-MIDI</b> - turn on the editor's <b>🎹 Device audio</b> to hear the clicks through your
|
|
computer (or solder a piezo to a free GPIO and set <code>P_BUZZER</code> in <code>app.py</code>).</p>
|
|
</section>
|
|
|
|
<details class="spec" open>
|
|
<summary>Wiring - the Pico Scroll Pack fixed pinout (just press it onto the Pico)</summary>
|
|
<div class="spec-body">
|
|
<p class="sub">Everything is wired through the header; this is what the firmware reads. Pins verified against Pimoroni's <code>pico_scroll</code> library.</p>
|
|
<table class="bom">
|
|
<thead><tr><th>Component</th><th>Pico pins</th></tr></thead>
|
|
<tbody>
|
|
<tr class="grp"><td colspan="2">LED matrix - 17×7 white, IS31FL3731 (I²C @ 0x74)</td></tr>
|
|
<tr><td class="part">SDA / SCL</td><td>GP4 / GP5</td></tr>
|
|
<tr class="grp"><td colspan="2">Buttons (digital, pull-up)</td></tr>
|
|
<tr><td class="part">A (play/stop) / B (track)</td><td>GP12 / GP13</td></tr>
|
|
<tr><td class="part">X (-bpm) / Y (+bpm)</td><td>GP14 / GP15</td></tr>
|
|
<tr class="grp"><td colspan="2">Audio (optional - not on the Scroll Pack)</td></tr>
|
|
<tr><td class="part">Piezo PWM <span class="spec">- only if you wire one; set <code>P_BUZZER</code></span></td><td>any free GPIO</td></tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</details>
|
|
|
|
<details class="spec" open>
|
|
<summary>Controls & views</summary>
|
|
<div class="spec-body">
|
|
<table class="bom">
|
|
<thead><tr><th>Button</th><th>Tap</th><th>Hold</th></tr></thead>
|
|
<tbody>
|
|
<tr><td class="part">A</td><td>play / stop</td><td>cycle view (Grid → Pendulum → BPM)</td></tr>
|
|
<tr><td class="part">B</td><td>next track</td><td>next set list</td></tr>
|
|
<tr><td class="part">X</td><td>tempo -1</td><td>repeat (-5 after ~1.5 s)</td></tr>
|
|
<tr><td class="part">Y</td><td>tempo +1</td><td>repeat (+5 after ~1.5 s)</td></tr>
|
|
</tbody>
|
|
</table>
|
|
<table class="bom" style="margin-top:10px">
|
|
<thead><tr><th>View</th><th>What the 17×7 matrix shows</th></tr></thead>
|
|
<tbody>
|
|
<tr><td class="part">Grid</td><td>lanes as rows, steps as columns; brightness = accent / normal / ghost; a bright playhead column tracks the beat (bars > 17 steps scale to fit - no steps dropped)</td></tr>
|
|
<tr><td class="part">Pendulum</td><td>a column bounces across the bar like a metronome arm, full-height flash on each beat</td></tr>
|
|
<tr><td class="part">BPM</td><td>the current tempo as three 3×5 digits</td></tr>
|
|
</tbody>
|
|
</table>
|
|
<p class="sub" style="margin-top:8px">Tap tempo lives in the web editor. The mapping is deliberately simple (this is a UI prototype) and easy to re-bind at the top of <code>app.py</code>.</p>
|
|
</div>
|
|
</details>
|
|
|
|
<details class="spec" open>
|
|
<summary>Parts</summary>
|
|
<div class="spec-body">
|
|
<p class="sub">Two off-the-shelf parts, no soldering - ballpark one-off price (USD).</p>
|
|
<table class="bom">
|
|
<thead><tr><th>Part</th><th class="q">Qty</th><th class="c">~$</th></tr></thead>
|
|
<tbody>
|
|
<tr><td class="part">Pimoroni Pico Scroll Pack (PIM545) <span class="spec">- 17×7 white LED matrix (IS31FL3731) + 4 buttons</span></td><td class="q">1</td><td class="c">22</td></tr>
|
|
<tr><td class="part">Raspberry Pi Pico <span class="spec">- RP2040; pre-soldered headers so the pack presses on</span></td><td class="q">1</td><td class="c">5</td></tr>
|
|
<tr><td class="part">USB cable <span class="spec">- power + flashing (micro-USB)</span></td><td class="q">1</td><td class="c">2</td></tr>
|
|
<tr class="total"><td>Total (one-off)</td><td class="q"></td><td class="c">≈ $29</td></tr>
|
|
</tbody>
|
|
</table>
|
|
<p class="sub" style="margin-top:10px">Reference: <a href="https://shop.pimoroni.com/products/pico-scroll-pack" target="_blank" rel="noopener">Pico Scroll Pack product page</a>
|
|
· <a href="https://github.com/pimoroni/pimoroni-pico/tree/main/libraries/pico_scroll" target="_blank" rel="noopener">vendor code (pico_scroll)</a>
|
|
· <a href="https://circuitpython.org/board/raspberry_pi_pico/" target="_blank" rel="noopener">CircuitPython for Raspberry Pi Pico</a>.</p>
|
|
</div>
|
|
</details>
|
|
|
|
<details class="spec" open>
|
|
<summary>Firmware - self-contained appliance (USB drive · web-driven editing via Live sync · MIDI audio · practice log)</summary>
|
|
<div class="spec-body">
|
|
<p class="sub">The firmware turns the Pico + Scroll Pack into a self-contained appliance: it mounts as a
|
|
<b>USB drive</b> carrying the (precompiled) firmware, your tracks and an offline copy of this editor;
|
|
drives the <b>17×7 matrix</b> with <b>web-driven editing</b> via <b>Live sync</b>; <b>logs your practice</b> to
|
|
<code>history.json</code>; takes new set lists <b>pushed from the editor over USB-MIDI</b>; and plays
|
|
out your <b>computer's speakers over USB-MIDI</b>. By default the firmware owns the drive (read-only to
|
|
the computer - so it can log and can't be accidentally erased); hold <b>button A</b> at power-on for
|
|
editor mode (drive writable).</p>
|
|
<p>
|
|
<a class="dl" href="/pm_g1_circuitpy.zip" download>Download CircuitPython bundle ↓</a>
|
|
<a class="dl alt" href="https://codeberg.org/VARASYS/metronome/src/branch/main/pico-scroll" target="_blank" rel="noopener">Source + README ↗</a>
|
|
</p>
|
|
<ol class="steps">
|
|
<li>Flash <b>CircuitPython for Raspberry Pi Pico</b>
|
|
(<a href="https://circuitpython.org/board/raspberry_pi_pico/" target="_blank" rel="noopener">download</a>)
|
|
via BOOTSEL, unzip the bundle onto <code>CIRCUITPY</code>, and power-cycle. It boots into appliance mode.</li>
|
|
<li><b>Edit on the web:</b> open the <a href="/editor-beta.html">editor (beta)</a> in Chrome / Edge / Firefox,
|
|
click <b>🔗 Live sync</b>, and the matrix mirrors your edits live (beats, tempo, track changes).</li>
|
|
<li><b>Save a set list to the device</b> for offline use: set-list <b>···</b> menu →
|
|
<b>📟 Save to device</b>. It's pushed over USB-MIDI; the device persists it to
|
|
<code>/programs.json</code>.</li>
|
|
<li><b>Play through your computer:</b> click <b>🎹 Device audio</b>, then press <b>A</b> on the device -
|
|
the full groove sounds through your speakers over USB-MIDI, in sync (the Scroll Pack has no speaker of its own).</li>
|
|
<li><b>Firmware updates:</b> ··· menu → <b>⬆ Update firmware</b> - the editor reads
|
|
the device id (G = Grid), fetches the matching <code>pico-scroll-app.mpy</code>, and pushes it
|
|
over USB-MIDI. The device A/B-updates with automatic rollback if a build won't boot.</li>
|
|
</ol>
|
|
</div>
|
|
</details>
|
|
|
|
<p class="sub" style="max-width:760px;margin:14px auto 0">Pairs with the touch-driven <a href="/info-kit.html">PM_K-1 Kit</a> and the button-driven <a href="/info-explorer.html">PM_X-1 Explorer</a> - same engine, same programs.json, same web editor.</p>
|
|
</main>
|
|
|
|
/*@BUILD:include:src/footer.html@*/
|
|
|
|
<script>
|
|
const APP_VERSION = "v0.0.1-dev";
|
|
/*@BUILD:include:src/chrome.js@*/
|
|
</script>
|
|
</body>
|
|
</html>
|