详解AP3216C（三合一sensor： 光照、距离、照射强度）驱动开发

目录

概述

1 认识AP3216C

1.1 AP3216C特性

1.2 AP3216C内部结构

1.3 AP3216C 硬件电路

1.4 AP3216C工作时序

1.4.1 I2C 写数据协议

1.4.2 I2C 读数据协议

1.5 重要的寄存器

1.5.1 系统配置寄存器

1.5.2 和中断相关寄存器

1.5.3 IR数据寄存器

1.5.4 ALS 数据寄存器

1.5.5 PS 数据寄存器

2 驱动开发

2.1 查看i2c总线下的设备

2.2 编写驱动代码 

 3 编写测试代码

3.1 测试代码实现

3.2 Makefile

4 测试

4.1 编译代码

4.2 运行测试程序

概述

        本文详细介绍AP3216C的特性，内部结构，操作时序和寄存器的参数意义，并使用linux platform tree 下i2c 驱动接口，实现了AP3216C的驱动程序。并且编写了一个测试范例，验证该驱动程序的性能。 其可以正确的读出sensor内部的数据。

源代码下载地址： AP3216Clinux环境下的驱动程序资源-CSDN文库

1 认识AP3216C

1.1 AP3216C特性

AP3216C是敦南科技出品的一款集成sensor, 其中包括 ：ALS（数字型环境光线感应 sensor），PS（测距sensor）IR（照射sensor）。这款sensor主要用在手机、平板电脑、电视、显示器、数码相机等产品上。

1）驱动方式： 采用标准的I2C接口，且工作在快速模式（400K Hz）

2）输出模块可选： ALS, PS+IR, ALS+PS+IR, PD,ALS once, SW Reset, PS+IR once and ALS+PS+IR once.

3） 高分辨率：

数字型环境光线感应 sensor ，采用 16-bit 有效数据输出，数据采集范围（ 0~65535 ）

测距sensor，采用 10-bit 有效数据输出， 数据采集范围（ 0~1023 ）

1.2 AP3216C内部结构

由下结构图可以看见： ALS和PS分别和ADC模块连接，以采集外部数据 。IR本分隔在一个单独的模块。

1.3 AP3216C 硬件电路

AP3216C采用标准的i2c驱动模式，其和MCU之间通过3个线连接，SDA和SCL是I2C的驱动线，还提供一个中断引脚INT

1.4 AP3216C工作时序

AP3216C采用标准的i2c驱动接口，其slave 设备地址为：0x1e

1.4.1 I2C 写数据协议

1） 写方式一： 写寄存器地址

S: start 信号

Slave address : 7 bit

W: 写数据bit

A: ACK信号

Register Address: 寄存器地址

P: Stop信号

详细时序图：

2） 写方式二： 写寄存器地址 和数据

S: start 信号

Slave address : 7 bit

W: 使能写数据bit

A: ACK信号

Register Address: 寄存器地址

register Command: 写寄存器数据

P: Stop信号

详细时序图：

1.4.2 I2C 读数据协议

1） 读方式一： 读寄存器地址

S: start 信号

Slave address : 7 bit

R: 使能读数据bit

A: ACK信号

Register command: 寄存器数据

N: NACK信号

P: Stop信号

详细时序图：

2） 读方式二： 读寄存器地址的数据

S: start 信号

Slave address : 7 bit

R: 使能读数据bit

W: 使能写数据bit

A: ACK信号

Register command: 寄存器数据

N: NACK信号

P: Stop信号

详细时序图：

1.5 重要的寄存器

AP3216C内部有许多寄存器，其地址空间（0x00 ~ 0x2d ），由于篇幅所限，这里不对每个寄存器做一一介绍。如需了解，可参看文档：AP3216C Rev0.86. pdf。 本文主要介绍系统寄存器部分，地址空间（0x00 ~ 0x0f。各个寄存器的功能，看下表：

1.5.1 系统配置寄存器

