当前版本:v3.0.0
OpenThermal 是一款高性能红外热成像测温系统。支持无线传输与 Type-C 有线传输,提供全场景跨平台客户端生态:支持全平台局域网网页在线实时查看(免安装)、Windows 桌面客户端以及可安装的 Android 手机 APK,满足电脑、手机、平板在不同环境下的红外测温与热像观察需求。
本发布包已内置各个平台的客户端与配套烧录工具,可直接点击下方链接打开或安装:
| 应用平台 / 工具 | 文件路径与直接链接 | 说明 |
|---|---|---|
| 💻 Windows 桌面端 | windows/OpenThermal.exe |
独立桌面程序,即开即用(包含完整 windows/ 运行库) |
| 📱 Android 手机端 | android/OpenThermal.apk |
安卓通用安装包(各芯片架构分包见 android/ 目录) |
| 🛠️ 固件烧录工具 | 烧录工具.exe |
单文件量产/烧录工具,用于刷机、备份与恢复 |
| 🌐 全平台在线控制台 | http://openthermal.local 或 http://192.168.4.1 |
免安装任何客户端,同一局域网任意浏览器直连 |
- 连接传输方式:
- 无线传输 (Wi-Fi):支持设备自带 AP 热点无线直连,也支持接入室内 Wi-Fi 路由器实现局域网无线流转。
- 有线传输 (Type-C USB):支持通过 Type-C 数据线有线直连电脑,或通过 Type-C OTG 线有线直连安卓手机,即插即用、延迟极低。
- 全平台终端覆盖:
- 局域网网页在线查看(全平台免安装):电脑、手机、平板(Windows / macOS / Linux / iOS / Android)无需安装任何应用,打开现代浏览器即可在线查看实时热像画面。
- Windows 桌面客户端:提供独立的桌面应用程序,支持 USB 有线高速直连与 Wi-Fi 无线局域网接入。
- Android 手机客户端 (APK):支持在安卓手机上安装独立 APK,支持手机 USB-OTG 有线即插即用与 Wi-Fi 无线连接。
- 高画质热像平滑成像:
- 采用多种平滑插值滤波算法(推荐使用
B-Spline样条滤波,同时提供Lanczos3、Gaussian等 12 种滤波核),将传感器点阵平滑重采样为高分辨率图像,画质过渡自然平滑。
- 采用多种平滑插值滤波算法(推荐使用
- 多模式伪彩调色板:
- 内置 14 套工业与医疗调色板(包含
Ironbow铁红、Rainbow彩虹、Classic经典、White-Hot白热、Black-Hot黑热、Medical医疗等),支持颜色反转,适应不同的观察背景。
- 内置 14 套工业与医疗调色板(包含
- 全自动温度跟踪与标线:
- 画面实时自动寻找并追踪最高温(红色十字)、最低温(蓝色十字)以及中心定点(绿色十字),并在界面实时显示全画幅平均温度。
- 自定义定点测温与温度趋势曲线:
- 支持在画面任意位置点击或拖动放置定点测温探针,精确测量指定点温度;
- 具备连续温度曲线记录功能,可实时绘制温度变化趋势图,并支持清空重置与导出下载温度历史数据(CSV 格式)。
- 自适应全动态量程 (Auto Range):
- 算法根据当前画面内的实时最高温度与最低温度,自动动态拉伸并映射全色阶,确保微小温差也能清晰呈现丰富的层次细节。
- 表面发射率(Emissivity)校正:
- 支持发射率 0.01 ~ 1.00 自由调节,针对金属、人体皮肤、粗糙或光滑表面进行准确的测温补偿。
- 多温标单位切换:
- 支持摄氏度 (℃)、华氏度 (℉)、开尔文 (K)、兰氏度 (°Ra) 四种国际温标单位一键切换。
- 画面旋转与镜像:
- 支持水平镜像、垂直镜像以及 90°、180°、270° 旋转,满足各种角度的固定安装或反向手持使用需求。
- 图像去噪与传感器校准:
- 卡尔曼滤波:平滑噪点,有效抑制温度数值跳动;
- Gamma 曲线校正:动态调整图像灰阶分布,突出低温区或高温区的层次细节;
- 传感器一致性校准:用于消除画面不均匀底噪。校准方法:使用表面温度一致的物体(如平整硬纸板、桌面或墙面)平整遮挡住镜头前方,然后在【系统设置】中点击“传感器一致性校准”按钮,即可一键完成画面校准;
- 测温斜率与偏置微调:支持对测温斜率(Slope)与温度偏置(Intercept)进行微调,方便专业用户进行精准测温补偿。
- 热像画面触控与手势快捷操作:
- 【App 移动端 & Web 网页端】:
- 垂直滑动(上下滑动):快速循环切换伪彩调色板(向下滑动切换下一个调色板,向上滑动切换上一个),屏幕上方即时弹出 HUD 动态胶囊提示;
- 水平滑动(左右滑动):快速循环切换重采样平滑滤波器(向右滑动切换下一个,向左滑动切换上一个),可在
B-Spline、Lanczos3、Gaussian等 12 种算法间秒级对比画质效果; - 单指点击 / 触碰任意位置:直接将定点测温十字靶心精确定位到手指触碰位置,底栏实时读取并显示该坐标的精确测温数据;
- 【手持带屏机型实体屏幕】:
- 上下滑动:快速切换调色板;
- 左右滑动:切换侧边数据信息栏停靠位置(在屏幕左侧或右侧互换停靠,方便左手或右手单手握持操作);
- 单指点击:在热像区域任意位置点击移动定点测温探针;
- 长按屏幕:长按屏幕任意区域直接进入【系统设置】页面;
- 短按电源键:画面冻结定格 / 继续实时流转(暂停与恢复)。
- 【App 移动端 & Web 网页端】:
- 屏幕背光调节(带屏机型):
- 支持屏幕背光亮度无级调节(1% ~ 100%),灵活适应室内与户外强弱光环境。
- 多语言与现代化主题:
- 提供简体中文、English 等多语言界面切换;
- 支持深色(Dark)与浅色(Light)主题自适应切换。
- 高清图片保存与 MP4 视频录制:
- 一键截屏保存:画面底栏支持一键点击“截屏”,高保真捕获包含测温标线与温度数值的热成像画面,自动保存为 PNG 图片至系统相册或下载目录;
- 实时视频录制:支持一键点击“录制 MP4”启动热像动态视频录制,实时记录被测目标的温度动态变化过程,录制结束自动保存为标准 MP4 视频文件,便于实验分析、故障诊断报告与工程存档。
- 免硬件离线演示模式 (Demo Mode):
- App 端与 PC 上位机均内置物理热场数学模型。即使手头暂无热像仪硬件,点击“演示模式”即可直接体验高帧率热成像画面流转、手势切换调色板与算法滤波等全部功能。
系统支持三种主要的使用方式:
适用于电脑、平板、iPhone、iPad、Android 手机等任何带有现代浏览器的设备(全平台免安装应用)。
- 无线开机连接:
- 模块通电后,会自动启动一个 Wi-Fi 热点,热点名称通常为
INFRARED-xxxxxx(无密码,直接连接即可);
- 模块通电后,会自动启动一个 Wi-Fi 热点,热点名称通常为
- 浏览器直接访问:
- 连接成功后,打开设备上的浏览器,访问:
http://192.168.4.1- 或访问 mDNS 域名:
http://openthermal.local
- 设备内置 DNS 捕获服务,直接打开任意网页也会自动跳转至控制台。页面加载后即可在线实时显示热成像画面,并可在界面上直接切换调色板、调整滤波器及发射率参数。
- 连接成功后,打开设备上的浏览器,访问:
- 配置连接路由器(可选局域网在线查看):
- 如果希望热像仪接入室内局域网,在网页控制台中打开【系统设置】->【网络与连接 / 无线局域网】;
- 在列表中选择周围可用的 Wi-Fi 并输入密码,点击保存;
- 配网成功后,同一局域网内的任何电脑、手机直接访问设备被分配的 IP 或
http://openthermal.local即可在线查看。
- 扩展管理功能:
- 网页端左上角展开抽屉导航,支持文件管理(浏览与导出板载 LittleFS 存储数据)、温度数据统计以及为带屏机型制作并下发个性化开机画面(BootScreen)。
提供流畅稳定的桌面端热像显示与参数调试功能。
- 启动程序:双击运行
windows/OpenThermal.exe(位于windows/目录下); - USB 有线直连(推荐):
- 用 Type-C 数据线将热像仪有线连接到电脑;
- 在软件连接界面中选择对应的 COM 端口,波特率保持默认(921600),点击“连接”;
- Wi-Fi 无线网络连接:
- 确保电脑已连接热像仪自带的 Wi-Fi 热点,或两者处于同一局域网中;
- 选择网络连接模式,输入热像仪 IP(直连热点时默认为
192.168.4.1),点击“连接”。
便携随身测温方案,手机即插即用。
- 安装 APK:
- 将安装包
android/OpenThermal.apk安装到安卓手机上(分架构包可在android/目录下获取);
- 将安装包
- Type-C OTG 有线直连(推荐):
- 使用双头 Type-C OTG 数据线将热像仪连接至手机充电口;
- 手机弹出 USB 设备访问权限请求窗口,勾选允许并确认,打开 App 即可直接显示实时热像画面;
- 提示:若手机未能识别外接热像仪,请在手机系统设置中确认已开启【OTG】功能;
- Wi-Fi 无线模式:
- 手机连入热像仪自带的 Wi-Fi 热点,打开 App 即可直接通过无线网络在线查看热像画面;
- 免硬件离线演示模式:
- 若手头暂未连接热像仪硬件,打开 App 后在主界面直接点击“演示模式”,即可启动内置的动态热场数学模型,体验高帧率热成像画面流转、手势切换调色板与算法滤波等全部功能。
| 参数项 | 推荐设置 | 说明与使用场景 |
|---|---|---|
| 调色板 (Palette) | Ironbow(铁红) / Rainbow(彩虹) |
综合观察最直观;查找微小温差推荐 Rainbow,夜间观察暗处推荐 White-Hot(白热)。 |
| 滤波器 (Filter) | B-Spline(B样条插值) |
平滑度和边缘过渡平衡较好;需要突出热点细节时可选用 Lanczos3。 |
| 发射率 (Emissivity) | 常见材料见下 | 测量不同物体表面时请按材质调整: • 人体皮肤 / 水面 / 冰面: 0.98• 哑光油漆 / 橡胶 / 塑料: 0.90 ~ 0.95• 氧化粗糙金属: 0.50 ~ 0.70• 抛光高亮金属(铜/铝): 0.10 ~ 0.20 |
| 卡尔曼滤波强度 | 默认开启 (50) | 画面噪点较多或环境温差微弱时可适当调大,抑制闪烁噪点。 |
| Gamma 对比度 | 1.0(正常) |
测量高温物体周围细节时可调小至 0.7;观察低温微弱温差时可调大至 1.4。 |
- 严禁强辐射源直射:
- 绝对禁止将镜头直接对准太阳、焊接电弧、大功率激光等极端辐射源,否则会导致红外热电堆传感器受到永久性不可逆损伤!
- 镜头清洁保护:
- 红外光学透镜表面有精密光学镀膜,请避免手指直接触摸镜头或被尖锐物体划伤。如需清洁,请使用专用的气吹或镜头擦拭纸轻轻拭去浮尘。
- 测温距离与视场说明:
- 测温距离与被测发热物体的面积相关,目标发热面积在画面中占有的像素越多,测温准确度越高。
本章节面向喜爱折腾的极客玩家,介绍配套单文件量产工具 烧录工具.exe 的使用方法、设备密钥备份位置、自行刷写 DIY 固件后的重新烧录恢复,以及硬件开发资料的获取。
用于自行刷入 DIY 固件、恢复官方出厂固件或设备维护:
- 设备连接:
- 使用 Type-C 数据线将热像仪连接至电脑;
- 若电脑未能自动识别端口,请检查电脑是否已安装 USB 串口驱动,或打开电脑【设备管理器】查看端口(COM 和 LPT)连接与识别状态;
- 启动烧录:
- 双击运行发布包根目录下的
烧录工具.exe;
- 双击运行发布包根目录下的
- 一键烧录:
- 在界面中选择需要刷写的固件文件;
- 点击界面下方的“一键烧录”按钮,工具将自动完成全套固件与文件系统的写入;
- 全盘擦除(可选):
- 界面提供了红色的“擦除芯片”按钮,用于彻底擦除彻底清空芯片全盘。
每台设备出厂时均包含专属的芯片识别认证与校准数据(存储于芯片内部 NVS 分区,一机一份)。在自行刷写 DIY 固件前,强烈建议先完成备份:
- 如何备份密钥:
- 设备连接电脑后,在
烧录工具.exe界面中直接点击“备份密钥”按钮; - 软件会自动从芯片中读取专属密钥和校准数据并完成备份;
- 设备连接电脑后,在
- 备份后的密钥在哪个文件夹:
- 备份生成的密钥文件名为
nvs_backup.bin; - 该文件会保存在与
烧录工具.exe相同的目录下(即工具所在的当前文件夹)。请妥善保管此文件。
- 备份生成的密钥文件名为
当您自行刷写了第三方或自制 DIY 固件后,如果需要重新烧回官方固件或恢复出厂系统:
- 放回备份密钥:
- 确保之前备份好的
nvs_backup.bin文件放置在与烧录工具.exe相同的目录下;
- 确保之前备份好的
- 自动识别与回填:
- 运行
烧录工具.exe,将设备连接至电脑; - 烧录工具在启动和检测到芯片时,会自动扫描同目录下的
nvs_backup.bin,并在秒级内自动校验并回填原厂授权与校准参数,无需手动输入;
- 运行
- 重新烧录:
- 选择对应的产品型号,直接点击“一键烧录”,即可一键完美恢复至官方出厂系统。
如需深入了解硬件外设引脚定义、电路设计或进行硬件二次开发,硬件原理图等相关开发资料可以联系客服免费领取。
早期的固件镜像、文档已统一归档至 archive/v2.x.x/ 目录供参考。
如需购买官方正品硬件、外壳镜头配件或定制模块,请扫描下方二维码或点击链接直达官方淘宝店铺:
本项目正在积极开发中,源代码将于固件版本稳定后正式开源(计划于 2027 年年内开源发布,或达到 300 颗 Star 立刻开源 😏)。
