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 以接收实时上行数据:
应用 ID —3ef9e6b9-ec54-4eda-86b8-a5fb46899f39是网关内置的出厂默认 ChirpStack 应用。
如果您创建了其他应用,请替换为实际的应用 ID。
网关 IP —192.168.31.193为示例网关 WAN 口 IP,
请替换为您实际的网关 IP 地址。
设备 EUI —ffffff100004bd16为示例设备 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
- 打开 Modbus Poll,连接
192.168.31.193:502,Slave ID7 - 菜单 Setup → Read/Write Definition,功能码选 FC03,起始地址
6,长度46 - 点击 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
- 打开 YABE,连接
192.168.31.193:47808 - 在设备树中展开设备 106
- 浏览 AI/BI/AV/BV/CV 对象,查看实时数值