R-DIAG
R-DIAG
概述
R-DIAG 是一种面向 IoT 设备的事件化诊断方案。设备侧在 SDK 中预定义事件类型与数据结构，按触发条件将关键数据以结构化形式写入内存；上位机可在任意时刻通过 UART/TCP/UDP 拉取历史事件，并结合编译阶段生成的 JSON 结构描述进行精准解析与可视化。
区别于传统 实时打印 方式， R-DIAG 通过 记录-异步上传 显著减少 CPU 资源占用，确保关键任务不受干扰，提供轻量、可靠的事件记录与管理能力。
方案优势
灵活信息获取
- 按需获取：支持批量拉取历史日志与实时订阅新增事件，覆盖在线与离线场景
- 跨平台接口：提供 UART（适用于资源受限设备）和 TCP/UDP（支持以太网或 Wi-Fi 设备），实现远程、多设备并发诊断
结构化、高信息密度的数据
- 事件包含类型、级别、时间戳与详细内容，便于解析、检索与统计
- 生成 JSON 结构描述与版本哈希，上位机与 Ameba 设备可进行一致性校验，降低兼容性风险
极低的运行时开销
- 记录操作耗时短，对任务调度影响可控，保持系统原始时序行为，便于问题复现
- 避免频繁实时打印，显著降低 CPU 占用与 I/O 冲击
灵活的后期分析
- 数据与展示分离：上位机直接将事件解析为可读字符串
- 易于扩展上位机能力：过滤、搜索、聚合统计、图表化等高级功能
典型应用
- 自定义事件记录
支持自定义事件及其触发条件，灵活满足不同诊断需求。 - 远程获取设备信息
通过 TCP/UDP 网络接口远程连接设备，批量提取诊断日志，减少现场调试成本；也可与云端服务对接实现集中化运维。 - 长期追踪设备状态
适用于设备长期稳定运行场景，可按需或定时采集日志，便于分析特定时间段内的运行状态与故障趋势。 - 任务实时性高要求
在对时间确定性要求高的场景，以内存记录替代实时打印，避免引入不可接受的延迟。
