/chimera

A tool for synthesizing Verilog programs

Primary LanguageVerilogGNU General Public License v3.0GPL-3.0

jotai drawing

Goals

ChiBench consists of a large collection of Verilog programs mined from open-source github repositories. The goal of this benchmark suite is to test and debug electronic design automation (EDA) tools, such as the Jasper Formal Verification Platform or Intel Quartus. To test your EDA tool, simply pass all the programs in the ChiBench collection to it, and see if it crashes. Below we list examples of issues reported in this way:

Issue Tool Description
2159 Verible's Obfuscator Crashes when reading a program that only contains the pragma directive.
2181 Verible's parser Crashes instead of reporting syntax errors related to instantiation type.
2189 Verible's code formater Crashes with syntactically valid input.
2233 Verible's parser Incorrectly accepts Verilog code with mismatched program and endmodule keywords.
5276 Verilator Crashes with signal 9 on a very large program.
5311 Verilator Crashes when using time assignments.
5312 Verilator Crashes when calling a function created in "generate" block.
1174 Icarus Verilog Crashes when assigning to parameters in a procedural block.
4598 Yosys Crashes while simplifying program.

If you ever use ChiBench to find bugs in some EDA tool, we would appreciate it very much if you could reach out to us and report your experience. If you need help to set up the scripts to do this kind of exploration, feel free to reach out to us as well!

Technical Report

The process of constructing and curating this collection of benchmarks is described on this technical report. Cite it as:

@misc{Sumitani24,
  title={ChiBench: a Benchmark Suite for Testing Electronic Design Automation Tools}, 
  author={Rafael Sumitani and João Victor Amorim and Augusto Mafra and Mirlaine Crepalde and Fernando Magno Quintão Pereira},
  year={2024},
  eprint={2406.06550},
  archivePrefix={arXiv},
  primaryClass={cs.AR}
}

Provenance

ChiBench contains only programs that were originally distributed with some license. Thus, each program in the ChiBench suite contains, as a header comment, the original license of that specification, plus a link to the repository from where that code was obtained. Notice that these programs might use different licenses, given that they were extracted from different projects. On May 24th, 2024, the following licenses were used among the repositories mined to build the ChiBench collection:

License #
Apache License 2.0 341
MIT License 331
GNU General Public License v3.0 159
GNU General Public License v2.0 37
BSD 3-Clause "New" or "Revised" License 37
BSD 2-Clause "Simplified" License 27
GNU Lesser General Public License v2.1 10
Creative Commons Zero v1.0 Universal 9
The Unlicense 7
GNU Lesser General Public License v3.0 5
Mozilla Public License 2.0 5
ISC License 5
Creative Commons Attribution Share Alike 4.0 International 4
CERN Open Hardware Licence Version 2 - Permissive 3
GNU Affero General Public License v3.0 3
Creative Commons Attribution 4.0 International 2
CERN Open Hardware Licence Version 2 - Strongly Reciprocal 1
CERN Open Hardware Licence Version 2 - Weakly Reciprocal 1

Acknowledgment

This project is sponsored by Cadence Design Systems. Additionally, the different people involved in this project acknowledge the support of CNPq, FAPEMIG, and CAPES. Finally, thank UFMG's Department of Computer Science for making available the infrastructure necessary to carry out this project.