4. SPI通信¶
本章主要围绕带有26Pin引脚的LubanCat-H618系列的板卡,如下
LubanCat-A1
26pin引脚中只有一组spi接口SCK,MOSI,MISO,有两个默认片选信号CS0,CS1
4.1. SPI引脚关系¶
LubanCat-H618系列的板卡都带有一组SPI,引脚关系如下表所示
SPI |
功能 |
---|---|
MOSI |
主设备输出/从设备输入 |
MISO |
主设备输入/从设备输出 |
CLK |
时钟信号线 |
CS0 |
片选信号线0 |
CS1 |
片选信号线1 |
spidev1.0控制CS0,spidev1.1控制CS1
以LubanCat-A1为例,引脚如下图所示:

对应实物的26pin接口
4.2. 使能SPI通信接口¶
SPI接口在默认情况是关闭状态的,需要使能才能使用, SPI接口的设备树插件有1个:
h618-lubancat-spi1-overlay.dtbo
h618-lubancat-spi1-overlay.dtbo是使用了SPI_MOSI,SPI_MISO,SPI_CLK,SPI_CS0,SPI_CS1这五个引脚
下面演示LubanCat-A1的开启SPI设备树插件。
可以通过打开 /boot/uEnv.txt 查看是否启用了spi相关设备设备树插件。
选择需要开启的设备树插件,粘贴到 overlays=
后面,多个设备树插件开启,设备树插件之间要用空格隔开,如下图:

然后重启激活设备
注解
如果是直接拔电源的方式重启,会有可能出现文件没能做出修改 (原因:文件未能及时从内存同步到存储设备中,解决方法,在终端上输入 “sync” 再拔电关机)
4.3. 检查SPI设备¶
使能spi设备树插件之后重新启动板卡,通过SPI设备文件来判断spi驱动是否加载成功。 SPI_1对应的设备文件是spidev1.0和spidev1.1
如下所示
1 2 3 | root@lubancat:/home/cat# ls /dev/spi*
/dev/spidev1.0 /dev/spidev1.1
root@lubancat:/home/cat#
|
小技巧
spidev1.0和spidev1.1的区别在于片选信号的不同,spidev1.0使用CS0 , spidev1.1使用CS1
4.4. 回环测试程序¶
1 2 3 4 5 6 | #如之前有获取则可跳过
#获取仓库
git clone https://gitee.com/LubanCat/lubancat_allwinner_code_storage
#代码所在的位置
lubancat_allwinner_code_storage/quick_start/spi
|
根据ioctl相关参数即可编写spi相关测试程序,此处为了简单仅做回环测试实验, 只需要将SPI3的 MIOS与MOSI引脚(板卡上的19和21)使用跳线帽短接即可。
如下图所示

1 | quick_start/spi/spi_selftest.c
|
代码较长复制粘贴容易乱序,可以下载我们提供的源码 spi_selftest.c
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 | #include <sys/ioctl.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>
#include <unistd.h>
#include <stdio.h>
#include <stdlib.h>
#include <stdint.h>
#include <linux/spi/spidev.h>
#define SPI_DEV_PATH "/dev/spidev3.0"
/*SPI 接收 、发送 缓冲区*/
unsigned char tx_buffer[100] = "hello the world !";
unsigned char rx_buffer[100];
int fd; // SPI 控制引脚的设备文件描述符
static unsigned mode = SPI_MODE_2; //用于保存 SPI 工作模式
static uint8_t bits = 8; // 接收、发送数据位数
static uint32_t speed = 10000000; // 发送速度
static uint16_t delay; //保存延时时间
void transfer(int fd, uint8_t const *tx, uint8_t const *rx, size_t len)
{
int ret;
struct spi_ioc_transfer tr = {
.tx_buf = (unsigned long)tx,
.rx_buf = (unsigned long)rx,
.len = len,
.delay_usecs = delay,
.speed_hz = speed,
.bits_per_word = bits,
.tx_nbits = 1,
.rx_nbits = 1
};
ret = ioctl(fd, SPI_IOC_MESSAGE(1), &tr);
if (ret < 1)
printf("can't send spi message\n");
}
void spi_init(int fd)
{
int ret = 0;
// spi mode 设置SPI 工作模式
ret = ioctl(fd, SPI_IOC_WR_MODE32, &mode);
if (ret == -1)
printf("can't set spi mode\n");
// bits per word 设置一个字节的位数
ret = ioctl(fd, SPI_IOC_WR_BITS_PER_WORD, &bits);
if (ret == -1)
printf("can't set bits per word\n");
// max speed hz 设置SPI 最高工作频率
ret = ioctl(fd, SPI_IOC_WR_MAX_SPEED_HZ, &speed);
if (ret == -1)
printf("can't set max speed hz\n");
// 打印
printf("spi mode: 0x%x\n", mode);
printf("bits per word: %d\n", bits);
printf("max speed: %d Hz (%d KHz)\n", speed, speed / 1000);
}
int main(int argc, char *argv[])
{
int fd;
if(argc < 2){
printf("Wrong use !!!!\n");
printf("Usage: %s [dev]\n",argv[0]);
return -1;
}
/*打开 SPI 设备*/
fd = open(argv[1], O_RDWR); // open file and enable read and write
if (fd < 0){
printf("Can't open %s \n",argv[1]); // open i2c dev file fail
exit(1);
}
/*初始化SPI */
spi_init(fd);
/*执行发送*/
transfer(fd, tx_buffer, rx_buffer, sizeof(tx_buffer));
/*打印 tx_buffer 和 rx_buffer*/
printf("tx_buffer: \n %s\n ", tx_buffer);
printf("rx_buffer: \n %s\n ", rx_buffer);
close(fd);
return 0;
}
|
4.4.1. 编译运行¶
1 2 3 4 | #编译
gcc spi_selftest.c -o spi_selftest
#运行
sudo ./spi_selftest /dev/spidev1.x
|
效果如下图所示

如果mosi和mosi不接测试,会出现乱码或者空白内容