多协议传感设备调试：以太网温湿度变送器 SNMP、TCP 通讯实战

□ 设备是否有 Web 管理界面？（浏览器访问 IP）
□ SNMP 功能是否默认开启？（查看 Web 界面或说明书）
□ SNMP 版本支持：v1 / v2c / v3？（多数设备只支持 v2c）
□ 社区名（Community）：默认 public？还是自定义？
□ SNMP 端口：默认 161？是否可修改？
□ Modbus TCP 端口：默认 502？是否可修改？
□ 两种协议是否共享同一 IP 和端口？还是独立端口？
□ 设备是否有 MIB 文件？（.mib 或 .txt 格式）

第 1 步：确认 SNMP Agent 已启用
  → 浏览器登录设备 Web 界面
  → 找到 SNMP 配置页面
  → 确认 "Enable SNMP" 已勾选
  → 记录社区名、SNMP 版本、端口号

第 2 步：从命令行测试基础连通性
  → snmpwalk -v 2c -c public IP 1.3.6.1.2.1.1.1
  → 如果返回系统描述信息，说明 SNMP 基本正常

第 3 步：找到温湿度 OID
  → 用 snmpwalk 遍历整个 MIB 树
  → 或查阅设备 MIB 文件，找到温度/湿度对应的 OID

第 4 步：验证数据正确性
  → 对比 SNMP 读取值与 Modbus TCP 读取值
  → 确认缩放因子、数据类型一致

# 安装（Ubuntu/Debian）
apt install snmp snmp-mibs-downloader

# 基础查询
snmpget -v 2c -c public 192.168.100.50 1.3.6.1.2.1.1.1.0
# 返回：系统描述（设备型号、固件版本等）

# 遍历子树
snmpwalk -v 2c -c public 192.168.100.50 1.3.6.1.4.1

# 指定 MIB 文件
snmptranslate -Td -m ./device.mib TEMP-SENSOR-MIB::temperature

# 批量查询
for oid in 1.3.6.1.4.1.50001.1.1.1 1.3.6.1.4.1.50001.1.1.2; do
    snmpget -v 2c -c public 192.168.100.50 $oid
done

# 持续监控（每 5 秒查询一次）
while true; do
    snmpget -v 2c -c public 192.168.100.50 1.3.6.1.4.1.50001.1.1.1.0
    sleep 5
done

from pysnmp.hlapi import *

def snmp_get(ip, community, oid):
    """SNMP GET 单个 OID"""
    iterator = getCmd(
        SnmpEngine(),
        CommunityData(community),
        UdpTransportTarget((ip, 161), timeout=2.0, retries=2),
        ContextData(),
        ObjectType(ObjectIdentity(oid))
    )
    
    errorIndication, errorStatus, errorIndex, varBinds = next(iterator)
    
    if errorIndication:
        print(f"SNMP 错误: {errorIndication}")
        return None
    elif errorStatus:
        print(f"SNMP 状态错误: {errorStatus.prettyPrint()}")
        return None
    else:
        for varBind in varBinds:
            return varBind[1].prettyPrint()

# 示例：读取温度和湿度
ip = "192.168.100.50"
community = "public"

# 假设 OID（需根据实际 MIB 替换）
temp_oid = "1.3.6.1.4.1.50001.1.1.1.0"
humid_oid = "1.3.6.1.4.1.50001.1.1.2.0"

temp = snmp_get(ip, community, temp_oid)
humid = snmp_get(ip, community, humid_oid)

print(f"温度: {temp} ℃")
print(f"湿度: {humid} %RH")

第 1 步：确认 TCP 502 端口可达
  → nc -zv IP 502
  → 或 telnet IP 502

第 2 步：用 Modbus Poll 读取寄存器
  → 连接 → TCP/IP → 输入 IP、端口 502
  → 设置从站 ID、功能码 03、起始地址、数量
  → 观察数据

第 3 步：验证数据格式
  → 确认寄存器类型（INT16/UINT16/INT32/Float）
  → 确认字节序（ABCD/CDAB/BADC/DCBA）
  → 确认缩放因子（×0.1 / ×0.01 / 无）

第 4 步：Python 脚本批量验证
  → 用 pymodbus 读取，自动对比预期值

import asyncio
from pymodbus.client import AsyncModbusTcpClient

