移植RT-Thread到靈動(dòng)微MM32F5265開(kāi)發(fā)板教程

本文轉(zhuǎn)載于極術(shù)社區(qū)

作者：曾是一顆薏米

前言

近期，筆者有幸獲得靈動(dòng)微 MM32F5265 開(kāi)發(fā)板的體驗(yàn)資格。MM32F5260 搭載了 arm china "Star-MC1 內(nèi)核"處理器，擁有高性能，主打家電和工業(yè)等高可靠性應(yīng)用領(lǐng)域。 總結(jié)一下，有以下亮點(diǎn)：

本土團(tuán)隊(duì)打造，完全自主可控，采用全國(guó)產(chǎn)化供應(yīng)鏈；

基于 Armv8-M 架構(gòu)，帶有 L1 I-Cache & D-Cache，對(duì)比市面主流的 M3/M4，有 20%性能提升；

通過(guò) I-Cache 實(shí)現(xiàn)對(duì) flash 的零延遲訪問(wèn)，擁有零延遲 AHB 總線矩陣，支持多并發(fā)總線；

擁有信號(hào)間互聯(lián)矩陣，可對(duì)多個(gè)事件進(jìn)行邏輯組合，可實(shí)現(xiàn)較為復(fù)雜的功能；

移植

本次 rt-thread 的移植參考了 “Rice 我叫加飯?” 的博文：https://aijishu.com/a/1060000000347637 參考代碼： https://gitee.com/RiceChen0/mm32f5270_rtt（感謝原作者的付出） 這里我重點(diǎn)說(shuō)一下不一樣的地方：

1.打印重定向到虛擬串口

雖然 Mini-F5265-OB 開(kāi)發(fā)板上沒(méi)有板載 CH340，但這也不影響交互功能，官方提供了一種新的途徑：通過(guò)板載的 MM32-LINK-OB 的虛擬串口來(lái)實(shí)現(xiàn)串口的交互。 簡(jiǎn)述實(shí)現(xiàn)的流程：

PC 通過(guò) USB 連接板載的 MM32-LINK-OB；

板載的 MM32-LINK-OB 將 USB 數(shù)據(jù)轉(zhuǎn)發(fā)成 SWD 接口信號(hào)和串口的 tx/rx 信號(hào)；

最終信號(hào)達(dá)到 Mini-F5265-OB 開(kāi)發(fā)板，實(shí)現(xiàn)串口的交互和程序的燒寫(xiě)功能；

板載的 MM32-LINK-OB，連接如下圖所示：

Mini-F5265-OB 開(kāi)發(fā)板，連接如下圖所示：

因此，移植的第一步就是要用上虛擬串口。

通過(guò)查看上述的原理圖可知虛擬串口用到 uart3。

修改 drv_uart.h，添加 uart3 支持：

#if defined(BSP_USING_UART3)
#ifndef UART3_CONFIG
#define UART3_CONFIG                                
    {                                               
        .name           = "uart3",                  
        .rx_gpiox       = GPIOC,                    
        .rx_rcc_clock   = RCC_AHBPeriph_GPIOC,       
        .rx_pin         = GPIO_Pin_11,              
        .rx_gpio_af     = GPIO_AF_7,                
        .tx_gpiox       = GPIOB,                    
        .tx_rcc_clock   = RCC_AHBPeriph_GPIOC,      
        .tx_pin         = GPIO_Pin_10,              
        .tx_gpio_af     = GPIO_AF_7,                
        .uart_rcc_clock = RCC_APB1Periph_UART3,     
        .uartx          = UART3,                    
        .irq_type       = UART3_IRQn,               
    }
#endif /* UART3_CONFIG */
#endif /* BSP_USING_UART3 */

修改 drv_uart.c，uart3 使用的 PC10 和 PC11 需要初始化：

static int rt_hw_uart_gpio_init(struct mm32_uart_config *cfg)
{
    GPIO_InitTypeDef GPIO_InitStruct;


    RCC_APB1PeriphClockCmd(RCC_APB1Periph_UART3, ENABLE);
    RCC_AHBPeriphClockCmd(RCC_AHBPeriph_GPIOC, ENABLE);


    GPIO_PinAFConfig(GPIOC, GPIO_PinSource10, GPIO_AF_7);
    GPIO_PinAFConfig(GPIOC, GPIO_PinSource11, GPIO_AF_7);


    GPIO_StructInit(&GPIO_InitStruct);
    GPIO_InitStruct.GPIO_Pin   = GPIO_Pin_10;
    GPIO_InitStruct.GPIO_Speed = GPIO_Speed_High;
    GPIO_InitStruct.GPIO_Mode  = GPIO_Mode_AF_PP;
    GPIO_Init(GPIOC, &GPIO_InitStruct);


    GPIO_StructInit(&GPIO_InitStruct);
    GPIO_InitStruct.GPIO_Pin  = GPIO_Pin_11;
    GPIO_InitStruct.GPIO_Mode = GPIO_Mode_IPU;
    GPIO_Init(GPIOC, &GPIO_InitStruct);


    return RT_EOK;
}

static rt_err_t mm32_control(struct rt_serial_device *serial,
                            int                      cmd,
                            void                     *arg)
{
    struct mm32_uart *uart;
    rt_ubase_t ctrl_arg = (rt_ubase_t)arg;


    RT_ASSERT(serial != RT_NULL);


    uart = rt_container_of(serial, struct mm32_uart, serial);


    switch (cmd)
    {
        case RT_DEVICE_CTRL_SET_INT:
        {
            UART_ITConfig(uart->config->uartx, UART_IT_RX, ENABLE);
            NVIC_EnableIRQ(uart->config->irq_type);


            break;
        }
        case RT_DEVICE_CTRL_CLR_INT:
        {
            UART_ITConfig(uart->config->uartx, UART_IT_RX, DISABLE);
            NVIC_DisableIRQ(uart->config->irq_type);
            break;
        }


    }
    return 0;
}


