Skip to content

docs: sound demos, board renders and 3D models in the READMEs - #92

Merged
KrasForge merged 2 commits into
mainfrom
claude/fervent-pasteur-89elgi
Oct 1, 2026
Merged

KrasForge merged 2 commits into
mainfrom
claude/fervent-pasteur-89elgi

Conversation

@KrasForge

Copy link
Copy Markdown
Owner

Prep for the Audio Developer Meetup Berlin.

Changes

  • README: hero render of the mated board stack, plus new Listen, See the mesh move and The hardware sections.
    • Spectrograms that link to mp3 clips (gong / plate / drum from model/demo_render.m, plus a new chaos-off vs chaos-on A/B strike).
    • A linear-vs-chaos mesh animation.
    • Solder-mask views and 3D renders of both boards.
    • The stack as .stl (GitHub 3D viewer) and coloured .glb.
  • Other READMEs: panel, mainboard, model/ and docs/ READMEs link the new media.
  • docs/media/: all generated assets, plus scripts/make_media.sh to regenerate them from model/ and the native KiCad 10 boards.
    • nlmesh.py (a NumPy port of NLMesh2D.m) is checked against Octave on every run (max |Δu| ≈ 2e-15).
    • Audio is labelled as model output, not hardware.
    • 3D component bodies are labelled as parametric stand-ins, because the actual-part STEP files are gitignored.
  • sim/Makefile: restores STD := --std=08, which was dropped in 3e1480a.

Known, not fixed here

  • make -C sim still stops at mallet_tb because 6 of the 9 golden src/tb/*_trace.txt files are gitignored, and nothing in the repo generates them. Expect GHDL CI to stay red until those are committed or regenerated.
  • README §9 and §10 disagree with hardware/CURRENT_DESIGN.md:
    • The FPGA is listed as XC7A35T; the board carries an XC7A50T.
    • The routing status says unrouted, or six BGA escapes left; the current DRC reports 0 unconnected.

🤖 Generated with Claude Code

https://claude.ai/code/session_01G2wKmUMbqp7aGPwbHSUVwu


Generated by Claude Code

claude added 2 commits October 1, 2026 14:44
Without it ghdl analyses as VHDL-93 and the suite stops at the first
process(all) in fx_fdn_reverb.vhd.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01G2wKmUMbqp7aGPwbHSUVwu
- docs/media/: demo clips (mp3 + spectrogram mp4), a linear-vs-chaos A/B
  strike, spectrograms, an animated mesh comparison, solder-mask views of
  both native KiCad boards, 3D renders, and the mated stack as STL (GitHub
  3D viewer) and coloured glTF.
- docs/media/scripts/make_media.sh regenerates everything from model/ and
  the native .kicad_pcb files; nlmesh.py is checked against Octave's
  NLMesh2D on every run. Component bodies are labelled as parametric
  stand-ins, and audio is labelled as model output, not hardware.
- README: hero image, Listen / See the mesh move / The hardware sections;
  panel, mainboard, model and docs READMEs link the new media.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01G2wKmUMbqp7aGPwbHSUVwu
@KrasForge
KrasForge merged commit 095850d into main Oct 1, 2026
0 of 2 checks passed
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.

2 participants