R-DIAG
R-DIAG
Overview
R-DIAG is an event-driven diagnostic solution for IoT devices. On the device side, event types and data structures are predefined in the SDK. Upon trigger conditions, key data is written to memory in a structured format. The host can retrieve historical events at any time via UART/TCP/UDP and accurately parse and visualize them using the JSON structure description generated during compilation.
Unlike traditional real-time printing, R-DIAG significantly reduces CPU resource usage through record-and-asynchronous-upload, ensuring critical tasks are not disturbed and providing lightweight, reliable event recording and management.
Advantages
Flexible Information Access
- On-demand access: supports batch retrieval of historical logs and real-time subscription to new events, covering both online and offline scenarios
- Cross-platform interfaces: provides UART (for resource-constrained devices) and TCP/UDP (for Ethernet/Wi-Fi devices) to enable remote, multi-device concurrent diagnostics
Structured, High-Density Data
- Events include type, level, timestamp, and detailed content for easy parsing, retrieval, and analysis
- Generates a JSON structure description and version hash; the host and the Ameba device can perform consistency checks to reduce compatibility risks
Extremely Low Runtime Overhead
- Low-latency recording with controllable impact on task scheduling, preserving the original system temporal behavior for accurate issue reproduction
- Avoids frequent real-time printing, significantly reducing CPU usage and I/O spikes
Flexible Post Analysis
- Separation of data and presentation: the host directly parses events into readable strings
- Easy to extend host capabilities: advanced features such as filtering, searching, aggregation, and charting
Typical Applications
- Custom Event Logging
Supports custom events and their trigger conditions to flexibly meet different diagnostic needs. - Remote Device Information Retrieval
Connect to devices remotely via TCP/UDP to bulk extract diagnostic logs, reducing on-site debugging costs; can also integrate with cloud services for centralized maintenance. - Long-Term Device Status Tracking
Suitable for long-term stable operation; logs can be collected on demand or scheduled to analyze operational status and fault trends over specific periods. - High Real-Time Task Requirements
In timing-critical scenarios, use in-memory recording instead of real-time printing to avoid unacceptable latency.
