Module ring_buffer

Error Ring Buffer for Network Initialization

Circular buffer that captures initialization errors and debug logs for display in the bootstrap UI. Also drains and forwards entries from the network crate’s internal debug ring buffer.

Design

• Fixed-size, no_std compatible (no heap allocation for buffer)
• Lock-free for single-producer single-consumer pattern
• Overwrites oldest entries when full
• Includes stage/source tracking for categorization

Structs

• ErrorLogEntry
  Single log entry in the ring buffer

Enums

• InitStage
  Stage identifiers for error categorization

Constants

• ERROR_MSG_LEN
  Maximum message length in bytes
• ERROR_RING_SIZE
  Number of entries in the ring buffer (power of 2 for efficient modulo)

Statics

• ERROR_RING 🔒
  Static ring buffer storage
• READ_POS 🔒
  Read position (wraps around)
• TOTAL_WRITTEN 🔒
  Total entries written (for overflow detection)
• WRITE_POS 🔒
  Write position (wraps around)

Functions

• debug_log
  Log a debug/info message to the ring buffer
• drain_network_logs
  Drain entries from the network crate’s debug ring buffer and forward them to our error ring buffer.
• error_log
  Log an error message to the ring buffer
• error_log_available
  Check how many entries are available to read
• error_log_clear
  Clear the ring buffer
• error_log_count
  Get total number of entries ever written (for overflow detection)
• error_log_pop
  Pop the oldest entry from the ring buffer
• log_internal 🔒