nanoFramework.Iot.Device.Tsl256x 1.2.613

TSL256x/TSL2560/TSL2561 - 亮度传感器

TSL2560 和 TSL2561 是亮度传感器。它们将光强度转换成数字信号的模拟到数字转换器。每个设备都结合了一个宽带光电二极管（可见光加红外线）和一个响应红外线的光电二极管，在一个单芯片 CMOS 电路中提供，能够在有效 20 位动态范围内提供近似视觉响应（16 位分辨率）。

两个积分模数转换器将光电二极管电流转换成代表每个通道测得的辐照度的数字输出。此数字输出可以输入到微处理器中，使用经验公式从辐照度（环境光水平）推导出 lux。

TSL2560 芯片允许 SMB-Alert 风格的中断，TSL2561 芯片支持传统的电平风格中断，该中断一直保持断言状态，直到固件清除它。

文档

• TSL256x 数据表

板子

使用方法

基本用法

TSL2560 和 TSL2561 设计用来测量两个 ADC 的积分时间和增益。默认值为 402 毫秒和一个正常的增益 x1。

基本用法如下

I2cDevice i2cDevice = I2cDevice.Create(new I2cConnectionSettings(1, Tsl256x.DefaultI2cAddress));
Tsl256x tsl256X = new(i2cDevice, PackageType.Other);
tsl256X.IntegrationTime = IntegrationTime.Integration402Milliseconds;
tsl256X.Gain = Gain.Normal;
var lux = tsl256X.MeasureAndGetIlluminance();
Console.WriteLine($"Illuminance is {lux.Lux} Lux");

注意事项:

• 请注意，有两种包装方式：CS和其他T、FN、CL。请参考文档了解您在板上使用的哪种包装。这将在创建传感器时成为一个问题，因为照度计算有所不同。
• 根据地址引脚的设置方式，该设备可能有3个不同的I2C地址
  • 默认I2cAddress = 0x39：当引脚接地时
  • 第二个I2cAddress = 0x29：当引脚悬浮时
  • 第三个I2cAddress = 0x49：当引脚接地时

检查版本

您可以确定您是否有TSL2560或TSL2561版本

var ver = tsl256X.Version;
string msg = ver.Major & 0x01 == 0x01 ? $"This is a TSL2561, version {ver}" : $"This is a TSL2560, version {ver}";
Console.WriteLine(msg);

使用中断

您可以通过《InterruptLevel》设置中断，您有不同可能的中断可以设置

• OutputDisabled：将禁用中断
• LevelInterrupt：将使用您设置的永久中断，见下文
• SmbAlertCompliant：将向SMB总线（仅限TSL2560版本）上的地址0b0000_1100发送警报
• TestMode：将生成测试目的的中断

InterruptPersistence 将允许您选择特定的中断时间

• EveryAdc：每次进行测量时
• AnyValueOutsideThreshold：任何时间值将超出设置阈值
• OutOfRangeXXIntegrationTimePeriods：其中XX是从2到15，只有当值超出超过XX次时才会中断

以下示例说明了如何使用测试模式设置基本中断

Console.WriteLine("Set interruption to test. Read the interrupt pin");
GpioController controller = new();
controller.OpenPin(PinInterrupt, PinMode.Input);
tsl256X.InterruptControl = InterruptControl.TestMode;
tsl256X.Enabled = true;
while (controller.Read(PinInterrupt) == PinValue.High)
{
    Thread.Sleep(1);
}

Console.WriteLine($"Interrupt detected, read the value to clear the interrupt");
tsl256X.GetRawChannels(out ushort ch0, out ushort ch1);

您还可以设置阈值上的中断。您首先需要设置阈值然后设置中断类型。

// Adjust those values with a previous measurement to understand the conditions, find a level where then you can
// hide the sensor with your arm and make it going under the minimum level or vice versa with a lamp
tsl256X.SetThreshold(0x0000, 0x00FF);
tsl256X.InterruptPersistence = InterruptPersistence.OutOfRange06IntegrationTimePeriods;
tsl256X.InterruptControl = InterruptControl.LevelInterrupt;
tsl256X.Power = true;
while (controller.Read(PinInterrupt) == PinValue.High)
{
    Thread.Sleep(1);
}

Console.WriteLine($"Interrupt detected, read the value to clear the interrupt");
tsl256X.GetRawChannels(out ch0, out ch1);
Console.WriteLine($"Raw data channel 0 {ch0}, channel 1 {ch1}");

手动集成

您还可以设置手动集成。请注意，您无法轻松计算照度等效值。您需要使用提供的手动集成功能

Console.WriteLine("This will use a manual integration for 2 seconds");
tsl256X.StartManualIntegration();
Thread.Sleep(2000);
tsl256X.StopManualIntegration();
tsl256X.GetRawChannels(out ch0, out ch1);
Console.WriteLine($"Raw data channel 0 {ch0}, channel 1 {ch1}");