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
- 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.
- 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:falsesignifica que IP/porta/firewall/serveestá fora do ar;activated:falsesignifica que a licença está ausente/inválida no host; ambostruesignifica que você está pronto.
- Consulte o CHANGELOG (em inglês) — seu problema pode já ter sido corrigido numa versão mais recente.
Canais
| Necessidade | Onde |
|---|---|
| 🐛 Relato de bug | Nova issue → Bug report |
| 💡 Solicitação de funcionalidade | Nova issue → Feature request |
| 💬 Pergunta / solicitação de licença | Nova issue → Question |
| 🔒 Divulgação de vulnerabilidade | Nã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:
- MCP
tia— issues em o repositório do MCP. - Plugin
tia-harness— issues em renanlido/tia-harness.