mirror of
https://github.com/pConst/basic_verilog.git
synced 2025-01-14 06:42:54 +08:00
README update
This commit is contained in:
parent
d046210740
commit
3aa56798bd
167
README.md
167
README.md
@ -1,85 +1,106 @@
|
|||||||
Must-have verilog systemverilog modules
|
Must-have verilog systemverilog modules
|
||||||
---------------------------------------
|
=======================================
|
||||||
|
Originally published as part of https://github.com/pConst/basic_verilog
|
||||||
|
by Konstantin Pavlov, pavlovconst@gmail.com
|
||||||
|
|
||||||
Hello! This is a collection of verilog systemverilog synthesizable modules.<br>
|
Hi! This is a collection of Verilog SystemVerilog synthesizable modules.
|
||||||
All the code is highly reusable across typical FPGA projects and mainstream FPGA vendors.<br>
|
|
||||||
Please feel free to contact me in case you found any code issues.<br>
|
|
||||||
Also, give me a pleasure, tell me if the code has got succesfully implemented in your hobby, scientific or industrial projects!<br>
|
|
||||||
|
|
||||||
Konstantin Pavlov, pavlovconst@gmail.com
|
All the code is highly reusable across typical FPGA projects and mainstream FPGA vendors.
|
||||||
|
|
||||||
The code is licensed under CC BY-SA 4_0.<br>
|
Please feel free to make pull requests or contact me in case you spot any code issues.
|
||||||
You can remix, transform, and build upon the material for any purpose, even commercially<br>
|
|
||||||
You must provide the name of the creator and distribute your contributions under the same license as the original<br>
|
|
||||||
|
|
||||||
Directories description:
|
Also, give me a pleasure, tell me if the code has got succesfully implemented in your hobby, scientific or industrial projects!
|
||||||
-----------------------
|
|
||||||
|
|
||||||
| DIRECTORY | DESCRIPTION |
|
Licensing
|
||||||
|-----------|-------------|
|
---------
|
||||||
| Advanced Synthesis Cookbook/ | useful code from Altera's cookbook |
|
The code is licensed under CC BY-SA 4_0
|
||||||
| KCPSM6_Release9_30Sept14/ | Xilinx's Picoblaze soft processo |
|
That means, that you can remix, transform, and build upon the material for any purpose, even commercially.
|
||||||
| pacoblaze-2.2/ | version of Picoblaze adapted for Altera devices |
|
However, YOU MUST provide the name of the creator and distribute your contributions under the same license as the original.
|
||||||
| example_projects/ | FPGA project examples |
|
|
||||||
| benchmark_projects/ | compilation time benchmarks for a dosen of FPGA types |
|
|
||||||
| scripts/ | useful TCL scripts |
|
|
||||||
|
|
||||||
Scripts description:
|
Contents description
|
||||||
--------------------
|
--------------------
|
||||||
|
For your convinience I`ve tagged some sources by their "difficulty":
|
||||||
|
:green_circle: - for the most basic tasks
|
||||||
|
:red_circle: - for advanced or special purpose routines
|
||||||
|
|
||||||
| SCRIPT | DESCRIPTION |
|
If you are a beginner in HW design - you may want to start exploring :green_circle: code first.
|
||||||
|--------|-------------|
|
Almost every source file in the repository contains detailed description and instantiation template!
|
||||||
| scripts/allow_undefined_ports.tcl | allows generation of test projects with undefined pins for Vivado IDE |
|
|
||||||
| scripts/compile_quartus.tcl | boilerplate script for commandline project compilation in Quartus IDE |
|
|
||||||
| scripts/convert_sof_to_jam.bat | Altera/Intel FPGA configuration file converter |
|
|
||||||
| scripts/convert_sof_to_rbf.bat | another Altera/Intel FPGA configuration file converter |
|
|
||||||
| scripts/iverilog_compile.tcl | complete script to compile Verilog sources with iverilog tool and run simulation in gtkwave tool |
|
|
||||||
| scripts/modelsim_compile.tcl | Modelsim no-project-mode compilation script |
|
|
||||||
| scripts/post_flow_quartus.tcl | custom reporting or report analisys for Intel Quartus IDE |
|
|
||||||
| scripts/post_flow_vivado.tcl | custom reporting or report analisys for Xilinx Vivado IDE |
|
|
||||||
| scripts/program_all.bat | command line programmer example for Altera/Intel FPGAs |
|
|
||||||
| scripts/project_version_auto_increment.tcl | project version autoincrement script for Quartus IDE |
|
|
||||||
| scripts/quartus_system_console_init.tcl | initialization script for reading/writing Avalon-MM through JTAG-to-Avalon-MM bridge IP |
|
|
||||||
| scripts/set_project_directory.tcl | changes current directory to match project directory in Vivado IDE |
|
|
||||||
| scripts/write_avalon_mm_from_file.tcl | writing bulk binary data from binary file to Avalon-MM through JTAG-to-Avalon-MM bridge IP |
|
|
||||||
|
|
||||||
Modules description:
|
| USAGE | DIRECTORY | DESCRIPTION |
|
||||||
--------------------
|
|---------------|--------------|-------------|
|
||||||
|
| | Advanced Synthesis Cookbook/ | useful code from Altera's cookbook |
|
||||||
|
| | KCPSM6_Release9_30Sept14/ | Xilinx's Picoblaze soft processor sources |
|
||||||
|
| :red_circle: | XilinxBoardStore_with_Alveo_cards_support | board definitions for Xilinx Alveo accelerator cards |
|
||||||
|
| | pacoblaze-2.2/ | version of Picoblaze adapted for Altera devices |
|
||||||
|
| | avalon_mm_master_templates/ | Avalon-MM component templates from Altera |
|
||||||
|
| | axi_master_slave_templates/ | AXI componet templates generated by Vivado |
|
||||||
|
| | benchmark_projects/ | benchmarking various IDEs to compile exact same Verilog project |
|
||||||
|
| | dual_port_ram_templates/ | Block RAM templates |
|
||||||
|
| | example_projects/ | FPGA project boilerplates and examples |
|
||||||
|
| | gitignores/ | gitignore files for FPGA projects |
|
||||||
|
| | scripts/ | useful TCL, batch and shell scripts |
|
||||||
|
| :red_circle: | scripts_for_intel_hls/ | useful scripts for compiling for Intel HLS |
|
||||||
|
| :red_circle: | scripts_for_xilinx_hls/ | useful scripts for compiling for Xilinx HLS |
|
||||||
|
| | xpm | Xilinx parametrizable macros sources |
|
||||||
|
|
||||||
| MODULE | DESCRIPTION |
|
| USAGE | FILE | DESCRIPTION |
|
||||||
|--------|-------------|
|
|----------------|--------------------|-------------|
|
||||||
| ActionBurst.v | multichannel one-shot triggering module |
|
| | adder_tree.sv | adding multiple values together in parallel |
|
||||||
| ActionBurst2.v | multichannel one-shot triggering with variable steps |
|
| | axi4l_logger.sv | |
|
||||||
| adder_tree.sv | adding multiple values together in parallel |
|
| :green_circle: | bin2gray.sv | combinational Gray code to binary converter |
|
||||||
| bin2gray.sv | combinational Gray code to binary converter |
|
| | bin2pos.sv | converts binary coded value to positional (one-hot) code |
|
||||||
| bin2pos.sv | converts binary coded value to positional (one-hot) code |
|
| | cdc_data.sv | |
|
||||||
| clk_divider.sv | wide reference clock divider |
|
| | cdc_strobe.sv | |
|
||||||
| debounce.v | two-cycle debounce for input buttons |
|
| :green_circle: | clk_divider.sv | wide reference clock divider |
|
||||||
| delay.sv | useful module to make static delays or to synchronize across clock domains |
|
| | clogb2.svh | |
|
||||||
| dynamic_delay.sv | dynamic delay for arbitrary input signal |
|
| :green_circle: | debounce.v | two-cycle debounce for input buttons |
|
||||||
| edge_detect.sv | combinational edge detector, gives one-tick pulses on every signal edge |
|
| :green_circle: | delay.sv | useful module to make static delays or to synchronize across clock domains |
|
||||||
| encoder.v | digital encoder input logic module |
|
| | delayed_event.sv | |
|
||||||
| fifo_single_clock_reg_*.sv | single-clock FIFO buffer (queue) implementation |
|
| | dynamic_delay.sv | dynamic delay for arbitrary input signal |
|
||||||
| gray2bin.sv | combinational binary to Gray code converter |
|
| :green_circle: | edge_detect.sv | combinational edge detector, gives one-tick pulses on every signal edge |
|
||||||
| leave_one_hot.sv | combinational module that leaves only lowest hot bit |
|
| | encoder.v | digital encoder input logic module |
|
||||||
| lifo.sv | single-clock LIFO buffer (stack) implementation |
|
| :red_circle: | fast_counter.sv | |
|
||||||
| main_tb.sv | basic testbench template |
|
| | fifo_combiner.sv | |
|
||||||
| NDivide.v | primitive integer divider |
|
| | fifo_operator.sv | |
|
||||||
| pos2bin.sv | converts positional (one-hot) value to binary representation |
|
| :red_circle: | fifo_single_clock_ram_*.sv | single-clock FIFO buffer (queue) implementation |
|
||||||
| pos2bin.sv | converts positional (one-hot) value to binary representation |
|
| :red_circle: | fifo_single_clock_reg_*.sv | single-clock FIFO buffer (queue) implementation |
|
||||||
| prbs_gen_chk.sv | PRBS pattern generator or checker |
|
| :green_circle: | gray2bin.sv | combinational binary to Gray code converter |
|
||||||
| pulse_gen.sv | generates pulses with given width and delay |
|
| :red_circle: | gray_functions.vh | |
|
||||||
| pulse_stretch.sv | configurable pulse stretcher/extender module |
|
| :green_circle: | hex2ascii.sv | |
|
||||||
| reset_set.sv | SR trigger variant w/o metastable state, set dominates here |
|
| | leave_one_hot.sv | combinational module that leaves only lowest hot bit |
|
||||||
| reverse_bytes.sv | reverses bytes order within multi-byte array |
|
| | lifo.sv | single-clock LIFO buffer (stack) implementation |
|
||||||
| reverse_vector.sv | reverses signal order within multi-bit bus |
|
| | main_tb.sv | basic testbench template |
|
||||||
| set_reset.sv | SR trigger variant w/o metastable state, reset dominates here |
|
| | moving_average.sv | |
|
||||||
| spi_master.sv | universal spi master module |
|
| | pack_unpack_array.v | |
|
||||||
| UartRx.v | straightforward yet simple UART receiver |
|
| | pattern_detect.sv | |
|
||||||
| UartTx.v | straightforward yet simple UART transmitter |
|
| | pdm_modulator.sv | |
|
||||||
| uart_rx_shifter.sv | UART-like receiver shifter for simple synchronous messaging inside the FPGA or between FPGAs |
|
| | pos2bin.sv | converts positional (one-hot) value to binary representation |
|
||||||
| uart_rx_shifter.sv | UART-like receiver shifter for simple synchronous messaging inside the FPGA or between FPGAs |
|
| | prbs_gen_chk.sv | PRBS pattern generator or checker |
|
||||||
| UartRxExtreme.v | extreme minimal UART receiver implementation |
|
| | preview_fifo.sv | |
|
||||||
| UartTxExtreme.v | extreme minimal UART transmitter implementation |
|
| | priority_enc.sv | |
|
||||||
|
| | pulse_gen.sv | generates pulses with given width and delay |
|
||||||
|
| | pulse_stretch.sv | configurable pulse stretcher/extender module |
|
||||||
|
| | pwm_modulator.sv | |
|
||||||
|
| :red_circle: | read_ahead_buf.sv | |
|
||||||
|
| | reset_set.sv | SR trigger variant w/o metastable state, set dominates here |
|
||||||
|
| | reset_set_comb.sv | |
|
||||||
|
| | reverse_bytes.sv | reverses bytes order within multi-byte array |
|
||||||
|
| | reverse_dimensions.sv | |
|
||||||
|
| | reverse_vector.sv | reverses signal order within multi-bit bus |
|
||||||
|
| | round_robin_enc.sv | |
|
||||||
|
| | round_robin_performance_enc.sv | |
|
||||||
|
| | set_reset.sv | SR trigger variant w/o metastable state, reset dominates here |
|
||||||
|
| | set_reset_comb.sv | |
|
||||||
|
| | sim_clk_gen.sv | |
|
||||||
|
| :red_circle: | soft_latch.sv | |
|
||||||
|
| | spi_master.sv | universal spi master module |
|
||||||
|
| :red_circle: | true_dual_port_write_first_2_clock_ram.sv | |
|
||||||
|
| :red_circle: | true_single_port_write_first_ram.sv | |
|
||||||
|
| | uart_debug_printer.sv | |
|
||||||
|
| :green_circle: | uart_rx.sv | straightforward yet simple UART receiver |
|
||||||
|
| | uart_rx_shifter.sv | UART-like receiver shifter for simple synchronous messaging inside the FPGA or between FPGAs |
|
||||||
|
| :green_circle: | uart_tx.sv | straightforward yet simple UART transmitter |
|
||||||
|
| | uart_tx_shifter.sv | UART-like transmitter shifter for simple synchronous messaging inside the FPGA or between FPGAs |
|
||||||
|
|
||||||
|
Also added testbenches for selected modules.
|
||||||
|
|
||||||
Also added testbenches for selected modules
|
|
||||||
|
Loading…
x
Reference in New Issue
Block a user