【GD32F427开发板】Liteos-m 移植

Cortex-M 嵌入式系统 MCU Arm 开发板

引言

HarmonyOS当前分为以下几种系统类型：轻量系统 、小型系统、标准系统。针对不同量级的系统，分别使用了不同形态的内核，在轻量系统上，可以选择LiteOS-M；在小型系统和标准系统上，可以选用LiteOS-A；在标准系统上，可以选用Linux。

由于LiteOS 官方已经适配过Cortex-M 系列单片机，移植过程比较简单。

Keil创建个人工程

1. 新建一工程个文件夹GD32F427V_Liteos_m,文件路径中不要有汉字，不然可能会出现一些奇奇怪怪的报错 ）

2. 选择开发板pack包
   

3. include 路径更新正确，如果编译fail, 建议检查依赖是否全部包含
   
   将一些基础的库文件都添加进去后，如下图所示
   
   Note: 在官方demo 上进行二次开发，可以省去很多配置步骤

Flash & Download

在配置环境过程中也踩了不少坑，但是好在有极术社区可以借鉴很多小伙伴的帖子，也能很快找到解决方法。

配置Flash

Flash Download 根据下面配置

串口调试
添加usart 代码
usart.c

void gd_com_init(void)
{
    /* enable GPIO clock */
//    uint32_t COM_ID = 0;
//    if(USART_COM0 == com)
//    {
//        COM_ID = 0U;
//    }

    rcu_periph_clock_enable(RCU_GPIOB);
    /* enable USART clock */
    rcu_periph_clock_enable(RCU_USART2);

    /* connect port to USARTx_Tx */
    gpio_af_set(GPIOB, GPIO_AF_7, GPIO_PIN_10);

    /* connect port to USARTx_Rx */
    gpio_af_set(GPIOB, GPIO_AF_7, GPIO_PIN_11);

    /* configure USART Tx as alternate function push-pull */
    gpio_mode_set(GPIOB, GPIO_MODE_AF, GPIO_PUPD_PULLUP,GPIO_PIN_10);
    gpio_output_options_set(GPIOB, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ,GPIO_PIN_10);

    /* configure USART Rx as alternate function push-pull */
    gpio_mode_set(GPIOB, GPIO_MODE_AF, GPIO_PUPD_PULLUP, GPIO_PIN_11);
    gpio_output_options_set(GPIOB, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_PIN_11);

    /* USART configure */
    usart_deinit(USART2);
    usart_baudrate_set(USART2, 9600);

usart_parity_config(USART2, USART_PM_NONE);
usart_stop_bit_set(USART2, USART_STB_1BIT);
usart_word_length_set(USART2, USART_WL_8BIT);
//        usart_hardware_flow_rts_config(USART_COM0, USART_RTS_DISABLE);
//        usart_hardware_flow_cts_config(USART_COM0, USART_CTS_DISABLE);
    usart_transmit_config(USART2, USART_TRANSMIT_ENABLE);
    usart_receive_config(USART2, USART_RECEIVE_ENABLE);

    usart_enable(USART2);
}
/* retarget the C library printf function to the USART */
int fputc(int ch, FILE *f)
{
usart_data_transmit(USART2, (uint8_t)ch);
while(RESET == usart_flag_get(USART2, USART_FLAG_TBE));
return ch;
}
main.c 中进行初始化

int main(void)
{

/* configure systick */
systick_config();

gd_com_init();
/ enable the LEDs GPIO clock /

rcu_periph_clock_enable(RCU_GPIOC);

/* configure LED2 GPIO port */
gpio_mode_set(GPIOC, GPIO_MODE_OUTPUT, GPIO_PUPD_NONE, GPIO_PIN_6);
gpio_output_options_set(GPIOC, GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, GPIO_PIN_6);
/* reset LED2 GPIO pin */
gpio_bit_reset(GPIOC, GPIO_PIN_6);

/* output a message on hyperterminal using printf function */
printf("\r\n USART printf example: please press the Tamper key \r\n");

/* wait for completion of USART transmission */
// while(RESET == usart\\_flag\\_get(USART2, USART\\_FLAG\\_TC)){
// }
    while(1){

printf("\r\n turn on LED2 \r\n");
    gpio_bit_set(GPIOC, GPIO_PIN_6);
    delay_1ms(500);

printf("\r\n turn off LED2 \r\n");
/ turn off LED2 /

    gpio_bit_reset(GPIOC, GPIO_PIN_6);
    delay_1ms(500);
    }
}

编译通过后下载验证：

前面已经验证好了我们裸机工程已经可以正常执行，现在我们将liteos-m代码进行移植

准备Liteos-m 源码

OpenHarmony-3.0-LTS： https://gitee.com/openharmony/kernel\_liteos\_m
c++ 基础库：https://gitee.com/openharmony/utils\_native

一. 导入 LiteOS-M 源代码

1.下载LiteOS-M 源代码
2.在Keil 5.0中打开项目，根据下面图示将源码导入对应路径下

二. 环境配置

1.设置宏定义，如系统版本、处理器类型等。
2.配置编译路径，如头文件、库文件等的搜索路径。
3.保存环境配置，使配置生效。

三. 编译

编译代码，以确保所有代码都满足编译要求并解决任何编译错误。通过详细检查编译错误消息并在代码中进行修复，以确保编译通过。

kernel\arch\arm\cortex-m4\iar\los\\\\\\\\_exc.S

32    PRESERVE8
33    SECTION .text: CODE(2)
34    THUMB

35    EXPORT  HalExcNMI
36    EXPORT  HalExcHardFault
37    EXPORT  HalExcMemFault
38    EXPORT  HalExcBusFault
39    EXPORT  HalExcUsageFault
40    EXPORT  HalExcSvcCall

Keil 中的汇编程序不支持“SECTION”指令。 “SECTION”指令通常用于 GNU 汇编器 (GAS)，但 Keil 使用不支持此指令的不同汇编器。
将 "SECTION"指令替换为"AREA"指令

AREA MyCode, CODE, READONLY

Re-build 出现如下错误

错误提示"Instruction not supported on targeted CPU"通常表示代码中使用的指令在选定的 CPU 上不受支持。
要解决此错误，可以尝试以下步骤：

1. 验证 Keil 项目中是否选择了正确的 CPU。打开 Project 菜单，选择 Options for Target，然后选择
   Devices 选项卡。确保选择了正确的 CPU。
2. 检查有问题的指令。确保所选 CPU支持该指令。您可以参考处理器的参考手册以获取受支持的指令列表。 如果该指令不受支持，可能需要使用 CPU 支持的等效指令替换它。
3. 重新构建项目，检查错误是否已经解决。

kernel\arch\arm\cortex-m4\iar\los_dispatch.S"

line 122:     BLX     OsSchedTaskSwitch

“BX” 指令在 GD32F427v CPU 中受支持。替换后的代码应该是：

LDR R0, =OsSchedTaskSwitch
BX R0

使用Keil 5.0编译LiteOS-M代码，生成固件文件，并烧录到开发板

五. 测试
进行系统测试，以确保LiteOS-M在GD32开发板上正常运行，

LED 闪烁，至此移植完成！