【S32K146RT-thread】之SPI驱动适配

RTThread物联网操作系统 2024-10-31 18:16

【有奖直播】无线前沿新技术与测试技术峰会 如何应对供应风险和挑战，在行业竞争中赢得先机？

概述

RT-Thread 对SPI总线的驱动，抽象出了spi bus 的设备驱动，我们基于S32K146 的硬件学习spi bus 设备驱动。

RT-Thread 官方文档https://www.rt-thread.org/document/site/#/rt-thread-version/rt-thread-standard/programming-manual/device/spi/spi对SPI总线驱动有详细说明。

SPI总线驱动适配

驱动涉及的主要结构体为如下:

rt_spi_device:app 通过该结构体和bus 绑定通过bus 控制spi总线
rt_spi_bus spi bus总线设备抽象
rt_spi_ops bus设备依赖的底层操作函数

结构体关系如下：

对于总线设备的驱动对接我们需要实现对应的ops函数。

使用S32 Design Studio 工具配置spi1

本次实验使用的是lpspi1 ,首先使用S32 Design Studio 工具生成pinmux 和 clk 初始化配置代码。

配置SPI1 master 参数

配置pimmux

配置clk

适配SPI1 ops 函数至RT-Thread

根据上面的梳理，依赖芯片层实现ops函数并开启spi设备驱动

config ops函数

tatic rt_err_t spi_configure(struct rt_spi_device* device,
                          struct rt_spi_configuration* configuration)
{
    struct rt_spi_bus * spi_bus = (struct rt_spi_bus *)device->bus;
    struct s32k_spi *spi_device = (struct s32k_spi *)spi_bus->parent.user_data;
    status_t ret;


    RT_ASSERT(device != RT_NULL);
    RT_ASSERT(configuration != RT_NULL);


    /* config spi init spi bus */
    //LPSPI_DRV_MasterDeinit(spi_device->instance);


    switch(configuration->mode & RT_SPI_MODE_3)
    {
    case RT_SPI_MODE_0:
        spi_device->masterconfig->clkPhase = LPSPI_CLOCK_PHASE_2ND_EDGE;
        spi_device->masterconfig->clkPolarity = LPSPI_SCK_ACTIVE_LOW;
        break;
    case RT_SPI_MODE_1:
        spi_device->masterconfig->clkPhase = LPSPI_CLOCK_PHASE_1ST_EDGE;
        spi_device->masterconfig->clkPolarity = LPSPI_SCK_ACTIVE_LOW;
        break;
    case RT_SPI_MODE_2:
        spi_device->masterconfig->clkPhase = LPSPI_CLOCK_PHASE_2ND_EDGE;
        spi_device->masterconfig->clkPolarity = LPSPI_SCK_ACTIVE_HIGH;
        break;
    case RT_SPI_MODE_3:
        spi_device->masterconfig->clkPhase = LPSPI_CLOCK_PHASE_1ST_EDGE;
        spi_device->masterconfig->clkPolarity = LPSPI_SCK_ACTIVE_HIGH;
        break;
    }


    /* MSB or LSB */
    if(configuration->mode & RT_SPI_MSB)
    {
        spi_device->masterconfig->lsbFirst = false;
    }
    else
    {
        spi_device->masterconfig->lsbFirst = true;
    }


    if(configuration->max_hz < 10000000)
        spi_device->masterconfig->bitsPerSec = configuration->max_hz;


    spi_device->masterconfig->bitcount = configuration->data_width;


    ret = LPSPI_DRV_MasterInit(spi_device->instance,spi_device->status,spi_device->masterconfig);
    RT_ASSERT(ret == STATUS_SUCCESS);


    ret = LPSPI_DRV_MasterSetDelay(spi_device->instance, 1, 1, 1);
    RT_ASSERT(ret == STATUS_SUCCESS);


