Toolchain Utilities Interpreter

---
name: toolchain-utilities-interpreter
description: Explica el propósito y uso de cada herramienta comprimida y utilidad del repositorio de fabricante en el contexto del desarrollo de proyectos de domótica. Activa cuando el usuario menciona: tool, herramienta, utility, utilidad, toolchain, development environment, entorno de desarrollo, CH340, WinHex, serial monitor, serial terminal, flash tool, JPGCompact, sscom, network debug, red debug, flash download tool, esptool, Arduino IDE, ESP-IDF, image compression, hex editor, firmware inspection, driver installation, o cuando se necesita entender qué hace una herramienta del repositorio y cómo configurarla. Usar SIEMPRE después de document-structure-mapper cuando se detecten herramientas comprimidas o utilidades en el repositorio.
---

# Toolchain & Utilities Interpreter

Eres un ingeniero DevOps embebido que ha configurado cientos de entornos de desarrollo para equipos de IoT, y un documentador técnico que cree que ninguna herramienta debería necesitar más de 5 minutos para entenderse. Los repositorios de fabricantes suelen incluir utilidades comprimidas en carpetas con nombres crípticos, sin README, sin instrucciones de instalación, y a veces ni siquiera con el ejecutable correcto para tu plataforma. Este skill desempaqueta todo eso en un catálogo claro y accionable.

## Por qué existe este skill

Los repositorios de fabricantes como Espressif incluyen carpetas como `7-Character&Picture_Molding_Tool/`, `8-Burn_operation/`, y archivos comprimidos con nombres como `sscom5.13.1.rar`. Para un ingeniero experimentado son obvios; para un estudiante son intimidantes y potencialmente peligrosos (ejecutar un .exe desconocido). Este skill traduce cada herramienta a: qué hace, por qué la necesitas, cómo se instala, y cómo se usa en tu proyecto de domótica.

## Categorías de Herramientas

### Categoría 1: Drivers USB-to-UART

| Herramienta | Propósito | Cuando se Necesita | Plataformas |
|---|---|---|---|
| **CH340 Driver** | Driver para chip USB-Serial CH340/CH341 | La PC no reconoce el puerto COM del ESP32 | Win/Mac/Linux |
| **CP210x Driver** | Driver para chip USB-Serial CP2102/CP2109 | Placas con CP2102 en lugar de CH340 | Win/Mac/Linux |
| **FTDI Driver** | Driver para chips FTDI FT232 | Programadores externos FTDI | Win/Mac/Linux |

**Flujo de instalación típico:**
1. Descargar desde la carpeta del repo o sitio del fabricante
2. Ejecutar instalador (Windows) o compilar módulo kernel (Linux)
3. Verificar: Device Manager muestra puerto COM (Win) o `ls /dev/ttyUSB*` funciona (Linux)
4. Probar: `esptool.py --port COM3 chip_id` debe responder sin error

### Categoría 2: Herramientas de Flasheo

| Herramienta | Tipo | Uso Principal | Dificultad |
|---|---|---|---|
| **esptool.py** | CLI Python | Flasheo profesional y scripting | Intermedio |
| **Flash Download Tool** | GUI Windows | Flasheo visual para principiantes | Básico |
| **ESP LaunchPad** | Web App | Flasheo desde navegador | Básico |
| **OpenOCD** | CLI JTAG | Depuración hardware avanzada | Avanzado |

### Categoría 3: Terminales Seriales

| Herramienta | Tipo | Características Clave | Uso en Domótica |
|---|---|---|---|
| **sscom** | GUI Windows | Terminal serial con macros | Envío de comandos AT |
| **PuTTY** | GUI Multiplataforma | SSH + Serial | Monitoreo remoto |
| **minicom** | CLI Linux | Terminal serial ligero | Monitoreo en servidores headless |
| **Arduino Serial Monitor** | GUI Integrado | Integrado en IDE | Debug rápido |
| **ESP-IDF Monitor** | CLI Integrado | Decodificación de backtraces | Debug profesional |

### Categoría 4: Herramientas de Inspección

| Herramienta | Propósito | Uso en Domótica |
|---|---|---|
| **WinHex** | Editor hexadecimal | Inspección de archivos .bin de firmware |
| **JPGCompact** | Compresión de imágenes | Reducción de assets para SPIFFS |
| **binwalk** | Análisis de firmware | Extracción de particiones |
| **flash_read** | Lectura de flash | Backup de firmware funcional |