该寄存器地址位0x00, 低位3个bit(bit-0 bit-1,bit-2)用于配置系统工作模式

具体模式如下表：

1.5.2 和中断相关寄存器

中断状态寄存器： address = 0x01

BIT-0: ALS-INT 用来表示中断是否发生， B0=1 表示ALS中断被触发， B0 =0 示ALS中断未被被触发

BIT-1: PS-INT 用来表示中断是否发生， B0=1 表示PS中断被触发， B0 =0 示PS中断未被被触发

中断清除寄存器: address = 0x02

当配置CLR_MNR = 0时， 在读取寄存器（0x0C, 0x0D, 0x0E, 0x0F)的值后，芯片会自动清除中断；

当配置CLR_MNR = 1时，需要软件强制把寄存器0x01的对应位置位为1，清除中断；

1.5.3 IR数据寄存器

对应地址： 0x0a 和0x0b

0x0a地址中，bit0和bit1 为数据位，表示低字节位， IR_OF为数据溢出标记，当IR_OF=1, 表明IR值过高，其会影响PS的数据的有效性

0x0b地址中，为IR 数据高字节位

1.5.4 ALS 数据寄存器

对应地址： 0x0c 和0x0d

1.5.5 PS 数据寄存器

对应地址： 0x0E 和0x0F

IR_OF = 1，表示读取的数据有效。IR_OF = 0，表示读取的数据无效。

2 驱动开发

2.1 查看i2c总线下的设备

i2c总线上可以挂载多个device，其要求在同一条总线上，每个设备的地址必须唯一性。如果两个设备的地址一样，会出现时序混乱。 下面通过命令来探测一下i2c总线下的设备情况。

查看i2c-0下设备情况

使用命令

 i2cdetect -a 0

执行该命令后，列出设备地址信息： 该总线下有两个设备，其地址分别为：0x1a和0x1e

2.2 编写驱动代码 

创建drv_ap3216c.c，编写如下代码

/***************************************************************
Copyright  2024-2029. All rights reserved.
文件名     : drv_ap3216c.c
作者       : tangmingfei2013@126.com
版本       : V1.0
描述       : ap3216c 驱动程序
其他       : 无
日志       : 初版V1.0 2024/02/01***************************************************************/
#include <sys/types.h>
#include <sys/stat.h>
#include <linux/types.h>
#include <linux/i2c-dev.h>
#include <linux/i2c.h>
#include <sys/ioctl.h>
#include <unistd.h>
#include <stdio.h>
#include <string.h>
#include <fcntl.h>
#include <stdlib.h>
#include <linux/fs.h>
#include <errno.h>
#include <assert.h>
#include <string.h>
#include <time.h>
#include "drv_ap3216.h"#define DEV_FILE               "/dev/i2c-0"static int fd = -1;static void msleep(unsigned int time)
{struct timespec sleeper, temp;sleeper.tv_sec = (time_t)(time/1000);sleeper.tv_nsec = (long)(time%1000)*1000000;nanosleep(&sleeper, &temp);
}static int ap3216c_write_reg( unsigned char reg, unsigned char cmd)
{int              ret = -1;unsigned char    buf[2] = {0};buf[0] = reg;buf[1] = cmd;ret = write(fd, buf, 2);if( ret < 0 ){printf("write cmd to ap3216c register failure.\n");return -1;}return 0;
}static int ap3216c_read_reg( unsigned char reg, unsigned char *val)
{int           ret = -1;unsigned char buf[1] = {0};buf[0] = reg;           //send register address ret = write( fd, buf, 1);if( ret < 0 ){printf("write cmd to ap3216c register failure.\n");return -1;}ret = read(fd, buf, 1);  //read data from the register if( ret < 0 ){printf("get the humidy failure.\n");return -1;}*val = buf[0];return 0;
}void ap3216c_read_datas(ap3216c_data *pdata)
{unsigned char i =0;unsigned char buf[6], val = 0;/* read all sensor‘ data */for( i = 0; i < 6; i++)    {ap3216c_read_reg( AP3216C_IRDATALOW + i, &val); buf[i] = val;}/* IR   */if(buf[0] & 0X80){  /* IR_OF位为1,则数据无效 */pdata->ir = 0;}        else {        pdata->ir = ((unsigned short)buf[1] << 2) | (buf[0] & 0X03); }        /* ALS  */  pdata->als = ((unsigned short)buf[3] << 8) | buf[2]; /* PS */if(buf[4] & 0x40){    /* IR_OF位为1,则数据无效 */pdata->ps = 0; }        else{                pdata->ps = ((unsigned short)(buf[5] & 0X3F) << 4) | (buf[4] & 0X0F); }
}void ap3216c_release( void )
{close( fd );
}int ap3216c_init(void)
{// init i2c fd = open(DEV_FILE, O_RDWR);if( fd < 0 ){close( fd );printf("%s %s i2c device open failure: %s\n", __FILE__, __FUNCTION__, strerror(errno));return -1;}ioctl(fd, I2C_TENBIT, 0);ioctl(fd, I2C_SLAVE, AP3216C_ADDR);// reset sensor ap3216c_write_reg( AP3216C_SYSTEMCONG, 0x04);msleep(2);// enable ALS、PS+IRap3216c_write_reg( AP3216C_SYSTEMCONG, 0X03);msleep(2);return fd;
}