    return ret == STATUS_SUCCESS ? RT_EOK:RT_ERROR;

xfer ops 函数

truct s32k_spi
{
    struct rt_spi_bus spi_bus;  /* spi bus device */
    lpspi_master_config_t * masterconfig; /* lpspi master config */
    lpspi_state_t * status;   /* lpspi driver status */
    uint32_t instance;  /* spi instance id */
    char * bus_name;
}s32k_spi_t;


static rt_ssize_t spixfer(struct rt_spi_device* device, struct rt_spi_message* message){
    struct rt_spi_bus * spi_bus = (struct rt_spi_bus *)device->bus;
    struct s32k_spi *spi_device = (struct s32k_spi *)spi_bus->parent.user_data;
    status_t ret;


    RT_ASSERT(device != NULL);
    RT_ASSERT(message != NULL);




    ret = LPSPI_DRV_MasterTransferBlocking(spi_device->instance,message->send_buf,message->recv_buf,message->length,1000);     
    RT_ASSERT(ret == STATUS_SUCCESS);


    return ret == STATUS_SUCCESS ? message->length:0;

添加如下初始化代码像系统注册spibus设备

xtern void LPSPI_DRV_IRQHandler(uint32_t instance);


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


    LPSPI_DRV_IRQHandler(1);


    /* leave interrupt */
    rt_interrupt_leave();
}


/* private rt-thread spi ops function */
static struct rt_spi_ops s32k_spi_ops =
{
    .configure = spi_configure,
    .xfer = spixfer,
};


static struct s32k_spi spi1;




int rt_hw_spi_init(void){
    int result = 0;


    /* config spi strruct */
    spi1.instance = INST_LPSPI_1;
    spi1.masterconfig = &lpspi_1_MasterConfig0;
    spi1.status = &lpspi_1State;
    spi1.spi_bus.parent.user_data = (void *)&spi1;
    spi1.bus_name = "spi1";


    result = rt_spi_bus_register(&spi1.spi_bus, spi1.bus_name, &s32k_spi_ops);


    RT_ASSERT(result == RT_EOK);


    LOG_D("%s bus init done", spi1.bus_name);


    if(result == RT_EOK)
    {
        INT_SYS_InstallHandler(LPSPI1_IRQn,S32K14X_LPspi1_Master_Slave_IRQHandler,NULL);
    }




    return result;
}


INIT_APP_EXPORT(rt_hw_spi_init);

验证

添加如下测试代码输入 spi10 open/config/readid 命令打开并挂载到spi1总线，并读取板子上的spi flash 的id信息

include 
#include 
#include 
#include 
#include 


#define SPF_R_JEDEC_CMD   (0x9Fu)
#define SPF_R_JEDEC_LEN   (4u)


struct rt_spi_device spi1_device;


static void spi10(int argc,char *argv[]){
     rt_err_t ret;
     struct rt_spi_configuration cfg;
     uint8_t sendbuff[4] = {SPF_R_JEDEC_CMD,0x00,0x00,0x00};
     uint8_t recvbuff[4] = {0x00,0x00,0x00,0x00};


     if(!strcmp(argv[1], "readid"))
    {
        rt_spi_transfer(&spi1_device,sendbuff,recvbuff,4);
        rt_kprintf("read did [%x][%x][%x]\n",recvbuff[1],recvbuff[2],recvbuff[3]);
    }
    else if(!strcmp(argv[1], "open"))
    {
        ret = rt_spi_bus_attach_device(&spi1_device,"spi10","spi1",NULL);
        if(ret != RT_EOK)
          rt_kprintf("attach spi1 faied %d\n",ret);
    }
    else if(!strcmp(argv[1], "config"))
    {
        cfg.data_width = 8;
        cfg.max_hz = 8000000;
        cfg.mode = RT_SPI_MODE_3 | RT_SPI_MSB;
        rt_spi_configure(&spi1_device,&cfg);
    }
    else if(!strcmp(argv[1], "read"))
    {


    }
}
MSH_CMD_EXPORT(spi10, spi10 flash test)