Interacción gRPC Local con PLCnext Control mediante grpcurl en Contenedor OCI

Esta es la última entrega de una serie sobre el uso de gRPC para interactuar con el Runtime de PLCnext en un dispositivo PLCnext Control.

Publicaciones anteriores en la serie incluyeron:

• gRPC remoto usando grpcurl
• gRPC remoto seguro usando grpcurl
• gRPC remoto usando reflexión

Los artículos listados arriba muestran cómo acceder al servidor gRPC en un dispositivo PLCnext Control desde un dispositivo cliente remoto. Esta publicación da un ejemplo de un cliente gRPC local, es decir, un cliente gRPC que se ejecuta en un dispositivo PLCnext Control, que accede al servidor gRPC en el mismo dispositivo.

Otros ejemplos de clientes gRPC locales en dispositivos PLCnext Control se pueden encontrar aquí:

• Cómo crear un cliente para el servidor gRPC de PLCnext Control en C#
• Use gRPC para interconectar scripts Python con proyectos PLCnext Engineer.

Dado que no hay software cliente gRPC instalado en dispositivos PLCnext Control como estándar, este artículo muestra cómo ejecutar un cliente gRPC (en este caso, grpcurl) en un contenedor OCI usando Podman y una imagen adecuada de dockerhub.

Requisitos previos

1. Un dispositivo PLCnext Control adecuado, con acceso a internet. Ejemplos: AXC F 3152 con versión de firmware 2025.0 o posterior; AXC F 1252 con versión de firmware 2026.0 o posterior. Actualmente, la imagen OCI usada en este artículo no está disponible para objetivos armv7 como el AXC F 2152.

2. En un navegador, abra el sitio de Gestión Basada en Web (WBM) en el dispositivo y, en la página Servicios del Sistema, asegúrese de que la función SERVIDOR GRPC LOCAL esté activada.

Procedimiento:

1. Abra una sesión de shell seguro en el dispositivo PLCnext Control usando la cuenta de usuario admin.

2. En la sesión de shell, ejecute el siguiente comando:

   podman pull docker.io/fullstorydev/grpcurl:latest-alpine
   

   Esto descarga una imagen OCI que contiene la herramienta de línea de comandos grpcurl al dispositivo PLCnext Control.

3. Liste los servicios gRPC disponibles en el dispositivo PLCnext Control local:

   podman run -it --rm -v /run/plcnext/:/run/plcnext/ --userns=keep-id docker.io/fullstorydev/grpcurl:latest-alpine --plaintext unix:///run/plcnext/grpc.sock list
   

   Respuesta:

   Arp.Device.Interface.Services.Grpc.IDeviceControlService
   Arp.Device.Interface.Services.Grpc.IDeviceInfoService
   Arp.Device.Interface.Services.Grpc.IDeviceSettingsService
   Arp.Device.Interface.Services.Grpc.IDeviceStatusService
   Arp.Io.Axioline.Services.Grpc.IAcyclicCommunicationService
   Arp.Io.Axioline.Services.Grpc.IAxioMasterService
   Arp.Plc.Gds.Services.Grpc.IDataAccessService
   Arp.Plc.Gds.Services.Grpc.IForceService
   Arp.Plc.Gds.Services.Grpc.ISubscriptionService
   Arp.Services.DataLogger.Services.Grpc.IDataLoggerService2
   Arp.Services.NotificationLogger.Services.Grpc.INotificationLoggerService
   Arp.System.Commons.Services.Io.Grpc.IDirectoryService
   Arp.System.Commons.Services.Io.Grpc.IFileService
   Arp.System.Commons.Services.Io.Grpc.IFileSystemInfoService
   Arp.System.Lm.Services.Grpc.ILicenseStatusService
   Arp.System.Nm.Services.Grpc.INotificationManagerService
   Arp.System.Security.Services.Grpc.IAuthenticationService
   Arp.System.Um.Services.Grpc.IAuthorizationInfoService
   Arp.System.Um.Services.Grpc.IPasswordAuthenticationService
   grpc.reflection.v1.ServerReflection
   grpc.reflection.v1alpha.ServerReflection
   

4. (Opcional) Cree un alias para simplificar comandos grpcurl posteriores:

   alias grpcurl="podman run -it --rm -v /run/plcnext/:/run/plcnext/ --userns=keep-id docker.io/fullstorydev/grpcurl:latest-alpine"
   

5. Recupere la temperatura de la placa del dispositivo PLCnext Control:

   grpcurl -format json -d '{"identifier":"Status.Board.Temperature.Centigrade"}' --plaintext unix:///run/plcnext/grpc.sock Arp.Device.Interface.Services.Grpc.IDeviceStatusService.GetItem
   

   Respuesta:

   {
   "_ReturnValue": {
   "TypeCode": "CT_Int8",
   "Int8Value": 46
   }
   }
   

Nota:

El Makers Blog muestra aplicaciones e historias de usuarios de miembros de la comunidad que no son probadas ni revisadas por Phoenix Contact. Úselas bajo su propio riesgo.