← Commit history

The process video on the main page, with a sub-readme on how it was made

John Lauer ·2baeadbe48 ·5d ago ·parent 327e47f
4 files changed +69−3
README.md+6−3
@@ -8,11 +8,13 @@ It takes the brief from the YouTube video "Hardware Design with GPT-6: Schematic  The board has not been fabricated yet. Everything below is design and simulation. -## Build video+## The video -Two minutes of the adom-aiflow run at speed: the pours rework, the current and thermal drawings, the Adom Fields walkthrough and the finished board in KiCad's 3D view. Every step's own clip is on the [build clips](docs/clips.md) page.+Three minutes, start to finish: the brief and the circuit, three SPICE engines in agreement, the live layout in KiCad 10, the current and heat analysis and the rework it caused, the silkscreen placed live, the part models and their wiki pages, and the molecule on its probing scaffold. [How the video was made](docs/process-video.md): the clips behind each scene, the voice-over script and the tools. -<video src="docs/build-video.mp4" poster="docs/build-video-poster.jpg" controls muted playsinline preload="metadata"></video>+<video controls preload="metadata" width="1080" poster="docs/video/buck-process-poster.jpg" src="docs/video/buck-process.mp4"></video>++[Download the 1080p copy (43 MB)](docs/video/buck-process-1080p.mp4)  ## Key specs @@ -57,6 +59,7 @@ Probe pads: TP1 SW, TP2 FB, TP3 VOUT, TP4 GND. The four corner machine pins are | [aiflow run](docs/aiflow-run.md) | Step timings, what aiflow did and what the AI did, and the aiflow gaps this run found (and which were fixed in 0.1.33). | | [Rework clips](docs/clips-rework.md) | The second run: the reroute, the pours again, the analyses and the silkscreen placed live. | | [Build clips](docs/clips.md) | Every step's video clip from the adom-aiflow run. |+| [The process video](docs/process-video.md) | How the three-minute video was made: the clips behind each scene, the voice-over script and the tools. |  ![The molecule on a LrgMed scaffold, wired to the Control Panel scaffold](docs/img/scaffold-iso.png) 
docs/process-video.mdadded+63
@@ -0,0 +1,63 @@+# The process video: how it was made++The three-minute video on the [main page](https://wiki.adom.inc/john/buck-12v5v-molecule) tells the whole story of this board: the brief, the circuit, the three-engine simulation, the live layout in KiCad, the current and heat analysis and the rework it caused, the silkscreen, the part models and their wiki pages, and the molecule on its scaffold. Every frame is real footage or a native render from this project; nothing is mocked up.++- 3 min 4 s, 1080p, 30 fps, narrated, with subtitles burned in so it also works muted.+- [Download the 1080p copy (43 MB)](docs/video/buck-process-1080p.mp4). The player on the main page is a 1600 px web copy (13 MB).++## Scenes and the clips behind them++Each scene is seen through a slow, eased camera move (a crop that pushes in or pans across the frame), and long recordings are sped up to their action. A scene is exactly as long as its narration plus a short lead-in and tail, so nothing is rushed or padded; scenes cross-dissolve into each other.++| starts at | scene | source |+|---|---|---|+| 0:00 | Opening | KiCad 3D viewer tour from the rework run (`run-rework`, clip recorded 2026-09-30 10:48), played at about 2x with a slow push-in; title in Familjen Grotesk. |+| 0:13 | The circuit | The KiCad schematic from the molecule page, panned and zoomed (a 34 s capture), played at 1.2x. |+| 0:39 | Simulation | Our own adom-spice dashboard run, recorded 2026-10-01 in a background pup window: ngspice's curves landing (real time), LTspice's "2 engines agree" (real time), PSpice for TI starting and its "3 engines agree" (real time). The idle minutes between them are cut. Vendor run times stay hidden (licence). |+| 1:03 | Placement | First run, placement clip: 31 s of the AI placing 24 parts, played at 2.3x, ending on a push-in to the board. |+| 1:16 | Routing and pours | Rework run, pours clip: the board with its pours stripped back to bare traces (25 s at 3.1x, a close pan), then the pours flooding back in (real time). |+| 1:30 | Current and heat | First run, Adom Fields walkthrough: 108 s of the current-density and heat views at about 7x. |+| 1:44 | The rework | First run, routing-rework clip (the sense trace moving, 36 s at 3.5x), then the rework run's second routing visit (62 s at about 8x). |+| 2:02 | Silkscreen, placed live | Rework run, the 16-minute live silkscreen session at about 88x, with a slow pan across the board. |+| 2:12 | Part models | Native KiCad 10 renders (`kicad-cli pcb render`) of the board before and after the part-model cleanup: a dissolve, then camera stops on C1, U1, C2/C3 and D1. |+| 2:29 | Component pages | Turntables of four hero GLBs from the component pages (WS2812B-2020, IN-S63BTG, TPS54202DDCR, EEE-FK1V470P), recorded in a pup window, about 3 s each. |+| 2:40 | On the scaffold | The scaffold scene from `scaffold/viewer.html`, rendered frame by frame in a headless browser (no cursor, no browser chrome) at 2880 x 1620. |+| 2:48 | Close | A rendered closing card in the brand fonts over the after render of the board. |++The screen recordings are the ones on the [build clips](clips.md) and [rework clips](clips-rework.md) pages, taken from their raw 4K masters. The earlier two-minute cut that adom-aiflow made automatically is still here: [build-video.mp4](docs/build-video.mp4).++## The voice-over script++Spoken by adom-tts (the Andrew voice, rate +4 %). Part numbers and units are written out the way they should be spoken; the subtitles show the written form.++**Opening.** This is a twelve volt to five volt, one amp buck converter. Claude designed it, laid it out, and documented it, start to finish, with Adom's tools. Here's how it came together.++**The circuit.** The brief came from a YouTube video, Hardware Design with G P T six: twelve volts in, five volts out at one amp. We kept the brief, and designed the circuit again from scratch, around TI's T P S five four two oh two. Every value comes from the datasheet equations: a fifteen microhenry inductor, three twenty-two microfarad output capacitors, and a sixty-eight picofarad feed-forward capacitor that shapes the loop.++**Simulation.** Before any copper, the design was simulated in three engines at once, with the Adom SPICE dashboard. N G spice runs right in the container. L T spice, and TI's P spice, run on a Windows PC, driven through Adom Bridge. Start-up, both load steps, and the inductor ripple all overlay: three engines, eight measurements, all in agreement.++**Placement.** Then the board. Adom AI Flow drives KiCad ten through the Adom KiCad Bridge, live. Twenty-four parts move onto a twenty-eight by twenty millimetre molecule, with the hot loop packed tight around the regulator.++**Routing and pours.** The routing lands as forty-eight traces, each one checked against KiCad's own design rules before it commits. Then the copper pours flood in: a solid ground, wide input and output planes, and a patch for the switch node.++**Current and heat.** Then the physics. Adom Fields solves current density and heat on the real copper. It found a choke point: two hundred fifteen amps per square millimetre in the neck of the switch node, right at the regulator. So the flow sent the board back.++**The rework.** Back to routing, and back to the pours. The sense trace moved off the ground plane, the switch patch got wider, and thermal vias went in under the regulator. The neck dropped to fifty amps per square millimetre, and the regulator now runs forty-four degrees over ambient, in still air.++**Silkscreen, placed live.** Next, the silkscreen, placed live, group by group: ninety-seven labels, each part's name large and its value small, with nothing sitting on a pad.++**Part models.** Then every 3D model got the same attention. Each part number is laser-etched flat onto the part, in the part's own colours. The LED is tinted to its datasheet wavelength, with its marking on the side, so the window stays clear. And every height matches its datasheet.++**Component pages.** Those models now live on each part's wiki page. Every 3D hero carries the footprint's pads, the silkscreen, and the pin names, so you can see exactly how the part lands on the board.++**On the scaffold.** Finally, the molecule takes its place on a probing scaffold, wired to the control panel, ready for live measurements.++**Close.** One measured run, from a prompt to a finished board. Zero design rule errors. Three simulators in agreement. And every part on it, marked and modelled. The whole story, with every clip, is on the Adom wiki.++## Tools++- **Narration:** `adom-tts say`, one file per scene, edge silence trimmed; the scene length is set from it.+- **Frames:** a small Python renderer reads each source through ffmpeg, crops it with eased keyframes and composites the text: Familjen Grotesk labels, JetBrains Mono chips and Satoshi subtitles on a soft dark glow, using the brand-font helpers from `gang-takes` in [adom/adom-video-post](https://wiki.adom.inc/adom/adom-video-post).+- **Assembly:** ffmpeg cross-dissolves the scenes (0.5 s), lays each narration at its scene's start and normalises loudness (-16 LUFS).+- **Captures made for the video:** the SPICE dashboard run (background pup window), the hero turntables (pup, three.js), the schematic pan (pup), and the scaffold orbit (headless, frame by frame).+- **Review:** frames from every scene were checked on contact sheets; fixes included re-cropping around a wandering mouse cursor, cropping out browser chrome, and re-timing the camera to the subtitles.
docs/video/buck-process-poster.jpgadded
⋯ 1 unchanged line ⋯
docs/video/buck-process.mp4added
⋯ 1 unchanged line ⋯