static int mm32_putc(struct rt_serial_device *serial, char c)
{
    struct mm32_uart *uart;


    RT_ASSERT(serial != RT_NULL);


    uart = rt_container_of(serial, struct mm32_uart, serial);


    UART_SendData(uart->config->uartx, (uint8_t)(c));
    while (RESET == UART_GetFlagStatus(uart->config->uartx, UART_FLAG_TXC)) {};


    return 1;
}


static int mm32_getc(struct rt_serial_device *serial)
{
    struct mm32_uart *uart;
    int ch = -1;


    RT_ASSERT(serial != RT_NULL);


    uart = rt_container_of(serial, struct mm32_uart, serial);


    if(UART_GetFlagStatus(uart->config->uartx, UART_FLAG_RXAVL))
    {
        ch = UART_ReceiveData(uart->config->uartx);
        return ch;
    }


    return -1;
}


static void uart_isr(struct rt_serial_device *serial)
{
    struct mm32_uart *uart;


    RT_ASSERT(serial != RT_NULL);


    uart = rt_container_of(serial, struct mm32_uart, serial);


    if(SET == UART_GetFlagStatus(uart->config->uartx, UART_IT_RX))
    {
        rt_hw_serial_isr(serial, RT_SERIAL_EVENT_RX_IND);
    }
}


void UART3_IRQHandler(void)
{
    rt_interrupt_enter();


    uart_isr(&(uart_obj[UART3_INDEX].serial));


    rt_interrupt_leave();
}

2.添加 hal 庫(kù)等文件

從官方的提供的例程資料中找到 HAL_Lib 文件夾，將里面的頭文件和源文件拷貝工程的 libraries/drivers 目錄里面。

修改 libraries/drivers 的 mm32f5260.h，定義“USE_STDPERIPH_DRIVER”的宏。（注意官方提供的默認(rèn)沒(méi)有定義該宏，需要定義后才會(huì)編譯標(biāo)準(zhǔn)外設(shè)驅(qū)動(dòng)庫(kù)）

在 libraries/drivers 目錄創(chuàng)建 hal_common.h，并在里面包含"hal_conf.h"，目的是在外面可以調(diào)到 hal 層的函數(shù)接口。

將官方提供的 core_starmc1.h 拷貝到工程的 libraries/libraries/CMSIS/Include 目錄下，替換原來(lái)的 core_star.h。

將官方提供的 source 文件夾里面的文件整理到 libraries 和 mdk 目錄。

注：以上僅列出關(guān)鍵部分，其余詳見(jiàn)代碼倉(cāng)庫(kù)。

3.實(shí)現(xiàn) systisk

跟以往不同的是：本次使用的 SDK 里面已經(jīng)實(shí)現(xiàn)了對(duì)系統(tǒng)時(shí)鐘的初始化(system_mm32f5260.c)，我們僅需實(shí)現(xiàn) systisk 即可，代碼如下：

void SysTick_Init(void)
{
    uint32_t reload = 0;


    SysTick->CTRL &= (uint32_t)0xFFFFFFFB;


    reload = CLOCK_SYSTICK_FREQ/RT_TICK_PER_SECOND;
    reload--;


    SysTick->CTRL |= SysTick_CTRL_TICKINT_Msk;
    SysTick->LOAD = reload;
    SysTick->CTRL |= SysTick_CTRL_ENABLE_Msk;
}


void SysTick_Handler(void)
{
    /* enter interrupt */
    rt_interrupt_enter();


    rt_tick_increase();


    /* leave interrupt */
    rt_interrupt_leave();
}


void rt_hw_board_init()
{
    SysTick_Init();
    SystemClock_Config();


#if defined(RT_USING_HEAP)
    rt_system_heap_init(HEAP_BEGIN, (void *)HEAP_END);
#endif


#ifdef RT_USING_SERIAL
    extern int rt_hw_uart_init(void);
    rt_hw_uart_init();
#endif


#if defined(RT_USING_CONSOLE) && defined(RT_USING_DEVICE)
   rt_console_set_device(RT_CONSOLE_DEVICE_NAME);
#endif


#ifdef RT_USING_COMPONENTS_INIT
    rt_components_board_init();
#endif
}

移植效果

到此為止，基本上已經(jīng)完成了移植工作。

編譯，燒寫(xiě)，可以到 rt-thread 的打印：

查看開(kāi)發(fā)板可看到 LED2 隔 500ms 閃爍一次。

總結(jié)

本次移植過(guò)程修改的地方不多，主要是因?yàn)?SDK 變動(dòng)而做的修改。在此，可以看到靈動(dòng)微在維護(hù) hal 庫(kù)做出的努力。畢竟 hal 層兼容性越強(qiáng)，可以吸收更多潛在用戶，節(jié)省用戶熟悉 SDK 的時(shí)間，這也是國(guó)產(chǎn)芯片替代的必經(jīng)之路。

最后，感謝靈動(dòng)微和極術(shù)社區(qū)提供的平臺(tái)，也祝愿國(guó)產(chǎn)芯片越來(lái)越好。

倉(cāng)庫(kù)代碼： https://gitee.com/sakura96888/mm32f5260_rtt

轉(zhuǎn)自 | 極術(shù)社區(qū)