在drv_ap3216c.h中，编写如下代码：

#ifndef __DRV__AP3216_H
#define __DRV__AP3216_H#ifdef __cplusplus
extern "C" {
#endif#define AP3216C_ADDR          0X1E/* AP3316C寄存器 */
#define AP3216C_SYSTEMCONG    0x00    /* 配置寄存器       */
#define AP3216C_INTSTATUS     0X01    /* 中断状态寄存器   */
#define AP3216C_INTCLEAR      0X02    /* 中断清除寄存器   */
#define AP3216C_IRDATALOW     0x0A    /* IR数据低字节     */
#define AP3216C_IRDATAHIGH    0x0B    /* IR数据高字节     */
#define AP3216C_ALSDATALOW    0x0C    /* ALS数据低字节    */
#define AP3216C_ALSDATAHIGH   0X0D    /* ALS数据高字节    */
#define AP3216C_PSDATALOW     0X0E    /* PS数据低字节     */
#define AP3216C_PSDATAHIGH    0X0F    /* PS数据高字节     */typedef struct _ap3216c_data{unsigned short ir; unsigned short als; unsigned short ps;      /* */ 
}ap3216c_data;void ap3216c_read_datas(ap3216c_data *pdata);
int ap3216c_init(void);#ifdef __cplusplus
}
#endif#endif /* __DRV__AP3216_H */

 3 编写测试代码

测试主要实现，调用驱动程序接口，读取ALS,PS,IR数据，并打印出来

3.1 测试代码实现

创建一个test_ap3216.c，编写如下代码：

/***************************************************************
Copyright  2024-2029. All rights reserved.
文件名     : test_ap3216.c
作者       : tangmingfei2013@126.com
版本       : V1.0
描述       : 验证dev_ap3216.c 
其他       : 无
日志       : 初版V1.0 2024/02/1***************************************************************/
#include <sys/types.h>
#include <sys/stat.h>
#include <linux/types.h>
#include <linux/i2c-dev.h>
#include <linux/i2c.h>
#include <unistd.h>
#include <stdio.h>
#include <string.h>
#include <fcntl.h>
#include <stdlib.h>
#include <linux/fs.h>
#include <sys/ioctl.h>
#include <errno.h>
#include <assert.h>
#include <string.h>
#include <time.h>
#include "drv_ap3216.h"int main(void)
{ap3216c_data stru_data;int count_run = 100;int set;set = ap3216c_init();if( set < 0){printf("initial ap3216c failure.\n");return -1;}while( count_run > 0){ap3216c_read_datas( &stru_data );printf("ir = %d, als = %d, ps = %d \r\n", stru_data.ir, stru_data.als, stru_data.ps);count_run--;sleep(1);}ap3216c_release();return 0;
}

