hobbylab.jp Software 開発環境 CH32 開発環境

WCH-LinkE は ARMモードと RISC-Vモード共に対応している。
CH32V203 は RISC-Vモードにする必要があります。
最初の状態は ARMモードになっていました。
これを変更する場合に必要なプログラムが WCH-LinkUtility ですが2025年7月20日現在では Windows 用しか無い。

b.WCH-LinkEのモード変更方法

(a)変更用のアプリ
　私が調べた限りではアプリは2種類有。

アプリ名	Windows,Mac	Linux
WCH-LinkUtility	○	○
MounRiver Studio	○	○

(b) WCH-LinkUtility アプリのダウンロードと起動
変更に必要なプログラムは Windows なので注意下さい。
プログラムのダウンロード先はWCH-LinkUtility.ZIP でダウンロードできます。ダウンロードしたファイルを解凍して『WCH-LinkUtility.exe』を起動させると下図の画面が表示されます。

(b)ファームウェアのアップデート
メニュー「Target」の [ Connect WCH-Link ] を選択。

アップデートするかの問に『はい』をクリック

　アップデート完了で Operation Result が変化する。
　

　⇒　

(c)RISC-Vモードへ変更
Active WCH-Link Mode:を [ WCH-LinkRV ] に選択して「Set」をクリック

画面左上の core を [ RISC-V ] に選択する。続いて画面下 Connected WCH-Link Lisst の Refresh ボタンをクリックすると [ RISC-V Link ] を選ぶ事ができようになったと思います。

RISC-V Link で WCH-LinkE のLEDは赤だけが点灯しているはずです。これで Linux でも接続できるはず。

c.WCH-LinkEとMPU端子の接続方法

WCH-LinkE	CH32V203	説　　　明
5V	5V	外部で5V→3.3V電圧変換があり、MPUへ給電している場合接続
3V3	3V3(VDD)	MPUへ直接接続する場合は5Vでなく3V3をVDDに接続する。
GND	GND
SWDIO	PA13
SWCLK	PA14

(2)IDEの設定(WCH-LinkE)

[ファイル] [環境設定] [追加のボードマネージャのURL]に以下URLを入力する。
https://raw.githubusercontent.com/verylowfreq/board_manager_ch32/main/package_ch32v_index_sz.json

a.インストールする。
　ボードマネージャ名は CH32V Boards by M.S.
b.ツールの項目、ボード以下の選択内容

項目	選択内容
ボード	CH32V20x
Upload methpd	WCH-SWD
シリアルポート	絶対選択しない事

もしWCH-SWDで動作しなくなった場合の対処は
a.コマンドで
　・アプリと設定ファイルを削除
　　sudo apt purge arduino
　・依存関係で不要パッケージを削除
　　sudo apt purge arduino
b.その他hoomに有るファイルを削除。
　　『Arduino』と「.arduino15」を削除。
　　『』はﾃﾞｨﾚｸﾄﾘｰ「」は隠しﾃﾞｨﾚｸﾄﾘｰです

その他URL
https://github.com/openwch/board_manager_files/raw/main/package_ch32v_index.json
これは203GとCシリーズのみ対応しているのでK8T6 32pinには対応していないようだ。また通信もSWDだけでISPが無いので USBダイレクト接続には対応していないと思われる。
CH-LinkE に接続して開発プログラムの書き込みはUSB接続と違って BOOT やリセットボタンの操作は不要だ。
このためUSB接続より良いと思う。

(3)USBに接続して開発

a.Linuxでの対応

Windowsと違いLinux(私はmintを使用しています。)では下記のUSB定義ファイルを登録する必要が有る。
通信に必要なキーワードは、wchisp
GitHub の Note for Linux に
『Linux に関する注意』が記載されており、ここには udev ルールの設定が必要と記載されている。

If you are using Linux, you need to set the udev rules for your device.
# /etc/udev/rules.d/50-wchisp.rules
SUBSYSTEM=="usb", ATTRS{idVendor}=="4348", ATTRS{idProduct}=="55e0", MODE="0666"
# or replace MODE="0666" with GROUP="plugdev" or something else

これは、『/etc/udev/rules.d/』に『50-wchisp.rules』のファイルを作成してそのファイルに『SUBSYSTEM=="usb", ATTRS{idVendor}=="4348", ATTRS{idProduct}=="55e0", MODE="0666"』を記載して usbのルールに再読込させる。
例えば端末からエディター『vim』で作成する場合は

