Crate esp32c2_hal

source ·
Expand description

no_std HAL for the ESP32-C2/ESP8684 from Espressif.

Implements a number of the traits defined by the various packages in the embedded-hal repository.

Cargo Features

  • async - Enable support for asynchronous operation, with interfaces provided by embedded-hal-async and embedded-io-async
  • debug - Enable debug features in the HAL (used for development)
  • defmt - Enable defmt::Format on certain types
  • direct-boot - Use the direct boot image format
  • direct-vectoring - Enable direct vector table hooking support
  • eh1 - Implement the traits defined in the 1.0.0-xxx pre-releases of embedded-hal, embedded-hal-nb, and embedded-io
  • embassy - Enable support for embassy, a modern asynchronous embedded framework
  • embassy-time-systick - Enable the embassy time driver using the SYSTIMER peripheral
  • embassy-time-timg0 - Enable the embassy time driver using the TIMG0 peripheral
  • interrupt-preemption - Enable priority-based interrupt preemption
  • log - enable log output using the log crate
  • rt - Runtime support
  • ufmt - Implement the ufmt_write::uWrite trait for the UART and USB Serial JTAG drivers
  • vectored - Enable interrupt vectoring
  • xtal26mhz - The target device uses a 26MHz crystal
  • xtal40mhz - The target device uses a 40MHz crystal
Default Features

The rt, vectored, and xtal40mhz features are enabled by default.

Supported Image Formats

This HAL supports building multiple different application image formats. You can read about each below.

The ESP-IDF Bootloader format is used unless some other format is specified via its feature.

ESP-IDF Bootloader

Use the second-stage bootloader from ESP-IDF and its associated application image format. See the App Image Format documentation for more information about this format.

Direct Boot

This device additionally supports direct-boot, which allows an application to be executed directly from flash, without using the second-stage bootloader. For more information please see the esp32c3-direct-boot-example in the Espressif organization on GitHub.

Modules

  • adc
  • analog
    Common module for analog functions
  • assist_debug
    Debug Assistant
  • clock
    Clock Control
  • delay
    Delay driver
  • dma
    Direct Memory Access Commons
  • efuse
    Reading of eFuses (ESP32-C2)
  • esp_riscv_rt
    Minimal startup / runtime for RISC-V CPUs from Espressif
  • gpio
    General Purpose I/Os
  • i2c
    I2C Driver
  • interrupt
    Interrupt support
  • ledc
    LEDC (LED PWM Controller) peripheral control
  • macros
    Procedural macros
  • peripheral
    Exclusive peripheral access
  • peripherals
    Peripheral instance singletons (ESP32-C2)
  • prelude
    The prelude
  • radio
    Wireless communication peripheral implementations
  • reset
    Hardware and Software Reset
  • rng
    Random Number Generator
  • rom
    ESP ROM libraries
  • rtc_cntl
    RTC_CNTL (Real-Time Clock Control) and Low-power Management
  • sha
    Secure Hash Algorithm peripheral driver
  • spi
    Serial Peripheral Interface
  • system
    System Control
  • systimer
    System Timer peripheral driver
  • timer
    General-purpose timers
  • trapframe
    State of the CPU saved when entering exception or interrupt
  • uart
    UART driver

Structs

  • Delay
    Delay driver
  • FlashSafeDma
    FlashSafeDma
  • IO
    General Purpose Input/Output driver
  • Rng
    Random number generator driver
  • Rtc
    Low-power Management
  • Rwdt
    RTC Watchdog Timer
  • Spi
    SPI peripheral driver
  • Timer
    General-purpose Timer driver
  • Uart
    UART driver

Enums

  • Cpu
    Available CPU cores

Functions

  • get_core
    Which core the application is currently executing on

Attribute Macros

  • entry
    Attribute to declare the entry point of the program