【模块系列】STM32TCS3472

前言

  手上正好有TCS3472模块,也正好想在加深一下自己对I2C协议的理解和应用,所以就写了这个代码库出来。参考的资料主要来源于TCS3472的数据手册,和arduino中MH_TCS3472库的宏定义,和函数名称,我就没有重新命名,方便大家理解和使用修改之类的。

环境

  • 开发板:STM32C6T6最小系统板

  • 案例的代码环境:Keil5+STM32CubeMX生成的HAL库,OLED(4P)+TCS3472

  • 案例接线:TCS3472模块的VIN接到ST-LINK的5V,OLED模块VCC接3.3V。TCS3472和OLED的SDA接到PB9,SCL接到PB8。TCS3472模块的LED引脚接PA3(闪烁)或GND都行,不接的话LED的会一直亮,导致RGB值与透明度计算后大于256的。

    注意:假如TCS3472模块的VIN接到板载的3.3V的话,可能会发生供电不足的情况。

特点

下述介绍参考数据手册

  • 支持I2C协议快速模式,接口数据传输速率高达 400 kbit/s

  • TCS3472提供红、绿、蓝(RGB)和透明光©感应值的16位数字量的返回。

  • 红、绿、蓝(RGB)和透明光。带红外屏蔽滤光片的感应器。可编程模拟增益和积分时间。3,800,000:1。动态范围灵敏度极高-非常适合在暗玻璃后操作。

  • 外置可编程中断引脚,启用可屏蔽中断当超出预设值时,系统会发出电平式中断可编程上下限阈值,带持久性过滤器,从而减少MCU的开销

  • 有着电源管理,低功耗-2.5μA 休眠状态65μA等待状态,可编程等待状态时间从2.4ms 至>7 秒

代码

  代码方面除了CubeMX生成的工程框架外,还导入了OLED(4P),自制了MyI2C,TCS34725库,假如其它项目要用到的话注意也要导入这几个库。下面仅展示TCS34725库,完整工程文件会放在文章末尾的

TCS34725.H

