LoRaWAN 数据格式

LoRaWAN 端数据格式与解析用户使用文档

本文档面向系统集成商、网络服务器（NS）后端运营人员，说明本设备（STM32WL 电池供电 LoRaWAN 温湿度墨水屏传感器）通过 LoRaWAN 空口上传与下发的数据格式及解析方法。

1. 基本信息

| 项目 | 值 | 说明 | |------|-----|------| | 频段 | CN470（中国 470MHz） | 标准 8 信道入网方案 | | 上行端口（FPort） | 2 | 传感器业务数据 | | 下行端口（FPort） | 3 | 仅用于设备工作模式（Class）切换 | | 默认工作模式 | Class A | | | 默认确认方式 | 确认帧（Confirmed） | 每帧要求网关 ACK 保证送达并即时反映断网；可通过 NFC 改为非确认帧省电（此时每 5 次上行自动发一次确认帧探针检测断网） | | 默认上报周期 | 2 分钟 | 可通过 NFC 修改（1 分钟 ~ 24 小时） | | 上行编码 | CayenneLPP | 与 TTN / ChirpStack / TTI 等主流平台兼容 |

部署提示：CN470 入网使用起始最低速率（SF12）+ 速率自适应（ADR）开启。入网后由网络服务器下发指令逐步提速，从而降低功耗、延长续航。若速率长期不收敛，设备会持续在低速高耗电状态发送，影响续航，部署后应抽检设备实际速率。

配置修改提示（2026-09 起）：设备经 NFC 修改配置时，只有改动入网核心配置（OTAA/ABP 模式、凭证来源、DevEUI/AppKey/DevAddr/会话密钥等）才会触发重新入网；仅修改上报周期、确认方式、温度单位、温湿度补偿、速率/功率等业务参数会直接应用、不重新入网，当前连接不断开。详见《NFC 移动端集成指南》。

会话提示：设备不持久化 LoRaWAN 会话（CONTEXT_MANAGEMENT_ENABLED = 0），每次上电都会重新入网（OTAA 每次重新 Join）；网络服务器需允许设备重复入网。

2. 上行数据格式（设备 → 网络服务器）

上行帧负载采用 CayenneLPP（低功耗协议） 编码。每一帧由若干「信道 + 类型 + 数值」的组合构成：

`` [信道 1 字节][类型 1 字节][数值 N 字节] [信道][类型][数值] ... ``

• 信道：逻辑编号，用来区分不同物理量
• 类型：数据类型编号，决定数值占用几个字节
• 数值：实际测量值，采用定点小数（整数放大后存储），大端序（高位在前）

2.1 设备上传的数据项

| 物理量 | 信道 | 类型编号 | 数值长度 | 还原公式 | 单位 | |--------|------|---------|---------|----------|------| | 温度 | 0 | 0x67 | 2 字节 | 数值 ÷ 10 | 摄氏度或华氏度（见 2.3 单位说明） | | 相对湿度 | 1 | 0x68 | 1 字节 | 数值 ÷ 2 | 百分比 | | 电池电量 | 2 | 0x00 | 1 字节 | 数值（直接读取） | 百分比（1~100，100=满电） | | 时间戳 | 3 | 0x09 | 6 字节 | 前 4 字节=Unix 秒（大端），后 2 字节=毫秒 | Unix 秒 |

类型编号遵循 myDevices CayenneLPP 通用标准：0x67=温度，0x68=相对湿度，0x00=数字量输入（此处用作电池电量 1~100），0x09=GPS 时间戳。

时间戳语义：实时帧=发送时刻；断网补传帧=缓存采集时刻（设备断网期间本地缓存、联网后补传）。设备已与网关同步过时间（LoRaWAN DeviceTimeReq）时为 Unix 秒；从未同步过的设备为相对秒（自设备 RTC 基准零点计，不具日历含义）。

2.2 典型帧示例（十六进制）

一帧包含四项（温度 + 湿度 + 电池 + 时间戳）：

`` 00 67 00 C8 01 68 64 02 00 30 03 09 66 2A 8C E4 00 00 ``

逐段解析：

| 内容 | 含义 | |------|------| | 00 67 00C8 | 信道 0，温度，数值 0x00C8 = 200 → 200 ÷ 10 = 20.0 ℃ | | 01 68 64 | 信道 1，湿度，数值 0x64 = 100 → 100 ÷ 2 = 50.0 % | | 02 00 30 | 信道 2，电池，数值 0x30 = 48 → 电量 48%（1~100 直接值） | | 03 09 662A8CE4 0000 | 信道 3，GPS 时间戳，0x662A8CE4 = 1714551012（示例值）→ Unix 秒，毫秒 0x0000 |

