Rtl Ip Instantiate

Prerequisites

• IP descriptor present at docs/ip/{ip_name}.xml (IP-XACT) or equivalent datasheet.
• Project coding conventions readable from rtl/ip_wrappers/ (existing wrappers) or .claude/rules/rtl-coding-conventions.md.

If missing: WARNING — halt and ask user for IP descriptor location before generating.

Apply steps 1-6 to every requested IP — do not stop after the first.

Task(subagent_type="rtl-agent-team:rtl-architect", prompt="Read IP descriptor at docs/ip/{ip_name}.xml (or datasheet). List all ports, " "required tie-offs, and parameter settings. Design wrapper interface: map vendor " "port names to project convention (i_/o_/io_ prefixes, {domain}_clk, {domain}_rst_n).")

Task(subagent_type="rtl-agent-team:rtl-coder", prompt="Write rtl/ip_wrappers/{ip_name}wrapper.sv. Instantiate {ip_name} as u{ip_name} " "with all ports connected per architect spec. Use logic only (no reg/wire). " "Port prefixes: i_ input, o_ output, io_ bidirectional. " "Clock: {domain}_clk, reset: {domain}_rst_n. " "Tied ports: // TIED: reason. Parameters: // PARAM: description.")

</Tool_Usage>

<Examples>
<example index="1">
<scenario>SRAM IP with 32 vendor ports; IP-XACT at docs/ip/sram.xml; project uses AXI4-Lite.</scenario>
<expected_output>rtl-explorer confirms i_/o_ prefix style; rtl-architect maps vendor clk→sys_clk, rst_n→sys_rst_n, din→i_sram_din; rtl-coder writes wrapper with u_sram instance and logic types; lint passes.</expected_output>
</example>

<example index="2">
<scenario>PLL IP with test-mode ports that must be tied off.</scenario>
<expected_output>All functional ports connected; test-mode ports tied to constants with `// TIED: unused test mode input` comments; parameter DATA_WIDTH documented with `// PARAM: AXI data bus width`.</expected_output>
</example>

<example index="3">
<scenario>IP has port width mismatch — vendor provides 36-bit data bus, project interface is 32-bit.</scenario>
<expected_output>rtl-architect flags mismatch to user; wrapper generation halted pending user resolution decision; no auto-truncation performed.</expected_output>
</example>
</Examples>

<Escalation_And_Stop_Conditions>
- IP descriptor not found → halt immediately; ask user for datasheet or IP-XACT file path.
- Port width mismatch between IP and project interface → flag to user; do not auto-resolve.
- Generated wrapper fails lint → fix all errors before delivering; do not suppress warnings without documented rationale.
</Escalation_And_Stop_Conditions>

## Output

- `rtl/ip_wrappers/{ip_name}_wrapper.sv` — convention-compliant wrapper module.

<Final_Checklist>
- [ ] IP port list fully read from descriptor before writing wrapper.
- [ ] All IP ports connected or explicitly tied off with `// TIED: reason` comments.
- [ ] Wrapper ports use `i_`/`o_`/`io_` prefixes (NOT `_i`/`_o` suffix).
- [ ] Clocks use `clk` or `{domain}_clk` naming (NOT `clk_i`).
- [ ] Resets use `rst_n` or `{domain}_rst_n` naming (NOT `rst_ni`).
- [ ] IP instance uses `u_` prefix (e.g., `u_{ip_name}`).
- [ ] `logic` types only — no `reg`/`wire`.
- [ ] Parameters documented with `// PARAM:` comments.
- [ ] Lint passes (Verible + slang) on generated wrapper.
- [ ] Wrapper path reported: `rtl/ip_wrappers/{ip_name}_wrapper.sv`.
</Final_Checklist>