Skip to content

Commit

Permalink
[Skip CI] Extending RESOURCES.md document (#2629)
Browse files Browse the repository at this point in the history
Adding more references from PULP and Zero Day Labs.
Fixing a few typos.
Unified the layout.
  • Loading branch information
jquevremont authored Jan 10, 2025
1 parent db568f3 commit a12d511
Showing 1 changed file with 55 additions and 20 deletions.
75 changes: 55 additions & 20 deletions RESOURCES.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,59 +11,94 @@ Please help improve this page, by filing an [issue](https://github.com/openhwgro
> [!WARNING]
> The CVA6 team is not liable for the other repositories.
> Assess their content and make sure they fit your needs and are mature enough for design.
> Assess their content and make sure they fit your needs and are mature enough for your design.
> Plese direct your issues or pull requests to these external repositories.
## Our legacy

CVA6 was designed by the [PULP Platform team](https://www.pulp-platform.org/). You can integrate it with many other PULP designs from [github.com/pulp-platform](https://github.com/pulp-platform).
CVA6 was designed by the **[PULP Platform team](https://www.pulp-platform.org/)**. You can integrate it with many other PULP designs from [github.com/pulp-platform](https://github.com/pulp-platform).

## Technical resources

### SW Tools and OSes

RISC-V tools for CVA6 and Buildroot Linux support are available [here](https://github.com/openhwgroup/cva6-sdk).
**RISC-V tools** for CVA6 and **Buildroot Linux** support are available [here](https://github.com/openhwgroup/cva6-sdk).

Yocto Linux support for CVA6 is available [here](https://github.com/openhwgroup/meta-cva6-yocto).
**Yocto Linux** support for CVA6 is available [here](https://github.com/openhwgroup/meta-cva6-yocto).

FreeRTOS support for CVA6 is available [here](https://github.com/FreeRTOS/FreeRTOS-Partner-Supported-Demos/tree/main/RISC-V_cva6).
**FreeRTOS** support for CVA6 is available [here](https://github.com/FreeRTOS/FreeRTOS-Partner-Supported-Demos/tree/main/RISC-V_cva6).

Zephyr support for CV64A6 will soon be available.
**Zephyr** support for CV64A6 will soon be available.

This [tutorial](https://github.com/ThalesGroup/cva6-eclipse-demo) offers resources to debug CVA6 under Eclipse IDE.
**Bao** ([repository](https://github.com/bao-project/bao-hypervisor), [documentation](https://github.com/bao-project/bao-docs)) is an embedded hypervisor targetting strong isolation and real-time guarantees, leveraging CV64A6 optional hypervisor support.

The OS ports below are on Digilent Genesys 2 board.
**seL4**, secure, formally verified microkernel supports CVA6 (still by its old ARIANE name) [here](https://docs.sel4.systems/Hardware/ariane.html).

This [tutorial](https://github.com/ThalesGroup/cva6-eclipse-demo) offers resources to debug CVA6 under **Eclipse IDE**.

The OS ports above are usually on Digilent Genesys 2 board.

### Related building blocks

These building blocks fit very nicely with CVA6:

- [OpenPiton](https://github.com/PrincetonUniversity/openpiton) is a many-core framework that supports CVA6.
- [Culsans/CV-TCCC](https://github.com/pulp-platform/culsans) is a multi-core infrastructure for a few CVA6 cores.
- [ARA/CV-VEC](https://github.com/pulp-platform/ara) is a vector unit for CVA6.
- [HPDcache](https://github.com/openhwgroup/cv-hpdcache) is a flexible (highly configurable) and high-throughput L1 cache.
**[OpenPiton](https://github.com/PrincetonUniversity/openpiton)** is a many-core framework that supports CVA6.

**[Culsans/CV-TCCC](https://github.com/pulp-platform/culsans)** is a multi-core infrastructure for a few CVA6 cores.

**[ARA/CV-VEC](https://github.com/pulp-platform/ara)** is a vector unit for CVA6.

**[HPDcache](https://github.com/openhwgroup/cv-hpdcache)** is a flexible (highly configurable) and high-throughput L1 cache.

**[IOMMU](https://github.com/zero-day-labs/riscv-iommu)** supports the RISC-V Input/Output Memory Management Unit (IOMMU) Specification, including the hypervisor privilege.

**[IOPMP](https://github.com/zero-day-labs/riscv-iopmp)** supports the RISC-V Input/Output Physical Memory Protection (IOPMP) Specification.

**[AIA](https://github.com/zero-day-labs/riscv-aia)** supports the RISC-V Advanced Interrupt Architecture (AIA) specification.

### Design examples (FPGA)

The CVA6 repository contains the CVA6 core and a basic CPU design, the "APU" and its implementation on a Digilent Genesys 2 FPGA board. Here is a list of other CVA6-based FPGA designs:

The [technical kits](https://github.com/thalesgroup/cva6-softcore-contest) of a student contest organized in France can be used as educational resources or as an easy way to get CVA6 up and running with a cheaper Digilent Zybo Z7-20 board. You will find in it:
The [technical kits](https://github.com/thalesgroup/cva6-softcore-contest) of a **student contest** organized in France can be used as educational resources or as an easy way to get CVA6 up and running with a cheaper Digilent Zybo Z7-20 board. You will find in it:
- The 2020-2021 contest, focusing on PPA optimization;
- The 2021-2022 contest, focusing on energy optimization;
- The 2022-2023 contest, focusing on cybersecurity, including a port of Zephyr OS;
- The 2023-2024 contest, focusing on the acceleration of the MNIST digit recognition with custom extensions;
- The 2024-2025 contest, focusing on the frequency increase (_not released yet_);
- The 2024-2025 contest, focusing on the frequency increase;
- A treat with the support of Linux and a VGA output.

[CVA6 with Xilinx Ethernet](https://github.com/cispa/CVA6-Vivado-Project-with-Xilinx-AXI-Ethernet/) is an alternative design which implements Xilinx 1G/2.5G Ethernet Subsystem on the Digilent Genesys 2 FPGA board. It has been tested with TFTP boot in u-boot and SSH in Linux.
**[CVA6 with Xilinx Ethernet](https://github.com/cispa/CVA6-Vivado-Project-with-Xilinx-AXI-Ethernet/)** is an alternative design which implements Xilinx 1G/2.5G Ethernet Subsystem on the Digilent Genesys 2 FPGA board. It has been tested with TFTP boot in u-boot and SSH in Linux.

### Platforms, subsystems and systems

These are large subsystems and systems that are more complex than the "APU". They can be a starting point for your design:

**Cheshire** ([repository](https://github.com/pulp-platform/cheshire), [documentation](https://pulp-platform.github.io/cheshire/))
is a light-weight, open-source (including peripherals), linux-capable RISC-V system built around CVA6.
It can be integrated as Linux-capable host in larger, heterogeneous systems.

**Carfield** ([repository](https://github.com/pulp-platform/carfield), [documentation](https://pulp-platform.github.io/carfield/))
is a mixed-criticality platform targeting automotive applications with several safety, security,
and predictability features built around Cheshire and CVA6.

**AlSaqr** ([repository](https://github.com/AlSaqr-platform/he-soc/tree/master))
is as secure system for Nano-UAV navigation based on CVA6 and Culsans.

### Designs (ASIC) and chiplets

### Designs (ASIC)
Here are open-source ASIC designs based on CVA6, that have been prototyped on silicon:

Here are open-source ASIC designs based on CVA6:
**[Polara APU](https://github.com/openhwgroup/core-v-polara-apu)**
is a 4-core processor made with OpenPiton, ARA and CVA6.

[Polara APU](https://github.com/openhwgroup/core-v-polara-apu) is a 4-core processor made with OpenPiton, ARA and CVA6.
**[Basilisk](https://github.com/pulp-platform/cheshire-ihp130-o)**
is an end-to-end open-source, Linux-capable chip based on Cheshire, CVA6, Yosys and OpenRoad.

To be completed
**Occamy** ([repository](https://github.com/pulp-platform/occamy),
[article](https://pulp-platform.org/occamy/),
[paper](https://doi.org/10.1109/VLSITechnologyandCir46783.2024.10631529))
is a 432-core, 2.5D chiplet RISC-V system with CVA6 as manager core.

## Business resources

Expand All @@ -88,7 +123,7 @@ and verification efforts within the OpenHW ecosystem. Our work on CVA6 includes
and implementation of multiple RISC-V extensions, such as Bitmanip, Zicond, Zcb, and Zcmp. Our expert team assists companies in integrating,
customizing, and optimizing CVA6 to meet their unique requirements.

_(To be completed based on companies's requests. Max 1 URL and 60 words per company)_
_(To be completed based on companies's requests. Max 1 URL and 70 words per company)_

### Product ICs

Expand Down

0 comments on commit a12d511

Please sign in to comment.