RT-Thread-【国产MCU移植】移植RT-Thread到国产芯片HK32F030C8RT-Thread问答社区

【国产MCU移植】移植RT-Thread到国产芯片HK32F030C8

发布于 2021-09-12 16:33:47 浏览：2447 订阅该版

[tocm]

## **一、移植前准备**
- [HK32F030数据手册](http://www.hsxp-hk.com/companyfile/3.html)
- [HK32F030用户手册](http://www.hsxp-hk.com/companyfile/91.html)
- [HKMicroChip.HK32F0xx_DFP](http://www.hsxp-hk.com/companyfile/69.html)
- [HK32F0xx外设库](https://bbs.21ic.com/icview-3040622-1-1.html)
- [rt-thread源码](https://github.com/RT-Thread/rt-thread)
- [rt-thread env工具](https://www.rt-thread.org/page/download.html)
- [formatting工具](https://www.github.com/mysterywolf/formatting)

## **二、移植过程**
### 2.1获取源码
移植完成后需要向RTT提交PR，所以拉取源码前先从rtt官方代码库fork到自己的仓库，然后从自己仓库clone到本地。
创建一个新的分支用于添加bsp

### 2.2添加bsp目录
Cortex内核的MCU移植原理都大同小异，比较容易上手的方式就是找一个比较符合目标芯片的bsp作为参考。我选择作为参考的bsp目录是at32，虽然内核不同于at32的Cortex-M4，但是这个bsp的目录结构比较符合我的审美。
![1b45b3052dd4590a051f9146918767b6.png](https://oss-club.rt-thread.org/uploads/20210912/1b45b3052dd4590a051f9146918767b6.png)

在bsp目录下创建名为hk32的文件夹，下级目录再分别创建hk32f030c8和libraries目录，libraries用于放置通用的外设库和驱动库。

![rt_drivers.png](https://oss-club.rt-thread.org/uploads/20210912/f840ee00c53e7ad1110708037b93c972.png.webp)

hk32f030c8目录下则拷贝at32f403a-start下的所有文件。

### 2.3修改工程文件
修改keil5的工程模板文件template.uvprojx，主要是选择目标芯片
![ee3d35847e22a0c61cf91fe92e8dff0f.png](https://oss-club.rt-thread.org/uploads/20210912/ee3d35847e22a0c61cf91fe92e8dff0f.png)

修改根目录下SConstruct文件，主要是与外设库和驱动库目录有关，使用相对地址即可
```python
SDK_ROOT = os.path.abspath('./')

if os.path.exists(SDK_ROOT + '/libraries'):
    libraries_path_prefix = SDK_ROOT + '/libraries'
else:
    libraries_path_prefix = os.path.dirname(SDK_ROOT) + '/libraries'

SDK_LIB = libraries_path_prefix
Export('SDK_LIB')

# prepare building environment
objs = PrepareBuilding(env, RTT_ROOT, has_libcpu=False)

hk32f0_library = 'HK32F0xx_StdPeriph_Driver'
rtconfig.BSP_LIBRARY_TYPE = hk32f0_library

# include libraries
objs.extend(SConscript(os.path.join(libraries_path_prefix, hk32f0_library, 'SConscript')))

# common include drivers
objs.extend(SConscript(os.path.join(libraries_path_prefix, 'rt_drivers', 'SConscript')))

# make a building
DoBuilding(TARGET, objs)
```

修改board目录下Kconfig、SConscript文件，为了方便使用env工具，相关的菜单脚本和构建脚本文件也要修改
芯片型号及其家族
```
config SOC_HK32F030C8T6
    bool
    select SOC_SERIES_HK32F0XX
    select RT_USING_COMPONENTS_INIT
    select RT_USING_USER_MAIN
    default y
```

启动文件等
```python
# add general drivers
src = Split('''
board.c
msp/hk32_msp.c
''')

path = [cwd]
path += [cwd + '/msp']

startup_path_prefix = SDK_LIB

src += [startup_path_prefix + '/HK32F0xx_StdPeriph_Driver/CMSIS/HK32F0xx/Source/system_hk32f0xx.c']
if rtconfig.CROSS_TOOL == 'gcc':
    src += [startup_path_prefix + '/HK32F0xx_StdPeriph_Driver/CMSIS/HK32F0xx/Source/gcc/startup_hk32f030x4x6x8.s']
elif rtconfig.CROSS_TOOL == 'keil':
    src += [startup_path_prefix + '/HK32F0xx_StdPeriph_Driver/CMSIS/HK32F0xx/Source/ARM/startup_hk32f030x4x6x8.s']
elif rtconfig.CROSS_TOOL == 'iar':
    src += [startup_path_prefix + '/HK32F0xx_StdPeriph_Driver/CMSIS/HK32F0xx/Source/iar/startup_hk32f030x4x6x8.s']
    
CPPDEFINES = ['HK32F030x8']
```

外设库下的SConscript文件
```python
src = Split("""
src/hk32f0xx_adc.c
src/hk32f0xx_crc.c
src/hk32f0xx_dbgmcu.c
src/hk32f0xx_divsqrt.c
src/hk32f0xx_dma.c
src/hk32f0xx_exti.c
src/hk32f0xx_flash.c
src/hk32f0xx_gpio.c
src/hk32f0xx_i2c.c
src/hk32f0xx_iwdg.c
src/hk32f0xx_misc.c
src/hk32f0xx_pwr.c
src/hk32f0xx_rcc.c
src/hk32f0xx_rtc.c
src/hk32f0xx_spi.c
src/hk32f0xx_syscfg.c
src/hk32f0xx_tim.c
src/hk32f0xx_usart.c
src/hk32f0xx_wwdg.c
""")

path = [
    cwd + '/CMSIS/HK32F0xx/Include',
    cwd + '/CMSIS/Core',
    cwd + '/inc',]

CPPDEFINES = ['USE_STDPERIPH_DRIVER']

group = DefineGroup('Libraries', src, depend = [''], CPPPATH = path, CPPDEFINES = CPPDEFINES)
```

### 2.4添加驱动
drv_gpio.c和drv_usart.c，主要是实现向pin、serial设备框架的注册以及底层调用接口的实现。因为外设库语法几乎一致，所以不需要花太多精力。

### 2.5向RT-Thread提交PR
参考[向 RT-Thread 贡献代码](https://www.rt-thread.org/document/site/#/rt-thread-version/rt-thread-standard/development-guide/github/github)
检查代码，需要遵循[RT-Thread 编程风格](https://github.com/RT-Thread/rt-thread/blob/master/documentation/coding_style_cn.md)

完善bsp目录下的readme文档，将代码push到自己的github上，提交PR。