3.2 Makefile

在测试程序的目录下，创建一个makefile文件，编写如下代码

CFLAGS= -Wall -O2
CC=/home/ctools/gcc-linaro-4.9.4-arm-linux-gnueabihf/bin/arm-linux-gnueabihf-gcc
STRIP=/home/ctools/gcc-linaro-4.9.4-arm-linux-gnueabihf/bin/arm-linux-gnueabihf-striptest_ap3216: test_ap3216.o drv_ap3216.o$(CC) $(CFLAGS) -o test_ap3216 test_ap3216.o drv_ap3216.o$(STRIP) -s test_ap3216clean:rm -f test_ap3216 test_ap3216.o drv_ap3216.o

4 测试

4.1 编译代码

使用Make命令编译代码，然后将生成的可执行文件copy到NFS的共享目录下，方便在板卡中运行程序。

4.2 运行测试程序

 运行测试程序，可以看见在终端上打印出来sensor的数据

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

如若内容造成侵权/违法违规/事实不符，请联系瞎胡闹网进行投诉反馈，一经查实，立即删除！

相关文章

HTML+CSS：动态搜索框

HTML+CSS：动态搜索框

效果演示 这段代码实现了一个简单的搜索栏效果。页面背景为从天蓝色到深蓝色的渐变色&#xff0c;搜索栏包括一个圆形背景的搜索图标和一个输入框。当用户点击搜索图标时&#xff0c;输入框会从搜索图标的位置滑出&#xff0c;显示一个输入框和一个清除按钮。用户可以在输入框中…
阅读更多...
西门子200SMART SB AE01的正确用法

西门子200SMART SB AE01的正确用法

西门子200SMART SB AE01&#xff0c;就是1路模拟量输入的SB板。信号板直接安装在 SR/ST CPU 本体正面&#xff0c;无需占用电控柜空间&#xff0c;安装、拆卸方便快捷。有些小型的系统如果只有1路模拟量输入&#xff0c;或者模块配置中恰好缺少1路模拟量输入&#xff0c;就可以…
阅读更多...
33.云原生之Istio管理任何七层流量

33.云原生之Istio管理任何七层流量

云原生专栏大纲 文章目录 Istio存在的问题Aeraki介绍Aeraki 的解决方案支持的协议支持的特性 安装AerakiAeraki教程采用 ServiceEntry 的 Demo 应用使用 Dubbo2Istio 对接 Dubbo 注册表 的 Demo 应用&#xff08;Interface 级流量治理&#xff09; Service Mesh 中有大量的七层…
阅读更多...
智能光耦合器的特点概述

智能光耦合器的特点概述

在不断发展的技术领域&#xff0c;光耦合器在确保无缝通信和可靠信号传输方面的作用变得越来越关键。本文深入探讨了光耦合器的复杂性&#xff0c;阐明了其重要性&#xff0c;探索了进步&#xff0c;并解决了光耦合器技术人员面临的常见问题。 光耦合器基础知识&#xff1a; 光…
阅读更多...
力扣hot100题解（python版1-6题）

力扣hot100题解（python版1-6题）

1、两数之和 给定一个整数数组 nums 和一个整数目标值 target&#xff0c;请你在该数组中找出 和为目标值 target 的那 两个 整数&#xff0c;并返回它们的数组下标。 你可以假设每种输入只会对应一个答案。但是&#xff0c;数组中同一个元素在答案里不能重复出现。 你可以按…
阅读更多...
SpringBoot和SpringCloud的区别，使用微服务的好处和缺点

SpringBoot和SpringCloud的区别，使用微服务的好处和缺点

