nanoFramework.Iot.Device.Amg88xx 1.2.613

前缀已保留
dotnet add package nanoFramework.Iot.Device.Amg88xx --version 1.2.613                
NuGet\Install-Package nanoFramework.Iot.Device.Amg88xx -Version 1.2.613                
此命令旨在在 Visual Studio 的包管理器控制台中使用,因为它使用 NuGet 模块的 Install-Package 版本。
<PackageReference Include="nanoFramework.Iot.Device.Amg88xx" Version="1.2.613" />                
对于支持 PackageReference 的项目,将此 XML 节点复制到项目文件中以引用包。
paket add nanoFramework.Iot.Device.Amg88xx --version 1.2.613                
#r "nuget: nanoFramework.Iot.Device.Amg88xx, 1.2.613"                
#r 指令可以在 F# Interactive 和 Polyglot Notebooks 中使用。将其复制到交互式工具或脚本的源代码中以引用包。
// Install nanoFramework.Iot.Device.Amg88xx as a Cake Addin
#addin nuget:?package=nanoFramework.Iot.Device.Amg88xx&version=1.2.613

// Install nanoFramework.Iot.Device.Amg88xx as a Cake Tool
#tool nuget:?package=nanoFramework.Iot.Device.Amg88xx&version=1.2.613                

AMG8833/AMG8834/AMG8853/AMG8854 红外阵列传感器系列

AMG88xx 红外阵列传感器系列的传感器具有 64 个热敏像素,排列在 8x8 矩阵中。传感器作为一个热红外摄像头工作。它可以从 5-7 米的距离检测到物体(例如人体)。一个像素可以测量 0 到 80°C / -20 到 100°C 范围内的物体温度,分辨率为 0.25°C,精度为 ±2.5°C / ±4.5°C。传感器具有 60° 的视场角和每个像素 7.5° 的视场角。

制造商(松下)列出的以下应用:家用电器(微波炉和空调)、建筑自动化(人数统计、空调控制)、家庭自动化(人体检测)、工厂自动化(预防故障)。传感器通过其数字接口(I2C)以每秒 1 或 10 帧的速率输出热图像。此外,中断引脚可以在任何一个单个像素超过或低于配置阈值时触发电器。

Illustration of thermophile pixel array and heat map

文档

设备系列

AMG88系列包括4个成员

类型 分辨率 增益 Vcc 目标温度范围 分辨率 精度
AMG8833 8x8 3V3 0-80°C 0.25°C ±2.5°C
AMG8834 8x8 3V3 -20-100°C 0.25°C ±4.5°C
AMG8853 8x8 5V0 0-80°C 0.25°C ±2.5°C
AMG8854 8x8 5V0 -20-100°C 0.25°C ±4.5°C

该传感器配备了一个片上热敏电阻,可以读取。热敏电阻的测量范围为-20...80°C,分辨率为0.0625°C。

绑定说明

Amg88xx绑定提供了一个瘦接口来检索像素阵列和控制传感器。所有传感器功能都涵盖在内。任何进一步的处理,例如图案识别,都不在绑定范围内。

热图像/像素阵列

像素阵列的温度读数可以以64个像素排列在8x8矩阵中的热图像形式读取。像素阵列可以随时以任何速度读取。不过,传感器会根据配置的帧率更新相应的寄存器。

传感器有一个集成的热敏电阻,可以读出以获取芯片温度。

注意: 芯片温度不等于环境温度。

可以通过以下方式从传感器读取当前图像到绑定

public void ReadImage()

可以使用索引器读取指定坐标的像素的温度

public Temperature this[int x, int y]

可以读取整个温度图像作为二维数组

public Temperature[,] TemperatureImage

可以使用索引器读取指定编号的像素的原始读数(12位二进制补码格式)

public Int16 this[int n]

注意: 参考规范中未提及像素寄存器更新和读取操作之间的同步。因此,您可以在一个读取操作中读取连续两帧中的像素数据。然而,对于正常应用,这不应相关。

属性

public Temperature SensorTemperature

注意: 热敏电阻温度不等于

操作模式/电源控制

传感器支持四种操作模式以控制功耗

  • 正常
  • 睡眠模式
  • 待机(每60秒间歇60秒)
  • 待机(每10秒间歇10秒)

属性

public OperatingMode OperatingMode

注意: 详细说明模式转换和传感器行为,请参考参考规范。

重置

传感器支持两种类型的重置。

  • 重置: 将所有标志和寄存器重置为默认值
  • 重置所有标志: 重置所有标志(状态寄存器、中断标志、中断表)
public void Reset()
public void ResetAllFlags()

