DevOps / Implantação

Implantação Automatizada de PLC
para Projetos TIA Portal

Automatize o ciclo de vida completo de implantação: compile hardware e software, estabeleça conexões online, compare estados online/offline, faça download de firmware e programas para o PLC e controle o estado de execução da CPU - tudo via script por REST API.

Automação Completa do Ciclo de Vida de Implantação

Cada etapa, do código-fonte ao PLC em execução, programável e repetível

Compilação

Compile a configuração de hardware e os blocos de software individualmente ou em conjunto. Os resultados da compilação incluem erros e avisos - integre em pipelines de CI para validar a implantação em compilações bem-sucedidas.

Conexão Online

Estabeleça e encerre conexões online com PLCs. Suporta PLCSim Softbus, PROFINET e sobreposições de caminho manuais. Detecte automaticamente os parâmetros de conexão ou especifique pontos de acesso explicitamente.

Escopos de Download

Escolha o escopo do download por implantação: Somente Software, Somente Hardware, Hardware e Software combinados ou Somente Alterações de Software para atualizações de impacto mínimo. Controle preciso sobre o que chega ao PLC.

Gerenciamento de Estado da CPU

Inicie e pare a CPU de forma programática. Leia o estado atual da CPU antes e depois da implantação. Crie sequências de implantação seguras que transicionem a CPU por STOP, download e RUN automaticamente.

Suporte a PLC Protegido por Senha

Autentique-se em PLCs protegidos por senha antes de entrar online. Defina, atualize e limpe credenciais de autenticação online via API para oferecer suporte a ambientes de produção seguros.

Proteções de Segurança

A flag confirmPhysicalDownload evita downloads acidentais para hardware real - apenas alvos PLCSim permitem downloads sem confirmação explícita. Uma barreira de segurança crítica para pipelines de CI/CD direcionados a PLCs físicos.

Fluxo de Trabalho de Implantação Padrão

Cinco etapas do código compilado a um PLC em execução

1

Compilar

Acione a compilação de hardware e software via compile_device ou compile_block. Verifique se há erros no resultado antes de prosseguir. Uma compilação com falha aborta a implantação.

2

Entrar Online

Chame go_online com o dispositivo de destino. O T-IA Connect resolve o ponto de acesso automaticamente ou aceita um caminho manual. Verifique o estado da conexão com get_online_state antes de prosseguir.

3

Comparar Online / Offline

Execute compare_online_offline para verificar se o PLC já corresponde ao projeto. Pule downloads desnecessários se nenhum delta for detectado, reduzindo a interrupção do PLC na produção.

4

Download para PLC

Execute download_to_plc com o escopo escolhido (Software, Hardware, HardwareAndSoftware ou SoftwareOnlyChanges). Defina confirmPhysicalDownload como true apenas quando o hardware real for o alvo intencional.

5

Iniciar CPU

Emita start_cpu para transicionar o PLC de STOP para RUN. Confirme o estado final com get_cpu_state. Registre o resultado para trilha de auditoria e relatórios de CI.

Scripting de Implantação REST API

Integre a implantação de PLC em qualquer ferramenta de CI/CD usando chamadas HTTP padrão

Compilar e verificar resultado

# Compile o dispositivo (hardware + software)
curl -X POST http://localhost:5000/api/compile-device \
  -H 'Content-Type: application/json' \
  -d {"deviceName": "PLC_1"}

Entrar online e fazer download

# Entrar online
curl -X POST http://localhost:5000/api/go-online \
  -H 'Content-Type: application/json' \
  -d {"deviceName": "PLC_1"}\n\n# Baixar apenas software
curl -X POST http://localhost:5000/api/download-to-plc \
  -H 'Content-Type: application/json' \
  -d {"deviceName": "PLC_1", "scope": "Software", "confirmPhysicalDownload": true}

Iniciar CPU e verificar estado

# Iniciar a CPU
curl -X POST http://localhost:5000/api/start-cpu \
  -H 'Content-Type: application/json' \
  -d {"deviceName": "PLC_1"}\n\n# Ler estado da CPU
curl -X GET 'http://localhost:5000/api/get-cpu-state?deviceName=PLC_1'

Ferramentas de Implantação Disponíveis

Todas as ferramentas são acessíveis via REST API e protocolo MCP

FerramentaDescrição
compile_deviceCompila o dispositivo completo (hardware + software) e retorna erros e avisos.
compile_blockCompila um único bloco de programa. Útil para pré-verificações direcionadas em pipelines de CI.
go_onlineEstabelece uma conexão online com o PLC. Suporta PLCSim, PROFINET e caminho manual.
go_offlineEncerra a conexão online e retorna o dispositivo ao modo offline.
get_online_stateRetorna o estado atual da conexão online/offline de um dispositivo.
download_to_plcFaz download dos dados do projeto para o PLC. Escopo: Software, Hardware, HardwareAndSoftware, SoftwareOnlyChanges.
upload_from_plcCarrega o programa atual do PLC de volta para o projeto do TIA Portal.
compare_online_offlineCompara o estado online do PLC com o projeto offline para detectar deltas.
start_cpuTransiciona a CPU do estado STOP para o estado RUN.
stop_cpuTransiciona a CPU do estado RUN para o estado STOP antes de um download.
get_cpu_stateLê o estado operacional atual da CPU (RUN, STOP, STARTING, etc.).
list_access_pointsLista todos os pontos de acesso configurados para resolver caminhos de conexão do PLC.
list_parameter_setsLista os conjuntos de parâmetros disponíveis para configuração de conexão.
get_pgpc_diagnosticRecupera diagnósticos da interface PG/PC para solucionar problemas de conexão.

Implante seu primeiro PLC automaticamente

Pare de clicar no TIA Portal. Crie o script de todo o seu pipeline de implantação uma vez e execute-o a cada commit.