by adom
A 12,960-LED addressable wall for the Adom workcell: 9 identical 160x160mm tiles (1,440 Dialight 587-1024-147F 2020 LEDs each, RP2040 + USB-C per tile) on a LrgLrg 576x576 scaffold. Remote Adom users each own a pixel.
← Commit history
Amendments: corrected Dialight footprint (measured pads), I2C tile mesh with single USB-C uplink (user-directed)
3 files changed
+63
docs/plan/COMPONENTS.md+8@@ -18,3 +18,11 @@ Worldsemi WS2812B-2020 (existing basic part) is out of stock at LCSC/Adom and not Mouser-distributed. - 3D discrepancy on adom/ws2812b-2020 filed as issue #1581 (not used in this design). - USB-C page is private to adom org; fine for an internal build. Mark public later if the tile page goes public.++## Amendment 2026-09-29 — I2C mesh additions+| MC1..MC2 | MachineContactMedium | I2C SDA/SCL tile interconnect | adom/machinecontactmedium | full CAD ✓ |+| R(ADR) | 10k 0402 (CR0402-FX-1002GLF) | address strap pull-ups GPIO4-7 | Adom Basic Parts | ✓ |+| R(I2C) | 22k 0402 (CR0402-FX-2232GLF) | I2C bus pull-ups SDA/SCL | Adom Basic Parts | ✓ |+| ADR0..3 | 2-pad 0402 solder jumper (bare pads, no part) | tile address straps | board project only | n/a |+Architecture: tiles mesh by I2C (400kHz); master tile (address 0) is the only USB-C uplink+to the control panel. One board design for all 9 tiles.
docs/plan/DECISIONS.md+23@@ -46,3 +46,26 @@ the grid so users can find their pixel. Emergent collaborative art. - adom/ws2812b-2020 page: STEP file header and geometry are a 5.0x5.0 mm 5050 model (bounds 6.45 x 6.25 x 1.6 mm), GLB is ~4 x 3.6 x 2.4 mm — neither matches the 2.0x2.0 footprint. Filed for fixing; not used by this design (Dialight part instead).++## Amendment 2026-09-29a — Dialight footprint corrected by measurement+The component-page build measured the 600dpi datasheet renders: p.1/p.2 callouts are+size+gap pairs, not size+pitch. Real geometry: terminals 0.6x0.6 on 1.4mm pitch (centers+±0.70); recommended pads 0.9x0.9 on 1.7mm pitch (centers ±0.85). Published footprint+`Dialight_587-1024-147F` uses pads at (±0.85,±0.85), courtyard ±1.55mm, IPC-7351 zero+orientation, pad 1 (DOUT) top-left. The earlier ±0.45/0.8mm numbers in this file and+GENERATOR-SPEC.md are superseded. Page: adom/587-1024-147f v0.1.1 (published, verified).++## Amendment 2026-09-29b — I2C tile mesh, one USB-C uplink (user-directed)+Per the user: tiles interconnect by I2C between their RP2040s; only ONE tile (the master)+uplinks to the control panel over USB-C.+- ONE board design stands: every tile gets the same MCU strip (USB-C populated on all;+ only the master's cable is plugged).+- Each tile gains 2x MachineContactMedium for I2C SDA/SCL in the MCU strip; the scaffold+ harness buses them to all 9 tiles (GND returns through the power contacts).+- 4 address-strap solder jumpers (GPIO4..7, pull-ups, strap to GND) set the tile's I2C+ address 0..15; address 0 = master (USB bridge). Slave tiles run I2C peripheral mode.+- Bus: I2C 400kHz (FM+ 1MHz possible after bring-up), 22k pull-ups on every tile+ (2.4k combined with 9 tiles — inside the 3mA drive budget).+- Firmware: one UF2 for all tiles; role from straps. Master: USB CDC <-> I2C bridge.+ Bulk frames carry the tile address; sparse per-LED updates are the common case+ (full-tile frame ~110ms at 400kHz — art-rate, fine).
docs/plan/GENERATOR-SPEC.md+32@@ -49,3 +49,35 @@ Every footprint needs a 3D binding: wiki STEP files live in parts/lib/*.step — - Open the board on the desktop via the kicad bridge (`adom-bridge --ai-thread "LED grid scaffold" kicad_open_board ...` — read /home/adom/.kimi-code/skills/kicad-bridge/SKILL.md first) and screenshot it in the background: the grid and MCU strip must look right. Save PNG to clips/gen-board-check.png. Do NOT save the board from KiCad (file is generated). - Run a self-DRC after applying moves+routes LOCALLY (generate tile-routed.kicad_pcb with all tracks/vias written into the file directly — same geometry as route-plan.json): service-kicad DRC must be 0 violations (unconnected=0). This proves the plan is landable before we spend an hour landing it live. - Report: LED count, net count, via count, any clearance compromises, and the exact rail/via scheme chosen.++---++# AMENDMENTS (2026-09-29) — these override anything above that conflicts++## A1. Dialight footprint (use the PUBLISHED one, do not regenerate)+Use `/home/adom/project/adom-led-grid/parts/lib/Dialight_587-1024-147F.kicad_mod` verbatim —+it is the published adom/587-1024-147f footprint: pads 0.9x0.9mm at (±0.85,±0.85),+courtyard ±1.55mm, pad 1=DOUT top-left, 2=VDD top-right, 3=DIN bottom-right, 4=GND bottom-left+(KiCad y-down). Symbol: parts/lib/587-1024-147f.kicad_sym. STEP/GLB: parts/lib/587-1024-147f.{step,glb}.+At 4mm pitch: pad-edge gutter is 4.0-2*(0.85+0.45)=1.4mm horizontally and vertically; courtyard+gutter is 0.9mm. Data links DOUT(top-left)→DIN(bottom-right) of the next LED are diagonal —+choose LED orientation per row (0° vs 180°) to keep every link ≤3.0mm and inside pad gutters;+keep orientation uniform within a row; document the pattern. Rails: VDD top-rail per row and+GND bottom-rail per row may both be needed on F.Cu now that the GND-pad gutter is tight — if a+rail does not fit the 1.4mm gutter at ≥0.2mm clearance, widen the pitch to 4.25mm for that axis+(41→39 cols or 36→33 rows) and report the change, or move GND vias into the pad-gutter crossing+points. DRC decides; report the final scheme.++## A2. I2C tile mesh replaces per-tile USB uplink (user-directed 2026-09-29)+- Add 2x MachineContactMedium (parts: adom/machinecontactmedium — pull its kicad_sym/kicad_mod/step+ from the wiki the same way as the large ones; refs MC1 (SDA), MC2 (SCL)) in the MCU strip,+ wired to bus nets I2C_SDA / I2C_SCL.+- RP2040 GPIO26 = I2C1 SDA, GPIO27 = I2C1 SCL (verify against ray/rp2040 pinout; use I2C1).+- 4 address straps: GPIO4..GPIO7 each with a 10k pull-up to V3V3 and a 2-pad solder jumper to GND+ (bare 0402 pads, no purchased part; nets ADR0..ADR3).+- 2x 22k pull-ups (0402, CR0402-FX-2232GLF if stocked else nearest basic 22k) SDA/SCL -> V3V3 on EVERY tile.+- USB-C remains on every tile (one board design); only the master is cabled in the wall.+- Keep the 4x MachineContactLarge power contacts.++## A3. Scratch paths+Probe/scratch boards go to gen/scratch/ — NEVER into run/ (reserved for the aiflow run).