【模块系列】STM32&TCS3472

前言

  手上正好有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();	// 666
	MyI2C_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);
	// 启动ADC
	TCS34725_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();	// 666
	MyI2C_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/1bfYNq78vGN_rHMDkys3_kA  提取码:1x08

  • 27
    点赞
  • 22
    收藏
    觉得还不错? 一键收藏
  • 10
    评论
### 回答1: 基于STM32的TCS230模块是一种颜色传感器,可以通过检测物体的颜色来进行相应的控制。该模块能够识别物体颜色的红、绿、蓝三个基本颜色以及其他混合颜色。它可以广泛应用于颜色排序、颜色检测和颜色识别等领域。 TCS230模块由颜色传感器和STM32微控制器组成。颜色传感器可以通过选择不同的滤光片来选择不同的颜色检测通道。在检测过程中,传感器会产生一个频率与检测到的颜色相关的电信号,STM32通过检测这个频率来判断物体的颜色。 基于STM32的TCS230模块具有以下特点: 1. 高精度:传感器能够对物体的颜色进行高精度的检测和识别,可以准确地分辨出不同的颜色。 2. 灵敏度可调:模块支持对传感器的灵敏度进行调节,可以根据具体的应用需求进行调整。 3. 低功耗:模块在工作时的功耗较低,使用较少的电能,有助于延长电池寿命。 4. 简单易用:模块提供了简单的接口和开发板设计,使得开发者可以快速上手使用。 5. 可编程性强:STM32微控制器具有强大的可编程性,可以通过编程来实现各种功能和控制。 基于STM32的TCS230模块在工业自动化、机器人技术、光电检测等领域具有广泛的应用前景。它可以实现对颜色信息的快速获取和处理,为各种应用提供了可靠的颜色检测和识别功能。 ### 回答2: 基于STM32的TCS230模块是一种颜色传感器模块,由STM32单片机和TCS230芯片组成。该模块能够通过测量所处环境中物体的颜色来实现色彩识别功能。 TCS230芯片是一种RGB颜色传感器,能够以数字方式输出识别到的颜色信息。它能够感知包括红、绿、蓝在内的基本颜色,并通过输出不同频率的方波来表示不同色彩的强弱。通过STM32单片机来控制TCS230芯片的工作模式和参数设置,我们可以实现对颜色的检测、分析和判断。 基于STM32的TCS230模块具有多种应用场景。比如在自动化生产的流水线上,可以利用该模块检测产品的颜色,实现自动分类与分拣。在智能家居系统中,可以通过颜色识别技术来实现对灯光和家电等的自动控制。此外,在机器人领域,该模块也可以用于实现机器人对周围环境的感知和交互。 使用基于STM32的TCS230模块,我们可以通过编程来读取芯片输出的颜色信息,并根据不同的颜色来执行相应的控制逻辑。我们可以设置阈值,来判断某个颜色是否达到了预设条件,触发相应的操作。此外,还可以利用该模块的频率输出功能,来实现颜色的定量分析。 总之,基于STM32的TCS230模块是一种实现色彩识别功能的颜色传感器模块,通过STM32单片机的控制,可以实现对颜色信息的获取、处理和控制。它在自动化生产、智能家居和机器人等领域都有广泛的应用前景。 ### 回答3: 基于STM32的TCS230模块是一种颜色传感器模块,广泛用于电子设计中。TCS230模块可以检测物体的颜色并将其转化为数字信号,从而实现对颜色的识别。该模块使用STM32微控制器作为主控芯片,通过与TCS230模块的通信来获取颜色识别结果。 TCS230模块采用RGB三基色光敏原件,可以同时测量红、绿、蓝三种颜色的光线强度。在测量过程中,TCS230模块通过PWM信号控制光源的亮度,并通过频率除法器将测得的光信号转化为对应的频率信号输出。STM32微控制器通过接收这些频率信号,可以实时计算出物体的颜色。 基于STM32的TCS230模块具有多种应用场景。例如,在机器人项目中,可以使用该模块来实现机器人对物体的颜色识别和分析。在自动化灯光系统中,可以利用TCS230模块检测环境中的光线颜色,并根据检测结果自动调整灯光的亮度和颜色。此外,该模块还可以应用于印刷检测、安防监控等领域,为不同行业提供精准的颜色检测功能。 总之,基于STM32的TCS230模块是一种功能强大的颜色传感器模块,通过与STM32微控制器的配合,可以实现对物体颜色的准确识别和分析。其广泛的应用领域使得该模块成为电子设计中不可或缺的重要工具之一。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 10
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值