Harmony鸿蒙南向驱动开发-SPI接口使用

功能简介

SPI指串行外设接口(Serial Peripheral Interface),是一种高速的,全双工,同步的通信总线。SPI是由Motorola公司开发,用于在主设备和从设备之间进行通信。

SPI接口定义了操作SPI设备的通用方法集合,包括:

  • SPI设备句柄获取和释放。

  • SPI读写:从SPI设备读取或写入指定长度数据。

  • SPI自定义传输:通过消息传输结构体执行任意读写组合过程。

  • SPI设备配置:获取和设置SPI设备属性。

运作机制

在HDF框架中,SPI的接口适配模式采用独立服务模式,在这种模式下,每一个设备对象会独立发布一个设备服务来处理外部访问,设备管理器收到API的访问请求之后,通过提取该请求的参数,达到调用实际设备对象的相应内部方法的目的。独立服务模式可以直接借助HDFDeviceManager的服务管理能力,但需要为每个设备单独配置设备节点,若设备过多可能增加内存占用。

独立服务模式下,核心层不会统一发布一个服务供上层使用,因此这种模式下驱动要为每个控制器发布一个服务,具体表现为:

  • 驱动适配者需要实现HdfDriverEntry的Bind钩子函数以绑定服务。

  • device_info.hcs文件中deviceNode的policy字段为1或2,不能为0。

图 1 SPI独立服务模式结构图

SPI独立服务模式结构图

SPI模块各分层作用:

  • 接口层提供打开SPI设备、SPI写数据、SPI读数据、SPI传输、配置SPI设备属性、获取SPI设备属性、关闭SPI设备的接口。

  • 核心层主要提供SPI控制器的添加、移除以及管理的能力,通过钩子函数与适配层交互。

  • 适配层主要是将钩子函数的功能实例化,实现具体的功能。

SPI以主从方式工作,通常有一个主设备和一个或者多个从设备。主设备和从设备之间一般用4根线相连,它们分别是:

  • SCLK:时钟信号,由主设备产生;

  • MOSI:主设备数据输出,从设备数据输入;

  • MISO:主设备数据输入,从设备数据输出;

  • CS:片选,从设备使能信号,由主设备控制。

一个主设备和两个从设备的连接示意图如图2所示,Device A和Device B共享主设备的SCLK、MISO和MOSI三根引脚,Device A的片选CS0连接主设备的CS0,Device B的片选CS1连接主设备的CS1。

图 2 SPI主从设备连接示意图

SPI主从设备连接示意图

  • SPI通信通常由主设备发起,通过以下步骤完成一次通信:

    1. 通过CS选中要通信的从设备,在任意时刻,一个主设备上最多只能有一个从设备被选中。

    2. 通过SCLK给选中的从设备提供时钟信号。

    3. 基于SCLK时钟信号,主设备数据通过MOSI发送给从设备,同时通过MISO接收从设备发送的数据,完成通信。

  • 根据SCLK时钟信号的CPOL(Clock Polarity,时钟极性)和CPHA(Clock Phase,时钟相位)的不同组合,SPI有以下四种工作模式:

    • CPOL=0,CPHA=0 时钟信号idle状态为低电平,第一个时钟边沿采样数据。

    • CPOL=0,CPHA=1 时钟信号idle状态为低电平,第二个时钟边沿采样数据。

    • CPOL=1,CPHA=0 时钟信号idle状态为高电平,第一个时钟边沿采样数据。

    • CPOL=1,CPHA=1 时钟信号idle状态为高电平,第二个时钟边沿采样数据。

约束与限制

SPI模块当前只支持主机模式,不支持从机模式。

使用指导

场景介绍

SPI通常用于与闪存、实时时钟、传感器以及模数/数模转换器等支持SPI协议的设备进行通信。

接口说明

SPI模块提供的主要接口如表1所示,具体API详见//drivers/hdf_core/framework/include/platform/spi_if.h。

表 1 SPI驱动API接口功能介绍

