Interaction gRPC locale avec PLCnext Control via grpcurl dans un conteneur OCI

Ceci est le dernier épisode d'une série sur l'utilisation de gRPC pour interagir avec le runtime PLCnext sur un dispositif PLCnext Control.

Les articles précédents de la série incluaient :

• gRPC à distance avec grpcurl
• gRPC à distance sécurisé avec grpcurl
• gRPC à distance avec réflexion

Les articles ci-dessus montrent comment accéder au serveur gRPC sur un dispositif PLCnext Control depuis un dispositif client distancié. Cet article donne un exemple d'un client gRPC local — c'est-à-dire un client gRPC s'exécutant sur un dispositif PLCnext Control, qui accède au serveur gRPC sur le même dispositif.

D'autres exemples de clients gRPC locaux sur des dispositifs PLCnext Control peuvent être trouvés ici :

• Comment créer un client pour le serveur gRPC PLCnext Control en C#
• Utiliser gRPC pour interfacer des scripts Python avec des projets PLCnext Engineer.

Comme il n'y a pas de logiciel client gRPC installé par défaut sur les dispositifs PLCnext Control, cet article montre comment exécuter un client gRPC (dans ce cas, grpcurl) dans un conteneur OCI en utilisant Podman et une image appropriée depuis dockerhub.

Prérequis

1. Un dispositif PLCnext Control approprié, avec accès Internet. Exemples : AXC F 3152 avec firmware 2025.0 ou ultérieur ; AXC F 1252 avec firmware 2026.0 ou ultérieur. Actuellement, l'image OCI utilisée dans cet article n'est pas disponible pour les cibles armv7 comme l'AXC F 2152.

2. Dans un navigateur, ouvrez le site de gestion web (WBM) sur le dispositif et, sur la page Services système, assurez-vous que la fonctionnalité GRPC LOCAL SERVER est activée.

Procédure :

1. Ouvrez une session shell sécurisée sur le dispositif PLCnext Control en utilisant le compte utilisateur admin.

2. Dans la session shell, exécutez la commande suivante :

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

   Cela télécharge une image OCI contenant l'outil en ligne de commande grpcurl sur le dispositif PLCnext Control.

3. Listez les services gRPC disponibles sur le dispositif 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 

   Réponse :

   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. (Optionnel) Créez un alias pour simplifier les commandes grpcurl ultérieures :

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

5. Récupérez la température de la carte du dispositif PLCnext Control :

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

   Réponse :

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

Note :

Le blog Makers présente des applications et des histoires d'utilisateurs de membres de la communauté qui ne sont pas testés ou revus par Phoenix Contact. Utilisez-les à vos propres risques.