Description :
Lit la valeur de la broche analogique spécifiée. Les cartes Arduino contiennent un convertisseur analogique-numérique multicanal 10 bits. Cela signifie qu’il mappera les tensions d’entrée entre 0 et la tension de fonctionnement (5 V ou 3,3 V) en valeurs entières comprises entre 0 et 1023. Sur un Arduino UNO, par exemple, cela donne une résolution entre les lectures de : 5 volts / 1024 unités ou , 0,0049 volts (4,9 mV) par unité. Voir le tableau ci-dessous pour les broches utilisables, la tension de fonctionnement et la résolution maximale pour certaines cartes Arduino.
La plage d’entrée peut être modifiée à l’aide de analogReference()
, tandis que la résolution peut être modifiée (uniquement pour les cartes Zero, Due et MKR) à l’aide de analogReadResolution()
.
Sur les cartes basées sur ATmega (UNO, Nano, Mini, Mega), il faut environ 100 microsecondes (0,0001 s) pour lire une entrée analogique, donc la vitesse de lecture maximale est d’environ 10 000 fois par seconde.
CONSEIL | TENSION DE FONCTIONNEMENT | BROCHES UTILISABLES | RÉSOLUTION MAXIMALE |
Uno |
5 Volts |
A0 to A5 |
10 bits |
Mini, Nano |
5 Volts |
A0 to A7 |
10 bits |
Mega, Mega2560, MegaADK |
5 Volts |
A0 to A14 |
10 bits |
Micro |
5 Volts |
A0 to A11* |
10 bits |
Leonardo |
5 Volts |
A0 to A11* |
10 bits |
Zero |
3.3 Volts |
A0 to A5 |
12 bits** |
Due |
3.3 Volts |
A0 to A11 |
12 bits** |
MKR Family boards |
3.3 Volts |
A0 to A6 |
12 bits** |
*A0 à A5 sont étiquetés sur la carte, A6 à A11 sont respectivement disponibles sur les broches 4, 6, 8, 9, 10 et 12
** La résolution analogRead()
par défaut pour ces cartes est de 10 bits, pour la compatibilité. Vous devez utiliser analogReadResolution()
pour le changer en 12 bits.
Syntaxe :
analogRead(pin)
Paramètres :
pin
: le nom de la broche d’entrée analogique à lire (A0 à A5 sur la plupart des cartes, A0 à A6 sur les cartes MKR, A0 à A7 sur Mini et Nano, A0 à A15 sur Mega).
Retour :
La lecture analogique sur la broche. Bien qu’il soit limité à la résolution du convertisseur analogique-numérique (0-1023 pour 10 bits ou 0-4095 pour 12 bits). Type de données : int
.
Exemple de code :
Le code lit la tension sur analogPin et l’affiche.
Remarques et avertissements :
Si la broche d’entrée analogique n’est connectée à rien, la valeur renvoyée par analogRead()
fluctuera en fonction d’un certain nombre de facteurs (par exemple, les valeurs des autres entrées analogiques, la distance entre votre main et la carte, etc.).
Source : https://www.arduino.cc/reference/fr/language/functions/analog-io/analogread/