JTY-AN-503A LoRaWAN 烟感探测器用户手册
设备信息：型号 JTY-AN-503A，devEui ffffff100004e970，网关 IP 192.168.31.205，Modbus Slave ID 5，BACnet Device ID 104
1 协议概览
JTY-AN-503A 在 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 | — | — | 型号码 = 0x51 |
0x84 |
1 | smokeStatus |
uint8 | — | — | 0=正常 1=烟雾报警（状态） |
0x31 |
1 | smokeEvent |
uint8 | — | — | 0=正常 1=烟雾事件 |
0x10 |
2 | temperature |
int16 BE | ÷100 | °C | 如 0x09F6=2550 → 25.50 °C |
0x77 |
1 | tamperState |
uint8 | — | — | 0=正常 1=防拆 |
0x82 |
1 | selfCheckEvent |
uint8 | — | — | 0=正常 1=自检事件 |
0x04 |
2 | batteryVoltage |
uint16 BE | ÷1000 | V | mV 原始值 ÷1000 = V |
0x05 |
1 | batteryLowEvent |
uint8 | — | — | 0=正常 1=低电压事件 |
JavaScript 解码示例：
// JTY-AN-503A Smoke Detector — Fport 210 uplink decoder
function decodeUplink(bytes) {
var i = 1, r = {};
function u16(b,o){ return (b[o]<<8)|b[o+1]; }
function i16(b,o){ var v=u16(b,o); return v>32767?v-65536:v; }
while (i < bytes.length) {
var t = bytes[i++];
switch (t) {
case 0x01: r.model = bytes[i++]; break;
case 0x04: r.batteryVoltage = u16(bytes,i)/1000; i+=2; break;
case 0x05: r.batteryLowEvent = bytes[i++]; break;
case 0x10: r.temperature = i16(bytes,i)/100; i+=2; break;
case 0x31: r.smokeEvent = bytes[i++]; break; // 0=normal 1=alarm
case 0x77: r.tamperState = bytes[i++]; break;
case 0x82: r.selfCheckEvent = bytes[i++]; break;
case 0x84: r.smokeStatus = bytes[i++]; break; // 0=normal 1=alarm
default: i++; break;
}
}
return r;
}
// Example payload (hex): 00 01 51 84 00 31 00 10 09 B8 77 00
// → { model:81, smokeStatus:0, smokeEvent:0, temperature:25.04, tamperState:0 }脚本下载：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.205为示例网关 WAN 口 IP，
请替换为您实际的网关 IP 地址。
设备 EUI —ffffff100004e970为示例设备 EUI，
请替换为网关设备列表中显示的实际 EUI；
也可用+通配符一次订阅所有设备的数据。
# 订阅指定设备
mosquitto_sub -h 192.168.31.205 -p 1883 \
-u gateway -P mqtt88888888 \
-t "application/3ef9e6b9-ec54-4eda-86b8-a5fb46899f39/device/ffffff100004e970/event/up"
# 订阅所有应用下所有设备（通配符）
mosquitto_sub -h 192.168.31.205 -p 1883 \
-u gateway -P mqtt88888888 \
-t "application/+/device/+/event/up"上行数据载荷示例（JSON）：
{
"devEui": "ffffff100004e970",
"fPort": 210,
"object": {
... (已解码的 LPP 字段)
}
}2.2 IoT Hub HTTP API
发送 GET 请求获取设备最新状态：
curl -s "http://192.168.31.205:8070/api/getStatus?devEui=ffffff100004e970"
{
"success": true,
"result": {
"batteryVoltage": 3.09,
"batteryVoltageState": 0,
"tamper": 1,
"tamperEvent": 0,
"smokeStatus": 0,
"selfCheckEvent": 0,
"model": "JTY-AN-503A"
}
}2.3 IoT Hub Modbus TCP — Python 脚本
脚本下载：modbus_tcp_read.py
使用 modbus_tcp_read.py 一次性读取所有寄存器：
python3 modbus_tcp_read.py --ip 192.168.31.205 --port 502 \
--slaveId 5 --sensorType JTY-AN-503A
Target: 192.168.31.205:502 | Slave ID: 5 | Sensor: JTY-AN-503A
================================================================================================================================================================
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 8E5D | 1775013469 | second
temperature | 9 | 03 | Int16(S) | Big(ABCD) | 1 | /100 | 0000 | 0.0 | celsius
batteryVoltage | 10 | 03 | Int16(S) | Big(ABCD) | 1 | /100 | 0135 | 3.09 | volt
batteryVoltageState | 11 | 03 | Int16 | Big(ABCD) | 1 | x1 | 0000 | 0.0 | none
tamper | 12 | 03 | Int16 | Big(ABCD) | 1 | x1 | 0001 | 1.0 | none
tamperEvent | 13 | 03 | Int16 | Big(ABCD) | 1 | x1 | 0000 | 0.0 | none
smokeEvent | 14 | 03 | Int16 | Big(ABCD) | 1 | x1 | 0000 | 0.0 | none
smokeStatus | 15 | 03 | Int16 | Big(ABCD) | 1 | x1 | 0000 | 0.0 | none
selfCheckEvent | 16 | 03 | Int16 | Big(ABCD) | 1 | x1 | 0000 | 0.0 | none
model | 41 | 03 | String(24B) | ASCII | 12 | x1 | 4A54 592D 414E 2D35 ... | JTY-AN-503A | none
rssi | 53 | 03 | Int16 | Big(ABCD) | 1 | x1 | FFC5 | -59.0 | none
... (13 fields total)2.4 IoT Hub Modbus TCP — Modbus Poll
工具下载：Modbus Poll 9.5.0.1507.zip
- 打开 Modbus Poll，连接
192.168.31.205:502，Slave ID5 - 菜单 Setup → Read/Write Definition，功能码选 FC03，起始地址
6，长度49 - 点击 OK — 数值实时刷新
2.5 IoT Hub BACnet BIP — Python 脚本
脚本下载：bacnet_read.py
使用 bacnet_read.py 读取所有 BACnet 对象：
python3 bacnet_read.py --ip 192.168.31.205 --port 47808 --id 104
Target: 192.168.31.205:47808 | BACnet ID: 104 | Scan: 10400-10499
------------------------------------------------------------
Type | Instance | Offset | Value | Object Name
------------------------------------------------------------
BI | 10402 | 2 | active | ffffff100004e970.online
AI | 10403 | 3 | 1775013504.00 | ffffff100004e970.lastOnlineTime
AI | 10404 | 4 | 0.00 | ffffff100004e970.temperature
AI | 10405 | 5 | 3.09 | ffffff100004e970.batteryVoltage
AI | 10406 | 6 | 0.00 | ffffff100004e970.batteryVoltageState
AI | 10407 | 7 | 1.00 | ffffff100004e970.tamper
AI | 10408 | 8 | 0.00 | ffffff100004e970.tamperEvent
AI | 10409 | 9 | 0.00 | ffffff100004e970.smokeEvent
AI | 10410 | 10 | 0.00 | ffffff100004e970.smokeStatus
AI | 10411 | 11 | 0.00 | ffffff100004e970.selfCheckEvent
CV | 10415 | 15 | JTY-AN-503A | ffffff100004e970.model
AI | 10416 | 16 | -59.00 | ffffff100004e970.rssi
... (13 objects total)2.6 IoT Hub BACnet BIP — YABE
工具下载：SetupYabe_v2.1.0.exe
- 打开 YABE，连接
192.168.31.205:47808 - 在设备树中展开设备 104
- 浏览 AI/BI/AV/BV/CV 对象，查看实时数值