结构化 FAQ 库

结论：四个值——ProductKey、DeviceName、DeviceSecret 和接入域名。主题、心跳、重连退避都由设备 SDK 生成，不用手工拼：SDK 按 <pk>/<dn>/up 与 <pk>/<dn>/down 自动订阅。三要素在控制台按设备维度生成，一台设备一份，不共用。

关联：快速开始（注册 → 首条数据 → 看板可见）

结论：只放出方向即可——TCP 8883（MQTT over TLS）、TCP 443（HTTPS 上报与 OTA）、UDP 123（NTP 对时）；用 CoAP 接入再加 UDP 5684。不需要公网入方向端口，也不需要固定公网 IP。清单可直接给客户 IT，见资料中心「网络与端口开通清单」。

关联：部署与运维清单 · 快速开始

结论：由从站响应时间决定下限。9600bps 下读写 10 个寄存器，单帧往返约 25~40ms；同口多站还要加站间间隔（建议 20ms）。因此单口 10 站以内建议周期 ≥1s，低于 500ms 时先确认从站是否支持，否则超时重试会堆积。

关联：协议接入（Modbus 轮询与超时）

结论：电气上限是 32 个标准负载（加中继器可扩展），工程上限按轮询预算算：单站 60ms、周期 1s，则不超过 16 台。超过 16 台就拆到第二个串口，不要靠缩短超时时间硬撑，那会变成随机丢点。

关联：协议接入（RS485 总线与轮询预算） · 点位表模板

结论：字节序与字序不匹配。4 字节浮点常见 ABCD、CDAB、BADC、DCBA 四种排列，还有仪表用「32 位整数 ×0.1」表示。处理顺序：先查仪表手册的寄存器说明，再在点位表里选字序；仍不对就同时读原始寄存器值与工程值比对，把结论写回点位表备注列。

关联：Modbus RTU 点位表模板 · 协议接入（数据类型与字序）

结论：keepalive 设 60s，平台按 1.5 倍（90s）判离线；重连用指数退避 1s→2s→4s→…封顶 60s，并加 0~30% 随机抖动，避免整批设备同时重连。弱网现场可把 keepalive 放到 120s，代价是离线发现晚 60s。

关联：协议接入（MQTT 主题与 QoS） · 运维与告警分级

结论：周期遥测用 QoS 0，靠网关本地缓存补传；告警与控制回执用 QoS 1；QoS 2 只用在需要对账的数据。注意 QoS 1 会重复投递，业务侧必须按消息 ID 做幂等，否则会出现重复告警。

关联：协议接入（QoS 与幂等）

结论：生产环境用 Basic256Sha256 + Sign&Encrypt，端口 4840，客户端证书由平台侧签发、有效期 1 年（到期前 30 天告警）。只有在物理隔离且无法升级的老设备上才允许 None，且必须在验收单上注明。

关联：协议接入（OPC UA 端点与证书） · 安全与合规

结论：网关本地缓存默认 72 小时，实测断网 72 小时后恢复，补传成功率 100%。缓存写满后按「告警优先保留、最旧遥测先丢」策略丢弃，并记录丢点计数供对账。需要更长离线窗口，就在部署检查表里写明 /data 分区可用空间。

关联：运维、OTA 与 SLA（离线自治与补传） · 现场部署检查表

结论：接入层 P99 240ms、消息引擎 P99 86ms、规则引擎 P99 45ms，常规链路 1s 内可见。实时看板刷新间隔 5s，历史曲线按分钟聚合，最迟滞后一个聚合周期。端到端 P95 的验收口径是 ≤3s。

关联：快速开始（看板可见） · 交付与验收

结论：分布式 MQTT Broker 异地多活部署，单集群支撑 1000 万+ 长连接。压测口径为 80 万设备并发写入、消息引擎 120 万条/秒；接入层 P99 240ms、消息引擎 P99 86ms、规则引擎 P99 45ms。容量评估按「设备数 × 上报频率 × 单包大小」出流量预算，不按连接数单算。

关联：平台能力 · 平台状态

结论：平台按 keepalive 的 1.5 倍判离线（keepalive 60s → 90s），再过 1 个聚合周期（5s），因此最迟 95s 内产生离线告警。要更快就把 keepalive 降到 30s，代价是设备功耗与流量上升。