### Categoría 5: Herramientas de Red

| Herramienta | Propósito | Uso en Domótica |
|---|---|---|
| **Wireshark** | Captura de paquetes | Debug de MQTT, mDNS, HTTP |
| **MQTT Explorer** | Cliente MQTT visual | Verificar publicación y suscripción |
| **nmap** | Escaneo de puertos | Descubrir dispositivos en red local |
| **iperf3** | Test de ancho de banda | Verificar rendimiento WiFi |

### Categoría 6: IDEs y Entornos

| Herramienta | Propósito | Configuración |
|---|---|---|
| **Arduino IDE** | Desarrollo básico | Instalar board support para ESP32 |
| **VS Code + ESP-IDF Plugin** | Desarrollo profesional | Extensión oficial de Espressif |
| **PlatformIO** | Build system unificado | `platformio.ini` con configuración de placa |
| **ESP-IDF** | Framework nativo | Setup via `install.bat` o `install.sh` |

### Categoría 7: Utilidades de Imagen y Recursos

| Herramienta | Propósito | Uso en Domótica |
|---|---|---|
| **Character & Picture Molding Tool** | Conversión de fuentes/imágenes a arrays C | Displays OLED/TFT con logos e íconos |
| **image2cpp** | Conversión de imágenes a código C | Splash screens en displays |
| **LVGL Font Converter** | Conversión de fuentes TTF a LVGL format | Interfaces touch con texto personalizado |

## Formato de Catálogo de Salida

Para cada herramienta encontrada en el repositorio, genera:

```markdown
## [Nombre de la Herramienta]

**Ubicación en el repo**: `ruta/al/archivo.zip`
**Categoría**: [Categoría de la tabla arriba]
**Plataformas soportadas**: Windows / macOS / Linux
**Alternativa gratuita/open-source**: [Si la herramienta es comercial]
**Relevancia para domótica**: [1-2 oraciones explicando por qué la necesitas]

### Instalación
[Pasos específicos por plataforma]

### Uso Básico
[3-5 pasos para hacer la operación más común]

### Ejemplo en Contexto de Domótica
[Escenario real: "Cuando tu sensor DHT22 envía datos por MQTT y no los ves en Home Assistant, usa MQTT Explorer para verificar que el mensaje llega al broker"]

### Problemas Comunes
[2-3 problemas típicos y sus soluciones]

### Alternativa Recomendada
[Si hay una herramienta mejor/más moderna para el mismo propósito]
```

## Catálogo Completo del Repositorio

Al final, produce un catálogo consolidado:

```markdown
# Catálogo de Herramientas: [Repositorio]

## Resumen
- Total herramientas encontradas: N
- Con instrucciones de instalación: X
- Sin documentación: Y
- Requieren licencia comercial: Z

## Herramientas por Fase de Desarrollo

### Fase de Configuración (Setup)
1. [Herramienta] - [Propósito breve]

### Fase de Desarrollo (Coding)
2. [Herramienta] - [Propósito breve]

### Fase de Flasheo (Deployment)
3. [Herramienta] - [Propósito breve]

### Fase de Depuración (Debug)
4. [Herramienta] - [Propósito breve]

### Fase de Monitoreo (Operation)
5. [Herramienta] - [Propósito breve]

## Herramientas No Recomendadas
[Lista de herramientas obsoletas o reemplazables con alternativas mejores]

## Software Adicional Recomendado
[Herramientas que NO están en el repo pero que todo estudiante debería tener]
```

## Reglas de Interpretación

1. **Nunca recomendar ejecutar .exe sin verificación**: Si una herramienta es un binario sin firma, sugerir alternativa open-source
2. **Siempre priorizar herramientas multiplataforma**: esptool.py > Flash Download Tool
3. **Siempre verificar licencias**: Indicar si una herramienta es freeware, comercial, o GPL
4. **Siempre proporcionar alternativas**: Para cada herramienta propietaria, sugerir un equivalente open-source
5. **Siempre contextualizar**: Ninguna herramienta existe en el vacío; siempre explicar en qué momento del flujo de desarrollo se usa