目录

• HC32L110(一) HC32L110芯片介绍和Win10下的烧录
• HC32L110(二) HC32L110在Ubuntu下的烧录
• HC32L110(三) HC32L110的GCC工具链和VSCode开发环境
• HC32L110(四) HC32L110的startup启动文件和ld连接脚本
• HC32L110(五) Ubuntu20.04 VSCode的Debug环境配置

以下介绍Ubuntu下搭建用于HC32L110系列MCU的GCC工具链和VSCode的开发环境.

仓库地址: https://github.com/IOsetting/hc32l110-template

如果转载, 请注明出处.

硬件准备

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/downloads/-/arm-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字节限制.