RT-Thread国产MCU开发板移植指南—极海APM32F103ZE
来源:MCU开发加油站发布时间:2021-09-23104浏览
询问 AIAPM32F103ZE简介
厂家介绍：珠海极海半导体有限公司，是艾派克微电子旗下全资子公司，其前身为艾派克物联网芯片事业部，总部为纳思达股份有限公司。极海具有20年的集成电路芯片设计经验，是专业的32位工业级通用微控制器、低功耗蓝牙芯片及工业物联网SoC-eSE安全主控芯片产品和方案提供商。
芯片介绍：APM32F103xE系列MCU，基于32位ARM® Cortex®-M3内核，配置增强型外部储存控制器eMMC,并行LCD兼容8080/6800模式，功耗低，容量大，可移植性好。工作温度范围覆盖-40℃~+150℃，符合工业级高可靠性标准。最高工作主频96MHz，支持FPU浮点运算单元，配置增强型外部存储控制器EMMC，支持USB和CAN接口同时使用；集成片上储存器、定时器以及数据转换器等多种外设接口，具有功耗低、容量大、可移植性好、Flash擦除/编程速度快等特点。目前已经通过中国IEC61508 SIL2认证和USB-IF测试，符合工业级高可靠性标准。适用于航模飞机、手持云台、扫码枪、报警器、密码锁、电子秤等领域。
移植过程
1.环境搭建
1.1 硬件准备
APM32F103ZE MINI BROARD，USB转TTL模块，JLINK仿真器。1.2 软件准备编程器，使用JLINK进行下载调试。集成开发环境，安装KEIL5。
串口助手使用的是Tera Term。1.2.1 APM32F103 SDK下载APM32F103ZE SDK包APM32F10x_SDK_V1.5.zip并安装其中的keil支持文件：
1.2.2 RT-thrad下载RT-thread源码。下载RT-Thread env 工具 ：RT-Thread物联网操作系统。2.BSP标准工程生成
其实移植RT-THREAD到一些比较通用的内核还是比较方便的，因为可以投机取巧。那接下来告诉你怎么投机取巧移植RT-Thread到国产MCU。本文只适配KEIL5的环境，GCC、KEIL4和IAR环境不做讲解。
基础模板：首先看看RT-Thread代码仓库中已有的BSP存在同是M3内核的芯片STM32F103。而我要移植的是APM32F103，参照STM32F103的工程，我们新建相似的工程目录。然后就开始增删改查，完成最终的BSP。
2.1 制作通用文件结构
bsp 文件夹目录下新建文件夹 apm32，再在apm32文件夹中新建libraries和apm32f103xe-minibroard两个文件夹。
2.1.1 libraries 文件夹libraries 文件夹下新建 APM32F10x_Library 文件夹以存放APM32F10x系列的libraries，新建 Drivers 文件夹以存放APM32F10x系列的RT-thread 外设驱动。创建Kconfig文件（后续编写文件内容）。
复制我们下载好的 APM32F10x系列的SDK下的 文件夹Library 内容到这里，再在该文件夹下新建SConscript文件。这样子我们的APM32F10x_Library文件夹内容在Drivers文件夹中 新建若干文件如下（后续编写文件内容）：
2.1.2 apm32f103xe-minibroard 文件夹apm32f103xe-minibroard 文件夹下新建applications和board文件夹。
applications 文件夹中新建两个文件，main.c 和 SConscript。文件内容稍后会在后续章节进行编写。
board 文件夹新建文件夹 linker_scripts 及两个文件，board.c 和 board.h。文件内容稍后会在后续章节进行编写。
linker_scripts 文件夹下新建文件link.sct。文件内容稍后会在后续章节进行编写。
2.2 创建工程(创建工程前请安装好APM32F1系列keil支持pack包。)
点击template文件打开工程，将芯片更换为APM32F103ZE。
Device选项卡，选择芯片 APM32F103ZE，点击OK，芯片更换完毕。
Debug选项卡，选择手上的仿真器型号，这里笔者是J-link,选择后点击“Seting”选择下载后的操作选项及下载算法。至此工程创建完毕。下一步我们将基于该工程，编译我们的RT-thread。
board\linker_scripts目录下文件link.sct内容更改为：
; *******************************************
; *** Scatter-Loading Description File generated by uVision ***
; ********************************************
LR_IROM1 0x08000000 0x00080000 { ; load region size_region
ER_IROM1 0x08000000 0x00080000 { ; load address = execution address
*.o (RESET, +First)
*(InRoot$$Sections)
.ANY (+RO)
.ANY (+XO)
}
RW_IRAM1 0x20000000 0x00020000 { ; RW data
.ANY (+RW +ZI)
}
}
在apm32f103xe-minibroard点击鼠标右键，选择“ConEmu Here”，调出命令行窗口输入“scons --target=mdk5”后按回车，生成MDK5工程。
3.BSP驱动文件编写及下载
要完成RT-thread适配，各种驱动及系统运行前的初始化必不可少，下面我们开始编写外设驱动及系统时钟初始化。我们点击上一章节生成的工程“project.uvprojx”，查看一下我们需要编写的文件。
3.1 Pin 驱动
为了跟其他rt--thread工程一样用统一的方法控制GPIO，移植PIN功能很有必要。关键是要实现好IO port和pin的映射关系，中断的映射关系。这里就不展开文件drv_gpio.c/h文件的编写工作了。大家可直接查看源码。
可参照APM32的官方例程，对照RT-thread底层接口完成，这里drv_usart.c/h也不展开。大家可直接查看源码。
\ | /
- RT - Thread Operating System
/ | \ 4.0.4 build Aug 20 2021
2006 - 2021 Copyright by rt-thread team
msh >
新闻来源：MCU开发加油站，文中所述为作者独立观点，不代表icspec立场。更多精彩资讯请下载icspec App。如对本稿件有异议，请联系微信客服specltkj。
