https://github.com/shishir-dey/ch32v103-template
A template repository for bare-metal C projects on CH32 microcontrollers
https://github.com/shishir-dey/ch32v103-template
ch32 ch32v ch32v103
Last synced: about 1 month ago
JSON representation
A template repository for bare-metal C projects on CH32 microcontrollers
- Host: GitHub
- URL: https://github.com/shishir-dey/ch32v103-template
- Owner: shishir-dey
- License: mit
- Created: 2025-08-31T14:13:17.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2025-08-31T14:44:59.000Z (about 2 months ago)
- Last Synced: 2025-08-31T16:23:18.097Z (about 2 months ago)
- Topics: ch32, ch32v, ch32v103
- Language: C
- Homepage:
- Size: 129 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# CH32V103 Template Project
A complete template project for the CH32V103 RISC-V microcontroller with CMake build system and automated CI/CD.
## Project Structure
```
ch32v103-template/
├── .gitignore
├── CMakeLists.txt
├── LICENSE
├── README.md
├── .github/
├── apps/ # Application examples
│ └── framework/ # Application framework
├── core/ # Core system files
├── cpu/ # CPU-specific code
├── driver/ # Hardware abstraction layer
│ ├── inc/ # Driver header files
│ └── src/ # Driver source files
├── lib/ # Libraries
│ └── debug/ # Debug utilities
└── system/ # System-level code
```
## Prerequisites
### Local Development
1. **RISC-V GCC Toolchain**: Install using xPack
```bash
npm install -g xpm
xpm install @xpack-dev-tools/riscv-none-elf-gcc@14.2.0-3.1
```
2. **CMake**: Version 3.16 or higher
```bash
# Ubuntu/Debian
sudo apt-get install cmake
# macOS
brew install cmake
# Windows
# Download from https://cmake.org/download/
```
3. **Make**: Build system
```bash
# Ubuntu/Debian
sudo apt-get install build-essential
# macOS (via Xcode Command Line Tools)
xcode-select --install
```
### Toolchain Setup
The toolchain will be installed in:
- Linux/macOS: `~/.local/xPacks/@xpack-dev-tools/riscv-none-elf-gcc/14.2.0-3.1/.content/bin/`
- Windows: `%APPDATA%\xPacks\@xpack-dev-tools\riscv-none-elf-gcc\14.2.0-3.1\.content\bin\`
Add this directory to your PATH environment variable.
## Building
### Quick Start
1. **Clone the repository**:
```bash
git clone
cd ch32v103-template
```
2. **Create build directory**:
```bash
mkdir build
cd build
```
3. **Configure and build**:
```bash
cmake ..
make -j$(nproc)
```
## Flashing with WCH-Link
To flash the compiled firmware to the CH32V103 microcontroller, use the WCH-Link tool (wlink).
### Installation
Install wlink using Cargo:
```bash
cargo install --git https://github.com/ch32-rs/wlink
```
### Usage
WCH-Link is a flash tool for WCH's RISC-V MCUs (CH32V, CH56X, CH57X, CH58X, CH59X, CH32L103, CH32X035, CH641, CH643).
Example: Flash the firmware binary to address 0x08000000:
```bash
wlink flash --address 0x08000000 ./firmware.bin
```
## License
This project template is provided as-is for educational and commercial use. Please check individual component licenses for specific terms.
## Contributing
1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test with the CI/CD pipeline
5. Submit a pull request