Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/islandcontroller/hello-ch32v103
A simple "Hello World"-like project for the WCH CH32V103 RISC-V MCU
https://github.com/islandcontroller/hello-ch32v103
ch32v103 hello-world openwch risc-v
Last synced: about 1 month ago
JSON representation
A simple "Hello World"-like project for the WCH CH32V103 RISC-V MCU
- Host: GitHub
- URL: https://github.com/islandcontroller/hello-ch32v103
- Owner: islandcontroller
- License: mit
- Created: 2022-02-17T16:10:46.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2024-03-30T18:31:46.000Z (9 months ago)
- Last Synced: 2024-03-30T19:36:45.782Z (9 months ago)
- Topics: ch32v103, hello-world, openwch, risc-v
- Language: C
- Homepage:
- Size: 572 KB
- Stars: 3
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# hello-ch32v103 [![GitHub license](https://img.shields.io/github/license/islandcontroller/hello-ch32v103?style=flat-square)](LICENSE) [![Discord server link](https://img.shields.io/badge/discord-WCH%20Community-white?style=flat-square&logo=discord)](https://t.co/Qbblvmfbae)
A simple "Hello World"-like project for the WCH CH32V103 RISC-V MCU.
This project contains a simple set of modules to get the MCU running in a minimal configuration:
- Serial I/O on USART1 (connected to WCH-Link VCP)
- SysTick enabled and using empty dummy interrupt handler
- TIM3 Channel 1 configured for PWM output to LED
- ADC1 internal temperature sensor and Vrefint readout
- I2C2 interface with 24C64 EEPROM read and write access**:information_source: See [`README.vscode.md`](README.vscode.md) for VSCode setup information! :information_source:**
## Requirements
* Hardware
* WCH CH32V103R8T6-EVT-R1 Evaluation Kit (available from LCSC, [PartNr `C2943982`](https://lcsc.com/product-detail/Development-Boards-Kits_WCH-Jiangsu-Qin-Heng-CH32V103R8T6-EVT-R1_C2943982.html)) + USB-A to USB-C Cable
* (optional) Female-female jumper wires
* (optional) AT24C64 EEPROM IC + Solderless breadboard + 2x 10k Resistors
* Software
* [MounRiver Studio Community](http://www.mounriver.com/)
* Serial terminal program, e.g. [PuTTy](https://www.putty.org/) or minicom## Hardware Setup (optional)
* Connect the `LED1` and `PA6` pins on header `J3` using a female-female jumper wire
* Connect the 24C64 EEPROM to `PB10` and `PB11` and add 10k pull-up resistors to SDA and SCL:
```
.___________. VCC VCC VCC VCC .________________
1| |_| |8 | | | | |
+---| A0 VCC |---+ .|. .|. +---| VCC (3V3)
| 2| |7 | | | | R1,R2 |
o---| A1 WP |---+ |_| |_| 10k +---| GND
| 3| |6 | | | | |
o---| A2 SCL |---(-----o---(---------(---| PB10 (I2C2_SCL)
| 4| |5 | | | |
o---| GND SDA |---(---------o---------(---| PB11 (I2C2_SDA)
| |___________| | | |________________
GND U2 GND GND U1
AT24C64 (DIP8) CH32V103R8T6
```## Usage
* Clone this repository using the following command. Note the use of the `--recursive` tag.
```
git clone --recursive https://github.com/islandcontroller/hello-ch32v103
```
* Load this project in **MounRiver Studio Community** and build the executable
* Open a serial terminal on the WCH-Link programmer's VCP (**115200 Baud, 8N1**)
* Flash the firmware to the MCU using the provided `.launch` script
* Resume execution once breakpoint in `main()` is reached
* Press `?` in the serial terminal to show available commands### **Note**
If you want to use the EEPROM demo, remove the comment at the start of the `#define USE_EEPROM_DEMO` line at the top of `main.c`. The demo is disabled by default.
## Licensing
If not stated otherwise in the specific file, the contents of this project are licensed under the MIT License. The full license text is provided in the [`LICENSE`](LICENSE) file.
SPDX-License-Identifier: MIT
## Help and References
* [openwch/ch32v103](https://github.com/openwch/ch32v103) Manufacturer EVT demos and documentation
* [WCH-IC: CH32V103DS0.pdf](http://www.wch-ic.com/downloads/CH32V103DS0_PDF.html) MCU Datasheet
* [WCH-IC: CH32xRM.pdf](http://www.wch-ic.com/downloads/CH32xRM_PDF.html) MCU Reference Manual
* [WCH-IC: QingKeV3_Processor_Manual.pdf](http://www.wch-ic.com/downloads/QingKeV3_Processor_Manual_PDF.html) Processor Core ManualIf you're looking for further information about WCH products, check out their community Discord server:
[![Discord server link](https://img.shields.io/badge/discord-WCH%20Community-white?style=flat-square&logo=discord)](https://t.co/Qbblvmfbae)