{"id":25781957,"url":"https://github.com/islandcontroller/template-ch32v003","last_synced_at":"2026-02-25T08:41:10.623Z","repository":{"id":278646041,"uuid":"930589024","full_name":"islandcontroller/template-ch32v003","owner":"islandcontroller","description":"A bare-minimum template for your next project using the ultra low-cost WCH CH32V003 RISC-V MCU!","archived":false,"fork":false,"pushed_at":"2025-04-19T21:29:09.000Z","size":53,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-19T22:50:11.617Z","etag":null,"topics":["ch32v003","cmake","openwch","template-project","vscode"],"latest_commit_sha":null,"homepage":"","language":"CMake","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/islandcontroller.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-10T21:58:39.000Z","updated_at":"2025-04-19T21:29:12.000Z","dependencies_parsed_at":"2025-02-20T22:32:12.104Z","dependency_job_id":"19aec2c4-05b5-41b5-88c5-1cbab513b7b9","html_url":"https://github.com/islandcontroller/template-ch32v003","commit_stats":null,"previous_names":["islandcontroller/template-ch32v003"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/islandcontroller/template-ch32v003","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/islandcontroller%2Ftemplate-ch32v003","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/islandcontroller%2Ftemplate-ch32v003/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/islandcontroller%2Ftemplate-ch32v003/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/islandcontroller%2Ftemplate-ch32v003/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/islandcontroller","download_url":"https://codeload.github.com/islandcontroller/template-ch32v003/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/islandcontroller%2Ftemplate-ch32v003/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29815025,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-25T05:36:42.804Z","status":"ssl_error","status_checked_at":"2026-02-25T05:36:31.934Z","response_time":61,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ch32v003","cmake","openwch","template-project","vscode"],"created_at":"2025-02-27T07:34:46.541Z","updated_at":"2026-02-25T08:41:10.607Z","avatar_url":"https://github.com/islandcontroller.png","language":"CMake","funding_links":[],"categories":[],"sub_categories":[],"readme":"# template-ch32v003 [![Discord server link](https://img.shields.io/badge/discord-WCH%20Community-white?style=flat-square\u0026logo=discord)](https://t.co/Qbblvmfbae)\n\nA bare-minimum template for your next project using the ultra low-cost WCH CH32V003 RISC-V MCU!\n\n\u003cp align=\"center\"\u003e\u003cimg src=\"scr.png\" /\u003e\u003c/p\u003e\n\nYou can find a fully working example at [islandcontroller/hello-ch32v003](https://github.com/islandcontroller/hello-ch32v003)!\n\n## Requirements\n\n* Hardware\n  * WCH CH32V003 microcontroller\n  * WCH-LinkE Debugger\n* Software\n  * Linux OS or WSL installation\n  * [Docker Engine](https://docs.docker.com/engine/install/debian/) (running within WSL if applicable)\n  * VSCode [Dev Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) extension\n  * (WSL only) [usbipd-win](https://learn.microsoft.com/en-us/windows/wsl/connect-usb)\n\n## Getting Started\n\n* Click on \"**Use this template**\" to create your own fork of this template.\n* Clone the forked repository using the following command. Note the use of the `--recursive` tag.\n  ```\n  git clone --recursive https://github.com/\u003cyour username here\u003e/template-ch32v003\n  ```\n* Open the folder in VSCode\n* Connect WCH-Link debug probe\n  * (WSL only) attach to WSL using `usbipd attach --wsl --busid \u003c...\u003e`. **This needs to be completed before starting the Dev Container.**\n* Run the command \"**Dev Containers: Reopen in Container**\"\n  * On first launch, you may need to install some udev rules on your host machine. Copy the files to your workspace by running `setup-devcontainer` inside the container.\n  * Re-open the workspace on your host and run the `install-rules` script inside the `.vscode/setup` folder.\n\n        cd .vscode/setup\n        sudo ./install-rules\n\n  * Afterwards, restart the devcontainer.\n* Upon prompt, select the \"`WCH RISC-V Toolchain x.x`\" CMake Kit. \n* Run \"**CMake: Configure**\"\n* Build using \"**CMake: Build [F7]**\"\n\n### Serial Monitor\n\nA serial port monitor is included in the devcontainer. To launch the serial monitor, use:\n\n    cu -l /dev/ttyACM0 -s \u003cbaudrate\u003e\n\nTo close the connection later on, press ESC/ENTER, type `~.` (tilde, dot) and wait for 3 seconds.\n\n### Customization\n\n* [CMakeLists.txt](CMakeLists.txt)\n  * Change the name and description in the `project(...)` command.\n  * Place additional include directories in the `include_directories(...)` command.\n  * Source files are added automatically if they have a `.c` or `.S` file extension.\n* [.vscode/launch.json](.vscode/launch.json)\n  * Adjust the ELF binary in the `program` field to match the project name.\n\n## Help and References\n\n* [islandcontroller/hello-ch32v003](https://github.com/islandcontroller/hello-ch32v003) Example project\n* [openwch/ch32v003](https://github.com/openwch/ch32v003) Manufacturer EVT demos and documentation\n* [WCH-IC: CH32V003DS0.pdf](http://www.wch-ic.com/downloads/CH32V003DS0_PDF.html) MCU Datasheet\n* [WCH-IC: CH32V003RM.pdf](http://www.wch-ic.com/downloads/CH32V003RM_PDF.html) MCU Reference Manual\n* [WCH-IC: QingKeV2_Processor_Manual.pdf](http://www.wch-ic.com/downloads/QingKeV2_Processor_Manual_PDF.html) Processor Core Manual\n\nIf you're looking for further information about WCH products, check out their community Discord server: \n[![Discord server link](https://img.shields.io/badge/discord-WCH%20Community-white?style=flat-square\u0026logo=discord)](https://t.co/Qbblvmfbae)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fislandcontroller%2Ftemplate-ch32v003","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fislandcontroller%2Ftemplate-ch32v003","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fislandcontroller%2Ftemplate-ch32v003/lists"}