Radical Computer Technologies
RadHDL Documentation

Version Change Notes

RadHDL 0.2.2-beta.1 / Experimental Crimson release

This release starts the vendor-portability push for RadHDL while keeping generated API datasheets available for existing RadIF, RadDSP, and RadILA modules.

Highlights

RadPrimitive Package DirectionIntroduces a documented primitive boundary for RAM, FIFO, CDC, and DSP resources.
Updated Datasheet CatalogRegenerates 0.2.2 datasheets from current RadHDL source instead of reusing the 0.2.1 generated catalog.
Vendor Wrapper CoverageDocuments Xilinx XPM/DSP48, Lattice ECP5 RAM/DSP direction, Gowin FIFO/DSP direction, and generic behavioral fallbacks.
Simulation MatrixFormalizes GHDL as the default open simulator and Vivado xsim as the XPM-backed simulator path.
Workflow DocumentationAdds Getting Started, package structure, RadBuild integration, standalone toolchain notes, and the first design guide.

Documentation Correction

The first 0.2.2 web documentation pass added the Getting Started and guide pages but copied the 0.2.1 generated datasheet catalog. This follow-up fixes the generator input and grouping rules so common/hdl/src, common/hdl/ecp5, RadPrimitive RAM/FIFO/CDC wrappers, and vendor primitive wrappers appear directly in the searchable datasheet browser.

Validation Markers

The RadHDL 0.2.2 branch was prepared with primitive portability smoke coverage for open and vendor simulator paths. The expected evidence markers include:

RADHDL_RAM_LATTICE_GHDL_OK
RADHDL_FIFO_SYNC_LATTICE_GHDL_OK
RADHDL_RAM_XILINX_XPM_XSIM_OK
RADHDL_FIFO_SYNC_XILINX_XPM_XSIM_OK

Known Gaps

AreaStatus
Generated datasheet catalogThe searchable catalog has been regenerated for 0.2.2 and now includes RadPrimitive datasheets. Simulation waveforms were not rerun during this web-doc refresh; validation evidence is tracked by the RadHDL simulation matrix.
XPM portabilityVivado xsim remains the authoritative path for XPM SystemVerilog simulation bodies. GHDL is used for portable VHDL behavior and non-XPM primitive models.
Board guidesColorlight i9 ECP5, Gowin GW5A, and expanded Xilinx board guides are planned follow-ups.

Related Pages

Getting Started Guides RadHDL 0.2.2 Home