第2章 開發環境搭建
第2章 開發環境搭建
從本章開始，將正式進入RISC-V MCU的開發之旅。
本章主要講解CH32V307的開發前的準備工作，包括整合開發環境MounRiver Studio（MRS）的安裝與使用說明、模擬除錯工具WCH-Link的簡介。
2.1 MounRiver Studio（MRS）
MounRiver Studio（MRS）是一款基於Eclipse GNU版本開發，面向RISC-V、ARM等核心MCU的整合開發環境，提供專業嵌入式專案所需的開發、除錯、燒錄以及專案管理等功能。
目前MRS免費使用，無需license，不用擔心版權問題。
2.1.1 MRS下載
MRS提供Windows、Linux兩個版本。
官網下載地址：http://www.mounriver.com/download
本教程主要執行環境為Windows，通過點選MounRIver_Studio_Setup_Vxxx.zip下載最新版本，也可點選檢視更多下載歷史版本。
2.1.2 MRS安裝
步驟一：解壓安裝包，雙擊MounRiver_studio_Setup_Vxxx.exe執行安裝，出現如下介面，按照提示，點選 下一步 。
步驟二：點選我接受，同意安裝許可協議。
步驟三：選擇安裝路徑，注意路徑中不要有空格和中文，選擇好路徑後，點選下一步。
步驟四：選擇“開始選單”資料夾，預設不用修改，點選安裝。
步驟五：執行安裝，過程有點漫長，耐心等待即可。
步驟六：完成MRS安裝。點選完成即可。
安裝完成後，桌面會有MRS啟動快捷方式。如下圖所示：
2.1.3 MRS使用說明
這裡只介紹使用MRS開發RISC-V MCU CH32V307過程中常用的操作，詳細的使用說明可檢視幫助文件。
MRS幫助文件開啟方式：MRS選單欄Help -> Help Manual。
2.1.3.1 歡迎頁面
第一次開啟MRS，會進入歡迎頁面，如不需要閱讀，點選左上角Welcome旁的叉叉，即可關閉。
如需再次開啟歡迎頁面，可點選選單欄 Help -> Welcome，即可開啟。
2.1.3.2 選單欄功能說明
常用快捷功能按鈕如下：
其中增量編譯Build
選單欄詳細功能描述可點選選單欄說明檢視。
2.1.3.3 新建工程
（1）點選選單欄 File -> New -> MounRiver Project，新建工程。
（2）配置引數
- Project Name，新建工程的名稱，可自行定義。
- 工程存放路徑，預設使用的路徑為MRS的workspace，取消勾選use default location後，可自定義存放路徑，注意，自定義路徑不要有空格和中文。
- 選擇晶片型號，CH32V307VCT6
- 點選Finish，完成新建工程。
該方法新建的工程為MRS預設提供的模板，後面章節會詳細介紹如何新建自定義模板的工程。
2.1.3.4 開啟工程
方式1：通過MRS新建的工程，都會在工程目錄中，生成以工程名稱命名的.wvproj檔案，雙擊該檔案即可快速開啟該工程。
方式2： 點選MRS選單欄 File -> Load，選擇工程檔案中.project檔案，點選ok，即可開啟工程。
2.1.3.5 快速恢復預設顯示視窗
當不小心，MRS主介面部分視窗隱藏或者位置變化後，可通過選單欄Window -> Reset View to Defaults，在彈出的對話方塊中點選OK，即可快速恢復預設視窗顯示。
2.2 模擬偵錯程式WCH-Link
沁恆RISC-V系列MCU都支援兩線模擬除錯，使用的模擬偵錯程式為WCH-Link。該偵錯程式支援RISC-V和ARM兩種核心的MCU模擬除錯。
目前該偵錯程式處於硬體開源的狀態，主控MCU使用的是沁恆8位增強型MCU CH549，可自行製作或沁恆官方淘寶店購買。
2.2.1 WCH-Link 引腳定義
| 引腳號 | WCH-Link引腳 | 連線目標板引腳 | 說明 |
|---|---|---|---|
| 1 | 5V | MCU 5V電源引腳 | 5V電壓輸出引腳，給目標板供電 |
| 2 | 3.3V | MCU 5V電源引腳 | 3.3V電壓輸出引腳，給目標板供電 |
| 3 | GND | MCU GND引腳 | 電源地 |
| 4 | SWCLK | MCU SWCLK | 兩線模擬中的時鐘訊號引腳 |
| 5 | SWDIO | MCU SWDIO | 兩線模擬中的資料訊號引腳 |
| 6 | RX | MCU UART-TX | WCH-Link CDC串列埠RX引腳 |
| 7 | TX | MCU UART-RX | WCH-Link CDC串列埠TX引腳 |
2.2.2 模式切換
WCH-Link預設是RISC-V模式，該模式下可對沁恆RISC-V系列MCU進行模擬除錯。如需對ARM核心MCU進行模擬除錯，需手動切換模式。不同模式下的WCH-Link在裝置管理器中顯示的裝置型別如下：
| 模式 | 指示燈 | IDE | 支援晶片 |
|---|---|---|---|
| RISC-V | 空閒時藍色指示燈常滅 | MRS | 沁恆RISC-V系列MCU |
| ARM | 空閒時藍色指示燈常亮 | keil / MRS | 支援SWD協議的ARM核心MCU |
模式切換步驟：
步驟一：WCH-Link斷電，將引腳TX與GND短接
步驟二：WCH-Link上電，藍色指示燈發生變化，表示模式切換成功，將TX與GND斷開
後續使用時，WCH-Link將保持該模式，需切模式時，重複步驟一和步驟二。
例如，當前WCH-Link處於RISC-V模式，此時空閒時，藍色指示燈常滅；執行步驟一和步驟二，此時空閒時藍色指示燈常亮，表示已切換至RAM模式。
remark：
- 下載和除錯過程中，藍色指示燈閃爍
- 切換模式後，及時斷開WCH-Link的TX和GND引腳
2.2.3 WCH-Link韌體升級
目前WCH-Link自帶IAP升級，可以通過MRS自動升級韌體。如升級失敗，可手動升級韌體，手動升級方式見WCH-Link使用說明。
WCH-Link使用說明見MRS安裝目錄：MounRiver -> MounRiver_Studio -> ExTool
2.2.4 WCH-Link原理圖
WCH-Link原理圖如下：