目录
- 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.xzcd /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 --versionarm-none-eabi-gcc (GNU Toolchain for the Arm Architecture 11.2-2022.02 (arm-11.14)) 11.2.1 20220111Copyright (C) 2021 Free Software Foundation, Inc.This is free software; see the source for copying conditions. There is NOwarranty; 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 filesBUILD_DIR = Build# Link descript file, hc32l110x4.ld or hc32l110x6.ldLDSCRIPT= Libraries/LDScripts/hc32l110x4.ld# ...
编译默认项目
目录 User 下有默认的点灯示例代码, 在上一步修改完Makefile后, 就可以编译了
make cleanmake
如果想看到详细的命令行, 可以用
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 foldersCDIRS:= User \Libraries/CMSIS \Libraries/HC32L110_Driver/src# C source files (if there are any single ones)CFILES :=
其中 CDIRS 用于目录的添加, CFILES 用于单个C源文件的添加.
除此以外, 如果有新增的 include 路径, 需要添加到 INCLUDES 这个变量中
# Include pathsINCLUDES:= Libraries/CMSIS \Libraries/HC32L110_Driver/inc \User
如果编译与预期不符, 在make时增加V=1
查看实际的命令行.
调整编译参数
编译的参数都在 rules.mk 文件中,
# Global compile flagsCFLAGS= -Wall -ggdb -ffunction-sections -fdata-sectionsASFLAGS= -g -Wa,--warn# Arch and target specified flagsOPT?= -OsCSTD?= -std=c99ARCH_FLAGS:= -fno-common -mcpu=cortex-m0plus -mthumb# c flagsTGT_CFLAGS += $(ARCH_FLAGS) $(addprefix -D, $(LIB_FLAGS))# asm flagsTGT_ASFLAGS += $(ARCH_FLAGS)# ld flagsTGT_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字节限制.