Skip to content

Conventions

This section explains the symbols and conventions used throughout the Mach-V documentation.

Symbols

The documentation uses visual badges to denote specific hardware states, version requirements, or configuration settings. Please familiarize yourself with the following conventions:

– Version

The tag symbol denotes the Mach-V Core Version required for a specific feature or architectural change. Ensure your hardware description (RTL) matches this version tag to guarantee compatibility.

– Optional Feature

This symbol indicates a hardware module (such as the Branch Predictor or FPU) that is not included in the core by default. These features must be explicitly enabled via Verilog defines (e.g., `define ENABLE_FPU) in your configuration file.

– External IP / Plugin

This symbol refers to External IP Cores (like Xilinx Clock Wizards or AMD Multipliers) or software plugins used in the project. These components may require specific vendor licenses or additional synthesis libraries.

– Experimental

Features marked with the flask symbol are currently being tested on the FPGA and may be unstable. The timing closure or logic correctness for these features is not yet guaranteed in all corner cases.

– Default Value

Indicates the default reset value of a hardware register or a configuration parameter if not otherwise specified by the software bootloader.