热像仪温度数据导出，是指将热像仪采集到的温度信息转换为可存储、可传输格式的过程，具备原始温度流（16位全帧数据）、视频流（H.264）、特征温度（最多16个测温对象）三种数据形态，主要用于工业设备监测、科研数据分析、智能制造产线集成等场景。
根据数据形态和使用场景的不同，温度数据导出分为SDK二次开发、配套软件导出、Modbus协议通信三种主流方式。本文对三种方式的操作流程、技术要点和适用边界进行系统梳理。
一、先明确：您要导出的是哪种温度数据
三种导出方式的差异，根源在于数据形态的差异。
热像仪输出的温度相关数据分为三类：
温度流数据（原始数据）：全帧画面的16位原始温度数据，逐像素可解析，用于深度数据分析与算法开发。
视频流数据：带测温信息的热像图像与视频，用于存档、回溯与报告制作。
特征温度数据：按用户配置的全局、局部测温对象（最多支持16个）输出的最高温、最低温、平均温及坐标，用于监控报警与系统联动。
数据形态决定导出路径，选型前请先完成数据形态定义。
二、SDK二次开发：原始数据的深度导出通道
SDK方式适用于需要集成自有系统或进行深度数据分析的场景，是获取原始温度流的唯一通道。
2.1 数据获取
调用SDK的实时预览接口（如Yoseen_StartPreview），在回调函数中接收DataFrame结构体。该结构体包含全帧画面的16位原始温度数据。
2.2 温度数据提取
调用Yoseen_GetTemperature或Yoseen_GetTemperatures等接口，传入DataFrame中的温度数据指针和区域坐标，即可获取指定点或区域的精确温度值（最高温、最低温、平均温）。
2.3 温度校正
原始温度值为short型，不可直接作为温度使用，须结合每帧数据头（DataFrameHeader）中提供的Slope和Offset系数进行换算：
真实温度（℃）= short值 ÷ Slope + Offset
2.4 数据导出
获取温度值（原始值或换算后的真实温度）后，可在程序中自行实现保存逻辑，导出为CSV、TXT等格式。
三、配套软件导出：零编程的快速导出方式
IRTool Pro、IRStudio等官方软件适用于直接、快速的数据查看和基础导出，无需编程基础。
3.1 基本操作流程
连接热像仪并启动实时预览（温度流或视频流）。
通过截图、录制或数据点分析工具捕获当前画面或时间段的数据。
将捕获数据保存为包含温度信息的JPG图片（可后期分析），或直接导出CSV格式的温度数据文件（包含测温点或区域的温度值）。
3.2 视频流数据的导出要点
温度流截图：由电脑端温度数据生成，效果最佳。
视频流截图：由设备端H.264解码生成，细节有损失。
录制功能：可保存带测温信息的热像视频。
RTSP流输出：直接访问设备的标准RTSP流地址，VLC等通用播放器即可播放和录制，适用于仅需画面、不关注温度数据的场景。
PAL模拟输出：部分设备支持，可直接连接显示设备或采集卡录制。
四、Modbus协议：特征温度的自动化导出通道
Modbus方式不依赖PC图形软件，适用于工业现场的嵌入式集成与自动化控制。
4.1 前置条件
设备固件须带”-mb”后缀以支持Modbus功能。支持Modbus-TCP（端口502）或Modbus-RTU两种连接方式。
4.2 通过第三方工具读取
以ModbusPoll为例：
建立与热像仪的连接（TCP或RTU）。
Function选择04 Read Input Registers(3x)，Address填写1，Quantity填写测温对象个数 × 8。
即可周期性或手动读取特征温度数据（最高温、最低温、平均温及其坐标），并在工具内查看或导出。
4.3 通过SDK函数提取
调用SDK中的mtGetResult或mtCheck等函数，从温度流数据帧中直接提取已配置测温对象的特征温度结果，并保存为TXT、CSV等格式。
4.4 通过寄存器地址直连
按寄存器地址映射表编程读取（例如：全局最高温地址30001，局部测温1的地址范围30009-30016等）。读数单位为0.1℃，须进行换算。
五、关键技术参数对比
| 参数项 | 指标值 | 说明 |
| 原始温度数据位深 | 16位 | DataFrame结构体，全帧画面逐像素温度 |
| 温度换算公式 | 真实温度（℃)=short值÷Slope+Offset | Slope、Offset取自每帧DataFrameHeader |
| 测温对象数量上限 | 16个 | 全局测温+局部测温对象 |
| 实时预览接口 | Yoseen_StartPreview | 回调接收DataFrame结构体 |
| 温度提取接口 | Yoseen_GetTemperature / Yoseen_GetTemperatures | 按数据指针+区域坐标取值 |
| 视频编码格式 | H.264 | 视频流截图由设备端解码生成 |
| Modbus-TCP端口 | 502 | 或走Modbus-RTU串口 |
| 读取功能码 | 04 Read Input Registers(3x) | Address=1，Quantity=测温对象个数×8 |
| 全局最高温寄存器 | 30001 | 局部测温1地址范围30009-30016 |
| 寄存器读数单位 | 0.1℃ | 读数须除以10换算 |
| 特征温度提取函数 | mtGetResult / mtCheck | 从温度流数据帧提取结果 |
六、三种方式适用场景
按场景匹配方式，是避免项目返工的核心原则。
实验室测试、现场初步诊断、数据验证：选用软件导出方式（IRTool Pro+第三方工具），操作直观，无需编程。
嵌入式系统集成、自动化生产线、定制化软件开发：选用SDK编程方式，灵活性高，可定制集成与自动化导出。
工业自动化系统、PLC控制、长期无人值守监测：选用Modbus协议方式，不依赖特定PC软件，适合工业现场嵌入式集成。
仅需视频画面、快速查看：使用RTSP流，兼容性最强。
温度分析、需保留完整温度信息：使用IRTool Pro软件。
七、常见问题（FAQ）
Q1：导出的温度值为什么是几千的异常数字？
温度换算环节出错。SDK输出的原始温度值是short型，必须结合每帧数据头中的Slope和Offset系数，按”真实温度（℃)=short值÷Slope+Offset”换算为真实温度，不能直接当温度使用。
Q2：为什么我的设备连不上Modbus工具？
检查固件版本。只有带”-mb”后缀的固件才支持Modbus功能；另外确认连接参数正确——Modbus-TCP走502端口，Function选择04 Read Input Registers(3x)，Address填1，Quantity填测温对象个数乘以8。
Q3：软件导出的CSV能用于算法开发吗？
不建议。软件导出的CSV是结果数据（测温点或区域的温度值），并非逐像素原始温度数据。有二次开发或算法分析需求时，应通过SDK获取DataFrame结构体中的16位原始温度数据。
