Soporte
Traducción al español. Original en inglés: SUPPORT.md.
Gracias por usar la TIA Openness API. Así puedes obtener ayuda.
Antes de abrir un issue
- Consulta la guía Primeros pasos y la configuración del MCP / clientes (docs/INSTALL.es.md): la mayoría de los problemas de configuración están cubiertos allí.
- Ejecuta los diagnósticos integrados:
- En la GUI de la bandeja del sistema: pestaña API → Check environment (verifica el grupo de Windows, el proceso x64, TIA Portal V21 + PublicAPI).
- Desde un cliente de IA: llama a
tia_ping.reachable:falsesignifica que IP/puerto/firewall/serveno está disponible;activated:falsesignifica que la licencia falta o no es válida en el host; ambostruesignifica que todo está listo.
- Revisa el CHANGELOG (en inglés): tu problema puede estar ya corregido en una versión más reciente.
Canales
| Necesidad | Dónde |
|---|---|
| 🐛 Informe de error | Nuevo issue → Bug report |
| 💡 Solicitud de funcionalidad | Nuevo issue → Feature request |
| 💬 Pregunta / solicitud de licencia | Nuevo issue → Question |
| 🔒 Divulgación de vulnerabilidades | No abras un issue público: consulta más abajo. |
El soporte prioritario (por correo electrónico, con objetivos de tiempo de respuesta según el nivel) está incluido en una licencia de pago, y el contacto se entrega junto con tu Activation License.
Qué incluir en un informe de error
Nos ayuda mucho que incluyas:
- Versión de la aplicación (la etiqueta
app-v*, que se muestra en la GUI / el instalador). - Versión de TIA Portal y la CPU de destino (p. ej., S7-1200 1214C, versión de firmware).
- Qué hiciste, qué esperabas y qué ocurrió (con el texto exacto del error / envelope).
- Si usabas la API directamente, mediante el MCP o mediante el plugin harness.
- La salida de Check environment /
tia_ping, si es relevante.
Divulgación de vulnerabilidades
Si crees haber encontrado una vulnerabilidad de seguridad, infórmala de forma privada: abre un GitHub security advisory en lugar de un issue público, para que pueda corregirse antes de su divulgación.
Alcance
Este repositorio da seguimiento a la aplicación / API (el producto con licencia). Para las capas de cliente abiertas:
- MCP
tia: issues en el repositorio del MCP. - Plugin
tia-harness: issues en renanlido/tia-harness.