1. 项目概述H7-TOOL的模拟量采集与LUA脚本编程如果你手头有一块H7-TOOL并且正在为如何用它来测量电压、电流、NTC热敏电阻阻值甚至是工业上常见的4-20mA信号而发愁那么这篇教程就是为你准备的。H7-TOOL不仅仅是一个调试器它内置的高性能ADC和灵活的模拟前端电路让它摇身一变成为一个功能强大的便携式数据采集仪。而LUA脚本语言的引入更是将这种灵活性推向了极致——你不再需要等待官方固件更新特定功能而是可以像在手机上安装APP一样自己编写小程序定制专属的测量逻辑。今天我们就来彻底拆解如何利用H7-TOOL的LUA接口玩转电压、电流、NTC热敏电阻以及4-20mA输入这四大模拟量测量功能从硬件原理到软件配置从基础读取到高级应用让你手中的工具潜力全开。2. 硬件原理与测量模式深度解析在动手写代码之前我们必须先搞清楚H7-TOOL的模拟测量部分是怎么工作的。这决定了我们后续的配置方式和代码逻辑。H7-TOOL的模拟测量核心是其内部的ADC模数转换器和一系列精密的模拟开关、运放和采样电阻网络。这些硬件资源被巧妙地复用以支持多种测量模式。2.1 三种核心测量模式示波器、负载电流与多路低速扫描H7-TOOL的模拟量采集系统主要工作在三种模式下通过配置寄存器0x01FF来选择。理解这三种模式的区别是正确使用的前提。模式0示波器模式。这是最高速的模式主要用于捕获动态波形采样率最高可达5MHz。在此模式下CH1和CH2通道作为高速差分或单端输入使用侧重于信号的时域特性捕捉。本篇教程的重点是直流或缓变信号的测量所以不深入此模式。模式1负载电流测量模式。这是高侧电流测量的专用模式。所谓高侧测量就是将电流采样电阻放在电源正极和负载之间。H7-TOOL内部集成了一个高精度的电流采样放大器通常基于零漂移运放如AD8418或类似方案专门用于测量流经内部或外部负载的电流。在此模式下CH1和CH2的硬件通路被内部切换到高侧电流采样电路和其对应的负载电压测量点上。因此当你选择模式1时read_analog(2)和read_analog(3)才能正确读取到负载电压和电流。模式2多路低速扫描模式。这是多功能测量的核心模式。在此模式下H7-TOOL内部的模拟多路开关会以较低的速率相对于示波器模式循环扫描多个测量点包括CH1/CH2通用电压输入、TVCC目标板供电电压/电流、NTC热敏电阻桥臂电压、外部/USB供电电压以及4-20mA转换后的电压。这个模式牺牲了速度换来了对多达8种不同模拟信号的巡回检测能力。我们测量通用电压、TVCC、NTC、供电电压和4-20mA都必须在此模式下进行。关键提示模式选择是“排他性”的。你不能同时以模式1测量负载电流又以模式2去读NTC。如果你的应用需要同时监测负载电流和NTC温度就需要在LUA脚本中设计分时切换逻辑或者评估是否可以通过其他方式如用CH1/CH2外接传感器间接实现。2.2 模拟前端电路与量程选择无论是哪种模式最终信号都会经过一个可编程增益放大器PGA或衰减网络然后送入ADC。寄存器0x0202和0x0203就是用来设置CH1和CH2的量程的。量程列表0~7对应着不同的输入电压满量程范围从±13.8V到±100mV。量程选择的黄金法则在保证不超量程的前提下选择最小的量程。这是因为ADC的位数分辨率是固定的比如16位。在±13.8V量程下1LSB最低有效位代表的电压值很大测量小信号时量化误差会非常明显。而在±100mV量程下同样的ADC分辨率1LSB代表的电压值很小对小信号的测量精度就高得多。举个例子你要测量一个大约3.3V的信号。如果选择量程0±13.8V那么ADC的整个量程被用于表示-13.8V到13.8V3.3V只用了很小一部分编码精度差。如果选择量程2±3.2V3.3V几乎用满了量程ADC的每一个编码变化都对应更精细的电压变化测量精度自然就上来了。实操心得在编写通用测量脚本时一个良好的实践是加入“自动量程”逻辑。可以先用一个较大量程快速测量一次根据测得电压值动态切换到最合适的较小量程再进行精确测量。这能兼顾测量速度和精度。2.3 各测量通道的物理连接与信号调理了解每个read_analog函数索引对应的物理信号从哪里来至关重要索引0 1 (CH1, CH2电压)直接对应H7-TOOL背面的CH1和CH2香蕉插座/探头接口。内部是经过衰减/放大网络后的信号。注意耦合方式寄存器0x0200,0x0201测直流信号务必设为DC耦合值为1否则内部的隔直电容会滤掉直流分量。索引2 3 (高侧负载电压/电流)这两个值来源于H7-TOOL的“负载”功能电路。通常你需要将待测负载连接在H7-TOOL的“VOUT”和“GND”输出端子之间工具内部会测量输出端的电压和流经内部采样电阻的电流。仅在测量模式1下有效。索引4 5 (TVCC电压/电流)TVCC是H7-TOOL提供给目标板如你的STM32开发板的电源。索引4测量的是TVCC输出电压索引5测量的是输出电流。这用于监控你的目标板功耗。索引6 (NTC热敏电阻阻值)H7-TOOL板载了一个NTC热敏电阻通常用于监测自身温度或环境温度并连接成一个电阻分压电路。read_analog(6)读取的是该分压点的电压内部固件已经根据这个电压值结合已知的上拉电阻和NTC的B值参数计算并直接返回了以欧姆为单位的电阻值。你拿到这个电阻值后需要通过NTC的R-T查表法或Steinhart-Hart公式来换算成温度。索引7 8 (外部/USB供电电压)索引7测量的是通过DC插座给H7-TOOL供电的电压例如12V适配器索引8测量的是USB总线电压。用于监控工具自身的供电状况。索引9 (4-20mA输入)这是工业传感器常用接口。H7-TOOL内部有一个精密的采样电阻例如250Ω将4-20mA电流信号转换为1-5V的电压信号再由ADC读取。read_analog(9)返回的已经是经过换算的电流值单位mA。3. LUA脚本编程从初始化到数据读取全流程掌握了硬件原理我们就可以用LUA脚本这个“万能遥控器”来指挥H7-TOOL干活了。LUA脚本的交互本质是通过一组预定义的API函数读写H7-TOOL的内部寄存器或调用其功能。3.1 初始化配置函数start_dso的逐行解读提供的代码中start_dso函数是配置采集系统的核心。虽然代码看起来很长但结构清晰。我们以最常用的“多路低速扫描模式”模式2为例拆解每一行配置的意义function start_dso(void) write_reg16(0x01FF, 2) -- 测量模式 0:示波器 1:负载电流 2:多路低速扫描 write_reg16(0x0200, 1) -- CH1耦合,0:AC 1:DC write_reg16(0x0201, 1) -- CH2耦合,0:AC 1:DC --量程取值 0:±13.8V 1:±6.4V 2:±3.2V 3:±1.6V 4:±800mV 5:±400mV 6:±200mV 7:±100mV write_reg16(0x0202, 0) -- CH1量程 默认±13.8V 根据实际信号调整 write_reg16(0x0203, 0) -- CH2量程 默认±13.8V 根据实际信号调整 write_reg16(0x0204, 0) -- CH1通道直流偏值未用用于软件调零通常设为0 write_reg16(0x0205, 0) -- CH2通道直流偏值未用 write_reg16(0x0206, 12) --采样频率索引 12对应1MHz这是对CH1/CH2高速通道的配置在低速扫描模式下此参数影响不大但需保持一个有效值 write_reg16(0x0207, 0) --采样深度索引 0对应1K点同样低速模式下影响不大 write_reg16(0x0208, 32768) --触发电平ADC值 0-65535对应中间电平2.5V参考时 write_reg16(0x0209, 50) --触发位置百分比 50%即中间触发 write_reg16(0x020A, 0) --触发模式 0:自动无信号也持续采集 write_reg16(0x020B, 0) --触发通道 0:CH1 write_reg16(0x020C, 0) --触发边沿 0:下降沿 write_reg16(0x020D, 0x03) --通道使能控制 bit0CH1, bit1CH2, 0x03表示两个通道都使能 write_reg16(0x020E, 1) --采集控制 1:启动采集 end关键配置项解析与避坑指南0x01FF(测量模式)这是最重要的寄存器。务必根据你想测量的信号类型正确选择1或2。选错模式会导致read_analog读到无效数据或全零。0x0202/0x0203(量程)这是精度关键。务必根据你接入CH1/CH2的信号幅度预估来设置。测量5V信号用±6.4V量程值1比用±13.8V值0精度更高。如果信号未知可以先设为最大量程0测出大概范围后再调整。0x020D(通道使能)即使你只用read_analog(6)读NTC这个寄存器通常也需要保持CH1和CH2使能0x03因为内部的多路扫描电路可能需要这两个通道的扫描周期来同步。除非官方文档特别说明否则建议保持默认。0x0206/0x0207/0x0208~0x020C(触发相关)在低速扫描模式下这些触发参数几乎不起作用因为系统不是以触发方式工作而是以固定周期轮询。但寄存器必须写入一个合法的值否则采集引擎可能无法启动。所以保持示例中的值即可。3.2 数据读取函数read_analog与read_adc的区别教程中提到了两组读取函数read_analog和read_adc。它们有什么区别read_analog(index)这是高级函数。它返回的是经过H7-TOOL内部固件完全处理后的物理量值。例如read_analog(0)返回的是以**伏特(V)为单位的电压值read_analog(3)返回的是以安培(A)为单位的电流值read_analog(6)返回的是以欧姆(Ω)为单位的电阻值read_analog(9)返回的是以毫安(mA)**为单位的电流值。对于绝大多数应用推荐使用这个函数简单直接。read_adc(index)这是底层函数。它返回的是ADC转换后的原始数字量通常是一个0到65535对应16位ADC或类似范围的整数。这个值需要你根据量程、参考电压等进行换算才能得到物理量。例如假设ADC参考电压是3.3V量程为±3.2V即输入范围-3.2V~3.2V跨度6.4V那么ADC值32768对应0V0对应-3.2V65535对应3.2V。换算公式为电压 (ADC值 / 65535 * 量程跨度) - 量程正半轴。除非你需要做特殊的校准、滤波或获取原始数据进行更复杂的算法处理否则不需要使用这个函数。实操建议统一使用read_analog。只有当你发现某个通道的测量值存在固定的微小偏差零点漂移或增益误差想在自己的LUA脚本里做软件校准时才考虑用read_adc获取原始值然后套用自己的校准系数进行计算。3.3 构建一个健壮的多功能数据采集脚本让我们结合上述知识编写一个更健壮、更实用的LUA脚本。这个脚本将初始化低速扫描模式然后循环读取并打印所有可用的模拟量值。-- 文件名h7tool_analog_logger.lua -- 功能H7-TOOL多路模拟量数据采集与记录示例 -- 初始化模拟量采集系统多路低速扫描模式 function init_analog_system() write_reg16(0x01FF, 2) -- 模式2多路低速扫描 write_reg16(0x0200, 1) -- CH1 DC耦合 write_reg16(0x0201, 1) -- CH2 DC耦合 -- 假设我们预计CH1/CH2输入电压不超过5V选择±6.4V量程以获得更好精度 write_reg16(0x0202, 1) -- CH1量程 ±6.4V write_reg16(0x0203, 1) -- CH2量程 ±6.4V write_reg16(0x0204, 0) write_reg16(0x0205, 0) write_reg16(0x0206, 12) -- 采样频率保持默认 write_reg16(0x0207, 0) -- 采样深度保持默认 write_reg16(0x0208, 32768) write_reg16(0x0209, 50) write_reg16(0x020A, 0) write_reg16(0x020B, 0) write_reg16(0x020C, 0) write_reg16(0x020D, 0x03) -- 使能CH1和CH2 write_reg16(0x020E, 1) -- 启动采集 print(模拟量采集系统已初始化多路低速扫描模式。) end -- 主循环 function main() init_analog_system() delayms(100) -- 等待采集系统稳定 local count 0 while true do count count 1 print(\n 第 .. count .. 次采样 ) -- 1. 读取通用电压输入 local ch1_voltage read_analog(0) -- 单位V local ch2_voltage read_analog(1) -- 单位V print(string.format(CH1电压: %.3f V, ch1_voltage)) print(string.format(CH2电压: %.3f V, ch2_voltage)) -- 2. 读取TVCC目标板电源信息 local tvcc_voltage read_analog(4) -- 单位V local tvcc_current read_analog(5) -- 单位A print(string.format(TVCC电压: %.3f V, TVCC电流: %.3f A, tvcc_voltage, tvcc_current)) -- 3. 读取NTC热敏电阻阻值 local ntc_resistance read_analog(6) -- 单位Ω print(string.format(NTC电阻: %.0f Ω, ntc_resistance)) -- 可选将电阻转换为温度需要知道NTC参数例如B3950, R2510k -- local temperature 1 / (1/298.15 (1/3950)*math.log(ntc_resistance/10000)) - 273.15 -- print(string.format(估算温度: %.2f °C, temperature)) -- 4. 读取供电电压 local ext_voltage read_analog(7) -- 单位V local usb_voltage read_analog(8) -- 单位V print(string.format(外部供电: %.2f V, USB供电: %.2f V, ext_voltage, usb_voltage)) -- 5. 读取4-20mA输入 local current_4_20ma read_analog(9) -- 单位mA print(string.format(4-20mA输入: %.2f mA, current_4_20ma)) -- 6. 尝试读取负载信息注意当前是模式2读出的负载数据无效这里仅为演示 -- local load_v read_analog(2) -- 在模式2下此值无意义 -- local load_i read_analog(3) -- 在模式2下此值无意义 -- print(string.format(警告当前为模式2负载测量值无效。 V%.3f, I%.3f, load_v, load_i)) delayms(1000) -- 每秒采样一次 end end -- 运行主函数 main()脚本要点说明量程预设我们在初始化时根据预估信号幅度5V将CH1/CH2量程设为±6.4V值1这比默认的±13.8V精度更高。模式限制提醒脚本中注释明确提醒在模式2下读取负载电压/电流索引23是无效的。这是一个很好的编程习惯避免用户误解数据。数据格式化使用string.format和%.3f这样的格式控制符让输出数据更加整洁易读。延时初始化后delayms(100)等待硬件稳定。主循环中delayms(1000)控制采样率为1Hz适用于大多数低速监控场景。你可以根据需求调整。4. 高级应用与数据处理技巧掌握了基础读取我们可以玩点更高级的让数据采集更智能、更有用。4.1 为NTC热敏电阻实现温度转换read_analog(6)直接返回的是电阻值。要得到温度我们需要NTC的型号参数。最常见的是B值型NTC。假设H7-TOOL板载的是B395025°C时阻值R2510kΩ的NTC。我们可以在LUA脚本中添加一个转换函数。这里使用Steinhart-Hart方程的精简形式B值方程1/T 1/T0 (1/B) * ln(R/R0)其中T是目标温度开尔文。T0是参考温度开尔文通常是25°C 298.15K。B是NTC的B值例如3950。R是当前测量的电阻值Ω。R0是参考温度下的电阻值Ω例如10kΩ。function ntc_resistance_to_temperature(resistance_ohm, B_value, R25) local T0 298.15 -- 25°C in Kelvin local R0 R25 or 10000.0 -- 默认10kΩ 25°C local B B_value or 3950.0 -- 默认B值3950 if resistance_ohm 0 then return nil -- 避免对数计算错误 end local inv_T 1/T0 (1/B) * math.log(resistance_ohm / R0) local T_kelvin 1 / inv_T local T_celsius T_kelvin - 273.15 return T_celsius end -- 在主循环中使用 local ntc_r read_analog(6) if ntc_r 0 then local temp ntc_resistance_to_temperature(ntc_r, 3950, 10000) if temp then print(string.format(NTC温度: %.2f °C, temp)) end end注意事项B值方程在NTC工作温度范围内通常0-100°C有较好的精度。如果你需要更宽范围或更高精度可能需要使用完整的Steinhart-Hart三参数方程或者直接使用查找表法。4.2 实现4-20mA信号的量程映射与报警工业上4-20mA信号通常对应一个物理量的量程比如0-100°C的温度或者0-1MPa的压力。我们需要在LUA脚本里做线性映射。假设一个压力变送器输出4mA对应0MPa20mA对应1.0MPa连接到H7-TOOL的4-20mA输入口。function map_4_20ma_to_engineering_value(current_ma, range_low, range_high) -- current_ma: read_analog(9)读取的电流值 -- range_low: 4mA对应的工程值 (如 0) -- range_high: 20mA对应的工程值 (如 1.0) if current_ma 4.0 then -- 低于4mA可能断线或故障 return nil, Underrange elseif current_ma 20.0 then -- 高于20mA可能超量程或故障 return nil, Overrange else -- 线性映射公式 local span_ma 20.0 - 4.0 local span_eng range_high - range_low local eng_value range_low ((current_ma - 4.0) / span_ma) * span_eng return eng_value, OK end end -- 在主循环中使用 local current read_analog(9) -- 单位 mA local pressure, status map_4_20ma_to_engineering_value(current, 0, 1.0) if status OK then print(string.format(压力: %.3f MPa, pressure)) else print(string.format(4-20mA信号异常: %s (读数: %.2f mA), status, current)) end高级技巧数字滤波。工业环境可能有噪声你可以对read_analog(9)的读数进行软件滤波比如简单的移动平均滤波local ma_filter_buffer {} local ma_filter_size 5 function moving_average_filter(new_value, buffer, size) table.insert(buffer, new_value) if #buffer size then table.remove(buffer, 1) -- 移除最旧的值 end local sum 0 for _, v in ipairs(buffer) do sum sum v end return sum / #buffer end -- 在主循环中 local raw_current read_analog(9) local filtered_current moving_average_filter(raw_current, ma_filter_buffer, ma_filter_size) -- 使用 filtered_current 进行后续映射和判断4.3 数据记录与导出H7-TOOL的LUA脚本支持文件操作取决于固件版本和存储空间你可以将采集的数据写入到TF卡中生成CSV格式的文件方便后期用Excel或Python分析。-- 假设固件支持文件操作API如 file_open, file_write, file_close -- 以下为概念性代码具体API名称请参考最新版H7-TOOL LUA手册 function start_data_logging(filename) local file_handle file_open(filename, w) -- 以写入模式打开 if file_handle then -- 写入CSV表头 file_write(file_handle, Timestamp,CH1(V),CH2(V),TVCC_V(V),TVCC_I(A),NTC_R(Ohm),Pressure(MPa)\n) return file_handle else print(无法创建日志文件) return nil end end function log_data_point(file_handle, ch1, ch2, tvcc_v, tvcc_i, ntc_r, pressure) local timestamp os.time() -- 获取当前时间戳 local line string.format(%d,%.3f,%.3f,%.3f,%.3f,%.0f,%.3f\n, timestamp, ch1, ch2, tvcc_v, tvcc_i, ntc_r, pressure) file_write(file_handle, line) end -- 在主循环初始化部分 local log_file start_data_logging(datalog.csv) if log_file then print(数据日志已启动记录到 datalog.csv) end -- 在主循环采样后 if log_file then log_data_point(log_file, ch1_voltage, ch2_voltage, tvcc_voltage, tvcc_current, ntc_resistance, pressure) end5. 常见问题排查与实战经验分享即使按照教程操作在实际使用中也可能遇到各种问题。这里分享一些我踩过的坑和解决方案。5.1 问题排查清单问题现象可能原因排查步骤与解决方案read_analog返回0或接近0的值1. 测量模式选择错误。2. 通道未使能。3. 物理连接错误或信号线断开。4. 量程设置过大小信号被噪声淹没。1. 确认write_reg16(0x01FF, )的值是否正确电压/NTC/4-20mA用2负载电流用1。2. 确认write_reg16(0x020D, )的值是否为0x03。3. 用万用表检查信号源是否有输出检查H7-TOOL接口是否接触良好。4. 尝试减小量程增大寄存器值如从0改为2或3看读数是否有变化。read_analog返回值不稳定跳动大1. 信号本身有噪声。2. 采样间隔太短ADC未稳定。3. 电源干扰。4. 量程设置过小信号偶尔超限。1. 在信号源端并联一个0.1uF~10uF的电容滤波。2. 在read_analog前增加delayms(10)。3. 确保H7-TOOL和目标板共地良好使用屏蔽线。4. 换用更大量程或确认信号峰值。负载电流测量值不准1. 未使用模式1。2. 负载电流超出H7-TOOL量程通常为0-3A。3. 高侧采样电阻温漂。1.务必将0x01FF设为1。2. 确认负载电流在工具规格内。大电流需使用外部分流器。3. 长时间大电流测量后让工具休息降温或进行零点校准在空载时记录一个偏移值后续减去。4-20mA测量读数偏差大1. 外部采样电阻如果外接精度不够或温漂大。2. 信号源带载能力不足接入H7-TOOL的250Ω电阻后电压被拉低。3. 接线错误电流未形成回路。1. H7-TOOL内部采样电阻精度很高优先使用内部。如需外接选用高精度、低温漂的金属膜电阻。2. 检查信号源变送器的负载能力确保其在250Ω负载下仍能输出正确的4-20mA。3. 确认4-20mA信号线是串联在回路中的H7-TOOL的输入端口是“电流输入”相当于一个电阻必须串联。NTC温度值跳变或不准1. NTC自身热噪声或自热效应。2. 上拉电阻精度或B值参数不准确。3. 测量电路接触电阻影响。1. 对NTC电阻值进行软件滤波如移动平均。降低测量电流增大上拉电阻以减少自热但会降低信噪比需权衡。2. 使用更精确的万用表测量已知温度下的NTC阻值反推算准确的B值更新到LUA脚本中。3. 确保NTC引脚焊接牢固使用四线制测量可消除引线电阻影响但H7-TOOL板载电路通常是两线制。5.2 实战经验如何为你的传感器定制量程H7-TOOL的CH1/CH2量程是固定的几档。如果你的传感器输出范围不匹配就需要外加信号调理电路。例如一个压力传感器输出0-3.3V对应0-10kPa。你想用±3.2V量程索引2获得最佳精度。直接连接0-3.3V在±3.2V量程内实际测量范围是-3.2V~3.2V但负电压用不到。可以但ADC的0-3.3V只用了大约一半的量程编码。使用运放进行缩放和偏移推荐设计一个运放电路将0-3.3V线性映射到0-3.2V甚至0-2.5V。例如用一个同相放大器增益设为0.97 (3.2/3.3)偏移为0。这样传感器的满量程输出刚好对应ADC的满量程输入充分利用了ADC的分辨率精度最高。在LUA脚本中做软件缩放如果不想动硬件也可以直接读取电压然后在LUA里换算。电压值 read_analog(0)压力值 (电压值 / 3.3) * 10。但这样ADC的量化误差会被保留。我的选择对于精度要求不高的场合方法3最简单。对于要求高的场合方法2硬件调理配合合适的量程选择能获得最佳性能。务必在start_dso函数中根据运放输出后的电压范围设置正确的量程索引。5.3 性能优化与稳定性建议采样率与功耗低速扫描模式本身功耗不高。但如果你在LUA脚本中疯狂循环读取比如不加delayms虽然数据更新快但会导致LUA引擎和USB/屏幕通信持续高负荷可能引起工具发热或偶尔卡顿。对于温度、压力等慢变信号100ms~1000ms的采样间隔完全足够。脚本结构将初始化配置start_dso放在循环外只执行一次。避免在循环内反复配置寄存器这毫无必要且浪费资源。错误处理在实际的自动化脚本中应该加入pcall等错误捕获机制。因为read_analog在极端情况下如硬件故障可能出错导致LUA脚本崩溃。一个好的习惯是local success, value pcall(read_analog, 0) if success then -- 处理value else print(读取CH1电压失败: , value) -- 此时value是错误信息 -- 尝试重新初始化或跳过本次采样 end校准对于绝对精度要求高的场合H7-TOOL的ADC出厂已校准。但你仍可以用一个更高精度的基准源如ADR445输入一个已知电压用read_adc读取原始值计算出一个校准系数斜率K和偏移B在read_analog的结果上再进行一次修正V_real K * V_read B。将这个系数保存在LUA脚本的全局变量中。最后H7-TOOL的LUA功能还在不断丰富新的API可能会增加。养成查阅官方最新版《H7-TOOL LUA脚本API手册》的习惯是挖掘这款工具潜力的最佳途径。希望这篇超详细的拆解能帮你把H7-TOOL的模拟量采集功能真正用起来搞定从简单的电压检查到复杂的多传感器数据记录等各种任务。