Skip to content

cartesi/machine-guest-tools

This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Folders and files

NameName
Last commit message
Last commit date
Sep 19, 2024
Sep 19, 2024
Sep 3, 2024
Aug 16, 2024
Dec 17, 2021
Mar 18, 2024
Jul 26, 2024
Aug 7, 2023
Sep 19, 2024
Mar 21, 2020
Mar 21, 2020
Jun 21, 2024
Aug 7, 2023
Sep 19, 2024
May 14, 2024
May 13, 2024
May 13, 2024
Apr 18, 2024

Repository files navigation

Cartesi Machine Emulator Tools

The Cartesi Machine Emulator Tools is a repository that contains a set of tools developed for the RISC-V Linux OS. It provides a RISC-V Debian package and a root filesystem for Ubuntu 22.04.

Getting Started

Users looking to create cartesi-machine applications can use the provided Debian package and root filesystem directly from one of the prepackaged releases, without needing to build this repository themselves.

Requirements

  • Docker >= 18.x
  • GNU Make >= 3.81
  • xgenext2fs >= 1.5.6

Docker buildx setup

To set up riscv64 buildx, use the following command:

$ make setup

Building

Invoking make will build all tools and create the machine-emulator-tools-$VERSION.deb Debian package along with the rootfs-tools-$VERSION.ext2 root filesystem artifacts.

$ make

Makefile targets

The following commands are available as make targets:

  • all: Build Debian package and rootfs (Default)
  • deb: Build machine-emulator-tools.deb package
  • fs: Build rootfs.ext2
  • setup: Setup riscv64 buildx
  • setup-required: Check if riscv64 buildx setup is required
  • help: List Makefile commands
  • env: Print useful Makefile variables as a KEY=VALUE list
  • clean: Remove the generated artifacts

Contributing

Thank you for your interest in Cartesi! Head over to our Contributing Guidelines for instructions on how to sign our Contributors Agreement and get started with Cartesi!

Please note we have a Code of Conduct, please follow it in all your interactions with the project.

License

The machine-emulator-tools repository and all contributions are licensed under APACHE 2.0. Please review our LICENSE file.