注意: 重置中断相关标志仅当您想在读取处于正回差范围时清除标志时才需要。有关中断行为的详细信息,请参阅中断部分。

传感器状态

传感器状态指示是否有任何像素或芯片内部热敏电阻超出了上下操作范围限制。它还会在发生中断时指示。状态可以按标志读取和重置

public bool HasTemperatureOverflow();
public void ClearTemperatureOverflow();

public bool HasThermistorOverflow();
public void ClearThermistorOverflow();

public bool HasInterrupt();
public void ClearInterrupt();

public void ClearAllFlags();

注意: 重置中断标志仅在您想在读取处于正回差范围(但已处于上下范围)时清除标志时才需要。此方法不会清除单个像素的中断标志。有关中断行为的详细信息,请参阅中断部分。

注意: 热敏电阻溢出标志仅在参考规范的早期版本中提到。不清楚这是规范错误还是传感器较新版修订的变化。

帧率

默认值: 10fps

传感器支持帧率为1fps和10fps。帧率定义了像素的更新间隔。这与I2C接口的读取间隔无关。

属性

public FrameRate FrameRate

移动平均

默认:关闭

传感器支持移动平均模式。在此模式下,它为每个像素构建两个移动平均。

  • 如果帧率设置为10fps,传感器将读取nn+1的读数,并以它们的平均值作为输出。
  • 如果帧率设置为1fps,传感器将读取10帧的数据(因为传感器始终内部以10fps运行)并构建平均值。10个读数的平均值是输出结果。

Moving average principle

使用移动平均模式时,每个像素的噪声将降低到1/sqrt2。

属性

public bool UseMovingAverageMode

重要:参考规范表明,当前模式可以读取,但似乎暂时不起作用。在这种情况下,该属性始终被读取为false

中断控制、级别和像素标志

如果任何像素超过给定的值,传感器可以引发中断。事件由状态寄存器的中断标志表示。此外,传感器的INT引脚可以降至低电平。

属性

public InterruptMode PixelTemperatureInterruptMode
public bool InterruptPinEnabled

可以配置中断级别。可以设置和读取下限、上限和滞后级别。最初寄存器被填充为零。这些级别适用于所有像素。

属性

public Temperature InterruptLowerLevel
public Temperature InterruptUpperLevel
public Temperature InterruptHysteresis

传感器引发中断后,可以从中断表寄存器读取触发像素。

public bool[,] GetInterruptFlagTable()

Interrupt levels and hysteresis

中断级别和滞后

注意

  • 请注意,如果没有任何像素温度超过下限或上限,则状态寄存器中的中断标志会自动重置。**无需**手动重置标志。
  • 如果对应的像素不再超过下限或上限,则中断标志表中的任何标志会自动重置。
  • 如果应用了滞后,并且一个像素的读数不再通过阈值,同时该读数仍在滞回范围内,则可以通过使用ResetAllFlags方法清除中断标志。

示例

概述

示例应用程序演示了传感器的关键功能和绑定

  • 热图像读取
  • 基于温度级别和滞后触发中断
  • 传感器状态
  • 使用传感器的移动平均功能进行噪声降低

从各种供应商处都可以获得AMG88xx突破式板。只要它提供了对传感器I2C接口的访问,就可以使用其中任何一个。

注意:还有提供附加接口甚至带有集成Arduino或兼容电路的板。仅当板子仅提供对I2C接口的访问时,才能使用此绑定。

布线

出于演示目的,将传感器的INT引脚连接到MCU的有效GPIO引脚。另外,将一个LED连接到MCU的另一个有效GPIO引脚。LED表示中断的发生。电阻取决于LED类型;然而,对于标准红色LED,150R-220R是一个安全的选择。或者更准确地说:R = (3,3V - U LED,forward) / I LED,forward

Wiring of a sensor breakout and LED for the sample

产品 兼容的和附加的计算机目标框架版本。
.NET Framework net是兼容的。
兼容的目标框架(s)
包含的目标框架(s)(在包中)
了解有关目标框架.NET Standard的更多信息。

NuGet 包

此包未由任何 NuGet 包使用。

GitHub 仓库

此包未由任何知名 GitHub 仓库使用。

