Created

Author: wsnyder

.gitignore

@@ -0,0 +1,41 @@
+# Compiled Object files
+*.slo
+*.lo
+*.o
+*.obj
+
+# Precompiled Headers
+*.gch
+*.pch
+
+# Compiled Dynamic libraries
+*.so
+*.dylib
+*.dll
+
+# Fortran module files
+*.mod
+
+# Compiled Static libraries
+*.lai
+*.la
+*.a
+*.lib
+
+# Verilator/simulator temporaries
+*.dmp
+*.log
+*.csrc
+*.vcd
+obj_*
+logs
+
+# Executables
+*.exe
+*.out
+*.app
+*.gcda
+*.gcov
+*.gcno
+*qmake_gcov
+*.pro.user

.travis.yml

@@ -0,0 +1,17 @@
+language: cpp
+dist: focal
+os: linux
+compiler: gcc
+#cache: ccache
+
+services:
+  - docker
+
+# This uses the latest version of Verilator, you may prefer :stable
+# We run make from inside the container, overriding default entry point (Verilator binary itself)
+# You may prefer to build install Verilator from git locally (slower but avoids docker)
+script: 
+  - docker run -ti -v ${PWD}:/work --user $(id -u):$(id -g) -e CCACHE_DIR=/work/.ccache --entrypoint make verilator/verilator:latest
+
+after_success: 
+  - bash <(curl -s https://codecov.io/bash)

Codecov.png

@@ -0,0 +1,107 @@
+######################################################################
+#
+# DESCRIPTION: Make Verilator model and run coverage
+#
+# This calls the object directory makefile.  That allows the objects to
+# be placed in the "current directory" which simplifies the Makefile.
+#
+# This file is placed under the Creative Commons Public Domain, for
+# any use, without warranty, 2020 by Wilson Snyder.
+# SPDX-License-Identifier: CC0-1.0
+#
+######################################################################
+
+ifneq ($(words $(CURDIR)),1)
+ $(error Unsupported: GNU Make cannot build in directories containing spaces, build elsewhere: '$(CURDIR)')
+endif
+
+# This example started with the Verilator example files.
+# Please see those examples for commented sources, here:
+# https://github.com/verilator/verilator/tree/master/examples
+
+######################################################################
+# Set up variables
+
+# If $VERILATOR_ROOT isn't in the environment, we assume it is part of a
+# package install, and verilator is in your path. Otherwise find the
+# binary relative to $VERILATOR_ROOT (such as when inside the git sources).
+ifeq ($(VERILATOR_ROOT),)
+VERILATOR = verilator
+VERILATOR_COVERAGE = verilator_coverage
+else
+export VERILATOR_ROOT
+VERILATOR = $(VERILATOR_ROOT)/bin/verilator
+VERILATOR_COVERAGE = $(VERILATOR_ROOT)/bin/verilator_coverage
+endif
+
+VERILATOR_FLAGS =
+# Generate C++ in executable form
+VERILATOR_FLAGS += -cc --exe
+# Generate makefile dependencies (not shown as complicates the Makefile)
+#VERILATOR_FLAGS += -MMD
+# Optimize
+VERILATOR_FLAGS += -Os -x-assign 0
+# Warn abount lint issues; may not want this on less solid designs
+VERILATOR_FLAGS += -Wall
+# Make waveforms
+#VERILATOR_FLAGS += --trace
+# Check SystemVerilog assertions
+VERILATOR_FLAGS += --assert
+# Generate coverage analysis
+VERILATOR_FLAGS += --coverage
+# Run make to compile model, with as many CPUs as are free
+VERILATOR_FLAGS += --build -j
+# Run Verilator in debug mode
+#VERILATOR_FLAGS += --debug
+# Add this trace to get a backtrace in gdb
+#VERILATOR_FLAGS += --gdbbt
+
+# Input files for Verilator
+VERILATOR_INPUT = -f input.vc top.v sim_main.cpp
+
+######################################################################
+
+# Create annotated source
+VERILATOR_COV_FLAGS += --annotate logs/annotated
+# A single coverage hit is considered good enough
+VERILATOR_COV_FLAGS += --annotate-min 1
+# Create LCOV info
+VERILATOR_COV_FLAGS += --write-info logs/coverage.info
+# Input file from Verilator
+VERILATOR_COV_FLAGS += logs/coverage.dat
+
+######################################################################
+default: run
+
+run:
+	@echo
+	@echo "-- Verilator coverage example"
+
+	@echo
+	@echo "-- VERILATE ----------------"
+	$(VERILATOR) $(VERILATOR_FLAGS) $(VERILATOR_INPUT)
+
+	@echo
+	@echo "-- RUN ---------------------"
+	@rm -rf logs
+	@mkdir -p logs
+	obj_dir/Vtop
+
+	@echo
+	@echo "-- COVERAGE ----------------"
+	@rm -rf logs/annotated
+	$(VERILATOR_COVERAGE) $(VERILATOR_COV_FLAGS)
+
+	@echo
+	@echo "-- DONE --------------------"
+
+
+######################################################################
+# Other targets
+
+show-config:
+	$(VERILATOR) -V
+
+maintainer-copy::
+clean mostlyclean distclean maintainer-clean::
+	-rm -rf obj_dir logs *.log *.dmp *.vpd core

LICENSE

@@ -0,0 +1,21 @@
+# travis_verilator_gcov
+
+[![Travis CI logo](TravisCI.png)](https://travis-ci.org)
+![Whitespace](Whitespace.png)
+[![Codecov logo](Codecov.png)](https://www.codecov.io)
+![Whitespace](Whitespace.png)
+[![Verilator logo](verilator_56x48-min.png)](https://verilator.org)
+
+[![Build Status](https://travis-ci.org/verilator/example-systemverilog.svg?branch=master)](https://travis-ci.org/verilator/example-systemverilog)
+[![codecov.io](https://codecov.io/github/verilator/example-systemverilog/coverage.svg?branch=master)](https://codecov.io/github/verilator/example-systemverilog?branch=master)
+
+This GitHub is part of [the SystemVerilog Verilator Codecov Tutorial](https://github.com/verilator/example-systemverilog).
+
+The goal of this project is to demonstrate a SystemVerilog project with:
+ * Verilator
+ * C++ compiler: `g++`
+ * Travis-CI running Docker
+ * Code coverage with `verilator_coverage` (note: it should show the code coverage is below 100%)
+ * Code coverage published in CodeCov.
+
+We are happy to help if you have any questions. Please contact email our Support at [[email protected]](mailto:[email protected])

Makefile

@@ -0,0 +1,3 @@
+#!/bin/bash
+qmake travis_qmake_gcc_cpp11_gcov.pro
+make

README.md

@@ -0,0 +1,2 @@
+// This file typically lists flags required by a large project, e.g. include directories
++libext+.v+.sv+.vh+.svh -y .