sync mdk pack and cubemx pack develop by linwei

sync mdk pack and cubemx pack develop by linwei

tools/mdk_pack/Documentation/README.md

@@ -0,0 +1,908 @@
+![](media/354799faf95c55a28fe89a774163e7c7.png)
+
+# 基于MDK开发的TencentOS-Tiny Software Pack
+
+TencentOS-Tiny software package based on MDK development
+
+[(English Documents Available)](README_EN.md)
+
+2021/9/3
+
+东南大学
+
+导师：汪礼超
+
+学员：崔林威
+
+Email：1797878653@qq.com
+
+<https://github.com/OpenAtomFoundation/TencentOS-tiny>
+
+目录
+
+[1、ARM软件包介绍](#1arm软件包介绍)
+
+[1.1 软件包简介](#11-软件包简介)
+
+[1.2 软件包开发](#12-软件包开发)
+
+[1.2.1 软件包开发过程](#121-软件包开发过程)
+
+[1.2.2 PDSC文件的编写](#122-pdsc文件的编写)
+
+[1.2.3 生成软件包](#123-生成软件包)
+
+[2、TencentOS-tiny软件包](#2tencentos-tiny软件包)
+
+[2.1 软件包内容](#21-软件包内容)
+
+[2.2 软件包安装](#22-软件包安装)
+
+[3、软件包测试](#3软件包测试)
+
+[3.1 ARM内核移植TencentOS tiny软件包](#31-arm内核移植tencentos-tiny软件包)
+
+[3.2 STM32不依赖裸机工程移植](#32-stm32不依赖裸机工程移植)
+
+[3.3 单片机裸机工程移植](#33-单片机裸机工程移植)
+
+[4、总结](#4总结)
+
+[5、开发参考](#5开发参考)
+
+[6、附录-移植配置参考](#6附录-移植配置参考)
+
+[6.1 MDK5.14版本移植到ARM内核](#61-mdk514版本移植到arm内核)
+
+[6.1.1 Cortex-M0内核移植](#611-cortex-m0内核移植)
+
+[6.1.2 Cortex-M0+内核移植](#612-cortex-m0内核移植)
+
+[6.1.3 Cortex-M3内核移植](#613-cortex-m3内核移植)
+
+[6.1.4 Cortex-M4内核移植](#614-cortex-m4内核移植)
+
+[6.1.5 Cortex-M7内核移植](#615-cortex-m7内核移植)
+
+[6.2 MDK5.14版本移植到基于ARM内核的芯片](#62-mdk514版本移植到基于arm内核的芯片)
+
+[6.2.1 移植到stm32f103c8芯片](#621-移植到stm32f103c8芯片)
+
+[6.2.2 移植到stm32f767igt芯片](#622-移植到stm32f767igt芯片)
+
+[6.3
+MDK5.30和MDK5.35版本移植（Cortex-M0+、0、3、4、7内核和芯片）](#63-mdk530和mdk535版本移植cortex-m00347内核和芯片)
+
+[6.4
+MDK5.30和MDK5.35版本移植（Cortex-M23、33）](#64-mdk530和mdk535版本移植cortex-m2333)
+
+[6.4.1 Cortex-M23内核移植](#641-cortex-m23内核移植)
+
+[6.4.2 Cortex-M33内核移植](#642-cortex-m33内核移植)
+
+# 1、ARM软件包介绍
+
+## 1.1 软件包简介
+
+在进行嵌入式软件开发时，ARM为我们提供了软件包功能，能够将软件算法等模块进行集成封装，从而方便第三方用户使用。ARM软件包能够为微控制器设备和开发板提供支持，包含软件组件（Software
+Component）如驱动程序和中间件，还可以包含示例项目和代码模板等，主要有以下类型的软件包：
+
+(1) 器件系列包（Device Family
+Pack）：由硅供应商或工具供应商生成，为特定的目标微控制器创建软件应用提供支持；
+
+(2) 板级支持包（Board Support
+Pack）：由电路板供应商发布，为安装在电路板上的外围硬件提供软件支持。
+
+(3) CMSIS软件包：由ARM提供，包括对CMSIS核心、DSP和RTOS的支持；
+
+(4) 中间件包（Middleware
+Pack）：由芯片供应商、工具供应商或第三方创建；通过提供对常用软件组件（如软件堆栈、特殊硬件库等）的软件集成，从而减少开发时间；
+
+(5) 内部组件（In-house components）：由工具用户开发，用于内部或外部分发。
+
+软件组件包括以下几部分：
+
+(1) 源代码、库、头文件/配置文件和文档；
+
+(2) 完整的示例项目，展示了软件组件的使用，可以下载并在评估硬件上执行；
+
+(3) 代码模板，方便使用软件组件。
+
+一个完整的软件包是一个ZIP文件，包含所有需要的软件库和文件，以及一个包含软件包所有信息的包描述文件（PDSC文件），软件包的结构是在CMSIS中定义的(<http://www.keil.com/CMSIS/Pack>)。
+
+## 1.2 软件包开发
+
+### 1.2.1 软件包开发过程
+
+软件包的开发过程相当于完成了一项产品的制作，因此引入产品生命周期管理（PLM）的概念，PLM包括以下四个阶段：（1）概念的产生，基于软件包需求进行产品定义，并创建第一个功能原型；（2）设计，根据技术特征和要求，进行原型测试和产品的实施，通过广泛的测试验证产品的功能与规格；（3）发布，产品被制造出来并推向市场；（4）服务，对产品的维护，包括对客户的支持，最后不断优化，结束产品的周期。
+
+在制作软件包时，主要面临以下几个过程：
+
+![](media/b2be2d798f47f13077e4eafee94fad29.png)
+
+图1.1 软件包开发流程
+
+首先，根据特定组件生成软件包即根据需求将相应的头文件、库文件等软件组件利用PDSC文件进行组织，在组织完成后即可利用软件包生成工具生成对应版本的软件包，然后对新生成的软件包进行测试，给出示例测试程序，再将其包含如PDSC文件中，最后经测试完成后生成最终的软件包。
+
+### 1.2.2 PDSC文件的编写
+
+PDSC文件时基于可扩展标记语言（XML）进行编写的，能够将软件包包含的各个模块按照特定的格式组织起来，接下来按照PDSC文件的结构对文件的编写进行详细介绍：
+
+首先是PDSC文件的开头，前两句是声明为XML格式，它是在MDK中的PACK.xsd文件定义的，所以不用修改；\<name\>和\<vendor\>标签定义了软件包的基本内容，也用于PACK文件的文件名，故该PDSC文件应命名为Tencent.TencentOS-tiny.pdsc；\<
+description
+\>标签描述了软件包的信息，它将显示在包安装程序中；\<url\>标签可以包含一个带有软件包下载链接的网址，方便用户下载；\<
+license \>标签包含了用户使用该软件包时需要遵守的协议，\< supportContact
+\>标签表示软件包的支持人员联系方式，可以提供一个电子邮件地址或网页URL。如图1.2为下列代码对应的软件包界面。
+
+\<?xml version="1.0" encoding="utf-8"?\>
+
+\<package schemaVersion="1.0"
+xmlns:xs=<http://www.w3.org/2001/XMLSchema-instance>
+xs:noNamespaceSchemaLocation="PACK.xsd"\>
+
+\<name\>Tencent\</name\>
+
+\<description\>Description of your pack\</description\>
+
+\<vendor\>TencentOS-tiny\</vendor\>
+
+\<url\>[https://github.com/OpenAtomFoundation/TencentOS-tiny\</url](https://github.com/OpenAtomFoundation/TencentOS-tiny%3c/url)\>
+
+\<license\>LICENSE.txt\</license\>
+
+\<supportContact\>…\</supportContact\>
+
+![](media/d014da7b13995d39b87cefa44a147e03.png)
+
+图1.2 程序对应的软件包
+
+接下来是PDSC文件的各个模块，\<releases\>标签定义了软件包的版本，开发者可以在版本更新时在此进行标注，从而在生成软件包时，系统会自动生成最新版本的软件包；
+
+\<releases\>
+
+\<release version=**"1.0.1"**\>
+
+Sep/3/2021, version name
+
+\</release\>
+
+\<release version=**"1.0.0"**\>
+
+Sep/1/2021, version name
+
+\</release\>
+
+\</releases\>
+
+\<taxonomy\>标签用于定义每个组件的description，如图1.3所示，通过下列代码中的Cclass、Cgroup和Csub来确定description所在的位置，doc用于指定description文件（也可以不加），然后添加description的名字。
+
+\<taxonomy\>
+
+\<description Cclass="TencentOS tiny" Cgroup="xx" Csub="xx"
+doc="examples/index.html"\>TencentOS tiny\</description\> \<!—添加网页功能 --\>
+
+\</taxonomy\>
+
+![](media/814a3eecfc04f2bbc24108cedce23ebf.png)
+
+图1.3 \<taxonomy\>标签
+
+\< keywords
+\>标签定义了软件包的关键词，在ARM官网下载软件包时可利用关键词搜索到需要的软件包。
+
+\<keywords \>
+
+\<keyword\>Tencent\</keyword\>
+
+\</keywords \>
+
+\< requirements
+\>标签定义了软件包的关联安装需求，即在安装本软件包时，还需要在网上安装其他包（网址：MDK5
+Software Packs (keil.com)），例如下面的定义则需要我们安装ARM的CMSIS5.7.0软件包。
+
+\<requirements\>
+
+\<packages\>
+
+\<package vendor="ARM" name="CMSIS" version="5.7.0"/\>
+
+\</packages\>
+
+\</requirements\>
+
+接下来是\<conditions\>标签，该标签在设计\<components\>时使用，用以说明软件包中各个组件的依赖关系，即使用本组件还需要选择其他组件。在该标签下可以定义多个condition，每个condition可以定义多个条件。其中\<conditions
+id\>表示条件名，\<description\>为条件信息，然后便是定义的条件，其中\<accept\>表示该条件时可选的，当同时存在多个\<accept\>时，用户需要至少满足其中一个条件才可以使用；\<require\>表示该条件是必选的，否则便无法使用相应的组件。在条件内部，包含一些特定的指示性语法，如果在设计\<component\>的时候开发者选择了名为Cortex_M0的条件，那么用户在使用该\<component\>时，则需要遵守条件要求：其中\<accept
+Dvendor="ARM:82" Dname="ARMCM0"/\>表示用户选择ARM-Cortex
+M0内核时才会触发该条件，\<require condition="condition id
+"/\>为条件嵌套，表示用户还需要满足嵌套条件对应的要求，\<require
+Cclass="TencentOS tiny" Cgroup="kernel"
+Csub="core"/\>表示用户还需要选择core组件。
+
+\<conditions\>
+
+\<condition id="Cortex_M0"\>
+
+\<description\> Cortex-M0\</description\>
+
+\<accept Dvendor="ARM:82" Dname="ARMCM0"/\>
+
+\<require condition="condition id "/\>
+
+\< require Tcompiler="ARMCC"/\>
+
+\<require Cclass="TencentOS tiny" Cgroup="kernel" Csub="core"/\>
+
+\</condition\>
+
+\<condition id=" condition_2 "\>
+
+\<description\>\</description\>
+
+\<!-- 第二个condition的内容 --\>
+
+\</condition\>
+
+\</conditions\>
+
+然后是\<components\>标签，该标签描述了软件包包含的所有文件，在编写该标签下的程序时，需要按照文件类别将文件进行划分，在下列代码中，定义了一个Keil::
+TencentOS tiny::
+arch::arch的\<component\>，\<description\>为该组件的信息，具体如图1.4所示。
+
+![](media/df78bafba8926434183546dce81e2926.png)
+
+图1.4 \<component\>定义界面
+
+\<components\>
+
+\<component Cvendor="Keil" Cclass="TencentOS tiny" Cgroup="arch" Csub="arch"
+Cversion="1.0.1" condition=" condition id"\>
+
+\<description\> description \</description\>
+
+\<files\>
+
+\<file category="doc" name="Documentation/General/html/driver_I2C.html"/\>--\>
+
+\<file category="include" name="arch/arm/arm-v7m/common/include/"/\>
+
+\<file category="header" name="arch/arm/arm-v7m/cortex-m0+/armcc/port.h"/\>
+
+\<file category="header" name="arch/arm/arm-v7m/cortex-m0+/armcc/port_config.h"
+attr="config"
+
+version="1.1.0"/\>
+
+\<file category="source" name="arch/arm/arm-v7m/common/tos_cpu.c"/\>
+
+\</files\>
+
+\</component\>
+
+\</components\>
+
+condition=" condition
+id"即为上述介绍的\<condition\>标签，从而用户在使用该组件时，还需要满足condition所要求的依赖组件。另外，在定义某一个\<component\>时，需要按照上面程序的\<files\>…\</files\>语法进行文件添加，其中file
+category的定义如表1-1所示，在name中可以添加文件路径和具体的某个文件，在软件包中，我们添加的文件默认是不可编辑的，为了方便用户对文件进行进行配置，我们需要添加attr="config"属性，并可通过version更新不同版本的文件。
+
+表1-1 file category定义
+
+| category | 含义                         |
+|----------|------------------------------|
+| doc      | 文件，可以是网页或者其他链接 |
+| include  | 包含某一个路径下的所有头文件 |
+| header   | 包含某路径下的具体头文件     |
+| source   | .c源文件                     |
+
+为了使我们设计的软件包能够适配不同的内核，即在使用软件包时与用户ARM核不一致的文件都不出现，可以按如下步骤进行\<files\>的添加：（1）在condition条件中，加入\<require
+Dvendor="ARM:82" Dname="ARMCM0"/\>这样的程序，该程序表示需要用户选择ARM
+Cortex-M0内核才会触发该条件；（2）在添加\<files\>时，我们可以将针对不同内核，同一类型文件的Cgroup和Csub保持同样的名字，并添加上（1）中定义的condition，这样用户选择不同内核时，将只会出现与用户内核一致的文件。
+
+同时，如果需要在PDSC文件中定义多个软件包，可以采用下列代码结构，其中每一个\<bundle\>标签定义了一个软件包。
+
+\<components\>
+
+\<bundle Cbundle="MDK-ARM" Cclass="TencentOS tiny" Cversion="1.0.0"\>
+
+\<description\>TencentOS tiny\</description\>
+
+\<doc\>examples/index.html\</doc\> \<!—添加网页功能 --\>
+
+\<component
+
+\<!-- 组件内容 --\>
+
+\</component\>
+
+\</bundle\>
+
+\<bundle Cbundle="MDK-ARM" Cclass="TencentOS tiny" Cversion="1.0.0"\>
+
+\<description\>TencentOS tiny\</description\>
+
+\<doc\>examples/index.html\</doc\>
+
+\<component
+
+\<!-- 组件内容 --\>
+
+\</component\>
+
+\</bundle\>
+
+\</components\>
+
+另外，PDSC文件还可以包含\<devices\>、\<apis\>、\<boards\>和\<examples\>，这些为ARM公司或者其他器件、开发板厂商提供，为针对器件、api库文件、板级和相应的示例文件，具体可以参阅ARM
+CMSIS的软件包。
+
+最后，PDSC文件后还需要在最后加上\</package\>，表示该文件的结束，从而完成PDSC文件的编写。
+
+### 1.2.3 生成软件包
+
+在完成PDSC文件的编写后，为了生成最终的软件包，还需要准备如图1.5所示的3个文件，其中PackChk.exe用于验证软件包包含的文件是否都存在，即是否完整；gen_pack.bat为Windows批处理文件，需要我们对文件中的路径进行修改，并用于生成软件包；PACK.xsd是schema，主要用来制定XML规范，用以验证我们编写的PDSC文件。另外，还需要准备7-Zip
+File Manager软件，用于对文件进行压缩，制作集成的软件包。
+
+![](media/fb7fd672372ec80d8f841631a36dbb3f.png)
+
+![](media/4026d5722bcff6998f4d25091cfe7b7e.png)
+
+![](media/41836625eb0ccd3daf48cabd4ea2b5a1.png)
+
+图1.5 生成软件包所需的软件配置
+
+首先利用记事本或Notepad++打开gen_pack.bat，对以下几个地方需要修改，如表1-2所示：
+
+SET ZIPPATH=C:\\Program Files\\7-Zip
+
+SET RELEASE_PATH=..\\Local_Release
+
+SET PACK_VENDOR=Tencent
+
+SET PACK_NAME=TencentOS-tiny
+
+SET PACK_FOLDER_LIST=arch osal kernel examples
+
+SET PACK_FILE_LIST=%PACK_VENDOR%.%PACK_NAME%.pdsc README.md LICENSE.txt
+
+表1-2 gen_pack.bat修改内容
+
+| 代码                 | 含义                             |
+|----------------------|----------------------------------|
+| SET ZIPPATH          | 7-Zip File Manager软件的安装路径 |
+| SET RELEASE_PATH     | 生成的软件包路径，为相对路径     |
+| SET PACK_VENDOR      | PDSC文件中的\<vendor\>标签       |
+| SET PACK_NAME        | PDSC文件中的\<name\>标签         |
+| SET PACK_FOLDER_LIST | 软件包包含文件所在路径           |
+| SET PACK_FILE_LIST   | README.md LICENSE.txt所在路径    |
+
+修改完毕gen_pack.bat后，便可以制作软件包了，首先利用cmd打开电脑的命令行界面，执行cd命令转到gen_pack.bat所在的路径，然后输入gen_pack.bat点击enter，如图1.6所示，gen_pack.bat会按照顺序压缩文件，然后读取PDSC文件，检查数据完整性和文件依赖是否完整，然后生成软件包，当提示gen_pack.bat
+completed sucessfully后就完成了软件报的创建。
+
+![](media/b7e362eb1bc37bc91eb9d9af5bb6bd37.png)
+
+![](media/98771c2e311304bce0f8a7710e1a2629.png)
+
+图1.6 软件包生成界面
+
+此时在Local_Release路径下，可以看到生成的软件包。
+
+![](media/40a428bcdc26b9aaeafdc0b7da33621c.png)
+
+图1.7 软件包
+
+# 2、TencentOS-tiny软件包
+
+腾讯物联网操作系统（TencentOS
+tiny）是腾讯面向物联网领域开发的实时操作系统，具有低功耗，低资源占用，模块化，可裁剪等特性。TencentOS
+tiny提供了最精简的 RTOS 内核，内核组件可裁剪可配置，可灵活移植到多种终端 MCU
+上。而且，基于RTOS内核，提供了 COAP/MQTT/TLS/DTLS
+等常用物联网协议栈及组件，方便用户快速接入腾讯云物联网通信 IoT
+Hub。同时，TencentOS tiny
+为物联网终端厂家提供一站式软件解决方案，方便各种物联网设备快速接入腾讯云，可支撑智慧城市、智能水表、智能家居、智能穿戴、车联网等多种行业应用。
+
+因此，为了有效减少开发人员在移植TencentOS
+tiny到ARM内核单片机上的开发时间，本文基于MDK完成了第三方TencentOS Tiny
+pack和软件包的封装，能够使用MDK pack直接生成适合不同MCU的TencentOS Tiny工程。
+
+## 2.1 软件包内容
+
+结合TencentOS tiny的算法架构，本文设计的软件包包括如表2-1所示的内容：
+
+表2-1 软件包内容
+
+| 内容     | 功能                                                                                                                          |                                              |
+|----------|-------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------|
+| arch     | 包括TencentOS-tiny\\arch\\arm下内核为Cortex-M0+、Cortex-M0、Cortex-M3、Cortex-M4、Cortex-M7、Cortex-M23、Cortex-M33的arch文件 |                                              |
+| kernel   | 包括TencentOS-tiny\\kernel下的core、hal路径中的文件、tos_config文件                                                           |                                              |
+| cmsis_os | 对应TencentOS-tiny\\osal\\cmsis_os的文件                                                                                      |                                              |
+| example  | helloworld_main                                                                                                               | 用于测试软件包的main文件                     |
+|          | mcu_it.c                                                                                                                      | 移植软件包时需要按照该文件对中断函数进行修改 |
+|          | mcu_platform.h                                                                                                                | 用户可在此文件在添加对应单片机的头文件       |
+
+软件包具有以下功能：
+
+（1）软件包针对ARMCortex-M0+、Cortex-M0、Cortex-M3、Cortex-M4、Cortex-M7、Cortex-M23和Cortex-M33内核进行了TencentOS
+tiny软件的封装，用户在安装软件包后能够快速将TencentOS tiny相应内核的Keil工程中；
+
+（2）软件包能够自动适应用户所选的内核，arch文件能够根据内核自动显示，从而方便用户使用；
+
+（3）用户在勾选一个组件时，软件包会自动提示还需要勾选其他模块，并可利用界面中的Resolve一键勾选，防止遗漏；
+
+（4）用户可自主修改对应内核的tos_config文件，对TencentOS tiny的功能进行裁剪。
+
+## 2.2 软件包安装
+
+接下来介绍Tencent.TencentOS-tiny软件包的安装，首先双击图1.5中的软件包，然后进入安装界面，如图2.1(a)，点击I
+agree to all the terms of the preceding License
+Agreement，再点击next进行安装，安装完成界面如图2.1(b)所示；
+
+![](media/a76212fa3a130d0aa42ed0d5aa3d1a9d.png)
+![](media/4e0b4c8cff17038a1c0ca9c35a7093bd.png)
+
+(a) (b)
+
+图2.1 安装界面
+
+此时软件包已经安装到Keil 5之中，打开Keil 5软件，并点击Pack
+Installer图标，可以进行不同软件包版本的安装与移除：
+
+![](media/b88ceffb6b7e01b67048bc376df85b94.png)
+
+图2.2 Pack Installer界面
+
+接下来就可以安装Tencent.TencentOS-tiny软件包中的组件，点击Manage Run-Time
+Environment图标，对需要从软件包中移植的文件进行勾选，如图2.3所示，如果有依赖可以点击Resolve进行一键安装。
+
+![](media/da8c2b1d2bbe5a9155ac6f1044c9086c.png)
+
+图2.3 Manage Run-Time Environment界面
+
+# 3、软件包测试
+
+## 3.1 ARM内核移植TencentOS tiny软件包
+
+首先在[MDK5 Software Packs
+(keil.com)](https://www.keil.com/dd2/pack/#!#eula-container)下载安装ARM
+CMSIS-5.7.0软件包，以便在不同内核下测试本软件包。
+
+![](media/66abeba588010af544fa689a4d5687fc.png)
+
+图3.1 ARM CMSIS-5.7.0软件包
+
+在安装完软件包后，以ARM
+Cortex-M3内核为例对软件包进行移植，并进行编译，首先利用Keil5-5.30版本软件新建工程，并选择ARMCM3，如图3.2所示，然后按照图3.3勾选相应的TencentOS-tiny组件和Cortex-M3内核文件，可以看到arch和tos_config都已经根据内核进行了自动适配。
+
+![](media/a644695d0639cedad43437d0daf55c84.png)
+
+图3.2勾选内核
+
+![](media/37ddbba2c87e25f8e8c75d19b63eb9bf.png)
+
+图3.3勾选组件
+
+接下来点击Options for target，选中默认编译版本5，然后选择C99 mode。
+
+![](media/1873eb5d1431042f0de2ffed6bff6c04.png)
+
+![](media/d486810db3aa3845008f5a9a423c77ef.png)
+
+图3.4 Options for target
+
+然后在mcu_platform.h中添加\#include "ARMCM3.h"和\#include "core_cm3.h"头文件。
+
+![](media/9a97ba66dcac835f6df16d47370855df.png)
+
+图3.5 添加对应内核的头文件
+
+最后点击Build图标进行测试，如图3.6所示：
+
+![](media/589898df2b1bef2552e3d8ae3af98251.png)
+
+图3.6 编译测试
+
+与之类似，如果要在ARM
+Cortex-M4内核下对本软件包进行测试，只需要在上述步骤修改mcu_platform.h中的头文件为\#include
+"ARMCM4.h"和\#include "core_cm4.h"即可，如果是其他内核则对应修改头文件。
+
+## 3.2 STM32不依赖裸机工程移植
+
+接下来选取具体单片机芯片，进行软件包的测试，按照以下步骤：
+
+在网站MDK5 Software Packs
+(keil.com)上下载STM32F1的软件支持包，如图3.7所示，并进行安装。
+
+![](media/d8af8e2edc40cc8ba9118bd25e011cd5.png)
+
+图3.7 STM32软件支持包
+
+新建工程，选择芯片为STM32F103C8，如图3.8所示，然后点击ok，按照图3.9所示，选择TencentOS-tiny软件包的组件和STM32的启动文件。
+
+![](media/0a73b53d3e30e784f48a79fd32c84e66.png)
+
+图3.8 选择STM32F103C8芯片
+
+![](media/2a43a3b2017e1d0da8b3384f7933f2d4.png)
+
+图3.9 选择组件
+
+然后按照图3.10(a)所示勾选编译版本5，并选择C99mode。
+
+![](media/1873eb5d1431042f0de2ffed6bff6c04.png)
+
+(a)
+
+![](media/ac7a5c0b6d4deb9b11d9b986f1c008d4.png)
+
+(b)
+
+图3.10 软件设置
+
+然后按照图3.11，在mcu_platform.h中添加以下头文件：
+
+\#include "stm32f10x.h"
+
+\#include "core_cm3.h"
+
+\#include "system_stm32f10x.h"
+
+![](media/041b53f475d4f82efcec712bf5eb70dc.png)
+
+图3.11 修改mcu_platform.h
+
+最后点击Build编译，没有报错则移植成功。
+
+![](media/aee29502a5a59eedcc261bd130d55ef7.png)
+
+图3.12 编译界面
+
+## 3.3 单片机裸机工程移植
+
+最后对单片机开发板进行测试，以正点原子探索者STM32F407ZGT6为例介绍TencentOS-tiny软件包的移植。
+
+（1）如下图为软件包勾选的内容：
+
+![](media/244e3aef94e671a066e2d4b9c934c9d2.png)
+
+图3.13 软件包组件勾选
+
+在正点原子探索者STM32F407ZGT6裸机工程模板中移植软件包后的界面如图3.14所示：
+
+![](media/7d039ebb51d2ee8d49bad77cb14cb7a7.png)
+
+图3.14 移植界面
+
+（2）然后按照mcu_it.c对stm32f4xx_it.c中的PendSV_Handler()函数和SysTick_Handler()函数进行修改，如下图所示，注释stm32f4xx_it.c中的PendSV_Handler()函数，并修改SysTick_Handler()函数。
+
+![](media/96b988085bb718244b84cd800467728f.png)
+
+图3.15 函数修改
+
+（3）对mcu_platform.h进行修改，添加\#include "stm32f4xx.h"
+
+![](media/9ab294a1beab98c5f618a2799326ae73.png)
+
+图3.16 修改mcu_platform.h
+
+（4）接下来，使用如下main程序：
+
+\#include "stm32f4xx.h"
+
+\#include "usart.h"
+
+\#include "tos_k.h"
+
+k_task_t task1;
+
+k_task_t task2;
+
+k_stack_t task_stack1[1024];
+
+k_stack_t task_stack2[1024];
+
+void test_task1(void \*Parameter)
+
+{
+
+while(1)
+
+{
+
+printf("task1 running\\r\\n");
+
+tos_task_delay(200);
+
+}
+
+}
+
+void test_task2(void \*Parameter)
+
+{
+
+k_err_t err;
+
+printf("task2 running\\r\\n");
+
+tos_task_delay(2000);
+
+// suspend task1暂停
+
+printf("suspend task1\\r\\n");
+
+err = tos_task_suspend(&task1);
+
+if(err != K_ERR_NONE)
+
+printf("suspend task1 fail! code : %d \\r\\n",err);
+
+tos_task_delay(2000);
+
+// resume task1恢复
+
+printf("resume task1\\r\\n");
+
+err = tos_task_resume(&task1);
+
+if(err != K_ERR_NONE)
+
+printf("resume task1 fail! code : %d \\r\\n",err);
+
+tos_task_delay(2000);
+
+// destroy task1销毁
+
+printf("destroy task1\\r\\n");
+
+err = tos_task_destroy(&task1);
+
+if(err != K_ERR_NONE)
+
+printf("destroy task1 fail! code : %d \\r\\n",err);
+
+// task2 running
+
+while(1)
+
+{
+
+printf("task2 running\\r\\n");
+
+tos_task_delay(1000);
+
+}
+
+}
+
+int main(void)
+
+{
+
+k_err_t err;
+
+/\*初始化USART 配置模式为 115200 8-N-1，中断接收\*/
+
+uart_init(115200);
+
+printf("Welcome to TencentOS tiny\\r\\n");
+
+tos_knl_init(); // TOS Tiny kernel initialize
+
+tos_robin_default_timeslice_config((k_timeslice_t)500u);
+
+printf("create task1\\r\\n");
+
+err = tos_task_create(&task1, "task1", test_task1, NULL, 3, task_stack1, 1024,
+20);
+
+if(err != K_ERR_NONE)
+
+printf("TencentOS Create task1 fail! code : %d \\r\\n",err);
+
+printf("create task2\\r\\n");
+
+err = tos_task_create(&task2, "task2", test_task2, NULL, 4, task_stack2, 1024,
+20);
+
+if(err != K_ERR_NONE)
+
+printf("TencentOS Create task2 fail! code : %d \\r\\n",err);
+
+tos_knl_start(); // Start TOS Tiny
+
+}
+
+（5）点击编译，并利用ST
+LINK-V2将程序下载到单片机上，如图3.17，然后将单片机的串口与电脑连接起来，利用XCOM串口通讯助手进行查看，结果如图3.18所示。
+
+![](media/eabe7550f7c093aab25191d5e2d2e574.png)
+
+图3.17 编译界面
+
+![](media/6ae58199b9fc760d8a73b48cec67924d.png)
+
+图3.18 测试界面
+
+另外，在编译过程中如果遇到图3.19(a)的报错，需要将图3.19(b)中的\#define
+TOS_CFG_OBJECT_VERIFY_EN 1u修改为TOS_CFG_OBJECT_VERIFY_EN 0u
+
+![](media/098dcc332ed6d345bba001e757104353.png)
+
+(a)
+
+![](media/249ca94ee23c5da4ee60df4b92502e00.png)
+
+(b)
+
+图3.19 报错修改
+
+# 4、总结
+
+本文首先研究了基于MDK完成第三方软件包封装的开发过程，并编写了软件包制作的步骤，然后结合TencentOS
+Tiny物联网操作系统，对其中的ARM内核架构下的文件进行了封装，从而设计了基于TencentOS
+Tiny的软件包。
+
+本软件包能够方便开发者快速地将TencentOS
+Tiny操作系统移植到用户的ARM内核单片机上，大大节省了开发移植的时间，同时软件包具有自动适配内核和依赖提示的功能，能够提高移植的效率。
+
+# 5、开发参考
+
+1、腾讯物联网操作系统网址<https://github.com/OpenAtomFoundation/TencentOS-tiny>
+
+2、MDK5软件包MDK5 Software Packs (keil.com)
+
+3、制作软件包培训视频https://www.bilibili.com/video/BV1AK411p7d9
+
+4、制作软件包博客https://blog.csdn.net/qq_40259429/article/details/119320319
+
+5、制作简易软件包https://www.cnblogs.com/libra13179/p/6273415.html
+
+6、CMSIS-Driver软件包ARM-software/CMSIS-Driver: Repository of microcontroller
+peripheral driver implementing the CMSIS-Driver API specification (github.com)
+
+# 6、附录-移植配置参考
+
+## 6.1 MDK5.14版本移植到ARM内核
+
+### 6.1.1 Cortex-M0内核移植
+
+（1）Manage Run-Time Environment勾选如下：
+
+![](media/4bf08b4e2307ff5a64f3fbf99926f19b.png)
+
+（2）在mcu_platform.h中添加：
+
+\#include "ARMCM0.h"
+
+\#include "core_cm0.h"
+
+### 6.1.2 Cortex-M0+内核移植
+
+（1）Manage Run-Time Environment勾选如下：
+
+![](media/3a9f68e87997d419e709c656933f3327.png)
+
+（2）在mcu_platform.h中添加：
+
+\#include "ARMCM0plus.h"
+
+\#include "core_cm0plus.h"
+
+### 6.1.3 Cortex-M3内核移植
+
+（1）Manage Run-Time Environment勾选如下：
+
+![](media/06581371b251d67e37967e491f2c3b4e.png)
+
+（2）在mcu_platform.h中添加：
+
+\#include "ARMCM3.h"
+
+\#include "core_cm3.h"
+
+### 6.1.4 Cortex-M4内核移植
+
+（1）Manage Run-Time Environment勾选如下：
+
+![](media/1fb57d5d2e131eefd894c26f9884eb64.png)
+
+（2）在mcu_platform.h中添加：
+
+\#include "ARMCM4.h"
+
+\#include "core_cm4.h"
+
+### 6.1.5 Cortex-M7内核移植
+
+1、Manage Run-Time Environment勾选如下：
+
+![](media/84734d13be5195307cf288639107f728.png)
+
+2、在MDK中修改为C99
+
+![](media/eaa74687e2374e6863dc32cd337760cb.png)
+
+3、在mcu_platform.h中添加：
+
+\#include "ARMCM7.h"
+
+\#include "core_cm7.h"
+
+## 6.2 MDK5.14版本移植到基于ARM内核的芯片
+
+### 6.2.1 移植到stm32f103c8芯片
+
+1、Manage Run-Time Environment勾选如下：
+
+![](media/3b64c5bf797e1779c87c3bf390845f4c.png)
+
+2、在mcu_platform.h中添加：
+
+\#include "stm32f10x.h"
+
+\#include "core_cm3.h"
+
+\#include "system_stm32f10x.h"
+
+### 6.2.2 移植到stm32f767igt芯片
+
+1、Manage Run-Time Environment勾选如下：
+
+![](media/91c2c98ce005e1159ac430772c446a17.png)
+
+2、在MDK中修改为C99
+
+![](media/eaa74687e2374e6863dc32cd337760cb.png)
+
+3、在mcu_platform.h中添加：
+
+\#include "stm32f7xx.h"
+
+\#include "core_cm7.h"
+
+\#include "system_stm32f7xx.h"
+
+## 6.3 MDK5.30和MDK5.35版本移植（Cortex-M0+、0、3、4、7内核和芯片）
+
+在MDK5.30和MDK5.35版本的Keil移植TencentOS-tiny
+Pack时，对于Cortex-M0+、0、3、4、7的内核和芯片，勾选组件和添加头文件的步骤之前一致，但是需要修改编译器的版本，具体修改如下，然后执行编译即可。
+
+![](media/241f9986adb8bd76f2c9836e98fe53e0.png)
+
+![](media/f0e11c195cd20abdca5fd5a9dc85ac7c.png)
+
+## 6.4 MDK5.30和MDK5.35版本移植（Cortex-M23、33）
+
+### 6.4.1 Cortex-M23内核移植
+
+（1）Manage Run-Time Environment勾选如下：
+
+![](media/b023beba923e4ae086a2091df55e270e.png)
+
+（2）在mcu_platform.h中添加：
+
+\#include "ARMCM23.h"
+
+\#include "core_cm23.h"
+
+（3）修改为不查看报错：
+
+![](media/3b90a1c32386f1e405dfa5f52a9b6a07.png)
+
+### 6.4.2 Cortex-M33内核移植
+
+（1）选择带FPU的芯片
+
+![](media/6746e7af0809a3073a7ea466d9e71771.png)
+
+（2）Manage Run-Time Environment勾选如下：
+
+![](media/5572ec30b5150aedb841b892b751140c.png)
+
+（3）在mcu_platform.h中添加：
+
+\#include "ARMCM33_DSP_FP.h"
+
+\#include "core_cm33.h"
+
+（4）修改为不查看报错：
+
+![](media/3b90a1c32386f1e405dfa5f52a9b6a07.png)