A standard library for VHDL - amplified.
This project is tested using the IEEE standard for VHDL 93, 02, and 08.
Run the following Orbit command:
orbit install amp:1.0.0 --url "https://github.com/hyperspace-labs/amp/archive/refs/tags/1.0.0.zip"
Add the following line to your Orbit.toml:
amp = "1.0.0"
Common functionality is grouped together within packages. A special prelude package exists as means to gather the set of commonly used and most basic types and functions. Keeping the prelude package a relatively lean set of items allows advantages in reduced complexity and size of the prelude, while allowing to be more easily assimilated into other projects. If not using the prelude package, a user must explicitly specify each package that is otherwise included in the prelude.
The following packages are currently available:
| Name | Description | Included in prelude? |
|---|---|---|
types |
Improved type names and additional types | ✔ |
cast |
Convenient conversions between types | ✔ |
manip |
Bit manipulation operations | ✔ |
math |
Compile-time arithmetic functions | |
dims |
Functions for interpreting linear vectors in multi-dimensional space |
This package strives to meet the following objectives:
- minimal: Implement the minimum set of functions necessary for any project, and wrap existing built-in functions when it makes sense
- general-purpose: Be generic enough for practicality in all applications
- interoperable: Be able to be used among varying standards (93, 08, etc.) without breaking existing built-in functionalities
After installing and adding amp to your project's Orbit.toml file, use the package wherever necessary:
Filename: my_design.vhd
library ieee;
use ieee.std_logic_1164.all;
library amp;
use amp.prelude.all;
entity my_design is
-- ...