Skip to content

PlatformIO platform for CH32V RISC-V chips (CH32V003, CH32V103, CH32V20x, CH32V30x, CH32X035) and CH56x, CH57x, CH58x, CH59x

License

Notifications You must be signed in to change notification settings

Community-PIO-CH32V/platform-ch32v

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CH32V: development platform for PlatformIO

Build Status Documentation Status

The CH32V series offers industrial-grade, general-purpose microcontrollers based on a range of QingKe 32-bit RISC-V cores. All devices feature a DMA and a hardware stack area, which greatly improves interrupt latency. The family ranges from ultra-cheap, low-end CH32V003 with 2kB RAM / 16kB flash, up to high speed, ultra-connected CH32V307 with 64kB RAM / 256kB flash, hardware FPU, USB, CAN, Ethernet, etc.. For a list of available devices see the CH32V product selector page.

Note: WCH also offers the CH32F family with identical peripherals, which is based on ARM Cortex-M.

This repository is a PlatformIO platform. Just like platform-ststm32 etc., it enables the PlatformIO core to work with W.CH CH32V chips. This means in all the IDEs that PlatformIO supports (VSCode, CLion, etc.), developing and debugging firmwares for CH32V chips is easily possible.

Head over to https://github.com/Community-PIO-CH32V/ch32-pio-projects to see more example projects and detailed starting instructions.

Documentation

Please visit https://pio-ch32v.readthedocs.io/ for the most recent documention.

This page is a work in progress at the moment.

Important notices

The newest used version of OpenOCD requires the firmware of the WCH-Link(E) probe to be the latest (2.10 and 2.11 respectively). Otherwise you will be seeing flash programming errors like

Info : WCH-LinkE  mode:RV version 2.9 
..
** Programming Started **
Info : device id = 0xabc8abcd
Error: error writing to flash at address 0x00000000 at offset 0x00000000
embedded:startup.tcl:1162: Error: ** Programming Failed **

Please update the WCH-Link(E) firmware using

If you use Mac, the usage of a Linux virtual machine may be required to run these tools.

Media

vscode debugging

platform

Support

  • chips
    • CH32V003 (QingKe V2A)
    • CH32V103 (QingKe V3A)
    • CH32V203 (QingKe V4B)
    • CH32V208 (QingKe V4C)
    • CH32V303 (QingKe V4F)
    • CH32V305 (QingKe V4F)
    • CH32V307 (QingKe V4F)
    • CH32X035 (QingKe V4C)
    • CH32L103 (QingKe V4C)
    • CH56x (QingKe V3A)
    • CH57x (QingKe V3A)
    • CH58x (QingKe V4A)
    • CH59x (QingKe V4C)
  • development boards
    • CH32V003F4P6-EVT-R0 (official by W.CH)
    • CH32V203C8T6-EVT-R0 (official by W.CH)
    • CH32V307 EVT (by SCDZ, close to official W.CH board)
    • CH32X035C8T6-EVT-R0, CH32X035G8U6-EVT-R0, CH32X035F8U6-EVT-R0 (official by W.CH)
    • CH32L103C8T6-EVT-R0 (official by W.CH)
  • frameworks
  • debuggers (also implicitly uploaders)
    • WCH-Link(E)
    • ST-Link
    • J-Link
    • GDB-UART stub for debug-probe-less debugging?
  • uploaders (no debugging)
    • USB ISP bootloader (supported via wchisp)

Installation (see docs)

  1. Install PlatformIO
  2. Install platform-ch32v via PIO Core CLI --> pio pkg install -g -p https://github.com/Community-PIO-CH32V/platform-ch32v.git
  3. Create PlatformIO project and configure a platform option in platformio.ini file:
  4. For Linux, add PlatformIO per documentation. Then, add WCH udev rules by appending the following content to etc/udev/rules.d/99-platformio-udev.rules.
SUBSYSTEM=="usb", ATTR{idVendor}="1a86", ATTR{idProduct}=="8010", GROUP="plugdev"
SUBSYSTEM=="usb", ATTR{idVendor}="4348", ATTR{idProduct}=="55e0", GROUP="plugdev"
SUBSYSTEM=="usb", ATTR{idVendor}="1a86", ATTR{idProduct}=="8012", GROUP="plugdev"

Without these udev rules or the missing group membership of the user in the plugdev group, accessing the WCH-Link(E) via OpenOCD or wchisp will not work!!

Updating

In case you are not seeing the latest features (e.g., available frameworks), please make sure that your platform version is up to date by either:

  1. PIO Core CLI -> pio pkg update -g -p "ch32v"
  2. or, simply delete these folders and build your project again C:\Users\<user>\.platformio\platforms\ch32v* C:\Users\<user>\.platformio\packages\framework-*ch* C:\Users\<user>\.platformio\.cache

Development version

[env:development]
platform = https://github.com/Community-PIO-CH32V/platform-ch32v.git
board = ...
...

Configuration

The configuration in regards to the builder scripts etc. are still in progress. See the above mentioned projects repository for now.

Media Supported Development Boards

ch32v307 evt board ch32v003 evt board ch32v203 evt board

About

PlatformIO platform for CH32V RISC-V chips (CH32V003, CH32V103, CH32V20x, CH32V30x, CH32X035) and CH56x, CH57x, CH58x, CH59x

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages