feat(v2): M8 PSRAM integration - real V1 backend shared across concurrent slots

neural_multiprocessor.v wraps dataflow_core.v (M7, unmodified) around
the real, unmodified V1 PSRAM backend chain (int8_memory_access ->
memory_interface -> psram_controller), funneling N_SLOTS independent
Memory Backend Interface ports through a new generic N-port arbiter
(slot_mem_arbiter.v) inspired by (not copied from) V1's own
mem_arbiter.v.

Real concurrent-slot simulation immediately surfaced a genuine bug
(ERR-0008): memory_manager/prefetch_engine's byte-level backend
protocol is fire-and-forget (a single-cycle mem_req pulse with no
accept handshake) - correct for M4's direct 1:1 connection, but a
naive arbiter silently drops a pulse arriving while the shared bus is
owned by another slot, hanging that slot forever. Fixed with a
per-port pending-request latch, the same "queue, don't drop" idiom
already used by memory_manager's own pf_pending register (ERR-0006).

Verified (Verilator): 4/4 PASS with 2 slots genuinely contending for
one real PSRAM port (444 cycles). No regression on M4's own
testbench. Real synthesis + nextpnr-ecp5 P&R (no harness needed - real
PSRAM pins keep the top-level at 157 pins): 0 problems, Fmax 142.45
MHz, PASS at 80MHz.

Arbitration policy is fixed lowest-index priority, not fairness-
balanced (DEC-0010) - consistent with every other "simplest correct
policy first" scheduling choice in this roadmap, revisited only if
M9's real measurement shows starvation matters.

Logged: simulation/synthesis/timing/benchmark/decisions (DEC-0010)/
experiments (EXP-0009)/errors (ERR-0008)/development.log, ROADMAP.md
updated.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013xXuuRUWZScuo1DeYJxs3v
This commit is contained in:
2026-09-05 15:13:11 +02:00
co-authored by Claude Sonnet 5
parent 77baa8fc16
commit 6cff2c8a7c
12 changed files with 732 additions and 1 deletions
+51
View File
@@ -203,3 +203,54 @@ WORKAROUND: set the parameter on the TOP module being synthesized
STATUS: WORKED AROUND. A build-script ordering detail, not a defect in
dataflow_core.v or harness_dataflow_core.v themselves -- noted here
so a future N_SLOTS sweep (M9/M10) does not re-trip over it.
ERR-0008 (real RTL bug in the first draft of hardware/v2/rtl/slot_mem_arbiter.v, FOUND AND FIXED)
DATE: 2026-09-05
MODULE: hardware/v2/rtl/slot_mem_arbiter.v (M8, new)
SYMPTOM: hardware/v2/sim/tb_neural_multiprocessor.v -- node0 (slot 0)
completes correctly (result=48), but node1 (slot 1, dispatched
concurrently to node0) never completes; its byte-level backend
request appears to simply vanish, and the slot hangs forever
(watchdog timeout at 20000 cycles, result stays 0).
ROOT CAUSE: memory_manager.v/prefetch_engine.v's own byte-level
backend protocol (mem_req/mem_wr/mem_addr/mem_wdata/mem_rdata/
mem_ready) is FIRE-AND-FORGET: mem_req is asserted for exactly ONE
clock cycle per byte transaction, with no separate "request
accepted" acknowledgment -- only `mem_ready` (transaction
COMPLETION) exists. M4's own testbench (tb_memory_manager.v) never
exposed this because it connects exactly ONE memory_manager directly
to int8_memory_access, which is always idle and therefore always
able to accept that single pulse the instant it fires. The first
arbiter draft only granted a port while its s_req was LIVE that same
cycle -- if slot 1's one-cycle pulse arrived on a cycle where the
arbiter was already owned by slot 0, the pulse was gone the very
next cycle with no record of it ever having happened, and slot 1's
prefetch_engine sat in ST_READ_X/ST_READ_W waiting forever for a
mem_ready that could never arrive (its request never reached
int8_memory_access at all).
DIAGNOSIS METHOD: ran the M8 testbench, observed node0 (whichever slot
the Director happened to grant the shared bus to first) complete
while node1 (the other, concurrently-dispatched slot) hung; traced
the fire-and-forget nature of mem_req directly in
prefetch_engine.v's own state machine (`mem_req <= 1'b1;` appearing
only inside single-cycle state-transition branches, unconditionally
cleared to 0 every other cycle) -- confirmed the arbiter's naive
"grant only while req is live" logic could not possibly catch a
pulse arriving during contention.
FIX: every incoming s_req pulse is now LATCHED into a per-port
`pending` register (capturing wr/addr/wdata the same cycle),
regardless of arbiter state -- the same single-entry "queue, don't
drop the request" idiom already used by memory_manager's own
pf_pending register (ERR-0006 fix #1). Grants are drawn from
`pending`, never from a live s_req directly. This adds a uniform
minimum 1-cycle latency to every byte transaction (a real, honestly
measured cost of sharing one PSRAM port across N_SLOTS -- see
timing.log/benchmark.log EXP-0009), but never drops a request
regardless of contention.
VERIFICATION: hardware/v2/sim/tb_neural_multiprocessor.v -- 4/4 PASS
after the fix (444 cycles end-to-end, vs the buggy draft's 20000-
cycle watchdog timeout). hardware/v2/sim/tb_memory_manager.v (M4,
untouched) re-run unchanged -- still 3/3 PASS, confirming the fix is
entirely contained inside the new arbiter module.
STATUS: FIXED, verified end-to-end with the real (unmodified) V1
PSRAM backend chain and real concurrent multi-slot contention.