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
<PackageReference Include="nanoFramework.Iot.Device.Amg88xx" Version="1.2.613" />
paket add nanoFramework.Iot.Device.Amg88xx --version 1.2.613
#r "nuget: nanoFramework.Iot.Device.Amg88xx, 1.2.613"
// 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 帧的速率输出热图像。此外,中断引脚可以在任何一个单个像素超过或低于配置阈值时触发电器。
文档
设备系列
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,传感器将读取n和n+1的读数,并以它们的平均值作为输出。
- 如果帧率设置为1fps,传感器将读取10帧的数据(因为传感器始终内部以10fps运行)并构建平均值。10个读数的平均值是输出结果。
使用移动平均模式时,每个像素的噪声将降低到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()
中断级别和滞后
注意
- 请注意,如果没有任何像素温度超过下限或上限,则状态寄存器中的中断标志会自动重置。**无需**手动重置标志。
- 如果对应的像素不再超过下限或上限,则中断标志表中的任何标志会自动重置。
- 如果应用了滞后,并且一个像素的读数不再通过阈值,同时该读数仍在滞回范围内,则可以通过使用
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
产品 | 版本 兼容的和附加的计算机目标框架版本。 |
---|---|
.NET Framework | net是兼容的。 |
-
- nanoFramework.CoreLibrary (>= 1.15.5)
- nanoFramework.Graphics.Core (>= 1.2.15)
- nanoFramework.Runtime.Events (>= 1.11.18)
- nanoFramework.System.Buffers.Binary.BinaryPrimitives (>= 1.2.586)
- nanoFramework.System.Device.Gpio (>= 1.1.41)
- nanoFramework.System.Device.I2c (>= 1.1.16)
- nanoFramework.System.Math (>= 1.5.43)
- UnitsNet.nanoFramework.Temperature (>= 5.56.0)
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 |