#ifndef __TCS34725_H__
#define __TCS34725_H__#define TCS34725_ADDRESS          (0x52)		// 八位地址
#define TCS34725_ADDRESS_7bit     (0x29)		// 七位地址#define TCS34725_COMMAND_BIT      (0x80)#define TCS34725_ENABLE           (0x00)
#define TCS34725_ENABLE_AIEN      (0x10)    ///< RGBC Interrupt Enable 
#define TCS34725_ENABLE_WEN       (0x08)    ///< Wait enable - Writing 1 activates the wait timer 
#define TCS34725_ENABLE_AEN       (0x02)    ///< RGBC Enable - Writing 1 actives the ADC, 0 disables it 
#define TCS34725_ENABLE_PON       (0x01)    ///< Power on - Writing 1 activates the internal oscillator, 0 disables it 
#define TCS34725_ATIME            (0x01)    ///< Integration time 
#define TCS34725_WTIME            (0x03)    ///< Wait time (if TCS34725_ENABLE_WEN is asserted) 
#define TCS34725_WTIME_2_4MS      (0xFF)    ///< WLONG0 = 2.4ms   WLONG1 = 0.029s 
#define TCS34725_WTIME_204MS      (0xAB)    ///< WLONG0 = 204ms   WLONG1 = 2.45s  
#define TCS34725_WTIME_614MS      (0x00)    ///< WLONG0 = 614ms   WLONG1 = 7.4s   
#define TCS34725_AILTL            (0x04)    ///< Clear channel lower interrupt threshold 
#define TCS34725_AILTH            (0x05)
#define TCS34725_AIHTL            (0x06)    ///< Clear channel upper interrupt threshold 
#define TCS34725_AIHTH            (0x07)
#define TCS34725_PERS             (0x0C)    ///< Persistence register - basic SW filtering mechanism for interrupts 
#define TCS34725_PERS_NONE        (0b0000)  ///< Every RGBC cycle generates an interrupt                                
#define TCS34725_PERS_1_CYCLE     (0b0001)  ///< 1 clean channel value outside threshold range generates an interrupt   
#define TCS34725_PERS_2_CYCLE     (0b0010)  ///< 2 clean channel values outside threshold range generates an interrupt  
#define TCS34725_PERS_3_CYCLE     (0b0011)  ///< 3 clean channel values outside threshold range generates an interrupt  
#define TCS34725_PERS_5_CYCLE     (0b0100)  ///< 5 clean channel values outside threshold range generates an interrupt  
#define TCS34725_PERS_10_CYCLE    (0b0101)  ///< 10 clean channel values outside threshold range generates an interrupt 
#define TCS34725_PERS_15_CYCLE    (0b0110)  ///< 15 clean channel values outside threshold range generates an interrupt 
#define TCS34725_PERS_20_CYCLE    (0b0111)  ///< 20 clean channel values outside threshold range generates an interrupt 
#define TCS34725_PERS_25_CYCLE    (0b1000)  ///< 25 clean channel values outside threshold range generates an interrupt 
#define TCS34725_PERS_30_CYCLE    (0b1001)  ///< 30 clean channel values outside threshold range generates an interrupt 
#define TCS34725_PERS_35_CYCLE    (0b1010)  ///< 35 clean channel values outside threshold range generates an interrupt 
#define TCS34725_PERS_40_CYCLE    (0b1011)  ///< 40 clean channel values outside threshold range generates an interrupt 
#define TCS34725_PERS_45_CYCLE    (0b1100)  ///< 45 clean channel values outside threshold range generates an interrupt 
#define TCS34725_PERS_50_CYCLE    (0b1101)  ///< 50 clean channel values outside threshold range generates an interrupt 
#define TCS34725_PERS_55_CYCLE    (0b1110)  ///< 55 clean channel values outside threshold range generates an interrupt 
#define TCS34725_PERS_60_CYCLE    (0b1111)  ///< 60 clean channel values outside threshold range generates an interrupt 
#define TCS34725_CONFIG           (0x0D)
#define TCS34725_CONFIG_WLONG     (0x02)    ///< Choose between short and long (12x) wait times via TCS34725_WTIME 
#define TCS34725_CONTROL          (0x0F)    ///< Set the gain level for the sensor 
#define TCS34725_ID               (0x12)    ///< 0x44 = TCS34721/TCS34725, 0x4D = TCS34723/TCS34727 
#define TCS34725_STATUS           (0x13)
#define TCS34725_STATUS_AINT      (0x10)    ///< RGBC Clean channel interrupt 
#define TCS34725_STATUS_AVALID    (0x01)    ///< Indicates that the RGBC channels have completed an integration cycle 
#define TCS34725_CDATAL           (0x14)    ///< Clear channel data 
#define TCS34725_CDATAH           (0x15)
#define TCS34725_RDATAL           (0x16)    ///< Red channel data 
#define TCS34725_RDATAH           (0x17)
#define TCS34725_GDATAL           (0x18)    ///< Green channel data 
#define TCS34725_GDATAH           (0x19)
#define TCS34725_BDATAL           (0x1A)    ///< Blue channel data 
#define TCS34725_BDATAH           (0x1B)typedef enum
{TCS34725_INTEGRATIONTIME_2_4MS  = 0xFF,   ///<  2.4ms - 1 cycle    - Max Count: 1024  TCS34725_INTEGRATIONTIME_24MS   = 0xF6,   ///<  24ms  - 10 cycles  - Max Count: 10240 TCS34725_INTEGRATIONTIME_50MS   = 0xEB,   ///<  50ms  - 20 cycles  - Max Count: 20480 TCS34725_INTEGRATIONTIME_101MS  = 0xD5,   ///<  101ms - 42 cycles  - Max Count: 43008 TCS34725_INTEGRATIONTIME_154MS  = 0xC0,   ///<  154ms - 64 cycles  - Max Count: 65535 TCS34725_INTEGRATIONTIME_700MS  = 0x00    ///<  700ms - 256 cycles - Max Count: 65535 
}
tcs34725IntegrationTime_t;typedef enum
{TCS34725_GAIN_1X                = 0x00,   ///<  No gain  TCS34725_GAIN_4X                = 0x01,   ///<  4x gain  TCS34725_GAIN_16X               = 0x02,   ///<  16x gain TCS34725_GAIN_60X               = 0x03    ///<  60x gain 
}
tcs34725Gain_t;typedef unsigned          char uint8_t;
typedef unsigned short     int uint16_t;
typedef unsigned           int uint32_t;/*****	底层函数	 *****/
void TCS34725_WriteReg(uint8_t reg,uint8_t data);
uint8_t TCS34725_ReadReg(uint8_t reg);/*****	功能函数	 *****/
void TCS34725_Init(void);						// 初始化TCS34725配置
void TCS34725_enable(void);					// 使能器件
void TCS34725_lock(void);						// 使能TCS34725内部中断
uint8_t TCS34725_getID(void);			// 获取器件ID
uint8_t TCS34725_getStatus(void);	// 获取TCS34725状态
void TCS34725_setGain(tcs34725Gain_t gain);		// 设置增益
void TCS34725_setIntegrationTime(tcs34725IntegrationTime_t time);		// 设置时间增益
void TCS34725_getRGBC(uint16_t *r, uint16_t *g, uint16_t *b, uint16_t *c);		// 获取TCS34725的颜色反馈#endif

