drbh / ch32-hal

A Rust Embassy HAL impl for the CH32V0, CH32V1, CH32V2, CH32V3, CH32X0 family, compatible with embedded-hal.

ch32-hal

WIP hal crate for WCH's 32-bit RISC-V microcontrollers.

This hal crates is the embassy driver for WCH's 32-bit RISC-V microcontrollers.

This hal crates uses the metapac approach to support multiple chips in the same crate. The metapac is maintained in the ch32-rs/ch32-data repository, published as a crate ch32-metapac.

Currently, supported chips are listed in Cargo.toml as feature flags, others should work if you are careful as most peripherals are similar enough.

Keypoints:

• embassy support
• embassy as the first-class citizen
• metapac approach
• all in one crate

TODOs

• Embassy timer driver using Systick
• SDI Debug
• GPIO
  • Interrupts using EXTI (async)
• UART
  • Half-duplex
  • UART async (DMA)
• SPI
  • blocking API
  • async API
• I2C
  • blocking API
  • async API
• ADC
  • blocking API, for CH32V2, CH32V3
  • async API
• OPA
• USB
• RNG
• More to come

Minimum supported Rust version(MSRV)

This project is developed with a recent nightly version of Rust compiler. And is expected to work with beta versions of Rust.

Feel free to change this if you did some testing with some version of Rust.

Contributing

TODO. All kinds of contributions are welcome.

License

This project is licensed under the MIT or Apache-2.0 license, at your option.