Africa’s Techmakers

3333333333333333333333333333333333333333333
Reference du langage de programmation Arduino

Le langage de programmation Arduino peut être divisé en 3 grandes parties

principales : les fonctions, les valeurs (variables, constantes) et la structure.

1. Les fonctions
Ils servent à contrôler la carte Arduino et faire des calculs

1.1 Sortie et entrée numérique

A. digitalRead()

B. digitalWrite()

C. pinMode()

A. digitalRead()

Description
Lis la valeur à partir d’une broche numérique (broches de 0 à 13 sur la
carte Arduino), soit High ou Low

« High » est un niveau logique qui fait référence à la ligne étant à 5v ou 3.3v. Et « Low » fait
référence à la ligne étant à 0v. Les logiques numériques ne fonctionnent qu’avec une seule
tension. Si la tension d’un système particulier est de 5v, alors « High » est de 5v. et de même
pour 3,3Vv
Syntaxe

digitalRead(pin)

La syntaxe est l’ensemble de règles qui définit comment un programme(code) Arduino

sera écrit

Les paramètres

Pin : le numéro de la broche Arduino sur laquelle la valeur doit être lut

Exemple : digitalRead(8) permet de lire la valeur à la broche 8

Retour

High ou Low

En utilisant la function digitalRead() nous recevons un retour: soit High ou Low

B. digitalWrite()

Description
Permet d’écrire une valeur HIGH ou LOW sur une broche numérique. Si
la broche a été configurée comme OUTPUT (sortie) avec pinMode (),
sa tension sera réglée à la valeur correspondante : 5V (ou 3,3V) pour
HIGH, 0V (terre) pour LOW. Si la broche est configurée comme
 INPUT (entrée), digitalWrite() activera (HIGH) ou désactivera
(LOW) la broche d’entrée.
Syntaxe

digitalWrite(Pin, valeur)

Les paramètres

Pin : Numéro de la broche Arduino connectée

Valeur : HIGH ou LOW

Exemple: digitalWrite(8, HIGH) envoie 5V a la broche de sortie 8

Retour
Nous n’attendons aucun retour dans ce cas
En utilisant la function digitalWrite() nous ne recevons aucun retour

C. pinMode()

Description
Configure la broche pour qu’elle se comporte soit comme une sortie soit
comme une entrée.

Syntaxe

pinMode(pin, mode)

Les paramètres

Pin : Le numéro de la broche Arduino qui à configurer

mode : INPUT ou OUTPUT (entrée ou sortie)
Retour
Nous n’attendons aucun retour dans ce cas
Exemple de code
int ledPin = 13; // LED connectée à la broche numérique 13

int inPin = 7; // bouton poussoir connectée à la broche numérique 7

int val = 0; // variable qui servira à stocker les valeurs lut

