ch32v003 from scratch in Zig

Examples range from simple to complex. Everything is compiled with a simple zig build.
The minichlink flasher is also included and can be compiled using zig build as well.

Getting Started

Note

If you are using nix, you can simply run nix develop in the root of the project, and it will automatically install zig, zigscient, and minichlink in your environment. And you can skip to the Build and upload the example section.

Install Zig

Currently, the examples are tested with 0.14.0.
You can download the latest version from: https://ziglang.org/download/

Build the flasher

cd tools/minichlink
zig build --release=safe

# Add the `minichlink` to your `PATH`:
export PATH=$PATH:$(pwd)/zig-out/bin

Build and upload the example

cd basic/001_blink_minimal
zig build
minichlink -w zig-out/firmware/ch32v003_blink.bin flash -b

Useful Notes

Size benchmark

See SIZE_BENCHMARK.md

Flashing

# Write and reboot.
minichlink -w zig-out/firmware/ch32v003_blink.bin flash -b

Debugging

# Run GDB server.
minichlink -G
# Reboot into halt and run GDB server 
# (firmware will be halted until GDB is connected).
minichlink -a -G

In CLion: add a new Remote Debug configuration.

Show firmware info

# Size (clang)
size zig-out/firmware/ch32v003_blink.elf
# Sections info (clang)
objdump -h zig-out/firmware/ch32v003_blink.elf 
bloaty zig-out/firmware/ch32v003_blink.elf

Dump memory

# To file
minichlink -r memory.bin 0x20000000 2048
# To stdout as hex
minichlink -r + 0x20000000 128
# To stdout as hex without empty lines
minichlink -r + 0x20000000 2048 | grep -v "00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00"

UART

screen /dev/tty.usbmodem* 115200 

Ctrl + A, Ctrl + \ - Exit screen and terminate all programs in this screen.
Ctrl + D, D or Ctrl + A, Ctrl + D - "minimize" screen and screen -r to restore it.