接口名接口描述
DevHandle SpiOpen(const struct SpiDevInfo *info)获取SPI设备句柄
void SpiClose(DevHandle handle)释放SPI设备句柄
int32_t SpiRead(DevHandle handle, uint8_t *buf, uint32_t len)读取指定长度的数据
int32_t SpiWrite(DevHandle handle, uint8_t *buf, uint32_t len)写入指定长度的数据
int32_t SpiTransfer(DevHandle handle, struct SpiMsg *msgs, uint32_t count)SPI数据传输接口
int32_t SpiSetCfg(DevHandle handle, struct SpiCfg *cfg)根据指定参数,配置SPI设备
int32_t SpiGetCfg(DevHandle handle, struct SpiCfg *cfg)获取SPI设备配置参数

使用流程

使用SPI的一般流程如下图所示。

图 3 SPI使用流程图

SPI使用流程图

获取SPI设备句柄

在使用SPI进行通信时,首先要调用SpiOpen获取SPI设备句柄,该函数会返回指定总线号和片选号的SPI设备句柄。

DevHandle SpiOpen(const struct SpiDevInfo *info); 

表 2 SpiOpen参数和返回值描述

参数参数描述
info结构体类型,SPI设备描述符
返回值返回值描述
NULL获取SPI设备句柄失败
设备句柄获取对应的SPI设备句柄成功

假设系统中的SPI设备总线号为0,片选号为0,获取该SPI设备句柄的示例如下:

struct SpiDevInfo spiDevinfo;       // SPI设备描述符
DevHandle spiHandle = NULL;         // SPI设备句柄
spiDevinfo.busNum = 0;              // SPI设备总线号
spiDevinfo.csNum = 0;               // SPI设备片选号// 获取SPI设备句柄
spiHandle = SpiOpen(&spiDevinfo);
if (spiHandle == NULL) {HDF_LOGE("SpiOpen: spi open fail!\n");return HDF_FAILURE;
}
获取SPI设备属性

在获取到SPI设备句柄之后,需要配置SPI设备属性。配置SPI设备属性之前,可以先获取SPI设备属性,获取SPI设备属性的函数如下所示:

int32_t SpiGetCfg(DevHandle handle, struct SpiCfg *cfg);

表 3 SpiGetCfg参数和返回值描述

参数参数描述
handleDevHandle类型,SPI设备句柄
cfg结构体指针类型,SPI设备配置参数
返回值返回值描述
HDF_SUCCESS获取设备属性成功
负数获取设备属性失败
int32_t ret;
struct SpiCfg cfg = {0};                // SPI配置信息
ret = SpiGetCfg(spiHandle, &cfg);       // 获取SPI设备属性
if (ret != HDF_SUCCESS) {HDF_LOGE("SpiGetCfg: failed, ret %d\n", ret);return ret;
}
配置SPI设备属性

在获取到SPI设备句柄之后,需要配置SPI设备属性,配置SPI设备属性的函数如下所示:

int32_t SpiSetCfg(DevHandle handle, struct SpiCfg *cfg);

表 4 SpiSetCfg参数和返回值描述

