A nix-shell for developing with Rust on Xtensa+RISCV ESP32 targets
  • Nix 74.1%
  • Just 12.2%
  • Shell 9.2%
  • Rust 4.5%
Find a file
Leigh Oliver c7dd278fd8
Updated README.md
Split the versions table into sub-tables, to make editing them easier.
2026-02-20 08:26:58 +11:00
.github/workflows Remove Darwin runner from test-nix-develop.yml 2026-02-18 22:38:42 +11:00
esp-rs Added versions 1.91.1.0 and 1.93.0.0 (#27) 2026-02-20 08:20:22 +11:00
qemu-test Mega squashed commit. Added qemu-test crate and GHAs. 2025-10-12 20:37:29 +11:00
utils Added missing GDB versions for aarch64-apple-darwin 2025-10-12 16:16:25 +11:00
.gitignore Use flake-parts to create multi-arch flakes 2025-10-12 11:15:18 +11:00
flake.lock Use flake-parts to create multi-arch flakes 2025-10-12 11:15:18 +11:00
flake.nix Removed systemdMinimal requirement 2025-10-12 16:19:19 +11:00
LICENSE Initial commit 2024-02-24 00:52:50 +11:00
package.nix Added versions 1.91.1.0 and 1.93.0.0 (#27) 2026-02-20 08:20:22 +11:00
README.md Updated README.md 2026-02-20 08:26:58 +11:00
shell.nix Added versions 1.91.1.0 and 1.93.0.0 (#27) 2026-02-20 08:20:22 +11:00

esp-rs-nix

Project goals:

Project status: works on my machine!

Tip

Now supports x86_64-linux,aarch64-linux, and aarch64-apple-darwin systems!

Getting started

For nix-shell use, please refer to shell.nix.
For nix develop use, please refer to flake.nix and package.nix.

Version selection

A specific version of the rust toolchain can used with either the shell.nix, or package.nix files.
Below is a table of the currently supported versions.

rust-build (rustc)
1.93.0.0
1.92.0.0
1.91.1.0
1.90.0.0
1.89.0.0
1.88.0.0
1.87.0.0
1.86.0.0
crosstool-NG (gcc)
15.2.0_20250920
15.1.0_20250607
binutils (gdb)
16.3_20250913
16.2_20250324

New versions can be added by updating the ./esp-rs/versions.nix file with the correct file hashes.

why?

The recommended installation method using the espup tool didn't work for me.

notes

  • This is for development of no_std, esp-hal-based applications only. NOT for use with esp-hal-idf.
  • This is hard-coded to download binaries for x86_64 only, at the moment.
  • PRs welcome!