1. NS 数据

NS 数据是 ThinkLink 系统中最底层的原始数据，记录的是网关与 NS 之间的 LoRaWAN MAC 层通信报文，包含完整的物理层参数（信号强度、信噪比、频率等）和加密的设备负载。适用于深度调试、网络性能分析和信号覆盖评估。

数据流位置

flowchart LR
    DEV[LoRaWAN 设备]:::dim
    GW[网关]:::dim
    NS[NS 数据\nMAC层原始帧]:::highlight
    AS[AS 数据\n解密结构化报文]:::dim
    RT[实时数据\n物模型解析值]:::dim
    HIS[历史数据\n归档查询]:::dim

    DEV -->|无线信号| GW
    GW -->|SEMTECH UDP| NS
    NS -->|LoRaWAN 解密| AS
    AS -->|物模型解析| RT
    RT -->|持久化| HIS

    classDef highlight fill:#1a6fcf,color:#fff,stroke:#1a6fcf
    classDef dim fill:#f0f0f0,color:#888,stroke:#ddd

你在这里：NS 数据是设备数据进入 ThinkLink 后的第一层，尚未解密。如果你只需要业务数值（温度、湿度等），请直接查看实时数据。

---

1.1. 数据格式

NS 数据以 JSON 格式呈现，分为上行（rxpk）和下行（txpk）两种类型。

上行数据（rxpk）

{
  "EUI": "5a53012501030011",
  "token": 35160,
  "payload": {
    "rxpk": {
      "mid": 8,
      "chan": 4,
      "codr": "4/5",
      "data": "QKg6ATAAQ2sL/g+03laRsIW5iqvAAD0TohUdGw==",
      "datr": "SF7BW125",
      "foff": 9,
      "freq": 471.1,
      "jver": 1,
      "lsnr": 12,
      "modu": "LORA",
      "rfch": 1,
      "rssi": -95,
      "size": 28,
      "stat": 1,
      "time": "2025-09-24T07:02:03.802672Z",
      "tmst": 2379579148,
      "rssis": -96
    }
  },
  "version": 2,
  "identifier": 0
}

字段	说明
EUI	接收该帧的网关 EUI
rxpk.rssi	接收信号强度（dBm），越接近 0 越好
rxpk.lsnr	信噪比（dB），正值越大越好
rxpk.freq	上行频率（MHz）
rxpk.datr	扩频因子和带宽，如 SF7BW125
rxpk.data	Base64 编码的加密 LoRaWAN 负载
rxpk.time	网关收包时间（UTC）

下行数据（txpk）

{
  "EUI": "5a53012501030011",
  "token": 52914,
  "payload": {
    "txpk": {
      "codr": "4/5",
      "data": "YKg6ATIm+AkNqlP+VU6cdZ50",
      "datr": "SF7BW125",
      "fdev": 0,
      "freq": 501.5,
      "imme": false,
      "ipol": true,
      "modu": "LORA",
      "ncrc": false,
      "powe": 22,
      "prea": 8,
      "rfch": 1,
      "size": 18,
      "time": "",
      "tmms": 0,
      "tmst": 760845965
    }
  },
  "version": 2,
  "identifier": 3
}

字段	说明
txpk.freq	下行频率（MHz）
txpk.powe	发射功率（dBm）
txpk.data	Base64 编码的下行负载内容
txpk.tmst	目标发送时间戳（对应设备的接收窗口）

---

1.2. LoRaWAN 报文解析

点击数据列表中的 + 可展开单帧的 LoRaWAN 协议层解析，包含 MIC 校验、帧计数、ADR 标志等 MAC 层信息，适用于排查入网失败、帧序号异常等问题。

---

1.3. 适用场景

场景	使用 NS 数据的原因
设备无法 Join	查看是否有 Join Request 上行，确认网关是否收包
信号质量评估	通过 RSSI / LSNR 判断覆盖情况
帧序号异常	展开解析面板查看 FCNT
下行是否送达网关	确认 txpk 是否出现在日志中

注意：NS 数据中的 data 字段为加密原始负载，无法直接读取业务数据。如需查看解密后的结构化报文，请进入 AS 数据。

---

1.4. 搜索技巧

在 NS 数据界面中，根据设备所处状态选择不同的搜索字段：

设备状态	推荐搜索字段	原因
未入网 / 刚复位	DevEUI	Join Request 和 Join Accept 报文使用 DevEUI 标识，此时还没有 DevAddr
已入网，正常通信	DevAddr	入网完成后，所有数据帧改用 NS 分配的动态地址 DevAddr

完整的收数据故障排查流程（网关在线 → NS → AS → 实时数据），请参见 AS 数据 → 故障诊断。