Enum Esp32Chip 

pub enum Esp32Chip {
    Esp32S3,
    Esp32C3,
    Esp32P4,
}

A supported ESP32-class target chip.

The variant determines the chip’s architecture and every architecture- and chip-specific build/emulation parameter. Parse one with Esp32Chip::from_str; the chip string is the single source of truth ([backends.esp32] chip in Water.toml, or the selected platform).

Variants

Esp32S3

ESP32-S3: dual-core Xtensa LX7.

Esp32C3

ESP32-C3: single-core RISC-V (RV32IMC).

Esp32P4

ESP32-P4: dual-core RISC-V (RV32IMAFC, hardware single-precision FPU).

Implementations

impl Esp32Chip

pub const fn id(self) -> &'static str

The canonical chip identifier (e.g. "esp32s3"), as used by espflash, QEMU machine models, and Water.toml.

pub const fn arch(self) -> Esp32Arch

The chip’s instruction set architecture.

pub const fn target_triple(self) -> &'static str

The Rust target triple to cross-compile the firmware for.

Xtensa chips use a per-chip triple (xtensa-<chip>-espidf); RISC-V chips use the architecture-level triple matching their ISA extensions (imc on the C-series, imafc — hardware single-float — on the P4).

pub fn triple(self) -> Triple

The target triple parsed into a Triple.

Panics

Panics only if the static triple stops being a valid target_lexicon triple, which would be a build-time bug in this table.

pub const fn lexicon_arch(self) -> Architecture

The target_lexicon architecture for the chip.

pub const fn qemu_binary(self) -> &'static str

The QEMU system binary that emulates this chip’s architecture.

pub const fn qemu_machine(self) -> &'static str

The QEMU -machine model for this chip (the chip id doubles as the machine name in Espressif’s QEMU fork).

pub const fn needs_qemu_efuse_workaround(self) -> bool

Whether QEMU needs the eFuse ADC-calibration workaround.

Xtensa chips hang at startup in hardware ADC self-calibration, which QEMU does not emulate; an eFuse image with calibration version 1 makes startup read the (zeroed) calibration codes instead. RISC-V chips boot cleanly under QEMU without it.

pub const fn gcc_component(self) -> Esp32GccComponent

The espup toolchain component directory holding the chip’s GCC, relative to ~/.rustup/toolchains/esp/<component>, together with the bin subpath under the discovered version directory.

pub const fn firmware_params(self) -> Esp32FirmwareParams

The harness firmware parameters that vary by chip: console transport, flash size, main-task stack, app-partition size, and codegen profile.

Trait Implementations

impl Clone for Esp32Chip

fn clone(&self) -> Esp32Chip

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for Esp32Chip

impl Debug for Esp32Chip

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for Esp32Chip

impl FromStr for Esp32Chip

type Err = Report

The associated error which can be returned from parsing.

fn from_str(value: &str) -> Result<Self>

Parses a string s to return a value of this type.

impl PartialEq for Esp32Chip

fn eq(&self, other: &Esp32Chip) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Esp32Chip