SPI设备树处理过程

上一篇我们讲了SPI的总线驱动模型，这一节呢，我们来讲讲SPI设备树是怎么处理的：

我们再回头来看看spi_device结构体：

spi_device结构体：

各个成员含义如下：

• max_speed_hz：该设备能支持的SPI时钟最大值

• chip_select：是这个spi_master下的第几个设备

  • 在spi_master中有一个cs_gpios数组，里面存放有下面各个spi设备的片选引脚

  • spi_device的片选引脚就是：cs_gpios[spi_device.chip_select]

• cs_gpio：这是可选项，也可以把spi_device的片选引脚记录在这里

• bits_per_word：每个基本的SPI传输涉及多少位

  • word：我们使用SPI控制器时，一般是往某个寄存器里写入数据，SPI控制器就会把这些数据一位一位地发送出去

  • 一个寄存器是32位的，被称为一个word(有时候也称为double word)

  • 这个寄存器里多少位会被发送出去？使用bits_per_word来表示

  • 扩展：bits_per_word是可以大于32的，也就是每次SPI传输可能会发送多于32位的数据，这适用于DMA突发传输

• mode：含义广泛，看看结构体里那些宏

  • SPI_CPHA：在第1个周期采样，在第2个周期采样？

  • SPI_CPOL：平时时钟极性

    • SPI_CPHA和SPI_CPOL组合起来就可以得到4种模式

    • SPI_MODE_0：平时SCK为低(SPI_CPOL为0)，在第1个周期采样(SPI_CPHA为0)

    • SPI_MODE_1：平时SCK为低(SPI_CPOL为0)，在第2个周期采样(SPI_CPHA为1)

    • SPI_MODE_2：平时SCK为高(SPI_CPOL为1)，在第1个周期采样(SPI_CPHA为0)

    • SPI_MODE_3：平时SCK为高(SPI_CPOL为1)，在第2个周期采样(SPI_CPHA为1)

  • SPI_CS_HIGH：一般来说片选引脚时低电平有效，SPI_CS_HIGH表示高电平有效

  • SPI_LSB_FIRST：

    • 一般来说先传输MSB(最高位)，SPI_LSB_FIRST表示先传LSB(最低位)；

    • 很多SPI控制器并不支持SPI_LSB_FIRST

  • SPI_3WIRE：SO、SI共用一条线

  • SPI_LOOP：回环模式，就是SO、SI连接在一起

  • SPI_NO_CS：只有一个SPI设备，没有片选信号，也不需要片选信号

  • SPI_READY：SPI从设备可以拉低信号，表示暂停、表示未就绪

  • SPI_TX_DUAL：发送数据时有2条信号线

  • SPI_TX_QUAD：发送数据时有4条信号线

  • SPI_RX_DUAL：接收数据时有2条信号线

  • SPI_RX_QUAD：接收数据时有4条信号线

SPI设备树格式：

对于SPI Master，就是SPI控制器，它下面可以连接多个SPI设备。

在设备树里，使用一个节点来表示SPI Master，使用子节点来表示挂在下面的SPI设备。

SPI Master：
 

在设备树中，对于SPI Master，必须的属性如下：

• #address-cells：这个SPI Master下的SPI设备，需要多少个cell来表述它的片选引脚

• #size-cells：必须设置为0

• compatible：根据它找到SPI Master驱动

可选的属性如下：

• cs-gpios：SPI Master可以使用多个GPIO当做片选，可以在这个属性列出那些GPIO

• num-cs：片选引脚总数

其他属性都是驱动程序相关的，不同的SPI Master驱动程序要求的属性可能不一样。

SPI Device

 

在SPI Master对应的设备树节点下，每一个子节点都对应一个SPI设备，这个SPI设备连接在该SPI Master下面。

这些子节点中，必选的属性如下：

• compatible：根据它找到SPI Device驱动

• reg：用来表示它使用哪个片选引脚

• spi-max-frequency：必选，该SPI设备支持的最大SPI时钟

可选的属性如下：

• spi-cpol：这是一个空属性(没有值)，表示CPOL为1，即平时SPI时钟为低电平

• spi-cpha：这是一个空属性(没有值)，表示CPHA为1)，即在时钟的第2个边沿采样数据

• spi-cs-high：这是一个空属性(没有值)，表示片选引脚高电平有效

• spi-3wire：这是一个空属性(没有值)，表示使用SPI 三线模式

• spi-lsb-first：这是一个空属性(没有值)，表示使用SPI传输数据时先传输最低位(LSB)

• spi-tx-bus-width：表示有几条MOSI引脚；没有这个属性时默认只有1条MOSI引脚

• spi-rx-bus-width：表示有几条MISO引脚；没有这个属性时默认只有1条MISO引脚

• spi-rx-delay-us：单位是毫秒，表示每次读传输后要延时多久

• spi-tx-delay-us：单位是毫秒，表示每次写传输后要延时多久

设备树示例：

设备树实例：

在设备树里，会有一个节点用来表示SPI控制器。

在这个SPI控制器下面，连接有哪些SPI设备？会在设备树里使用子节点来描述SPI设备。

使用GPIO模拟的SPI控制器

IMX6ULL SPI控制器

STM32MP157 SPI控制器

设备树处理过程