DevOps / Despliegue

Despliegue automatizado de PLC
para proyectos TIA Portal

Automatice el ciclo de vida completo del despliegue: compile hardware y software, establezca conexiones en línea, compare estados online/offline, descargue firmware y programas al PLC y controle el estado de ejecución de la CPU, todo programado mediante REST API.

Automatización completa del ciclo de vida del despliegue

Cada paso desde el código fuente hasta el PLC en funcionamiento, programable y repetible

Compilación

Compile la configuración de hardware y los bloques de software de forma individual o conjunta. Los resultados de la compilación incluyen errores y advertencias; intégrelos en pipelines CI para condicionar el despliegue a builds exitosos.

Conexión en línea

Establezca y finalice conexiones en línea con los PLCs. Soporta PLCSim Softbus, PROFINET y sobrescritura manual de rutas. Autodetección de parámetros de conexión o especificación explícita de puntos de acceso.

Ámbitos de descarga

Elija el ámbito de descarga por despliegue: solo software, solo hardware, hardware y software combinados, o solo cambios de software para actualizaciones de impacto mínimo. Control preciso sobre lo que llega al PLC.

Gestión del estado de la CPU

Inicie y detenga la CPU mediante programación. Lea el estado actual de la CPU antes y después del despliegue. Cree secuencias de despliegue seguras que transicionen la CPU por STOP, descarga y RUN automáticamente.

Soporte para PLC protegido por contraseña

Autentíquese ante PLCs protegidos por contraseña antes de entrar en línea. Establezca, actualice y borre credenciales de autenticación en línea a través de la API para soportar entornos de producción seguros.

Protecciones de seguridad

El flag confirmPhysicalDownload evita descargas accidentales a hardware real; solo los objetivos PLCSim permiten descargas sin confirmación explícita. Una barrera crítica para pipelines CI/CD dirigidos a PLCs físicos.

Flujo de trabajo de despliegue estándar

Cinco pasos desde el código compilado hasta un PLC en funcionamiento

1

Compilar

Active la compilación de hardware y software mediante compile_device o compile_block. Compruebe el resultado en busca de errores antes de continuar. Una compilación fallida aborta el despliegue.

2

Entrar online

Llame a go_online con el dispositivo de destino. T-IA Connect resuelve el punto de acceso automáticamente o acepta una ruta manual. Verifique el estado de la conexión con get_online_state antes de continuar.

3

Comparar online / offline

Ejecute compare_online_offline para comprobar si el PLC ya coincide con el proyecto. Omita descargas innecesarias si no se detecta delta, reduciendo la interrupción del PLC en producción.

4

Descargar al PLC

Ejecute download_to_plc con el ámbito elegido (Software, Hardware, HardwareAndSoftware o SoftwareOnlyChanges). Establezca confirmPhysicalDownload a true solo cuando se dirija a hardware real intencionadamente.

5

Iniciar CPU

Emita start_cpu para transicionar el PLC de STOP a RUN. Confirme el estado final con get_cpu_state. Registre el resultado para la pista de auditoría y los informes de CI.

Scripting de despliegue con REST API

Integre el despliegue de PLC en cualquier herramienta CI/CD utilizando llamadas HTTP estándar

Compilar y comprobar resultado

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

Entrar online y descargar

# Entrar online
curl -X POST http://localhost:5000/api/go-online \
  -H 'Content-Type: application/json' \
  -d {"deviceName": "PLC_1"}\n\n# Descargar solo 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 y verificar estado

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

Herramientas de despliegue disponibles

Todas las herramientas son accesibles vía REST API y protocolo MCP

HerramientaDescripción
compile_deviceCompila el dispositivo completo (hardware + software) y devuelve errores y advertencias.
compile_blockCompila un único bloque de programa. Útil para comprobaciones previas específicas en pipelines CI.
go_onlineEstablece una conexión online con el PLC. Soporta PLCSim, PROFINET y ruta manual.
go_offlineFinaliza la conexión online y devuelve el dispositivo al modo offline.
get_online_stateDevuelve el estado de conexión online/offline actual de un dispositivo.
download_to_plcDescarga los datos del proyecto al PLC. Ámbito: Software, Hardware, HardwareAndSoftware, SoftwareOnlyChanges.
upload_from_plcSube el programa actual del PLC de vuelta al proyecto de TIA Portal.
compare_online_offlineCompara el estado online del PLC con el proyecto offline para detectar deltas.
start_cpuTransiciona la CPU de estado STOP a RUN.
stop_cpuTransiciona la CPU de estado RUN a STOP antes de una descarga.
get_cpu_stateLee el estado operativo actual de la CPU (RUN, STOP, STARTING, etc.).
list_access_pointsEnumera todos los puntos de acceso configurados para resolver las rutas de conexión del PLC.
list_parameter_setsEnumera los conjuntos de parámetros disponibles para la configuración de la conexión.
get_pgpc_diagnosticRecupera diagnósticos de la interfaz PG/PC para solucionar problemas de conexión.

Despliegue su primer PLC automáticamente

Deje de hacer clics en TIA Portal. Programe todo su pipeline de despliegue una vez y ejecútelo en cada commit.