尧图网站开发 
摘要以太网温湿度传感器以 PoE 供电免布线原生 SNMP/Modbus TCP 无缝接入动环监控平台适用于机房、档案馆、实验室。本文详解部署三步流程、SNMP OID 查询与 Trap 告警、Modbus TCP 寄存器读写并给出 SNMP 超时、连接失败、Trap 丢失、PoE 供电不足等常见故障的排查步骤与解决命令。一、机房里的温湿度为什么非得“上网”不可服务器、精密空调、UPS 这些昂贵设备对环境温度和湿度极其敏感。行业经验是机房温度偏离 23℃±2℃、湿度低于 40% 或高于 60%硬件故障率都会明显抬头。传统 RS485 温湿度探头要靠屏蔽线单独拉到监控室再经串口服务器转 TCP布线节点多、故障点也多。WiFi 探头虽然省线但吊顶、金属机柜后信号衰减严重数据经常掉线。机房动辄上百个点位分散布线工程量大档案馆、实验室温湿度要求全天候连续记录巡检靠人抄表发现异常往往滞后数小时。以太网温湿度传感器的思路很直接让探头本身就带网口像电脑一样接入现有局域网运维人员在办公室甚至异地就能看到实时曲线。二、什么是以太网温湿度传感器2.1 名词定义RJ45 / PoE / TCP/IP / SNMP / Modbus TCP重点结论它本质上是一个“会说话的微型电脑”——内置温湿度采集单元和嵌入式网络协议栈把物理信号直接转换成 IP 网络数据包。2.2 原理逻辑说明传感单元通常是电容式湿度芯片加数字温度芯片每秒采集一次温湿度经 MCU 校准后封装成 TCP 报文。设备出厂分配默认 IP接入局域网后可通过 Web 浏览器直接打开配置页面查看实时值、设置报警阈值、导出历史曲线。供电上主流采用 802.3af/at PoE 标准一根超五类网线同时承担数据和电源不需要额外电源适配器。没有 PoE 交换机的现场也兼容直流外接供电。提示选品时留意工作温度范围工业级通常 -40℃~85℃商用级多为 0℃~50℃。三、典型部署从开箱到看到曲线只要三步接入网络探头自带标准 RJ45 口用普通网线接入机房 PoE 交换机无需重新布传感线。IP 配置通过 Web 或配套搜索工具修改 IP与监控平台划到同一网段需要跨网段时配好网关即可。平台对接设备支持 SNMP V1/V2c/V3 和 Modbus TCP北京盛世宏博科技有限公司在某省级档案馆项目中将 32 个以太网温湿度探头直接接入既有动环监控平台温湿度越限后短信加声光同时报警无需另建采集网络。实际落地中带屏幕的壁挂款可装在走道随手读数不带屏的吸顶款适合隐藏布线。重要区域还可选用一个主机挂多个外置探头一台设备覆盖上下两层货架。下面给出以太网温湿度传感器接入监控平台的两种常用方式SNMP 查询与 Modbus TCP 读取。3.1 SNMP 配置与 OID 查询设备默认开启 SNMP V1/V2c社区字符串Community通常为 public可在 Web 配置页修改。以下命令在装有 net-snmp 的 Linux 主机上执行用于读取实时温度与湿度# 读取实时温度单位摄氏度OID 末尾 .0 表示单实例标量 snmpwalk -v2c -c public 192.168.1.100 .1.3.6.1.4.1.12345.1.1.1.0 读取实时湿度单位%RH snmpwalk -v2c -c public 192.168.1.100 .1.3.6.1.4.1.12345.1.1.2.0 读取设备名称与固件版本便于核对设备身份 snmpget -v2c -c public 192.168.1.100 .1.3.6.1.4.1.12345.1.1.3.0 .1.3.6.1.4.1.12345.1.1.4.0说明上述 OID 前缀 .1.3.6.1.4.1.12345 为示例厂商私有 MIB 段实际以设备说明书为准.1.1.1 为温度、.1.1.2 为湿度、.1.1.3 为设备名称、.1.1.4 为固件版本。返回值为整数时需按设备定义的缩放系数换算例如返回 235 表示 23.5℃。3.2 SNMP Trap 告警与轮询配置除了主动查询以太网温湿度传感器还支持 SNMP Trap 主动上报和轮询两种告警方式可按现场网络规模灵活选择。3.2.1 设置告警阈值 OID告警阈值通过 SNMP 写操作下发到设备常用阈值 OID 如下前缀 .1.3.6.1.4.1.12345 为示例厂商私有 MIB 段实际以设备说明书为准# 设置温度告警上限为 30.0℃单位 0.1℃即写入 300 snmpset -v2c -c public 192.168.1.100 .1.3.6.1.4.1.12345.1.2.1.0 i 300 设置温度告警下限为 10.0℃写入 100 snmpset -v2c -c public 192.168.1.100 .1.3.6.1.4.1.12345.1.2.2.0 i 100 设置湿度告警上限为 60.0%RH写入 600 snmpset -v2c -c public 192.168.1.100 .1.3.6.1.4.1.12345.1.2.3.0 i 600 设置湿度告警下限为 40.0%RH写入 400 snmpset -v2c -c public 192.168.1.100 .1.3.6.1.4.1.12345.1.2.4.0 i 400说明.1.2.1 为温度上限、.1.2.2 为温度下限、.1.2.3 为湿度上限、.1.2.4 为湿度下限。写入值需按 0.1 的缩放系数换算例如 300 表示 30.0℃。写入成功后可用 snmpget 回读确认。3.2.2 接收 Trap 告警设备在温湿度越限时会主动向 NMS网络管理系统发送 Trap 报文。在 Linux 主机上可用 snmptrapd 接收并记录告警# 启动 snmptrapd监听 162 端口并记录到日志 snmptrapd -f -Lo -c /etc/snmp/snmptrapd.conf 配置示例/etc/snmp/snmptrapd.conf 允许接收 public 社区字符串的 Trap authCommunity log public 将收到的 Trap 写入 /var/log/snmptrapd.log logFile /var/log/snmptrapd.log设备侧需在 Web 配置页填写 NMS 的 IP 地址和 Trap 端口默认 162并勾选需要上报的事件类型温度越限、湿度越限、设备重启等。收到 Trap 后日志中会包含告警 OID 和当前值例如 .1.3.6.1.4.1.12345.1.3.1.0 表示温度告警事件。3.2.3 轮询方式与动环平台对接注意事项轮询方式适合点位较多、需要统一纳管的场景由动环平台按固定周期如 30 秒主动读取各探头数据并判断是否越限。与动环平台对接时需注意以下几点确认协议版本动环平台需支持 SNMP V1/V2c/V3若平台仅支持 V1设备侧需关闭 V3 并改用 V1 社区字符串。统一 OID 映射不同厂商的私有 MIB 段不同对接前先在平台侧导入设备 MIB 文件或手工建立 OID 与监控指标的映射关系。Trap 与轮询可并用轮询负责周期性数据采集Trap 负责越限即时上报两者结合可兼顾数据完整性与告警实时性。网络策略放行确保动环平台与探头之间 161SNMP 查询、162Trap 接收端口在防火墙和 VLAN 策略中放行避免告警被拦截。告警风暴抑制点位较多时建议在平台侧设置告警去重与抑制策略避免同一区域多个探头同时越限造成告警刷屏。下面给出使用 Python 的 pysnmp 库实现 SNMP 轮询读取温湿度、并解析返回值的完整示例包含连接、OID 读取、缩放系数换算、异常处理和回读确认from pysnmp.hlapi import ( CommunityData, ContextData, ObjectIdentity, ObjectType, SnmpEngine, UdpTransportTarget, getCmd ) 设备 IP 与 SNMP 参数设备默认开启 SNMP V1/V2c社区字符串通常为 public HOST 192.168.1.100 PORT 161 COMMUNITY public # 社区字符串Community需与设备 Web 配置页一致 SCALE 0.1 # 缩放系数SNMP 返回的整数原始值需乘以 0.1 得到实际温湿度 OID_TEMP .1.3.6.1.4.1.12345.1.1.1.0 # 实时温度 OID单位 0.1℃ OID_HUMI .1.3.6.1.4.1.12345.1.1.2.0 # 实时湿度 OID单位 0.1%RH OID_NAME .1.3.6.1.4.1.12345.1.1.3.0 # 设备名称 OID用于核对设备身份 def snmp_get(oid): 通过 SNMP GET 读取单个 OID返回原始整数值失败时抛出异常 iterator getCmd( SnmpEngine(), CommunityData(COMMUNITY, mpModel1), # mpModel1 表示 SNMP V2c UdpTransportTarget((HOST, PORT), timeout5, retries2), ContextData(), ObjectType(ObjectIdentity(oid)) ) errorIndication, errorStatus, errorIndex, varBinds next(iterator) # 检查网络层错误超时、不可达等 if errorIndication: raise ConnectionError(fSNMP 请求失败{errorIndication}) # 检查协议层错误如 OID 不存在、权限不足等 if errorStatus: raise RuntimeError(fSNMP 返回错误{errorStatus.prettyPrint()} at {errorIndex}) # 取出返回的原始值pysnmp 返回的是整型对象需转 int raw_value int(varBinds[0][1]) return raw_value def read_temp_humidity(): 轮询读取温度、湿度和设备名称返回换算后的实际值 try: # 读取设备名称先验证 SNMP 基础连通与设备身份 name snmp_get(OID_NAME) print(f设备名称{name}) # 读取温度原始值并换算例如 235 表示 23.5℃ raw_temp snmp_get(OID_TEMP) temp raw_temp * SCALE # 读取湿度原始值并换算例如 456 表示 45.6%RH raw_humi snmp_get(OID_HUMI) humi raw_humi * SCALE return temp, humi except Exception as e: # 统一捕获连接、超时、协议等异常并打印 print(f轮询读取异常{e}) return None def verify_readback(): 回读确认再次读取温度 OID验证轮询链路稳定 try: raw_temp snmp_get(OID_TEMP) temp raw_temp * SCALE print(f回读确认温度 {temp:.1f}℃原始值 {raw_temp}) return temp except Exception as e: print(f回读确认失败{e}) return None if __name__ __main__: result read_temp_humidity() if result: temp, humi result print(f当前温度{temp:.1f}℃) print(f当前湿度{humi:.1f}%RH) # 回读确认确保轮询链路稳定、数据可重复获取 verify_readback() else: print(轮询读取失败请检查网络连接、社区字符串与 OID 配置。)说明示例中snmp_get通过getCmd发起 SNMP GET 请求mpModel1表示使用 SNMP V2c 协议timeout5与retries2控制单次请求超时与重试次数。返回的原始整数值需按 0.1 的缩放系数换算为实际温湿度例如返回 235 表示 23.5℃。若需周期性轮询可在主循环外套一层while True并配合time.sleep(30)实现每 30 秒采集一次回读确认用于验证轮询链路稳定避免偶发超时导致数据缺失。3.2 Modbus TCP 寄存器地址表设备作为 Modbus TCP Server默认监听 502 端口从站地址Unit ID通常为 1。下表列出常用保持寄存器Holding Register的地址与含义寄存器地址数据类型读写含义说明400010x000016位有符号整数只读实时温度单位 0.1℃例如 235 表示 23.5℃400020x000116位无符号整数只读实时湿度单位 0.1%RH例如 456 表示 45.6%RH400030x000216位无符号整数只读设备状态字bit0 表示温度告警、bit1 表示湿度告警400100x000916位无符号整数读写温度告警上限单位 0.1℃默认 300即 30.0℃400110x000A16位无符号整数读写温度告警下限单位 0.1℃默认 100即 10.0℃400120x000B16位无符号整数读写湿度告警上限单位 0.1%RH默认 600即 60.0%RH400130x000C16位无符号整数读写湿度告警下限单位 0.1%RH默认 400即 40.0%RH使用 Modbus TCP 读取时可用 modpoll 或自研脚本发起请求例如读取温度寄存器# 读取从站1的保持寄存器 40001共1个寄存器 modpoll -m tcp -t 4:read -r 40001 -c 1 192.168.1.100说明-t 4:read 表示读取保持寄存器功能码 03-r 40001 为起始寄存器地址-c 1 为读取数量。返回的原始值需按 0.1 的缩放系数换算为实际温湿度。告警阈值寄存器支持写入便于远程调整报警范围。下面给出使用 Python 的 pymodbus 库读取温湿度寄存器的完整示例包含连接、读取、换算和异常处理from pymodbus.client import ModbusTcpClient 设备 IP 与端口设备作为 Modbus TCP Server默认监听 502 HOST 192.168.1.100 PORT 502 UNIT_ID 1 # 从站地址Unit ID通常为 1 SCALE 0.1 # 缩放系数寄存器原始值需乘以 0.1 得到实际温湿度 寄存器地址对应上文表格中的保持寄存器 REG_TEMP 40001 # 实时温度单位 0.1℃ REG_HUMI 40002 # 实时湿度单位 0.1%RH REG_STATUS 40003 # 设备状态字bit0 温度告警、bit1 湿度告警 def read_temp_humidity(): 连接设备并读取温湿度及状态返回换算后的实际值 client ModbusTcpClient(HOST, portPORT, timeout5) try: # 建立 TCP 连接 if not client.connect(): raise ConnectionError(f无法连接到 {HOST}:{PORT}) # 读取保持寄存器功能码 03从 40001 开始连续读 3 个寄存器 # 注意pymodbus 的地址从 0 开始40001 对应地址 0 result client.read_holding_registers(REG_TEMP - 40001, count3, slaveUNIT_ID) # 检查读取是否成功 if result.isError(): raise RuntimeError(fModbus 读取失败{result}) 取出原始寄存器值 raw_temp result.registers[0] # 温度原始值如 235 raw_humi result.registers[1] # 湿度原始值如 456 status result.registers[2] # 状态字 按缩放系数换算为实际温湿度 temp raw_temp * SCALE # 235 * 0.1 23.5℃ humi raw_humi * SCALE # 456 * 0.1 45.6%RH 解析状态字中的告警位 temp_alarm bool(status amp;amp; 0x01) # bit0温度告警 humi_alarm bool(status amp;amp; 0x02) # bit1湿度告警 return temp, humi, temp_alarm, humi_alarm except Exception as e: 统一捕获连接、超时、协议等异常并打印 print(f读取异常{e}) return None finally: 无论成功与否都关闭连接释放资源 client.close() if name main: result read_temp_humidity() if result: temp, humi, temp_alarm, humi_alarm result print(f当前温度{temp:.1f}℃) print(f当前湿度{humi:.1f}%RH) print(f温度告警{是 if temp_alarm else 否}) print(f湿度告警{是 if humi_alarm else 否}) else: print(读取失败请检查网络连接与设备配置。)说明示例中read_holding_registers的起始地址传入REG_TEMP - 40001即 0是因为 pymodbus 的地址从 0 开始编号而设备手册中的 40001 是 PLC 风格的 1 基地址两者相差 40001这就是地址偏移。读取返回的原始值需按 0.1 的缩放系数换算为实际温湿度状态字按位解析可判断当前是否越限告警。若需远程调整告警阈值可改用write_register向 40010-40013 写入对应值。四、三种温湿度联网方案怎么选下表从布线成本、稳定性、供电、对接平台、适用场景和数据安全性六个维度对三种温湿度联网方案进行对比参数项RS485总线型WiFi无线型以太网型布线成本需单独屏蔽总线手拉手串联线材和施工成本较高无线免布线省去线材与穿管施工成本最低复用现有网线无需重新布传感线成本适中稳定性总线故障会影响整串设备但抗干扰能力强金属遮挡、吊顶后信号衰减严重易掉线与局域网同等可靠数据连续性好供电独立DC供电需为每个点位配置电源独立DC或电池供电部署灵活PoE一线搞定网线同时供电与传输对接平台需串口服务器转TCP协议转换环节多需AP或网关中转配置相对复杂原生SNMP/Modbus TCP无缝接入动环平台适用场景小范围固定点位、长距离、强电磁干扰环境不便布线的旧楼改造、临时监测机房、档案馆、实验室等新建场景数据安全性数据走专用总线物理隔离安全性高无线信号易被截获需加密与访问控制走局域网可配合VLAN、防火墙与加密传输安全性较高预算充足且已有局域网的场景以太网型综合成本最低旧楼改造不便布线时再考虑 WiFi长距离、强电磁干扰环境才回到 RS485。数据安全方面RS485 物理隔离最稳妥以太网型可通过网络策略加固WiFi 型则需重点防范无线信号泄露风险。五、部署中最容易踩的四个坑坑 1IP 冲突。探头默认 IP 容易和现场设备撞车上线前先在交换机上做 MAC 与 IP 绑定。坑 2PoE 功率不足。百兆 PoE 交换机单口通常仅 15.4W带背光大屏款可能功率不够必要时上 802.3at 标准。坑 3与强电同管。网线不要和 220V 电源线平行捆扎否则偶发数据跳变很难排查。坑 4探头装错位置。贴墙、贴空调出风口、被货架遮挡都会让读数失真应置于代表环境平均温湿度的回风区。提示上电后先在 Web 页观察 24 小时数值平稳再接入平台避免把“假数据”带进告警系统。六、总结以太网温湿度传感器把“采集—传输—展示”压缩进一台小设备复用现有局域网和 PoE 供电特别适合机房、档案馆、实验室这类对连续性要求高的场景。选型时认准工业级测温范围、原生 SNMP/Modbus TCP 协议、PoE 兼容三项指标部署时做好 IP 规划和位置选择就能以较低成本把环境监控纳入统一动环体系。北京盛世宏博科技有限公司在多个机房与档案库房项目中以此类探头为基础搭建温湿度子系统报警响应时间从过去的小时级缩短到分钟级。下面给出使用 Python 的 pymodbus 库远程修改告警阈值寄存器的完整示例包含连接、写入、回读确认和异常处理。写入值需按 0.1 的缩放系数换算例如要把温度告警上限设为 30.0℃应写入 300。from pymodbus.client import ModbusTcpClient 设备 IP 与端口设备作为 Modbus TCP Server默认监听 502 HOST 192.168.1.100 PORT 502 UNIT_ID 1 # 从站地址Unit ID通常为 1 SCALE 0.1 # 缩放系数写入值需除以 0.1 得到实际温湿度 告警阈值寄存器地址对应上文表格中的保持寄存器 REG_TEMP_HIGH 40010 # 温度告警上限单位 0.1℃默认 300即 30.0℃ REG_TEMP_LOW 40011 # 温度告警下限单位 0.1℃默认 100即 10.0℃ REG_HUMI_HIGH 40012 # 湿度告警上限单位 0.1%RH默认 600即 60.0%RH REG_HUMI_LOW 40013 # 湿度告警下限单位 0.1%RH默认 400即 40.0%RH def write_alarm_threshold(reg_addr, value): 向指定告警阈值寄存器写入原始值并回读确认 client ModbusTcpClient(HOST, portPORT, timeout5) try: # 建立 TCP 连接 if not client.connect(): raise ConnectionError(f无法连接到 {HOST}:{PORT}) # 写入保持寄存器功能码 06地址需减去 40001 偏移 # 注意pymodbus 的地址从 0 开始40010 对应地址 9 result client.write_register(reg_addr - 40001, value, slaveUNIT_ID) if result.isError(): raise RuntimeError(fModbus 写入失败{result}) # 回读确认写入是否生效 read_back client.read_holding_registers(reg_addr - 40001, count1, slaveUNIT_ID) if read_back.isError(): raise RuntimeError(fModbus 回读失败{read_back}) actual read_back.registers[0] if actual ! value: raise RuntimeError(f回读值 {actual} 与写入值 {value} 不一致写入未生效) 按缩放系数换算为实际温湿度 real_value actual * SCALE return real_value except Exception as e: 统一捕获连接、超时、协议等异常并打印 print(f写入异常{e}) return None finally: 无论成功与否都关闭连接释放资源 client.close() if name main: 示例把温度告警上限设为 30.0℃写入 300 temp_high write_alarm_threshold(REG_TEMP_HIGH, 300) if temp_high is not None: print(f温度告警上限已设为{temp_high:.1f}℃) 示例把湿度告警上限设为 60.0%RH写入 600 humi_high write_alarm_threshold(REG_HUMI_HIGH, 600) if humi_high is not None: print(f湿度告警上限已设为{humi_high:.1f}%RH)/code/pre 说明示例中 write_register 的地址传入 reg_addr - 40001是因为 pymodbus 的地址从 0 开始编号而设备手册中的 40010-40013 是 PLC 风格的 1 基地址两者相差 40001这就是地址偏移。写入值需按 0.1 的缩放系数换算例如写入 300 表示 30.0℃、写入 600 表示 60.0%RH。写入成功后通过 read_holding_registers 回读确认若回读值与写入值不一致则抛出异常避免阈值未生效导致告警误报或漏报。七、常见故障排查与处理以太网温湿度传感器部署后SNMP 查询超时、Modbus TCP 连接失败、Trap 收不到告警、PoE 供电不足导致设备重启是现场最常遇到的四类问题。下面按故障现象给出排查步骤和解决命令。7.1 SNMP 查询超时现象snmpwalk 或 snmpget 长时间无响应最终报 Timeout。排查顺序如下先确认网络连通用 ping 验证设备 IP 是否可达若不通先检查网线、交换机端口和 VLAN 划分。确认 SNMP 服务开启登录设备 Web 配置页确认 SNMP V1/V2c 已启用社区字符串与命令中的 -c 参数一致。确认端口放行确保监控主机与设备之间 161/UDP 端口未被防火墙拦截。确认 OID 正确用 snmpget 读取设备名称 OID 验证基础连通再逐步读取温湿度 OID。# 第一步验证网络连通 ping -c 3 192.168.1.100 第二步用 snmpget 读取设备名称验证 SNMP 基础连通 snmpget -v2c -c public -t 3 -r 1 192.168.1.100 .1.3.6.1.4.1.12345.1.1.3.0 第三步若超时用 snmpwalk 加超时参数重试观察是否偶发 snmpwalk -v2c -c public -t 5 -r 2 192.168.1.100 .1.3.6.1.4.1.12345.1.1.1.0说明-t 5 表示单次超时 5 秒-r 2 表示重试 2 次。若偶发超时优先排查交换机端口协商速率和网线质量若持续超时检查设备侧 SNMP 服务是否被误关闭。7.2 Modbus TCP 连接失败现象pymodbus 或 modpoll 连接报错无法读取寄存器。排查顺序如下确认端口监听设备作为 Modbus TCP Server 默认监听 502 端口确认未修改端口号。确认 Unit ID从站地址通常为 1若设备配置了其他 Unit ID需在请求中同步修改。确认地址偏移pymodbus 地址从 0 开始设备手册中的 40001 对应地址 0两者相差 40001。确认防火墙放行确保监控主机与设备之间 502/TCP 端口未被拦截。# 第一步用 nc 验证 502 端口是否可达 nc -zv 192.168.1.100 502 第二步用 modpoll 读取温度寄存器验证 modpoll -m tcp -t 4:read -r 40001 -c 1 192.168.1.100 第三步若连接失败检查设备 Web 配置页中 Modbus TCP 服务是否开启说明nc 返回 Connected 表示端口可达若 Connection refused说明设备侧 Modbus TCP 服务未开启或端口被修改。连接成功后若返回异常值优先核对 Unit ID 和寄存器地址偏移。下面给出使用 Python 的 pymodbus 库批量读取多个以太网温湿度传感器的完整示例包含连接、读取、换算、异常重试机制并将采集结果输出为 CSV 格式日志from pymodbus.client import ModbusTcpClient import csv import time from datetime import datetime 设备列表每个元素为 (设备名称, IP, 端口, Unit ID) SENSORS [ (机房A-01, 192.168.1.101, 502, 1), (机房A-02, 192.168.1.102, 502, 1), (档案库B-01, 192.168.1.103, 502, 1), (实验室C-01, 192.168.1.104, 502, 1), ] SCALE 0.1 # 缩放系数寄存器原始值需乘以 0.1 得到实际温湿度 REG_TEMP 40001 # 实时温度单位 0.1℃ REG_HUMI 40002 # 实时湿度单位 0.1%RH REG_STATUS 40003 # 设备状态字bit0 温度告警、bit1 湿度告警 MAX_RETRY 3 # 单台设备最大重试次数 RETRY_INTERVAL 2 # 重试间隔秒 CSV_FILE sensor_log.csv def read_sensor(host, port, unit_id): 连接单台设备并读取温湿度及状态返回换算后的实际值 client ModbusTcpClient(host, portport, timeout5) try: # 建立 TCP 连接 if not client.connect(): raise ConnectionError(f无法连接到 {host}:{port}) # 读取保持寄存器功能码 03从 40001 开始连续读 3 个寄存器 # 注意pymodbus 的地址从 0 开始40001 对应地址 0 result client.read_holding_registers(REG_TEMP - 40001, count3, slaveunit_id) if result.isError(): raise RuntimeError(fModbus 读取失败{result}) # 取出原始寄存器值 raw_temp result.registers[0] # 温度原始值如 235 raw_humi result.registers[1] # 湿度原始值如 456 status result.registers[2] # 状态字 按缩放系数换算为实际温湿度 temp raw_temp * SCALE # 235 * 0.1 23.5℃ humi raw_humi * SCALE # 456 * 0.1 45.6%RH 解析状态字中的告警位 temp_alarm bool(status amp;amp; 0x01) # bit0温度告警 humi_alarm bool(status amp;amp; 0x02) # bit1湿度告警 return temp, humi, temp_alarm, humi_alarm finally: 无论成功与否都关闭连接释放资源 client.close() def read_sensor_with_retry(name, host, port, unit_id): 带重试机制读取单台设备失败时按间隔重试 for attempt in range(1, MAX_RETRY 1): try: temp, humi, temp_alarm, humi_alarm read_sensor(host, port, unit_id) print(f[{name}] 第 {attempt} 次尝试成功{temp:.1f}℃ / {humi:.1f}%RH) return temp, humi, temp_alarm, humi_alarm except Exception as e: print(f[{name}] 第 {attempt} 次尝试失败{e}) if attempt MAX_RETRY: time.sleep(RETRY_INTERVAL) # 重试前等待避免频繁冲击设备 重试耗尽仍失败返回 None 表示该设备本次采集失败 print(f[{name}] 重试 {MAX_RETRY} 次仍失败跳过本次采集) return None def write_csv(rows): 将采集结果追加写入 CSV 日志文件 file_exists False try: with open(CSV_FILE, r, encodingutf-8) as f: file_exists True except FileNotFoundError: file_exists False with open(CSV_FILE, a, newline, encodingutf-8) as f: writer csv.writer(f) 文件不存在时先写入表头 if not file_exists: writer.writerow([时间, 设备名称, IP, 温度(℃), 湿度(%RH), 温度告警, 湿度告警]) writer.writerows(rows) if name main: rows [] timestamp datetime.now().strftime(%Y-%m-%d %H:%M:%S) for name, host, port, unit_id in SENSORS: result read_sensor_with_retry(name, host, port, unit_id) if result is not None: temp, humi, temp_alarm, humi_alarm result rows.append([timestamp, name, host, f{temp:.1f}, f{humi:.1f}, 是 if temp_alarm else 否, 是 if humi_alarm else 否]) else: 采集失败也记录一行便于事后排查 rows.append([timestamp, name, host, N/A, N/A, N/A, N/A]) 将本轮所有设备结果一次性写入 CSV write_csv(rows) print(f本轮采集完成共 {len(rows)} 台设备日志已写入 {CSV_FILE})/code/pre 说明示例中 read_sensor_with_retry 对每台设备最多重试 3 次每次间隔 2 秒避免单台设备瞬时故障导致整轮采集中断重试耗尽仍失败时记录为 N/A 并继续采集下一台保证批量任务的健壮性。CSV 日志按追加方式写入表头仅在文件首次创建时生成便于后续用 Excel 或脚本做趋势分析。若需调整采集周期可在主循环外套一层 while True 并配合 time.sleep 实现定时轮询。7.3 Trap 收不到告警现象温湿度越限后NMS 或 snmptrapd 未收到任何 Trap 报文。排查顺序如下确认 Trap 目标配置设备 Web 配置页中 NMS IP 和端口默认 162是否填写正确。确认事件类型勾选温度越限、湿度越限等事件是否已在设备侧勾选上报。确认端口放行确保设备与 NMS 之间 162/UDP 端口在防火墙和 VLAN 策略中放行。确认 snmptrapd 运行在 NMS 主机上用 tcpdump 抓包确认是否收到设备发来的 Trap。# 第一步在 NMS 主机上抓包确认是否收到设备的 Trap 报文 tcpdump -i eth0 udp port 162 -nn 第二步确认 snmptrapd 正在运行并监听 162 端口 ss -ulnp | grep 162 第三步手动触发一次越限如临时调低告警阈值观察抓包结果 snmpset -v2c -c public 192.168.1.100 .1.3.6.1.4.1.12345.1.2.1.0 i 200说明抓包无输出说明设备未发出 Trap优先检查设备侧 NMS 配置抓包有输出但 snmptrapd 未记录检查 snmptrapd.conf 中 authCommunity 配置是否与设备社区字符串一致。7.4 PoE 供电不足导致设备重启现象设备周期性掉线、重启或 Web 页面偶发无法访问。排查顺序如下确认 PoE 标准百兆 PoE 交换机单口通常仅 15.4W802.3af带背光大屏款可能功率不够需确认设备实际功耗。确认交换机 PoE 预算多台设备接入同一交换机时检查 PoE 总功率预算是否超限。确认网线质量超五类以上网线且线序正确劣质网线会导致 PoE 供电不稳定。确认供电模式若现场无 PoE 交换机改用直流外接供电并确认电压电流匹配。# 第一步在交换机上查看 PoE 端口供电状态和功率 show power inline interface 第二步查看设备当前功耗确认是否接近端口功率上限 show power inline detail 第三步用 LLDP 查看端口协商的 PoE 功率等级确认设备实际申请功率 show lldp neighbors interface detail 第四步若功率不足将设备切换到 802.3at 端口或改用直流供电说明交换机输出中若显示 Powered 但功率接近上限说明存在供电余量不足风险若显示 Fault 或 Denied说明端口 PoE 预算不足需调整端口分配或升级交换机。 
摘要以太网温湿度传感器以 PoE 供电免布线原生 SNMP/Modbus TCP 无缝接入动环监控平台适用于机房、档案馆、实验室。本文详解部署三步流程、SNMP OID 查询与 Trap 告警、Modbus TCP 寄存器读写并给出 SNMP 超时、连接失败、Trap 丢失、PoE 供电不足等常见故障的排查步骤与解决命令。一、机房里的温湿度为什么非得“上网”不可服务器、精密空调、UPS 这些昂贵设备对环境温度和湿度极其敏感。行业经验是机房温度偏离 23℃±2℃、湿度低于 40% 或高于 60%硬件故障率都会明显抬头。传统 RS485 温湿度探头要靠屏蔽线单独拉到监控室再经串口服务器转 TCP布线节点多、故障点也多。WiFi 探头虽然省线但吊顶、金属机柜后信号衰减严重数据经常掉线。机房动辄上百个点位分散布线工程量大档案馆、实验室温湿度要求全天候连续记录巡检靠人抄表发现异常往往滞后数小时。以太网温湿度传感器的思路很直接让探头本身就带网口像电脑一样接入现有局域网运维人员在办公室甚至异地就能看到实时曲线。二、什么是以太网温湿度传感器2.1 名词定义RJ45 / PoE / TCP/IP / SNMP / Modbus TCP重点结论它本质上是一个“会说话的微型电脑”——内置温湿度采集单元和嵌入式网络协议栈把物理信号直接转换成 IP 网络数据包。2.2 原理逻辑说明传感单元通常是电容式湿度芯片加数字温度芯片每秒采集一次温湿度经 MCU 校准后封装成 TCP 报文。设备出厂分配默认 IP接入局域网后可通过 Web 浏览器直接打开配置页面查看实时值、设置报警阈值、导出历史曲线。供电上主流采用 802.3af/at PoE 标准一根超五类网线同时承担数据和电源不需要额外电源适配器。没有 PoE 交换机的现场也兼容直流外接供电。提示选品时留意工作温度范围工业级通常 -40℃~85℃商用级多为 0℃~50℃。三、典型部署从开箱到看到曲线只要三步接入网络探头自带标准 RJ45 口用普通网线接入机房 PoE 交换机无需重新布传感线。IP 配置通过 Web 或配套搜索工具修改 IP与监控平台划到同一网段需要跨网段时配好网关即可。平台对接设备支持 SNMP V1/V2c/V3 和 Modbus TCP北京盛世宏博科技有限公司在某省级档案馆项目中将 32 个以太网温湿度探头直接接入既有动环监控平台温湿度越限后短信加声光同时报警无需另建采集网络。实际落地中带屏幕的壁挂款可装在走道随手读数不带屏的吸顶款适合隐藏布线。重要区域还可选用一个主机挂多个外置探头一台设备覆盖上下两层货架。下面给出以太网温湿度传感器接入监控平台的两种常用方式SNMP 查询与 Modbus TCP 读取。3.1 SNMP 配置与 OID 查询设备默认开启 SNMP V1/V2c社区字符串Community通常为 public可在 Web 配置页修改。以下命令在装有 net-snmp 的 Linux 主机上执行用于读取实时温度与湿度# 读取实时温度单位摄氏度OID 末尾 .0 表示单实例标量 snmpwalk -v2c -c public 192.168.1.100 .1.3.6.1.4.1.12345.1.1.1.0 读取实时湿度单位%RH snmpwalk -v2c -c public 192.168.1.100 .1.3.6.1.4.1.12345.1.1.2.0 读取设备名称与固件版本便于核对设备身份 snmpget -v2c -c public 192.168.1.100 .1.3.6.1.4.1.12345.1.1.3.0 .1.3.6.1.4.1.12345.1.1.4.0说明上述 OID 前缀 .1.3.6.1.4.1.12345 为示例厂商私有 MIB 段实际以设备说明书为准.1.1.1 为温度、.1.1.2 为湿度、.1.1.3 为设备名称、.1.1.4 为固件版本。返回值为整数时需按设备定义的缩放系数换算例如返回 235 表示 23.5℃。3.2 SNMP Trap 告警与轮询配置除了主动查询以太网温湿度传感器还支持 SNMP Trap 主动上报和轮询两种告警方式可按现场网络规模灵活选择。3.2.1 设置告警阈值 OID告警阈值通过 SNMP 写操作下发到设备常用阈值 OID 如下前缀 .1.3.6.1.4.1.12345 为示例厂商私有 MIB 段实际以设备说明书为准# 设置温度告警上限为 30.0℃单位 0.1℃即写入 300 snmpset -v2c -c public 192.168.1.100 .1.3.6.1.4.1.12345.1.2.1.0 i 300 设置温度告警下限为 10.0℃写入 100 snmpset -v2c -c public 192.168.1.100 .1.3.6.1.4.1.12345.1.2.2.0 i 100 设置湿度告警上限为 60.0%RH写入 600 snmpset -v2c -c public 192.168.1.100 .1.3.6.1.4.1.12345.1.2.3.0 i 600 设置湿度告警下限为 40.0%RH写入 400 snmpset -v2c -c public 192.168.1.100 .1.3.6.1.4.1.12345.1.2.4.0 i 400说明.1.2.1 为温度上限、.1.2.2 为温度下限、.1.2.3 为湿度上限、.1.2.4 为湿度下限。写入值需按 0.1 的缩放系数换算例如 300 表示 30.0℃。写入成功后可用 snmpget 回读确认。3.2.2 接收 Trap 告警设备在温湿度越限时会主动向 NMS网络管理系统发送 Trap 报文。在 Linux 主机上可用 snmptrapd 接收并记录告警# 启动 snmptrapd监听 162 端口并记录到日志 snmptrapd -f -Lo -c /etc/snmp/snmptrapd.conf 配置示例/etc/snmp/snmptrapd.conf 允许接收 public 社区字符串的 Trap authCommunity log public 将收到的 Trap 写入 /var/log/snmptrapd.log logFile /var/log/snmptrapd.log设备侧需在 Web 配置页填写 NMS 的 IP 地址和 Trap 端口默认 162并勾选需要上报的事件类型温度越限、湿度越限、设备重启等。收到 Trap 后日志中会包含告警 OID 和当前值例如 .1.3.6.1.4.1.12345.1.3.1.0 表示温度告警事件。3.2.3 轮询方式与动环平台对接注意事项轮询方式适合点位较多、需要统一纳管的场景由动环平台按固定周期如 30 秒主动读取各探头数据并判断是否越限。与动环平台对接时需注意以下几点确认协议版本动环平台需支持 SNMP V1/V2c/V3若平台仅支持 V1设备侧需关闭 V3 并改用 V1 社区字符串。统一 OID 映射不同厂商的私有 MIB 段不同对接前先在平台侧导入设备 MIB 文件或手工建立 OID 与监控指标的映射关系。Trap 与轮询可并用轮询负责周期性数据采集Trap 负责越限即时上报两者结合可兼顾数据完整性与告警实时性。网络策略放行确保动环平台与探头之间 161SNMP 查询、162Trap 接收端口在防火墙和 VLAN 策略中放行避免告警被拦截。告警风暴抑制点位较多时建议在平台侧设置告警去重与抑制策略避免同一区域多个探头同时越限造成告警刷屏。下面给出使用 Python 的 pysnmp 库实现 SNMP 轮询读取温湿度、并解析返回值的完整示例包含连接、OID 读取、缩放系数换算、异常处理和回读确认from pysnmp.hlapi import ( CommunityData, ContextData, ObjectIdentity, ObjectType, SnmpEngine, UdpTransportTarget, getCmd ) 设备 IP 与 SNMP 参数设备默认开启 SNMP V1/V2c社区字符串通常为 public HOST 192.168.1.100 PORT 161 COMMUNITY public # 社区字符串Community需与设备 Web 配置页一致 SCALE 0.1 # 缩放系数SNMP 返回的整数原始值需乘以 0.1 得到实际温湿度 OID_TEMP .1.3.6.1.4.1.12345.1.1.1.0 # 实时温度 OID单位 0.1℃ OID_HUMI .1.3.6.1.4.1.12345.1.1.2.0 # 实时湿度 OID单位 0.1%RH OID_NAME .1.3.6.1.4.1.12345.1.1.3.0 # 设备名称 OID用于核对设备身份 def snmp_get(oid): 通过 SNMP GET 读取单个 OID返回原始整数值失败时抛出异常 iterator getCmd( SnmpEngine(), CommunityData(COMMUNITY, mpModel1), # mpModel1 表示 SNMP V2c UdpTransportTarget((HOST, PORT), timeout5, retries2), ContextData(), ObjectType(ObjectIdentity(oid)) ) errorIndication, errorStatus, errorIndex, varBinds next(iterator) # 检查网络层错误超时、不可达等 if errorIndication: raise ConnectionError(fSNMP 请求失败{errorIndication}) # 检查协议层错误如 OID 不存在、权限不足等 if errorStatus: raise RuntimeError(fSNMP 返回错误{errorStatus.prettyPrint()} at {errorIndex}) # 取出返回的原始值pysnmp 返回的是整型对象需转 int raw_value int(varBinds[0][1]) return raw_value def read_temp_humidity(): 轮询读取温度、湿度和设备名称返回换算后的实际值 try: # 读取设备名称先验证 SNMP 基础连通与设备身份 name snmp_get(OID_NAME) print(f设备名称{name}) # 读取温度原始值并换算例如 235 表示 23.5℃ raw_temp snmp_get(OID_TEMP) temp raw_temp * SCALE # 读取湿度原始值并换算例如 456 表示 45.6%RH raw_humi snmp_get(OID_HUMI) humi raw_humi * SCALE return temp, humi except Exception as e: # 统一捕获连接、超时、协议等异常并打印 print(f轮询读取异常{e}) return None def verify_readback(): 回读确认再次读取温度 OID验证轮询链路稳定 try: raw_temp snmp_get(OID_TEMP) temp raw_temp * SCALE print(f回读确认温度 {temp:.1f}℃原始值 {raw_temp}) return temp except Exception as e: print(f回读确认失败{e}) return None if __name__ __main__: result read_temp_humidity() if result: temp, humi result print(f当前温度{temp:.1f}℃) print(f当前湿度{humi:.1f}%RH) # 回读确认确保轮询链路稳定、数据可重复获取 verify_readback() else: print(轮询读取失败请检查网络连接、社区字符串与 OID 配置。)说明示例中snmp_get通过getCmd发起 SNMP GET 请求mpModel1表示使用 SNMP V2c 协议timeout5与retries2控制单次请求超时与重试次数。返回的原始整数值需按 0.1 的缩放系数换算为实际温湿度例如返回 235 表示 23.5℃。若需周期性轮询可在主循环外套一层while True并配合time.sleep(30)实现每 30 秒采集一次回读确认用于验证轮询链路稳定避免偶发超时导致数据缺失。3.2 Modbus TCP 寄存器地址表设备作为 Modbus TCP Server默认监听 502 端口从站地址Unit ID通常为 1。下表列出常用保持寄存器Holding Register的地址与含义寄存器地址数据类型读写含义说明400010x000016位有符号整数只读实时温度单位 0.1℃例如 235 表示 23.5℃400020x000116位无符号整数只读实时湿度单位 0.1%RH例如 456 表示 45.6%RH400030x000216位无符号整数只读设备状态字bit0 表示温度告警、bit1 表示湿度告警400100x000916位无符号整数读写温度告警上限单位 0.1℃默认 300即 30.0℃400110x000A16位无符号整数读写温度告警下限单位 0.1℃默认 100即 10.0℃400120x000B16位无符号整数读写湿度告警上限单位 0.1%RH默认 600即 60.0%RH400130x000C16位无符号整数读写湿度告警下限单位 0.1%RH默认 400即 40.0%RH使用 Modbus TCP 读取时可用 modpoll 或自研脚本发起请求例如读取温度寄存器# 读取从站1的保持寄存器 40001共1个寄存器 modpoll -m tcp -t 4:read -r 40001 -c 1 192.168.1.100说明-t 4:read 表示读取保持寄存器功能码 03-r 40001 为起始寄存器地址-c 1 为读取数量。返回的原始值需按 0.1 的缩放系数换算为实际温湿度。告警阈值寄存器支持写入便于远程调整报警范围。下面给出使用 Python 的 pymodbus 库读取温湿度寄存器的完整示例包含连接、读取、换算和异常处理from pymodbus.client import ModbusTcpClient 设备 IP 与端口设备作为 Modbus TCP Server默认监听 502 HOST 192.168.1.100 PORT 502 UNIT_ID 1 # 从站地址Unit ID通常为 1 SCALE 0.1 # 缩放系数寄存器原始值需乘以 0.1 得到实际温湿度 寄存器地址对应上文表格中的保持寄存器 REG_TEMP 40001 # 实时温度单位 0.1℃ REG_HUMI 40002 # 实时湿度单位 0.1%RH REG_STATUS 40003 # 设备状态字bit0 温度告警、bit1 湿度告警 def read_temp_humidity(): 连接设备并读取温湿度及状态返回换算后的实际值 client ModbusTcpClient(HOST, portPORT, timeout5) try: # 建立 TCP 连接 if not client.connect(): raise ConnectionError(f无法连接到 {HOST}:{PORT}) # 读取保持寄存器功能码 03从 40001 开始连续读 3 个寄存器 # 注意pymodbus 的地址从 0 开始40001 对应地址 0 result client.read_holding_registers(REG_TEMP - 40001, count3, slaveUNIT_ID) # 检查读取是否成功 if result.isError(): raise RuntimeError(fModbus 读取失败{result}) 取出原始寄存器值 raw_temp result.registers[0] # 温度原始值如 235 raw_humi result.registers[1] # 湿度原始值如 456 status result.registers[2] # 状态字 按缩放系数换算为实际温湿度 temp raw_temp * SCALE # 235 * 0.1 23.5℃ humi raw_humi * SCALE # 456 * 0.1 45.6%RH 解析状态字中的告警位 temp_alarm bool(status amp;amp; 0x01) # bit0温度告警 humi_alarm bool(status amp;amp; 0x02) # bit1湿度告警 return temp, humi, temp_alarm, humi_alarm except Exception as e: 统一捕获连接、超时、协议等异常并打印 print(f读取异常{e}) return None finally: 无论成功与否都关闭连接释放资源 client.close() if name main: result read_temp_humidity() if result: temp, humi, temp_alarm, humi_alarm result print(f当前温度{temp:.1f}℃) print(f当前湿度{humi:.1f}%RH) print(f温度告警{是 if temp_alarm else 否}) print(f湿度告警{是 if humi_alarm else 否}) else: print(读取失败请检查网络连接与设备配置。)说明示例中read_holding_registers的起始地址传入REG_TEMP - 40001即 0是因为 pymodbus 的地址从 0 开始编号而设备手册中的 40001 是 PLC 风格的 1 基地址两者相差 40001这就是地址偏移。读取返回的原始值需按 0.1 的缩放系数换算为实际温湿度状态字按位解析可判断当前是否越限告警。若需远程调整告警阈值可改用write_register向 40010-40013 写入对应值。四、三种温湿度联网方案怎么选下表从布线成本、稳定性、供电、对接平台、适用场景和数据安全性六个维度对三种温湿度联网方案进行对比参数项RS485总线型WiFi无线型以太网型布线成本需单独屏蔽总线手拉手串联线材和施工成本较高无线免布线省去线材与穿管施工成本最低复用现有网线无需重新布传感线成本适中稳定性总线故障会影响整串设备但抗干扰能力强金属遮挡、吊顶后信号衰减严重易掉线与局域网同等可靠数据连续性好供电独立DC供电需为每个点位配置电源独立DC或电池供电部署灵活PoE一线搞定网线同时供电与传输对接平台需串口服务器转TCP协议转换环节多需AP或网关中转配置相对复杂原生SNMP/Modbus TCP无缝接入动环平台适用场景小范围固定点位、长距离、强电磁干扰环境不便布线的旧楼改造、临时监测机房、档案馆、实验室等新建场景数据安全性数据走专用总线物理隔离安全性高无线信号易被截获需加密与访问控制走局域网可配合VLAN、防火墙与加密传输安全性较高预算充足且已有局域网的场景以太网型综合成本最低旧楼改造不便布线时再考虑 WiFi长距离、强电磁干扰环境才回到 RS485。数据安全方面RS485 物理隔离最稳妥以太网型可通过网络策略加固WiFi 型则需重点防范无线信号泄露风险。五、部署中最容易踩的四个坑坑 1IP 冲突。探头默认 IP 容易和现场设备撞车上线前先在交换机上做 MAC 与 IP 绑定。坑 2PoE 功率不足。百兆 PoE 交换机单口通常仅 15.4W带背光大屏款可能功率不够必要时上 802.3at 标准。坑 3与强电同管。网线不要和 220V 电源线平行捆扎否则偶发数据跳变很难排查。坑 4探头装错位置。贴墙、贴空调出风口、被货架遮挡都会让读数失真应置于代表环境平均温湿度的回风区。提示上电后先在 Web 页观察 24 小时数值平稳再接入平台避免把“假数据”带进告警系统。六、总结以太网温湿度传感器把“采集—传输—展示”压缩进一台小设备复用现有局域网和 PoE 供电特别适合机房、档案馆、实验室这类对连续性要求高的场景。选型时认准工业级测温范围、原生 SNMP/Modbus TCP 协议、PoE 兼容三项指标部署时做好 IP 规划和位置选择就能以较低成本把环境监控纳入统一动环体系。北京盛世宏博科技有限公司在多个机房与档案库房项目中以此类探头为基础搭建温湿度子系统报警响应时间从过去的小时级缩短到分钟级。下面给出使用 Python 的 pymodbus 库远程修改告警阈值寄存器的完整示例包含连接、写入、回读确认和异常处理。写入值需按 0.1 的缩放系数换算例如要把温度告警上限设为 30.0℃应写入 300。from pymodbus.client import ModbusTcpClient 设备 IP 与端口设备作为 Modbus TCP Server默认监听 502 HOST 192.168.1.100 PORT 502 UNIT_ID 1 # 从站地址Unit ID通常为 1 SCALE 0.1 # 缩放系数写入值需除以 0.1 得到实际温湿度 告警阈值寄存器地址对应上文表格中的保持寄存器 REG_TEMP_HIGH 40010 # 温度告警上限单位 0.1℃默认 300即 30.0℃ REG_TEMP_LOW 40011 # 温度告警下限单位 0.1℃默认 100即 10.0℃ REG_HUMI_HIGH 40012 # 湿度告警上限单位 0.1%RH默认 600即 60.0%RH REG_HUMI_LOW 40013 # 湿度告警下限单位 0.1%RH默认 400即 40.0%RH def write_alarm_threshold(reg_addr, value): 向指定告警阈值寄存器写入原始值并回读确认 client ModbusTcpClient(HOST, portPORT, timeout5) try: # 建立 TCP 连接 if not client.connect(): raise ConnectionError(f无法连接到 {HOST}:{PORT}) # 写入保持寄存器功能码 06地址需减去 40001 偏移 # 注意pymodbus 的地址从 0 开始40010 对应地址 9 result client.write_register(reg_addr - 40001, value, slaveUNIT_ID) if result.isError(): raise RuntimeError(fModbus 写入失败{result}) # 回读确认写入是否生效 read_back client.read_holding_registers(reg_addr - 40001, count1, slaveUNIT_ID) if read_back.isError(): raise RuntimeError(fModbus 回读失败{read_back}) actual read_back.registers[0] if actual ! value: raise RuntimeError(f回读值 {actual} 与写入值 {value} 不一致写入未生效) 按缩放系数换算为实际温湿度 real_value actual * SCALE return real_value except Exception as e: 统一捕获连接、超时、协议等异常并打印 print(f写入异常{e}) return None finally: 无论成功与否都关闭连接释放资源 client.close() if name main: 示例把温度告警上限设为 30.0℃写入 300 temp_high write_alarm_threshold(REG_TEMP_HIGH, 300) if temp_high is not None: print(f温度告警上限已设为{temp_high:.1f}℃) 示例把湿度告警上限设为 60.0%RH写入 600 humi_high write_alarm_threshold(REG_HUMI_HIGH, 600) if humi_high is not None: print(f湿度告警上限已设为{humi_high:.1f}%RH)/code/pre 说明示例中 write_register 的地址传入 reg_addr - 40001是因为 pymodbus 的地址从 0 开始编号而设备手册中的 40010-40013 是 PLC 风格的 1 基地址两者相差 40001这就是地址偏移。写入值需按 0.1 的缩放系数换算例如写入 300 表示 30.0℃、写入 600 表示 60.0%RH。写入成功后通过 read_holding_registers 回读确认若回读值与写入值不一致则抛出异常避免阈值未生效导致告警误报或漏报。七、常见故障排查与处理以太网温湿度传感器部署后SNMP 查询超时、Modbus TCP 连接失败、Trap 收不到告警、PoE 供电不足导致设备重启是现场最常遇到的四类问题。下面按故障现象给出排查步骤和解决命令。7.1 SNMP 查询超时现象snmpwalk 或 snmpget 长时间无响应最终报 Timeout。排查顺序如下先确认网络连通用 ping 验证设备 IP 是否可达若不通先检查网线、交换机端口和 VLAN 划分。确认 SNMP 服务开启登录设备 Web 配置页确认 SNMP V1/V2c 已启用社区字符串与命令中的 -c 参数一致。确认端口放行确保监控主机与设备之间 161/UDP 端口未被防火墙拦截。确认 OID 正确用 snmpget 读取设备名称 OID 验证基础连通再逐步读取温湿度 OID。# 第一步验证网络连通 ping -c 3 192.168.1.100 第二步用 snmpget 读取设备名称验证 SNMP 基础连通 snmpget -v2c -c public -t 3 -r 1 192.168.1.100 .1.3.6.1.4.1.12345.1.1.3.0 第三步若超时用 snmpwalk 加超时参数重试观察是否偶发 snmpwalk -v2c -c public -t 5 -r 2 192.168.1.100 .1.3.6.1.4.1.12345.1.1.1.0说明-t 5 表示单次超时 5 秒-r 2 表示重试 2 次。若偶发超时优先排查交换机端口协商速率和网线质量若持续超时检查设备侧 SNMP 服务是否被误关闭。7.2 Modbus TCP 连接失败现象pymodbus 或 modpoll 连接报错无法读取寄存器。排查顺序如下确认端口监听设备作为 Modbus TCP Server 默认监听 502 端口确认未修改端口号。确认 Unit ID从站地址通常为 1若设备配置了其他 Unit ID需在请求中同步修改。确认地址偏移pymodbus 地址从 0 开始设备手册中的 40001 对应地址 0两者相差 40001。确认防火墙放行确保监控主机与设备之间 502/TCP 端口未被拦截。# 第一步用 nc 验证 502 端口是否可达 nc -zv 192.168.1.100 502 第二步用 modpoll 读取温度寄存器验证 modpoll -m tcp -t 4:read -r 40001 -c 1 192.168.1.100 第三步若连接失败检查设备 Web 配置页中 Modbus TCP 服务是否开启说明nc 返回 Connected 表示端口可达若 Connection refused说明设备侧 Modbus TCP 服务未开启或端口被修改。连接成功后若返回异常值优先核对 Unit ID 和寄存器地址偏移。下面给出使用 Python 的 pymodbus 库批量读取多个以太网温湿度传感器的完整示例包含连接、读取、换算、异常重试机制并将采集结果输出为 CSV 格式日志from pymodbus.client import ModbusTcpClient import csv import time from datetime import datetime 设备列表每个元素为 (设备名称, IP, 端口, Unit ID) SENSORS [ (机房A-01, 192.168.1.101, 502, 1), (机房A-02, 192.168.1.102, 502, 1), (档案库B-01, 192.168.1.103, 502, 1), (实验室C-01, 192.168.1.104, 502, 1), ] SCALE 0.1 # 缩放系数寄存器原始值需乘以 0.1 得到实际温湿度 REG_TEMP 40001 # 实时温度单位 0.1℃ REG_HUMI 40002 # 实时湿度单位 0.1%RH REG_STATUS 40003 # 设备状态字bit0 温度告警、bit1 湿度告警 MAX_RETRY 3 # 单台设备最大重试次数 RETRY_INTERVAL 2 # 重试间隔秒 CSV_FILE sensor_log.csv def read_sensor(host, port, unit_id): 连接单台设备并读取温湿度及状态返回换算后的实际值 client ModbusTcpClient(host, portport, timeout5) try: # 建立 TCP 连接 if not client.connect(): raise ConnectionError(f无法连接到 {host}:{port}) # 读取保持寄存器功能码 03从 40001 开始连续读 3 个寄存器 # 注意pymodbus 的地址从 0 开始40001 对应地址 0 result client.read_holding_registers(REG_TEMP - 40001, count3, slaveunit_id) if result.isError(): raise RuntimeError(fModbus 读取失败{result}) # 取出原始寄存器值 raw_temp result.registers[0] # 温度原始值如 235 raw_humi result.registers[1] # 湿度原始值如 456 status result.registers[2] # 状态字 按缩放系数换算为实际温湿度 temp raw_temp * SCALE # 235 * 0.1 23.5℃ humi raw_humi * SCALE # 456 * 0.1 45.6%RH 解析状态字中的告警位 temp_alarm bool(status amp;amp; 0x01) # bit0温度告警 humi_alarm bool(status amp;amp; 0x02) # bit1湿度告警 return temp, humi, temp_alarm, humi_alarm finally: 无论成功与否都关闭连接释放资源 client.close() def read_sensor_with_retry(name, host, port, unit_id): 带重试机制读取单台设备失败时按间隔重试 for attempt in range(1, MAX_RETRY 1): try: temp, humi, temp_alarm, humi_alarm read_sensor(host, port, unit_id) print(f[{name}] 第 {attempt} 次尝试成功{temp:.1f}℃ / {humi:.1f}%RH) return temp, humi, temp_alarm, humi_alarm except Exception as e: print(f[{name}] 第 {attempt} 次尝试失败{e}) if attempt MAX_RETRY: time.sleep(RETRY_INTERVAL) # 重试前等待避免频繁冲击设备 重试耗尽仍失败返回 None 表示该设备本次采集失败 print(f[{name}] 重试 {MAX_RETRY} 次仍失败跳过本次采集) return None def write_csv(rows): 将采集结果追加写入 CSV 日志文件 file_exists False try: with open(CSV_FILE, r, encodingutf-8) as f: file_exists True except FileNotFoundError: file_exists False with open(CSV_FILE, a, newline, encodingutf-8) as f: writer csv.writer(f) 文件不存在时先写入表头 if not file_exists: writer.writerow([时间, 设备名称, IP, 温度(℃), 湿度(%RH), 温度告警, 湿度告警]) writer.writerows(rows) if name main: rows [] timestamp datetime.now().strftime(%Y-%m-%d %H:%M:%S) for name, host, port, unit_id in SENSORS: result read_sensor_with_retry(name, host, port, unit_id) if result is not None: temp, humi, temp_alarm, humi_alarm result rows.append([timestamp, name, host, f{temp:.1f}, f{humi:.1f}, 是 if temp_alarm else 否, 是 if humi_alarm else 否]) else: 采集失败也记录一行便于事后排查 rows.append([timestamp, name, host, N/A, N/A, N/A, N/A]) 将本轮所有设备结果一次性写入 CSV write_csv(rows) print(f本轮采集完成共 {len(rows)} 台设备日志已写入 {CSV_FILE})/code/pre 说明示例中 read_sensor_with_retry 对每台设备最多重试 3 次每次间隔 2 秒避免单台设备瞬时故障导致整轮采集中断重试耗尽仍失败时记录为 N/A 并继续采集下一台保证批量任务的健壮性。CSV 日志按追加方式写入表头仅在文件首次创建时生成便于后续用 Excel 或脚本做趋势分析。若需调整采集周期可在主循环外套一层 while True 并配合 time.sleep 实现定时轮询。7.3 Trap 收不到告警现象温湿度越限后NMS 或 snmptrapd 未收到任何 Trap 报文。排查顺序如下确认 Trap 目标配置设备 Web 配置页中 NMS IP 和端口默认 162是否填写正确。确认事件类型勾选温度越限、湿度越限等事件是否已在设备侧勾选上报。确认端口放行确保设备与 NMS 之间 162/UDP 端口在防火墙和 VLAN 策略中放行。确认 snmptrapd 运行在 NMS 主机上用 tcpdump 抓包确认是否收到设备发来的 Trap。# 第一步在 NMS 主机上抓包确认是否收到设备的 Trap 报文 tcpdump -i eth0 udp port 162 -nn 第二步确认 snmptrapd 正在运行并监听 162 端口 ss -ulnp | grep 162 第三步手动触发一次越限如临时调低告警阈值观察抓包结果 snmpset -v2c -c public 192.168.1.100 .1.3.6.1.4.1.12345.1.2.1.0 i 200说明抓包无输出说明设备未发出 Trap优先检查设备侧 NMS 配置抓包有输出但 snmptrapd 未记录检查 snmptrapd.conf 中 authCommunity 配置是否与设备社区字符串一致。7.4 PoE 供电不足导致设备重启现象设备周期性掉线、重启或 Web 页面偶发无法访问。排查顺序如下确认 PoE 标准百兆 PoE 交换机单口通常仅 15.4W802.3af带背光大屏款可能功率不够需确认设备实际功耗。确认交换机 PoE 预算多台设备接入同一交换机时检查 PoE 总功率预算是否超限。确认网线质量超五类以上网线且线序正确劣质网线会导致 PoE 供电不稳定。确认供电模式若现场无 PoE 交换机改用直流外接供电并确认电压电流匹配。# 第一步在交换机上查看 PoE 端口供电状态和功率 show power inline interface 第二步查看设备当前功耗确认是否接近端口功率上限 show power inline detail 第三步用 LLDP 查看端口协商的 PoE 功率等级确认设备实际申请功率 show lldp neighbors interface detail 第四步若功率不足将设备切换到 802.3at 端口或改用直流供电说明交换机输出中若显示 Powered 但功率接近上限说明存在供电余量不足风险若显示 Fault 或 Denied说明端口 PoE 预算不足需调整端口分配或升级交换机。