A generic class library in SystemVerilog
HTML SystemVerilog JavaScript CSS Makefile TeX Other
Latest commit 782f0d5 Jan 1, 2016 @cluelogic Revision 0.6.1.
Permalink
Failed to load latest commit information.
api/framed_html Revision 0.6.1. Jan 1, 2016
dev Revision 0.6.1. Jan 1, 2016
run Release v0.2.0. Apr 18, 2014
src Revision 0.6.1. Jan 1, 2016
test Revision 0.6.0. Jan 1, 2016
.gitignore Release v0.3.0. Dec 6, 2015
README.md Revision 0.6.1. Jan 1, 2016
RELEASE.md Revision 0.6.1. Jan 1, 2016

README.md

ClueLib: A SystemVerilog generic library

ClueLib is a free, open-source generic library written in SystemVerilog. ClueLib is provided under MIT license and is available on GitHub for forking.

Revision

The latest revision is 0.6.1.

Documents

  • Online Documentation
  • Offline Documentation (same contents as the Online Documentation) is available at api/framed_html/index.html after installation.

You can try ClueLib without installing it!

How to install

Using Git

  1. git clone https://github.com/cluelogic/cluelib
  2. Go to the run directory: cd cluelib/run
  3. Check makefile options: make help
  4. Run a satity check. Use one of the simulators listed in the previous step: Do make vcs for example.
  5. If you see no errors, the library is in good shape. See the list of compatible simulators below.

In a traditional way

  1. Click the Download ZIP button on the right.
  2. Unzip the source code: unzip cluelib-master.zip
  3. Go to the run directory: cd cluelib-master/run
  4. Check makefile options: make help
  5. Run a satity check. Use one of the simulators listed in the previous step: Do make vcs for example.
  6. If you see no errors, the library is in good shape. See the list of compatible simulators below.

Compatible simulators

The library has been tested on the following simulators:

  • Incisive Enterprise Simulator (Version 12.20-s031) of Cadence Design Systems, Inc.
  • Questa Advanced Simulator (Version 10.2c) of Mentor Graphics Corporation
  • VCS (Version G-2012.09-SP1) of Synopsys, Inc.

How to use

Compile src/cl_pkg.sv (and optional src/cl_dpi.cc) with your files.

  • The src/cl_pkg.sv includes all library files. Make sure your +incdir option points to the src directory when you compile.
  • By default, DPI-C is disabled. If you want to use the DPI-C, uncomment the CL_USE_DPI_C macro in src/cl_define.svh and compile the src/cl_dpi.cc with the src/cl_pkg.sv.
  • Sample makefiles are available under the run directory.

Pull requests policy

Unlike other open-source projects, in which contributors use their own time and software, the verification libraries are usually developed using their employer’s resources. Typically, the copyright of such libraries belong to their employer. To avoid potential risks with lawsuits, we have decided not to accept any Pull Requests from individual contributors. This may not be the ideal eco-system, but the users can still make comments on the library and fork the library to extend it by themselves. Although we will not accept the source code in itself, we will accept a request for developing a new class or a function. Because the new function might immediately benefit other users, we will try to add it on a regular basis to make the library more useful.

Trademarks

  • Cadence is a registered trademark (#3474136) of Cadence Design Systems, Inc.
  • Incisive is a registered trademark (#2890264) of Cadence Design Systems, Inc.
  • Mentor is a registered trademark (#2388156) of Mentor Graphics Corporation.
  • Questa is a registered trademark (#3308638) of Mentor Graphics Corporation.
  • Synopsys is a registered trademark (#1618482) of Synopsys, Inc.
  • VCS is a registered trademark (#2777162) of Synopsys, Inc.