SPI驱动学习七（SPI_Slave_Mode驱动程序框架）

于 2024-09-28 20:05:07 发布
阅读量704 收藏 23
点赞数 12
分类专栏： Linux驱动 文章标签： 学习 linux 驱动开发 arm开发
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_45842280/article/details/142618997
版权

目录

一、SPI_Slave_Mode驱动程序框架

  • 参考内核源码: Linux-5.x\drivers\spi\spi-imx.c
  • 注意：Linux 4.9的内核未支持SPI Slave Mode
  • 参考文档：《Linux_as_an_SPI_Slave_Handouts.pdf》

1. Master和Slave模式差别

  SPI（串行外设接口，Serial Peripheral Interface）是一种常用的同步串行通信协议，用于微控制器与各种外设（如传感器、存储器、显示器等）之间的通信。在 SPI 通信中，通常有两个角色：主设备（Master）和从设备（Slave）。这两者之间的区别如下：

1.1 主设备 (Master)

  • 定义：主设备负责控制 SPI 通信，生成时钟信号，并管理从设备的选择。

  • 功能：

    • 时钟产生：主设备生成 SPI 时钟信号（SCK），并控制数据传输的速率。
    • 选择从设备：通过选择线（如 Chip Select，CS）选择与其通信的特定从设备。通常在传输数据前，主设备会将 CS 线拉低以使对应的从设备准备接收数据。
    • 数据发送和接收：主设备负责读取从设备发送的数据，并向从设备发送命令和数据。

  • 例子：微控制器通常充当主设备，与多个传感器或存储器从设备通信。

1.2 从设备 (Slave)

  • 定义：从设备被动地响应主设备的命令。它不会主动启动通信，而是等待主设备进行操作。

  • 功能：

    • 响应主设备：从设备在主设备的指令下工作，并在主设备发送时钟信号时提供数据。
    • 数据接收和发送：从设备接收来自主设备的数据，并将其处理后，发送响应或数据回主设备。

  • 例子：传感器、EEPROM、LCD 显示屏等通常作为从设备，实现数据的接收和响应。

1.3 示例

以IMX6ULL为例，Master和Slave模式的异同如下图：

  • 初始化

    • 使用的SPI寄存器有所不同
    • 引脚有所不同：Master模式下SS、CLK引脚是输出引脚，Slave模式下这些引脚是输入引脚

  • 准备数据：都需要准备好要发送的数据，填充TX FIFO

  • 发起传输：Master模式下要主动发起传输，等待发送完成(等待中断)

  • 使能接收中断：Slave模式下无法主动发起传输，只能被动地等待，使能接收中断即可

  • 中断函数里：读取RXFIFO得到数据

  • 传输完成

  • 在这里插入图片描述

2. SPI传输概述

2.1 数据组织方式

  使用SPI传输时，最小的传输单位是"spi_transfer"，对于一个设备，可以发起多个spi_transfer，这些spi_transfer，会放入一个spi_message里。
在这里插入图片描述
所以，反过来，SPI传输的流程是这样的：

  • 从spi_master的队列里取出每一个spi_message
    • 从spi_message的队列里取出一个spi_transfer
      • 处理spi_transfer

2.2 SPI控制器数据结构

  参考内核文件：include\linux\spi\spi.h，Linux中SPI控制器struct spi_controller，有两套传输方法：
