1. 项目概述热成像技术在电子硬件调试、工业巡检、安防监控及科研实验中具有不可替代的价值。传统红外测温枪仅能获取单点温度而热成像相机则可提供完整的二维温度分布图使工程师能够直观识别PCB上微小的发热点、判断散热设计合理性、验证电源模块热应力分布甚至发现隐藏的虚焊、短路或器件老化问题。然而现有开源热成像方案长期存在“高分辨率”与“高流畅度”的二元对立基于MLX90640等MEMS热电堆阵列的方案虽成本低、易集成但16×12或32×24的原始分辨率导致图像颗粒感严重细节模糊而采用海康威视TB4117等专业热成像模组的方案虽具备160×120的有效像素和25Hz帧率却常因嵌入式平台算力不足、GUI框架优化欠佳或USB视频流处理瓶颈导致用户界面卡顿、动画撕裂、交互响应迟滞。LiThermal项目正是针对这一工程矛盾提出的系统性解决方案。它并非简单堆砌高性能硬件而是围绕“热成像数据流—图像处理—人机交互”全链路进行深度协同设计选用全志T113-S3双核Cortex-A7 SoC作为主控兼顾计算性能与功耗控制采用LVGL 8作为GUI引擎通过硬件加速器G2D与帧缓冲Framebuffer的精准调度实现UI动画90Hz刷新率将TB4117模组工作于NCM网络模式而非UVC模式规避Linux UVC驱动对高带宽视频流的兼容性风险并利用其内置H.264编码能力降低USB总线负载。最终成果是一个软硬件全栈开源、功能完备、交互流畅且具备工程复现价值的便携式热成像终端。1.1 系统定位与核心指标LiThermal定位于面向嵌入式开发者与硬件工程师的可学习、可修改、可量产的参考设计。其核心性能指标如下表所示类别参数说明热成像性能分辨率160×120TB4117模组原生输出非插值放大刷新率25Hz模组固件设定满足动态热场观测需求测温范围0℃ ~ 106.4℃标准校准范围-20℃以下需自行补偿光标显示逻辑限制为0℃起始显示系统屏幕2.4英寸TFT LCD分辨率320×240匹配热图缩放与UI布局刷新率94.3Hz屏幕原生支持为LVGL动画提供高帧率基础主控平台SoC全志T113-S3双核ARM Cortex-A7 1.0GHz集成G2D 2D图形加速器内存128MB DDR3满足Linux内核、LVGL渲染缓存及视频解码需求存储MicroSD卡启动支持32GB及以下容量兼容主流品牌TF卡软件栈OS定制Tina LinuxOpenWRT衍生轻量级专为T113-S3优化内核版本4.9.xGUILVGL 8.3启用硬件加速、抗锯齿、多层渲染UI线程与视频解码线程分离视频协议NCMNetwork Control ModelUSB CDC ECM类将TB4117视为网络设备IP通信稳定可靠该设计摒弃了“为炫技而堆料”的思路所有选型均服务于一个明确目标在有限的BOM成本与PCB面积约束下构建一条低延迟、高确定性的热数据可视化通路。从传感器原始数据采集到屏幕像素点亮端到端延迟被严格控制在视觉可接受范围内确保用户操作如调色板切换、温度统计触发与画面反馈之间无明显割裂感。2. 硬件架构设计LiThermal的硬件系统采用模块化分层设计分为主控子系统、热成像接口子系统、电源管理子系统、人机交互子系统及显示子系统。各模块间通过标准高速接口互联物理布局遵循信号完整性与热管理原则。2.1 主控与存储单元主控单元以全志T113-S3为核心其外围电路设计严格遵循官方《T113-S3 Hardware Design Guidelines》。关键设计要点包括DDR3内存布线采用Fly-by拓扑时钟线CK/CK#与地址/命令线ADDR/CMD长度严格匹配差分对内间距≤0.1mm线宽/线距按50Ω单端阻抗设计。所有DDR走线避开电源平面分割区域底层铺完整地平面。eMMC启动T113-S3通过SDIO 4-bit接口连接eMMC芯片原理图中标注为EMMC但项目实际采用MicroSD卡启动方案。此处eMMC引脚被复用为GPIO或悬空SD卡槽直接接入T113-S3的SDIO0控制器支持HS200模式保障固件加载速度。USB Host接口TB4117模组通过USB 2.0 High-Speed接口接入T113-S3的USB PHY。PCB上预留TVS二极管D1,D2用于ESD防护串联电阻R1,R2用于阻抗匹配与信号整形确保480Mbps数据传输的信号眼图质量。2.2 热成像模组接口设计TB4117是海康威视推出的紧凑型热成像模组内置160×120非制冷氧化钒VOx焦平面探测器、专用ISP处理器及H.264编码器。LiThermal未采用常见的UVCUSB Video Class模式而是选择NCMNetwork Control Model模式其硬件接口设计具有显著工程优势NCM模式原理TB4117在NCM模式下USB设备描述符被识别为CDC ECMEthernet Control Model类设备。T113-S3的Linux内核加载cdc_ether驱动后模组表现为一个虚拟以太网接口如usb0。热图像数据被封装为标准以太网帧通过HTTP API或私有TCP协议获取规避了UVC驱动对YUV格式、帧同步、带宽协商等复杂机制的依赖。硬件适配为启用NCM模式TB4117需外接一颗RTL8153B或AX88179 USB-to-Ethernet桥接芯片项目BOM中为U11: AX88179。该芯片将TB4117的内部以太网MAC接口转换为USB 2.0接口。PCB设计中AX88179的USB D/D-线长严格匹配靠近T113-S3 USB PHY放置并添加π型滤波电路C1,C2,R3抑制高频噪声。供电隔离TB4117与AX88179由独立LDOU10: SY8009供电避免USB Host端口电流波动影响模组稳定性。实测表明使用开关电源或劣质USB Hub供电时TB4117易出现花屏或断连而采用线性稳压或优质充电宝则运行稳定。2.3 电源管理子系统电源系统是LiThermal可靠性的基石尤其考虑到T113-S3对核心电压VDD-CPU, VDD-SYS精度的严苛要求。本项目采用EA3036三路同步降压DC-DC控制器U1: EA3036其设计体现了典型的嵌入式电源工程思维多路输出设计EA3036提供三路独立可调输出VDD-CPU: 0.9V 2A —— T113-S3 CPU核心电压纹波要求20mVppVDD-SYS: 1.5V 2A —— SoC系统IO与内存接口电压VDD-IO: 3.3V 2A —— 外设USB PHY、LVDS屏接口、SD卡供电FB反馈网络每路输出通过外部电阻分压器R_FB1/R_FB2,R_FB3/R_FB4,R_FB5/R_FB6设定电压。原文提及“FB引脚上的100nF电容改为220pF”此为相位补偿调整——增大FB节点电容可提升环路稳定性抑制高频振荡是DC-DC设计中常见的环路补偿手段。上电时序控制EA3036支持EN引脚使能及PGOODPower Good信号输出。原理图中PGOOD信号连接至STC8单片机U2的GPIO用于电源健康状态监测。焊接流程强调“先测三路电压正常再焊T113”正是基于此设计若EA3036 FB网络虚焊导致输出电压漂移可能直接击穿T113-S3的ESD保护二极管。2.4 显示与人机交互接口LCD接口采用8080并行总线DB0~DB15,RS,WR,RD,CS,RESET驱动2.4英寸TFT屏。T113-S3的LCD控制器LCDC配置为RGB565格式直接映射至Framebuffer/dev/fb0。屏幕背光由NMOSQ1控制栅极串联100kΩ电阻R_BL用于限流与防静电符合原文“可用100K 0402代替”的工程冗余设计。按键与指示灯SW1为长按开机键连接至STC8单片机的外部中断引脚实现硬件级电源管理。LED1电源指示与LED2WiFi/状态指示由STC8 GPIO驱动便于调试阶段快速判断系统状态。调试接口板载CH340 USB转串口芯片U3TXD/RXD引出至测试点用于T113-S3的Linux内核日志输出与Shell交互。STC8单片机亦通过同一CH340提供独立串口R-TX,T-RX用于烧录其固件及读取电源管理状态。3. 软件系统架构LiThermal的软件栈采用分层架构自底向上分为Linux内核层、中间件层、应用层与GUI层。其设计核心在于解耦热数据获取与UI渲染确保高帧率交互不被视频解码阻塞。3.1 Linux内核与驱动配置内核定制基于Allwinner Tina Linux SDK构建内核版本为4.9.118。关键驱动配置包括CONFIG_USB_CDCETHERy启用CDC ECM驱动识别TB4117为usb0网络接口。CONFIG_DRM_SUN8I_DW_HDMIy禁用HDMI节省资源CONFIG_DRM_SUN8I_TCON_TOPy启用TCONTiming Controller驱动精确控制LCD时序。CONFIG_FB_SUN8IyFramebuffer驱动/dev/fb0为LVGL提供显存。USB网络配置系统启动后执行ifconfig usb0 192.168.64.1 netmask 255.255.255.0 up将主机端IP设为192.168.64.1。TB4117默认IP为192.168.64.64构成点对点以太网链路。此设计绕过复杂的USB枚举与UVC协议栈大幅降低内核态CPU占用率。3.2 热数据获取与处理热图像数据通过HTTP RESTful API从TB4117获取这是整个软件链路的关键创新点API调用流程应用程序向http://192.168.64.64/ISAPI/Streaming/channels/101/picture发送GET请求获取JPEG格式热图快照。或向http://192.168.64.64/ISAPI/ContentMgmt/StreamingProxy/channels/101/picture获取实时流式JPEGMJPEG over HTTP。数据解析获取的JPEG数据由libjpeg-turbo库解码为RGB565格式直接写入Framebuffer内存。温度元数据最大值、最小值、中心值通过另一APIhttp://192.168.64.64/ISAPI/Thermal/channels/1/pictureData获取JSON响应解析后更新UI控件。性能优化为避免频繁HTTP请求开销应用程序采用双缓冲机制一个线程持续拉取JPEG流并解码至后台缓冲区另一个线程在LVGL渲染周期中将后台缓冲区内容原子性地交换至前台Framebuffer。实测25Hz热图流下CPU占用率稳定在35%左右远低于UVC方案的60%。3.3 LVGL GUI框架实现LVGL 8.3被深度定制以匹配T113-S3硬件特性硬件加速集成启用LV_USE_GPU_STM32_DMA2D此处为LVGL对全志G2D的抽象命名所有lv_img_create()创建的图像对象在lv_img_set_src()指定内存地址后由G2D硬件块复制引擎完成显存填充CPU无需参与像素搬运。多线程渲染LVGL主线程lv_timer_handler()负责UI事件处理与控件更新独立的video_thread负责JPEG解码与Framebuffer写入。二者通过lv_task_create()注册的定时任务协调确保UI刷新90Hz与视频帧率25Hz异步解耦。关键UI组件热图渲染器继承lv_img_t重写draw_cb回调将解码后的RGB565数据通过G2D Blit至指定Framebuffer区域。温度统计图使用lv_chart_tX轴为像素索引Y轴为温度值实时绘制160×120全图温度直方图。调色板管理器预置Ironbow、WhiteHot、BlackHot等LUTLook-Up Table运行时通过lv_img_set_zoom()动态应用无需重新解码JPEG。4. 关键电路与BOM分析4.1 核心器件选型依据器件型号选型理由工程备注主控SoCAllwinner T113-S3双核A71GHz集成G2D、LVDS、USB 2.0 PHYTina Linux生态成熟成本低于RK3308需注意DDR布线难度建议参考官方Layout Guide热成像模组Hikvision TB4117160×120 VOx探测器25Hz帧率内置H.264编码NCM模式稳定可靠NCM模式需AX88179桥接UVC模式需额外UVC驱动适配USB网卡AX88179成熟USB-to-Ethernet方案Linux内核原生支持asix驱动功耗低替代型号RTL8153B亦可需确认内核驱动兼容性DC-DC控制器EA3036三路同步降压支持宽输入4.5V-36V轻载效率高FB网络易调节FB电容220pF为稳定性补偿100nF亦可工作但需验证纹波LCD驱动ILI9341 (屏内置)2.4 320×240 TFT8080并口SPI兼容成本低供货稳定屏幕易压伤组装时严禁尖锐物触碰4.2 BOM关键参数表序号位号器件规格数量备注1U1EA30363-Channel Synchronous Buck DC-DC1FB网络电阻按原理图值焊接2U2STC8F1K088051 Core, 8KB Flash, 1KB RAM1电源管理MCU需烧录power.hex固件3U3CH340GUSB to UART Bridge1用于T113与STC8调试4U10SY8009ABC3A, 1.2MHz Sync Buck1为TB4117/AX88179供电5U11AX88179USB 2.0 to 10/100M Ethernet1TB4117 NCM模式必需6Q1DMN3025LSDN-Channel MOSFET, 30V/6.5A1屏幕背光控制7Y1ABM3B-32.768KHZ-D2Y-T32.768kHz Crystal1可不焊系统使用内部RC振荡器注原文指出“32.768kHz晶振和旁边的电阻电容可以不焊”因其仅用于RTC实时时钟模块而LiThermal当前固件未启用RTC功能故为可裁剪项体现设计的灵活性。5. 系统集成与调试指南5.1 焊接与上电流程焊接是LiThermal复现的最大挑战其难点在于0.4mm间距的T113-S3 QFP封装与细间距的AX88179。标准流程必须严格执行分阶段焊接先焊接所有阻容感、CH340、STC8、EA3036等中小器件。使用万用表二极管档逐脚测量EA3036的VIN与GND间是否短路排除PCB短路。烧录STC8固件power.hex上电后用万用表直流电压档测量VDD-CPU0.9V、VDD-SYS1.5V、VDD-IO3.3V三点确认无过压/欠压。仅当三路电压全部正常后方可焊接T113-S3。此步骤可避免EA3036 FB虚焊导致的0.9V输出异常如升至1.2V从而永久损坏T113-S3的CPU核心。T113-S3焊接要点使用热风枪温度设为350℃风速3级喷嘴对准芯片中心均匀加热。焊接后用10倍放大镜检查所有引脚是否存在连锡Bridge。重点检查VDD-CPU、VSS-CPU、CLKIN等关键网络。连锡修复用吸锡线烙铁或细铜丝蘸助焊剂拖焊。5.2 固件烧录与系统启动TF卡烧录使用PhoenixCard工具选择LiThermal.img文件烧录模式为“启动卡”。务必使用32GB及以下容量、Class 10以上TF卡。烧录完成后卡内应包含boot、rootfs两个分区。首次启动插入TF卡长按SW13秒开机。若屏幕显示Logo则Framebuffer与LVGL初始化成功若白屏但电脑识别MTP设备说明LCD排线或T113-LCD接口虚焊若无任何USB设备识别则检查TF卡槽焊接或eMMC引脚是否短路。MTP设备配置将UDISK.tar解压后的LiThermal、thermalcamera.sh、BSOD三个文件复制至MTP设备根目录。重启后系统自动加载这些文件完成应用层初始化。5.3 TB4117网络配置TB4117的IP与认证设置是系统联调成败的关键使用海康“设备网络搜索”工具Windows扫描局域网找到TB4117设备。修改其IP为192.168.64.64子网掩码255.255.255.0。管理员密码设为Ab123456若提示弱口令先设强密码再登录Web界面http://192.168.64.64在“用户管理”中修改。Web界面中进入“配置 网络 接口”确认工作模式为“NCM”进入“视频 编码”设置主码流为H.264分辨率160×120帧率25fps。完成上述配置后T113-S3端执行ping 192.168.64.64若通则热成像数据通道已建立。6. 开源生态与二次开发LiThermal的全部应用层源代码C/C、LVGL UI代码、Shell脚本及编译脚本均托管于GitHub采用GPLv3许可证。其开源价值不仅在于代码可见更在于提供了完整的、可离线复现的构建环境。6.1 本地编译环境搭建项目使用GitHub Actions自动化构建其.yml文件makeProject.yml即为权威构建说明书。在Ubuntu 22.04 LTS上手动构建步骤如下# 1. 安装依赖 sudo apt update sudo apt install -y build-essential git wget unzip python3-pip # 2. 克隆仓库 git clone https://github.com/diylxy/LiThermal_Compiler.git cd LiThermal_Compiler # 3. 执行构建脚本会自动下载Tina SDK、交叉编译工具链 ./build.sh # 4. 构建产物位于 output/images/ 下包含 LiThermal.img构建过程会下载约3GB的Tina SDK与工具链全程需稳定网络。构建成功后output/images/LiThermal.img即为可烧录固件。6.2 功能定制示例修改开机Logo替换LiThermal/app/src/logo.c中的logo_data数组该数组为128×128 RGB565格式的Logo图像数据。使用Python脚本可将PNG图片转换为此格式。新增温度算法在LiThermal/app/src/thermal.c中get_temperature_data()函数负责解析TB4117返回的JSON。可在此处添加自定义的非线性补偿算法提升低温段测温精度。扩展网络协议当前使用HTTP API若需更低延迟可修改thermalcamera.sh改用TCP Socket直连TB4117的私有协议端口如554接收H.264 Annex B流由gstreamer或ffmpeg库解码。所有修改均可通过./build.sh一键重新编译生成新固件。这种“代码即文档”的开源模式使工程师能真正理解每一行代码的硬件对应关系而非仅停留在黑盒使用层面。7. 故障排查与工程经验7.1 常见故障现象与根因分析现象可能根因排查步骤屏幕白屏但电脑识别MTP设备LCD排线接触不良T113-LCD接口虚焊RESET信号未正确拉高检查排线金手指是否氧化用万用表测LCD_RESET引脚电压是否为3.3V重焊T113的LCD_D0~D15引脚TB4117无法Ping通AX88179未识别USB数据线过长/屏蔽不良TB4117未设为NCM模式dmesg热图显示但温度值为0HTTP API路径错误TB4117 Web认证未开启JSON解析失败curl http://192.168.64.64/ISAPI/Thermal/channels/1/pictureData手动测试检查Web界面“安全 认证”是否启用UI动画卡顿60HzLVGL未启用硬件加速G2D驱动未加载Framebuffer内存不足cat /proc/meminfo7.2 焊接与调试经验总结T113-S3焊接推荐使用“拖焊法”。先用烙铁加锡膏在芯片一侧引脚上拖焊形成连续锡条再用吸锡线吸走多余焊锡利用表面张力使锡球自动归位。此法比逐点焊接更高效且连锡概率更低。EA3036电压异常若VDD-CPU输出高于0.9V首要怀疑FB1分压电阻虚焊或R_FB1阻值偏大。用万用表在线测量FB1引脚对地电压应为0.6VEA3036内部基准。若为0.8V则R_FB1开路。TB4117花屏90%源于USB供电不稳。务必使用5V/2A以上线性电源或优质充电宝供电禁用电脑USB口直连。AX88179的VDD33引脚旁的10μF钽电容C10若失效亦会导致花屏需更换。LiThermal项目的价值最终体现在其解决真实工程问题的能力上。当一块新PCB在示波器上显示出清晰的热分布云图当工程师不再需要凭经验猜测哪个电容在过热当一个开源设计能被真正复现、修改、部署于产线调试台——这便是嵌入式硬件开源最坚实的意义。
嵌入式热成像终端设计：基于TB4117与T113-S3的低延迟可视化方案
1. 项目概述热成像技术在电子硬件调试、工业巡检、安防监控及科研实验中具有不可替代的价值。传统红外测温枪仅能获取单点温度而热成像相机则可提供完整的二维温度分布图使工程师能够直观识别PCB上微小的发热点、判断散热设计合理性、验证电源模块热应力分布甚至发现隐藏的虚焊、短路或器件老化问题。然而现有开源热成像方案长期存在“高分辨率”与“高流畅度”的二元对立基于MLX90640等MEMS热电堆阵列的方案虽成本低、易集成但16×12或32×24的原始分辨率导致图像颗粒感严重细节模糊而采用海康威视TB4117等专业热成像模组的方案虽具备160×120的有效像素和25Hz帧率却常因嵌入式平台算力不足、GUI框架优化欠佳或USB视频流处理瓶颈导致用户界面卡顿、动画撕裂、交互响应迟滞。LiThermal项目正是针对这一工程矛盾提出的系统性解决方案。它并非简单堆砌高性能硬件而是围绕“热成像数据流—图像处理—人机交互”全链路进行深度协同设计选用全志T113-S3双核Cortex-A7 SoC作为主控兼顾计算性能与功耗控制采用LVGL 8作为GUI引擎通过硬件加速器G2D与帧缓冲Framebuffer的精准调度实现UI动画90Hz刷新率将TB4117模组工作于NCM网络模式而非UVC模式规避Linux UVC驱动对高带宽视频流的兼容性风险并利用其内置H.264编码能力降低USB总线负载。最终成果是一个软硬件全栈开源、功能完备、交互流畅且具备工程复现价值的便携式热成像终端。1.1 系统定位与核心指标LiThermal定位于面向嵌入式开发者与硬件工程师的可学习、可修改、可量产的参考设计。其核心性能指标如下表所示类别参数说明热成像性能分辨率160×120TB4117模组原生输出非插值放大刷新率25Hz模组固件设定满足动态热场观测需求测温范围0℃ ~ 106.4℃标准校准范围-20℃以下需自行补偿光标显示逻辑限制为0℃起始显示系统屏幕2.4英寸TFT LCD分辨率320×240匹配热图缩放与UI布局刷新率94.3Hz屏幕原生支持为LVGL动画提供高帧率基础主控平台SoC全志T113-S3双核ARM Cortex-A7 1.0GHz集成G2D 2D图形加速器内存128MB DDR3满足Linux内核、LVGL渲染缓存及视频解码需求存储MicroSD卡启动支持32GB及以下容量兼容主流品牌TF卡软件栈OS定制Tina LinuxOpenWRT衍生轻量级专为T113-S3优化内核版本4.9.xGUILVGL 8.3启用硬件加速、抗锯齿、多层渲染UI线程与视频解码线程分离视频协议NCMNetwork Control ModelUSB CDC ECM类将TB4117视为网络设备IP通信稳定可靠该设计摒弃了“为炫技而堆料”的思路所有选型均服务于一个明确目标在有限的BOM成本与PCB面积约束下构建一条低延迟、高确定性的热数据可视化通路。从传感器原始数据采集到屏幕像素点亮端到端延迟被严格控制在视觉可接受范围内确保用户操作如调色板切换、温度统计触发与画面反馈之间无明显割裂感。2. 硬件架构设计LiThermal的硬件系统采用模块化分层设计分为主控子系统、热成像接口子系统、电源管理子系统、人机交互子系统及显示子系统。各模块间通过标准高速接口互联物理布局遵循信号完整性与热管理原则。2.1 主控与存储单元主控单元以全志T113-S3为核心其外围电路设计严格遵循官方《T113-S3 Hardware Design Guidelines》。关键设计要点包括DDR3内存布线采用Fly-by拓扑时钟线CK/CK#与地址/命令线ADDR/CMD长度严格匹配差分对内间距≤0.1mm线宽/线距按50Ω单端阻抗设计。所有DDR走线避开电源平面分割区域底层铺完整地平面。eMMC启动T113-S3通过SDIO 4-bit接口连接eMMC芯片原理图中标注为EMMC但项目实际采用MicroSD卡启动方案。此处eMMC引脚被复用为GPIO或悬空SD卡槽直接接入T113-S3的SDIO0控制器支持HS200模式保障固件加载速度。USB Host接口TB4117模组通过USB 2.0 High-Speed接口接入T113-S3的USB PHY。PCB上预留TVS二极管D1,D2用于ESD防护串联电阻R1,R2用于阻抗匹配与信号整形确保480Mbps数据传输的信号眼图质量。2.2 热成像模组接口设计TB4117是海康威视推出的紧凑型热成像模组内置160×120非制冷氧化钒VOx焦平面探测器、专用ISP处理器及H.264编码器。LiThermal未采用常见的UVCUSB Video Class模式而是选择NCMNetwork Control Model模式其硬件接口设计具有显著工程优势NCM模式原理TB4117在NCM模式下USB设备描述符被识别为CDC ECMEthernet Control Model类设备。T113-S3的Linux内核加载cdc_ether驱动后模组表现为一个虚拟以太网接口如usb0。热图像数据被封装为标准以太网帧通过HTTP API或私有TCP协议获取规避了UVC驱动对YUV格式、帧同步、带宽协商等复杂机制的依赖。硬件适配为启用NCM模式TB4117需外接一颗RTL8153B或AX88179 USB-to-Ethernet桥接芯片项目BOM中为U11: AX88179。该芯片将TB4117的内部以太网MAC接口转换为USB 2.0接口。PCB设计中AX88179的USB D/D-线长严格匹配靠近T113-S3 USB PHY放置并添加π型滤波电路C1,C2,R3抑制高频噪声。供电隔离TB4117与AX88179由独立LDOU10: SY8009供电避免USB Host端口电流波动影响模组稳定性。实测表明使用开关电源或劣质USB Hub供电时TB4117易出现花屏或断连而采用线性稳压或优质充电宝则运行稳定。2.3 电源管理子系统电源系统是LiThermal可靠性的基石尤其考虑到T113-S3对核心电压VDD-CPU, VDD-SYS精度的严苛要求。本项目采用EA3036三路同步降压DC-DC控制器U1: EA3036其设计体现了典型的嵌入式电源工程思维多路输出设计EA3036提供三路独立可调输出VDD-CPU: 0.9V 2A —— T113-S3 CPU核心电压纹波要求20mVppVDD-SYS: 1.5V 2A —— SoC系统IO与内存接口电压VDD-IO: 3.3V 2A —— 外设USB PHY、LVDS屏接口、SD卡供电FB反馈网络每路输出通过外部电阻分压器R_FB1/R_FB2,R_FB3/R_FB4,R_FB5/R_FB6设定电压。原文提及“FB引脚上的100nF电容改为220pF”此为相位补偿调整——增大FB节点电容可提升环路稳定性抑制高频振荡是DC-DC设计中常见的环路补偿手段。上电时序控制EA3036支持EN引脚使能及PGOODPower Good信号输出。原理图中PGOOD信号连接至STC8单片机U2的GPIO用于电源健康状态监测。焊接流程强调“先测三路电压正常再焊T113”正是基于此设计若EA3036 FB网络虚焊导致输出电压漂移可能直接击穿T113-S3的ESD保护二极管。2.4 显示与人机交互接口LCD接口采用8080并行总线DB0~DB15,RS,WR,RD,CS,RESET驱动2.4英寸TFT屏。T113-S3的LCD控制器LCDC配置为RGB565格式直接映射至Framebuffer/dev/fb0。屏幕背光由NMOSQ1控制栅极串联100kΩ电阻R_BL用于限流与防静电符合原文“可用100K 0402代替”的工程冗余设计。按键与指示灯SW1为长按开机键连接至STC8单片机的外部中断引脚实现硬件级电源管理。LED1电源指示与LED2WiFi/状态指示由STC8 GPIO驱动便于调试阶段快速判断系统状态。调试接口板载CH340 USB转串口芯片U3TXD/RXD引出至测试点用于T113-S3的Linux内核日志输出与Shell交互。STC8单片机亦通过同一CH340提供独立串口R-TX,T-RX用于烧录其固件及读取电源管理状态。3. 软件系统架构LiThermal的软件栈采用分层架构自底向上分为Linux内核层、中间件层、应用层与GUI层。其设计核心在于解耦热数据获取与UI渲染确保高帧率交互不被视频解码阻塞。3.1 Linux内核与驱动配置内核定制基于Allwinner Tina Linux SDK构建内核版本为4.9.118。关键驱动配置包括CONFIG_USB_CDCETHERy启用CDC ECM驱动识别TB4117为usb0网络接口。CONFIG_DRM_SUN8I_DW_HDMIy禁用HDMI节省资源CONFIG_DRM_SUN8I_TCON_TOPy启用TCONTiming Controller驱动精确控制LCD时序。CONFIG_FB_SUN8IyFramebuffer驱动/dev/fb0为LVGL提供显存。USB网络配置系统启动后执行ifconfig usb0 192.168.64.1 netmask 255.255.255.0 up将主机端IP设为192.168.64.1。TB4117默认IP为192.168.64.64构成点对点以太网链路。此设计绕过复杂的USB枚举与UVC协议栈大幅降低内核态CPU占用率。3.2 热数据获取与处理热图像数据通过HTTP RESTful API从TB4117获取这是整个软件链路的关键创新点API调用流程应用程序向http://192.168.64.64/ISAPI/Streaming/channels/101/picture发送GET请求获取JPEG格式热图快照。或向http://192.168.64.64/ISAPI/ContentMgmt/StreamingProxy/channels/101/picture获取实时流式JPEGMJPEG over HTTP。数据解析获取的JPEG数据由libjpeg-turbo库解码为RGB565格式直接写入Framebuffer内存。温度元数据最大值、最小值、中心值通过另一APIhttp://192.168.64.64/ISAPI/Thermal/channels/1/pictureData获取JSON响应解析后更新UI控件。性能优化为避免频繁HTTP请求开销应用程序采用双缓冲机制一个线程持续拉取JPEG流并解码至后台缓冲区另一个线程在LVGL渲染周期中将后台缓冲区内容原子性地交换至前台Framebuffer。实测25Hz热图流下CPU占用率稳定在35%左右远低于UVC方案的60%。3.3 LVGL GUI框架实现LVGL 8.3被深度定制以匹配T113-S3硬件特性硬件加速集成启用LV_USE_GPU_STM32_DMA2D此处为LVGL对全志G2D的抽象命名所有lv_img_create()创建的图像对象在lv_img_set_src()指定内存地址后由G2D硬件块复制引擎完成显存填充CPU无需参与像素搬运。多线程渲染LVGL主线程lv_timer_handler()负责UI事件处理与控件更新独立的video_thread负责JPEG解码与Framebuffer写入。二者通过lv_task_create()注册的定时任务协调确保UI刷新90Hz与视频帧率25Hz异步解耦。关键UI组件热图渲染器继承lv_img_t重写draw_cb回调将解码后的RGB565数据通过G2D Blit至指定Framebuffer区域。温度统计图使用lv_chart_tX轴为像素索引Y轴为温度值实时绘制160×120全图温度直方图。调色板管理器预置Ironbow、WhiteHot、BlackHot等LUTLook-Up Table运行时通过lv_img_set_zoom()动态应用无需重新解码JPEG。4. 关键电路与BOM分析4.1 核心器件选型依据器件型号选型理由工程备注主控SoCAllwinner T113-S3双核A71GHz集成G2D、LVDS、USB 2.0 PHYTina Linux生态成熟成本低于RK3308需注意DDR布线难度建议参考官方Layout Guide热成像模组Hikvision TB4117160×120 VOx探测器25Hz帧率内置H.264编码NCM模式稳定可靠NCM模式需AX88179桥接UVC模式需额外UVC驱动适配USB网卡AX88179成熟USB-to-Ethernet方案Linux内核原生支持asix驱动功耗低替代型号RTL8153B亦可需确认内核驱动兼容性DC-DC控制器EA3036三路同步降压支持宽输入4.5V-36V轻载效率高FB网络易调节FB电容220pF为稳定性补偿100nF亦可工作但需验证纹波LCD驱动ILI9341 (屏内置)2.4 320×240 TFT8080并口SPI兼容成本低供货稳定屏幕易压伤组装时严禁尖锐物触碰4.2 BOM关键参数表序号位号器件规格数量备注1U1EA30363-Channel Synchronous Buck DC-DC1FB网络电阻按原理图值焊接2U2STC8F1K088051 Core, 8KB Flash, 1KB RAM1电源管理MCU需烧录power.hex固件3U3CH340GUSB to UART Bridge1用于T113与STC8调试4U10SY8009ABC3A, 1.2MHz Sync Buck1为TB4117/AX88179供电5U11AX88179USB 2.0 to 10/100M Ethernet1TB4117 NCM模式必需6Q1DMN3025LSDN-Channel MOSFET, 30V/6.5A1屏幕背光控制7Y1ABM3B-32.768KHZ-D2Y-T32.768kHz Crystal1可不焊系统使用内部RC振荡器注原文指出“32.768kHz晶振和旁边的电阻电容可以不焊”因其仅用于RTC实时时钟模块而LiThermal当前固件未启用RTC功能故为可裁剪项体现设计的灵活性。5. 系统集成与调试指南5.1 焊接与上电流程焊接是LiThermal复现的最大挑战其难点在于0.4mm间距的T113-S3 QFP封装与细间距的AX88179。标准流程必须严格执行分阶段焊接先焊接所有阻容感、CH340、STC8、EA3036等中小器件。使用万用表二极管档逐脚测量EA3036的VIN与GND间是否短路排除PCB短路。烧录STC8固件power.hex上电后用万用表直流电压档测量VDD-CPU0.9V、VDD-SYS1.5V、VDD-IO3.3V三点确认无过压/欠压。仅当三路电压全部正常后方可焊接T113-S3。此步骤可避免EA3036 FB虚焊导致的0.9V输出异常如升至1.2V从而永久损坏T113-S3的CPU核心。T113-S3焊接要点使用热风枪温度设为350℃风速3级喷嘴对准芯片中心均匀加热。焊接后用10倍放大镜检查所有引脚是否存在连锡Bridge。重点检查VDD-CPU、VSS-CPU、CLKIN等关键网络。连锡修复用吸锡线烙铁或细铜丝蘸助焊剂拖焊。5.2 固件烧录与系统启动TF卡烧录使用PhoenixCard工具选择LiThermal.img文件烧录模式为“启动卡”。务必使用32GB及以下容量、Class 10以上TF卡。烧录完成后卡内应包含boot、rootfs两个分区。首次启动插入TF卡长按SW13秒开机。若屏幕显示Logo则Framebuffer与LVGL初始化成功若白屏但电脑识别MTP设备说明LCD排线或T113-LCD接口虚焊若无任何USB设备识别则检查TF卡槽焊接或eMMC引脚是否短路。MTP设备配置将UDISK.tar解压后的LiThermal、thermalcamera.sh、BSOD三个文件复制至MTP设备根目录。重启后系统自动加载这些文件完成应用层初始化。5.3 TB4117网络配置TB4117的IP与认证设置是系统联调成败的关键使用海康“设备网络搜索”工具Windows扫描局域网找到TB4117设备。修改其IP为192.168.64.64子网掩码255.255.255.0。管理员密码设为Ab123456若提示弱口令先设强密码再登录Web界面http://192.168.64.64在“用户管理”中修改。Web界面中进入“配置 网络 接口”确认工作模式为“NCM”进入“视频 编码”设置主码流为H.264分辨率160×120帧率25fps。完成上述配置后T113-S3端执行ping 192.168.64.64若通则热成像数据通道已建立。6. 开源生态与二次开发LiThermal的全部应用层源代码C/C、LVGL UI代码、Shell脚本及编译脚本均托管于GitHub采用GPLv3许可证。其开源价值不仅在于代码可见更在于提供了完整的、可离线复现的构建环境。6.1 本地编译环境搭建项目使用GitHub Actions自动化构建其.yml文件makeProject.yml即为权威构建说明书。在Ubuntu 22.04 LTS上手动构建步骤如下# 1. 安装依赖 sudo apt update sudo apt install -y build-essential git wget unzip python3-pip # 2. 克隆仓库 git clone https://github.com/diylxy/LiThermal_Compiler.git cd LiThermal_Compiler # 3. 执行构建脚本会自动下载Tina SDK、交叉编译工具链 ./build.sh # 4. 构建产物位于 output/images/ 下包含 LiThermal.img构建过程会下载约3GB的Tina SDK与工具链全程需稳定网络。构建成功后output/images/LiThermal.img即为可烧录固件。6.2 功能定制示例修改开机Logo替换LiThermal/app/src/logo.c中的logo_data数组该数组为128×128 RGB565格式的Logo图像数据。使用Python脚本可将PNG图片转换为此格式。新增温度算法在LiThermal/app/src/thermal.c中get_temperature_data()函数负责解析TB4117返回的JSON。可在此处添加自定义的非线性补偿算法提升低温段测温精度。扩展网络协议当前使用HTTP API若需更低延迟可修改thermalcamera.sh改用TCP Socket直连TB4117的私有协议端口如554接收H.264 Annex B流由gstreamer或ffmpeg库解码。所有修改均可通过./build.sh一键重新编译生成新固件。这种“代码即文档”的开源模式使工程师能真正理解每一行代码的硬件对应关系而非仅停留在黑盒使用层面。7. 故障排查与工程经验7.1 常见故障现象与根因分析现象可能根因排查步骤屏幕白屏但电脑识别MTP设备LCD排线接触不良T113-LCD接口虚焊RESET信号未正确拉高检查排线金手指是否氧化用万用表测LCD_RESET引脚电压是否为3.3V重焊T113的LCD_D0~D15引脚TB4117无法Ping通AX88179未识别USB数据线过长/屏蔽不良TB4117未设为NCM模式dmesg热图显示但温度值为0HTTP API路径错误TB4117 Web认证未开启JSON解析失败curl http://192.168.64.64/ISAPI/Thermal/channels/1/pictureData手动测试检查Web界面“安全 认证”是否启用UI动画卡顿60HzLVGL未启用硬件加速G2D驱动未加载Framebuffer内存不足cat /proc/meminfo7.2 焊接与调试经验总结T113-S3焊接推荐使用“拖焊法”。先用烙铁加锡膏在芯片一侧引脚上拖焊形成连续锡条再用吸锡线吸走多余焊锡利用表面张力使锡球自动归位。此法比逐点焊接更高效且连锡概率更低。EA3036电压异常若VDD-CPU输出高于0.9V首要怀疑FB1分压电阻虚焊或R_FB1阻值偏大。用万用表在线测量FB1引脚对地电压应为0.6VEA3036内部基准。若为0.8V则R_FB1开路。TB4117花屏90%源于USB供电不稳。务必使用5V/2A以上线性电源或优质充电宝供电禁用电脑USB口直连。AX88179的VDD33引脚旁的10μF钽电容C10若失效亦会导致花屏需更换。LiThermal项目的价值最终体现在其解决真实工程问题的能力上。当一块新PCB在示波器上显示出清晰的热分布云图当工程师不再需要凭经验猜测哪个电容在过热当一个开源设计能被真正复现、修改、部署于产线调试台——这便是嵌入式硬件开源最坚实的意义。
