追加調査で押さえる実務ポイント
CH32V208のpinoutを、MCU package pin、GPIO名、board header番号、software alias、alternate functionに分けて確認するトラブルシューティングガイドです。販売ページや別boardの図を流用せず、現物revisionと公式回路図を照合します。
先に結論
CH32V208C8T6等のpackage pin、WCH LinkW、一般開発boardのsilkscreenは別概念です。USB、Ethernet、BLE、debug pinはexact packageと回路図で確認します。
対応表を作る
| board label | MCU GPIO | package pin | alternate function | voltage domain | source |
|---|---|---|---|---|---|
| 要確認 | 要確認 | 要確認 | 要確認 | 要確認 | schematic/datasheet |
確認順
- 基板表裏のsilkscreenとrevisionを撮影する。
- MCU markingとpackageを確認する。
- official pinout diagramでphysical pinを確認する。
- board schematicでheaderまで信号を追う。
- SDKのboard definitionとaliasを確認する。
- multimeterのcontinuityで必要箇所だけ確認する。
- GPIO outputはseries resistorを入れ、LEDやlogic analyzerで確認する。
pin mux
同じGPIOでもUART、SPI、I2C、timer、USB、debugなど複数機能を持ちます。任意の組合せが使えるとは限りません。peripheral instance、alternate function、clock、package制約を同時に確認します。
revision差
同じ商品名でもregulator、USB connector、crystal、LED pin、boot circuitが変更される場合があります。購入日、seller、board revision、写真を記録し、別revisionでの再現を保証しません。
危険な誤認
- physical pin番号とGPIO番号を同じと思う
- Arduino pin aliasをMCU port名と混同する
- 5V pinを3.3V GPIOへ接続する
- SWD/SWIO pinを一般GPIOとして使う
- boot strap pinの起動時状態を無視する
配線・書き込み・観測の共通手順
- MCU完全型番、board名、revision、搭載moduleを記録する。
- 外付け回路を外し、board単体のLEDまたはUART sampleを動かす。
- power rail、logic voltage、GNDを無通電で確認する。
- official sampleを無改変でbuildし、toolchainとSDK versionを保存する。
- debuggerまたはbootloaderから書き込む。
- UART、USB descriptor、logic analyzerなどで期待結果を観測する。
- reset、電源再投入、cable再接続を試す。
- known-good firmwareへ戻せることを確認する。
検証記録
| 項目 | 記録内容 |
|---|---|
| hardware | MCU型番、board、revision、serial |
| power | 入力、rail、idle・active・peak current |
| software | SDK、commit、compiler、board target |
| programming | probe、boot mode、runner |
| observation | console、USB、signal、電流 |
| result | 成功条件、失敗条件、再現回数 |
| recovery | 復旧imageと手順 |
安全上の注意
絶対最大定格は通常動作条件ではありません。配線変更は無通電で行い、USB VBUS、3.3V rail、外部motor電源、field bus電源を混同しません。評価ボード上のUSB bridge、debugger、LED、regulatorをtarget MCU自身の機能として扱わないでください。
受入基準
- clean workspaceから再buildできる
- 新しい個体へ書き込める
- 電源再投入後も同じ結果になる
- errorを検出し安全状態へ戻る
- 使用pin、電圧、USB roleを説明できる
- 書き込み失敗後に復旧できる
参考リンク
- https://www.wch-ic.com/products/CH32V208.html - 公式製品情報、仕様、SDKまたは開発資料。
- https://www.wch-ic.com/downloads/CH32V208DS0_PDF.html - 公式製品情報、仕様、SDKまたは開発資料。
次に確認するページ
Amazonの検索結果
購入リンクにはアフィリエイトリンクを含む場合があります。仕様・在庫は購入前に販売ページとメーカー公式情報で確認してください。
「CH32V208 development board」で検索した結果です。個別商品の推薦ではありません。型番・仕様・販売元を販売ページで確認してください。
Amazonで検索