Différences

Ci-dessous, les différences entre deux révisions de la page.

--- archives:netmf43:4b_netmfpandapap [2021/08/10 14:56] – [1. Préambule] phil
+++ archives:netmf43:4b_netmfpandapap [2021/08/11 09:19] (Version actuelle) – modification externe 127.0.0.1
@@ Ligne 1: / Ligne 1: @@
+[[archives:netmf43:accueilnetmf|{{ :iconemaison.jpg?nolink&25|Sommaire .NETMF v4.3 }}]]
+===== Premiers programmes en C#  "étape par étape" avec une carte Panda 3 =====
+[Mise à jour le : 16/7/2018]
+{{ :netmf43:netmf.png?nolink|}}
+==== 1. Préambule ====
+Pour mener à bien ce tutoriel vous devez disposer d’une carte <html><a href="https://docs.ghielectronics.com/hardware/duino/fez-panda-iii.html" target="_blank">Panda 3</a></html>. Les [[:archives:netmf43:3_logicielnetmf|outils logiciels]] nécessaires à sa programmation doivent être installés sur le PC. Le firmware de la carte doit être à jour. Si ce n’est pas le cas : suivez le « **Guide d’installation des logiciels** » <html><a href="https://docs.ghielectronics.com/software/netmf/getting-started.html" target="_blank">ici</a></html>.
+Le cours sur les fondamentaux du langage C#, accessible sur <html><a href="https://docs.microsoft.com/fr-fr/learn/paths/csharp-first-steps/" target="_blank">LEARN</a></html> est un excellent préalable et un complément à ce tutoriel.
+On trouvera également des tutoriels en anglais sur le site de la société <html><a href="http://docs.ghielectronics.com/software/netmf/tutorials/intro.html" target="_blank">GHI Electronics</a></html>.
+==== 2. Premier programme : Blink ====
+----
+**Cahier des charges du programme 1**
+Faire clignoter la LED1 de la carte Panda 3 !
+----
+=== Etape 1 : Créer un projet ===
+  * Ouvrez l’**IDE Visual Studio** en cliquant sur l’icône suivante : {{:netmf43:iconevs.png?nolink|}} puis sélectionnez : **Fichier (File) -> Nouveau projet (New Project)** ou **[Ctrl+Maj+N]**,
+  * Dans la boîte de dialogue "Nouveau projet" (New Project) sélectionnez: **Modèles(Templates) -> Visual C# -> Micro Framework et Console Application**.
+{{ :netmf43:fezappli.jpg?nolink |}}
+  * Donnez le nom "**Blink**" à l’application puis cliquez sur **Ok**.
+{{ :netmf43:projpandablink.jpg?nolink |}}
+  * **Cliquez** sur Program.cs dans la fenêtre **Explorateur de solution**
+__Remarque__: L’emplacement (Location) identifié ci-dessous peut changer en fonction de la version du logiciel et de l'arborescence des répertoires du PC.
+L’IDE est alors configuré comme sur la copie d’écran ci-dessous (ou un équivalent selon sa version) :
+{{ :netmf43:vs1.png?nolink |}}
+__Remarque__: Les espaces de nom sont des racourcis. Le projet en contient plus ou moins selon son type.
+Le projet **//Blink//** est contenu dans la solution //**Blink**//. Vous allez écrire le code dans le fichier **Program.cs**.
+  * Définissez la **version du framework** en sélectionnant **Projet -> Propriétés de Blink -> Framework cible** comme dans la copie d'écran ci-dessous.
+{{ :netmf43:framewok43.jpg?nolink |}}
+=== Etape 2 : Editer le code source du programme ===
+**1. Déclaration des "Espaces de noms" et sélection des "bibliothèques" correspondantes**
+Une partie du code a été renseigné par Visual Studio. C’est le cas de la liste des espaces de noms installés par défaut et de la structure minimum du corps de programme (**repère 2 de la copie d'écran ci-dessus**). Nous allons commencer par compléter la liste des espaces de nom et installer les  bibliothèques correspondantes.
+Pour le moment seuls les espaces de nom suivants sont présents :
+{{ :netmf43:espacenompanda.jpg?nolink |}}
+Modifiez cette liste pour qu'elle corresponde à la copie d'écran ci-dessous.
+{{ :netmf43:espacenom2panda.jpg?nolink |}}
+Visual Studio souligne **using GHI.pins** en rouge spécifiant qu’il y a un problème. Cela est dû au fait qu’il ne trouve pas la bibliothèque correspondant à ce nouvel espace de noms. **Une autre manipulation est nécessaire** !
+Dépliez le répertoire "**Références**" (References) dans l’**explorateur de solution** pour obtenir la copie d'écran ci-dessous.
+{{ :netmf43:referencepanda.jpg?nolink |}}
+Pour ajouter la nouvelle bibliothèque: effectuez un clic droit sur "Références" (Reference) puis "Ajouter une référence" (Add Reference) et dans la liste, sélectionnez : **GHI.pins**. La nouvelle référence apparaît dans le répertoire "Références" et l’erreur disparaît dans le code.
+** 2. Partie déclarative du programme : construction d'un objet virtuel "Led" pour contrôler la LED de la carte**
+Entrez la ligne ci-dessous à la place du commentaire : //write your code here//
+<code csharp led.cs> var Led = new OutputPort(Pins.ONBOARD_LED, false); //(ligne 1) </code>
+----
+__Remarque__ : Vous pouvez constater l’effet de l’**autocompletion (intellisense)** au fur et à mesure de la construction de la ligne. Les propositions faites par le logiciel sont une aide précieuse lors de l’écriture du code.
+Il n’est pas nécessaire d’écrire complètement un mot : un **appui sur la touche tabulation** {{:netmf43:tab.png?nolink|}} permet de l’insérer lorsqu'il est sélectionné.
+----
+{{ :netmf43:autocompletion.jpg?nolink |}}
+**3. Partie exécutive du programme (le corps du programme) : placée dans une boucle infinie**
+Ecrivez le mot //**while**// à la suite de la **ligne 1** dans le corps du programme. Le logiciel vous propose un gabarit ([[https://fr.wikipedia.org/wiki/Template_(programmation)|template]]) de code.
+{{ :netmf43:template.png?nolink |}}
+Appuyez **deux fois** sur la touche de tabulation {{:netmf43:tab.png?nolink|}} {{:netmf43:tab.png?nolink|}}. Le logiciel construit la structure //**while**// pour vous.
+Complétez la structure //**while**// avec le code ci-dessous (les commentaires ** peuvent être omis**) :
+{{ :netmf43:prog1.png?nolink |}}
+=== Etape 3 : Générer la solution ===
+Dans l'éditeur, sélectionner : **Générer (Build) -> Générer la solution (Build Solution) ou [Ctrl+Maj+B]**. Si il n’y a pas d’erreurs dans le code le logiciel indique : {{:netmf43:generationreussie.png?nolink|}} (en bas et à gauche de la fenêtre) . Vous allez maintenant pouvoir transférer le programme dans la carte Netduino et l'exécuter.
+=== Etape 4 : Transférer le programme et l'exécuter ===
+**1. Affichage de la fenêtre de sortie**
+Cette fenêtre donne des informations lors de l’exécution d’un programme. Elle est utile lors de sa mise au point ou pour remplacer un périphérique d’affichage.
+Dans l’éditeur, sélectionner : **Affichage (view) -> Sortie (Output) ou [Ctrl+Alt+O]**
+{{  :netmf43:fsortie.jpg?nolink |}}
+**2. Transfert et exécution du programme dans la carte**
+Vérifiez que l’éditeur est en mode {{:netmf43:debug.png?nolink|}}. Pour transférer et exécuter le programme dans la carte, cliquez sur {{:netmf43:demarrer.png?nolink|}}(Start) ou appuyez sur la **touche F5**. Après une série d’actions, l’IDE doit afficher " Prêt " **(Ready) sur un fond rouge** en bas et à gauche de la fenêtre.
+----
+**La LED de la carte doit clignoter !**
+----
+{{ :netmf43:pb.png?nolink |}}
+=== Etape 5 : Tester le programme en mode pas à pas ===
+Pour mettre un programme "**au point**" (**déboguer**), vous pouvez l'arrêter, le redémarrer ou le mettre en pause.
+{{ :netmf43:debogueur.png?nolink |}}
+Pour bien comprendre les possibilités du débogueur, vous allez faire fonctionner le programme en **mode pas à pas.**
+Cliquez sur l'icône "Arrêter" et modifiez votre code comme ci-dessous :
+{{ :netmf43:prog2.png?nolink |}}
+Placez un __**point d’arrêt**__ (rond rouge) en cliquant à gauche du mot //**while**// comme ci-dessous.
+{{ :netmf43:pointarret.png?nolink |}}
+Relancez le programme (touche F5 ou {{:netmf43:demarrer.png|}}). Celui-ci s’arrête sur //**while**//. Vous pouvez l’exécuter le code ligne par ligne (**mode pas à pas**) en appuyant sur la **touche F10**. (Un appui exécute une ligne)
+**Résultat attendu dans la fenêtre de sortie et comportement de la LED correspondant !**
+{{ :netmf43:debugblink.jpg?nolink |}}
+==== 3. Deuxième programme : "MesureAngle" (entrée analogique et sortie numérique) ====
+----
+**Cahier des charges du programme 2**
+Afficher la position angulaire d'un axe sur un lcd.
+----
+**Matériels**
+  * Carte Panda 3 et shield [[http://www.gotronic.fr/art-sensor-shield-v2-tinkerkit-17925.htm|Tinkerkit]]
+  * Potentiomètre
+  * Afficheur LCD 2 lignes de 16 caractères et module [[http://www.lextronic.fr/P18987-module-de-pilotage-serie-pour-afficheurs.html|ELCD162]]
+----
+** Montage à réaliser **
+{{ :netmf43:PandaAngle.jpg?nolink |}}
+----
+=== Etape 1 : Créer le projet "MesureAngle" ===
+Reprenezla démarche vue dans le programme 1. Nommez le projet //MesureAngle//
+=== Etape 2 : Editer le code du fichier Program.cs ===
+**1. Sélection des "bibliothèques" et déclaration des "Espaces de noms"**
+**a. Modifiez** la liste des bibliothèques du projet comme ci-dessous :
+{{ :netmf43:referencepandaMA.JPG?nolink |}}
+__Remarque__ : La bibliothèque **MicroToolskit** est à télécharger sur Nuget.org en suivant la procédure suivante.
+  - clic droit sur "//Références//"
+  - Sélectionnez "//Gérer les packages NuGet//"
+  - Dans "//Source de package//", sélectionnez "//nuget.org//"
+  -
+  - Positionnez la fenêtre sur //Parcourir// et entrez **Microtoolskit** dans la barre de "//Recherche en ligne//"
+La bibliothèque apparaît comme sur la copie d'écran ci-dessous. Cliquez sur "//Installer//".
+{{ :netmf43:microtoolskit.jpg?nolink |}}
+**b. Modifiez** la liste des espaces de noms (on conserve seulement ceux qui sont utiles au projet !)
+<code csharp using.cs>
+using System;
+using System.Threading;
+using Microsoft.SPOT.Hardware;
+using GHI.Pins;
+using Microtoolskit.Hardware.Displays;
+</code>
+__Remarque__ : le contenu de la bibliothèque MicroToolsKit est accessible en effectuant un clic droit sur son nom dans "//Référence//" et en sélectionnant "//Afficher dans l'explorateur d'objets//".
+**2a. Partie déclarative du programme**
+Complétez le fichier "Program.cs" avec les extraits de code ci-dessous:
+a. Déclaration des constantes
+<code csharp const.cs>
+public static void Main()
+{
+  // Constantes
+  const UInt16 delay = 500;   // En ms
+</code>
+b. Déclaration des variables
+<code csharp var.cs>
+ // A la suite du code précédent, entrer :
+ // Variables
+ var N = 0;
+ var Angle = 0;
+</code>
+c. Configuration des entrées, sorties
+<code csharp es.cs>
+ // A la suite du code précédent, entrer :
+ // Configuration des E/S
+ // http://msdn.microsoft.com/en-us/library/hh421132.aspx (Description de la classe AnalogInput)
+ AnalogInput Potentiometre = new AnalogInput(FEZPandaIII.AnalogInput.A5); // Connecté sur I5 Tinkerkit
+ // http://webge.github.io/ELCD162/ (Description de la classe ELCD162)
+ ELCD162 Lcd = new ELCD162("COM1"); // Connecté sur SERIAL Tinkerkit
+</code>
+d. Initialisation de l'afficheur
+<code csharp init.cs>
+ // A la suite du code précédent, entrer :
+// Initialisation
+Lcd.Init(); Lcd.ClearScreen(); Lcd.CursorOff();
+</code>
+**2b. Partie exécutive du programme**
+<code csharp while.cs>
+ // A la suite du code précédent, entrer :
+ while (true)
+ {
+   N = Potentiometre.ReadRaw();
+   Angle = (270 * N ) / 4096;
+   Lcd.ClearScreen();
+   Lcd.PutString("Angle =" + Angle.ToString("F1") + "deg");
+   Thread.Sleep(delay);
+ }
+</code>
+=== Etape 3 : Générer la solution ===
+Reprenez la démarche vue dans le programme 1.
+=== Etape 4 : Transférer le programme et l'exécuter ===
+Reprenez la démarche vue dans le programme 1.
+----
+**Exercice**
+Modifiez le programme pour qu'une LED simulant une alarme (à rajouter sur la carte) s'éclaire si l'angle n'est pas compris dans l'intervalle [**120°, 150°C**]. En C#, le **OU** logique se code **||**, le **ET** logique se code **&&**.
+----
+**Sources des exemples**
+Les sources des exemples (compilées avec Visual Studio Community 2015) sont téléchargeables [[https://webge.fr/doc/wikis/code/GHI/NETMF/G80/PANDA_3_pap.zip|ici]].
+----