Awesome

HDLGen from Wilson Chen 2022

Overview

HDLGen is a tool for HDL(mainly for Verilog) generation, it enables embedded Perl or Python scripts in Verilog source code, and support Perl style variable anyway, to generate desired HDL in an easy and efficient way. It supports all syntax and data structure of Perl or Python, and has a few predefined functions for signal define, module instance, port connection etc.
This tool also supports extended API functions in Perl style, for any function or module that you want or have from previous knowledge or project.
HDL and script mixed design file can be any name, while final generated RTL file will be Verilog only( as .v).

License

                     Copyright 2022~2023 Wilson Chen                                                     
        Licensed under the Apache License, Version 2.0 (the "License");                            
        You may not use this file except in compliance with the License.                          
        You may obtain a copy of the License at                                                  
                http://www.apache.org/licenses/LICENSE-2.0                                      
        Unless required by applicable law or agreed to in writing, software                    
        distributed under the License is distributed on an "AS IS" BASIS,                     
        WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.             
        See the License for the specific language governing permissions and                 
        limitations under the License.

any feedback, suggestion, requirement, solution, contribution, is always welcome

What you can do with HDLGen

RTL stitch

Instance module from RTL or IPXACT file as what Verilog does
Connect module's port to wires with native regular express
Automatically generate instance's wires definitions
Automatically generate reg or wire definictions(not perfect but really helpful)
Warning out any Instance signals which has no connection
Use embedded native Perl or Python to generate(print) whatever code you want

Interface manipulate

Add interface from IPXACT, JSON, RTL, SV code, or hash array
Add port to interface by name
Remove port from interface by name
Print or show interface signals for design or debug

IPXACT manipulate

Read in IPXACT and add all interfaces
Show all interfaces defined in IPXACT ( for debug )
Export interface to IPXACT by name ( in development )
Export port to IPXACT by name ( in development )
Export standard IPXACT for current top module ( in development )

Function generation

Use embedded functions to generate differnt module or loigc you want
- Clk, Reset, Fuse, Pmu, Fifo, Async-interface, Memories etc ( flow done, can custom design )
Extend your own module/logic by standard config ( in development )
- config can be in Verilog, JSON, YAML, EXCEL etc.
- then generate these logic with parameters by just a simple function call

Based on above functions, this tool can generate a SOC in an easy and flexible way

What you cannot do with HDLGen

Detail logic design: you still need to write RTL to implement your ideas
Synthesis or simulation or verification: you need to use other EDA tools to handle

Directory Structure

├── HDLGen.bin                # Tool binary for easy adopt
├── HDLGen.pl                 # Tool source code
├── plugins                   # Tool plugin funcitons in Perl module
    ├── Design_Template         # custom module design template files
├── test                      # Source design code for testing
    ├── cfg                     # JSON and XML for config
    ├── incr                    # necessary design files
├── doc                       # usage introduction

Usage

first you need to set shell ENV of HDLGEN_ROOT, otherwise tool will report error. plese refer to setenv.sh then run command as simple as: cd test ../HDLGen.pl -i NV_NVDLA_CMAC_CORE_mac.src or ../HDLGen.bin -i NV_NVDLA_CMAC_CORE_mac.src or ../HDLGen.pl -f ./src.list for help message you can run: HDLGen.pl -usage

NOTE:

Verilog-mode for EMACS or VIM is very powerful to do AUTO Port,Reg/Wire, and Instance, but it has some limitations or inconvenient things: --- mostly used in GUI mode but no batch mode -- seems NOT TURE --- Instance port/wire name change is manual hard mapping but no Regular Express --- NOT TRUE, RE is supproted but need 3rd file --- No Warning for unconnected instance signals --- No Interface a/o IPXACT support --- No embedded Perl/Python support --- no function generation for inhouse/customer design
this tool only test on Ubuntu 18.04.05 & 20.04.5 with Perl-5.34, but should work on any system have Perl5 installed
Python script only support python3 but no python2.x (one more reason for why not Python ;-) )
several Perl Modules are required, can refer to the package head in source code, here listed: Getopt JSON Text::Template File::Basename File::Find Verilog::Netlist XML::Simple XML::SAX::Expat; #this is strange as not used at all, but pp need it Dumper Text::ParseWords Term::ANSIColor

Suggestion: You can first run HDLGen.pl, then install any package according to the error message, or just run HDLGen.bin for results

Why need this tool?

For any ASIC or SOC engineer with over 10 years experience, we may hate Verilog sometime, as Verilog HDL's syntax is TOO simple or TOO basic, it's Register Transfer Level description, we're not writing code, we're indeed designing circuit, it's very cool, but sometime we will be bored, especially when instancing module, do wire connections. So we learned and tried different ways, we may study and learn Chisel, SpinalHDL, MyHDL PyHDL, or PyGear recently. But, when we learned, tried, finally we gave up, because they're DSL, they're not HDL! DSL is totally new language, DSL is more like a high level software language, we have to write code in a new style, no Verilog or HDL at all. Is it safe for a project to abandon Verilog HDL? Is it safe for an experienced engineer to abandon previous skills and design logic with non-HDL code? Is it easy or friendly to learn a new language? Is that language widely used or accepted and will evolve in long term? Is there any different way to help us? Yes, we have a different way! And it is easy to use, smoothly to move, seamlessly to adopt. The tool is going to support you keep writing HDL while give the ability to improve your efficiency, and with ZERO learning curve, is here, named as "HDLGen". The way you're going to work is writing Verilog or VHDL code, the tool helps you on most boring tasks: signal define for wire a/o reg, instance modules by connections with auto wire signals defined and easy name change, connect signals with regular expression, instance JSON and IPXACT xml file as simple as HDL code natively. If any task/logic/design which is not friendly written in HDL, then you can use high level script language like Perl or Python for any code or task you want, wherever and whenever in the HDL source file, as long as you know Perl or Python script, or even shell script. This tool supports standard AMBA bus interfaces natively. This tool also support you to manually define an interface, through SystemVerilog, Verilog, IPXACT or XML, JSON, or Hash array. If there is any inhouse developed or accumulated design which is common for your designs, you can put as a template in this tool, then instance with any parameters you want by just as simple as one function call in HDL.

*** DSL is really cool *** *** But Verilog is still the King *** *** Connection is what you need *** *** And Fexibility is really helpful ***

Thanks

Thanks NVIDIA for giving me the chance to know how Perl is powerful to run big ASIC factory, Thanks NVIDIA's VIVA to let me know how Perl makes Verilog intersting and amazing. Thanks NVIDIA's open sourced NVDLA as a test source.

Note:

This tool was developed from scratch during the special spring time in Shanghai in 2022 The things related to NVIDIA are:

several functions' name are identical;
several HDL files of open sourced NVDLA are used to be test source

Please kindly let me know if there is any license issue