From 69554ce36341311a61554eee3364314b303c1c90 Mon Sep 17 00:00:00 2001 From: jorgeloopzz Date: Sat, 23 May 2026 01:58:44 +0100 Subject: [PATCH 1/4] [cheshire] Cheshire and Ara's dependencies --- cheshire/requirements.txt | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 cheshire/requirements.txt diff --git a/cheshire/requirements.txt b/cheshire/requirements.txt new file mode 100644 index 000000000..68a982494 --- /dev/null +++ b/cheshire/requirements.txt @@ -0,0 +1,28 @@ +# University Institute of Applied Microelectronics +# https://www.iuma.ulpgc.es/ +# Author: Jorge López Viera +# This file includes the Python's dependencies for +# both the Cheshire and Ara + +requests +hjson +mako +pyyaml +tabulate +yapf +mkdocs +mkdocs-material +markdown-grid-tables +tclint==0.4.2 +flatdict>=4.1.0 +setuptools<81 +peakrdl>=1.5.0 +peakrdl-rawheader>=0.2.3 +dataclasses +gitpython +jsonref +jsonschema +yamlfmt +numpy +matplotlib +scikit-learn From a07bab0a6553c6473c58d49e7e6c9edaece960f4 Mon Sep 17 00:00:00 2001 From: jorgeloopzz Date: Sat, 23 May 2026 02:02:15 +0100 Subject: [PATCH 2/4] [cheshire] Add dependencies specifications for Ara and Cheshire --- cheshire/README.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/cheshire/README.md b/cheshire/README.md index 653310f28..1318f33ec 100644 --- a/cheshire/README.md +++ b/cheshire/README.md @@ -4,6 +4,27 @@ Ara can be synthesized on a VCU128 FPGA and boot Linux through the Cheshire SoC. Our entry point is to generate a custom `add_sources.vcu128.tcl` file with specific Ara targets, copy this file into the Cheshire directory, and then use the default Cheshire compile flow, which will use our provided TCL file +## Requirements +From Cheshire's [web documentation](https://pulp-platform.github.io/cheshire/gs/#dependencies), ensure you have the next dependencies: + +- GNU make >= 3.82 +- CMake >= 3.24.0 +- Python >= 3.11 +- Bender >= 0.27.1 +- RISCV GCC >= 11.2.0 + +> [!TIP] +> Check [Bender](https://github.com/pulp-platform/bender) repository to install it + +For Python dependencies, it is highly recommended to create a virtual environment and install all packages listed in `requirements.txt` + +```bash +python3 -m venv .venv +source .venv/bin/activate + +pip install -r requirements.txt +``` + ## How to Use Ara should be instantiated as a submodule of Cheshire. This means that the Ara repo should be downloaded through `bender checkout` from the Cheshire directory. Then, Ara's path can be retrived using `bender path ara`. From ffc8f7c5112b8abb8ec857c5c1cf1d1a5a0bd861 Mon Sep 17 00:00:00 2001 From: jorgeloopzz Date: Sat, 23 May 2026 02:06:57 +0100 Subject: [PATCH 3/4] [cheshire] Specify which branch to clone to get the Ara --- cheshire/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/cheshire/README.md b/cheshire/README.md index 1318f33ec..7a76c5b75 100644 --- a/cheshire/README.md +++ b/cheshire/README.md @@ -27,10 +27,10 @@ pip install -r requirements.txt ## How to Use -Ara should be instantiated as a submodule of Cheshire. This means that the Ara repo should be downloaded through `bender checkout` from the Cheshire directory. Then, Ara's path can be retrived using `bender path ara`. +Ara should be instantiated as a submodule of Cheshire. This means that the Ara repo should be downloaded through `bender checkout` from the Cheshire directory, more specifically, the `mp/ara-pulp-v2` branch, which includes the CVA6 connected to the Ara. Then, Ara's path can be retrived using `bender path ara`. ```bash -git clone git@github.com:pulp-platform/cheshire.git +git clone --branch=mp/ara-pulp-v2 https://github.com/pulp-platform/cheshire.git cd cheshire git checkout ${COMMIT} bender checkout From 876f8818643f16fcba1941ba61c1943458f3ca47 Mon Sep 17 00:00:00 2001 From: jorgeloopzz Date: Sat, 23 May 2026 02:09:19 +0100 Subject: [PATCH 4/4] [CHANGELOG] Update Changelog --- CHANGELOG.md | 1 + 1 file changed, 1 insertion(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 542eb153d..24cabe393 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -132,6 +132,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0. - Switch to a better buildroot mirror - CI frees up space in the runner before building a toolchain - Update documentation + - Enhance Cheshire's documentation for better workflow integration with Ara ## 3.0.0 - 2023-09-08