参数参数描述
handleDevHandle类型,SPI设备句柄
cfg结构体指针类型,SPI设备配置参数
返回值返回值描述
HDF_SUCCESS配置设备属性成功
负数配置设备属性失败
int32_t ret;
struct SpiCfg cfg = {0};                     // SPI配置信息
cfg.mode = SPI_MODE_LOOP;                    // 以回环模式进行通信
cfg.transferMode = PAL_SPI_POLLING_TRANSFER; // 以轮询的方式进行通信
cfg.maxSpeedHz = 115200;                     // 最大传输频率
cfg.bitsPerWord = 8;                         // 读写位宽为8比特
ret = SpiSetCfg(spiHandle, &cfg);            // 配置SPI设备属性
if (ret != HDF_SUCCESS) {HDF_LOGE("SpiSetCfg: failed, ret %d\n", ret);return ret;
}
进行SPI通信
  • 向SPI设备写入指定长度的数据

    如果只向SPI设备写一次数据,则可以通过以下函数完成:

    int32_t SpiWrite(DevHandle handle, uint8_t *buf, uint32_t len);

    表 5 SpiWrite参数和返回值描述

    参数参数描述
    handleDevHandle类型,SPI设备句柄
    bufuint8_t类型指针,待写入数据
    lenuint32_t类型,待写入的数据长度
    返回值返回值描述
    HDF_SUCCESS写入成功
    负数写入失败
    int32_t ret;
    uint8_t wbuff[4] = {0x12, 0x34, 0x56, 0x78};
    // 向SPI设备写入指定长度的数据
    ret = SpiWrite(spiHandle, wbuff, 4);
    if (ret != HDF_SUCCESS) {HDF_LOGE("SpiWrite: failed, ret %d\n", ret);return ret;
    }
  • 从SPI设备读取指定长度的数据

    如果只读取一次数据,则可以通过以下函数完成:

    int32_t SpiRead(DevHandle handle, uint8_t *buf, uint32_t len); 

    表 6 SpiRead参数和返回值描述

    参数参数描述
    handleDevHandle类型,SPI设备句柄
    bufuint8_t类型指针,待读取数据
    lenuint32_t类型,待读取的数据长度
    返回值返回值描述
    HDF_SUCCESS读取成功
    负数读取失败
    int32_t ret;
    uint8_t rbuff[4] = {0};
    // 从SPI设备读取指定长度的数据
    ret = SpiRead(spiHandle, rbuff, 4);
    if (ret != HDF_SUCCESS) {HDF_LOGE("SpiRead: failed, ret %d\n", ret);return ret;
    }
  • 自定义传输

    如果需要发起一次自定义传输,则可以通过以下函数完成:

    int32_t SpiTransfer(DevHandle handle, struct SpiMsg *msgs, uint32_t count);

    表 7 SpiTransfer参数和返回值描述

    参数参数描述
    handleDevHandle类型,SPI设备句柄
    msgs结构体指针,待传输数据的数组
    countuint32_t类型,msgs数组长度
    返回值返回值描述
    HDF_SUCCESS传输执行成功
    负数传输执行失败
    int32_t ret;
    uint8_t wbuff[1] = {0x12};
    uint8_t rbuff[1] = {0};
    struct SpiMsg msg;        // 自定义传输的消息
    msg.wbuf = wbuff;         // 写入的数据
    msg.rbuf = rbuff;         // 读取的数据
    msg.len = 1;              // 读取、写入数据的长度都是1
    msg.csChange = 1;         // 进行下一次传输前关闭片选
    msg.delayUs = 0;          // 进行下一次传输前不进行延时
    msg.speed = 115200;       // 本次传输的速度
    // 进行一次自定义传输,传输的msg个数为1
    ret = SpiTransfer(spiHandle, &msg, 1);
    if (ret != HDF_SUCCESS) {HDF_LOGE("SpiTransfer: failed, ret %d\n", ret);return ret;
    }
销毁SPI设备句柄

SPI通信完成之后,需要销毁SPI设备句柄,销毁SPI设备句柄的函数如下所示:

void SpiClose(DevHandle handle);

该函数会释放掉申请的资源。

表 8 SpiClose参数描述

参数参数描述
handleDevHandle类型,SPI设备句柄
SpiClose(spiHandle); // 销毁SPI设备句柄

使用实例

本例拟对Hi3516DV300开发板上SPI设备进行操作。

SPI设备完整的使用示例如下所示,首先获取SPI设备句柄,然后配置SPI设备属性,接着调用读写接口进行数据传输,最后销毁SPI设备句柄。