即：温度 20.0℃、湿度 50.0%、电池 48%、采集时刻 1714551012（Unix 秒）。

时间戳为可选解析项：不需按采集时间归档的服务器可跳过信道 3（6 字节），不影响温度/湿度/电池解析。

2.3 温度单位注意事项（重要）

设备上报的温度数值语义取决于设备的温度单位设置（可由手机 NFC 写入 temp_unit 切换，同时影响墨水屏与上行）：

• 摄氏度模式（默认）：数值 = 摄氏度 × 10，按摄氏度解析即可。
• 华氏度模式：设备会先把摄氏度换算成华氏度再编码，数值 = 华氏度 × 10。

网络服务器必须与设备使用相同的温度单位口径，否则会出现系统性偏差（℃ 与 ℉ 相差约 1.8 倍）。设备当前单位可经 NFC 状态/配置读取确认（配置区 temp_unit 字段），建议服务器侧按设备实际单位解析，或固定将设备设置为摄氏度并强制服务器按摄氏度解析。

2.4 解析步骤（通用）

1. 确认收到的是 FPort = 2 的上行帧。
2. 从帧首开始，每 3 步循环：

• 读 1 字节得信道号；
• 读 1 字节得类型编号；
• 根据类型编号读取对应长度的数值，按上表公式还原。

1. 信道 0 对应温度，信道 1 对应湿度，信道 2 对应电池电量（1 字节），信道 3 对应时间戳（6 字节，可选解析）。

2.5 断网缓存与补传机制

设备在断网期间把采集数据落盘到内部 Flash 环形缓存，链路恢复后再逐条补传，保证断网期间的数据不丢失（在服务器侧可按采集时刻归档）。

（1）存储（在哪、存多少、是否可靠）

• 介质：MCU 内部 Flash 环形缓存，占用 2 个页（合计 4 KB），最多 512 条记录。
• 每条记录 8 字节：时间戳（4B）+ 温度×10（2B）+ 湿度×10（2B）。
• 环形淘汰：写满当前页后擦除「较旧页」再续写，写满后自动淘汰最旧一批（环形语义）。
• 掉电安全：每条为单次 8 字节双字编程（原子），写入过程中掉电不会破坏已存记录。
• 上电恢复：开机扫描两页有效记录，恢复写指针与计数（只读，不写 Flash）。

（2）触发（什么情况开始缓存）

满足以下任一即判为"断网"，进入缓存：

• 未入网（无有效会话）；或
• 已入网但连续多次确认帧未获网关 ACK（默认连续 2 次，2026-09 起新增）——会话可能仍有效，但链路已不可达。

断网期间按上报周期（tx_duty_cycle_ms）限频写入，保证缓存密度与在线上报一致。

缓存节奏与「入网重试退避」解耦（2026-09-17 起）：入网失败后的指数退避（30s→翻倍→15min）只决定「何时再试一次 Join」，不再决定唤醒周期。未入网/退避期间设备仍按上报周期唤醒采样并写缓存；只有「退避剩余 < 上报周期」时才提前醒来重试入网。因此退避不会让离线缓存变稀疏（修复前退避期间缓存间隔会被拉长到 4/8/16/15 分钟）。

未确认帧（Unconfirmed）模式下没有逐帧 ACK，设备靠周期性确认帧探针（每 5 次上行一次）来探测链路，从而触发/结束上述判定。

断网判定窗口不再有数据空洞（2026-09-17 起）：判定断网需要连续 2 次确认帧无 ACK，而从「网关消失」到「判定成立」之间发出的实时帧，原本既送不到也不进缓存，复网补传后历史里会缺一段（Unconfirmed 模式下最长约 5 帧 ≈ 10 分钟）。现在设备把这批在途采样暂存在 RAM 环中：一旦确认帧 NACK（或判定链路不可达），立即按采集时刻补写进缓存，复网后一并补传。

代价：若这段上行其实已被网关收到（只是 ACK 丢失），该条会重复上报一次（帧内时间戳相同），服务器可按信道 3 时间戳去重。

（3）补传（链路恢复后如何回传）