SpringBoot是一个用于快速开发单个Spring应用程序的框架&#xff0c;通过提供默认配置和约定大于配置的方式&#xff0c;快速搭建基于Spring的应用。让程序员更专注于业务逻辑的编写&#xff0c;不需要过多关注配置细节。可以看成是一种快速搭建房子的工具包&#xff0c;不用从…
阅读更多...
List集合之UML、特点、遍历方式、迭代器原理、泛型、装拆箱及ArrayList、LinkedList和Vector的区别

List集合之UML、特点、遍历方式、迭代器原理、泛型、装拆箱及ArrayList、LinkedList和Vector的区别

目录 ​编辑 一、什么是UML 二、集合框架 三、List集合 1.特点 2.遍历方式 3.删除 4.优化 四、迭代器原理 五、泛型 六、装拆箱 七、ArrayList、LinkedList和Vector的区别 ArrayList和Vector的区别 LinkedList和Vector的区别 一、什么是UML UML&#xff08;Unif…
阅读更多...
C# winfroms使用socket客户端服务端代码详解

C# winfroms使用socket客户端服务端代码详解

文章目录 1️⃣ 通信相关说明1.1服务端与客户端1.2 信息发送原理1.3 信息接收原理 2️⃣ socket代码2.1 客户端代码2.2 服务端代码 3️⃣ 定时任务处理报文3.1 Timers定时任务 优质资源分享 作者&#xff1a;xcLeigh 文章地址&#xff1a;https://blog.csdn.net/weixin_4315141…
阅读更多...
【扩散模型】【网络结构探索】神经网络扩散：Neural Network Diffusion（论文解读）

【扩散模型】【网络结构探索】神经网络扩散：Neural Network Diffusion（论文解读）

项目地址&#xff1a;https://github.com/NUS-HPC-AI-Lab/Neural-Network-Diffusion 文章目录 摘要一、前言二、Nerual Network Diffusion &#xff08;神经网络扩散&#xff09;2.1扩散模型&#xff08;预备知识&#xff09;2.2 总览2.3 参数自动编码器2.4 参数生成 三、实验3…
阅读更多...
RocketMQ快速实战以及集群架构原理详解

RocketMQ快速实战以及集群架构原理详解

RocketMQ快速实战以及集群架构原理详解 组成部分 启动Rocket服务之前要先启动NameServer NameServer 提供轻量级Broker路由服务&#xff0c;主要是提供服务注册 Broker 实际处理消息存储、转发等服务的核心组件 Producer 消息生产者集群&#xff0c;通常为业务系统中的一个功…
阅读更多...
xff注入 [CISCN2019 华东南赛区]Web111

xff注入 [CISCN2019 华东南赛区]Web111

打开题目 看见smarty 想到模板注入 又看见ip 想到xff注入 一般情况下输入{$smarty.version}就可以看到返回的smarty的版本号。该题目的Smarty版本是3.1.30 在Smarty3的官方手册里有以下描述: Smarty已经废弃{php}标签&#xff0c;强烈建议不要使用。在Smarty 3.1&#xff…
阅读更多...
07 MyBatis之高级映射 + 懒加载(延迟加载)+缓存

07 MyBatis之高级映射 + 懒加载(延迟加载)+缓存

1. 高级映射 例如有两张表, 分别为班级表和学生表 自然, 一个班级对应多个学生 像这种数据 , 应该如果如何映射到Java的实体类上呢? 这就是高级映射解决的问题 以班级和学生为例子 , 因为一个班级对应多个学生 , 因此学生表中必定有一个班级编号字段cid 但我们在学生的实体…
阅读更多...
HarmonyOS学习--三方库

HarmonyOS学习--三方库