#include "hdf_log.h"
#include "spi_if.h"void SpiTestSample(void)
{int32_t ret;struct SpiCfg cfg;                      // SPI配置信息struct SpiDevInfo spiDevinfo;           // SPI设备描述符DevHandle spiHandle = NULL;             // SPI设备句柄struct SpiMsg msg;                      // 自定义传输的消息uint8_t rbuff[4] = { 0 };uint8_t wbuff[4] = { 0x12, 0x34, 0x56, 0x78 };uint8_t wbuff2[4] = { 0xa1, 0xb2, 0xc3, 0xd4 };spiDevinfo.busNum = 0;                  // SPI设备总线号spiDevinfo.csNum = 0;                   // SPI设备片选号spiHandle = SpiOpen(&spiDevinfo);       // 根据spiDevinfo获取SPI设备句柄if (spiHandle == NULL) {HDF_LOGE("SpiTestSample: spi open fail!\n");return;}// 获取SPI设备属性ret = SpiGetCfg(spiHandle, &cfg);if (ret != HDF_SUCCESS) {HDF_LOGE("SpiTestSample: spi get cfg fail, ret:%d!\n", ret);goto err;}cfg.maxSpeedHz = 115200;                // 将最大时钟频率改为115200cfg.bitsPerWord = 8;                    // 传输位宽改为8比特// 配置SPI设备属性ret = SpiSetCfg(spiHandle, &cfg);if (ret != HDF_SUCCESS) {HDF_LOGE("SpiTestSample: spi set cfg fail, ret:%d!\n", ret);goto err;}/* 向SPI设备写入指定长度的数据 */ret = SpiWrite(spiHandle, wbuff, 4);if (ret != HDF_SUCCESS) {HDF_LOGE("SpiTestSample: spi write fail, ret:%d!\n", ret);goto err;}/* 从SPI设备读取指定长度的数据 */ret = SpiRead(spiHandle, rbuff, 4);if (ret != HDF_SUCCESS) {HDF_LOGE("SpiTestSample: spi read fail, ret:%d!\n", ret);goto err;}msg.wbuf = wbuff2;                      // 写入的数据msg.rbuf = rbuff;                       // 读取的数据msg.len = 4;                            // 读取写入数据的长度为4msg.keepCs = 0;                         // 当前传输完成后是否保持CS活动,1表述保持,0表示关闭CSmsg.delayUs = 0;                        // 进行下一次传输前不进行延时msg.speed = 115200;                     // 本次传输的速度// 进行一次自定义传输,传输的msg个数为1ret = SpiTransfer(spiHandle, &msg, 1);if (ret != HDF_SUCCESS) {HDF_LOGE("SpiTestSample: spi transfer fail, ret:%d!\n", ret);goto err;}HDF_LOGD("SpiTestSample: function tests end!");
err:// 销毁SPI设备句柄SpiClose(spiHandle);
}

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术?不知道需要重点掌握哪些鸿蒙应用开发知识点?而且学习时频繁踩坑,最终浪费大量时间。所以有一份实用的鸿蒙(HarmonyOS NEXT)资料用来跟着学习是非常有必要的。 

这份鸿蒙(HarmonyOS NEXT)资料包含了鸿蒙开发必掌握的核心知识要点,内容包含了ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等)鸿蒙(HarmonyOS NEXT)技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助,有需要的小伙伴自行领取,限时开源,先到先得~无套路领取!!

获取这份完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙(HarmonyOS NEXT)最新学习路线

  •  HarmonOS基础技能

  • HarmonOS就业必备技能 
  •  HarmonOS多媒体技术

  • 鸿蒙NaPi组件进阶

  • HarmonOS高级技能

  • 初识HarmonOS内核 
  • 实战就业级设备开发

有了路线图,怎么能没有学习资料呢,小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙(OpenHarmony )学习手册(共计1236页)鸿蒙(OpenHarmony )开发入门教学视频,内容包含:ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习资料

《鸿蒙 (OpenHarmony)开发入门教学视频》

《鸿蒙生态应用开发V2.0白皮书》

图片

《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

图片

 《鸿蒙开发基础》

  • ArkTS语言
  • 安装DevEco Studio
  • 运用你的第一个ArkTS应用
  • ArkUI声明式UI开发
  • .……

图片

 《鸿蒙开发进阶》

  • Stage模型入门
  • 网络管理
  • 数据管理
  • 电话服务
  • 分布式应用开发
  • 通知与窗口管理
  • 多媒体技术
  • 安全技能
  • 任务管理
  • WebGL
  • 国际化开发
  • 应用测试
  • DFX面向未来设计
  • 鸿蒙系统移植和裁剪定制
  • ……

图片