仅当链路可达（既非未入网、也无连续无 ACK）时才补传：

| 维度 | 规则 | |------|------| | 顺序 | 最旧优先，逐条上发 | | 帧格式 | 与实时帧完全一致（FPort=2，CayenneLPP 编码）| | 时间戳 | 该条记录的真实采集时刻（非发送时刻），服务器据此归档 | | 送达判定 | 补传帧一律使用确认帧，收到网关 ACK 才视为送达并推进下一条 | | 发送节奏 | 背靠背：一条确认后立即发下一条，由 LoRaWAN 空口时间 + 接收窗口自然限速（通常远快于上报周期）；若被 MAC 拒绝（BUSY/占空比），按 MAC 给出的等待快速重试（BUSY=5s），不会被抬到一个上报周期 | | 补传中再次断网 | 暂停补传但保留进度与缓存，链路恢复后从该条继续（不重复已确认送达的记录）| | 结束 | 全部缓存记录均获 ACK 送达后，清空缓存，恢复纯实时上报 |

关键点："推进/清缓存"以网关 ACK 为准，而非"已排入发送队列"。因此补传帧即便暂时发不出去，也只会暂停，绝不会在未送达时把缓存清掉。

（4）时序示意

`` 实时上报 ──断网──▶ 按周期写缓存（最多 512 条，最旧自动淘汰） │ 链路恢复（收到 ACK） ▼ 逐条补传（最旧优先 · 确认帧 · ACK 才推进） ├─ 收到 ACK ─▶ 下一条 … ─▶ 全部送达 ─▶ 清空缓存 ─▶ 回到实时上报 └─ 未获 ACK ─▶ 暂停补传 · 保留缓存 ─▶ 等链路恢复后重发该条 ``

（5）服务器/集成方注意

• 补传帧与实时帧同端口（FPort=2）、同编码，请以帧内时间戳（信道 3）区分/归档"采集时刻"。
• 缓存容量上限 512 条：长时间断网且无网关时，超出后最旧数据被覆盖。
• 首次入网前（从未同步时间）时间戳为相对秒；同步过（DeviceTimeReq）后为 Unix 秒。断网后的行为详见 §2.6。
• 补传帧的时间戳在「补传时」换算（缓存内只存 RTC 原生秒，不固化时区偏移）：因此「写入缓存时还没同步、补传前已同步」的记录，补传出去同样是正确的绝对 Unix 秒（2026-09-17 修复；修复前会固化相对秒，表现为 1970 年附近的错误时间，且可能与后续记录不单调）。
• 缓存溢出告警：写满 512 条后淘汰最旧一页时，串口打印 DLOG: cache FULL, oldest page (256 recs) discarded, data loss。

2.6 时间戳时基与断网后的行为

时基构成：设备时间 = MCU RTC 日历（LSE 驱动，电池域保持）+ RTC 备份寄存器中的偏移量。

• 与网关同步后，MAC 把「网关时间 − RTC 日历」的偏移写入 RTC 备份寄存器（SysTimeSet）；
• SysTimeGet() 实时返回「RTC 日历 + 偏移」，因此只要 VBAT 不断，时间就持续正确走时（可穿越 STOP2 与软复位，不依赖 LoRaWAN 连接）。

同步时机：入网成功后第一个上行即捎带 MAC 命令 DeviceTimeReq；收到 DeviceTimeAns 后写入偏移；之后每 1 小时重同步一次（校正 RTC 漂移）。需网络服务器支持 DeviceTimeReq（ChirpStack 需在 Device Profile 中允许 Device Time）。

2026-09-23 起改为「NFC 优先 / 服务器仅兜底」：只要设备有过一次手机 NFC 授时，就不再请求 DeviceTimeReq；即便收到 DeviceTimeAns 也不采用（设备时钟从 NFC 基准继续走、不跳变）。服务器时间仅在"从未贴过卡"时用作兜底。详见 §5 更新记录。

时间同步状态机（2026-09-19 起）：设备用三态（未同步 / 已请求待 Ans / 已同步）管理同步，只有"已同步"才认为本地时间可信。三条自愈规则：

1. Ans 超时：请求发出后 90 秒内未收到应答，即退回"未同步"，下个上行重试；

2. 结果校验：同步结果须落在 2020-01-01 ~ 2100-01-01 之间，否则拒绝并继续重试（防止把错误偏移固化）；

