Files
maksyuki 3b6a925a51 feat: add documentation for new utility components and scripts
- Created documentation for , , , and  modules, detailing their functionality, parameters, and usage examples.
- Implemented a script  to ensure required headings and content are present in documentation files.
- Developed  to generate and update documentation pages from SystemVerilog declarations, ensuring consistency and completeness.
2026-08-04 16:35:53 +08:00

2.1 KiB

tech_pll

Property Value
Kind module
RTL source rtl/tech/pll.sv
Availability Technology model; replace in an ASIC technology flow

Summary

Technology PLL abstraction.

Functional Behavior

Technology PLL abstraction. It supplies portable functional behavior or a backend substitution hook, not characterized silicon timing or power behavior.

Suitable Applications

Use for simulation, generic synthesis, FPGA prototyping, and technology-independent elaboration.

Parameters

This unit has no configurable parameters.

Interface Definition

module tech_pll #(
) (
    input  logic        fref_i,
    input  logic [ 5:0] refdiv_i,
    input        [11:0] fbdiv_i,
    input  logic [ 2:0] postdiv1_i,
    input  logic [ 2:0] postdiv2_i,
    output logic        pll_lock_o,
    output logic        pll_clk_o
);

Port Summary

Signal Direction Declaration
fref_i input input logic fref_i
refdiv_i input input logic [ 5:0] refdiv_i
fbdiv_i input input [11:0] fbdiv_i
postdiv1_i input input logic [ 2:0] postdiv1_i
postdiv2_i input input logic [ 2:0] postdiv2_i
pll_lock_o output output logic pll_lock_o
pll_clk_o output output logic pll_clk_o

Integration and Use

Replace it through the target technology flow before ASIC tape-out. Treat its active-low controls and backend macros as part of the integration contract.

tech_pll u_tech_pll (
    .fref_i(fref_i),
    .refdiv_i(refdiv_i),
    .fbdiv_i(fbdiv_i),
    .postdiv1_i(postdiv1_i),
    .postdiv2_i(postdiv2_i),
    .pll_lock_o(pll_lock_o),
    .pll_clk_o(pll_clk_o)
);

Dependencies and Verification

The linked RTL source is the implementation authority and contains local assertions for unsupported parameter combinations. See docs/design.md for repository-wide CDC, reset, stream, and storage contracts, and docs/verification.md for the verification matrix.