esp32-debug

What problem does it solve?

This Skill centralizes operational knowledge and diagnostics for ESP32 devices to quickly identify firmware, hardware, and communication failures from serial logs, MQTT traffic, and server artifacts, reducing mean time to resolution.

Core Features & Use Cases

• Boot and SafeMode Analysis: Step-by-step boot-sequence checkpoints, safe-mode triggers, and LED/serial patterns to pinpoint initialization failures.
• Error-Code Reference & Actions: Full 1000–4999 error-code mappings with suggested hardware checks, configuration fixes, and server cross-checks.
• Communication & Circuit Breaker Diagnostics: MQTT and WiFi circuit-breaker behaviors, topic schemas, QoS expectations, and recovery workflows for offline or degraded devices.
• Cross-Layer Troubleshooting: Practical workflows combining serial logs, Docker service status, database queries, and MQTT observation to resolve sensor, actuator, and watchdog issues.
• Use Case: When an ESP32 repeatedly reboots and stops publishing sensor data, use this Skill to analyze serial output, evaluate boot-loop counters, inspect circuit-breaker events, and correlate server-side heartbeat logs to determine root cause and remediation steps.

Quick Start

Open the primary ESP32 serial log and inspect boot, error code, and circuit-breaker patterns to determine whether the device is in safe mode, experiencing hardware faults, or suffering connectivity problems.