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 ces étapes.

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

Les premières lignes du programme (du sketch) sont des commentaires.

/*
 * Blink
 * Turns on the LEDs on Brainzy Board on for one second, then off for one second, repeatedly.
 *
 * Download latest BRAINZY library here:
 *    https://github.com/WhoIsMrRobotics/brainzy-library/releases/latest
 *
 * Visit Documentation page here:
 *    https://www.mr-robotics.com/docs
 *
 * BRAINZY library is licensed under the GPL-3.0 license.
 * 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). Ces quelques lignes sont écrites pour expliquer au lecteur de quel programme il s'agit. C'est une 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 ou pour vous même lorsque vous revenez modifier vos anciens programmes.

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. Elle contient un ensemble de fonctions pré-codées vous permettant d'écrire des programmes simples, courts et élégants.

Les variables globales sont ensuite déclarées.

unsigned long waitTime = 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. Ici, la variable nommée waitTime a pour type unsigned long (pour en savoir plus) et est initialisée avec la valeur 1000. Ainsi à chaque fois que le nom waitTime apparaît dans le code, sa valeur est récupérée.

void setup() {
  // put your setup code here, to run once:
}

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

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:
  delay(waitTime);      // wait
  Robby.ledOff();       // turn the button on board off
  Robby.ledButtonOn();  // turn the button led on
  delay(waitTime);      // wait again
  Robby.ledOn();        // turn the button on board on
  Robby.ledButtonOff(); // turn the button led off
}

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

Étape 2

Connecter votre BRAINZY Board en USB

1. Branchez la batterie

2. Branchez le cable USB

Une LED rouge 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

Une fois votre code terminé 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 compilé, une nouvelle fenêtre apparaît.

Il ne vous reste plus qu'à 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 le bouton Upload de l'IDE Arduino.

Étape 4

Petits exercices pour aller plus loin

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.