oblonka/ch32-rs

Embedded Rust device crates for WCH's RISC-V and Cortex-M microcontrollers

ch32-rs - WCH's CH32 Peripheral Access Crates

Embedded Rust device crates for WCH's RISC-V and Cortex-M microcontrollers.

Roadmap

• Support CH32V3x/CH32V2x family
• Support CH32V103 family
• Support CH32V003 family, ch32v00x-hal
• Toolchains
  • wchisp for USB-ISP
  • wlink for WCH-Link probe
  • probe-rs support, WIP...
• HAL crate for CH32V3x/CH32V2x family
  • https://github.com/ch32-rs/ch32v20x-hal WIP...
• HAL crate for CH32V103x family
• CHxxx interface or BLE MCUs.
• Cortex-M MCUs.

Development

# Do not use rust version of svdtools
pip install svdtools

# install xmlint

cargo install svd2rust

./scripts/generate.sh && ./scripts/update.sh

MCU list

• 32-bit General Purpose RISC-V
• 32-bit General Purpose Cortex-M3
• 32-bit High-speed Interface MCU, RISC-V or Unmentioned
• 32-bit BLE MCU, RISC-V or Coretex-M

NOTE: Will never support 8-bit MCUs.

Subdivision

• D6: Low-and-medium-density general
• D8: High-density general
• D8C: Connectivity or interconnectivity
• D8W: Wireless

RISC-V

Nick name: "赤菟"(Chitu). IP Core brand: 青稞(Qingke). V2, V3, V4A, V4B, V4C, V4F.

• CH32V103: Qingke-V3A
• CH32V203: Qingke-V4B
• CH32V208: Qingke-V4C
• CH32V303/305/307: Qingke-V4F
• CH32L103 RISC-V4C, Low power
• CH32X035/033: RISC-V4C
• CH56x: RISC-V3A
• CH571, CH573: RISC-V3A BLE 4.2
• CH58x: RISC-V4A, BLE
• CH59x: RISC-V4C, BLE 5.4
• CH643: RISC-V4C RGB driver MCU

Cortex-M

CH32F20x_D6: CH32F203K8, CH32F203C6 and CH32F203C8.
CH32F20x_D8: CH32F203CB, CH32F203RC and CH32F203VC.
CH32F20x_D8C: CH32F205RB and CH32F207VC.
CH32F20x_D8W: CH32F208RB and CH32F208WB.

Toolchain

• MRS: MounRiver Studio
  • Precompiled binary of OpenOCD is included in MRS(Windows, Linux, and macOS)
  • But it requires WCH-Link to be force upgraded to 2.7
• Official Flash Tool: NanjingQinheng/WCH-Link
• OpenOCD fork with WCH-Link support(wlink)
  • Buggy, compatible with WCH-Link 2.3
• ch32-rs/wchisp

Ref

• https://github.com/openwch