AN-306 LoRaWAN 雷达存在感应传感器用户手册

设备信息:型号 AN-306,devEui ffffff100004bd16,网关 IP 192.168.31.193,Modbus Slave ID 7,BACnet Device ID 106

1 协议概览

AN-306 在 Fport 210 上报雷达存在状态、雷达事件、电池电压、防拆状态及信号质量。

1.1 上行数据协议(Fport 210)

载荷格式(Fport 210):

字节位置 字段 说明
0 保留 固定 0x00(协议版本)
1 … N TLV 对 [Type(1 B)][Value(N B)] … 循环至结束

每个 Type 字节决定字段名称和后续 value 字节数:

Type Value字节数 字段名称 编码方式 换算 单位 说明
0x01 1 model uint8 型号码 = 0x44
0x6D 1 packetType uint8 0x00=心跳 0x01=数据上报
0x77 1 tamperState uint8 0=正常 1=防拆
0xBD 1 presenceStatus uint8 0=无人 1=有人(状态)
0xBE 1 presenceEvent uint8 0=无事件 1=存在感应事件
0x03 1 tamperEvent uint8 0=正常 1=防拆事件

JavaScript 解码示例:

// AN-306 Radar Presence Sensor — Fport 210 uplink decoder
function decodeUplink(bytes) {
  var i = 1, r = {};
  while (i < bytes.length) {
    var t = bytes[i++];
    switch (t) {
      case 0x01: r.model         = bytes[i++]; break;
      case 0x03: r.tamperEvent   = bytes[i++]; break;
      case 0x6D: r.packetType    = bytes[i++]; break;
      case 0x77: r.tamperState   = bytes[i++]; break;
      case 0xBD: r.presenceStatus= bytes[i++]; break; // 0=no person  1=person
      case 0xBE: r.presenceEvent = bytes[i++]; break; // 0=no event  1=event
      default:   i++; break;
    }
  }
  return r;
}
// Example payload (hex): 00 01 44 6D 01 77 00 BD 01 BE 01
// → { model:68, packetType:1, tamperState:0, presenceStatus:1, presenceEvent:1 }

脚本下载:LPP.zip

版本说明: LPP.js 基于 ChirpStack v4.17.0 开发和测试。不同版本的 ChirpStack JavaScript 编解码器 API 可能存在差异——如果您使用的是其他版本,请在部署前检查并根据需要调整脚本。

2 获取上行数据

⚠️ 以下示例中的 IP 地址(192.168.31.205 / 192.168.31.193)、ChirpStack API token、Slave ID、BACnet Device ID 及 devEui 均为演示示例,请替换为实际网关 IP、ChirpStack API token 及设备参数。

2.1 ChirpStack MQTT 订阅

订阅 MQTT topic 以接收实时上行数据:

应用 ID3ef9e6b9-ec54-4eda-86b8-a5fb46899f39 是网关内置的出厂默认 ChirpStack 应用。
如果您创建了其他应用,请替换为实际的应用 ID。

网关 IP192.168.31.193 为示例网关 WAN 口 IP,
请替换为您实际的网关 IP 地址。

设备 EUIffffff100004bd16 为示例设备 EUI,
请替换为网关设备列表中显示的实际 EUI;
也可用 + 通配符一次订阅所有设备的数据。
# 订阅指定设备
mosquitto_sub -h 192.168.31.193 -p 1883 \
  -u gateway -P mqtt88888888 \
  -t "application/3ef9e6b9-ec54-4eda-86b8-a5fb46899f39/device/ffffff100004bd16/event/up"

# 订阅所有应用下所有设备(通配符)
mosquitto_sub -h 192.168.31.193 -p 1883 \
  -u gateway -P mqtt88888888 \
  -t "application/+/device/+/event/up"

上行数据载荷示例(JSON):

{
  "devEui": "ffffff100004bd16",
  "fPort": 210,
  "object": {
    ...  (已解码的 LPP 字段)
  }
}

2.2 IoT Hub HTTP API

发送 GET 请求获取设备最新状态:

