以下介紹Ubuntu下搭建用於HC32L110系列MCU的GCC工具鏈和VSCode的開發環境. AS06-VTB07H 產品頁鏈接. 這個開發板有新舊兩個版本. 4.0使用的是STM8, 5.0使用的是HC32L110, 現在能買到的都是後者, pin腳全部引出, 有預留燒錄口, 有一個功能按鈕,... ...
目錄
- HC32L110(一) HC32L110晶元介紹和Win10下的燒錄
- HC32L110(二) HC32L110在Ubuntu下的燒錄
- HC32L110(三) HC32L110的GCC工具鏈和VSCode開發環境
以下介紹Ubuntu下搭建用於HC32L110系列MCU的GCC工具鏈和VSCode的開發環境.
硬體準備
JLink-OB
前一篇中已經介紹, 用於Linux環境下燒錄
基於HC32L110系列MCU的開發板
以下是 AS06-VTB07H 產品頁鏈接. 這個開發板有新舊兩個版本. 4.0使用的是STM8, 5.0使用的是HC32L110, 現在能買到的都是後者, pin腳全部引出, 有預留燒錄口, 有一個功能按鈕, 兩個LED, 自帶USB2TTL通信(P01, P02), 非常方便.
下麵的介紹都基於這個開發板. 如果使用其他的板子, GPIO口自己調整一下就可以.
軟體準備
燒錄軟體 JLink
JLink軟體和對應的flash演算法文件, 在前一篇中已經介紹
IDE VSCode
安裝並配置好, 在網上有很多教程.
GCC ARM工具鏈
在GCC ARM網站下載工具鏈接https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/downloads, 然後解壓到合適的目錄
tar xvf gcc-arm-11.2-2022.02-x86_64-arm-none-eabi.tar.xz
cd /opt/gcc-arm/
sudo mv ~/Backup/linux/gcc-arm-11.2-2022.02-x86_64-arm-none-eabi/ .
sudo chown -R root:root gcc-arm-11.2-2022.02-x86_64-arm-none-eabi/
檢查版本
/opt/gcc-arm/gcc-arm-11.2-2022.02-x86_64-arm-none-eabi/bin/arm-none-eabi-gcc --version
arm-none-eabi-gcc (GNU Toolchain for the Arm Architecture 11.2-2022.02 (arm-11.14)) 11.2.1 20220111
Copyright (C) 2021 Free Software Foundation, Inc.
This is free software; see the source for copying conditions. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
示例項目導出和編譯
導出項目
git clone https://github.com/IOsetting/hc32l110-template.git
根據自己的環境參數修改下Makefile
PROJECT ?= app
# 改成本地的工具鏈路徑
ARM_TOOCHAIN ?= /opt/gcc-arm/gcc-arm-11.2-2022.02-x86_64-arm-none-eabi/bin
# 改成本地的JLinkExe的路徑
JLINKEXE ?= /opt/SEGGER/JLink/JLinkExe
# MCU型號, 這個是16K的版本, 如果是32K版本要改成 HC32L110x6, 對應下麵的ld文件也要修改
DEVICE ?= HC32L110x4
# The path for generated files
BUILD_DIR = Build
# Link descript file, hc32l110x4.ld or hc32l110x6.ld
LDSCRIPT = Libraries/LDScripts/hc32l110x4.ld
# ...
編譯預設項目
目錄 User 下有預設的點燈示例代碼, 在上一步修改完Makefile後, 就可以編譯了
make clean
make
如果想看到詳細的命令行, 可以用
V=1 make
燒錄
編譯完成後, 執行下麵的命令燒錄
make flash
如果使用的是 AS06-VTB07H, 燒錄完成後可以看到兩個LED每隔一秒交替閃爍.
配置VSCode開發環境
作為Linux下的生產力工具, VSCode是要用起來的, 開發C語言項目, 需要配置的就是兩個, c_cpp_properties.json 和 tasks.json
首先用VSCode打開項目目錄, C/C++插件未安裝會有提示, 按提示安裝即可.
配置C/CPP: c_cpp_properties.json
快捷鍵Ctrl + Shift + P調出菜單, 輸入 C/C++, 可以看到 C/C++ Edit Configurations (JSON), 回車, 在創建的模板中按以下內容編輯, 路徑換成自己的
{
"configurations": [
{
"name": "Linux",
"includePath": [
"${workspaceFolder}/**"
],
"defines": [],
"compilerPath": "/opt/gcc-arm/gcc-arm-11.2-2022.02-x86_64-arm-none-eabi/bin/arm-none-eabi-gcc",
"cStandard": "gnu99",
"cppStandard": "gnu++14",
"intelliSenseMode": "gcc-arm",
"configurationProvider": "ms-vscode.makefile-tools"
}
],
"version": 4
}
配置Tasks: tasks.json
快捷鍵Ctrl + Shift + P調出菜單, 輸入 Task, 可以看到 Config Task, 回車 -> Create tasks.json from template -> Others, 編輯創建的 tasks.json , 根據自己的習慣添加快捷方式
{
// See https://go.microsoft.com/fwlink/?LinkId=733558
// for the documentation about the tasks.json format
"version": "2.0.0",
"tasks": [
{
"label": "clean, build",
"type": "shell",
"command": "make clean;make",
"problemMatcher": []
},
{
"label": "build, download",
"type": "shell",
"command": "make;make flash",
"problemMatcher": []
},
{
"label": "download",
"type": "shell",
"command": "make flash",
"problemMatcher": []
},
{
"label": "build",
"type": "shell",
"command": "make",
"problemMatcher": []
},
{
"label": "clean",
"type": "shell",
"command": "make clean",
"problemMatcher": []
},
]
}
平時使用時, 用Alt + Shift + F10就可以調出Task菜單, 快速執行編譯和燒錄等操作.
編譯選項
項目中新增代碼目錄和單個C文件
User目錄下的代碼, Makefile已經覆蓋, 會自動添加無需修改 Makefile. 如果新增其他的目錄需要包含整個目錄, 或包含單個源文件, 可以編輯Makefile中的這部分
# C source folders
CDIRS := User \
Libraries/CMSIS \
Libraries/HC32L110_Driver/src
# C source files (if there are any single ones)
CFILES :=
其中 CDIRS 用於目錄的添加, CFILES 用於單個C源文件的添加.
除此以外, 如果有新增的 include 路徑, 需要添加到 INCLUDES 這個變數中
# Include paths
INCLUDES := Libraries/CMSIS \
Libraries/HC32L110_Driver/inc \
User
如果編譯與預期不符, 在make時增加V=1查看實際的命令行.
調整編譯參數
編譯的參數都在 rules.mk 文件中,
# Global compile flags
CFLAGS = -Wall -ggdb -ffunction-sections -fdata-sections
ASFLAGS = -g -Wa,--warn
# Arch and target specified flags
OPT ?= -Os
CSTD ?= -std=c99
ARCH_FLAGS := -fno-common -mcpu=cortex-m0plus -mthumb
# c flags
TGT_CFLAGS += $(ARCH_FLAGS) $(addprefix -D, $(LIB_FLAGS))
# asm flags
TGT_ASFLAGS += $(ARCH_FLAGS)
# ld flags
TGT_LDFLAGS += --specs=nano.specs -mcpu=cortex-m0plus -mthumb -nostartfiles -Wl,--gc-sections -Wl,-Map=$(BDIR)/$(PROJECT).map -Wl,--print-memory-usage
如果要優化編譯的結果大小或執行速度, 需要修改OPT參數, -O0是無優化, -O1是基礎優化, -Os是尺寸壓縮, 具體優化項參考 https://gcc.gnu.org/onlinedocs/gcc/Optimize-Options.html
OPT ?= -Os
其中-ffunction-sections -fdata-sections和-Wl,--gc-sections是非常重要的參數, 如果不使用這些參數, 編譯的結果大概會超出HC32L110的16K位元組限制.
