Développer une application console PLCnext en C# : guide pour débutants

Ce tutoriel montre comment créer une simple application console « Hello World » pour un contrôleur PLCnext Control. L'application est écrite en C# et cible .NET Core.

Note : ce tutoriel concerne les applications C# s'exécutant entièrement en dehors du PLCnext Runtime. Pour les applications C# ciblant l'eCLR, consultez la section eCLR du PLCnext Info Center.

Le tutoriel d'installation montrait comment installer .NET Core sur un PLC. Dans ce cas, plusieurs applications .NET Core peuvent tourner sur le PLC, avec duplication minimale des DLL communes.

Alternative : exécuter une application .NET Core sur un PLC sans framework .NET Core installé. Toutes les dépendances .NET requises sont déployées avec l'application. Adapté aux projets ne nécessitant qu'une seule application .NET Core sur le PLC.

Ce tutoriel traite ce second type.

Utilisé :

• AXC F 2152 avec firmware 2021.0.3. .NET Core non requis.
• Visual Studio 2019. Aucun add-in ou SDK PLCnext spécifique requis.

Procédure

1. Dans Visual Studio, créer un nouveau projet avec le modèle C# Console App (.NET Core).

2. Ajouter un fichier runtimeconfig.template.json à la racine du projet, contenant :

   {
     "configProperties": {
       "System.Globalization.Invariant": true
     }
   }
   

   La raison de ce paramètre est expliquée dans la section « Background Information » du tutoriel d'installation.

3. Ajouter cette ligne dans la section PropertyGroup du fichier projet (.csproj) :

   <RuntimeIdentifiers>linux-arm</RuntimeIdentifiers>
   

   Cela indique au compilateur de cibler une plateforme Linux 32 bits. Le .csproj devrait ressembler à :

   <Project Sdk="Microsoft.NET.Sdk">
     <PropertyGroup>
       <OutputType>Exe</OutputType>
       <TargetFramework>netcoreapp3.1</TargetFramework>
       <RuntimeIdentifiers>linux-arm</RuntimeIdentifiers>
     </PropertyGroup>
   </Project>
   

4. Dans l'Explorateur de solutions, clic droit sur la solution > ouvrir un Terminal.

5. Dans le terminal, exécuter :

   dotnet build ConsoleApp1.csproj
   dotnet publish -c RELEASE -r linux-arm ConsoleApp1.csproj -o MyApp
   

   ConsoleApp1 = nom de la solution, MyApp = répertoire de sortie. Publication possible en mode DEBUG.

6. Copier le répertoire de sortie et son contenu sur le PLC (ex: WinSCP).

7. Ouvrir une session shell sur le PLC (ex: PuTTY ou ssh).

8. Vérifier le format de l'exécutable :

   file /opt/plcnext/MyApp/ConsoleApp1
   ConsoleApp1: ELF 32-bit LSB executable, ARM, EABI5 version 1 (SYSV), dynamically linked, interpreter /lib/ld-linux-armhf.so.3, for GNU/Linux 2.6.32, BuildID[sha1]=887a06cd9735de5da4b686517f69d68779571cec, stripped
   

   Cela confirme que l'application est compilée pour la bonne plateforme.

9. Donner les droits d'exécution :

   chmod a+x /opt/plcnext/MyApp/ConsoleApp1
   

10. Exécuter l'application :

    /opt/plcnext/MyApp/ConsoleApp1
    Hello World!
    

Questions / commentaires ?

Pour toute question ou commentaire, posez-les sur le forum PLCnext Community.