| .. zephyr:board:: ch32v003evt |
| |
| Overview |
| ******** |
| |
| The `WCH`_ CH32V003EVT hardware provides support for QingKe V2A 32-bit RISC-V |
| processor and the following devices: |
| |
| * CLOCK |
| * :abbr:`GPIO (General Purpose Input Output)` |
| * :abbr:`NVIC (Nested Vectored Interrupt Controller)` |
| |
| The board is equipped with two LEDs. The `WCH webpage on CH32V003`_ contains |
| the processor's information and the datasheet. |
| |
| Hardware |
| ******** |
| |
| The QingKe V2A 32-bit RISC-V processor of the WCH CH32V003EVT is clocked by an |
| external crystal and runs at 48 MHz. |
| |
| Supported Features |
| ================== |
| |
| .. zephyr:board-supported-hw:: |
| |
| Connections and IOs |
| =================== |
| |
| LED |
| --- |
| |
| * LED1 = Unconnected. Connect to an I/O pin (PD4). |
| |
| Programming and Debugging |
| ************************* |
| |
| .. zephyr:board-supported-runners:: |
| |
| Applications for the ``ch32v003evt`` board target can be built and flashed |
| in the usual way (see :ref:`build_an_application` and :ref:`application_run` |
| for more details); however, an external programmer is required since the board |
| does not have any built-in debug support. |
| |
| The following pins of the external programmer must be connected to the |
| following pins on the PCB (see image): |
| |
| * VCC = VCC (do not power the board from the USB port at the same time) |
| * GND = GND |
| * SWIO = PD1 |
| |
| Flashing |
| ======== |
| |
| You can use ``minichlink`` to flash the board. Once ``minichlink`` has been set |
| up, build and flash applications as usual (see :ref:`build_an_application` and |
| :ref:`application_run` for more details). |
| |
| Here is an example for the :zephyr:code-sample:`blinky` application. |
| |
| .. zephyr-app-commands:: |
| :zephyr-app: samples/basic/blinky |
| :board: ch32v003evt |
| :goals: build flash |
| |
| Debugging |
| ========= |
| |
| This board can be debugged via OpenOCD or ``minichlink``. |
| |
| Testing the LED on the WCH CH32V003EVT |
| ************************************** |
| |
| There is 1 sample program that allow you to test that the LED on the board is |
| working properly with Zephyr: |
| |
| .. code-block:: console |
| |
| samples/basic/blinky |
| |
| You can build and flash the examples to make sure Zephyr is running |
| correctly on your board. The button and LED definitions can be found |
| in :zephyr_file:`boards/wch/ch32v003evt/ch32v003evt.dts`. |
| |
| References |
| ********** |
| |
| .. target-notes:: |
| |
| .. _WCH: http://www.wch-ic.com |
| .. _WCH webpage on CH32V003: https://www.wch-ic.com/products/CH32V003.html |
