沁恆CH32V003(二): Ubuntu20.04 MRS和Makefile開發環境配置
- 2022 年 10 月 31 日
- 筆記
- CH32, CH32V003, Embed/Mobile, RISC-V
目錄
硬體準備
- 沁恆CH32V003F4P6開發板
- WCH-LinkE
MounRiver Studio Community 環境
使用 MounRiver Studio Community IDE 進行開發是比較簡單的一種方式, 前往 //mounriver.com/download 下載 MounRiver_Studio_Community_Linux_V130, 解壓後
- 參照 beforeinstall/start.sh 的內容, 添加動態鏈接庫文件以及udev規則文件
- 運行可執行文件 MounRiver Studio_Community 即可啟動MRS
創建項目
File -> New -> MounRiver Project
- Project Name: 項目名稱,隨便輸入
- Use Default Location: 使用默認的工作空間或另外指定
- 勾選 RISC-V Core, 因為要查找的是 CH32V003, 在下面的選擇框中選中 CH32V003, 然後選擇 CH32V003F4P6
- 其它默認
點擊Finish後, IDE會創建一個帶內容的項目模板
編譯項目
可以直接按 Ctrl + B 或從菜單 Project -> Build All 編譯. 如果提示編譯錯誤, 可能是工具鏈未設置, 需要設置一下工具鏈路徑
全局默認工具鏈路徑設置
菜單 Window -> Preferences -> MCU, 只需要設置和CH32V003相關的工具鏈
- Global OpenOCD Path, 設置為自帶的openocd路徑, 例如 /opt/wch/MRS_Community/toolchain/OpenOCD/bin
- Global RISC-V Toolchains Paths, 設置為自帶的gcc路徑, 例如 /opt/wch/MRS_Community/toolchain/RISC-V Embedded GCC/bin
項目工具鏈路徑設置
Project -> Properties 下可以設置當前項目相關的工具鏈路徑, 條目和全局的一樣.
燒錄
Flash -> Config, 配置燒錄選項
- 點擊第一個圖標查詢編程器狀態
- 如果開啟了讀防寫(底下狀態為綠), 要點擊解鎖圖標解鎖
- 檢查Target中的MCU類型, Target File是否正確
- Options默認全部勾選
應用後, 按F8就會開始燒錄
問題處理
啟動後無創建MounRiver Project的選項
如果將解壓得到的 MRS_Community 目錄修改為其它用戶, 例如將其移動到 /opt 下並 chown -R root:root, 那麼在啟動後, 在 New 菜單中會看不到創建 MounRiver Project 的選項, 是因為有幾個 plugins 的許可權不正確導致, 文件許可權為600, 應該修改為644.
plugins目錄下 com.mounriver 開頭的文件
-rw-r--r-- 1 root root 115170 Sep 20 00:35 com.mounriver.editor.ld_1.8.2.jar
-rw------- 1 root root 581702 Oct 10 19:19 com.mounriver.flash_1.8.2.jar
-rw------- 1 root root 2088946 Oct 10 19:19 com.mounriver.project_1.8.2.jar
-rw-r--r-- 1 root root 141287 Sep 22 2020 com.sun.el_2.2.0.v201303151357.jar
# 執行命令
sudo chmod 644 com.mounriver.*
以及 plugins/org.eclipse.epp.package.embedcdt_4.17.0.20200921-0821 目錄下的幾個png文件
-rw-r--r-- 1 root root 1036 Sep 22 2020 about.properties
-rw------- 1 root root 777 Sep 7 2021 eclipse16.png
-rw------- 1 root root 18913 Sep 7 2021 eclipse256.png
-rw------- 1 root root 1739 Sep 7 2021 eclipse32.png
-rw------- 1 root root 2826 Sep 7 2021 eclipse48.png
-rwxrw-r-- 1 root root 95552 Apr 3 2020 eclipse_lg.png*
-rw-r--r-- 1 root root 10655 Sep 22 2020 intro-eclipse.svg
drwxr-xr-x 3 root root 4096 Sep 22 2020 META-INF/
-rw------- 1 root root 137750 Sep 1 2021 MounRiver.png
drwxr-xr-x 2 root root 4096 Sep 22 2020 org.eclipse.ui.intro.universal.solstice/
# 執行命令
sudo chmod 644 *.png
Makefile, VSCode 環境
如果傾向於使用其它的IDE, 例如VSCode, 則需要使用 Makefile 方式進行配置
- 硬體 依然使用 CH32V003F4P6開發板以及WCH-LinkE,
- 軟體 從//mounriver.com/download下載 MRS_Toolchain_Linux_x64_V1.60.tar.xz, 注意需要使用V1.60, 舊版本不支援CH32V003.
注意: 當前CH32V系列的開發都不能使用公版RISC-V GCC和公版OpenOCD, 因為包含沁恆訂製部分, 未在開源項目主幹中支援.
配置步驟
解壓工具鏈後
- 參照 beforeinstall/start.sh 的內容, 添加動態鏈接庫文件以及udev規則文件
- 將工具鏈移動到合適的位置, 並修改owner為root避免誤修改
導出項目模板
git clone //gitee.com/iosetting/ch32v003-template.git
根據自己本地環境, 修改Makefile中的配置
TOOL_CHAIN_PATH ?= /opt/gcc-riscv/riscv-wch-embedded-gcc-v1.60/bin
OPENOCD_PATH ?= /opt/openocd/wch-openocd-v1.60/bin
編譯和燒錄
# 清空
make clean
# 編譯
make
# 燒錄 = 擦除 + 燒錄 + 重啟運行
make flash
# 擦除
make erase
# 重啟運行
make reset
編譯參數
CH32V003編譯的基本參數如下, 注意 march 和 mabi, 和 CH32V103 是不一樣的, 使用CH32V103參數編譯寫入後不運行, 這些參數是從MRS中實際執行的編譯命令中提取的
CCFLAGS := -march=rv32ec \
-mabi=ilp32e \
-msmall-data-limit=0 \
-msave-restore \
-Os \
-fmessage-length=0 \
-fsigned-char \
-ffunction-sections \
-fdata-sections \
-fno-common \
-Wunused -Wuninitialized -g