SPI 用户空间的读写操作
spi_device
虽然用户空间不需要直接用到spi_device结构体,但是这个结构体和用户空间的程序有密切的关系,理解它的成员有助于理解SPI设备节点的IOCTL命令,所以首先来介绍它。在内核中,每个spi_device代表一个物理的SPI设备:
struct spi_device {
structdevice dev;
structspi_master *master;
u32 max_speed_hz; /* 通信时钟最大频率 */
u8 chip_select; /* 片选号 */
u8 mode; /*SPI设备的模式,下面的宏是它各bit的含义 */
#define SPI_CPHA 0x01 /* 采样的时钟相位 */
#define SPI_CPOL 0x02 /* 时钟信号起始相位:高或者是低电平 */
#define SPI_MODE_0 (0|0)
#define SPI_MODE_1 (0|SPI_CPHA)
#define SPI_MODE_2 (SPI_CPOL|0)
#define SPI_MODE_3 (SPI_CPOL|SPI_CPHA)
#define SPI_CS_HIGH 0x04 /* 为1时片选的有效信号是高电平 */
#define SPI_LSB_FIRST 0x08 /* 发送时低比特在前 */
#define SPI_3WIRE 0x10 /* 输入输出信号使用同一根信号线 */
#define SPI_LOOP 0x20 /* 回环模式 */
u8 bits_per_word; /* 每个通信字的字长(比特数) */
int irq; /*使用到的中断 */
void *controller_state;
void *controller_data;
char modalias[32]; /* 设备驱动的名字 */
};
spi_device的mode成员有两个比特位含义很重要:
SPI_CPHA选择对数据线采样的时机,0选择每个时钟周期的第一个沿跳变时采样数据,1选择第二个时钟沿采样数据;
SPI_CPOL选择每个时钟周期开始的极性,0表示时钟以低电平开始,1选择高电平开始。
这两个比特有四种组合,对应SPI_MODE_0~SPI_MODE_3。
另一个比较重要的成员是bits_per_word。这个成员指定每次读写的字长,单位是比特。虽然大部分SPI接口的字长是8或者16,仍然会有一些特殊的例子。需要说明的是,如果这个成员为零的话,默认使用8作为字长。
最后一个成员并不是设备的名字,而是需要绑定的驱动的名字。
spi_ioc_transfer
linux中,应用开发常用的结构体主要是struct spi_ioc_transfer:
struct spi_ioc_transfer {
__u64 tx_buf;
__u64 rx_buf;
__u32 len;
__u32 speed_hz;
__u16 delay_usecs;
__u8 bits_per_word;
__u8 cs_change;
__u32 pad;
};
每个 spi_ioc_transfer都可以包含读和写的请求,其中读和写的长度必须相等。所以成员len不是tx_buf和rx_buf缓冲的长度之和,而是它们各自的长度。SPI控制器驱动会先将tx_buf写到SPI总线上,然后再读取len长度的内容到rx_buf。如果只想进行一个方向的传输,把另一个方向的缓冲置为0就可以了。
speed_hz和bits_per_word这两个成员可以为每次通信配置不同的通信速率(必须小于spi_device的max_speed_hz)和字长,如果它们为0的话就会使用spi_device中的配置。
delay_usecs可以指定两个spi_ioc_transfer之间的延时,单位是微妙。一般不用定义。
cs_change指定这个cs_change结束之后是否需要改变片选线。一般针对同一设备的连续的几个spi_ioc_transfer,只有最后一个需要将这个成员置位。这样省去了来回改变片选线的时间,有助于提高通信速率。
SPI设备的初始化
void spi_Init()
{
int ret = 0;
spifd = open(device, O_RDWR);
if (spifd < 0)
pabort("can't open device");
/*
* spi mode
*/
ret = ioctl(spifd, SPI_IOC_WR_MODE, &mode);
if (ret == -1)
pabort("can't set spi mode");
ret = ioctl(spifd, SPI_IOC_RD_MODE, &mode);
if (ret == -1)
pabort("can't get spi mode");
/*
* bits per word
*/
ret = ioctl(spifd, SPI_IOC_WR_BITS_PER_WORD, &bits);
if (ret == -1)
pabort("can't set bits per word");
ret = ioctl(spifd, SPI_IOC_RD_BITS_PER_WORD, &bits);
if (ret == -1)
pabort("can't get bits per word");
/*
* max speed hz
*/
ret = ioctl(spifd, SPI_IOC_WR_MAX_SPEED_HZ, &speed);
if (ret == -1)
pabort("can't set max speed hz");
ret = ioctl(spifd, SPI_IOC_RD_MAX_SPEED_HZ, &speed);
if (ret == -1)
pabort("can't get max speed hz");
}
首先open打开SPI的设备,然后通过ioctl函数进行数据位、速率、模式进行配置。
IOCTL命令
用户空间对spidev设备节点使用IOCTL命令失败会返回-1。
SPI_IOC_RD_MODE
读取SPI设备对应的spi_device.mode,使用的方法如下:
ioctl(fd,SPI_IOC_RD_MODE, &mode);
SPI_IOC_WR_MODE
设置SPI设备对应的spi_device.mode。使用的方式如下:
ioctl(fd,SPI_IOC_WR_MODE, &mode);
SPI_IOC_RD_LSB_FIRST
查看设备传输的时候是否先传输低比特位。如果是的话,返回1。使用的方式如下:
ioctl(fd,SPI_IOC_RD_LSB_FIRST, &lsb);
其中lsb是一个uint8_t类型的变量。返回的结果存在lsb中。
SPI_IOC_WR_LSB_FIRST
设置设备传输的时候是否先传输低比特位。当传入非零的时候,低比特在前,当传入0的时候高比特在前(默认)。使用的方式如下:
ioctl(fd,SPI_IOC_WR_LSB_FIRST, &lsb);
SPI_IOC_RD_BITS_PER_WORD
读取SPI设备的字长。使用的方式如下:
ioctl(fd,SPI_IOC_RD_BITS_PER_WORD, &bits);
其中bits是一个uibt8_t类型的变量。返回的结果保存在bits中。
SPI_IOC_WR_BITS_PER_WORD
设置SPI通信的字长。使用的方式如下:
ioctl(fd,SPI_IOC_WR_BITS_PER_WORD, &bits);
SPI_IOC_RD_MAX_SPEED_HZ
读取SPI设备的通信的最大时钟频率。使用的方式如下:
ioctl(fd,SPI_IOC_RD_MAX_SPEED_HZ, &speed);
SPI_IOC_MESSAGE(N)
一次进行双向/多次读写操作。使用的方式如下:
structspi_ioc_transfer xfer[2];
......
status= ioctl(fd, SPI_IOC_MESSAGE(2), xfer);
其中N是本次通信中xfer的数组长度。
SPI的读写
int spi_read()
{
bt_devide_msg msg;
unsigned char ucRegVal;
int ret,i;
unsigned char tx[20];
for(i = 0;i<20;i++)
{
tx[i] = 0xda;
}
unsigned char rx[ARRAY_SIZE(tx)] = {0, };
struct spi_ioc_transfer tr = {
.tx_buf = (unsigned long)tx,
.rx_buf = (unsigned long)rx,
.len = ARRAY_SIZE(tx),
.delay_usecs = udelay,
.speed_hz = speed,
.bits_per_word = bits,
};
ret = ioctl(fd, SPI_IOC_MESSAGE(1), &tr);
if (ret < 1)
{
printf("can't read spi message\n");
return -1;
}
if(rx[0] !=0xAA)
{
printf("read spi data: ");
for (ret = 0; ret < ARRAY_SIZE(tx); ret++)
{
printf("%02X ", rx[ret]);
}
printf("\n");
}
ucRegVal = rx[ARRAY_SIZE(tx)-1];
get_data_process(rx);
return 1;
测试:
void main()
{
spi_init();
spi_read();
}