/GSoC-21-Project-Report

Final report for Google Summer of Code 2021 project 'Porting BaseJump STL to FuseSoC' under FOSSi Foundation.

GSoC'21: Final Report

   

Project: Porting BaseJump STL to FuseSoC

Organisation: The Free and Open Source Silicon Foundation (FOSSi)

Mentors: Dan Petrisko, Prof. Michael B. Taylor and Olof Kindgren

Abstract

BaseJump STL is to the hardware world as C++ STL is to the software world. It is a comprehensive hardware library for SystemVerilog that seeks to contain all the commonly used hardware primitives. FuseSoC is a package manager and set of build tools for reusable hardware building blocks facilitating the sharing of designs between projects and reusing open IP cores.

The objective of my project is to port BaseJump STL to FuseSoC so that new projects can directly reuse these hand-optimized IP cores rather than starting from scratch. BaseJump STL has the hardware primitives defined in the form of SystemVerilog modules. FuseSoC makes use of core files that reference the provider, file sets and default targets allowing for the reuse of IP cores in the process of creating, building and simulating SoC solutions. FuseSoC allows for easier tracking and downloading of dependencies as well as versioning using VLNV tags making it much more convenient to work with large cores as well as keep track of changes to these cores. This project will involve porting all the modules as well as the testing infrastructure in BaseJump STL to work with FuseSoC.

Objectives

  1. Create core files for all BaseJump STL modules
  2. Add lint targets for all cores
  3. Port testbenches to work with verilator
  4. Add verilator testbench targets for cores with testbenches
  5. Create FuseSoC generator for generated cores like bsg_round_robin_arb

Results

All the proposed objectives have been completed and additional work has been done in order to better the project.

Objectives Completed

From the proposed objectives the following have been completed:

1. Core files have been created for all the BaseJump STL modules

Status: Complete. The cores have been tested for missing files and dependancies.

2. Lint targets have been added and tested

  • Lint targets were added to all the previously created core files and tested.
  • Necessary debugging was done on the original modules and warning ignore tags added for those that were not problematic.
  • Repository - adithyasunil26/basejump_stl_cores

Status: Complete. The core files have been tested for the lint targets.

3. All existing and compatible testbenches were modified to work with verilator

Status: Complete. The PR has been merged.

4. Verilator testbenches have been added to the cores

Status: Complete. The PR has been merged.

5. FuseSoC generator created for bsg_round_robin_arb

  • FuseSoC generator script and core file created for bsg_round_robin_arb generator.
  • This will allow users to generate bsg_round_robin_arb cores as per their channel requirments directly through FuseSoC.
  • Repository - adithyasunil26/basejump_stl_generators

Status: Complete. The generator has been tested.

The following are additional objectives which were not part of the initial proposal that have been completed:

6. FuseSoC generator created for bsg_fakeram

Status: Complete. The generator has been tested both individually and as a dependancy in adithyasunil26/basejump_stl_alu.

7. ALU module created as a proof of concept

  • Created an ALU core using cores from the BaseJump cores and the bsg_fakeram generator as a proof of concept of this project and tested successfully.
  • Repository - adithyasunil26/basejump_stl_alu

Status: Complete. The cores have been tested.

8. Empty testbenches have been added for modules without testbenches

Status: Complete. Reviewed but pending merge.

9. Yosys targets have been added to all cores

Status: Complete. Pending testing, review and merge.

10. Python 3 compatibility for bsg_round_robin_arb generator

Status: Complete. Reviewed but pending merge.

Ongoing Work

1. Code coverage measurments for BaseJump STL modules

  • Verilator has built in code coverage analysis.
  • Currently working on setting up a script to generate code coverage reports.

Status: In Progress.

2. Porting BlackParrot to FuseSoC

  • With the BaseJump STL cores ready it is now possible to start work on porting BlackParrot to FuseSoC.
  • Curretnly working on setting up the filesets and lint targets.

Status: In Progress.

Future Plans

I will continue to work with the organisation to improve the project and add more features and here are some things I have in mind for the future:

  1. Establish a CI\CD pipeline for BaseJump STL
  2. Complete porting Blackparrot to FuseSoC
  3. Add FuseSoC targets for industrial tools like VCS to the BaseJump STL cores.
  4. Explore the possibility of adding open-source FPGA and ASIC flows

More details

You can find more information about the project on my blog post here. You can find more about the weekly progress of the project on my weekly blogs here.

Acknowlegements

I would like to thank my mentors Dan Petrisko, Prof. Michael B. Taylor and Olof Kindgren for all their guidance and support. Without them this project would not have progressed as far as it has now. They have always been providing valuable feedbacks and suggestions based on which I shaped my work.

I am also grateful to The Free and Open Source Silicon Foundation (FOSSi) community members for their support throughtout the project. I also thank Google for giving me this opportunity to work on this project through the Google Summer of Code program.