README.md

hwtLib

hwtLib is the library of hardware components writen using hwt library. Any component can be exported as Xilinx Vivado (IP-exact) or Quartus IPcore using IpPackager or as raw Verilog/VHDL/SystemC code and constraints by to_rtl() function. Target language is specified by keyword parameter serializer.

Content

For example there is a component AxiLiteEndpoint, wich is configured using c-like data type description and it generates a address decoders and convertors to other intefaces if requested. Another example is Axi4S_frameParser, which is configured in same way and performs an extraction of the data fields from an input stream. Hwt type system does contains all c-like and SystemVerilog-like types but in addition it allows for better specification of padding and allignment and has an explicit data type for streams. This allows Axi4S_frameParser to be easily configured to change alignemnt of the stream, cut/split/replace part of the steam with an easy to read HLS-like description.

Verifications are write in UVM like style and as hwt based design are actually a graph we can easily analyse them. This is every useful as it allows us to generate most of the test environment automatically in a user controlled and predictable way and write mostly only a test scenario. For example there is no need to build bus transactions manually as AddressSpaceProbe can discover the mapped address space (for any interface) and we can set register values using a proxy as if it was a normal value. This means that you can write a verification which will have a component with arbitrary bus/address space and it will work as long as you keep the names of the registers the same.

Clock frequencies and target chips usually does not matter but if componet generates constraints it surely needs a correct clock period to generate them correctly.

Also note that the code of the components should be shared if @serializeParamsUniq is used, the design for largest FPGAs takes 5s to generate. The verification should be also fast (take look at travis build) if this is not your case you are probably doing something wrong.

• abstract - abstract classes for component classes like bus endpoint, etc
• amba - AXI interfaces and components for them (AXI3/4 DMAs, interconnects, Axi-stream components, Axi4Lite address decoders etc...)
• avalon - same thing as amba just for Avalon interfaces (AvalonST, AvalonMM, ... and components for them)
• cesnet - components and interfaces specific to Cesnet designs
• clocking - various generic PLLs, timer generators etc.
• commonHwIO - various interfaces which does not have it's package yet
• examples - demonstrative examples of hwt functionality
• handshaked - components for handshaked interfaces (FIFO, AsyncFifo, Resizer, interconnects, Register, ...)
• logic - various components like CRC generator, gray counter, decoders-encoders ...
• mem - various memories (BRAM, ROM, FIFO, Async FIFO, CAM, LUT, ...)
• peripheral - various peripheral interfaces and components (I2C, MDIO, SPI, UART, USB, Ethernet, ...)
• sim - simulation utils
• structManipulators - DMAs for specific data structures
• tests - tests which are not related to another components
• types - deffinitions of common types (uint32_t, ipv6_t, udp_t, ...)
• xilinx - components, primitives and interfaces specific to Xilinx based designs (IPIF, LocalLink, ...)
• 💀 orc-apps - examples for orcc compiler
• 💀 fpga-npu - NPU softprocesor, compiler and runtime If you see any problem/do not underestand something/do miss something open the github issue as others may step uppon same problem sooner or later.

Installation

# from PYPI (latest release)
sudo pip3 install hwtLib

# or from git (latest)
sudo pip3 install -r https://raw.githubusercontent.com/Nic30/hwtLib/master/doc/requirements.txt git+https://github.com/Nic30/hwtLib#egg=hwtLib --upgrade --no-cache

Repositories with opensource HW:

• analogdevicesinc/hdl/
• connectal - framework for software-driven hardware development
• corundum - Packet DMA
• Elphel repositories - Verilog, firmware for Zynq based camera with DDR3, HiSPi, JPEG
• enjoy-digital repositories - Migen, SoC level modules
• FPGAwars FPGA-peripherals - Verilog, simple peripherals
• hdl4fpga - Verilog/VHDL various peripherals
• hdl-util - SV, various IO
• analogdevicesinc/hdl - Verilog, Library of common components for AnalogDevices chip interfacing
• leon/grlib - Library of SoC components
• myhdl-resources - MyHDL list of projects
• NyuziProcessor - GPGPU
• opencores - everything
• openrisc - OpenRISC, FuseSoC, peripherals and cpu parts
• picorv32 - Verilog, A Size-Optimized RISC-V SoC
• PoC - VHDL, utils
• pulp-platform
• rhea - MyHDL, SoC level modules
• SpinalCrypto - SpinalHDL, various crypto/hash functions
• surf - VHDL, SoC/DSP/IO/Ethernet focused components
• tinyfpgax
• ultraembedded/cores - mostly Verilog, mostly peripherals
• ZipCPU repositories - Verilog, mostly peripherals, DSP
• hls-fpga-machine-learning - Python -> HSL C++, mostyl ML and video processing
• fpgasystems - HLS C++, SystemVerilog, FPGA @ Systems Group, ETH Zurich, mostly networking
• Limago - SV/VHDL - 100G TCP/IP stack
• Vitis_Libraries - C++/VitisHLS - set of various algorithms implemented in VitisHLS
• Vitis HLS Introductory Examples - C++/VitisHLS - set of various examples for VitisHLS
• WangXuan95 repositories - SV - compression, encoding, USB, DSP
• vortexgpgpu
• wav-lpddr-hw - SV - LPDDR4x/LPDDR5, DFI5.0
• hlslibs - C++/VitisHls - set of libraries for mostly focused on ML/DSP and generic math
• OpenXiangShan - Chisel3 - performance focused RISC-V
• Parretto/DisplayPort - SV - universal RX/TX DisplayPort core
• fabriziotappero/ip-cores - SV/VHDL
• EttusResearch/fpga - SV - SDR focused
• WangXuan95 repositories - SV - Compression/Image processing focused