Pular para o conteúdo
PLCWare

Suporte

Tradução em português. Original em inglês: SUPPORT.md.

Obrigado por usar a TIA Openness API. Veja como obter ajuda.

Antes de abrir uma issue

  1. Consulte o guia Primeiros passos e a configuração do MCP / clientes (docs/INSTALL.pt.md) — a maioria dos problemas de configuração está coberta ali.
  2. Execute os diagnósticos integrados:
    • Na GUI de bandeja: aba API → Verificar ambiente (verifica o grupo do Windows, o processo x64, o TIA Portal V21 + PublicAPI).
    • A partir de um cliente de IA: chame tia_ping — reachable:false significa que IP/porta/firewall/serve está fora do ar; activated:false significa que a licença está ausente/inválida no host; ambos true significa que você está pronto.
  3. Consulte o CHANGELOG (em inglês) — seu problema pode já ter sido corrigido numa versão mais recente.

Canais

NecessidadeOnde
🐛 Relato de bugNova issue → Bug report
💡 Solicitação de funcionalidadeNova issue → Feature request
💬 Pergunta / solicitação de licençaNova issue → Question
🔒 Divulgação de vulnerabilidadeNão abra uma issue pública — veja abaixo.

O suporte prioritário (por e-mail, com metas de tempo de resposta por nível) está incluído em uma licença paga, e o contato é entregue junto com a sua Activation License.

O que incluir em um relato de bug

Ajuda muito se você incluir:

  • Versão do app (a tag app-v*, exibida na GUI / no instalador).
  • Versão do TIA Portal e a CPU de destino (ex.: S7-1200 1214C, versão de firmware).
  • O que você fez, o que esperava e o que aconteceu (com o texto exato do erro / envelope).
  • Se você estava usando a API diretamente, via MCP ou via o plugin harness.
  • A saída de Verificar ambiente / tia_ping, se for relevante.

Divulgação de vulnerabilidades

Se você acredita ter encontrado uma vulnerabilidade de segurança, relate-a de forma privada — abra um GitHub security advisory em vez de uma issue pública, para que ela possa ser corrigida antes da divulgação.

Escopo

Este repositório acompanha o app / API (o produto licenciado). Para as camadas de cliente abertas: