目录
- AIR32F103(一) 合宙AIR32F103CBT6开发板上手报告
- AIR32F103(二) Linux环境和LibOpenCM3项目模板
- AIR32F103(三) Linux环境基于标准外设库的项目模板
Linux 开发环境
使用的 GCC Arm, st-flash 和 JLink 与前一篇相同, 可以参考前一篇的说明
关于 Air32F103-Template
项目地址: https://gitee.com/iosetting/air32f103-template
这是为 GCC Arm 工具链准备的 AIR32F103x 项目开发模板
项目结构
├── Build # 编译结果
├── Examples # 示例代码
│ ├── FreeRTOS # FreeRTOS示例代码
│ └── NonFreeRTOS # 非FreeRTOS示例代码
├── Libraries
│ ├── AIR32F10xLib # AIR32F103外设层库代码
│ │ ├── inc # .h头文件
│ │ ├── lib
│ │ │ └── cryptlib
│ │ └── src # .c源文件
│ ├── CORE # Coretex M 核心外设层源文件
│ ├── Debug # delay和printf支持
│ ├── DeviceSupport # AIR32F103的gcc arm startup文件
│ │ └── startup
│ │ └── arm-gcc
│ ├── FreeRTOS # FreeRTOS 库代码
│ └── LDScripts # 连接脚本
├── Makefile
├── Misc
│ └── flash.jlink # JLink烧录脚本
├── README.cn.md
├── README.md
├── rules.mk # make规则
└── User # 用户项目代码
快速开始
1. 导出项目
git clone https://github.com/IOsetting/hk32f030m-template.git
2. 根据本地环境修改 Makefile
修改 Makefile 设置, 确保 ARM_TOOCHAIN 和 JLINKEXE(或ST_Flash) 指向正确的路径
##### Project #####
# 项目名称
PROJECT ?= app
# 编译结果目录
BUILD_DIR = Build
##### Options #####
# 是否使用 FreeRTOS, y:yes, n:no
USE_FREERTOS ?= n
# 烧录工具, jlink 或 stlink
FLASH_PROGRM ?= stlink
##### Toolchains #######
# 根据本地环境, 设置工具链路径
ARM_TOOCHAIN ?= /opt/gcc-arm/gcc-arm-11.2-2022.02-x86_64-arm-none-eabi/bin
# st-flash 可执行文件路径
ST_FLASH ?= st-flash
# JLinkExe 可执行文件路径和设备类型
JLINKEXE ?= /opt/SEGGER/JLink/JLinkExe
JLINK_DEVICE ?= STM32F103CB
##### Paths ############
# 当前芯片的连接脚本
LDSCRIPT = Libraries/LDScripts/air32f103cbt6.ld
3. 编译默认项目并烧录
# 清理
make clean
# 编译
make
# 带详细输出的编译
V=1 make
# 烧录
make flash
默认的项目会点亮板载的三个LED
示例代码
示例代码位于 Examples 目录下, 项目中的示例代码几乎都是迁移自合宙的Keil项目中的示例代码, 已经在GCC Arm下运行验证过.
如果需要运行示例代码, 先将 User 目录下的文件清空, 将示例代码复制到 User 目录下, make clean清空, 然后重新编译和烧录.
VSCode 配置文件
c_cpp_properties.json 供参考
{
"configurations": [
{
"name": "Linux",
"includePath": [
"${workspaceFolder}/**"
],
"defines": [
"HK32F030MF4P6"
],
"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.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": "build",
"type": "shell",
"command": "make",
"problemMatcher": []
},
{
"label": "clean",
"type": "shell",
"command": "make clean",
"problemMatcher": []
},
]
}
常见问题说明
切换GCC编译器版本, 11.2, 11.3 和 12.2
项目模板测试过的最新的GCC Arm编译器版本为12.2, 对比 11.2 和 11.3, 12.2 编译会带来一些性能提升, 但是检查也更严格, 按11.2和11.3的配置会产生不少warning. 在GCC Arm 12.2编译提示 LOAD segment with RWX permissions 警告 和 GCC Arm 11.3rel1, 12.2编译提示 _close is not implemented and will always fail 中有说明
printf 无法输出浮点数
printf输出浮点数默认是关闭的, 打印浮点无输出. 可以在TGT_LDFLAGS中增加选项 -u _printf_float 开启, 开启后会明显增加二进制程序尺寸.
TGT_LDFLAGS += $(ARCH_FLAGS) -specs=nano.specs -specs=nosys.specs -static -lc -lm \
-u _printf_float \
-Wl,-Map=$(BDIR)/$(PROJECT).map \
-Wl,--gc-sections \
-Wl,--print-memory-usage
开启后, 连接时会检查_getpid(void)和_kill(pid_t pid, int sig)这两个函数是否定义, 如果没定义会报warning.
对FreeRTOS的支持
运行 Examples/FreeRTOS 目录下的例子时, 需要在 Makefile 中开启对 FreeRTOS 的支持, 将需要下面的配置改为y
# Build with FreeRTOS, y:yes, n:no
USE_FREERTOS ?= n
切换不同的MCU型号
Makefile默认配置的是 AIR32F103CBT6 的编译选项, 如果需要切换到CCT6和RPT6, 需要在Makefile中修改两处
# CCT6不用改, RPT6需要修改为 STM32F103RB
JLINK_DEVICE ?= STM32F103CB
...
# 对应的修改为 air32f103cct6.ld 和 air32f103rpt6.ld
LDSCRIPT = Libraries/LDScripts/air32f103cbt6.ld