Table des matières

Sommaire TinyCLR OS

Premiers programmes en C# "étape par étape" avec une carte FEZ T18

[Mise à jour le : 13/2/2020]

Programmes réalisés dans le tuto

1. Préambule

Pour mener à bien ce tutoriel, vous devez disposer d’une carte Fez T18.

Microsoft Visual Studio 2017 ou 2019 (Community) doit être installé sur le PC.

Le firmware de la carte doit être à jour. Si ce n’est pas le cas : suivez le "Guide d’installation" ou voir la vidéo "Updating BrainPad’s Firmware - Tech Talk 041".

Les vidéos du cours sur les fondamentaux du langage C#, accessibles sur le site MVA sont un excellent préalable ou un complément à ce tutoriel.

Cahier des charges du programme 1 : faire clignoter la LED “LED1” de la carte FEZ T18 !

Remarque: L’emplacement 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) :

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 source du programme dans le fichier Program.cs.

Etape 2 : Installer des bibliothèques dans le projet

Etape 3 : Editer le code source du programme

a) Déclarer les espaces de nom

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).

Pour le moment seuls les espaces de nom suivants sont présents :

*.cs
using System;
using System.Collections;
using System.Text;
using System.Threading;
 
namespace Blink
{
    class Program
    {
        static void Main()
        {
        }
    }
}

Modifier cette liste pour qu'elle corresponde au code ci-dessous.

*.cs
using System;
using System.Collections;
using System.Text;
using System.Threading;
using GHIElectronics.TinyCLR.Devices.Gpio;
using GHIElectronics.TinyCLR.Pins;
 
namespace Blink
{
    class Program
    {
        static void Main()
        {
        }
    }
}

b) Construction d'un objet virtuel “led” pour contrôler la LED “LED1” de la carte

Entrer le code ci-dessous.

led.cs
       static void Main()
        {
            var gpio = GpioController.GetDefault(); // Ces deux lignes ouvrent la broche
            var led = gpio.OpenPin(FEZ.GpioPin.Led1); // sur laquelle est connectée LED1
            led.SetDriveMode(GpioPinDriveMode.Output); // Cette ligne la configure en sortie
        }

Remarque : Vous pouvez constater l’effet de l’autocomplétion (intellisense) au fur et à mesure de l'écriture du code. 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 permet de l’insérer lorsqu'il est sélectionné.

c) Partie exécutive du programme (le corps du programme) : à placer dans une boucle infinie

Ecrire le mot while . Le logiciel vous propose un gabarit (template) de code.

Appuyer deux fois sur la touche de tabulation . Le logiciel construit la structure while pour vous.

Compléter la structure while avec le code ci-dessous :

*.cs
        static void Main()
        {
            var gpio = GpioController.GetDefault(); // Ces deux lignes ouvrent la broche
            var led = gpio.OpenPin(FEZ.GpioPin.Led1); // sur laquelle est connectée LED1
            led.SetDriveMode(GpioPinDriveMode.Output); // Cette ligne la configure en sortie
        }
        while {
                led.Write(GpioPinValue.High);
                Thread.Sleep(100);
                led.Write(GpioPinValue.Low);
                Thread.Sleep(100);
              }

Etape 4 : Générer la solution

La fenêtre de sortie donne des informations pendant l’exécution d’un programme. Elle est utile lors de sa mise au point ou pour remplacer un périphérique d’affichage.

Si la fenêtre de sortie n'est pas présente, vous pouvez là faire apparaître en sélectionnant : Affichage → Sortie ou [Ctrl+Alt+O].

Dans l'éditeur, sélectionner : Générer → Générer la solution ou [Ctrl+Maj+B]. S'il n’y a pas d’erreurs dans le code le logiciel indique :

Etape 5 : Transférer le programme et l'exécuter

Vérifier que l’éditeur est en mode .

Pour transférer et exécuter le programme dans la carte, cliquer sur ou appuyer sur la touche F5.

Après une série d’actions, l’IDE doit afficher Prêt sur un fond rouge en bas et à gauche de la fenêtre.

La LED de la carte doit clignoter !

Etape 6 : Tester le programme en mode pas à pas

Pour mettre un programme “au point” (déboguer), il est possible de l'arrêter, de le redémarrer ou de le mettre en pause.

Pour bien comprendre les possibilités du débogueur, vous allez faire fonctionner le programme en mode pas-à-pas.

Cliquer sur l'icône “Arrêter”, ajouter l'espace de nom : 

using System.Diagnostics;

et modifier la boucle while comme ci-dessous :

*.cs
            while (true)
            {
                led.Write(GpioPinValue.High);
                Debug.WriteLine("Led1 éclairée");
                Thread.Sleep(100);
                led.Write(GpioPinValue.Low);
                Debug.WriteLine("Led1 éteinte");
                Thread.Sleep(100);
            }

Placer un point d’arrêt (rond rouge) en cliquant à gauche du mot while comme ci-dessous.

Relancer le programme (touche F5 ou ). Celui-ci s’arrête sur while. Vous pouvez l’exécuter 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

Exercices

Exercice 1
Modifier le programme pour que la LED clignote à une fréquence de 4Hz avec un rapport cyclique de 1/10

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