版本 下载 最后更新
1.2.613 56 8/9/2024
1.2.601 48 7/26/2024
1.2.590 60 7/17/2024
1.2.580 80 6/28/2024
1.2.573 89 6/19/2024
1.2.570 89 6/14/2024
1.2.560 81 5/29/2024
1.2.548 88 5/15/2024
1.2.536 101 4/15/2024
1.2.514 87 3/22/2024
1.2.494 89 2/28/2024
1.2.474 115 1/24/2024
1.2.462 129 1/5/2024
1.2.458 107 12/20/2023
1.2.436 163 11/10/2023
1.2.416 103 11/8/2023
1.2.403 126 10/6/2023
1.2.396 102 9/27/2023
1.2.384 141 9/6/2023
1.2.378 138 8/16/2023
1.2.369 136 8/2/2023
1.2.363 148 7/28/2023
1.2.357 153 7/19/2023
1.2.354 123 7/14/2023
1.2.345 150 6/21/2023
1.2.341 162 6/14/2023
1.2.337 185 6/7/2023
1.2.335 154 6/2/2023
1.2.329 148 5/26/2023
1.2.316 167 5/16/2023
1.2.313 165 5/12/2023
1.2.308 168 5/11/2023
1.2.304 170 5/10/2023
1.2.302 184 5/10/2023
1.2.297 154 5/3/2023
1.2.273 230 3/17/2023
1.2.267 239 3/10/2023
1.2.263 267 3/8/2023
1.2.259 231 2/27/2023
1.2.256 296 2/24/2023
1.2.253 275 2/22/2023
1.2.222 311 1/9/2023
1.2.212 292 1/5/2023
1.2.208 329 1/3/2023
1.2.203 291 12/28/2022
1.2.159 400 11/14/2022
1.2.153 359 11/5/2022
1.2.141 384 10/25/2022
1.2.128 407 10/22/2022
1.2.122 484 10/12/2022
1.2.114 386 10/8/2022
1.2.95 435 9/22/2022
1.2.87 482 9/15/2022
1.2.73 421 9/8/2022
1.2.63 433 9/3/2022
1.2.47 448 8/15/2022
1.2.40 445 8/6/2022
1.2.38 481 8/5/2022
1.2.28 466 8/1/2022
1.2.13 460 7/24/2022
1.2.10 462 7/23/2022
1.1.145.58726 502 7/7/2022
1.1.133.52556 453 6/30/2022
1.1.121.35854 490 6/26/2022
1.1.116.8772 466 6/24/2022
1.1.113.2032 466 6/23/2022
1.1.102.51394 444 6/15/2022
1.1.99.36719 466 6/14/2022
1.1.97.17326 449 6/13/2022
1.1.92.53000 470 6/8/2022
1.1.72.29765 470 5/31/2022
1.1.64.21380 485 5/26/2022
1.1.58.10097 490 5/23/2022
1.1.54.28879 504 5/23/2022
1.1.40 477 5/5/2022
1.1.3 493 4/15/2022
1.1.1 480 4/14/2022
1.0.300 478 3/31/2022
1.0.288-preview.114 119 3/25/2022
1.0.288-preview.113 121 3/25/2022
1.0.288-preview.104 106 3/22/2022
1.0.288-preview.103 108 3/21/2022
1.0.288-preview.100 118 3/19/2022
1.0.288-preview.99 120 3/18/2022
1.0.288-preview.98 110 3/18/2022
1.0.288-preview.93 110 3/15/2022
1.0.288-preview.87 118 3/10/2022
1.0.288-preview.86 109 3/8/2022
1.0.288-preview.77 111 2/27/2022
1.0.288-preview.75 108 2/26/2022
1.0.288-preview.65 107 2/18/2022
1.0.288-preview.63 114 2/16/2022
1.0.288-preview.61 113 2/12/2022
1.0.288-preview.58 115 2/10/2022
1.0.288-preview.53 109 2/9/2022
1.0.288-preview.48 129 2/4/2022
1.0.288-preview.41 127 1/31/2022
1.0.288-preview.29 122 1/28/2022
1.0.288-preview.20 131 1/27/2022
1.0.288-preview.19 128 1/27/2022
1.0.288-preview.18 129 1/27/2022
1.0.288-preview.5 131 1/24/2022
1.0.288-preview.1 121 1/21/2022
1.0.272 159 1/10/2022
1.0.259 343 12/9/2021
1.0.258 359 12/7/2021
1.0.218 185 10/18/2021
1.0.157 347 9/4/2021
1.0.155 335 8/31/2021
1.0.153 157 8/14/2021
1.0.151 165 8/6/2021
1.0.146 156 7/22/2021
1.0.136 220 7/17/2021
1.0.135 153 7/16/2021
1.0.134 168 7/15/2021
1.0.133 179 7/14/2021
1.0.130 152 7/6/2021
1.0.127 162 7/5/2021
1.0.125 191 7/5/2021
1.0.122 201 6/30/2021
1.0.121 193 6/29/2021
1.0.119 213 6/28/2021
1.0.111 173 6/14/2021
1.0.105 267 5/29/2021
1.0.104 240 5/29/2021
1.0.97 167 5/28/2021
1.0.80 148 5/26/2021