文章目录 一、三方库获取二、常用的三方库1. UI库&#xff1a;2. 网络库&#xff1a;3. 动画库&#xff1a; 三、使用开源三方库1. 安装与卸载2. 使用 四、问题解决1. zsh: command not found: ohpm 一、三方库获取 在Gitee网站中获取 搜索OpenHarmony-TPC仓库&#xff0c;在t…
阅读更多...
Day20_网络编程(软件结构,网络编程三要素,UDP网络编程,TCP网络编程)

Day20_网络编程(软件结构,网络编程三要素,UDP网络编程,TCP网络编程)

文章目录 Day20 网络编程学习目标1 软件结构2 网络编程三要素2.1 IP地址和域名1、IP地址2、域名3、InetAddress类 2.2 端口号2.3 网络通信协议1、OSI参考模型和TCP/IP参考模型2、UDP协议3、TCP协议 2.4 Socket编程 3 UDP网络编程3.1 DatagramSocket和DatagramPacket1、Datagram…
阅读更多...
强大的文本绘图——PlantUML

强大的文本绘图——PlantUML

PlantUML是一款开源工具&#xff0c;它允许用户通过简单的文本描述来创建UML图&#xff08;统一建模语言图&#xff09;。这种方法可以快速地绘制类图、用例图、序列图、状态图、活动图、组件图和部署图等UML图表。PlantUML使用一种领域特定语言&#xff08;DSL&#xff09;&am…
阅读更多...
PostMan使用自带js库base64编码、sha256摘要、环境变量的使用

PostMan使用自带js库base64编码、sha256摘要、环境变量的使用

目录 1、环境变量的使用2、base64编码、sha256摘要、以及脚本的使用3、脚本代码 在请求调试接口的过程中&#xff0c;因为要使用大量相同的参数&#xff0c;使用变量的方式能很大程度上减轻接口调用的工作量 版本说明&#xff1a;Postman for Windows&#xff0c;Version&#…
阅读更多...
BUGKU-WEB 备份是个好习惯

BUGKU-WEB 备份是个好习惯

题目描述 题目截图如下&#xff1a; 进入场景看看&#xff1a; 解题思路 看源码看提示&#xff1a;备份是个好习惯扫描目录md5弱比较 相关工具 御剑md5解密&#xff1a;https://www.somd5.com/ 解题步骤 看到的这串字符&#xff0c;有点像md5&#xff1f; d41d8cd98…
阅读更多...
【PCL】（十二）使用ConditionalRemoval或RadiusOutlierRemoval滤波器对点云进行滤波

【PCL】（十二）使用ConditionalRemoval或RadiusOutlierRemoval滤波器对点云进行滤波

&#xff08;十二&#xff09;使用ConditionalRemoval 或 RadiusOutlierRemoval滤波器对点云进行滤波 RadiusOutlierRemove滤波器删除PointCloud中在指定半径的邻域范内&#xff0c;邻点没能达到指定数量的点。下图中&#xff0c;如果指定了邻点数为1&#xff0c;则黄色点将从…
阅读更多...
亿道丨三防平板电脑厂家推荐丨三防平板PAN智能化赋能

亿道丨三防平板电脑厂家推荐丨三防平板PAN智能化赋能

随着科技的不断进步和人们对智能化产品的需求日益增长&#xff0c;三防平板迎来了智能化赋能的时代。通过融合创新科技&#xff0c;三防平板实现了更高的性能、更智能的功能以及更广泛的应用场景&#xff0c;引领着未来的发展潮流。 一、智能化技术提升性能 随着技术的进步&…
阅读更多...
Nginx网络服务四-----日志、Nginx压缩和ssl

Nginx网络服务四-----日志、Nginx压缩和ssl

1.自定义访问日志 如果访问出错---404&#xff0c;可以去看error.log日志信息 访问日志是记录客户端即用户的具体请求内容信息&#xff0c;而在全局配置模块中的error_log是记录nginx服务器运行时的日志保存路径和记录日志的level&#xff0c;因此两者是不同的&#xff0c;而且…
阅读更多...
最新文章

Copyright @ 2022~2023