开源地址：https://gitee.com/AT32437_OpenHarmony
学习本文档的意义
1.学习移植OpenHarmony轻量系统到AT32全系列mcu上，本文档移植的具体型号为AT32F437ZMT7
2.学习OpenHarmony轻量系统开发
6.target_config.h文件适配
在//kernel/liteos_m/kernel/include/los_config.h文件中，有包含一个名为target_config.h的头文件，如果没有这个头文件，则会编译出错。
首先在target_config.h中包含at32f435_437.h头文件，主要修改OS_SYS_CLOCK和LOSCFG_SYS_HEAP_SIZE，
- OS_SYS_CLOCK是配置LiteOS-M的时钟为系统时钟的参数,单位是hz。我们修改为at32437的主频288Mhz
- LOSCFG_SYS_HEAP_SIZE系统的内存大小，at32437的SRAM大小为512kb,这里我们简单设置为300*1024
target_config.h具体内容
#ifndef _TARGET_CONFIG_H
#define _TARGET_CONFIG_H
#include <stdint.h>
#include "at32f435_437.h" 包含了at32平台大量的宏定义
#ifdef __cplusplus
#if __cplusplus
extern "C" {
#endif /* __cplusplus */
#endif /* __cplusplus */
/* =============================================================================
System clock module configuration
系统时钟模块配置参数
============================================================================= */
//OS_SYS_CLOCK是配置LiteOS-M的时钟为系统时钟的参数,单位是hz
//AT43F437ZMT7系统时钟为288MHz
#define OS_SYS_CLOCK 288*1000*1000
//LOSCFG_BASE_CORE_TICK_PER_SECOND表示操作系统每秒钟产生Tick的数量，Tick是指操作系 统节拍的时钟周期。时钟节拍就是系统以固定的频率产生中断（时基中断），并在中断中处理与时间相关的事件，推动所有任务 向前运行。时钟节拍需要依赖于硬件定时器
//在LiteOS-M中，系统延时和阻塞时间都是以Tick为单位的，配置LOSCFG_BASE_CORE_TICK_PER_SECOND 的值可以改变中断的频率，从而间接改变LiteOS的时钟周期（T=1/f）。如果将LOSCFG_BASE_CORE_TICK_PER_SECOND的值设置为1000， 那么LiteOS-M的时钟周期为1ms。过高的系统节拍中断频率意味着LiteOS-M内核将占用更多的CPU时间，因此会降低效率，一般将 LOSCFG_BASE_CORE_TICK_PER_SECOND的值设置为50~1000即可。
#define LOSCFG_BASE_CORE_TICK_PER_SECOND (1000UL)
//定时器裁剪的外部配置项。
#define LOSCFG_BASE_CORE_TICK_HW_TIME 0
#define LOSCFG_BASE_CORE_TICK_WTIMER 0
#define LOSCFG_BASE_CORE_TICK_RESPONSE_MAX (20000)
/* =============================================================================
Hardware interrupt module configuration
硬件外部中断模块配置参数
============================================================================= */
//LOSCFG_PLATFORM_HWI是硬件中断定制配置参数，YES表明LiteOS-M接管了外部中断，一般建议设置为NO，即不接管中断。
#define LOSCFG_PLATFORM_HWI 0
// 是否使用OS默认的中断。1接管，0不接管。
#define LOSCFG_USE_SYSTEM_DEFINED_INTERRUPT 0
//LOSCFG_PLATFORM_HWI_LIMIT这个宏定义表示 LiteOS-M支持最大的外部中断数，默认为96，一般不作修改，使用默认即可。
#define LOSCFG_PLATFORM_HWI_LIMIT 0x200
/* =============================================================================
Task module configuration
任务模块的配置。
============================================================================= */
//LOSCFG_BASE_CORE_TSK_LIMIT这个宏定义表示LiteOS支持的最大任务个数（除去空闲任务），默认为15。
#define LOSCFG_BASE_CORE_TSK_LIMIT 60
//LOSCFG_BASE_CORE_TSK_IDLE_STACK_SIZE这个宏定义表示空闲任务的栈大小，默认为0x500U字节
#define LOSCFG_BASE_CORE_TSK_IDLE_STACK_SIZE (0x600U)
//LOSCFG_BASE_CORE_TSK_DEFAULT_STACK_SIZE宏定义表示定义默认的任务栈大小为0x2D0U字节，在任务创建的时候一般都会指定任务栈的大小，以适 配不一样的应用任务，而如果没有指定则使用默认值。
#define LOSCFG_BASE_CORE_TSK_DEFAULT_STACK_SIZE (0x800U)
//LOSCFG_BASE_CORE_TSK_MIN_STACK_SIZE这个宏定义则表示任务最小需要的栈大小，栈大小应该是一个 合理的值，如果大小太大，可能会导致内存耗尽，最小的栈大小默认为0x130U。
#define LOSCFG_BASE_CORE_TSK_MIN_STACK_SIZE (0x100U)
//LOSCFG_BASE_CORE_TIMESLICE这个宏定义表示是否使用时间片，在LiteOS-M一般都会使用时间片，故配置为YES。
#define LOSCFG_BASE_CORE_TIMESLICE 1
//LOSCFG_BASE_CORE_TIMESLICE_TIMEOUT这个宏定义表示具有相同优先级的任务的最长执行时间，单位为时钟节拍周期，默认配置为10。
#define LOSCFG_BASE_CORE_TIMESLICE_TIMEOUT 1000
//LOSCFG_BASE_CORE_TSK_MONITOR这个宏定义表示任务栈监控模块定制的配置项，在LiteOS-M中默认打开。
#define LOSCFG_BASE_CORE_TSK_MONITOR 1
#define LOSCFG_EXC_HARDWARE_STACK_PROTECTION 0
/* =============================================================================
Semaphore module configuration
信号量模块配置，信号量用于任务间的IPC通信，或者是用于任务与任务间的同步， 任务与中断间的同步等。
============================================================================= */
//LOSCFG_BASE_IPC_SEM这个宏定义表示信号量的配置项，配置为YES则表示默认使用信号量。
#define LOSCFG_BASE_IPC_SEM 1
//LOSCFG_BASE_IPC_SEM_LIMIT这个宏定义表示LiteOS-M最大支持信号量的个数，默认为20个，用户可以自定义设置信号量个数。
#define LOSCFG_BASE_IPC_SEM_LIMIT 48
/*=============================================================================
Mutex module configuration
是互斥锁模块配置，互斥锁在LiteOS中起不可缺少的作用，如果某资源同时只准一个任务 访问，可以用互斥锁保护这个资源，互斥锁还具有优先级继承机制。
============================================================================= */
//LOSCFG_BASE_IPC_MUX这个宏定义表示互斥锁的配置项，配置为YES则表示默认使用互斥锁。
#define LOSCFG_BASE_IPC_MUX 1
//LOSCFG_BASE_IPC_MUX_LIMIT这个宏定义表示LiteOS-M最大支持互斥锁的个数，默认为15。
#define LOSCFG_BASE_IPC_MUX_LIMIT 32
/*=============================================================================
Queue module configuration
消息队列模块配置，消息队列也是IPC通信的一种，用于任务与任务之间，任务与中断直接 的通信，可以存储有限的、大小固定的数据。
============================================================================= */
//队列功能开关，1表示打开，0表示关闭
//LOSCFG_BASE_IPC_QUEUE这个宏定义表示队列量的配置项，配置为YES则表示默认使用消息队列。
#define LOSCFG_BASE_IPC_QUEUE 1
//LOSCFG_BASE_IPC_QUEUE_LIMIT这个宏定义表示LiteOS-M最大支持消息队列量的个数，默认为10。
#define LOSCFG_BASE_IPC_QUEUE_LIMIT 24
/*=============================================================================
Software timer module configuration
软件定时器模块配置，使用软件定时器则必须要使用消息队列，否则不会使用软件定时器。
============================================================================= */
//软件定时器特性开关，1表示打开，0表示关闭
//LOSCFG_BASE_CORE_SWTMR这个宏定义表示软件定时器的配置项，配置为YES则表示默认使用软件定时器。
#define LOSCFG_BASE_CORE_SWTMR 1
//对齐软件定时器特性开，1表示打开，依赖软件定时器特性打开，0表示关闭
#define LOSCFG_BASE_CORE_SWTMR_ALIGN 0
//LOSCFG_BASE_CORE_SWTMR_LIMIT这个宏定义表示支持的最大软件定时器数量，而不是可用的软件定时器数量。默认为16。
#define LOSCFG_BASE_CORE_SWTMR_LIMIT 5
/*=============================================================================
Memory module configuration
内存模块的配置项。
============================================================================= */
//声明了外部定义的一些变量，__heap_start为系统的起始地址，__heap_end为系统的结束地址，系统管理的内存均在这两个地址之间。
extern unsigned int __heap_start;
extern unsigned int __heap_end;
//这个宏决定系统是使用内核的内部堆内存还是用户的堆内存，默认为0（即使用内部的堆内存），大小为0x10000；如果用户需要基于外部的堆内存，那么可以将该宏设置为1。
#define LOSCFG_SYS_EXTERNAL_HEAP 1
//系统的内存起始地址。
#define LOSCFG_SYS_HEAP_ADDR (void *)(UINTPTR)(&__heap_start)
//系统的内存大小，大小为结束地址-起始地址+1。
#define LOSCFG_SYS_HEAP_SIZE 310*1024 //SRAM 384 kb（出厂默认），最大可设定为 512
//LOSCFG_MEM_MUL_POOL这个宏定义是配置内存模块内存池检查，默认打开。
#define LOSCFG_MEM_MUL_POOL 0
#define OS_SYS_MEM_NUM 20
#define LOSCFG_MEM_FREE_BY_TASKID 0
//LOSCFG_BASE_MEM_NODE_INTEGRITY_CHECK这个宏定义是配置内存节点完整性检查，默认打开。
#define LOSCFG_BASE_MEM_NODE_INTEGRITY_CHECK 0
#define LOSCFG_STACK_POINT_ALIGN_SIZE 4
/* =============================================================================
Exception module configuration
============================================================================= */
//打印特性开关，1表示打开，0表示关闭
#define LOSCFG_KERNEL_PRINTF 1
#define LOSCFG_SUPPORT_LITTLEFS 1
#ifdef __cplusplus
#if __cplusplus
}
#endif /* __cplusplus */
#endif /* __cplusplus */
#endif /* _TARGET_CONFIG_H */
7.启动恢复子系统适配
启动恢复子系统适配bootstrap_lite/syspara_lite两个部件。请在vendor\artery\AT-START-F437\config.json中新增对应的配置选项。
{
"subsystem": "startup",
"components": [
{
"component": "bootstrap_lite" --- bootstrap_lite 部件
},
{
"component": "syspara_lite", --- syspara_lite 部件
"features": [
"enable_ohos_startup_syspara_lite_use_posix_file_api = true"
]
}
]
},
1.在厂商ld链接脚本AT32F437xM_FLASH.ld中添加如下代码
.zinitcall_array :
{
. = ALIGN(0x4) ;
PROVIDE_HIDDEN (__zinitcall_core_start = .);
KEEP (*(SORT(.zinitcall.core*)))
KEEP (*(.zinitcall.core*))
PROVIDE_HIDDEN (__zinitcall_core_end = .);
. = ALIGN(0x4) ;
PROVIDE_HIDDEN (__zinitcall_device_start = .);
KEEP (*(SORT(.zinitcall.device*)))
KEEP (*(.zinitcall.device*))
PROVIDE_HIDDEN (__zinitcall_device_end = .);
. = ALIGN(0x4) ;
PROVIDE_HIDDEN (__zinitcall_bsp_start = .);
KEEP (*(SORT(.zinitcall.bsp*)))
KEEP (*(.zinitcall.bsp*))
PROVIDE_HIDDEN (__zinitcall_bsp_end = .);
. = ALIGN(0x4) ;
PROVIDE_HIDDEN (__zinitcall_sys_service_start = .);
KEEP (*(SORT(.zinitcall.sys.service*)))
KEEP (*(.zinitcall.sys.service*))
PROVIDE_HIDDEN (__zinitcall_sys_service_end = .);
. = ALIGN(0x4) ;
PROVIDE_HIDDEN (__zinitcall_app_service_start = .);
KEEP (*(SORT(.zinitcall.app.service*)))
KEEP (*(.zinitcall.app.service*))
PROVIDE_HIDDEN (__zinitcall_app_service_end = .);
. = ALIGN(0x4) ;
PROVIDE_HIDDEN (__zinitcall_sys_feature_start = .);
KEEP (*(SORT(.zinitcall.sys.feature*)))
KEEP (*(.zinitcall.sys.feature*))
PROVIDE_HIDDEN (__zinitcall_sys_feature_end = .);
. = ALIGN(0x4) ;
PROVIDE_HIDDEN (__zinitcall_app_feature_start = .);
KEEP (*(SORT(.zinitcall.app.feature*)))
KEEP (*(.zinitcall.app.feature*))
PROVIDE_HIDDEN (__zinitcall_app_feature_end = .);
. = ALIGN(0x4) ;
PROVIDE_HIDDEN (__zinitcall_run_start = .);
KEEP (*(SORT(.zinitcall.run*)))
KEEP (*(.zinitcall.run*))
PROVIDE_HIDDEN (__zinitcall_run_end = .);
. = ALIGN(0x4) ;
PROVIDE_HIDDEN (__zinitcall_test_start = .);
KEEP (*(SORT(.zinitcall.test*)))
KEEP (*(.zinitcall.test*))
PROVIDE_HIDDEN (__zinitcall_test_end = .);
. = ALIGN(0x4) ;
PROVIDE_HIDDEN (__zinitcall_exit_start = .);
KEEP (*(SORT(.zinitcall.exit*)))
KEEP (*(.zinitcall.exit*))
PROVIDE_HIDDEN (__zinitcall_exit_end = .);
} > FLASH
8.修改启动文件
1.在target_config.h中通过LOSCFG_USE_SYSTEM_DEFINED_INTERRUPT来配置操作系统接管还是不接管中断向量, 选择不接管的方式
- 修改startup_at32f435_437.s文件,
```
PendSV_Handler修改为HalPendSV
SysTick_Handler修改为OsTickHandler
```
总结
读者可以比对厂家雅特力提供的AT32F435_437_Firmware_Library和at32f437_vendor，查看移植过程对AT32F435_437_Firmware_Library的修改