![在这里插入图片描述](https://i-blog.csdnimg.cn/direct/a3c374792e144463b6bb6113c558bbde.png

3. SPI Slave Mode数据传输过程

在这里插入图片描述

4. 如何编写程序

4.1 设备树

  • SPI控制器设备树节点中，需要添加一个空属性：spi-slave
  • 要模拟哪类slave设备？需要添加slave子节点，这是用来指定slave protocol
    在这里插入图片描述

4.2 内核相关

  • 新配置项：CONFIG_SPI_SLAVE

  • 设备树的解析：增加对spi-slave、slave子节点的解析

  • sysfs：新增加/sys/devices/.../CTLR/slave，对应SPI Slave handlers

  • 新API

    • spi_alloc_slave( )
    • spi_slave_abort( )
    • spi_controller_is_slave( )

  • 硬件设置不一样

    • master：SS、SCLK引脚是输出引脚
    • slave：SS、SCLK引脚是输入引脚

  • 传输时等待函数不一样

    • master：master主动发起spi传输，它可以指定超时时间，使用函数wait_for_completion_timeout() 进行等待
    • slave：slave只能被动等待传输，它无需指定超时时间，使用函数wait_for_completion_interruptible()进行等待 ，使用.slave_abort() 来取消等待

4.3 简单的示例代码

4.3.1 master和slave驱动示例

在这里插入图片描述

4.3.2 master和slave使用示例

  对于设置为spi master模式的spi控制器，下面接的是一个一个spi slave设备，我们编写各类spi slave driver，通过spi master的函数读写spi slave 设备。

  对于设置为spi slave模式的spi控制器，它是作为一个spi slave设备被其他单板的spi master设备来访问，它如何接收数据、如何提供数据？我们编写对应的spi slave handler。

  对于master和slave，有两个重要概念：

  • SPI Slave Driver：通过SPI Master控制器跟SPI Slave设备通信
  • SPI Slave Handler：通过SPI Slave控制器监听远端的SPI Master
    在这里插入图片描述

二、SPI_Slave_Mode驱动程序源码解读(drivers/spi/spi-imx.c)

1. 设备树

下图是摘自《Linux_as_an_SPI_Slave_Handouts.pdf》：
在这里插入图片描述

2. 控制器驱动程序

  在Linux 5.x版本中，SPI控制器的驱动程序仍然使用原理的名字：struct spi_master，但是它已经是一个宏：

#define spi_master			spi_controller

  这意味着它可以工作于master模式，也可以工作于slave模式。

2.1 分配一个spi_controller

在这里插入图片描述

2.2 设置spi_controller

  工作于slave模式时，跟master模式最大的差别就是如下函数不一样：

  • bitbang.txrx_bufs函数不一样
    • 在IMX6ULL中，这个函数为spi_imx_transfer，里面对master、slave模式分开处理
    • master模式：使用spi_imx_pio_transfer函数
    • slave模式：使用spi_imx_pio_transfer_slave函数
  • 增加了bitbang.master->slave_abort函数
    在这里插入图片描述
      不同厂家的SOC的SPI 驱动实现会有所不同，有的就不会用到bitbang；spi_bitbang 结构体定义了一种软件模拟SPI通信的方式，通过软件控制GPIO引脚来实现SPI通信所需的时序和信号。这种方法通常用于那些没有内置SPI硬件控制器的微控制器或系统上。

2.3 注册spi_controller

  无论是master模式，还是slave模式，注册函数时一样的：
在这里插入图片描述
  在spi_bitbang_start内部，会处理设备树中的子节点，创建并注册spi_device：

spi_bitbang_start
    spi_register_master
    	spi_register_controller
    		of_register_spi_devices

  对于master模式，设备树中的子节点对应真实的spi设备；但是对于slave模式，这些子节点只是用来选择对应的spi slave handler：就是使用哪个驱动来模拟spi slave设备，比如：
在这里插入图片描述

/* drivers/spi/spi-slave-time.c
 * SPI从机处理器，接收上一条SPI消息后报告系统运行时间
 *
 * 该SPI从机处理器以二进制格式和网络字节顺序发送上一条SPI消息接收时间
 * 的两个32位无符号整数，分别表示自系统启动以来的秒数和小数秒数（以微秒为单位）。
 *
 * 版权所有 (C) 2016-2017 Glider bvba
 *
 * 本文件受 GNU 通用公共许可证条款和条件的约束。请参阅此存档主目录中的 "COPYING" 文件以获取更多详细信息。
 *
 * 使用方法（假设 /dev/spidev2.0 对应远程系统上的 SPI 主设备）:
 *
 *   # spidev_test -D /dev/spidev2.0 -p dummy-8B
 *   spi 模式: 0x0
 *   每字的位数: 8
 *   最大速度: 500000 Hz (500 KHz)
 *   RX | 00 00 04 6d 00 09 5b bb ...
 *		^^^^^    ^^^^^^^^
 *		秒数    微秒数
 */
 
#include <linux/completion.h>
#include <linux/module.h>
#include <linux/sched/clock.h>
#include <linux/spi/spi.h>

struct spi_slave_time_priv {
	struct spi_device *spi;
	struct completion finished;
	struct spi_transfer xfer;
	struct spi_message msg;
	__be32 buf[2];
};

static int spi_slave_time_submit(struct spi_slave_time_priv *priv);

/**
 * @brief SPI从机时间补偿函数
 * 
 * 当SPI从机传输完成或者发生错误时，此函数被调用以处理相应的后续操作。主要功能包括检查上一次传输状态，
 * 并根据状态决定是否继续提交时间补偿处理或者终止并通知上层。
 * 
 * @param arg 传递给此函数的参数，实际类型为struct spi_slave_time_priv*，用于访问SPI从机时间补偿相关的数据。
 */
static void spi_slave_time_complete(void *arg)
{
	// 将参数转换为相应的结构体指针，以便访问私有数据
	struct spi_slave_time_priv *priv = arg;

	// 存储操作结果的变量
	int ret;

	// 检查上一次SPI从机消息的状态，如果存在错误，则不继续操作
	ret = priv->msg.status;
	if (ret)
		goto terminate;

	// 尝试提交下一次时间补偿处理，如果提交失败，则跳转到terminate块
	ret = spi_slave_time_submit(priv);
	if (ret)
		goto terminate;

	// 如果没有错误，正常返回
	return;

terminate:
	// 当出现错误或者传输完成时，记录日志并通知上层处理已经完成
	dev_info(&priv->spi->dev, "Terminating\n");
	complete(&priv->finished);
}

/**
 * 提交SPI从机时间同步请求
 *
 * 该函数用于从SPI从机角度，向SPI主机请求时间同步。它会将本地时钟和剩余微秒封装成数据，
 * 并通过SPI异步传输的方式发送给SPI主机。时间同步对于需要在分布式系统中保持时间一致性的
 * 应用非常关键。
 *
 * @param priv 指向SPI从机时间私有数据结构的指针，包含必要的传输数据和配置信息。
 * @return 返回spi_async调用的结果，如果失败则记录错误信息。
 */
static int spi_slave_time_submit(struct spi_slave_time_priv *priv)
{
	// 剩余的微秒部分
	u32 rem_us;
	// 返回值
	int ret;
	// 时间戳，以纳秒为单位
	u64 ts;

	// 获取当前的本地时钟值，以纳秒为单位
	ts = local_clock();
	// 从纳秒转换到微秒，并将结果保存到rem_us
	rem_us = do_div(ts, 1000000000) / 1000;

	// 将纳秒和微秒部分分别转换为大端字节序，并存入缓冲区
	priv->buf[0] = cpu_to_be32(ts);
	priv->buf[1] = cpu_to_be32(rem_us);

	// 初始化SPI消息，只包含一个传输操作
	spi_message_init_with_transfers(&priv->msg, &priv->xfer, 1);

	// 设置SPI消息的完成回调函数和上下文数据
	priv->msg.complete = spi_slave_time_complete;
	priv->msg.context = priv;

	// 异步发送SPI消息
	ret = spi_async(priv->spi, &priv->msg);
	// 如果发送失败，记录错误信息
	if (ret)
		dev_err(&priv->spi->dev, "spi_async() failed %d\n", ret);

	return ret;
}

/**
 * spi_slave_time_probe - SPI从机时间延迟自动探测函数
 * @spi: 指向SPI设备结构体的指针
 *
 * 本函数用于在SPI从机模式下，自动探测和调整时间延迟参数，以确保SPI通信的正确性和稳定性。
 * 它通过分配私有数据空间，初始化必要的结构，然后提交一个SPI传输请求来进行时间延迟探测。
 * 若探测过程出错，则返回相应的错误码。
 *
 * 返回: 0表示成功，负值表示遇到的相应错误。
 */
static int spi_slave_time_probe(struct spi_device *spi)
{
	struct spi_slave_time_priv *priv;
	int ret;

	/* 分配内存用于存储私有数据，包括时间延迟探测所需的各种数据 */
	priv = devm_kzalloc(&spi->dev, sizeof(*priv), GFP_KERNEL);
	if (!priv)
		return -ENOMEM;

	/* 初始化私有数据结构中的成员 */
	priv->spi = spi;
	init_completion(&priv->finished);
	priv->xfer.tx_buf = priv->buf;
	priv->xfer.len = sizeof(priv->buf);

	/* 提交SPI传输请求，进行时间延迟探测 */
	ret = spi_slave_time_submit(priv);
	if (ret)
		return ret;

	/* 将私有数据结构与SPI设备驱动模型数据关联，以便后续使用 */
	spi_set_drvdata(spi, priv);
	return 0;
}

/**
 * 从SPI设备中移除slave定时器功能
 * 
 * 本函数主要用于从SPI设备中移除slave定时器功能在一些情况下，可能需要
 * 中止当前的SPI传输操作，并确保所有相关的定时器处理已经完成此函数通过
 * 调用spi_slave_abort来尝试中止当前的SPI操作，并通过等待完成来确保所有
 * 相关的定时器处理已经结束这对于在设备移除或者重新配置时清理资源非常有用
 * 
 * @param spi 指向SPI设备结构的指针该参数是必需的，用于标识需要进行操作的SPI设备
 * 
 * @return 该函数返回0，表示执行成功这里不使用其他的返回值，因为当前的实现
 * 不需要区分更多的错误类型
 * 
 * 注意：该函数假定传入的spi参数是非空的，并且spi所指向的设备已经正确初始化并
 * 具有slave定时器功能
 */
static int spi_slave_time_remove(struct spi_device *spi)
{
	// 获取与SPI设备相关的私有数据
	struct spi_slave_time_priv *priv = spi_get_drvdata(spi);

	// 尝试中止当前的SPI操作
	spi_slave_abort(spi);
	// 等待直到所有定时器相关的操作完成
	wait_for_completion(&priv->finished);

	return 0;
}

static struct spi_driver spi_slave_time_driver = {
	.driver = {
		.name	= "spi-slave-time",
	},
	.probe		= spi_slave_time_probe,
	.remove		= spi_slave_time_remove,
};
module_spi_driver(spi_slave_time_driver);

MODULE_AUTHOR("Geert Uytterhoeven <geert+renesas@glider.be>");
MODULE_DESCRIPTION("SPI slave reporting uptime at previous SPI message");
MODULE_LICENSE("GPL v2");

2.4 硬件操作

在这里插入图片描述

3. 设备驱动程序

3.1 Master模式

在这里插入图片描述

3.2 Slave模式

  参考代码：Linux-5.x\drivers\spi\spi-slave-time.c
在这里插入图片描述

  本文章参考了韦东山老师驱动大全部分笔记，其余内容为自己整理总结而来。水平有限，欢迎各位在评论区指导交流！！！😁😁😁

小嵌同学
关注
专栏目录
linux 添加spi 驱动,linux驱动之spi框架
weixin_30045597的博客
05-03 1033
一、前言前面我们简单的介绍了 I2C总线 的基本框架，本文则将继续讲述另一种常用的 外设总线，即 SPI总线。SPI总线 常用于 传感器或者flash等外设。本文将沿着 SPI总线驱动代码，从整体上梳理一下 SPI框架 的使用及原理。注意：本文将假设读者已经熟悉SPI总线协议，如若有读者不熟悉请自行查阅资料二、正文本节将使用 m25p80 这个驱动文件，m25p80 是常用 flash 的驱动代码...
Linux驱动开发 - spi子系统(3) spi slave控制器驱动
u013428341的博客
04-25 657
spi slave控制器驱动
linux驱动系列学习之spi框架源码分析
zichuanning520的博客
03-23 1853
spi框架分析
【SPI】SPI学习之SPI驱动相关
诸葛一帆丶的博客
05-29 2795
spi驱动框架 目录：linux/driver/spi/ <从设备驱动层>　　spidev.c　　　　　　　　　　　　　　　　　　　　　　　　　　 　 自己编写 <核 心 层>　　spi.c　　　　　　　　　　　　　　　　　　　　　　　　　　　　 内核提供 <控 制 器 层>　 spi-xxx.c（瑞芯微：spi-rockchip.c　　全志：spi-sunxi.c）　　　　 原厂提供 ...
SPI驱动学习二（驱动框架）
小嵌同学的博客
09-01 1750
在SPI Master对应的设备树节点下，每一个子节点都对应一个SPI设备，这个SPI设备连接在该SPI Master下面。在设备树里，会有一个节点用来表示SPI控制器。会在设备树里使用子节点来描述SPI设备。这通常意味着该节点的资源大小是隐含的，或者不需要明确地在设备树中指定资源的大小。考虑一个设备树的片段，其中定义了一个总线节点，并且包含两个子节点：一个内存节点和一个设备节点。, Linux中使用spi_master结构体描述SPI控制器，里面最重要的成员就是。在设备树中，对于SPI Master，
linux的SPI设备驱动程序
Icewaver的专栏
04-12 2257
串行外设接口(SPI)是四线总线：MOSI、MISO、串行时钟SCK和片选CS。它常用于连接闪存、AD/DA转换器。主设备生成时钟和管理片选CS，速度可达80MB，远超I2C总线。
Linux spi驱动框架分析（一）
m0_46525308的博客
03-04 2294
Linux下spi的驱动架构如下图： 从图中可以观察到spi系统的整个框架，发现跟i2c的框架很十分相似；spi驱动框架主要分为三个部分，spi控制器驱动，spi设备驱动，和spi核心。 内核把spi控制器抽象为struct spi_master结构体，设备驱动抽象为spi_driver，spi设备抽象spi_device结构体。 spi与i2c内核空间的类比： （1）spi_master就相当于i2c中的i2c_adapter （2）spi_driver即i2c_driver （3）spi_device
Linux驱动学习--SPI驱动（一）
qq_39717374的博客
03-12 1379
SPI主控用来发出数据，SPI从设备用来接受数据SPI主控用来接受数据，SPI从设备用来发送数据SCK：时钟CS：芯片选择引脚假设现在主控芯片要传输一个0x56数据给SPI Flash，时序如下：首先CS0先选中SPI Flash，0x56的二进制就是0b0101 0110，因此在每个SCK时钟周期，DO输出对应的电平。SPI Flash会在每个读取DO上的电平。在spi协议中，有两个值来确定SPI的模式。CPOL：表示SPICLK的初始电平，0为低电平，1为高电平。
Qualcomm平台的SPI驱动框架分析
tianyu0801的博客
06-23 1354
- 一、SPI总线概述 SPI是英语Serial Peripheral interface的缩写，顾名思义就是串行外围设备接口，是Motorola首先在其MC68HCXX系列处理器上定义的。SPI接口主要应用在 EEPROM，FLASH，实时时钟，AD转换器，还有数字信号处理器和数字信号解码器之间。SPI是一种高速的，全双工，同步的通信总线，并且在芯片的管脚上只占用四根线，节约了芯片的管脚，同时为PCB的布局上节省空间，提供方便。 SPI的通信原理很简单，它以主从方式工作，这种模式通常有一个主设备和一个或多
SPI驱动学习七（SPI-Slave-Mode驱动程序框架）
最新发布
09-28
了解Linux下spi作为slave时的使用方式
SPI.zip_slave spi verilog_spi slave_spi slave verilog
09-23
在压缩包内的文件名中，"spi_master_mode_verilog.doc"可能是关于SPI主模式的Verilog实现文档，虽然题目主要关注从机，但了解主模式对于完整理解SPI通信仍然是有价值的。"SPI总线协议介绍.pdf"则很可能是SPI协议的...
spi-slave-mode.rar_spi slave_spi_slave
09-19
标题“spi-slave-mode.rar_spi slave_spi_slave”表明这个压缩包文件包含了关于SPI从模式的相关资料，而描述中的“bjx 301a spi 从模式读写数据”则提示我们，可能涉及到一种特定型号（bjx 301a）的SPI从设备的数据...
spi_verilog_master_slave_latest.tar.gz
01-06
该项目在Verilog HDL中提供SPI Mode-3主从模块。数据宽度为8位。它是为Xilinx Spartan 6合成的，时钟频率最高可达225MHz。最大SPI时钟（sck）频率为112MHz，由主时钟得出。来自主时钟的SCK缩放比例可以是2、4、8和16...
spi.rar_SPI so si_spi_spi dsp_spi 程序_模拟SPI
09-24
SPI协议有四种工作模式，根据时钟极性和边沿触发方式的不同组合，分别是Mode 0、Mode 1、Mode 2和Mode 3。这些模式影响数据在时钟上升沿还是下降沿被捕获，以及何时开始传输。 在编程实现模拟SPI的过程中，需要注意...
Spring Boot 学习和使用
cesske的博客
09-24 1111
Spring Boot是一款开源的Java Web应用框架，旨在简化Spring应用的初始搭建以及开发过程。Spring Boot通过整合Spring技术栈中的诸多关键组件，为开发者提供了一种快速、简便的Spring应用开发方式。它遵循“约定优于配置”的原则，通过自动配置、起步依赖和内置的Servlet容器，极大地简化了传统Spring应用的配置和部署过程。Spring Boot通过其自动化配置、起步依赖、内嵌服务器等特性，极大地简化了Spring应用的开发和部署过程。
大模型输入参数学习
AI智能，无处不在
09-25 542
top_p和top_k：用于控制生成文本的多样性和连贯性。较小的值会使生成的文本更连贯但缺乏多样性，较大的值会使生成的文本更随机和多样。：用于控制生成文本的随机性。较高的值增加随机性，较低的值增加确定性。：用于控制生成文本的长度。
Nexus学习
howwickhappy的博客
09-24 986
Nexus 是一个开源的仓库管理器，用于管理和分发软件构建的组件。
Linux入门学习：进程概念
Lvision2的博客
09-24 1073
在课本的概念中，进程程序的一个执行实例，正在执行的程序。其内核观点：担当分配系统资源（CPU时间，内存）的实体。但这些概念太笼统，并不能让我们更加清晰的知道进程是什么，实际上，进程是内核数据结构(pcb) + 程序的代码与数据。pcb(process control block)进程控制块，进程信息被放在一个叫pcb的数据结构中，可以理解为进程属性的集合。在Linux入门学习：深刻理解计算机硬件与OS体系中，我们已经了解到。
SPI_InitStructure.SPI_Mode = SPI_Mode_Master; //设置SPI工作模式:设置为主SPI
08-13
SPI_InitStructure.SPI_Mode = SPI_Mode_Master; 这行代码的作用是设置SPI（Serial Peripheral Interface）的工作模式为Master模式。在SPI通信中，Master模式指的是设备控制传输流程，它发送命令并接收从从设备（Slave）响应的数据。当设置为Master模式时，主设备（通常是微控制器）会主动发起数据传输，并管理数据的发送和接收。 在STM32或其他支持SPI的嵌入式开发中，`SPI_InitStructure`通常是一个结构体，用于配置SPI模块的行为。通过这种方式设置参数，你可以定制SPI的通信特性，如波特率、数据位数、奇偶校验等。 具体操作可能依赖于你使用的特定库或框架，但基本原理就是通过初始化这个结构体并传递给SPI相关的初始化函数，比如`HAL Spi_Init()`，来配置SPI工作在Master模式。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

小嵌同学

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值