🚀 VS Code Template para Microcontroladores

Configuración profesional optimizada para desarrollo de STM32, ESP32, Arduino y más

✨ Características Principales

• 🎯 Sin conflictos IntelliSense - Configuración optimizada Microsoft C++ vs clangd
• ⚡ Multi-plataforma - STM32, ESP32, Arduino, Python/MicroPython
• 🧠 IntelliSense avanzado - Autocompletado inteligente con clangd
• 🐛 Debugging profesional - Configuraciones para ST-Link, ESP-IDF, PlatformIO
• 🎨 Snippets personalizados - Código rápido para microcontroladores
• 📋 15+ extensiones - Stack completo preconfigurado
• 🔧 Configuración optimizada - Performance y productividad maximizada

🛠️ Extensiones Incluidas

Core Development

• PlatformIO IDE - Desarrollo de microcontroladores
• ESP-IDF Extension - Desarrollo ESP32 avanzado
• STM32Cube clangd - IntelliSense STM32 optimizado
• Microsoft C/C++ - Soporte C/C++ básico

Python & Scripting

• Python - Desarrollo Python/MicroPython
• Pylance - IntelliSense Python avanzado
• autoDocstring - Documentación automática

Productividad

• Material Icon Theme - Iconos profesionales
• Better C++ Syntax - Resaltado mejorado
• Code Runner - Ejecución rápida
• Hex Editor - Editor hexadecimal

📦 Instalación Rápida

Método 1: Clonar Template

# Clonar en tu proyecto
git clone https://github.com/tu-usuario/vscode-microcontrollers-template.git
cd vscode-microcontrollers-template

# Copiar configuración a tu proyecto
cp -r .vscode /path/to/your/project/

Método 2: Script Automático

# Descargar e instalar automáticamente
curl -fsSL https://raw.githubusercontent.com/tu-usuario/vscode-microcontrollers-template/main/install.sh | bash

Método 3: VS Code Profile

1. Descargar archivo microcontrollers-profile.code-profile
2. VS Code → Cmd+Shift+P → "Profiles: Import Profile"
3. Seleccionar el archivo descargado

🚀 Uso Rápido

Nuevo Proyecto PlatformIO

# Crear proyecto PlatformIO
pio project init --board esp32dev

# Aplicar configuración
cp -r path/to/template/.vscode ./

# Abrir VS Code
code .

Configuración ESP-IDF

# Aplicar template
cp -r .vscode path/to/esp-idf-project/

# Configurar ESP-IDF
cd path/to/esp-idf-project
idf.py menuconfig

⌨️ Atajos de Teclado

Acción	Atajo	Descripción
Build	Cmd+Shift+B	Compilar proyecto
Upload	Cmd+Shift+U	Subir firmware
Debug	F5	Iniciar debugging
Monitor	Cmd+Shift+M	Monitor serie
Clean	Cmd+Shift+Alt+C	Limpiar build
Task Menu	Cmd+Shift+P	Paleta de comandos

🎨 Snippets Disponibles

Arduino

arduino-setup    // Setup básico Arduino
esp32-wifi       // Configuración WiFi ESP32
gpio-config      // Configuración GPIO

STM32

stm32-gpio       // GPIO HAL STM32
stm32-uart       // UART HAL STM32
stm32-timer      // Timer HAL STM32

Comunicaciones

modbus-frame     // Frame Modbus RTU
uart-init        // Inicialización UART
spi-config       // Configuración SPI

FreeRTOS

freertos-task    // Crear tarea FreeRTOS
freertos-queue   // Cola FreeRTOS
freertos-mutex   // Mutex FreeRTOS

🔧 Configuración Avanzada

Resolver Conflictos IntelliSense

La configuración está optimizada para evitar conflictos entre extensiones:

// Microsoft C++ deshabilitado para evitar conflictos
"C_Cpp.intelliSenseEngine": "disabled",
"C_Cpp.errorSquiggles": "disabled",

// clangd como motor principal
"clangd.arguments": [
    "--compile-commands-dir=${workspaceFolder}/.pio/build"
]

Configuración por Plataforma

STM32

"clangd.arguments": [
    "--query-driver=~/.platformio/packages/toolchain-gccarmnoneeabi/bin/arm-none-eabi-*"
]

ESP32

"idf.espIdfPath": "/path/to/esp-idf",
"idf.pythonPath": "/path/to/python"

🐛 Debugging

PlatformIO Debug

• Debugging nativo integrado
• Soporte para ST-Link, J-Link
• Visualización de registros SVD

ESP-IDF Debug

• OpenOCD integrado
• JTAG debugging
• Monitor GDB

Configuraciones Incluidas

• PIO Debug - Debugging PlatformIO estándar
• PIO Debug (skip Pre-Debug) - Debug sin pre-build
• ST-Link Debug - Debug con ST-Link externo
• ESP-IDF Debug - Debug ESP32 con JTAG

📁 Estructura del Template

.vscode/
├── settings.json           # Configuración principal optimizada
├── tasks.json             # Tareas PlatformIO + ESP-IDF
├── launch.json            # Perfiles de debugging
├── c_cpp_properties.json  # Propiedades C/C++
├── extensions.json        # Extensiones recomendadas
├── snippets/              # Snippets personalizados
│   └── microcontrollers.code-snippets
├── SETUP_GUIDE.md         # Guía de configuración
├── COMMANDS_GUIDE.md      # Guía de comandos
└── EXECUTIVE_SUMMARY.md   # Resumen ejecutivo

🔄 Actualizaciones

Para actualizar la configuración:

# Actualizar desde el repositorio
git pull origin main

# Aplicar cambios a tu proyecto
cp -r .vscode /path/to/your/project/

🤝 Contribuir

1. Fork el repositorio
2. Crea una rama feature (git checkout -b feature/improvement)
3. Commit tus cambios (git commit -am 'Add improvement')
4. Push a la rama (git push origin feature/improvement)
5. Abre un Pull Request

📝 Changelog

v2.1.1 - 2025-10-24

• ✅ Resueltos conflictos IntelliSense Microsoft C++ vs clangd
• ✅ Añadido soporte completo ESP-IDF
• ✅ Optimizaciones de performance
• ✅ Snippets personalizados para microcontroladores
• ✅ Configuración debugging multi-plataforma

v2.0.0 - 2025-10-20

• ✅ Primera versión del template
• ✅ Configuración básica PlatformIO
• ✅ Extensiones fundamentales

📄 Licencia

MIT License - ve LICENSE para más detalles.

🆘 Soporte

• 📧 Email: support@caos-hub.com
• 💬 Issues: GitHub Issues
• 📖 Wiki: Documentación completa

---

¿Te resultó útil? ⭐ Dale una estrella al repositorio!

Made with ❤️ by Caos-Hub