Différences

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

--- archives:netmf43:4c_netmfbrainpadv1pap [2021/08/10 14:45] – phil
+++ archives:netmf43:4c_netmfbrainpadv1pap [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 BrainPad v1  =====
+{{  :netmf43:brainpadico.png?nolink&100|}}{{ :netmf43:netmf.png?nolink|}}
+[Mise à jour le : 11/07/2018]
+===== 1. Préambule =====
+Pour mener à bien ce tutoriel vous devez disposer d’une carte **[[netmf43:2c_carte_brainpadv1|BrainPad V1]]**. Les 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** »  [[http://docs.ghielectronics.com/software/netmf/getting-started.html|ici]].
+Les vidéos du cours sur les fondamentaux du langage C#, accessibles sur le site [[http://www.microsoftvirtualacademy.com/training-courses/les-fondamentaux-du-developpement-en-c-sharp|MVA]] sont un excellent préalable ou un complément à ce tutoriel.
+On trouvera également des tutoriels en anglais sur le site de la société [[http://docs.ghielectronics.com/software/netmf/tutorials/intro.html|GHI Electronics]].
+===== 2. Premier programme : Blink =====
+----
+**Cahier des charges**
+Faire clignoter la LED RVB de la carte BrainPad et afficher le texte "Hello, world!" sur l'écran graphique.
+----
+==== 2a. Créer un projet avec le template BrainPad .NET Application ====
+  * Ouvrez l’**IDE Microsoft Visual Studio 2015** 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 puis BrainPad .NET Application**.
+{{ :netmf43:projbrainpad.jpg?nolink |}}
+  * Donnez le nom "**Blink**" à l’application puis cliquez sur **Ok**.
+{{ :netmf43:enreg.png?nolink |}}
+__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.jpg?nolink |}}
+Le projet **//Blink//** est contenu dans la solution //**Blink**//. Vous allez écrire le code dans le fichier **Program.cs**.
+==== 2b. Organisation d'un programme créé avec le template "BrainPad .NET Application" ====
+Comme pour un projet **Arduino**, un projet utilisant le **template BrainPad .NET Application** contient deux parties :
+  * Le **Setup**, nommé ici **BrainPadSetup**, contient le code ne devant s'exécuter qu'**une seule fois** au démarrage de la carte.
+  * La boucle **Loop**, nommée ici **BrainPadLoop**, contient le code devant s’exécuter **indéfiniment** après le démarrage de la carte.
+==== 2c. Téléchargement et exécution du programme Blink ====
+La carte étant connectée au PC avec le câble USB, le programme est compilé puis transféré en cliquant sur le bouton {{:netmf43:demarrer.png?nolink|}} ou sur **F5**.
+La LED RVB **Light Bulb** clignote et le texte **"Hello, world!"** s'affiche sur l'écran comme ci-dessous.
+{{ :netmf43:hellow.jpg?nolink |}}
+**Étude du fonctionnement de l'exemple**
+L'application démarre en exécutant une seule fois le code placé entre les accolades de la **méthode BrainPadSetup()**.
+{{ :netmf43:codehello.jpg?nolink |}}
+La méthode **DrawText()** de l'objet Display placé sur la carte BrainPad affiche en blanc le texte "Hello, world" à la position 0,0 de l'écran.
+Puis, le code placé entre les accolades de la méthode BrainPadLoop() s'exécute indéfiniment.
+{{ :netmf43:codebulb.jpg?nolink |}}
+La Led Bulb est éclairée puis éteinte successivement pendant 0,5s.
+----
+**Exercice 1** : Modifiez le programme pour que la LED émette un flash de 100ms toutes les 1s et que votre nom (prémom) apparaissent en jaune sur l'afficheur.
+__Remarque__ : l'afficheur n'accepte pas les caractères accentués.
+----
+===== 3. L'objet BrainPad =====
+Dans le monde "réel", les voitures, les tables, les téléviseurs sont des **objets**. Un objet du monde réel peut être décrit par son **état** (la voiture est une Citroën bleue) et par son comportement (la voiture avance).
+Dans le monde "virtuel" tout peut être assimilé à un objet : même une personne ! Les concepts d'**objet**, d'**état** et de **comportement** son repris dans les langages de programmation dit "Objet" comme le **C#** utilisé pour programmer la carte BrainPad.
+La carte BrainPad réelle est contrôlée par l'objet BrainPad virtuel. Cet objet est décrit par du code développé par la société GHI Electronics. Il est contenu dans le fichier Brainpad.cs.
+L'accès aux fonctionnalités de la carte BrainPad nécessite d'entrer le mot **BrainPad chaque fois qu'on y fait référence**. En faisant suivre ce mot par un **point** on obtient la liste des objets qui "composent" la carte tels que : **Display**, **Buzzer**, **Accelerometer** etc.
+{{ :netmf43:classesbrainpad.jpg?nolink |}}
+Tous ces "sous-objets" sont accessibles à partir de leur nom. Il suffit d'en sélectionner un pour accéder à la liste de ses fonctionnalités.
+Par exemple, en sélectionnant Display on obtient la liste ci-dessous :
+{{ :netmf43:classesdisplay.jpg?nolink |}}
+L'IDE Visual Studio simplifie la programmation en proposant automatiquement la liste des fonctionnalités d'un objet. Vous allez utiliser cette aide pour écrire le prochain programme.
+===== 4. Second programme : TrafficLight =====
+**Cahier des charges** : Faire clignoter la Led verte de la zone TrafficLight.
+__Remarque__ : Vous allez écrire une partie du code et simuler un problème de programmation. Sa résolution vous permettra de découvrir le mode de fonctionnement pas à pas.
+**Etape 1**. **Créez** un nouveau projet BrainPad et nommez-le TrafficLight
+**Etape 2**. **Supprimez** le code produit automatiquement. Votre programme doit ressembler à la copie d'écran ci-dessous.
+{{ :netmf43:trafficlight.png?nolink  }}
+**Etape 3**. **Copiez** l'extrait de code ci-dessous entre les accolades de **BrainPadSetup()**.
+{{ :netmf43:code1trafficlight.jpg?nolink  }}
+**Etape 4**. **Téléchargez** et exécutez le code en cliquant sur {{:netmf43:demarrer.png?nolink}} ou en appuyant sur **F5**.
+----
+**Problème** : la Led reste constamment éclairée au lieu de clignoter. Ceci vient du fait que le programme fonctionne très rapidement. Il est nécessaire de le ralentir.
+----
+Pour visualiser ce que fait le programme lorsqu'il s'exécute lentement, nous allons le faire fonctionner en mode pas-à-pas.
+**Etape 5** : **Test** du programme en mode pas-à-pas
+Ce mode de fonctionnement permet de mettre un programme "au point" (déboguer). Dans ce mode, vous pouvez l'arrêter, le redémarrer ou le mettre en pause.
+{{ :netmf43:vsbarre.jpg?nolink |}}
+. **Cliquez** sur l'icône "Arrêter".
+. **Placez** un __**point d’arrêt**__ en cliquant dans la marge à gauche de la première ligne comme ci-dessous.
+{{ :netmf43:breakpoint.jpg?nolink |}}
+. **Relancez** le programme (touche F5 ou {{:netmf43:demarrer.png?nolink|}}. Celui-ci s’arrête. Vous pouvez exécuter le code ligne par ligne (**mode pas-à-pas**) en appuyant sur la touche **F10**. (Un appui exécute une ligne) **Lorsque vous atteignez l'accolade fermante : arrêtez le programme**.
+----
+**Exercice 2** : Modifiez le programme pour que la Led jaune clignote 2 fois par seconde. Par précaution, on éteindra les trois Leds au démarrage de la carte.
+----
+**Exercice 3** : Créez un programme de simulation de feu de carrefour à partir de l'algorithme ci-dessous. (Créez un nouveau projet BrainPad et nommez-le Carrefour).
+{{ :netmf43:algofeux.jpg?nolink |}}
+----
+===== 5. Button : un troisième programme pour se familiariser avec la structure si... alors ... sinon... fin si =====
+**Algorithme**
+<code>
+si (condition) alors Action1 sinon Action2 fin si
+</code>
+L'action 1 est exécutée si la //condition// est vraie.
+L'action 2 est exécutée si la //condition// est fausse. (L'action 2 peut être omise !).
+----
+**Cahier des charges du programme à réaliser**
+Si le boutton Down est appuyé la led verte s'éclaire.
+----
+**1. Créez** un nouveau projet BrainPad et nommez-le Button.
+**2. Copiez** le code ci-dessous et exécutez-le :
+{{ :netmf43:codebuton1.jpg?nolink |}}
+Il semble qu'il y ait un problème : la Led ne s’éteint pas lorsqu'on relâche le bouton. Pour cela : il faut lui dire !
+**3. Modifiez** votre programme comme ci-dessous.
+{{ :netmf43:codebuton2.jpg?nolink |}}
+===== 6. Synthèse : "Jouer une partition avec le buzzer" =====
+Les méthodes décrites dans le tableau ci-dessous permettent de contrôler le buzzer.
+^ ^Synthaxe^Description^
+|{{:netmf43:method_16x.png?nolink|}} {{:netmf43:s_16x.png?nolink|}}|//void// **PlayFrequency**(//int// Frequency)|Joue une fréquence.|
+|{{:netmf43:method_16x.png?nolink|}} {{:netmf43:s_16x.png?nolink|}} |//void// **Stop**()|Coupe le son.|
+//Remarque// : void signifie que la méthode ne renvoie pas d'informations. int signifie que la valeur à placer entre les parenthèses doit être un entier
+//Exemple// : BrainPad.Buzzer.PlayFrequency(523);
+Vous allez utiliser ces méthodes pour écrire le programme **AuClairDeLaLune** dont la partition est donnée ci-dessous (ou une autre de votre choix) .
+**Partition**
+{{ :netmf43:auclairdelalune.jpg?nolink |}}
+Les fréquences correspondant aux notes et le rythme à attribuer à une note sont précisés dans les ressources ci-dessous.
+**Ressources**
+Fréquence des notes : [[http://jeanjacques.dialo.free.fr/frequenc.htm|lien]]
+Le rythme des notes de musique (ronde, blanche, noire...): [[http://www.happynote.com/musique/solfege/rythme-notes.html|lien]]
+----
+**Exercice 4**
+**Version 1a** : La carte joue seule la partition (une fois). (Nom du projet : **ClairLuneV1a**)
+**Version 1b** : La carte joue seule la partition (une fois) et le texte de la chanson s'affiche sur l'écran. (Nom du projet : **ClairLuneV1b**) [[https://twitter.com/MNO_Ph/status/900694474778705920|[Video]]]
+__Remarques__ : Une noire dure 0,5s
+----
+**pour aller plus loin...**
+**Version 2** : L'utilisateur joue la partition avec le clavier. (Nom du projet **ClairLuneV2**)
+----
+__Indications__ : Utiliser des évènements pour gérer les boutons-poussoir (**voir prof**)
+**Events**
+Many modules generate useful events. Type +=<tab><tab> to add a handler to an event, e.g.:
+button.ButtonPressed +=<tab><tab>
+----
+**Sources**
+Les sources des exemples et des exercices (compilés avec **Visual Studio 2015 Community**) sont téléchargeables [[https://webge.fr/doc/wikis/code/GHI/NETMF/G30/NetMFv43_BrainPad_pap.zip|ici]].
+----
+===== 7. Les classes de la bibliothèque Brainpad =====
+Accessibles à partir de ce [[netmf43:8_netmfclassbrainpad|lien]]