TCS34725.C

#include "TCS34725.h"
#include "MyI2C.h"/*** @描述:基于TCS34725 写寄存器 ID-地址-数据*/
void TCS34725_WriteReg(uint8_t reg,uint8_t data)
{MyI2C_Start();					MyI2C_SendByte(TCS34725_ADDRESS);			MyI2C_ReceiveAck();	MyI2C_SendByte(TCS34725_COMMAND_BIT | reg);		MyI2C_ReceiveAck();			MyI2C_SendByte(data);MyI2C_ReceiveAck();MyI2C_Stop();						
}/*** @描述:基于TCS34725 读寄存器 ID-地址-数据*/
uint8_t TCS34725_ReadReg(uint8_t reg)
{uint8_t reData = 0;MyI2C_Start();					MyI2C_SendByte(TCS34725_ADDRESS);		MyI2C_ReceiveAck();	MyI2C_SendByte(TCS34725_COMMAND_BIT | reg);			MyI2C_ReceiveAck();MyI2C_Start();	// 666MyI2C_SendByte(TCS34725_ADDRESS | 0x01);		MyI2C_ReceiveAck();	reData = MyI2C_ReceiveByte();MyI2C_SendAck(1);MyI2C_Stop();		return reData;
}/**
* @描述:初始化TCS34725配置
*/
void TCS34725_Init()
{TCS34725_setIntegrationTime(TCS34725_INTEGRATIONTIME_101MS);TCS34725_setGain(TCS34725_GAIN_1X);TCS34725_enable();
}/**
* @描述:TCS34725毫秒级延时
*/
void TCS34725_DelayMs(uint16_t ms)
{char i;for(i = 0;i < ms;i++){MyI2C_DelayUs(1000);}}/**
* @描述:设置时间增益
*/
void TCS34725_setIntegrationTime(tcs34725IntegrationTime_t time)
{// 更新时序寄存器TCS34725_WriteReg(TCS34725_ATIME,time);
}/**
* @描述:设置增益
*/
void TCS34725_setGain(tcs34725Gain_t gain)
{// 设置增益TCS34725_WriteReg(TCS34725_CONTROL,gain);}/**
* @描述:使能器件
*/
void TCS34725_enable(void)
{// 开启内部振荡器--启动TCS34725_WriteReg(TCS34725_ENABLE,TCS34725_ENABLE_PON);TCS34725_DelayMs(3);// 启动ADCTCS34725_WriteReg(TCS34725_ENABLE,TCS34725_ENABLE_PON | TCS34725_ENABLE_AEN);
}/**
* @描述:读取TCS34725指定寄存器
*/
uint16_t TCS34725_readRegWord(uint8_t reg)
{uint16_t h = 0x0000;		// 高八位uint16_t l = 0x0000;		// 低八位MyI2C_Start();															// I2C开始条件MyI2C_SendByte(TCS34725_ADDRESS);						// I2C发送字节MyI2C_ReceiveAck();													// I2C接收应答MyI2C_SendByte(TCS34725_COMMAND_BIT | reg | 0x20);	// I2C发送字节MyI2C_ReceiveAck();													// I2C接收应答MyI2C_Start();	// 666MyI2C_SendByte(TCS34725_ADDRESS | 0x01);		MyI2C_ReceiveAck();	h = MyI2C_ReceiveByte();			// I2C接收字节MyI2C_SendAck(0);							// I2C发送应答l = MyI2C_ReceiveByte();			// I2C接收字节MyI2C_SendAck(1);							// I2C发送应答MyI2C_Stop();									// I2C结束条件h <<= 8;h |= l;return h;
}/**
* @描述:获取TCS34725的颜色反馈
*/
void TCS34725_getRGBC(uint16_t *r, uint16_t *g, uint16_t *b, uint16_t *c)
{*c = TCS34725_readRegWord(TCS34725_CDATAL);*r = TCS34725_readRegWord(TCS34725_RDATAL);*g = TCS34725_readRegWord(TCS34725_GDATAL);*b = TCS34725_readRegWord(TCS34725_BDATAL);// 给定一定的采集后延时TCS34725_DelayMs(100);
}/**
* @描述:使能TCS34725内部中断
*/
void TCS34725_lock()
{uint8_t r = TCS34725_ReadReg(TCS34725_ENABLE);r |= TCS34725_ENABLE_AIEN;TCS34725_WriteReg(TCS34725_ENABLE, r);
}/**
* @描述:获取器件ID
* @返回:0x44 = TCS34721/TCS34725, 0x4D = TCS34723/TCS34727 
*/
uint8_t TCS34725_getID()
{return TCS34725_ReadReg(TCS34725_ID);
}/**
* @描述:获取TCS34725状态
* @返回:返回该寄存器数值
*/
uint8_t TCS34725_getStatus()
{return TCS34725_ReadReg(TCS34725_STATUS);
}

现象

  下面为代码现象。OLED上显示的分别是,ID,8位R,8位G,8位B,16位C的值,可以看出来,测出的结果跟我设定的结果还差一点,不过能测量出个大概,比如偏红色啊,偏蓝色啊。当然可能也是我的参数没配置好,大家想要更高精度的话,就要关注TCS34725_Init()里面的时间增益,和数值增益了。

在这里插入图片描述

在这里插入图片描述

工程

链接包含资料:Keil5工程代码*1,TCS34727资料手册(英文)*1

链接:https://pan.baidu.com/s/1AapcmqJjpgtlvu-eMr3Bpg  提取码:wq6k

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

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

相关文章

华为数通HCIA题库(750题)

完整题库在这里&#xff1a;华为数通HCIA-RS题库注释版-加水印.pdf资源-CSDN文库 此处只节选几题。 1.网络管理员在网络中捕获到了一个数据帧&#xff0c;其目的MAC地址是01-00-5E-AO-B1-C3。关于该MAC地址的说法正确的是&#xff08; )。 A.它是一个单播MAC地址 B.它是一个广播…

详解ajax、fetch、axios的区别

众所周知它们都用来发送请求&#xff0c;其实它们区别还蛮大的。这也是面试中的高频题&#xff0c;本文将详细进行讲解。 1. ajax 英译过来是Aysnchronous JavaScript And XML&#xff0c;直译是异步JS和XML&#xff08;XML类似HTML&#xff0c;但是设计宗旨就为了传输数据&a…

从JDK源码级别剖析JVM类加载器

欢迎大家关注我的微信公众号&#xff1a; 类加载运行全过程 当我们用java命令运行某个类的main函数启动程序时&#xff0c;首先需要通过类加载器把主类加载到JVM。 package com.tuling.jvm;public class Math {public static final int initData 666;public static User u…

多维时序 | Matlab实现RIME-HKELM霜冰算法优化混合核极限学习机多变量时间序列预测

多维时序 | Matlab实现RIME-HKELM霜冰算法优化混合核极限学习机多变量时间序列预测 目录 多维时序 | Matlab实现RIME-HKELM霜冰算法优化混合核极限学习机多变量时间序列预测效果一览基本介绍程序设计参考资料 效果一览 基本介绍 1.Matlab实现RIME-HKELM霜冰算法优化混合核极限学…

Git命令(bash)

来由 本地版本控制 集中版本控制 分布版本控制 每个人都有全部代码&#xff0c;安全性有待考究 对比 常用命令 配置 查看配置 (全部) git config -l (系统) git config --system --list (本地&#xff0c;也就是用户自己配置的) git config --global --list 配置自己的na…

使用CLIP和LLM构建多模态RAG系统

在本文中我们将探讨使用开源大型语言多模态模型(Large Language Multi-Modal)构建检索增强生成(RAG)系统。本文的重点是在不依赖LangChain或LLlama index的情况下实现这一目标&#xff0c;这样可以避免更多的框架依赖。 什么是RAG 在人工智能领域&#xff0c;检索增强生成(re…

Provide/Inject 依赖注入(未完待续)

父组件传递给子组件数据&#xff0c;通过props&#xff0c;但是需要逐层传递 provide/Inject 的推出就是为了解决这个问题&#xff0c;它提供了一种组件之间共享此类值的方式,不必通过组件树每层级显示地传递props 目的是为了共享那些被 认为对于一个组件树而言是全局的数据 p…

Ubuntu 22.04.3 LTS arm64 aarch64 ISO jammy-desktop-arm64.iso 下载

Ubuntu 22.04.3 LTS (Jammy Jellyfish) Daily Build 参考 Are there official Ubuntu ARM / aarch64 desktop images? - Ask Ubuntu

浅谈有源滤波装置应用在水处理行业配电系统中

摘要&#xff1a;水处理行业供配电系统涉及曝气风机、提升泵、污泥脱水设备等负载设备&#xff0c;导致异步电机产生更多无功功率和大量谐波&#xff0c;降低系统功率因数&#xff0c;对配电系统和负载造成很大危害。因此&#xff0c;水处理行业需要更加重视电能质量&#xff0…

解码数据:数据可视化的魔力在于快速概括

在信息爆炸的时代&#xff0c;我们每天都面临着海量的数据&#xff0c;无论是个人生活中的各种记录&#xff0c;还是工作中的业务数据&#xff0c;都充斥着我们的日常。如何从这些数据中快速实现归纳总结&#xff0c;理清思路&#xff0c;找出关键信息&#xff1f;数据可视化应…

记录浏览器莫名其妙部分网页无法访问的一个解决办法

问题描述&#xff1a; 不知道什么原因&#xff0c;浏览器无法访问CSDN了&#xff0c;访问其他网站都可以正常加载。 经电脑网络诊断检测&#xff0c;反馈内容大致为&#xff1a; 资源处于联机状态但未对连接尝试做出响应&#xff0c;远程计算机不接受端口443上的连接。 测试…

CNAS中兴新支点——软件测试报告如何编写,出检测报告第三方实验室推荐

进行软件测试工作&#xff0c;编写一份软件测试报告对于测试人员来说必不可少。虽然编写软件测试报告是软件测试人员的工作&#xff0c;但是项目的开发人员比如程序员、软件使用单位对软件测试报告的组成部分有一定的了解也是十分有必要的&#xff0c;软件测试报告比较容易理解…

统计学-R语言-1

文章目录 统计学介绍基本类型数据和变量数据抽样总结 统计学介绍 统计学(statistics)是“数据的科学” 1.是用以收集数据、分析数据和由数据得出结论的一组概念、原则和方法。 2.统计学进行推断的基础是数据(data)。数据不仅仅限于数字&#xff0c;也可能是图表、视频、音频或…

Talk|斯坦福大学史浩辰:学习结构化世界模型用于现实世界中柔性物体的操控

本期为TechBeat人工智能社区第562期线上Talk。 北京时间1月10日(周三)20:00&#xff0c;斯坦福大学博士生—史浩辰的Talk已准时在TechBeat人工智能社区开播&#xff01; 他与大家分享的主题是: “学习结构化世界模型用于现实世界中柔性物体的操控”&#xff0c;介绍了他的团队在…

03-JVM虚拟机-课堂笔记

3-JVM虚拟机 灵魂三问&#xff1a; JVM是什么&#xff1f; JVM广义上指的是一种规范。狭义上的是JDK中的JVM虚拟机。 为什么要学习JVM&#xff1f; 面试过程中&#xff0c;经常会被问到JVM。 研发过程中&#xff0c;肯定会面临一些重难点问题与JVM有关系。例如&#xff1a…

计算机毕业设计------SSH宿舍管理系统

项目介绍 本项目分为三种角色&#xff1a;系统管理员、楼宇管理员、学生&#xff1b; 系统管理员主要功能如下&#xff1a; 楼宇管理员管理、学生管理、楼宇管理、宿舍管理、学生入住登记、学生寝室调换、学生迁出登记、学生缺勤记录、修改密码、退出登录 楼宇管理员主要功能…

密码学(三)

文章目录 前言一、Software Attestation Overview二、Authenticated Key Agreement三、The Role of Software Measurement 前言 本文来自 Intel SGX Explained 请参考&#xff1a; 密码学&#xff08;一&#xff09; 密码学&#xff08;二&#xff09; 一、Software Attesta…

单片机原理及应用:定时器与计数器中断

时间概念 中断结构 引脚 TCON TMOD IE IP 时间概念 在一般单片机中&#xff0c;有2个16位可编程的硬件计数模块T0和T1&#xff0c;我们称其为计数器或定时器&#xff0c;顾名思义&#xff0c;该模块可以实现定时和计数两种功能&#xff0c;其功能由软件控制和切换。实质…

信道编码理论【信息论安全】

目录 一. 信道编码模型 二. 信道编码速率与错误译码率 2.1 信道编码速率 2.2 平均错误率 三. 信道容量 四. 小结 一. 信道编码模型 &#xff08;1&#xff09;消息 假定消息集合为M&#xff0c;如下&#xff1a; &#xff08;2&#xff09;编码 将消息m映射成码字&…

[VisualStudioCode]_[VSCODE]_[C/C++开发环境配置-问题解决和补充]

场景 在使用VSCode配置C的开发环境时《VisualStudioCode_C/C开发环境配置[1]》&#xff0c;编译时会发现找不到标准库的std::mutex和std::thread的声明&#xff0c;而这两个的头文件已经引入&#xff0c;什么情况&#xff1f; 无论如何MinGW都是Windows上验证开发C特性比较新的…