async def read_sensor(ip, port=502, slave_id=1):
    client = AsyncModbusTcpClient(ip, port=port, timeout=2.0)
    await client.connect()
    
    if not client.connected:
        print(f"❌ {ip} 连接失败")
        return
    
    # 读取保持寄存器 0-3（温度、湿度、PM2.5、压差）
    resp = await client.read_holding_registers(0, count=4, slave=slave_id)
    
    if resp.isError():
        print(f"❌ {ip} 读取失败: {resp}")
    else:
        temp = resp.registers[0] * 0.1
        humid = resp.registers[1] * 0.1
        pm25 = resp.registers[2]
        pressure = resp.registers[3]
        print(f"✅ {ip}:")
        print(f"   温度: {temp} ℃")
        print(f"   湿度: {humid} %RH")
        print(f"   PM2.5: {pm25} μg/m³")
        print(f"   压差: {pressure} Pa")
    
    await client.close()

# 批量读取
async def batch_read(ips):
    for ip in ips:
        await read_sensor(ip)

ips = ["192.168.100.50", "192.168.100.51", "192.168.100.52"]
asyncio.run(batch_read(ips))

import asyncio
from pymodbus.client import AsyncModbusTcpClient
from pysnmp.hlapi import *

async def compare_protocols(ip, snmp_community, modbus_port=502, slave_id=1):
    """对比 SNMP 和 Modbus TCP 读到的数据"""
    print(f"\n{'='*50}")
    print(f"设备: {ip}")
    print(f"{'='*50}")
    
    # Modbus TCP 读取
    mb_client = AsyncModbusTcpClient(ip, port=modbus_port, timeout=2.0)
    await mb_client.connect()
    
    if mb_client.connected:
        mb_resp = await mb_client.read_holding_registers(0, count=2, slave=slave_id)
        if not mb_resp.isError():
            mb_temp = mb_resp.registers[0] * 0.1
            mb_humid = mb_resp.registers[1] * 0.1
            print(f"Modbus TCP: 温度={mb_temp}℃, 湿度={mb_humid}%RH")
        else:
            print("Modbus TCP: 读取失败")
            mb_temp, mb_humid = None, None
    else:
        print("Modbus TCP: 连接失败")
        mb_temp, mb_humid = None, None
    
    await mb_client.close()
    
    # SNMP 读取（同步方式，简化示例）
    # 实际使用时需要安装 pysnmp 并配置正确的 OID
    print("SNMP: 需要配置正确的 OID（参考设备 MIB 文件）")
    print("  请手动执行: snmpwalk -v 2c -c public IP 1.3.6.1.4.1")
    
    # 如果两种协议都成功，对比数据
    if mb_temp is not None:
        print(f"\n数据对比提示:")
        print(f"  Modbus 温度: {mb_temp}℃")
        print(f"  SNMP 温度: 请手动对比")
        print(f"  偏差应 < 0.5℃（传感器自身精度）")

# 运行对比
ips = ["192.168.100.50"]
for ip in ips:
    asyncio.run(compare_protocols(ip, "public"))

步骤 1：创建主机
  → 配置 → 主机 → 创建主机
  → 主机名称: Sensor-A01
  → 群组: Temperature Sensors
  → 接口: SNMP, IP 地址, 端口 161

步骤 2：配置 SNMP 社区
  → 宏 → 创建宏
  → 宏: {$SNMP_COMMUNITY}
  → 值: public

步骤 3：创建监控项
  → 监控项 → 创建监控项
  → 名称: 温度
  → 类型: SNMPv2 代理
  → 键值: sensor.temp
  → SNMP OID: 1.3.6.1.4.1.50001.1.1.1.0
  → 信息类型: 数字（浮点数）
  → 单位: ℃
  → 更新间隔: 30s

步骤 4：创建触发器
  → 触发器 → 创建触发器
  → 名称: 温度过高
  → 表达式: last(/Sensor-A01/sensor.temp) > 30
  → 严重性: 警告

步骤 5：创建图形
  → 图形 → 创建图形
  → 名称: 温湿度趋势
  → 添加监控项: 温度、湿度

方法 1：使用 Zabbix 内置的 Modbus 监控项（Zabbix 5.0+）
  → 监控项类型: Modbus
  → 端点: tcp://192.168.100.50:502
  → 从站 ID: 1
  → 寄存器类型: Holding register
  → 寄存器地址: 0
  → 数据类型: INT16
  → 转换: ×0.1

方法 2：使用外部脚本（Zabbix agent + Python）
  → 编写 Python 脚本读取 Modbus TCP
  → Zabbix agent 调用脚本
  → 返回 JSON 格式数据

# 同时抓 SNMP（UDP 161）和 Modbus TCP（TCP 502）
tcp port 502 or udp port 161

# SNMP 请求和响应
snmp

# Modbus TCP 请求和响应
modbus

# 同时看两种协议
tcp.port == 502 || udp.port == 161

# 按设备 IP 过滤
ip.addr == 192.168.100.50 && (tcp.port == 502 || udp.port == 161)