第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為對選中工程修改過的部分進行編譯，速度快；重新編譯Rebuild為對選中工程進行全局編譯。

菜單欄詳細功能描述可點擊菜單欄說明查看。

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原理圖如下：