《鸿蒙进阶实战》

  • ArkTS实践
  • UIAbility应用
  • 网络案例
  • ……

图片

 获取以上完整鸿蒙HarmonyOS学习资料,请点击→纯血版全套鸿蒙HarmonyOS学习资料

总结

总的来说,华为鸿蒙不再兼容安卓,对中年程序员来说是一个挑战,也是一个机会。只有积极应对变化,不断学习和提升自己,他们才能在这个变革的时代中立于不败之地。 

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/811707.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

页表缓存TLB原理

处理器的内存管理单元(Memory Management Uint,MMU)负责把虚拟地址转换成物理地址,为了加快虚拟地址到物理地址的转换速度,避免每次转换都需要查询内存中的页表,处理器厂商在MMU中增加了一个高速缓存TLB(Translation Lookaside Bu…

算法练习第16天|101. 对称二叉树

101. 对称二叉树 力扣链接https://leetcode.cn/problems/symmetric-tree/description/ 题目描述: 给你一个二叉树的根节点 root , 检查它是否轴对称。 示例 1: 输入:root [1,2,2,3,4,4,3] 输出:true示例 2&#x…

详解QActionGroup类的使用

QActionGroup 是 Qt 框架中用于管理一组相关 QAction 对象的类。它主要用于实现互斥选择(即单选)或多选(即复选)的行为,特别是在菜单、工具栏或上下文菜单中,当存在一系列相互排斥或相关联的操作选项时&…

【Python面试题收录】什么是堆?什么是栈?栈和堆的区别是什么?

一、堆和栈的定义 (1)堆(Heap) 数据结构:堆是一种特殊的完全二叉树,满足父节点的值总是大于或等于(大根堆)其子节点的值。也可以是总是小于或等于(小根堆)其…

品牌百度百科词条创建多少钱?

百度百科作为国内最具权威和影响力的知识型平台,吸引了无数品牌和企业争相入驻。一个品牌的百度百科词条,不仅是对品牌形象的一种提升,更是增加品牌曝光度、提高品牌知名度的重要途径。品牌百度百科词条创建多少钱,这成为了许多企…

玻璃生产线 Web 组态应用案例介绍

玻璃生产线组态可视化 概述 随着工厂信息化、数字化发展,智慧生产车间成为必然发展趋势,通过智能硬件、物联网、大数据等智慧化技术与手段,提高车间生产设备、工艺设备的智能执行能力,从而提升整个车间乃至工厂的智能化、网络化与…

【SpringBoot XSS存储漏洞 拦截器】Java纯后端对于前台输入值的拦截校验实现 一个类加一个注解结束

先看效果: 1.js注入拦截: 2.sql注入拦截 生效只需要两步: 1.创建Filter类,粘贴如下代码: package cn.你的包命.filter; import java.io.BufferedReader; import java.io.ByteArrayInputStream; import java.io.IO…

macos 查看 远程服务器是否开放某个端口

想要使用mac查看远程服务器某个端口是否开发&#xff0c;可通过 nc 命令&#xff0c;如下&#xff1a; nc -zv <服务器IP> <端口号>如果该端口开发&#xff0c;结果为&#xff1a;succeeded! Connection to <服务器IP> port <端口号> [类型] succeed…

CLion 2024:为Mac与Win打造的卓越跨平台集成开发环境

CLion 2024作为一款跨平台IDE&#xff0c;CLion 2024不仅完美支持Mac和Windows两大操作系统&#xff0c;更在细节之处展现了其出色的跨平台兼容性。无论你是在Mac的优雅界面下工作&#xff0c;还是在Windows的实用环境中编程&#xff0c;CLion 2024都能为你提供一致且流畅的开发…

Day98:云上攻防-云原生篇K8s安全Config泄漏Etcd存储Dashboard鉴权Proxy暴露

目录 云原生-K8s安全-etcd(Master-数据库)未授权访问 etcdV2版本利用 etcdV3版本利用 云原生-K8s安全-Dashboard(Master-web面板)未授权访问 云原生-K8s安全-Configfile鉴权文件泄漏 云原生-K8s安全-Kubectl Proxy不安全配置 知识点&#xff1a; 1、云原生-K8s安全-etcd未…

对SQL主键优化策略收录

1. 主键选择 类型选择&#xff1a;主键应当尽可能短小且高效。通常推荐使用整数类型&#xff08;如INT或更小的SMALLINT、TINYINT&#xff09;&#xff0c;尤其是带有自增属性&#xff08;AUTO_INCREMENT&#xff09;的整数&#xff0c;这样既能保证唯一性&#xff0c;又能减少…

Springboot实现链路追踪功能

前言 在日常开发中&#xff0c;一个业务的实现往往会调用很多个方法&#xff0c;当我们去看日志的时候&#xff0c;各种接口的日志打印出来&#xff0c;看着就头疼&#xff0c;压根没办法去定位&#xff0c;而链路追踪就能很好的帮助我们去查看接口从头至尾依次调用了哪些方法…

vue小程序跳转页面携带参数

跳转携带对象 前一个页面&#xff1a;跳转的方法里把数组转成字符串 gotoArea(item){console.log("item",item)let datas JSON.stringify(item);goto.goto(navigateTo,index/area/main?itemdatas);},跳转的目标页面&#xff1a; onLoad(options){let datas JSO…

MacOS13搭建安卓逆向环境

MacOS中用apktool解包 这里是所有链接&#xff1a;123云盘下载 https://www.123pan.com/s/9QRqVv-JE7Y.html安装apktool https://apktool.org/docs/install/ 或者下载单独的jar包 brew install wgethttps://apktool.org/blog/apktool-2.9.3下载直链&#xff1a;https://co…

ChatGPT让论文写作更高效,让学术研究更精彩

ChatGPT无限次数:点击直达 ChatGPT让论文写作更高效&#xff0c;让学术研究更精彩 引言 在当今数字化时代&#xff0c;人工智能技术的发展为学术研究者提供了更多创新的机会和工具。其中&#xff0c;自然语言处理模型如ChatGPT在论文写作领域展现出强大的潜力。本文将介绍如何…

数据仓库—大数据建模

大数据建模是一个关键的环节&#xff0c;它直接影响到数据仓库的设计和运行效果。下面将详细介绍一下大数据建模的一般步骤和关键概念。 建模步骤 需求分析&#xff1a;首先要对业务需求进行深入分析&#xff0c;了解业务的核心目标和数据分析的重点。只有明确了需求&#xff…

spring的事件推送

本质上是设计模式中的观察者模式。 一、什么是观察者模式 观察者模式是一种行为型设计模式&#xff0c;它定义了一种一对多的依赖关系&#xff0c;当一个对象的状态发生改变时&#xff0c;其所有依赖者都会收到通知并自动更新。 二、什么是spring的事件推送 在 Spring 的事…

使用Python批量将PDF转Word

简述 以下全部代码无法完美对图片、表格等非文字形式的内容转化。要较好的效果需要使用光学字符分析等方法进行转化 我懒&#xff0c;不想将代码模块拆分出来写注释 除代码1中有详细注释外&#xff0c;剩下的代码仅在关键部分进行注释 代码1&#xff1a;小规模文件的转换 代码…

TikTok如何矩阵养号?TK防关联引流系统助力TK账号安全运营

TK是 TikTok旗下的短视频社交媒体&#xff0c;平台目前是全球最火的短视频平台&#xff0c;目前全球活跃用户已经超过8亿。其中 TikTok的用户已经达到8亿。TK这款短视频社交媒体平台在海外的发展潜力非常大&#xff0c;也是国内很多人的创业目标&#xff0c;很多人都想从 TK这个…

如何将arping以及所有依赖打包安装到另外一台离线ubuntu机器

ubuntu系统下可以使用arping命令检测局域网内一些ip是否冲突&#xff0c;使用方式为&#xff1a; arping xx.xx.xx.xx 在线情况下&#xff0c;可以使用下面命令下载arping&#xff0c;然后使用即可 apt install arping 但是有些情况下机器可能不能上网&#xff0c;这时就需要将…