1. 热成像项目为什么值得折腾热成像这东西早几年还是工业检测和安防领域的专属玩具模块动辄大几千普通人根本摸不着。这两年情况完全变了国产传感器把价格打下来之后几百块就能搞到一个能输出温度矩阵的模组精度还过得去。我手上这个项目就是在这个背景下启动的——用一块叫 Forgix 的开发板搭配 Lepton 系列热成像模组做一套能实时看温度分布、能记录、能报警的小系统。先说清楚这个项目到底在干什么。Forgix 是一块面向嵌入式视觉场景设计的小板子接口比较全跑 Linux 也顺拿来接热成像模组正合适。Lepton 是那种体积很小的热成像传感器输出的是每像素对应一个温度值的原始数据不是普通摄像头那种 RGB 画面。你要做的是把这些温度数据读出来、转成可视化的热图、再叠加一些分析逻辑比如找最高温点、划定区域报警、记录温度曲线。整套东西做下来能用在设备过热预警、电路板故障排查、甚至家里地暖管道检漏这些场景。适合谁看如果你玩过树莓派、搞过摄像头采集、写过一点 Python 或者 C那这个项目对你来说就是顺水推舟。如果你完全没碰过嵌入式也没关系我会把关键步骤拆得足够细包括接线、驱动、数据解析、可视化每一步都告诉你为什么这么做、坑在哪里。我踩过的坑不少有些是硬件层面的有些是软件层面的还有一些是“看起来没问题但实际就是不对”的玄学问题后面都会讲到。核心关键词就几个热成像、Lepton、Forgix、温度矩阵、可视化、报警逻辑。整篇文章围绕这几个词展开不跑偏。2. 方案选型与整体设计思路2.1 为什么选 Lepton 而不是其他热成像方案市面上能买到的热成像方案大致分三类。第一类是成品热像仪比如那些手持式的插上就能用但你想二次开发基本没门数据拿不出来。第二类是工业相机性能好、接口标准但价格摆在那里个人项目没必要。第三类就是 Lepton 这种模组体积小、功耗低、有官方 SDK、社区资料多关键是价格能接受。Lepton 有几个版本分辨率主要是 80x60 和 160x120 两种。80x60 听起来很寒酸但热成像本来就不需要高分辨率你关心的是温度分布趋势不是看清人脸。160x120 当然更好但价格翻倍而且数据量大了之后对处理能力要求也高。我选的是 80x60 的版本实测下来做区域温度监测完全够用。还有一个关键点Lepton 输出的是原始温度数据不是图像。它通过 I2C 或者 SPI 输出每个像素是一个 16 位数值需要你自己转换成摄氏度。这个转换过程涉及一些校准参数官方文档里有说明但写得比较晦涩我后面会详细讲怎么算。2.2 Forgix 板子的角色和接口分配Forgix 在这个项目里干三件事第一跟 Lepton 通信把原始数据读进来第二跑数据处理和可视化逻辑第三对外输出结果比如通过屏幕显示、通过网络发送、或者触发报警。接口分配上Lepton 的通信接口我选了 SPI因为速度比 I2C 快80x60 的帧率能跑到 8-9 帧每秒I2C 的话会慢不少。Forgix 上有现成的 SPI 接口接线也简单四根线搞定时钟、数据输入、数据输出、片选。另外 Lepton 还需要一个使能引脚和复位引脚这两个用普通 GPIO 控制就行。电源方面要注意Lepton 对电源噪声比较敏感最好用独立的 LDO 供电不要直接从板子的 3.3V 排针上取电否则图像上会出现规律性的条纹噪声。我一开始就是图省事直接取的后来查了半天才发现是电源问题。2.3 软件架构的分层设计软件这块我分了三层。最底层是驱动层负责跟 Lepton 通信读取原始帧数据。中间是处理层把原始数据转成温度矩阵做校准、滤波、温度计算。最上层是应用层负责可视化、报警逻辑、数据记录。这么分的好处是每一层可以独立调试。比如你怀疑是驱动层读数据有问题可以单独把原始数据打印出来看怀疑是温度计算不对可以拿已知温度的物体去验证。如果所有逻辑揉在一起出了问题根本不知道从哪里查。可视化我用了两种方式一种是直接在 Forgix 连接的屏幕上显示热图用伪彩色映射高温红色低温蓝色另一种是通过网络把温度矩阵发送到另一台设备上用更强大的工具做分析和展示。两种方式各有用途后面会分别讲。3. 硬件连接与驱动层实操3.1 接线细节与电源处理接线这块看起来简单但有几个细节不注意就会出问题。SPI 的四根线SCLK、MOSI、MISO、CS对应接好就行。但 Lepton 的 SPI 模式比较特殊它用的是 SPI 从模式也就是说 Forgix 要作为主机去主动读数据。这一点跟普通 SPI 设备一样没什么特别的。使能引脚和复位引脚要注意电平。Lepton 的使能是高电平有效复位是低电平有效。我一开始把复位引脚悬空了结果模组时不时自己重启后来加了一个上拉电阻才稳定。电源方面前面说了要用独立 LDO我选了一个输出噪声比较低的型号输入 5V 输出 3.3V最大电流 500mA 足够。还有一点Lepton 的镜头前面有一个快门用来做非均匀性校正。这个快门在启动的时候会动一下发出轻微的“咔哒”声这是正常的。如果你发现快门一直不动可能是驱动没初始化好或者供电不足。3.2 驱动初始化与通信协议解析Lepton 的通信协议是基于 SPI 的但并不是你发一个命令它就回一个数据那么简单。它有一套自己的寄存器读写机制你需要先发送命令字再读取返回的数据。具体来说每个 SPI 事务包含几个阶段首先是命令阶段发送 16 位的命令字然后是数据阶段根据命令类型读取或写入数据。初始化流程大致是这样的先拉高使能引脚等待模组启动然后通过 SPI 读取模组 ID确认通信正常接着配置一些基本参数比如输出格式、帧率、温度单位最后启动快门校正等待校正完成。这个过程我写了一个初始化函数每一步都有超时检测防止卡死。通信协议里有一个坑Lepton 的 SPI 时钟极性跟普通设备不一样需要配置成特定的模式。我一开始用默认模式读出来的数据全是乱的后来查了数据手册才发现要改 CPOL 和 CPHA 的设置。这个细节在官方文档里写得很隐蔽不注意根本找不到。3.3 原始数据读取与帧同步读取原始数据的时候帧同步是个关键问题。Lepton 输出的每一帧数据前面有几个字节的包头你需要根据包头来判断一帧从哪里开始、到哪里结束。如果帧同步没做好读出来的数据就会错位温度矩阵会变成一堆乱码。我的做法是先读取足够多的字节然后在缓冲区里搜索包头。找到包头之后再根据帧长度截取完整的一帧。帧长度是固定的80x60 的模组每帧是 4800 字节加上包头和校验总共 4804 字节左右。每次读取的时候我一次性读 5000 字节然后在里面找包头这样能保证不会漏帧。还有一个细节Lepton 的帧率是可以配置的但实际帧率会受到 SPI 时钟速度的影响。如果时钟太慢帧率就上不去如果时钟太快数据可能出错。我实测下来SPI 时钟设在 8MHz 左右比较稳再高就会出现偶发的数据错误。4. 温度矩阵解析与校准计算4.1 原始值到摄氏度的转换公式Lepton 输出的原始数据是 16 位无符号整数每个像素一个值。这个值并不是直接的摄氏度而是跟温度成线性关系的原始值。转换公式大致是这样的摄氏度 原始值 * 0.01 - 273.15。但这个公式只适用于模组出厂时的默认校准实际使用中会有偏差。更准确的做法是使用模组内部存储的校准参数。Lepton 在出厂时会把每个像素的增益和偏移量写入内部存储区你需要把这些参数读出来然后对每个像素做单独的校正。这个过程叫非均匀性校正简称 NUC。不做 NUC 的话图像上会出现明显的条纹和噪点温度读数也不准。NUC 参数读取比较麻烦需要通过特定的命令序列访问内部存储区。我写了一个函数专门做这件事把参数读出来之后存到内存里每次转换温度的时候用上。实测下来做了 NUC 之后温度读数能稳定在正负 2 摄氏度以内对于大多数应用来说够用了。4.2 快门校正与温度漂移处理即使做了 NUC模组在使用过程中还是会因为环境温度变化而产生漂移。这时候就需要快门校正。快门校正的原理是把镜头前面的快门关掉让所有像素看到同一个温度快门本身的温度然后根据这个基准重新计算偏移量。快门校正的触发方式有两种一种是手动触发比如你发现图像质量下降了就发一个命令让模组做一次校正另一种是自动触发模组会根据内部温度传感器的读数自动判断是否需要校正。我一般设置成每 5 分钟自动校正一次同时在检测到温度突变的时候手动触发一次。这里有个坑快门校正的时候模组会短暂停止输出数据大概持续 200 毫秒左右。如果你的程序没有处理这个中断可能会读到不完整的数据帧。我的做法是在校正期间暂停读取等校正完成后再继续。4.3 温度矩阵的滤波与降噪原始温度矩阵里会有一些噪点表现为个别像素的温度值明显偏离周围。这些噪点可能来自传感器本身的噪声也可能来自电源干扰或者电磁干扰。如果不处理可视化出来的热图会有很多麻点影响观感。我用了两种滤波方式。第一种是中值滤波对每个像素取周围 3x3 区域的中值能有效去除孤立的噪点。第二种是高斯滤波对图像做平滑处理让温度过渡更自然。两种滤波可以叠加使用先中值再高斯效果比较好。但滤波也有副作用它会模糊温度边界让高温区域和低温区域的过渡变得不那么锐利。如果你需要精确测量某个小区域的温度滤波可能会引入误差。我的做法是可视化的时候用滤波后的数据但温度报警逻辑用原始数据这样既能保证画面好看又能保证报警准确。5. 可视化实现与报警逻辑5.1 伪彩色映射与热图渲染热图渲染的核心是伪彩色映射。简单说就是把温度值映射到一组颜色上低温用蓝色中温用绿色黄色高温用红色。映射函数有很多种我选了一种叫“铁红”的配色方案因为它在高温区域的对比度比较好容易看出温度差异。具体实现上我先把温度矩阵归一化到 0-255 的范围然后查表得到 RGB 值。这个查表操作可以用查表法加速提前把 256 个颜色值算好存到数组里渲染的时候直接查就行。80x60 的分辨率一帧渲染下来在 Forgix 上大概几毫秒完全跟得上帧率。如果你想把热图叠加到普通摄像头的画面上那就需要做图像对齐。这个比较复杂因为两个摄像头的视场角不一样需要标定。我暂时没做这个因为项目需求里不需要。5.2 区域温度监测与阈值报警报警逻辑我设计得比较灵活。你可以划定任意矩形区域设置一个温度阈值当区域内的最高温度超过阈值时触发报警。报警方式可以是屏幕上的颜色变化、蜂鸣器响、或者通过网络发送通知。区域划定的实现方式是在温度矩阵上定义一个矩形范围然后遍历这个范围内的所有像素找最大值。这个操作计算量不大80x60 的矩阵即使划多个区域也很快。阈值可以设置成固定值也可以设置成动态值比如跟环境温度的差值。这里有个经验阈值不要设得太接近正常温度否则会因为噪声导致误报。我一般建议阈值比正常温度高至少 10 摄氏度这样既能及时报警又不会频繁误触发。5.3 数据记录与温度曲线绘制数据记录我用了两种方式。一种是原始数据记录把每一帧的温度矩阵存成二进制文件方便后续分析。另一种是统计记录每隔一段时间记录一次区域最高温、最低温、平均温存成 CSV 文件方便用表格软件画曲线。温度曲线绘制是在另一台设备上做的用 Python 的 matplotlib 库。Forgix 负责采集和发送数据另一台设备负责接收和绘图。这样分工的好处是Forgix 不用承担绘图的计算压力可以专注于采集和报警。网络传输我用了简单的 TCP 协议Forgix 作为客户端另一台设备作为服务端。数据格式是自定义的二进制协议包含帧头、时间戳、温度矩阵。传输频率我设在 1Hz也就是每秒发送一次这样网络压力不大曲线也够平滑。6. 常见问题与排查技巧实录6.1 图像出现条纹或噪点怎么办这是最常见的问题原因可能有几个。首先是电源噪声前面说过Lepton 对电源比较敏感如果直接从板子取电很容易出现条纹。解决办法是换独立 LDO或者在电源引脚旁边加滤波电容。其次是 NUC 参数没加载或者加载了但没生效。你可以通过读取模组状态寄存器来确认 NUC 是否启用。如果没有启用重新执行一次 NUC 加载流程。还有一个可能是快门校正没做或者做了但没等它完成就开始读数据。确保校正完成后再继续读取。6.2 温度读数偏差大怎么校准温度读数偏差大首先要确认 NUC 是否正常。如果 NUC 正常那可能是环境温度补偿没做好。Lepton 内部有一个温度传感器用来测量模组自身的温度这个温度会影响读数。你需要根据这个温度对读数做补偿。补偿公式官方文档里有大致是根据模组温度和出厂校准时的温度差值乘以一个系数加到原始读数上。这个系数也在内部存储区里需要读出来。如果补偿之后还是有偏差那可能是镜头污染或者快门老化。用无水酒精清洁镜头或者更换快门组件。6.3 SPI 通信失败排查步骤SPI 通信失败的表现是读不到数据或者读到的数据全是 0 或者全是 1。排查步骤是这样的先用示波器或者逻辑分析仪看 SPI 波形确认时钟、数据、片选信号是否正常。如果波形正常但数据不对检查 CPOL 和 CPHA 设置。如果波形不正常检查接线和电源。还有一个容易忽略的点Lepton 的 SPI 片选信号是低电平有效但有些板子的 SPI 控制器默认输出高电平需要配置成低电平有效。这个在设备树或者驱动配置里改。6.4 帧率不稳定或丢帧的处理帧率不稳定通常是 SPI 时钟太快或者 CPU 负载太高。先降低 SPI 时钟试试如果还不行检查一下 Forgix 上有没有其他进程在抢 CPU。可以把采集线程的优先级调高或者用 DMA 来传输数据减少 CPU 占用。丢帧的话检查缓冲区大小是否足够。如果缓冲区太小上一帧还没处理完下一帧就来了就会丢帧。加大缓冲区或者优化处理逻辑让每帧的处理时间缩短。7. 项目扩展与个人经验分享这个项目做完之后我又陆续加了一些功能。比如把温度数据和普通摄像头画面做融合这样既能看温度又能看实际场景。还加了历史数据回放功能可以查看过去某段时间的温度变化。这些扩展都不难核心框架搭好之后加功能就是往上堆的事。我个人在实际操作中的体会是热成像项目的难点不在软件而在硬件和校准。软件逻辑再复杂调试起来总有办法但硬件问题比如电源噪声、信号完整性、热漂移往往需要反复试验才能解决。所以如果你打算做类似的项目建议在硬件上多花点时间把电源和接线做扎实后面会省很多事。最后再分享一个小技巧Lepton 模组对温度突变比较敏感如果你从空调房拿到室外最好等几分钟让它适应环境温度再开始采集否则读数会飘得厉害。这个在官方文档里没写是我自己踩坑踩出来的。 
长河君 · 2026/10/16 1:25:15 · 阅读 1.2k 基于Forgix与Lepton的热成像温度矩阵采集与可视化实战
1. 热成像项目为什么值得折腾热成像这东西早几年还是工业检测和安防领域的专属玩具模块动辄大几千普通人根本摸不着。这两年情况完全变了国产传感器把价格打下来之后几百块就能搞到一个能输出温度矩阵的模组精度还过得去。我手上这个项目就是在这个背景下启动的——用一块叫 Forgix 的开发板搭配 Lepton 系列热成像模组做一套能实时看温度分布、能记录、能报警的小系统。先说清楚这个项目到底在干什么。Forgix 是一块面向嵌入式视觉场景设计的小板子接口比较全跑 Linux 也顺拿来接热成像模组正合适。Lepton 是那种体积很小的热成像传感器输出的是每像素对应一个温度值的原始数据不是普通摄像头那种 RGB 画面。你要做的是把这些温度数据读出来、转成可视化的热图、再叠加一些分析逻辑比如找最高温点、划定区域报警、记录温度曲线。整套东西做下来能用在设备过热预警、电路板故障排查、甚至家里地暖管道检漏这些场景。适合谁看如果你玩过树莓派、搞过摄像头采集、写过一点 Python 或者 C那这个项目对你来说就是顺水推舟。如果你完全没碰过嵌入式也没关系我会把关键步骤拆得足够细包括接线、驱动、数据解析、可视化每一步都告诉你为什么这么做、坑在哪里。我踩过的坑不少有些是硬件层面的有些是软件层面的还有一些是“看起来没问题但实际就是不对”的玄学问题后面都会讲到。核心关键词就几个热成像、Lepton、Forgix、温度矩阵、可视化、报警逻辑。整篇文章围绕这几个词展开不跑偏。2. 方案选型与整体设计思路2.1 为什么选 Lepton 而不是其他热成像方案市面上能买到的热成像方案大致分三类。第一类是成品热像仪比如那些手持式的插上就能用但你想二次开发基本没门数据拿不出来。第二类是工业相机性能好、接口标准但价格摆在那里个人项目没必要。第三类就是 Lepton 这种模组体积小、功耗低、有官方 SDK、社区资料多关键是价格能接受。Lepton 有几个版本分辨率主要是 80x60 和 160x120 两种。80x60 听起来很寒酸但热成像本来就不需要高分辨率你关心的是温度分布趋势不是看清人脸。160x120 当然更好但价格翻倍而且数据量大了之后对处理能力要求也高。我选的是 80x60 的版本实测下来做区域温度监测完全够用。还有一个关键点Lepton 输出的是原始温度数据不是图像。它通过 I2C 或者 SPI 输出每个像素是一个 16 位数值需要你自己转换成摄氏度。这个转换过程涉及一些校准参数官方文档里有说明但写得比较晦涩我后面会详细讲怎么算。2.2 Forgix 板子的角色和接口分配Forgix 在这个项目里干三件事第一跟 Lepton 通信把原始数据读进来第二跑数据处理和可视化逻辑第三对外输出结果比如通过屏幕显示、通过网络发送、或者触发报警。接口分配上Lepton 的通信接口我选了 SPI因为速度比 I2C 快80x60 的帧率能跑到 8-9 帧每秒I2C 的话会慢不少。Forgix 上有现成的 SPI 接口接线也简单四根线搞定时钟、数据输入、数据输出、片选。另外 Lepton 还需要一个使能引脚和复位引脚这两个用普通 GPIO 控制就行。电源方面要注意Lepton 对电源噪声比较敏感最好用独立的 LDO 供电不要直接从板子的 3.3V 排针上取电否则图像上会出现规律性的条纹噪声。我一开始就是图省事直接取的后来查了半天才发现是电源问题。2.3 软件架构的分层设计软件这块我分了三层。最底层是驱动层负责跟 Lepton 通信读取原始帧数据。中间是处理层把原始数据转成温度矩阵做校准、滤波、温度计算。最上层是应用层负责可视化、报警逻辑、数据记录。这么分的好处是每一层可以独立调试。比如你怀疑是驱动层读数据有问题可以单独把原始数据打印出来看怀疑是温度计算不对可以拿已知温度的物体去验证。如果所有逻辑揉在一起出了问题根本不知道从哪里查。可视化我用了两种方式一种是直接在 Forgix 连接的屏幕上显示热图用伪彩色映射高温红色低温蓝色另一种是通过网络把温度矩阵发送到另一台设备上用更强大的工具做分析和展示。两种方式各有用途后面会分别讲。3. 硬件连接与驱动层实操3.1 接线细节与电源处理接线这块看起来简单但有几个细节不注意就会出问题。SPI 的四根线SCLK、MOSI、MISO、CS对应接好就行。但 Lepton 的 SPI 模式比较特殊它用的是 SPI 从模式也就是说 Forgix 要作为主机去主动读数据。这一点跟普通 SPI 设备一样没什么特别的。使能引脚和复位引脚要注意电平。Lepton 的使能是高电平有效复位是低电平有效。我一开始把复位引脚悬空了结果模组时不时自己重启后来加了一个上拉电阻才稳定。电源方面前面说了要用独立 LDO我选了一个输出噪声比较低的型号输入 5V 输出 3.3V最大电流 500mA 足够。还有一点Lepton 的镜头前面有一个快门用来做非均匀性校正。这个快门在启动的时候会动一下发出轻微的“咔哒”声这是正常的。如果你发现快门一直不动可能是驱动没初始化好或者供电不足。3.2 驱动初始化与通信协议解析Lepton 的通信协议是基于 SPI 的但并不是你发一个命令它就回一个数据那么简单。它有一套自己的寄存器读写机制你需要先发送命令字再读取返回的数据。具体来说每个 SPI 事务包含几个阶段首先是命令阶段发送 16 位的命令字然后是数据阶段根据命令类型读取或写入数据。初始化流程大致是这样的先拉高使能引脚等待模组启动然后通过 SPI 读取模组 ID确认通信正常接着配置一些基本参数比如输出格式、帧率、温度单位最后启动快门校正等待校正完成。这个过程我写了一个初始化函数每一步都有超时检测防止卡死。通信协议里有一个坑Lepton 的 SPI 时钟极性跟普通设备不一样需要配置成特定的模式。我一开始用默认模式读出来的数据全是乱的后来查了数据手册才发现要改 CPOL 和 CPHA 的设置。这个细节在官方文档里写得很隐蔽不注意根本找不到。3.3 原始数据读取与帧同步读取原始数据的时候帧同步是个关键问题。Lepton 输出的每一帧数据前面有几个字节的包头你需要根据包头来判断一帧从哪里开始、到哪里结束。如果帧同步没做好读出来的数据就会错位温度矩阵会变成一堆乱码。我的做法是先读取足够多的字节然后在缓冲区里搜索包头。找到包头之后再根据帧长度截取完整的一帧。帧长度是固定的80x60 的模组每帧是 4800 字节加上包头和校验总共 4804 字节左右。每次读取的时候我一次性读 5000 字节然后在里面找包头这样能保证不会漏帧。还有一个细节Lepton 的帧率是可以配置的但实际帧率会受到 SPI 时钟速度的影响。如果时钟太慢帧率就上不去如果时钟太快数据可能出错。我实测下来SPI 时钟设在 8MHz 左右比较稳再高就会出现偶发的数据错误。4. 温度矩阵解析与校准计算4.1 原始值到摄氏度的转换公式Lepton 输出的原始数据是 16 位无符号整数每个像素一个值。这个值并不是直接的摄氏度而是跟温度成线性关系的原始值。转换公式大致是这样的摄氏度 原始值 * 0.01 - 273.15。但这个公式只适用于模组出厂时的默认校准实际使用中会有偏差。更准确的做法是使用模组内部存储的校准参数。Lepton 在出厂时会把每个像素的增益和偏移量写入内部存储区你需要把这些参数读出来然后对每个像素做单独的校正。这个过程叫非均匀性校正简称 NUC。不做 NUC 的话图像上会出现明显的条纹和噪点温度读数也不准。NUC 参数读取比较麻烦需要通过特定的命令序列访问内部存储区。我写了一个函数专门做这件事把参数读出来之后存到内存里每次转换温度的时候用上。实测下来做了 NUC 之后温度读数能稳定在正负 2 摄氏度以内对于大多数应用来说够用了。4.2 快门校正与温度漂移处理即使做了 NUC模组在使用过程中还是会因为环境温度变化而产生漂移。这时候就需要快门校正。快门校正的原理是把镜头前面的快门关掉让所有像素看到同一个温度快门本身的温度然后根据这个基准重新计算偏移量。快门校正的触发方式有两种一种是手动触发比如你发现图像质量下降了就发一个命令让模组做一次校正另一种是自动触发模组会根据内部温度传感器的读数自动判断是否需要校正。我一般设置成每 5 分钟自动校正一次同时在检测到温度突变的时候手动触发一次。这里有个坑快门校正的时候模组会短暂停止输出数据大概持续 200 毫秒左右。如果你的程序没有处理这个中断可能会读到不完整的数据帧。我的做法是在校正期间暂停读取等校正完成后再继续。4.3 温度矩阵的滤波与降噪原始温度矩阵里会有一些噪点表现为个别像素的温度值明显偏离周围。这些噪点可能来自传感器本身的噪声也可能来自电源干扰或者电磁干扰。如果不处理可视化出来的热图会有很多麻点影响观感。我用了两种滤波方式。第一种是中值滤波对每个像素取周围 3x3 区域的中值能有效去除孤立的噪点。第二种是高斯滤波对图像做平滑处理让温度过渡更自然。两种滤波可以叠加使用先中值再高斯效果比较好。但滤波也有副作用它会模糊温度边界让高温区域和低温区域的过渡变得不那么锐利。如果你需要精确测量某个小区域的温度滤波可能会引入误差。我的做法是可视化的时候用滤波后的数据但温度报警逻辑用原始数据这样既能保证画面好看又能保证报警准确。5. 可视化实现与报警逻辑5.1 伪彩色映射与热图渲染热图渲染的核心是伪彩色映射。简单说就是把温度值映射到一组颜色上低温用蓝色中温用绿色黄色高温用红色。映射函数有很多种我选了一种叫“铁红”的配色方案因为它在高温区域的对比度比较好容易看出温度差异。具体实现上我先把温度矩阵归一化到 0-255 的范围然后查表得到 RGB 值。这个查表操作可以用查表法加速提前把 256 个颜色值算好存到数组里渲染的时候直接查就行。80x60 的分辨率一帧渲染下来在 Forgix 上大概几毫秒完全跟得上帧率。如果你想把热图叠加到普通摄像头的画面上那就需要做图像对齐。这个比较复杂因为两个摄像头的视场角不一样需要标定。我暂时没做这个因为项目需求里不需要。5.2 区域温度监测与阈值报警报警逻辑我设计得比较灵活。你可以划定任意矩形区域设置一个温度阈值当区域内的最高温度超过阈值时触发报警。报警方式可以是屏幕上的颜色变化、蜂鸣器响、或者通过网络发送通知。区域划定的实现方式是在温度矩阵上定义一个矩形范围然后遍历这个范围内的所有像素找最大值。这个操作计算量不大80x60 的矩阵即使划多个区域也很快。阈值可以设置成固定值也可以设置成动态值比如跟环境温度的差值。这里有个经验阈值不要设得太接近正常温度否则会因为噪声导致误报。我一般建议阈值比正常温度高至少 10 摄氏度这样既能及时报警又不会频繁误触发。5.3 数据记录与温度曲线绘制数据记录我用了两种方式。一种是原始数据记录把每一帧的温度矩阵存成二进制文件方便后续分析。另一种是统计记录每隔一段时间记录一次区域最高温、最低温、平均温存成 CSV 文件方便用表格软件画曲线。温度曲线绘制是在另一台设备上做的用 Python 的 matplotlib 库。Forgix 负责采集和发送数据另一台设备负责接收和绘图。这样分工的好处是Forgix 不用承担绘图的计算压力可以专注于采集和报警。网络传输我用了简单的 TCP 协议Forgix 作为客户端另一台设备作为服务端。数据格式是自定义的二进制协议包含帧头、时间戳、温度矩阵。传输频率我设在 1Hz也就是每秒发送一次这样网络压力不大曲线也够平滑。6. 常见问题与排查技巧实录6.1 图像出现条纹或噪点怎么办这是最常见的问题原因可能有几个。首先是电源噪声前面说过Lepton 对电源比较敏感如果直接从板子取电很容易出现条纹。解决办法是换独立 LDO或者在电源引脚旁边加滤波电容。其次是 NUC 参数没加载或者加载了但没生效。你可以通过读取模组状态寄存器来确认 NUC 是否启用。如果没有启用重新执行一次 NUC 加载流程。还有一个可能是快门校正没做或者做了但没等它完成就开始读数据。确保校正完成后再继续读取。6.2 温度读数偏差大怎么校准温度读数偏差大首先要确认 NUC 是否正常。如果 NUC 正常那可能是环境温度补偿没做好。Lepton 内部有一个温度传感器用来测量模组自身的温度这个温度会影响读数。你需要根据这个温度对读数做补偿。补偿公式官方文档里有大致是根据模组温度和出厂校准时的温度差值乘以一个系数加到原始读数上。这个系数也在内部存储区里需要读出来。如果补偿之后还是有偏差那可能是镜头污染或者快门老化。用无水酒精清洁镜头或者更换快门组件。6.3 SPI 通信失败排查步骤SPI 通信失败的表现是读不到数据或者读到的数据全是 0 或者全是 1。排查步骤是这样的先用示波器或者逻辑分析仪看 SPI 波形确认时钟、数据、片选信号是否正常。如果波形正常但数据不对检查 CPOL 和 CPHA 设置。如果波形不正常检查接线和电源。还有一个容易忽略的点Lepton 的 SPI 片选信号是低电平有效但有些板子的 SPI 控制器默认输出高电平需要配置成低电平有效。这个在设备树或者驱动配置里改。6.4 帧率不稳定或丢帧的处理帧率不稳定通常是 SPI 时钟太快或者 CPU 负载太高。先降低 SPI 时钟试试如果还不行检查一下 Forgix 上有没有其他进程在抢 CPU。可以把采集线程的优先级调高或者用 DMA 来传输数据减少 CPU 占用。丢帧的话检查缓冲区大小是否足够。如果缓冲区太小上一帧还没处理完下一帧就来了就会丢帧。加大缓冲区或者优化处理逻辑让每帧的处理时间缩短。7. 项目扩展与个人经验分享这个项目做完之后我又陆续加了一些功能。比如把温度数据和普通摄像头画面做融合这样既能看温度又能看实际场景。还加了历史数据回放功能可以查看过去某段时间的温度变化。这些扩展都不难核心框架搭好之后加功能就是往上堆的事。我个人在实际操作中的体会是热成像项目的难点不在软件而在硬件和校准。软件逻辑再复杂调试起来总有办法但硬件问题比如电源噪声、信号完整性、热漂移往往需要反复试验才能解决。所以如果你打算做类似的项目建议在硬件上多花点时间把电源和接线做扎实后面会省很多事。最后再分享一个小技巧Lepton 模组对温度突变比较敏感如果你从空调房拿到室外最好等几分钟让它适应环境温度再开始采集否则读数会飘得厉害。这个在官方文档里没写是我自己踩坑踩出来的。