关联：运维与告警分级 · 接入与协议（心跳）

结论：适合做点位条件、窗口聚合、跨设备关联与 12 类动作（写回、告警、HTTP 回调、MQTT 转发等），边缘侧响应 18ms。不适合做机器学习推断与跨系统长事务：前者放端侧模型，后者放业务系统，规则引擎只做触发。

关联：平台能力 · 端侧运行时

结论：云端编译为边缘可执行格式后按灰度下发，设备侧 A/B 双模型槽切换。模型差分包约为全量的 13%，失败自动回滚，回滚耗时 <1s 且不需要重启设备。

关联：端侧运行时与模型部署 · 运维、OTA 与 SLA

结论：不会变砖。升级写入非活跃分区，写完才原子切换；中途断电重启仍在旧分区运行，上电后从断点续传。校验失败自动切回旧分区并上报失败码，失败码与处置方式见运维文档的失败码表。

关联：运维、OTA 与 SLA（失败码与回滚）

结论：按批次并发下发，单批 500 台、并发 50，实测到达率 99.76%。10 万台规模按 3~5 天排期：先 1% 观察 24 小时，再 10%，最后全量；错误率超过 2% 自动熔断回滚。

关联：运维、OTA 与 SLA（灰度批次） · OTA 发布单模板

结论：热数据 90 天在线（原始精度），90 天到 2 年降采样为分钟级存温层，2 年以上转冷归档。保留期在项目交付时确定并写入方案，事后调整只从变更日生效，不追溯已有数据。

关联：平台能力（数据面） · 定价

结论：可以。指标可对接 Prometheus / OpenTelemetry，事件可推 Kafka 或 Webhook；自建监控侧只需开通出方向访问，不需要平台侧改配置，也不需要额外插件。

关联：运维、OTA 与 SLA（监控指标） · 平台状态

结论：一机一密：每台设备出厂写入独立密钥，平台按设备维度校验，密钥不落在明文配置文件里。更换板卡必须重新注册，旧密钥立即吊销；同一密钥出现两地同时登录会直接拒绝并告警。

关联：安全能力 · 快速开始（设备注册）

结论：全链路 TLS 1.2 及以上，证书双向校验，服务端禁用 SSLv3 与 TLS 1.0/1.1 及弱套件。只能跑明文协议的老设备不直接暴露公网，改为串口采集进网关后再加密上行。

关联：安全能力 · 协议接入（老设备接入路径）

结论：能。固件包用 ECDSA P-256 签名并带 X.509 证书链，板端验签通过才写入非活跃分区；同时有防回滚计数，目标版本低于计数器时直接拒绝升级，避免用降级方式绕过修复。

关联：运维、OTA 与 SLA（签名与验签） · 安全能力

结论：按数据分级处理：生产数据默认本地闭环，只有约定的测点与统计值上行。要求数据不出内网的项目采用私有化部署，数据留在客户机房，备份与销毁策略由客户安全部门确认。

关联：安全能力 · 私有化与定价

结论：三级角色——只读（看板与历史）、运维（配置与 OTA）、管理员（账号与密钥）。OTA 发布需要两人复核：发布单 + 回滚记录齐全才放行，单人账号没有全量发布权限。

关联：运维、OTA 与 SLA（发布流程） · OTA 发布单模板

结论：每季度一次内部红队测试，覆盖设备伪造、MQTT 重放、OTA 签名绕过、权限提升四类手法，修复后必须回归验证。报告可应客户要求在保密协议下查阅，攻击细节不在官网公开。

关联：安全能力 · 工程笔记（测试方法）

结论：按三态标注——CNAS 质检报告（已取得，随货附带）、EMC 4 级（已取得）、等保测评（进行中，配合客户按其定级要求推进）、GDPR 相关（不适用，业务不涉及欧盟个人数据）。需要资质扫描件请在申请邮件里注明用途。

关联：安全与合规 · 申请获取流程

结论：操作日志与升级日志在线留存 180 天，安全事件日志留存 1 年；日志按租户隔离，客户只能查看自己设备范围的记录，导出需要管理员二次确认并留下导出记录。

关联：运维、OTA 与 SLA（审计与日志） · 安全能力