Skip to main content

Award-winnning package manager and build abstraction tool for HDL code

Project description

FuseSoC

CI status image

Introduction

FuseSoC is an award-winning package manager and a set of build tools for HDL (Hardware Description Language) code.

Its main purpose is to increase reuse of IP (Intellectual Property) cores and be an aid for creating, building and simulating SoC solutions.

FuseSoC makes it easier to

  • reuse existing cores
  • create compile-time or run-time configurations
  • run regression tests against multiple simulators
  • port designs to new targets
  • let other projects use your code
  • set up continuous integration

To learn more about FuseSoC head over to the User Guide.

Getting started

Installing the latest release

FuseSoC works on Linux, Windows, and macOS. It is written in Python and can be installed like any other Python package through "pip". Please refer to the full list of system requirements and installation instructions in the Installation section in the User Guide.

Quick start

To check if FuseSoC is working, and to get an initial feeling for how FuseSoC works, you can try to simulate a simple hardware design from our core library.

First, create and enter an empty workspace

mkdir workspace
cd workspace

Install the FuseSoc base library into the workspace

fusesoc library add fusesoc-cores https://github.com/fusesoc/fusesoc-cores

Get a list of cores found in the workspace

fusesoc core list

If you have any of the supported simulators installed, you can try to run a simulation on one of the cores as well. For example, fusesoc run --target=sim i2c will run a regression test on the core i2c with Icarus Verilog. If you want to try another simulator instead, add e.g. --tool=modelsim or --tool=xcelium between run and i2c.

fusesoc --help will give you more information on commands and switches.

Did it work? Great! FuseSoC can be used to create FPGA images, perform linting, manage your IP libraries or do formal verification as well. Check out the online documentation to learn more about creating your own core files and using existing ones. If it didn't work, please get in touch (see below).

Next steps

A good way to get your first hands-on experience with FuseSoC is to contribute to the LED to Believe project. This project aims to used FuseSoC to blink a LED on every available FPGA development board in existence. There are already around 40 different boards supported. If your board is already supported, great, then you can run your first FuseSoC-based design. If it's not supported, great, you now have the chance to add it to the list of supported boards. Either way, head over to LED to Believe to learn more and see how to go from a blinking LED to running a RISC-V core on an FPGA.

Need help?

FuseSoC comes with extensive online documentation.

For quick communication with the active developers, feel free to join us at the FuseSoC chat.

If you have found an issue, or want to know more about currently known problems, check out the issue tracker on GitHub.

If you are looking for professional paid support, we are happy to provide feature additions, bug fixes, user training, setting up core libraries, migrating existing designs to FuseSoC and other things. Please contact olof.kindgren@gmail.com for more information.

Contributing to FuseSoC

FuseSoC is developed by an active and friendly community, and you're welcome to join! You can read more about setting up a development environment in our Developer's Guide.

You can file bug reports and propose changes in the olofk/fusesoc repository on GitHub.

Further reading

License

FuseSoC is licensed under the permissive 2-clause BSD license, freely allowing use, modification, and distribution of FuseSoC for all kinds of projects. Please refer to the LICENSE file for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fusesoc-2.4.3.tar.gz (179.7 kB view details)

Uploaded Source

Built Distribution

fusesoc-2.4.3-py3-none-any.whl (60.9 kB view details)

Uploaded Python 3

File details

Details for the file fusesoc-2.4.3.tar.gz.

File metadata

  • Download URL: fusesoc-2.4.3.tar.gz
  • Upload date:
  • Size: 179.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.3

File hashes

Hashes for fusesoc-2.4.3.tar.gz
Algorithm Hash digest
SHA256 fc25b06cb52f516cd00c6d04c9f638205e46f3e35e840fc3f8ec00bb3a6405d5
MD5 5246d8d2e9620cf587d543ef3e2eb810
BLAKE2b-256 b4c632532ef324c628f41628070dfb4b63c4cbb7a28b0ad72c618d79bcaba952

See more details on using hashes here.

File details

Details for the file fusesoc-2.4.3-py3-none-any.whl.

File metadata

  • Download URL: fusesoc-2.4.3-py3-none-any.whl
  • Upload date:
  • Size: 60.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.3

File hashes

Hashes for fusesoc-2.4.3-py3-none-any.whl
Algorithm Hash digest
SHA256 9ab4a82a5b7d4decbeb8f76049673a1b0806732ab8f807fee285bbc0452b3dc3
MD5 4fb7cb7b8a3bd7756efa0faca132b02e
BLAKE2b-256 cba810f62458dda2ca07c49477448e643b10f30825b7741fdb6ec3e6188b6999

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page