Saltar al contenido
PLCWare

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

  1. 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í.
  2. 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:false significa que IP/puerto/firewall/serve no está disponible; activated:false significa que la licencia falta o no es válida en el host; ambos true significa que todo está listo.
  3. Revisa el CHANGELOG (en inglés): tu problema puede estar ya corregido en una versión más reciente.

Canales

NecesidadDónde
🐛 Informe de errorNuevo issue → Bug report
💡 Solicitud de funcionalidadNuevo issue → Feature request
💬 Pregunta / solicitud de licenciaNuevo issue → Question
🔒 Divulgación de vulnerabilidadesNo 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: