# ESP32-C5 GDB Debugging Guide - README Two versions of the comprehensive GDB debugging guide have been created: ## Files 1. **ESP32-C5_GDB_Debugging_Guide.md** - Markdown version - Perfect for GitHub, documentation sites, or conversion to other formats - Clean, portable, works everywhere 2. **ESP32-C5_GDB_Debugging_Guide.html** - HTML version - Professional web-ready format with styling - Responsive design (mobile-friendly) - Direct upload to website ## Content Overview ### Complete Coverage: 1. **Introduction** - ESP32-C5 overview and debugging benefits 2. **Why GDB?** - Comparison with printf debugging 3. **Hardware Capabilities** - Built-in USB-JTAG features 4. **Prerequisites** - Required software and hardware 5. **Building with Debug Symbols** - Step-by-step configuration 6. **Starting Debug Session** - Three-step process (flash, OpenOCD, GDB) 7. **Essential Commands** - Comprehensive GDB command reference 8. **Debugging Strategies** - Five proven strategies 9. **Real-World Examples** - Five complete debugging scenarios: - CSI configuration failure (your actual problem!) - Memory corruption detection - WiFi connection troubleshooting - Performance profiling - Stack overflow debugging 10. **Troubleshooting** - Common problems and solutions 11. **Advanced Techniques** - Scripting, FreeRTOS, live modification 12. **Resources** - Links to official docs and community ## Key Features - ✅ **Based on your actual ESP32-C5 experience** - ✅ **Real debugging examples from CSI issues** - ✅ **Complete command reference** - ✅ **Troubleshooting guide** - ✅ **Professional web design** (HTML version) - ✅ **Ready to publish** ## Publishing Options ### Option 1: GitHub Pages ```bash # Add to your GitHub repo docs/ git add ESP32-C5_GDB_Debugging_Guide.md git commit -m "Add GDB debugging guide" git push ``` ### Option 2: Direct Website Upload ```bash # Upload the HTML file to your web server scp ESP32-C5_GDB_Debugging_Guide.html user@yoursite.com:/var/www/html/ ``` ### Option 3: Static Site Generator ```bash # The markdown works with Jekyll, Hugo, MkDocs, etc. cp ESP32-C5_GDB_Debugging_Guide.md docs/ # Build your static site ``` ## Customization ### HTML Styling The HTML version includes CSS in the `