3. 重试分级：从未同步成功 → 每 60 秒重试；曾成功过或连续失败 ≥5 次 → 每 300 秒重试。

若 NS 未回复 DeviceTimeReq，且设备从未有过 NFC 授时，设备会在未同步期间持续捎带该 1 字节 MAC 命令（数据帧不受影响）；此时设备时间戳的相对顺序与间隔仍然正确（RTC 独立走时、速率 1:1），但绝对零点会持续偏离，需在服务器侧按设备实际偏差校正（或贴一次卡授时）。已有 NFC 授时的设备则完全不再发送该 MAC 命令。

另外：链路不可达期间不发时间同步请求（请求到不了网关，且会白白刷新节流计时）；链路恢复后的第一个上行立即补一次。

断网后的时间戳（重点）：

| 情形 | 缓存 / 补传帧的时间戳 | |------|----------------------| | 入网并同步过，之后断网 | 仍是绝对时间（Unix 秒），即真实采集时刻。断网期间 RTC 独立走时，时间戳继续正确递增；恢复联网后可直接按采集时刻归档 | | 断网期间 RTC 漂移 | 断网时无法每 1h 重同步，LSE 漂移会累积（典型 ppm 级，长时间断网可能有秒级误差），但仍是绝对时间 | | 从未同步过（从未入网 / 从未收到 Ans）| 相对秒（以设备 RTC 基准零点计，不具日历含义）| | VBAT 断电（更换电池）后 | RTC 与备份寄存器清零 → 回到相对时间；下次入网收到 DeviceTimeAns 后重新变为绝对时间 |

结论：只要设备曾经入网同步过，断网期间缓存与后续补传的时间戳就是可用的绝对时间；只有「从未同步过」或「换电池后尚未再同步」的设备才需按相对时间处理。

3. 下行数据格式（网络服务器 → 设备）

本设备对下行帧的处理仅限工作模式（Class）切换，其余端口与内容一律忽略。

| FPort | 含义 | 负载格式 | 行为 | |-------|------|----------|------| | 3 | 工作模式切换 | 1 字节：0=Class A，1=Class B，2=Class C | 切换设备工作模式 | | 其他 | 未定义 | — | 设备仅记录接收，不做任何业务响应 |

下行负载（FPort=3）单字节取值表：

| 字节值 | 目标工作模式 | |--------|------------| | 0x00 | Class A | | 0x01 | Class B | | 0x02 | Class C |

说明：除工作模式切换外，本设备不提供其他 LoRaWAN 下行指令通道。若需修改上报周期、温度单位、确认方式等参数，请通过 NFC（手机贴卡） 写入配置，而非 LoRaWAN 下行。

3.1 NFC 显示页面选择（非 LoRaWAN 指令，配置字段）

墨水屏支持两种显示界面，可由手机贴卡（NFC 配置）选择，设备上电后默认显示主界面。该控制不走 LoRaWAN 下行（下行端口仅用于 Class 切换），而是写进 NFC 配置结构体的 reserved[4] 字段（结构体绝对 offset 115）：

| reserved[4] 值 | 显示界面 | 说明 | |------------------|----------|------| | 0x00 | 主界面（页面 A） | 默认界面 | | 0x01 | 详情页（页面 B） | 大号时间 + 温湿度组合显示 | | 0xFF | 不修改 | 保留设备当前显示界面，仅用于"本次只改其他配置、不动页面"的场景 |

手机端操作（与授时/其他配置共用同一 128 字节配置包）：

1. 构造 NFC_Config_t（128 字节，CRC 覆盖 offset 0~125）；
2. 将 reserved[4]（整个 reserved 区的第 5 字节）写为 0x00 / 0x01 / 0xFF；
3. 其余字段必须按当前设备配置回填（activation_type、cred_source、凭证等填实际值；不授时时 reserved[0..3] 填 0），避免误触发重新入网；
4. 写入 EEPROM，手机离开后设备应用配置并按该字段切换 UI_SetDisplayPage()。

与上行数据的关系：显示页面不影响任何 LoRaWAN 上行帧内容（上行仍由 §2 的 CayenneLPP 编码决定），仅改变墨水屏本地呈现。服务器侧无需、也无法通过空口读取/设置该选择。完整字段定义见《NFC 移动端集成指南》§3 主表与 references/data-contracts.md。

4. 对接清单（Checklist）