void setup() {

pinMode(ledPin, OUTPUT); // configure la broche numéro 13 (ledPin) en sortie

pinMode(inPin, INPUT); // configure la broche numéro 7 en entrée

void loop() {

val = digitalRead(inPin); // read the input pin

digitalWrite(ledPin, val); // sets the LED to the button's value

} 1.2 Sortie et entrée analogique

A. analogRead()

B. analogReference()

C. analogWrite()

A. analogRead()

Description

Lit la valeur de la broche analogique spécifiée. Les cartes arduino

contiennent un convertisseur analogique- numérique 10 bits multicanal
 (voir Tutoriel 4). Cela signifie qu’il mappera les tensions d’entrée entre 0
et la tension de fonctionnement (5v ou 3,3 v) en valeurs entières comprise
entre 0 et 1023.

Syntaxe

analogRead(pin)

Les paramètres

pin : Le nom de la broche analogique à lire.

Analog IN: A0, A1, A2, A3, A4, A5 (voir sur la carte Arduino)

Retour
Cette fonction retourne lecture analogique sur la broche

B. analogReference()

Description
Configure la tension de référence utilisée pour l’entrée analogique. Les
options pour la carte Arduino Uno, Mega, Leonardo, etc. sont :

DEFAULT : la référence analogique par défaut de 5 volts ou 3,3 volts.

INTERNE : une référence intégrée, égale a 1,1 volts sur l’ATmega168 ou

l’ATmega328P et a 2,56 volts sur les ATmega32U4

INTERNAL1V1 : une reference 1,1 V intégrée (Arduino Mega

uniquement)

INTERNAL2V56 : une référence 2,56V intégrée (Arduino Mega

uniquement)
 EXTERNE : la tension appliquée à la broche AREF (0 à 5V uniquement)
est utilisé comme référence.

Syntaxe

analogReference(type)

Les paramètres

Type : Quelle type référence faut-il utilisé (voir la liste des options dans
la description)

Retour
Nous n’attendons aucun retour dans ce cas

C.analogWrite()

Description
Ecrit une valeur analogique (one PWM, Tutoriel 13) sur la broche. Peut
être utilisé pour allumer une LED a des intensités variables ou pour
tourner un moteur différentes vitesse. Apres un appel analogWrite(), la
broche génèrera une onde rectangulaire constante du cycle de marche
spécifié jusqu’au prochain appel analogWrite() (ou un appel à
digitalRead() ou digitalWrite() ) sur la même broche.

Syntaxe

analogWrite(pin, valeur)

Les paramètres

Pin : Numéro de la broche Arduino.

 Valeur : Le cycle de marche : entre 0 et 255

Retour
Nous n’attendons aucun retour dans ce cas

Exemple de code
int ledPin = 9; // LED connectée à la broche 9

int analogPin = 3; // potentiomètre connecté a broche analogique ~ 3

int val = 0; // variable pour stocker la valeur lut

void setup() {

pinMode(ledPin, OUTPUT); // configurer la broche en sortie

void loop() {

val = analogRead(analogPin); // lit la valeur a broche 3

analogWrite(ledPin, val / 4); // les valeurs analogRead vont de 0 à 1023, les valeurs analogWrite vont de 0
a 255

1.3 Temps
A. delay()

Description
Suspend le programme pendant la durée (en millisecondes) spécifiée
comme paramètre. ( il y a 1000 millisecondes dans une seconde.)
Syntaxe
delay(ms)

Les paramètres
ms : Le nombre de millisecondes à mettre en pause.

Retour
Nous n’attendons aucun retour dans ce cas

Exemple de code
int ledPin = 13; // LED connectée a la broche numérique 13

void setup() {

pinMode(ledPin, OUTPUT); // configure la broche 13 en sortie

void loop() {

digitalWrite(ledPin, HIGH); // allume la LED

delay(1000); // pause pendant 1 second

digitalWrite(ledPin, LOW); // éteint la LED

delay(1000); // pause pendant 1 second

}
 2. Les variables

Quelques data types (types de données) et constante Arduino.

Data types et constante

array
char
string
int
float
const
byte
size of
unsigned long

array (data type)

Description
array (tableau) est une collection de variables accessibles avec un
numéro d’index.

Création (déclaration) d’un tableau

Toutes les méthodes ci-dessous sont des moyens valides pour créer
(déclarer) un tableau.

i nt myInts[6];

int myPins[] = {2, 4, 8, 3, 6};

int mySensVals[6] = {2, 4, -8, 3, 2};

char message[6] = "hello";

 Vous pouvez déclarer un tableau sans l’initialiser comme dans mylnts.
Dans myPins, nous déclarons un tableau sans choisir explicitement une
taille. Le compilateur compte les éléments et crée un tableau de la taille
appropriée. Enfin, vous pouvez à la fois initialiser et dimensionner votre
tableau votre tableau comme dans mySensVals. Notez que lors de la
déclaration d’un tableau type char, un élément de plus que votre
initialisation est requis, car le compte commence à partir de 0. Par
exemple si on initialise a 5 on aura 5-1 = 4. A 6 on aura 6-1 = 5 comme
dans notre cas ici le mot « hello » a bien 5 caractère.

Accéder à un tableau
Les tableaux sont indexés à zéro, c’est-à-dire que, comme mentionné ci-
dessous, le premier élément du tableau est à l’index 0, d’où dans le
tableau mysensVals [6] = {2, 4, -8, 3, 2} ;

mysensVals [0] = = 2 , mysensVals[1] = = 4 … ainsi de suite

Notez que dans Arduino le « = = » veut simplement dire égale

Cela signifie également dans un tableau avec dix éléments, l’indice 9 est
le dernier élément. Par conséquent :
int myArray[10]={9, 3, 2, 4, 3, 2, 7, 8, 9, 11};

// myArray[9] contiens 11

// myArray [3] contiens 4

// myArray[10] est invalide cette adresse n’existe pas

Pour affecter une valeur dans un tableau

mySensVals[0] = 10;

Pour récupérer une des valeurs d’un tableau

x = mySensVals[4];
 char (data type)

Description
char est un data type utilisé pour stocker une valeur de caractère. Les
caractères littéraux sont écrits, comme ceci : 'A' (pour plusieurs
caractères utilisez les double griffes "ABC"). La taille du data type char
est d’au moins 8 bits. Il est recommandé de n’utiliser que char pour
stocker les caractères.

Syntaxe

char var = val;

Les paramètres
var : Nom de la variable.
val : La valeur à assignée a cette variable.

Exemple de code
char myChar = 'A';

char myChar = 65;

// les deux lignes de codes ici sont équivalente

Selon le ASCII (American standard code for information interface) les

caractères peuvent être codés numériquement. Ci-dessous vous avez une petite
de la liste des caractères et leur équivalent numérique

valeur Caractères

num

64 @

65 A

66 B

67 C

68 D

69 E

70 F
 string (data type)

Description
string est utilisé pour stocker du texte. Ils peuvent être utilisés pour
afficher du texte sur un écran LCD ou sur le moniteur serie de
l’environnement de programmation Arduino.

Syntaxe
Tous les éléments suivant sont des déclarations valide pour les strings
char Str1[15];

char Str2[8] = {'a', 'r', 'd', 'u', 'i', 'n', 'o'};

char Str3[8] = {'a', 'r', 'd', 'u', 'i', 'n', 'o', '\0'};

char Str4[] = "arduino";

char Str5[8] = "arduino";

char Str6[15] = "arduino";

int (data type)

Description
int (entier) est un type de données utilisé pour stockage des nombres. int
stocke une valeur de 16 bits (2 octets). Cela donne un intervalle de -32
768 à 32 767 (valeur minimal de -215 et valeur maximal de 215 – 1).

int counter = 32 ; // déclaration de variable de type int et l’initialisée avec 32

 float (data type)

Description
float est utilisé pour stocker les nombres a virgule.

float num = 1.352;//déclaration d’une variable de type float et initialiser avec 1.352

3. Déclarations de contrôle

Les structures de prise de décision exigent que le programmeur spécifie une ou

plusieurs conditions à évaluer ou à tester par le programme. Ils doivent être
accompagné d’une ou plusieurs instructions à exécuter si la condition est jugée
vraie, et éventuellement d’autres instructions à exécuter si la condition est jugée
fausse.
Voici la forme générale d’une structure de prise de décision typique trouvée
dans la plupart des langages de programmation.
 Les instructions de contrôle sont des éléments du code qui contrôlent le flux
d’exécution du programme. Elles sont :

if
Il prend une expression (condition) entre parenthèses et une instruction ou un
bloc d’instructions. Si l’expression est vraie, l’instruction ou le bloc
d’instructions est exécuté sinon ces instructions sont ignorées.
Différentes formes de déclaration if
Forme 1

if ( expression)
instruction;

Vous pouvez utiliser l’instruction if sans accolades {} si vous avez qu’une seule instruction

Forme 2

if (expression) {
bloc d’instructions ;
}

Exemple
/* Déclaration de viable */
int A = 5 ;
int B = 9 ;

Void setup () {

Void loop () {
/*vérifier la condition booléenne */

if (A > B) /* si la condition est vraie exécutez l’instruction suivante */

A++;

/* vérifier la condition booléenne */

if ( ( A < B ) && ( B != 0 )) /* si la condition est vraie exécutez

l’instruction suivante */ {

A += B;
B--;
}
}