1. stm32h7 移植RTX5（AC6） 基于CUBEMX

基于CUBEMX H750 移植 RTX5 使用AC6编译器

本文参考了安富莱论坛的相关教程：
【安富莱】RTX5内核教程，采用CMSIS-RTOS V2封装层，已经更新发布至第6章 （2020-09-21）

硬件：
STM32H750VB开发板

软件配置：

• CMSIS 软件包使用当前最新的：V5.8.0
• STM32H7 使用当前最新的：V2.7.0
• STM32CubeMX 使用当前最新的：V6.3.0

一.创建CUBEMX工程。
1.时基使用TIM6

2.启用高速外部晶振

设置Debug为SW

并配置好时钟

3.关闭NVIC的代码生成，这三个中断函数在 RTX5 里有定义。

4.配置 2个 LED 灯用于测试。

5.工程配置

注意修改IDE，和堆栈大小。

6.生成代码，并打开工程。

二.添加RTX5组件。
1.修改工程配置。启用MicroLIB,并使用AC6编译器，点击编译，确保没有警告及错误。

2.开始添加 RTX5 组件，点击此处。

3.勾选 RTX5 组件，选择使用源码方式加入，点击resolve，自动完成配置，最后点击OK。

4.完成后会弹出下面的窗口，提示要使用cubemx-api生成一次配置文件。

5.在新打开的CUBEMX中，不做任何配置直接点击生成代码，然后关闭它。


6.回到KEIL，提示文件被修改，点击 “是” 更新文件。

7.此时，工程文件如下图所示。

8.屏蔽不需要的工程文件，使其兼容 CUBEMX 工程模板，具体操作如下：
8.1 右键选择需要屏蔽编译的文件：如 stm32h7xx_hal.c ，选择 Option for Component Class “Device”，取消 Include in target build 前的勾选，点击OK

8.2 按下图依次将 Device 中的文件屏蔽，保留 stm32h7xx_hal_msp.c 文件：

8.3 按下图依次将 STM32CubeMX:Common Sources 中的文件屏蔽，stm32h7xx_it.h不用管它：

9.打开 “Device” 下的 stm32h7xx_hal_msp.c 文件，在文件首尾位添加条件编译，此文件与cubemx生成的文件冲突。如果只是屏蔽掉的话，每次使用cubemx重新生成代码都会使其恢复编译状态，所以使用条件编译来屏蔽掉它。

10.完成以上操作后，点击编译。

11.至此RTX5移植工作完成。

三.功能测试
1.添加测试代码 OS_Start.c 和 OS_Start.h
OS_Start.c 内容如下：

#include "OS_start.h"
#include "stdio.h"
#include "cmsis_os2.h"


static void AppTaskCreate (void);
void AppTaskUserIF(void *argument);
void AppTaskLEDG(void *argument);
void AppTaskLEDR(void *argument);
void AppTaskMsgPro(void *argument);
void AppTaskStart(void *argument);


const osThreadAttr_t ThreadStart_Attr = 
{
	.name = "osRtxStartThread",
	.attr_bits = osThreadDetached, 
	.priority = osPriorityHigh4,
	.stack_size = 2048,
};

const osThreadAttr_t ThreadMsgPro_Attr = 
{
	.name = "osRtxMsgProThread",
	.attr_bits = osThreadDetached, 
	.priority = osPriorityHigh3,
	.stack_size = 1024,
};

const osThreadAttr_t ThreadLEDG_Attr = 
{
	.name = "osRtxLEDGThread",
	.attr_bits = osThreadDetached, 
	.priority = osPriorityHigh2,
	.stack_size = 512,
};

const osThreadAttr_t ThreadLEDR_Attr = 
{
	.name = "osRtxLEDRThread",
	.attr_bits = osThreadDetached, 
	.priority = osPriorityHigh2,
	.stack_size = 512,
};

