format_list_bulleted

Écrire mon premier programme

Étape 1

Ouvrir un exemple

De nombreux exemples sont disponibles pour prendre en main la bibliothèque BRAINZY*. Il vous suffit d'ouvrir l'IDE Arduino puis de naviguer dans File > Examples > BRAINZY. Les exemples y sont classés par catégorie.

* Pour installer la bibliothèque BRAINZY, suivez les étapes suivantes.

Choissons pour commencer l'exemple Blink disponible dans File > Examples > BRAINZY > 1. Getting Started. Ce sketch permet de faire clignoter les LED de la BRAINZY Board. Une fois sélectionnée, l'example doit alors apparaître dans une nouvelle fenêtre.

Les premières lignes du programme, aussi appelé sketch, sont des commentaires.

/*
   * Blink
   * Turns on the LEDs on Brainzy Board on for one second, then off for one second, repeatedly.
   * 
   * This example code is in the public domain.
   */

Tout ce qui se trouve entre /* et */ est ignoré par Arduino quand le sketch est exécuté (* en début de chaque ligne n'est pas requis et n'est là que pour enjoliver le commentaire). C'est quelques lignes sont écrites pour expliquer au lecteur dequel programme il s'agit. C'est de bonne pratique de commenter son code, et d'actualiser vos commentaires à mesure que celui-ci est modifié. C'est une manière d'aider les autres programmeurs à le comprendre.

Vous pouvez aussi écrire de courts commentaires en utilisant les //. Tout ce qui en suit (jusqu'à la fin de la ligne) est alors commenté.

#include <BRAINZY.h> // include the robot library

Le mot clef #include permet de charger la bibliothèque BRAINZY.h.

Les variables globales sont ensuite déclarées.

unsigned long oldTime = 0;
unsigned long wait = 1000; // waiting time (in ms)

Une variable est un moyen de stocker une information. Elle dispose d'un nom, d'un type et d'une valeur. Par exemple, la variable nommée wait a pour type unsigned long et est initialisée avec la valeur 1000. Ainsi à chaque fois que le nom wait apparaîtra dans le code, sa valeur est récupérée.

void setup() {
    // put your setup code here, to run once:
    Robby.ledOff();       // turn the button on board off
    Robby.ledButtonOn();  // turn the button led on
  }

Il existe deux fonctions qui sont toujours présente dans un sketch Arduino : setup() et loop(). La fonction setup() est appelée qu'une seule fois quand le sketch commence. C'est un bonne emplacement pour initialiser vos variables, vos tâches... La fonction loop() est exécuter en boucle, c'est le coeur de vos programmes.

Vous pouvez aussi définir vos propres fonctions, pour en savoir plus consultez ce tutoriel.

void loop() {
    // put your main code here, to run repeatedly:
    if (millis()-oldTime > wait) {
      oldTime = millis();
      if (Robby.isLedOn()) {
        Robby.ledOff();       // turn the button on board off
      }
      else {
        Robby.ledOn();        // turn the button on board on
      }
      if (Robby.isLedButtonOn()) {
        Robby.ledButtonOff(); // turn the button led off
      }
      else {
        Robby.ledButtonOn();  // turn the button led on
      }
    }
  }

Vous prouvez obtenir les informations spécifiques à chaque fonction de la bibliothèque BRAINZY dans l'onglet Référence : par exemple ledButtonOn(), ledButtonOff(), isLedOn(), ledOn() et ledOff().

Étape 2

Connecter votre BRAINZY Board en USB à votre PC

1. Branchez la batterie

2. Branchez le cable USB

La LED rouge D2 doit alors s'allumer pour signaler que la BRAINZY Board est sous tension. Si la LED est éteinte, vous ne pourrez pas passer à l'étape 3 car la BRAINZY Board n'apparaîtra pas dans la liste des Serial ports.

Étape 3

Compiler & flasher Robby

Une fois votre code écrit (ou votre exemple ouvert) et votre carte branchée, rendez-vous dans l'onglet Tools pour configurer la connection entre Robby et votre ordinateur.

Sélectionnez les réglages suivants :

Board : Teensy 3.5
USB Type : Serial
CPU Speed : 120 MHz
Optimize : Faster
Port : (le port USB que vous utilisez, notifié du nom Teensy)

Compilez votre code en utilisant le bouton Verify de l'IDE Arduino. Une fois compiler, une nouvelle fenêtre apparaît.

Il ne vous reste plus cas téléverser votre programme en appuyant le bouton de la BRAINZY Board.

À la fin de chaque téléversement, la BRAINZY Board redémarre en beepant.

infoVous pouvez aussi compiler puis téléverser automatiquement votre code en utilisant de le bouton Upload de l'IDE Arduino.

Étape 4

Petits exercices

1. Modifiez l'exemple Blink pour que les LED clignotent en même temps.

2. Modifiez de nouveau le code pour que les LED restent allumées pendant 100ms et éteint pendant 1s.

warningIl est fortement recommandé de pas utiliser de fonctions bloquantes (tel que la fonction `delay()` d'Arduino) dans vos programmes. Pour plus d'informations, consultez ce tutoriel.