rtl: implement Chisel skeleton for PopLinkPHY_Behavioral

navigator commented

2026-05-25 14:35:05 -03:00

Owner

Goal

Implement the Chisel skeleton for PopLinkPHY_Behavioral per rtl/src/pop/specs/PopLinkPHY_Behavioral.SPEC.md. This issue closes the gap between the SPEC text and a buildable Scala module, with an IO bundle, internal stubs, and a chiseltest unit testbench skeleton — no full behaviour yet.

Module dep status: leaf.

Acceptance criteria

rtl/src/pop/PopLinkPHY_Behavioral.scala exists, compiles under Chipyard 1.13.0 with sbt compile green
IO bundle reflects the Interface section of PopLinkPHY_Behavioral.SPEC.md (use ??? / DontCare for fields where the spec is TBD — annotate each with a // TBD per SPEC §<section> comment)
Module is wired into the parent (only for non-leaf modules; leaves can stand alone)
rtl/tests/PopLinkPHY_Behavioral/PopLinkPHY_BehavioralSpec.scala exists with a chiseltest AnyFlatSpec skeleton: at least one test that elaborates the module via should "elaborate"
Header preserved: SPDX-License-Identifier: CHARRUA-1.2 on the Scala source; AGPL-3.0-or-later on the test
No fabricated values for spec TBD items — leave as DontCare with comment, do not invent widths/timing

Blocked on

#46 (Chipyard install) — without the toolchain, sbt compile cannot run.

Plan refs

PLAN.md §8.2 (custom module list); §12.3 (per-module verification floor). ADRs that constrain this module: see SPEC file header.

Notes

Coverage targets and full behaviour come in follow-up issues. This issue is the skeleton + elaborate.
Do not modify the SPEC file itself in this PR — SPEC edits are separate decisions.

## Goal Implement the Chisel skeleton for `PopLinkPHY_Behavioral` per `rtl/src/pop/specs/PopLinkPHY_Behavioral.SPEC.md`. This issue closes the gap between the SPEC text and a buildable Scala module, with an IO bundle, internal stubs, and a chiseltest unit testbench skeleton — no full behaviour yet. **Module dep status:** leaf. ## Acceptance criteria - [ ] `rtl/src/pop/PopLinkPHY_Behavioral.scala` exists, compiles under Chipyard 1.13.0 with `sbt compile` green - [ ] IO bundle reflects the **Interface** section of `PopLinkPHY_Behavioral.SPEC.md` (use `???` / `DontCare` for fields where the spec is `TBD` — annotate each with a `// TBD per SPEC §<section>` comment) - [ ] Module is wired into the parent (only for non-leaf modules; leaves can stand alone) - [ ] `rtl/tests/PopLinkPHY_Behavioral/PopLinkPHY_BehavioralSpec.scala` exists with a chiseltest `AnyFlatSpec` skeleton: at least one test that elaborates the module via `should "elaborate"` - [ ] Header preserved: `SPDX-License-Identifier: CHARRUA-1.2` on the Scala source; `AGPL-3.0-or-later` on the test - [ ] No fabricated values for spec `TBD` items — leave as `DontCare` with comment, do not invent widths/timing ## Blocked on - #46 (Chipyard install) — without the toolchain, `sbt compile` cannot run. ## Plan refs PLAN.md §8.2 (custom module list); §12.3 (per-module verification floor). ADRs that constrain this module: see SPEC file header. ## Notes - Coverage targets and full behaviour come in follow-up issues. This issue is the **skeleton + elaborate**. - Do **not** modify the SPEC file itself in this PR — SPEC edits are separate decisions.

navigator added the

area:rtl

phase:1

labels

2026-05-25 14:35:05 -03:00

navigator added the

agent:queued

label

2026-05-25 16:23:47 -03:00

navigator commented

2026-05-25 16:23:55 -03:00

Author

Owner

Chipyard 1.13.0 installed on agent host as of #59 (sbt 1.12.11, Verilator 5.032, chipyard at ~/chipyard/ pinned to commit 69eba86). Toolchain is reachable from any worktree — sbt compile should work after sourcing ~/chipyard/env.sh (or running from inside the chipyard tree). Now queued for resolver.

Chipyard 1.13.0 installed on agent host as of #59 (sbt 1.12.11, Verilator 5.032, chipyard at `~/chipyard/` pinned to commit 69eba86). Toolchain is reachable from any worktree — `sbt compile` should work after sourcing `~/chipyard/env.sh` (or running from inside the chipyard tree). Now queued for resolver.

navigator added

agent:in-progress

and removed

agent:queued

labels

2026-05-25 17:22:10 -03:00

navigator commented

2026-05-25 17:22:10 -03:00

Author

Owner

No description provided.