【花雕学编程】Arduino动手做（188）---TSL2561数字I2C环境光传感器的基本测试

《Arduino 手册（思路与案例）》栏目介绍：
在电子制作与智能控制的应用领域：广泛涉及了Arduino BLDC、Arduino CNC、Arduino ESP32 SPP、Arduino FreeRTOS、Arduino FOC、Arduino GRBL、Arduino HTTP、Arduino HUB75、Arduino IoT Cloud、Arduino JSON、Arduino LCD、Arduino OLED、Arduino LVGL、Arduino PID 及 Arduino TFT 等方面的相关拓展思路和众多参考案例。本专栏目前博客近2300篇。
https://blog.csdn.net/weixin_41659040/category_12422453.html

37款传感器与模块的提法，在网络上广泛流传，其实Arduino能够兼容的传感器模块肯定是不止37种的。鉴于本人手头积累了一些传感器和执行器模块，依照实践出真知（一定要动手做）的理念，以学习和交流为目的，这里准备逐一动手试试多做实验，不管成功与否，都会记录下来——小小的进步或是搞不掂的问题，希望能够抛砖引玉。

**【Arduino】189种传感器模块系列实验（资料代码+仿真编程+图形编程）
实验一百八十八：TSL2561数字I2C环境光传感器 GY-2561光照强度检测模块 TSL2561数字I2C环境光传感器 GY-2561光照强度检测模块 **

TSL2561 是 TAOS（现属于德州仪器）公司生产的一款环境光传感器。

1、基本概述
TSL2561 能感知周围环境的光照强度，其内置了两个光敏二极管，分别对可见光和红外光敏感，通过对这两个光敏二极管输出信号的处理，可以计算出环境光的强度，并且能够将光信号转化为数字信号，通过 I²C 接口输出，便于与微控制器（如 Arduino、ESP32 等）进行连接和通信。

2、主要特性

1. 宽动态范围：可检测的光照强度范围很宽，从 0.1 lux 到 40,000 lux，能适应从微弱光线到强光的不同环境，比如室内昏暗的灯光环境到室外明亮的阳光环境都能准确测量。
2. 高灵敏度：对光线变化非常敏感，能够检测到微小的光照强度变化，适合用于需要精确光照检测的应用场景。
3. 可编程增益和积分时间：用户可以根据实际需求调整传感器的增益和积分时间，以优化在不同光照条件下的测量精度。例如，在低光照环境下可以增大增益和积分时间来提高测量灵敏度。
4. I²C 接口：采用 I²C 通信协议与微控制器进行数据传输，这种接口方式简单且通用，方便与各种开发板集成。
5. 低功耗：工作电流低，适合电池供电的设备使用，能有效延长设备的续航时间。

3、应用场景

1. 智能照明系统：根据环境光强度自动调节室内灯光的亮度，实现节能和舒适的照明效果。例如，在白天光线充足时降低灯光亮度，在夜晚光线较暗时提高灯光亮度。
2. 显示屏亮度调节：用于手机、平板电脑、笔记本电脑等设备，根据环境光强度自动调整显示屏的亮度，提供更好的视觉体验，同时也能节省电量。
3. 农业和园艺：在温室种植中，监测光照强度，帮助控制植物生长环境，确保植物获得适宜的光照。
4. 安防监控：根据环境光强度自动调整监控摄像头的曝光参数，保证在不同光照条件下都能拍摄到清晰的图像。

TSL2561 传感器的引脚详细说明：

• VCC：此引脚用于传感器的电源。它必须连接到 5V 电源。
• GND：GND 引脚（Ground）是传感器的电气接地。
• SLC：SLC 代表“串行时钟”，用于 I2C 通信。
• SDA：SDA 代表“串行数据”，也用于 I2C 通信。
• INT：INT 引脚（中断）用于配置传感器的 I2C 地址。

实验模块接线示意图——Arduino uno

搜索并安装TSL2561库

安装了第二个驱动库

【Arduino】189种传感器模块系列实验（资料代码+仿真编程+图形编程）
实验一百八十八：TSL2561数字I2C环境光传感器 GY-2561光照强度检测模块
项目之一：使用 TSL2561 光照传感器读取光强数据

实验开源代码

/*
  【Arduino】189种传感器模块系列实验（资料代码+仿真编程+图形编程）
  实验一百八十八：TSL2561数字I2C环境光传感器 GY-2561光照强度检测模块
  项目之一：使用 TSL2561 光照传感器读取光强数据
*/

#include <Wire.h>
#include "TSL2561.h"

TSL2561 tsl(TSL2561_ADDR_FLOAT);

void setup(void) {
  Serial.begin(9600);

  if (tsl.begin()) {
    Serial.println("找到传感器");
  } else {
    Serial.println("没有检测到传感器？");
    while (1);
  }

  tsl.setGain(TSL2561_GAIN_16X);
  tsl.setTiming(TSL2561_INTEGRATIONTIME_13MS);

}

void loop(void) {
  uint16_t luminosite = tsl.getLuminosity(TSL2561_VISIBLE);

  Serial.print("亮度：");
  Serial.print(luminosite);
  Serial.println(" Lux");
  delay(1000);
}

代码解读

这段代码使用 TSL2561 光照传感器 读取光强数据，并通过 串口打印亮度值（Lux），核心逻辑如下：

1. 初始化
   ✅ #include <Wire.h> → 使用 I2C 进行通信
   ✅ TSL2561 tsl(TSL2561_ADDR_FLOAT); → 初始化 TSL2561 传感器
   ✅ Serial.begin(9600); → 启动串口通信，波特率 9600

2. 传感器检测
   ✅ if (tsl.begin()) { Serial.println(“Capteur trouvé”); } → 检查是否找到传感器
   ✅ else { Serial.println(“Aucun capteur détecté ?”); while(1); } → 未找到传感器时进入死循环

3. 传感器设置
   ✅ tsl.setGain(TSL2561_GAIN_16X); → 设置增益 16 倍，提高检测精度
   ✅ tsl.setTiming(TSL2561_INTEGRATIONTIME_13MS); → 设置积分时间 13ms

4. 读取光照数据
   ✅ uint16_t luminosite = tsl.getLuminosity(TSL2561_VISIBLE); → 获取可见光强度
   ✅ Serial.print(“Luminosité : “); Serial.print(luminosite); Serial.println(” Lux”); → 打印光照数据（单位 Lux）

5. 循环读取
   ✅ delay(1000); → 每 1 秒读取一次光照数据
   这段代码让 TSL2561 传感器每秒读取一次光照强度，并在串口打印 Lux 值 。

实验串口返回情况

实验场景图