• [ ] 网络服务器信道计划设为 CN470（与设备一致，否则无法入网）
• [ ] 应用解码器监听 FPort=2，按第 2 节 CayenneLPP 规则解析温度 / 湿度 / 电池（可选时间戳）
• [ ] 确认设备温度单位口径（默认摄氏度，NFC 可切华氏），避免 ℃/℉ 解析偏差
• [ ] 如需按采集时间归档历史数据，解析信道 3 GPS 时间戳（补传帧为采集时刻）
• [ ] 下行仅 FPort=3 用于工作模式切换；配置变更走 NFC，不走 LoRaWAN
• [ ] 入网后关注速率是否收敛（是否从低速 SF12 上调），以保障续航
• [ ] 明确配置修改的入网触发规则：设备切换 OTAA/ABP 或改写凭证会重新入网（产生新会话，服务器需按新凭证识别）；仅改上报周期等业务参数不重新入网（连接不中断）
• [ ] 设备不持久化 LoRaWAN 会话（每次上电重新入网，OTAA 每次重新 Join），服务器需允许重复入网

5. 固件更新记录

仅记录对网络服务器 / 集成方有影响的变化；配置结构体（NFC 区，v0x03）自 2026-08 起未变。

2026-09-23 时间来源仲裁改为「NFC 优先 / 服务器仅兜底」

• 设备时间戳基准：手机 NFC 授时为优先基准；DeviceTimeReq 只在设备从未有过 NFC 授时时才请求一次作为兜底。
• NFC 授时写入的是本地时间：手机写入 reserved[0..3] 的值是手机当前显示的本地时间（带时区，分量按 UTC 解释）对应的 Unix 秒；设备直接以该值为系统时间基准，墨水屏显示与上行时间戳（信道 3）都使用这个本地时间，设备端不做任何时区还原/换算。
• 不再被服务器时间覆盖：已有 NFC 授时的设备即使收到 DeviceTimeAns 也不采用（设备时钟从 NFC 基准继续走、不跳变），避免 NS 的 GPS epoch 时间（比 UTC 快约 18 秒闰秒差）覆盖已校准的本地时间。⇒ 对集成方的含义：不要以服务器时间推断设备时间，设备上报的时间戳一律为手机 NFC 授时的本地时间（带时区）。
• 无格式影响：时间戳仍是信道 3 的 Unix 秒；来源可见于 NFC 状态区 reserved[2]（0=无/相对秒、1=服务器、2=NFC）。
• Flash 时间锚点保存间隔由 5 分钟放宽为 15 分钟（仅影响"换电池后恢复基准"的偏早量，最多多偏 15 分钟；设备侧年擦除次数降至约 1/3）。

2026-09-22 上行静默修复（服务器「只收到 Join、收不到数据」）

故障现象：概率性出现在上电 / 入网期间（入网过程中手机贴卡会显著提高命中率），设备已入网，但此后一条上行都没有（设备屏上 TX=0）。

根因（设备侧，与报文格式无关）

• 入网进行中若发起一次发送，LmHandlerSend() 会因「未入网」再发起一次 Join 并返回 NO_NETWORK_JOINED；应用把它误判为「会话丢失」→ 置断网计数 + NFC 状态刷新标志。
• 该标志又把紧随其后的 TX 定时器唤醒吞成「仅刷 NFC」而跳过发送函数；而单次（ONESHOT）TX 定时器只在发送函数末尾重装 ⇒ 发送心跳永久丢失，设备静默。

修复后行为（集成方可见）

• 入网与发送严格互斥：入网进行中不发数据帧；未入网时由固件显式发起入网（不再借道发送接口）→ 服务器侧不会再出现"反复 Join 却无上行"。
• 新增发送心跳看门狗：距上次服务发送超过 2×上报周期仍未按时唤醒 ⇒ 自动重装定时器并补发；正常时无额外唤醒/空口开销。
• 手机贴卡不再额外占用空口发一帧；同一突发内的重复发送（3 秒内）被抑制（补传背靠背不受限）。

2026-09-17

行为变更（断网缓存节奏 / 补传速度，详见 §2.5）

