HK32F030MF4P6的Linux GCC工具链开发环境

HK32F030MF4P6简介

航顺的 HK32F030MF4P6, TSSOP20封装,


Arm Cortex M0 内核, 内建32MHz时钟, 16K Flash, 2K RAM(实际上可用的有4K).
这个型号的目的应该是硬件替换 STM8S003, 管脚和 STM8S003 兼容(和 STM32F030 兼容的型号是 HK32F030F4P6). HK32F030MF4P6 可能是当前市场上最便宜的 Cortex M0 芯片了, 单价0.9元不到. 一个32位的Arm M0芯片, 烧录能用普通编程器, 参数也还可以, 常用的外设I2C, SPI, UART, PWM, ADC都有, 甚至还有I2S, 性价比相当不错.

合宙也在放风要出1元的M0, 配置4K RAM, 256K Flash, M0这个级别很快就会进入一元的市场, 8bit系列按现在的价格, 如果不降到比M0低, 可能只剩下存量项目和教学用途了.

项目模板地址:

    GitHub: https://github.com/IOsetting/hk32f030m-template
    Gitee: https://gitee.com/iosetting/hk32f030m-template

相关资料下载:

    HK32F030Mxx系列开发资料 下载地址 https://ifxz.lanzoui.com/b015xbcoh 密码:fqnv
    航顺MCU相关软件 下载地址 https://ifxz.lanzoui.com/b015ynwri 密码:ajnh

相关链接

    CMake项目 https://github.com/monoliths-uni/HK32F030MXX_CMAKE_PRO
    Nerd Ralph 对 HK32F030MF4P6 的hack记录
        http://nerdralph.blogspot.com/2020/12/trying-to-test-ten-cent-tiny-arm-m0-mcu.html
        http://nerdralph.blogspot.com/2021/01/trying-to-test-ten-cent-tiny-arm-m0-mcu.html
        https://github.com/nerdralph/HK32F030M
    JLink 设备支持 https://wiki.segger.com/HK32F030xx
    国产替代 MCU 踩坑记 https://xw.qq.com/cmsid/20210402A015N900

HK32F030MF4P6 的外设库

对比 HK32F030M 的外设库和 STM32F0xx_StdPeriph_Lib_V1.5.0, 格式几乎是照抄的, 定义前者比后者有一些缩水而已, 因为端口和功能上确实少一些. 所以熟悉 STM32F0 的人很容易上手. 相比较之前介绍的华大 HC32 系列, HC32 这个系列就有很明显的 STC 寄存器风格, 和 STM 不是一条路线.

Linux GCC Arm Embedded 开发环境

Windows下的开发环境已经有很多资料了, 前面的资料下载里有很详细的文档. 这里主要介绍一下 Linux (再准确点, Ubuntu) 下的开发环境. 以下介绍 HK32F030MF4P6 这个芯片使用 Linux GCC Arm Embedded 工具链的开发环境.

硬件环境

    带 HK32F030MF4P6 的开发板. 这个芯片不需要外围元件, 直接用 TSSOP20 转接板接出即可
    JLink OB, 最常见最便宜的那种 JLink 烧录器

JLink接线

## JLINK
VCC -> #9  VCC
GND -> #7  GND
CLK -> #11
SWD -> #2

软件环境
烧录软件 JLink

JLink7.70 已经内建对 HK32F030M 系列的支持, 安装后直接可用
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.

HK32F030M外设库

从 https://bbs.21ic.com/icview-3236132-1-1.html 下载, 需要其中的外设库.
示例项目导出和编译

导出项目

git clone https://github.com/IOsetting/hk32f030m-template.git

    1

将下载的外设库放到 Libraries/HK32F030M_Driver 目录下

复制

根据自己的环境参数修改 Makefile



PROJECT     ?= app

# path to gcc arm (or should be specified in PATH)

ARM_TOOCHAIN  ?= /opt/gcc-arm/gcc-arm-11.2-2022.02-x86_64-arm-none-eabi/bin

# path to JLinkExe (or should be specified in PATH)

JLINKEXE    ?= /opt/SEGGER/JLink/JLinkExe

# MCU type: HK32F030MD4P6, HK32F030MF4U6, HK32F030MF4P6 or HK32F030MJ4M6

DEVICE      ?= HK32F030MF4P6

# The path for generated files

BUILD_DIR     = Build

项目中带了一个LED Blink的演示, 接线

复制

## LED

LED1 -> #18 PD1

LED2 -> #17 PC7

LED3 -> #6  PA2

编译

make clean
make

    1
    2

烧录

make flash

项目模板目录结构

项目模板结构

复制

├── Build                       # 编译结果文件目录

├── Examples                    # 示例代码

├── flash.jlink                 # JLink 下载脚本

├── Libraries

│   ├── CMSIS

│   ├── Debug                   # SysTick 延时函数, printf 支持

│   ├── HK32F030M_Driver        # MCU 外设库

│   └── LDScripts

├── LICENSE

├── Makefile                    # Make 配置

├── README.md

├── rules.mk                    # Makefile 预设的编译规则

└── User                        # 用户应用代码

其中并未包含外设库, 和STM32的太像了, 放上去感觉不妥, 怕有版权问题, 还是删掉了. 自己下载也很方便.

编译参数

rules.mk 中, 预设的包含文件和目录为

复制

# C source folders

CDIRS := User \

    Libraries/CMSIS/HK32F030M/Source \

    Libraries/HK32F030M_Driver/src \

    Libraries/Debug

# C source files (if there are any single ones)

CFILES := 



# ASM source folders

ADIRS := User

# ASM single files

AFILES  := Libraries/CMSIS/HK32F030M/Source/startup_hk32f030mf4p6.s



# Include paths

INCLUDES  := Libraries/CMSIS/CM0/Core \

      Libraries/CMSIS/HK32F030M/Include \

      Libraries/HK32F030M_Driver/inc \

      Libraries/Debug \

      User

其中 CDIRS, ADIRS, INCLUDES 对应的都是目录, CFILES 和 AFILES 对应的是单独的源文件.
如果引入其它的库或者源文件, 对应修改这部分即可.

编译参数如下所示
# 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-m0 -mthumb

### c flags ###
TGT_CFLAGS  += $(ARCH_FLAGS) $(addprefix -D, $(LIB_FLAGS))

### asm flags ###
TGT_ASFLAGS += $(ARCH_FLAGS)

### ld flags ###
TGT_LDFLAGS += --specs=nosys.specs -mcpu=cortex-m0 -mthumb -Wl,--gc-sections -Wl,-Map=$(BDIR)/$(PROJECT).map -Wl,--print-memory-usage
# Use newlib-nano instead of newlib for smaller flash size
TGT_LDFLAGS += --specs=nano.specs
# Exclude standard initialization actions, when __libc_init_array exists, this should be omit, \
   otherwise it will generate "undefined reference to `_init'" error. \
   **Remove** `bl __libc_init_array` from startup.s if you want to enable this.
# TGT_LDFLAGS += -nostartfiles

因为使用了__libc_init_array, 默认不使用-nostartfiles, 如果取消注释, 需要到 startup_hk32f030mf4p6.s 中删除这行, 否则会报错.

bl __libc_init_array

Startup 和 LD 代码

startup_hk32f030mf4p6.s 移植自 STM32F0 的 startup 代码, 没有什么特别的, 中断向量和手册是一致的. LD文件中

复制

MEMORY

{

  RAM (xrw)      : ORIGIN = 0x20000000, LENGTH = 4K

  FLASH (rx)     : ORIGIN = 0x08000000, LENGTH = 16K

}