【模块系列】STM32TCS3472

发布时间：2026/7/14 14:34:54

【模块系列】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

相关新闻

Python expandtabs()与endswith()方法

Python expandtabs()与endswith()方法

Python expandtabs()方法 描述 Python expandtabs() 方法把字符串中的 tab 符号(\t)转为空格&#xff0c;默认的空格数 tabsize 是 8。 语法 expandtabs()方法语法&#xff1a; string.expandtabs(tabsize8) 参数 tabsize -- 指定转换字符串中的 tab 符号(\t)转为空格的字…

2026/7/10 5:12:56
qml实现动态轮播图

qml实现动态轮播图

一、效果展示 二、源码分享 DynamicCarousel.qmlimport QtQuick import QtQuick.Controls import QtQuick.Layouts import QtQuick.ShapesItem {id:selfsignal clearError(string numberStr)PathView{id:pathViewanchors.fill: parentfocus: trueclip: truemodel:listModeldele…

2026/7/6 6:27:36
[C#]Onnxruntime部署Chinese CLIP实现以文搜图以文找图功能

[C#]Onnxruntime部署Chinese CLIP实现以文搜图以文找图功能

【官方框架地址】 https://github.com/OFA-Sys/Chinese-CLIP 【算法介绍】 在当今的大数据时代&#xff0c;文本信息处理已经成为了计算机科学领域的核心议题之一。为了高效地处理海量的文本数据&#xff0c;自然语言处理&#xff08;NLP&#xff09;技术应运而生。而在诸多N…

2026/7/13 14:10:13

最新新闻

AMD SESR-M7-512x512-tiles-amdnpu性能对比：INT8量化如何提升NPU推理速度 [特殊字符]

AMD SESR-M7-512x512-tiles-amdnpu性能对比：INT8量化如何提升NPU推理速度 [特殊字符]

AMD SESR-M7-512x512-tiles-amdnpu性能对比&#xff1a;INT8量化如何提升NPU推理速度 &#x1f680; 【免费下载链接】sesr-m7-512x512-tiles-amdnpu 项目地址: https://ai.gitcode.com/hf_mirrors/amd/sesr-m7-512x512-tiles-amdnpu 在人工智能推理领域&#xff0c;模…

2026/7/14 14:34:52
微世界模型部署指南：如何在本地运行AMD Micro-World AI视频生成

微世界模型部署指南：如何在本地运行AMD Micro-World AI视频生成

微世界模型部署指南&#xff1a;如何在本地运行AMD Micro-World AI视频生成 【免费下载链接】Micro-World 项目地址: https://ai.gitcode.com/hf_mirrors/amd/Micro-World AMD Micro-World是一款强大的AI视频生成工具&#xff0c;能够帮助用户轻松创建高质量的视频内容…

2026/7/14 14:34:52
30岁，被裁员前三个月，我从前端跳进了AI Agent的坑

30岁，被裁员前三个月，我从前端跳进了AI Agent的坑

去年秋天&#xff0c;部门会议上总监说"组织架构优化"的时候&#xff0c;我低头数了数工牌号——前后端加起来27个人&#xff0c;优化名额8个。我30岁&#xff0c;女&#xff0c;前端&#xff0c;性价比这三个字在我脑子里自动排好了队。 当天晚上回家&#xff0c;我…

2026/7/14 14:34:52
革命性超分辨率模型：Real-ESRGAN 128x128-tiles-amdnpu如何实现4倍图像质量飞跃

革命性超分辨率模型：Real-ESRGAN 128x128-tiles-amdnpu如何实现4倍图像质量飞跃

革命性超分辨率模型&#xff1a;Real-ESRGAN 128x128-tiles-amdnpu如何实现4倍图像质量飞跃 【免费下载链接】realesrgan-128x128-tiles-amdnpu 项目地址: https://ai.gitcode.com/hf_mirrors/amd/realesrgan-128x128-tiles-amdnpu 想要将低分辨率图像瞬间提升4倍清晰度…

2026/7/14 14:34:52
终极指南：如何用OpCore-Simplify在3分钟内完成Hackintosh配置

终极指南：如何用OpCore-Simplify在3分钟内完成Hackintosh配置

终极指南&#xff1a;如何用OpCore-Simplify在3分钟内完成Hackintosh配置 【免费下载链接】OpCore-Simplify A tool designed to simplify the creation of OpenCore EFI 项目地址: https://gitcode.com/GitHub_Trending/op/OpCore-Simplify OpCore-Simplify是一款革命性…

2026/7/14 14:34:52
SingGuard+NSFA双模型实战部署教程：AI内容与智能体行为安全落地配置清单

SingGuard+NSFA双模型实战部署教程：AI内容与智能体行为安全落地配置清单

2026年Claude Code后门事件彻底撕开了AI应用落地的核心安全漏洞。以往行业的安全防护重心&#xff0c;全部集中在大模型输入输出的文本内容合规审核上&#xff0c;团队运维人员只会拦截违规话术、低俗文本、敏感图片。但很少有人关注AI智能体的执行链路风险。 现在绝大多数企业…

2026/7/14 14:34:25

日新闻

2026综合实力出众的国内投票系统服务商汇总:兼顾安全与性价比

2026综合实力出众的国内投票系统服务商汇总:兼顾安全与性价比

网络投票早已不是“能发起就行”的时代了。刷票毁公平、收费毁预算、卡顿毁体验、导不出数据等于白干——这四条铁律&#xff0c;是无数活动组织者用真金白银换来的教训。市面上打着“免费”旗号的投票工具多如牛毛&#xff0c;但真正能做到永久免费、零广告、强防刷、免费导出…

2026/7/14 0:00:55
【小程序毕业设计】基于 SpringBoot 的畲族特色文创产品电商小程序的设计与实现 八闽畲族文化数字化交流与线上交易系统(源码+文档+远程调试，全bao定制等)

【小程序毕业设计】基于 SpringBoot 的畲族特色文创产品电商小程序的设计与实现 八闽畲族文化数字化交流与线上交易系统(源码+文档+远程调试，全bao定制等)

博主介绍&#xff1a;✌️码农一枚 &#xff0c;专注于大学生项目实战开发、讲解和毕业&#x1f6a2;文撰写修改等。全栈领域优质创作者&#xff0c;博客之星、掘金/华为云/阿里云/InfoQ等平台优质作者、专注于Java、小程序技术领域和毕业项目实战 ✌️技术范围&#xff1a;&am…

2026/7/14 0:00:55
微信投票到底该怎么做?2026三大平台对比+人人微投票保姆级图文教程

微信投票到底该怎么做?2026三大平台对比+人人微投票保姆级图文教程

在 2026 年的微信生态中&#xff0c;投票依然是社群互动、品牌营销和校园赛事中最直接有效的“流量引擎”。无论是幼儿园想办一场引爆朋友圈的“萌宝大赛”&#xff0c;还是企业要评选年度“优秀员工”&#xff0c;选对工具&#xff0c;活动就成功了一半。然而&#xff0c;面对…

2026/7/14 0:00:55

周新闻

PlantUML 实战：5分钟将 UML 2.5 序列图转换为可执行代码草图

PlantUML 实战：5分钟将 UML 2.5 序列图转换为可执行代码草图

PlantUML 实战&#xff1a;5分钟将 UML 2.5 序列图转换为可执行代码草图 在软件开发过程中&#xff0c;清晰的系统设计往往比编码本身更为关键。传统拖拽式UML工具虽然直观&#xff0c;却常常成为效率杀手——频繁的鼠标操作打断设计思路&#xff0c;版本控制困难&#xff0c;…

2026/7/14 2:00:43
【RT-DETR涨点改进】29 动态Batch推理：让RT-DETR在低延迟下吃满GPU算力

【RT-DETR涨点改进】29 动态Batch推理：让RT-DETR在低延迟下吃满GPU算力

29 动态Batch推理：让RT-DETR在低延迟下吃满GPU算力 开篇故事 上个月帮一家安防厂商做项目优化，他们用RT-DETR做实时人流统计，部署在NVIDIA A10上。客户反馈说：“GPU利用率才30%，但延迟已经飙到40ms了，加人流量就丢帧。” 我远程一看，好家伙——生产环境里每个请求单独…

2026/7/14 3:20:10
Postman 环境变量实战：3种动态设置方法与CI/CD集成避坑指南

Postman 环境变量实战：3种动态设置方法与CI/CD集成避坑指南

Postman 环境变量高阶实战&#xff1a;动态管理与 CI/CD 深度集成在接口自动化测试领域&#xff0c;环境变量的灵活运用往往成为区分初级与高级测试工程师的关键能力。本文将深入探讨 Postman 环境变量的三种动态设置模式&#xff0c;并分享 Newman 在 CI/CD 流水线中的实战避坑…

2026/7/14 5:00:42

月新闻

[C++]内存管理：串顺序存储的内存回收

[C++]内存管理：串顺序存储的内存回收

在串&#xff08;字符串&#xff09;的顺序存储中&#xff0c;内存回收的方式取决于字符串的存储方式以及所使用的编程语言和相关库。以下以 C 为例进行说明&#xff0c;因为 C 对内存管理有较为直接的控制。 1. 基于 char 数组的串顺序存储 如果使用普通的 char 数组来存储字…

2026/7/13 17:23:43
移动端游戏功耗测试实战：电流、功率、亮度和场景对比

移动端游戏功耗测试实战：电流、功率、亮度和场景对比

移动端游戏功耗测试：先控制变量，再比较优化是否真的省电 摘要：功耗测试最容易犯的错误，是拿两次不同温度、不同亮度、不同场景的平均功率直接比较。本文给出一套可复现的游戏功耗测试方法，覆盖引擎特性验证、版本回归和黑盒体验测试，并说明如何把功耗与帧率、温控、CPU/G…

2026/7/14 5:33:13
足球口袋教练 HarmonyOS 离线应用实战（03/20）：ArkUI 首页仪表盘搭建

足球口袋教练 HarmonyOS 离线应用实战（03/20）：ArkUI 首页仪表盘搭建

本文是“足球口袋教练 HarmonyOS 离线应用实战”系列第 3 篇。示例项目是一个 HarmonyOS / ArkTS / ArkUI 编写的离线足球训练助手&#xff0c;围绕真实页面、真实截图和可复现操作展开。 本篇要解决的问题 训练 App 的首页不能只展示欢迎语&#xff0c;它要解决“我现在该点哪…

2026/7/14 1:15:37