analogReference()
Description :
Configure la tension de référence utilisée pour l’entrée analogique (c’est-à-dire la tension maximale détectable). Les options sont :
Arduino AVR Boards (UNO, Mega, Leonardo, etc.)
- PAR DÉFAUT : référence analogique par défaut de 5 V (sur les cartes Arduino 5 VCC) ou 3,3 V (sur les cartes Arduino 3,3 VCC).
- INTERNE : référence intégrée, égale à 1,1 V sur l’ATmega168 ou l’ATmega328P et à 2,56 V sur l’ATmega32U4 et l’ATmega8 (non disponible sur l’Arduino Mega).
- INTERNE1V1 : référence intégrée de 1,1 VCC (Arduino Mega uniquement).
- INTERNE2V56 : référence intégrée de 2,56 VCC (Arduino Mega uniquement).
- EXTERNE : la tension appliquée à la broche AREF (0 à 5 VCC uniquement) sert de référence.
Arduino Renesas Boards (UNO R4, Portenta C33)
- AR_DEFAULT : référence analogique par défaut de 5 V.
- AR_INTERNAL : référence intégrée, égale à 1,5 V sur le RA4M1 de l’UNO R4.
- AR_INTERNAL_1_5V : référence intégrée, égale à 1,5 VCC sur le R7FA6M5 du Portenta C33.
- AR_INTERNAL_2_0V : référence intégrée, égale à 2,0 VCC sur le R7FA6M5 du Portenta C33.
- AR_INTERNAL_2_5V : référence intégrée, égale à 2,5 VCC sur le R7FA6M5 du Portenta C33.
- AR_EXTERNAL : la tension appliquée à la broche AREF (0 à 5 VCC uniquement) est utilisée comme référence.
Arduino SAMD Boards (Zero, etc.)
- AR_DEFAULT : référence analogique par défaut de 3,3 VCC.
- AR_INTERNAL : référence intégrée de 2,23 VCC.
- AR_INTERNAL1V0 : référence intégrée de 1,0 VCC.
- AR_INTERNAL1V65 : référence intégrée de 1,65 VCC.
- AR_INTERNAL2V23 : référence intégrée de 2,23 VCC.
- AR_EXTERNAL : la tension appliquée à la broche AREF sert de référence.
Arduino megaAVR Boards (UNO WiFi Rev2, Arduino Nano Every)
- PAR DÉFAUT : référence intégrée de 0,55 VCC
- INTERNE : référence intégrée de 0,55 VCC
- VDD : tension de référence de l’ATmega4809. 5 VCC sur les modèles Uno WiFi Rev2 et Nano.
- INTERNE0V55 : référence intégrée de 0,55 VCC
- INTERNE1V1 : référence intégrée de 1,1 VCC
- INTERNE1V5 : référence intégrée de 1,5 VCC
- INTERNE2V5 : référence intégrée de 2,5 VCC
- INTERNE4V3 : référence intégrée de 4,3 VCC
- EXTERNE : la tension appliquée à la broche AREF (0 à 5 VCC uniquement) sert de référence.
Arduino SAM Boards (Due)
- AR_DEFAULT : la référence analogique par défaut de 3,3 VDC. Il s’agit de la seule option prise en charge pour le Due.
Arduino Mbed OS Nano Boards (Nano 33 BLE), Arduino Mbed OS Edge Boards (Edge Control)
- AR_VDD : référence par défaut de 3,3 VCC
- AR_INTERNAL : référence intégrée de 0,6 VCC
- AR_INTERNAL1V2 : référence de 1,2 VCC (référence interne de 0,6 VCC avec gain multiplié par 2)
- AR_INTERNAL2V4 : référence de 2,4 VCC (référence interne de 0,6 VCC avec gain multiplié par 4)
La référence analogique Nicla Sense ME et Nicla Voice est fixée à 1,8 VDC et ne peut pas être configurée par logiciel.
Syntaxe :
Utilisez la fonction suivante pour modifier la référence de tension pour les entrées analogiques dans les cartes prises en charge :
analogReference(type)
Paramètres :
La fonction prend en charge le paramètre suivant :
- type : quel type de référence utiliser (voir la liste des options dans la description).
Retours
La fonction ne renvoie rien.
Remarques et avertissements :
Après avoir modifié la référence analogique, les premières mesures de analogRead() peuvent être inexactes.
N’utilisez pas une tension de référence externe inférieure à 0 V ni supérieure à 5 V CC sur la broche AREF ! Si vous utilisez une référence externe sur la broche AREF, vous devez définir la référence analogique sur EXTERNAL avant d’appeler analogRead().
Sinon, vous risquez de court-circuiter la tension de référence active (générée en interne) et la broche AREF, ce qui pourrait endommager le microcontrôleur de votre carte Arduino.
Vous pouvez également connecter la tension de référence externe à la broche AREF via une résistance de 5 kOhm, ce qui vous permet de basculer entre les tensions de référence externe et interne. Notez que la résistance modifie la tension utilisée comme référence, car une résistance interne de 32 kOhm est présente sur la broche AREF. Les deux agissent comme un diviseur de tension. Ainsi, par exemple, une tension de 2,5 V CC appliquée via la résistance produira 2,5 * 32 / (32 + 5) = environ 2,2 V CC sur la broche AREF.
Source : https://docs.arduino.cc/language-reference/en/functions/analog-io/analogReference/