Crate e310x_hal

HAL for the E310x family of microcontrollers

This is an implementation of the [embedded-hal] traits for the E310x family of microcontrollers.

Building an application for the E310x chips

The E310x chips implement the Zaamo extension for atomic instructions. This means that it partially supports the A extension for atomic. Specifically, it supports the amo* instructions, but not the lr* and sc* instructions.

It is discouraged to use the riscv32imac-unknown-none-elf target for E310x chips, as it will potentially generate code that uses the lr* and sc* instructions, which are not supported by the E310x chips. Thus, it is recommended to use riscv32imc-unknown-none-elf.

Working with atomic operations

If you are using the riscv32imc-unknown-none-elf target, you will notice that core::sync::atomic is not available. To work around this, you can use the portable-atomic crate. This crate allows us to use native amo* instructions on the E310x chips without requiring the A extension. Furthermore, you can emulate the lr* and sc* instructions if needed.

Thus, the recommended way to work with E310x chips is:

1. Compile your code against the riscv32imc-unknown-none-elf target.
2. Add the following configuration to your .cargo/config.toml:

[target.'cfg(all(target_arch = "riscv32", target_os = "none"))']
rustflags = [
   "--cfg", "portable_atomic_target_feature=\"zaamo\"",
]

[build]
target = "riscv32imc-unknown-none-elf"

This will ensure that the portable-atomic crate is correctly configured to work with the E310x chips.

Re-exports

pub use device::DeviceResources;

pub use e310x;

Modules

clock

Clock configuration

core

E31 core peripherals

delay

Delays

device

Device resources available in FE310-G000 and FE310-G002 chip packages

gpio

General Purpose I/O

i2c

I2C Master Interface

pmu

PMU Extension

prelude

Prelude

pwm

Pulse Width Modulation Interface

rtc

RTC

serial

Serial interface

spi

Serial Peripheral Interface

stdout

Stdout

time

Time units

wdog

Watchdog