Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
37 changes: 37 additions & 0 deletions docs/dmx-smoke-evidence/2026-06-30-sacn/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
# PlotForge D4 sACN Hardware Smoke Evidence

Date: 2026-06-30

Status: scaffold only; sACN hardware run pending

## Required Files

- [ ] `relay.log` — output from `npm run dmx:relay`
- [ ] `capture.pcap` or `capture.pcapng` — sACN UDP packet capture on port 5568
- [ ] `node-ui.png` — screenshot of sACN node receive/output UI
- [ ] `fixture-video.mov` or `fixture-video.mp4` — optional, required for fixture verified status

## Hardware

- Protocol: sACN
- Node:
- Node firmware:
- Node IP:
- Network interface:
- Fixture or dimmer:
- DMX universe/address:

## Results

- [ ] No output before arming
- [ ] Arm succeeds
- [ ] Selected fixture intensity test works
- [ ] Blackout works
- [ ] Bad target fails visibly
- [ ] Network disconnect faults visibly
- [ ] Relay crash or tab failure faults and blacks out
- [ ] Blackout recovery works

## Evidence Notes

Record packet count, node UI status, fixture behavior, unicast or multicast mode, and any failures here before marking D4 verified.
37 changes: 37 additions & 0 deletions docs/dmx-smoke-evidence/2026-06-30/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
# PlotForge D3 Hardware Smoke Evidence

Date: 2026-06-30

Status: scaffold only; hardware run pending

## Required Files

- [ ] `relay.log` — output from `npm run dmx:relay`
- [ ] `capture.pcap` or `capture.pcapng` — Art-Net UDP packet capture
- [ ] `node-ui.png` — screenshot of Art-Net node receive/output UI
- [ ] `fixture-video.mov` or `fixture-video.mp4` — optional, required for fixture verified status

## Hardware

- Protocol: Art-Net
- Node:
- Node firmware:
- Node IP:
- Network interface:
- Fixture or dimmer:
- DMX universe/address:

## Results

- [ ] No output before arming
- [ ] Arm succeeds
- [ ] Selected fixture intensity test works
- [ ] Blackout works
- [ ] Bad target fails visibly
- [ ] Network disconnect faults visibly
- [ ] Relay crash or tab failure faults and blacks out
- [ ] Blackout recovery works

## Evidence Notes

Record packet count, node UI status, fixture behavior, and any failures here before marking D3 verified.
29 changes: 29 additions & 0 deletions docs/dmx-smoke-evidence/local/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
# PlotForge Local DMX Smoke Evidence

Status: local pre-hardware proof only

Run:

```bash
PATH=/opt/homebrew/opt/node@22/bin:$PATH npm run dmx:local-smoke
```

The script starts a loopback DMX relay, opens an authenticated WebSocket session, sends Art-Net and sACN unicast frames to a local UDP listener, and writes `local-smoke-latest.json`.

This proves:

- Relay `/health`.
- Origin rejection.
- No UDP before an authenticated frame command.
- Bad target rejection without UDP.
- 512-slot ArtDmx frame emission to a UDP listener.
- Art-Net blackout burst all-zero frames.
- 512-slot sACN frame emission to a UDP listener.
- sACN blackout burst all-zero frames.
- Heartbeat watchdog fault plus blackout.
- Active client disconnect blackout.
- Relay shutdown blackout.

Controlled sACN multicast target derivation is covered by automated relay tests, not by this loopback smoke. Real multicast behavior still belongs in D4 hardware/network smoke.

This does **not** satisfy D3 or D4 hardware verification. D3 still requires relay log, packet capture, node UI screenshot, and a real Art-Net fixture or dimmer result in `docs/dmx-smoke-evidence/2026-06-30/`. D4 still requires the same class of proof on a sACN-capable node.
Loading