curl -s "http://192.168.31.193:8070/api/getStatus?devEui=ffffff100004bd16"
{
  "success": true,
  "result": {
    "presence": false,
    "tamper": 0,
    "presenceEvent": 0,
    "isHeartbeat": false,
    "model": "AN-306"
  }
}

2.3 IoT Hub Modbus TCP — Python 脚本

脚本下载:modbus_tcp_read.py

使用 modbus_tcp_read.py 一次性读取所有寄存器:

python3 modbus_tcp_read.py --ip 192.168.31.193 --port 502 \
    --slaveId 7 --sensorType AN-306
Target: 192.168.31.193:502 | Slave ID: 7 | Sensor: AN-306
================================================================================================================================================================
Attribute                | Addr   | FC  | Format     | Order        | Cnt | Scale    | Raw(Hex)            | Value              | Unit
----------------------------------------------------------------------------------------------------------------------------------------------------------------
online                   | 6      | 03  | Bit/Bool   | Big(ABCD)    | 1   | x1       | 0001                | true               | none
lastOnlineTime           | 7      | 03  | UnixTime   | Big(ABCD)    | 2   | x1       | 69CC CEC5           | 1775029957         | second
presence                 | 9      | 03  | Bit/Bool   | Big(ABCD)    | 1   | x1       | 0000                | false              | none
tamper                   | 10     | 03  | Int16      | Big(ABCD)    | 1   | x1       | 0000                | 0.0                | none
presenceEvent            | 11     | 03  | Int16      | Big(ABCD)    | 1   | x1       | 0000                | 0.0                | none
tamperEvent              | 12     | 03  | Int16      | Big(ABCD)    | 1   | x1       | 0000                | 0.0                | none
isHeartbeat              | 13     | 03  | Bit/Bool   | Big(ABCD)    | 1   | x1       | 0000                | false              | none
model                    | 38     | 03  | String(24B) | ASCII        | 12  | x1       | 414E 2D33 3036 0000 ... | AN-306             | none
rssi                     | 50     | 03  | Int16      | Big(ABCD)    | 1   | x1       | FFC1                | -63.0              | none
snr                      | 51     | 03  | Int16      | Big(ABCD)    | 1   | x1       | 000D                | 13.0               | none

2.4 IoT Hub Modbus TCP — Modbus Poll

工具下载:Modbus Poll 9.5.0.1507.zip

  1. 打开 Modbus Poll,连接 192.168.31.193:502,Slave ID 7
  2. 菜单 Setup → Read/Write Definition,功能码选 FC03,起始地址 6,长度 46
  3. 点击 OK — 数值实时刷新

2.5 IoT Hub BACnet BIP — Python 脚本

脚本下载:bacnet_read.py

使用 bacnet_read.py 读取所有 BACnet 对象:

python3 bacnet_read.py --ip 192.168.31.193 --port 47808 --id 106
Target: 192.168.31.193:47808 | BACnet ID: 106 | Scan: 10600-10699
------------------------------------------------------------
Type | Instance | Offset | Value                    | Object Name
------------------------------------------------------------
BI   | 10602    | 2      | active                   | ffffff100004bd16.online
AI   | 10603    | 3      | 1775030016.00            | ffffff100004bd16.lastOnlineTime
BI   | 10604    | 4      | inactive                 | ffffff100004bd16.presence
AI   | 10605    | 5      | 0.00                     | ffffff100004bd16.tamper
AI   | 10606    | 6      | 0.00                     | ffffff100004bd16.presenceEvent
AI   | 10607    | 7      | 0.00                     | ffffff100004bd16.tamperEvent
BI   | 10608    | 8      | inactive                 | ffffff100004bd16.isHeartbeat
CV   | 10612    | 12     | AN-306                   | ffffff100004bd16.model
AI   | 10613    | 13     | -63.00                   | ffffff100004bd16.rssi
AI   | 10614    | 14     | 13.00                    | ffffff100004bd16.snr

2.6 IoT Hub BACnet BIP — YABE

工具下载:SetupYabe_v2.1.0.exe

  1. 打开 YABE,连接 192.168.31.193:47808
  2. 在设备树中展开设备 106
  3. 浏览 AI/BI/AV/BV/CV 对象,查看实时数值