hobbylab@GZBOX:~$ sudo vim /etc/udev/rules.d/50-wchisp.rules
　［ Vim でファイル内を編集して記録する。その後 udevのルールシステムを再起動する。］
hobbylab@GZBOX:~$ sudo udevadm control --reload-rules

となる。

(4)IDEの設定(USB)

IDEの設定で注意する事項としては、｢ツール｣、「ボード内の Upload method」が [ WCH-ISP ] になっていることを確認すること。

(5)プログラミング

プログラムを記載してArduino IDE の『マイコンボードに書き込む』ボタンを押す前に
開発ボートの｢BOOT｣ボタンを押しながら「リセット」ボタンを押すこと。
その後 Arduino IDE の『マイコンボードに書き込む』ボタンを押すとメッセージの一部で文字色が赤字となったが、エラーは無さそうで、プログラムを書き込む事に成功した。
メッセージ

最大229376バイトのフラッシュメモリのうち、スケッチが8564バイト（3%）を使っています。
最大20480バイトのRAMのうち、グローバル変数が628バイト（3%）を使っていて、ローカル変数で19852バイト使うことができます。
01:30:10 [INFO] Chip: CH32V203C8T6[0x3119] (Code Flash: 64KiB)
01:30:10 [INFO] Chip UID: CD-AB-DB-62-FF-BC-A7-CB
01:30:10 [INFO] BTVER(bootloader ver): 02.70
01:30:10 [INFO] Code Flash protected: false
01:30:10 [INFO] Current config registers: a55a3fc000ff00ffffffffff00020700cdabdb62ffbca7cb
RDPR_USER: 0xC03F5AA5
  [7:0]   RDPR 0xA5 (0b10100101)
    `- Unprotected
  [16:16] IWDG_SW 0x1 (0b1)
    `- IWDG enabled by the software, and disabled by hardware
  [17:17] STOP_RST 0x1 (0b1)
    `- Disable
  [18:18] STANDBY_RST 0x1 (0b1)
    `- Disable, entering standby-mode without RST
  [23:22] SRAM_CODE_MODE 0x0 (0b0)
    `- CODE-192KB + RAM-128KB / CODE-128KB + RAM-64KB depending on the chip
DATA: 0xFF00FF00
  [7:0]   DATA0 0x0 (0b0)
  [23:16] DATA1 0x0 (0b0)
WRP: 0xFFFFFFFF
  `- Unprotected
01:30:10 [INFO] Read /tmp/arduino_build_800052/sketch_uno_Blink.ino.elf as ELF format
01:30:10 [INFO] Found loadable segment, physical address: 0x00000000, virtual address: 0x00000000, flags: 0x7
01:30:10 [INFO] Section names: [".init", ".vector", ".text", ".init_array"]
01:30:10 [INFO] Found loadable segment, physical address: 0x00002174, virtual address: 0x20000000, flags: 0x6
01:30:10 [INFO] Section names: [".data"]
01:30:10 [INFO] Firmware size: 9216
01:30:10 [INFO] Erasing...
01:30:10 [INFO] Erased 10 code flash sectors
01:30:11 [INFO] Erase done
01:30:11 [INFO] Writing to code flash...
01:30:11 [INFO] Code flash 9216 bytes written
01:30:11 [INFO] Verifying...
01:30:12 [INFO] Verify OK
01:30:12 [INFO] Now reset device and skip any communication errors
01:30:12 [INFO] Device reset

・プログラム内容は

void setup() {
pinMode(PB5,OUTPUT);
}
void loop() {
digitalWrite( PB5, HIGH );
digitalWrite( PB5, LOW );
}

・結果：PB5の波形周波数は890kHzと私が持っている最速の Arduino DUE-CH340 で240KHZから見ても相当早い。
直接ハードを制御したプログラムへ変更した場合の周波数が楽しみだ。※後で MounRiverStudio により作成した結果 6MHz だった。

なお上記の様に、開発ボートの｢BOOT｣ボタンを押しながら「リセット」ボタンを押さないで『マイコンボードに書き込む』ボタンを押すとUSBディバイスが無いと『エラー』になります。
エラーメッセージ