const osThreadAttr_t ThreadUserIF_Attr = 
{
	.name = "osRtxThreadUserIF",
	.attr_bits = osThreadDetached, 
	.priority = osPriorityHigh1,
	.stack_size = 1024,
};

osThreadId_t ThreadIdTaskUserIF = NULL;
osThreadId_t ThreadIdTaskMsgPro = NULL;
osThreadId_t ThreadIdTaskLEDG = NULL;
osThreadId_t ThreadIdTaskLEDR = NULL;
osThreadId_t ThreadIdStart = NULL;


void Task_start(void)
{
	osKernelInitialize();                                  
	ThreadIdStart = osThreadNew(AppTaskStart, NULL, &ThreadStart_Attr);  
	osKernelStart();
}

void AppTaskMsgPro(void *argument)
{
	while(1)
	{
		osDelay(10);
	}	
}

void AppTaskUserIF(void *argument)
{
    while(1)
    {	
		osDelay(200);
	}
}

void AppTaskLEDG(void *argument)
{
	const uint16_t usFrequency = 200; 
	uint32_t tick;

	tick = osKernelGetTickCount(); 
	
    while(1)
    {
		tick += usFrequency;                          
		osDelayUntil(tick);
		
		HAL_GPIO_TogglePin(LEDG_GPIO_Port,LEDG_Pin);
		
    }
}

void AppTaskLEDR(void *argument)
{
	const uint16_t usFrequency = 250; 
	uint32_t tick;

	tick = osKernelGetTickCount(); 
	
    while(1)
    {
		tick += usFrequency;                          
		osDelayUntil(tick);
		
		HAL_GPIO_TogglePin(LEDR_GPIO_Port,LEDR_Pin);
		
    }
}

void AppTaskStart(void *argument)
{
	const uint16_t usFrequency = 1; 
	uint32_t tick;
	
	HAL_ResumeTick();
	AppTaskCreate();
	tick = osKernelGetTickCount(); 
	
    while(1)
    {
		tick += usFrequency;                          
		osDelayUntil(tick);
    }
}

static void AppTaskCreate (void)
{
	ThreadIdTaskMsgPro = osThreadNew(AppTaskMsgPro, NULL, &ThreadMsgPro_Attr);  
	ThreadIdTaskLEDG = 	osThreadNew(AppTaskLEDG, NULL, &ThreadLEDG_Attr);  
	ThreadIdTaskLEDR = 	osThreadNew(AppTaskLEDR, NULL, &ThreadLEDR_Attr);  
	ThreadIdTaskUserIF = osThreadNew(AppTaskUserIF, NULL, &ThreadUserIF_Attr);  
}

OS_Start.h内容如下：

#ifndef _OS_START_H_
#define	_OS_START_H_

#include "main.h"

extern void Task_start(void);

#endif

2.在 main.c 对应位置添加如下代码：

/* USER CODE BEGIN Includes */
#include "OS_start.h"
/* USER CODE END Includes */

  /* USER CODE BEGIN 2 */
	Task_start();
  /* USER CODE END 2 */

编译并下载。

运行效果，LEDG和LEDR以不同频率闪烁。

四.已知存在的问题：
1.编译信息会多出一条提示：

Note: source file ‘D:\H750_RTX5_AC6\MDK-ARM\RTE\Device\STM32H750VBTx\STCubeGenerated\Src\stm32h7xx_hal_msp.c’ - object file renamed from ‘H750_RTX5_AC6\stm32h7xx_hal_msp.o’ to ‘H750_RTX5_AC6\stm32h7xx_hal_msp_1.o’.

原因：这是因为工程中同时存在 两个 stm32h7xx_hal_msp.c 文件。

2.使用 cubemx 重新生成时会出现下面的提示，

原因：加入了 RTX5 的工程文件多了关于RTX5的描述文件，cubemx生成的工程文件少了这些描述文件所以报错了，不用担心，再次使用 cubemx 生成一次就可以打开了。

五.后续
2. stm32h7 移植RL-USB（AC6）MSC模式 基于CUBEMX