本文主要介绍RT-thread中的SPI设备驱动，涉及到的文件主要有：驱动框架文件（spi_dev.c，spi_core.c，spi.h），底层硬件驱动文件（spi_hard.c，spi_hard.h）。这里spi_hard.c和spi_hard.h是指利用MCU的硬件SPI接口，而不是通过GPIO口来模拟SPI时序。应用SPI设备驱动时，需要在rtconfig.h中宏定义#define RT_USING_SPI。
一、SPI设备驱动框架
先来看spi.h中的一些数据结构：
**
* SPI message structure
*/
struct rt_spi_message
{
const void *send_buf;
void *recv_buf;
rt_size_t length;
struct rt_spi_message *next; unsigned cs_take : ;
unsigned cs_release : ;
}; /**
* SPI configuration structure
*/
struct rt_spi_configuration
{
rt_uint8_t mode;
rt_uint8_t data_width;
rt_uint16_t reserved; rt_uint32_t max_hz;
}; struct rt_spi_ops;
struct rt_spi_bus
{
struct rt_device parent;
const struct rt_spi_ops *ops; struct rt_mutex lock;
struct rt_spi_device *owner;
}; /**
* SPI operators
*/
struct rt_spi_ops
{
rt_err_t (*configure)(struct rt_spi_device *device, struct rt_spi_configuration *configuration);
rt_uint32_t (*xfer)(struct rt_spi_device *device, struct rt_spi_message *message);
};
/**
* SPI Virtual BUS, one device must connected to a virtual BUS
*/
struct rt_spi_device
{
struct rt_device parent;
struct rt_spi_bus *bus; struct rt_spi_configuration config;
};
#define SPI_DEVICE(dev) ((struct rt_spi_device *)(dev))
spi_core.c,spi_dev.c这两个文件位于RTT\components\drivers\spi目录下，而spi.h头文件位于RTT\\components\drivers\include\drivers目录下。可在MKD工程的Drivers组下将上面两个源文件加进行，并将spi.h头文件所在目录添加到工程的include path下。
spi_core.c文件实现了spi的抽象操作，如注册spi总线(spi_bus)，向SPI总线添加设备函数等。注: 这里将MCU的一路spi外设虚拟成spi总线，然后总线上可以挂很多spi设备(spi_device)，一个spi_device有一个片选cs。spi总线和spi设备要在RTT中可以生效就必须先向RTT注册,因此就需要使用上面的注册SPI总线函数和向SPI总线中添加SPI设备。
spi_core.c还包含了配置SPI函数，发送和接收等通信函数，占用和释放SPI总线函数及选择SPI设备函数。这些函数都是抽象出来的，反映出SPI总线上的一些常规操作。真正执行这些操作的过程并不在spi_core.c源文件中，实际上，这些操作信息都是通过注册SPI总线和向总线添加SPI设备时这些操作集就已经"注册"下来了，真正操作时是通过注册信息内的操作函数去实现,也可以说是一种回调操作。spi_core.c中实现的函数主要有：rt_spi_bus_register(); rt_spi_bus_attach_device(); rt_spi_configure(); rt_spi_send_then_send(); rt_spi_send_then_recv(); rt_spi_transfer(); rt_spi_transfer_message(); rt_spi_take_bus(); rt_spi_release_bus(); rt_spi_take(); rt_spi_release()。
而spi_dev.c实现了SPI设备的一些抽象操作，比如读，写，打开，关闭，初始化等，当然当MCU操作SPI设备的时候，是需要通过SPI总线与SPI设备进行通信的，既然通信就必然会有SPI通信协议，但是通信协议并不在这里具体，spi_dev.c这里还只是SPI设备的抽象操作而已，它只是简单地调用spi_core.c源文件中的抽象通信而已，具体实现还是要靠上层通过SPI总线或SPI设备注册下来的信息而实现的。spi_device.c中实现的函数主要有:_spi_bus_device_read(); _spi_bus_device_write(); _spi_bus_device_control(); rt_spi_bus_device_init();_spidev_device_read();_spidev_device_write();_spidev_device_control();rt_spidev_device_init()。
在确保了spi_core.c，spi_dev.c和spi.h这三个源文件在MDK工程内之后，接着往下走。
二、底层硬件驱动
在spi_hard.c中实现configure和xfer函数（默认没有使用DMA）：
static struct rt_spi_ops stm32_spi_ops =
{
configure,
xfer
};
然后，向RT-thread注册spi总线：
struct stm32_spi_bus
{
struct rt_spi_bus parent; SPI_TypeDef * SPI; #ifdef SPI_USE_DMA
DMA_Stream_TypeDef * DMA_Stream_TX;
uint32_t DMA_Channel_TX; DMA_Stream_TypeDef * DMA_Stream_RX;
uint32_t DMA_Channel_RX; uint32_t DMA_Channel_TX_FLAG_TC;
uint32_t DMA_Channel_RX_FLAG_TC;
#endif /* #ifdef SPI_USE_DMA */
}; struct stm32_spi_cs
{
GPIO_TypeDef * GPIOx;
uint16_t GPIO_Pin;
};
rt_err_t stm32_spi_register(SPI_TypeDef * SPI,
struct stm32_spi_bus * stm32_spi,
const char * spi_bus_name)
{
if(SPI == SPI1)
{
stm32_spi->SPI = SPI1;
RCC_APB2PeriphClockCmd(RCC_APB2Periph_SPI1, ENABLE);//84MHZ #ifdef SPI_USE_DMA
RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_DMA2, ENABLE);
/* DMA2_Stream0 DMA_Channel_3 : SPI1_RX ; DMA2_Stream2 DMA_Channel_3 : SPI1_RX */
stm32_spi->DMA_Stream_RX = DMA2_Stream0;
stm32_spi->DMA_Channel_RX = DMA_Channel_3;
stm32_spi->DMA_Channel_RX_FLAG_TC = DMA_FLAG_TCIF0;
/* DMA2_Stream3 DMA_Channel_3 : SPI1_TX ; DMA2_Stream5 DMA_Channel_3 : SPI1_TX */
stm32_spi->DMA_Stream_TX = DMA2_Stream3;
stm32_spi->DMA_Channel_TX = DMA_Channel_3;
stm32_spi->DMA_Channel_TX_FLAG_TC = DMA_FLAG_TCIF3;
#endif
}
else if(SPI == SPI2)
{
stm32_spi->SPI = SPI2;
RCC_APB1PeriphClockCmd(RCC_APB1Periph_SPI2, ENABLE);//42MHZ #ifdef SPI_USE_DMA
RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_DMA1, ENABLE);
/* DMA1_Stream3 DMA_Channel_0 : SPI2_RX */
stm32_spi->DMA_Stream_RX = DMA1_Stream3;
stm32_spi->DMA_Channel_RX = DMA_Channel_0;
stm32_spi->DMA_Channel_RX_FLAG_TC = DMA_FLAG_TCIF3;
/* DMA1_Stream4 DMA_Channel_0 : SPI2_TX */
stm32_spi->DMA_Stream_TX = DMA1_Stream4;
stm32_spi->DMA_Channel_TX = DMA_Channel_0;
stm32_spi->DMA_Channel_TX_FLAG_TC = DMA_FLAG_TCIF4;
#endif
}
else if(SPI == SPI3)
{
stm32_spi->SPI = SPI3;
RCC_APB1PeriphClockCmd(RCC_APB1Periph_SPI3, ENABLE);//42MHZ #ifdef SPI_USE_DMA
RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_DMA1, ENABLE);
/* DMA1_Stream2 DMA_Channel_0 : SPI3_RX ; DMA1_Stream0 DMA_Channel_0 : SPI3_RX */
stm32_spi->DMA_Stream_RX = DMA1_Stream2;
stm32_spi->DMA_Channel_RX = DMA_Channel_0;
stm32_spi->DMA_Channel_RX_FLAG_TC = DMA_FLAG_TCIF2;
/* DMA1_Stream5 DMA_Channel_0 : SPI3_TX ; DMA1_Stream7 DMA_Channel_0 : SPI3_TX */
stm32_spi->DMA_Stream_TX = DMA1_Stream5;
stm32_spi->DMA_Channel_TX = DMA_Channel_0;
stm32_spi->DMA_Channel_TX_FLAG_TC = DMA_FLAG_TCIF5;
#endif
}
else
{
return RT_ENOSYS;
} return rt_spi_bus_register(&stm32_spi->parent, spi_bus_name, &stm32_spi_ops);
}
最后，进行spi硬件初始化，并挂载spi设备到已注册的spi总线。
int rt_hw_spi1_init(void)
{
/* register SPI bus */
static struct stm32_spi_bus stm32_spi; //it must be add static /* SPI1 configure */
{
GPIO_InitTypeDef GPIO_InitStructure; /* Enable GPIO Periph clock */
RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOA , ENABLE); GPIO_PinAFConfig(GPIOA, GPIO_PinSource5, GPIO_AF_SPI1);
GPIO_PinAFConfig(GPIOA, GPIO_PinSource6, GPIO_AF_SPI1);
GPIO_PinAFConfig(GPIOA, GPIO_PinSource7, GPIO_AF_SPI1); GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_InitStructure.GPIO_OType = GPIO_OType_PP;
GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_NOPULL; /* Configure SPI1 pins */
GPIO_InitStructure.GPIO_Pin = GPIO_Pin_5;
GPIO_Init(GPIOA, &GPIO_InitStructure);
GPIO_InitStructure.GPIO_Pin = GPIO_Pin_6;
GPIO_Init(GPIOA, &GPIO_InitStructure);
GPIO_InitStructure.GPIO_Pin = GPIO_Pin_7;
GPIO_Init(GPIOA, &GPIO_InitStructure);
} /* SPI1 configuration */ /* register SPI1 to stm32_spi_bus */
stm32_spi_register(SPI1, &stm32_spi, "spi1"); /* attach spi10 */
{
static struct rt_spi_device rt_spi_device_10; //it must be add static
static struct stm32_spi_cs stm32_spi_cs_10; //it must be add static stm32_spi_cs_10.GPIOx = GPIOE;
stm32_spi_cs_10.GPIO_Pin = GPIO_Pin_3; RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOE, ENABLE); GPIO_InitTypeDef GPIO_InitStructure;
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_OUT;
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
GPIO_InitStructure.GPIO_OType = GPIO_OType_PP;
GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_NOPULL;
GPIO_InitStructure.GPIO_Pin = GPIO_Pin_3;
GPIO_Init(GPIOE, &GPIO_InitStructure);
GPIO_SetBits(GPIOE, GPIO_Pin_3); rt_spi_bus_attach_device(&rt_spi_device_10, "spi10", "spi1", (void*)&stm32_spi_cs_10);//set spi_device->bus
/* config spi */
{
struct rt_spi_configuration cfg;
cfg.data_width = ;
cfg.mode = RT_SPI_MODE_3 | RT_SPI_MSB; /* SPI Compatible Modes 3 and SPI_FirstBit_MSB in lis302dl datasheet */ //APB2=168M/2=84M, SPI1 = 84/2,4,8,16,32 = 42M, 21M, 10.5M, 5.25M, 2.625M ...
cfg.max_hz = ; /* SPI_BaudRatePrescaler_16=84000000/16=5.25MHz. The max_hz of lis302dl is 10MHz in datasheet */
rt_spi_configure(&rt_spi_device_10, &cfg);
} /* config spi */
} /* attach spi10 */ return ;
}
INIT_BOARD_EXPORT(rt_hw_spi1_init);//rt_hw_spi1_init will be called in rt_components_board_init()
三、SPI设备初始化
这里以lis302dl三轴加速度计为例：
static rt_err_t lis302dl_init(const char * spi_device_name)
{
rt_uint8_t chip_id, ctrl, temp; spi_device = (struct rt_spi_device *)rt_device_find(spi_device_name);
if(spi_device == RT_NULL)
{
rt_kprintf("\nspi_device %s for lis302dl not found!\n", spi_device_name);
return -RT_ENOSYS;
} // /* If not use rt_device_write or rt_device_read, then it's no necessary to rt_device_open */
// /* oflag has no meaning for spi device , so set to RT_NULL */
// if(rt_device_open(&spi_device->parent, RT_NULL) != RT_EOK)
// {
// rt_kprintf("\nspi_device %s for lis302dl opened failed!\n", spi_device_name);
// return -RT_EEMPTY;
// } LIS302DL_InitTypeDef LIS302DL_InitStruct;
LIS302DL_FilterConfigTypeDef LIS302DL_FilterStruct;
/* Set configuration of LIS302DL*/
LIS302DL_InitStruct.Output_DataRate = LIS302DL_DATARATE_100;
LIS302DL_InitStruct.Power_Mode = LIS302DL_LOWPOWERMODE_ACTIVE;
LIS302DL_InitStruct.Full_Scale = LIS302DL_FULLSCALE_2_3;
LIS302DL_InitStruct.Self_Test = LIS302DL_SELFTEST_NORMAL;
LIS302DL_InitStruct.Axes_Enable = LIS302DL_XYZ_ENABLE;
LIS302DL_Init(&LIS302DL_InitStruct);
/* MEMS High Pass Filter configuration */
LIS302DL_FilterStruct.HighPassFilter_Data_Selection = LIS302DL_FILTEREDDATASELECTION_OUTPUTREGISTER;
LIS302DL_FilterStruct.HighPassFilter_Interrupt = LIS302DL_HIGHPASSFILTERINTERRUPT_1_2;
LIS302DL_FilterStruct.HighPassFilter_CutOff_Frequency = LIS302DL_HIGHPASSFILTER_LEVEL_1;
LIS302DL_FilterConfig(&LIS302DL_FilterStruct); /* not use internal high pass filter and INT2 */
ctrl=0x04;//enable INT1 Data ready interrupt; interrupt active high; pull-push;
LIS302DL_Write(&ctrl, LIS302DL_CTRL_REG3_ADDR, );
LIS302DL_Read(&temp, LIS302DL_CTRL_REG3_ADDR, );
if(temp == ctrl)
rt_kprintf("the LIS302DL_CTRL_REG3_ADDR(value 0x%02x) verify passed!\n", temp);
else
rt_kprintf("the LIS302DL_CTRL_REG3_ADDR(value 0x%02x) verify failed!\n", temp); /* Required delay for the MEMS Accelerometre: Turn-on time = 3/Output data Rate = 3/100 = 30ms in datasheet */
//rt_thread_delay(30);
extern void stm32_mdelay(rt_uint32_t ms);
stm32_mdelay(); /* power_mode is active */
LIS302DL_Read(&chip_id, LIS302DL_WHO_AM_I_ADDR, );
rt_kprintf("(chip_id of lis302dl is 0x%02x)", chip_id); return ;
} int rt_lis302dl_init(void)
{
rt_sem_init(&sem_lis302dl, "lis302dl", , RT_IPC_FLAG_FIFO); lis302dl_interrupt_int1(); lis302dl_init("spi10"); return ;
}
INIT_APP_EXPORT(rt_lis302dl_init);
注意事项：
1、若需要使用rt_device_read()或rt_device_write()函数，则必须先调用rt_device_open()打开spi设备，保证该设备的ref_count大于0。硬件初始化函数中不需要调用rt_device_open()打开spi总线，因为在rt_spi_bus_attach_device()函数中没有初始化bus->owner，从而会导致调用_spi_bus_device_read()或_spi_bus_device_write()时“RT_ASSERT(bus->owner != RT_NULL);”断言语句进入死循环。而 _spidev_device_read()或_spidev_device_write()中断言语句“RT_ASSERT(device->bus != RT_NULL);”正常通过。
2、在使用SPI设备驱动操作数字芯片的寄存器时，需谨慎使用rt_device_read()和rt_device_write()函数。因为根据spi读写时序，spi读写一次最少要连续操作2个字节数据（第一个为寄存器地址值，第二个为待读取或待写入的字节数据），并且在这2个字节数据之间CS信号不能拉高，而rt_device_read()和rt_device_write()函数仅操作一个字节后，cs信号拉高，导致字节数据不能正常读取或写入相应寄存器。所以，一般情况下在SPI工作在全双工模式时，读写数字芯片寄存器的函数中直接使用spi_core.c中的rt_spi_transfer()、rt_spi_send_then_recv()、rt_spi_send_then_send()三个函数，如下所示：
void LIS302DL_Write(rt_uint8_t* pBuffer, rt_uint8_t WriteAddr, rt_uint16_t NumByteToWrite)
{
/* Configure the MS bit:
- When 0, the address will remain unchanged in multiple read/write commands.
- When 1, the address will be auto incremented in multiple read/write commands.
*/
if(NumByteToWrite > 0x01)
{
WriteAddr |= (rt_uint8_t)MULTIPLEBYTE_CMD;
} /* the CS can't pull up between &WriteAddr and pBuffer */
//rt_device_write(&spi_device->parent, RT_NULL, &WriteAddr, 1);
//rt_device_write(&spi_device->parent, RT_NULL, pBuffer, NumByteToWrite);
rt_spi_send_then_send(spi_device, &WriteAddr, , pBuffer, NumByteToWrite);// transfer NumByteToWrite+1 bytes
} void LIS302DL_Read(rt_uint8_t* pBuffer, rt_uint8_t ReadAddr, rt_uint16_t NumByteToRead)
{
/* Configure the MS bit:
- When 0, the address will remain unchanged in multiple read/write commands.
- When 1, the address will be auto incremented in multiple read/write commands.
*/
if(NumByteToRead > 0x01)
{
ReadAddr |= (rt_uint8_t)(READWRITE_CMD | MULTIPLEBYTE_CMD);
}
else
{
ReadAddr |= (rt_uint8_t)READWRITE_CMD;
} /* the CS can't pull up between &WriteAddr and pBuffer */
//rt_device_write(&spi_device->parent, RT_NULL, &ReadAddr, 1);
//rt_device_read(&spi_device->parent, RT_NULL, pBuffer, NumByteToRead);
rt_spi_send_then_recv(spi_device, &ReadAddr, , pBuffer, NumByteToRead);// transfer NumByteToRead+1 bytes
}
3、对于可读取寄存器值的数字芯片，在写入字节数据后可通过读取相同寄存器，判断读出的值与写入的值是否一致，从而判断寄存器写操作是否正确，如下：
void LIS302DL_Init(LIS302DL_InitTypeDef *LIS302DL_InitStruct)
{
rt_uint8_t ctrl = 0x00; /* Configure MEMS: data rate, power mode, full scale, self test and axes */
ctrl = (rt_uint8_t) (LIS302DL_InitStruct->Output_DataRate | LIS302DL_InitStruct->Power_Mode | \
LIS302DL_InitStruct->Full_Scale | LIS302DL_InitStruct->Self_Test | \
LIS302DL_InitStruct->Axes_Enable); /* Write value to MEMS CTRL_REG1 regsister */
LIS302DL_Write(&ctrl, LIS302DL_CTRL_REG1_ADDR, ); rt_uint8_t temp = 0x00;
LIS302DL_Read(&temp, LIS302DL_CTRL_REG1_ADDR, );
if(temp == ctrl)
rt_kprintf("\nthe LIS302DL_CTRL_REG1_ADDR(value 0x%02x) verify passed!\n", temp);
else
rt_kprintf("\nthe LIS302DL_CTRL_REG1_ADDR(value 0x%02x) verify failed!\n", temp);
}