• 缓存节奏与入网退避解耦：入网失败退避（30s→翻倍→15min）仅决定"何时再试一次 Join"，不再决定唤醒周期；未入网期间仍按上报周期采样并写缓存。修复前退避期间缓存间隔会被拉长到 4/8/16/15 分钟，现已消除（缓存密度恒等于上报周期）。
• 补传更稳更快：补传被 MAC 拒绝（BUSY/占空比）时按 MAC 给出的短等待快速重试（BUSY=5s），不再白等一个上报周期；补传中断（NACK / 掉网）保留进度，恢复后从该条继续，不再从最旧重来（避免重复上传已送达记录）。
• "已入网但网关消失"兜底自愈：该状态下设备不会再发起 Join，若丢会话的是 NS 侧（NS 重启 / 会话过期），设备会一直"自以为已入网"、上行被丢。现增加兜底：持续不可达 ≥ 30 分钟（LINK_LOST_FORCE_REJOIN_S，置 0 可关闭）→ 主动 LmHandlerStop() + LmHandlerJoin(true) 重建 OTAA 会话（未入网/退避中、以及 ABP 不走此路径）。

2026-09-17 (2) 离线数据完整性与时间戳修复

时间戳（对归档有影响，详见 §2.5 (5)、§2.6）

• 补传时间戳改为「补传时换算」：缓存内统一只存 RTC 原生秒，补传时再叠加当前偏移换算成绝对 Unix 秒。修复前：设备尚未同步时间时写入的缓存记录会把相对秒当 Unix 秒固化，复网补传后时间戳完全错误（1970 年附近），且与后续记录可能不单调。修复后只要在补传前同步成功，补传出去即为正确绝对时间。
• 时间同步改为三态状态机（2026-09-19）：未同步时按 60 秒重试（连续失败 5 次后降为 300 秒），并新增「Ans 超时 90 秒即重试」与「同步结果合理性校验」两道关卡；已同步后每 1 小时重同步。链路不可达期间不发请求，恢复后首个上行立即补一次。

数据完整性（详见 §2.5 (2)）

• 消除「断网判定窗口」的数据空洞：判定断网前发出的实时帧原会两头落空（Unconfirmed 模式最长约 5 帧 ≈ 10 分钟）。现把在途采样暂存 RAM 环，确认帧 NACK 或判定不可达时立即补写进缓存，复网后补传。副作用：若该帧其实已到达（仅 ACK 丢失），会重复上报一次（同时间戳，可去重）。
• 缓存溢出显式告警：写满 512 条淘汰最旧页时串口打印 DLOG: cache FULL, oldest page (256 recs) discarded, data loss。

2026-09-13

行为变更（用户可见，详见 §2.5）

• 断网判定扩展：由「仅未入网」扩展为「未入网 或 已入网但连续多次确认帧未获网关 ACK」（默认连续 2 次）。后者期间会话可能仍有效，但设备会开始本地缓存数据。
• 补传改为以网关 ACK 为准：补传帧强制使用确认帧，收到网关 ACK 才推进下一条/清除缓存；未获 ACK 则暂停补传并保留缓存，链路恢复后从该条重发，避免「已调度但未送达即清空」导致丢数据。
• 非确认帧探针间隔缩短：Unconfirmed 模式下，链路探针由每 10 次上行一次改为每 5 次（断网检测更快）。

稳定性修复（对数据格式与解析无影响）

• 修复启动阶段 HardFault 复位：ThreadX 字节池缓冲未对齐，导致启动时 STRD 非对齐访问异常（表现为上电即死机/自动复位）。
• 加固 Flash 双字写入、LoRaWAN AES、射频缓冲的内存对齐，消除同类非对齐访问隐患。

2026-09

• 新增「入网核心配置 vs 非入网参数」差异化处理：仅改模式（OTAA/ABP）、凭证来源、凭证时重新入网；改上报周期/显示/补偿/速率等业务参数直接应用、不重新入网。
• 修复 AUTO 模式（凭据全 0 属合法派生默认）改配置无法触发重新入网的问题。
• 修复 OTAA→ABP 切换后首帧沿用旧帧计数器、被服务器拒收的问题（切换时复位帧计数器）。

2026-08

• 默认上报方式改为 Confirmed（每帧要求网关 ACK）；可经 NFC 切回 Unconfirmed 省电。
• 上行帧新增信道 2「电池电量」（1~100，100=满电）与信道 3「GPS 时间戳」；断网数据本地缓存并在联网后补传（补传帧带采集时刻时间戳）。
• temp_unit 现在同时影响上行温度编码（此前仅影响墨水屏显示）；datarate/tx_power 在 ADR 关闭时写入即生效。
• 电池电量改为时间估算（固定 600 天，与上报周期无关），不再经 ADC 电压测量。