analogReference()
Описание
Настраивает опорное напряжение, используемое для аналогового входа (т.е. максимальное напряжение, которое может быть измерено). Доступные варианты:
Платы Arduino AVR (UNO, Mega, Leonardo и др.)
DEFAULT: опорное напряжение по умолчанию — 5 вольт (на платах Arduino с питанием 5 В) или 3,3 вольта (на платах с питанием 3,3 В).
INTERNAL: встроенное опорное напряжение, равное 1,1 В на ATmega168 или ATmega328P и 2,56 В на ATmega32U4 и ATmega8 (недоступно на Arduino Mega).
INTERNAL1V1: встроенное опорное напряжение 1,1 В (только Arduino Mega).
INTERNAL2V56: встроенное опорное напряжение 2,56 В (только Arduino Mega).
EXTERNAL: в качестве опорного используется напряжение, подключённое к пину AREF (только от 0 до 5 В).
Платы Arduino Renesas (UNO R4, Portenta C33)
AR_DEFAULT: опорное напряжение по умолчанию — 5 вольт.
AR_INTERNAL: встроенное опорное напряжение, равное 1,5 В на RA4M1 платы UNO R4.
AR_INTERNAL_1_5V: встроенное опорное напряжение 1,5 В на R7FA6M5 платы Portenta C33.
AR_INTERNAL_2_0V: встроенное опорное напряжение 2,0 В на R7FA6M5 платы Portenta C33.
AR_INTERNAL_2_5V: встроенное опорное напряжение 2,5 В на R7FA6M5 платы Portenta C33.
AR_EXTERNAL: в качестве опорного используется напряжение, подключённое к пину AREF (только от 0 до 5 В).
Платы Arduino SAMD (Zero и др.)
AR_DEFAULT: опорное напряжение по умолчанию — 3,3 В.
AR_INTERNAL: встроенное опорное напряжение 2,23 В.
AR_INTERNAL1V0: встроенное опорное напряжение 1,0 В.
AR_INTERNAL1V65: встроенное опорное напряжение 1,65 В.
AR_INTERNAL2V23: встроенное опорное напряжение 2,23 В.
AR_EXTERNAL: в качестве опорного используется напряжение, подключённое к пину AREF.
Платы Arduino megaAVR (UNO WiFi Rev2, Arduino Nano Every)
DEFAULT: встроенное опорное напряжение 0,55 В.
INTERNAL: встроенное опорное напряжение 0,55 В.
VDD: Vdd ATmega4809. 5 В на Uno WiFi Rev2 и Nano Every.
INTERNAL0V55: встроенное опорное напряжение 0,55 В.
INTERNAL1V1: встроенное опорное напряжение 1,1 В.
INTERNAL1V5: встроенное опорное напряжение 1,5 В.
INTERNAL2V5: встроенное опорное напряжение 2,5 В.
INTERNAL4V3: встроенное опорное напряжение 4,3 В.
EXTERNAL: в качестве опорного используется напряжение, подключённое к пину AREF (только от 0 до 5 В).
Платы Arduino SAM (Due)
AR_DEFAULT: опорное напряжение по умолчанию — 3,3 В. Это единственный поддерживаемый вариант для Due.
Платы Arduino Mbed OS Nano (Nano 33 BLE), Arduino Mbed OS Edge (Edge Control)
AR_VDD: опорное напряжение по умолчанию — 3,3 В.
AR_INTERNAL: встроенное опорное напряжение 0,6 В.
AR_INTERNAL1V2: опорное напряжение 1,2 В (внутренние 0,6 В с усилением 2x).
AR_INTERNAL2V4: опорное напряжение 2,4 В (внутренние 0,6 В с усилением 4x).
Примечание
Аналоговое опорное напряжение Nicla Sense ME и Nicla Voice фиксировано на 1,8 В и не может быть изменено программно.
Синтаксис
Используйте следующую функцию для изменения опорного напряжения аналоговых входов на поддерживаемых платах:
analogReference(type)
Параметры
Функция поддерживает следующий параметр:
type: тип используемого опорного напряжения (см. список вариантов в описании).
Возвращаемое значение
Функция ничего не возвращает.
Примечания и предупреждения
Примечание
После изменения аналогового опорного напряжения первые несколько считываний с analogRead() могут быть неточными.
Предупреждение
Не подавайте на пин AREF напряжение ниже 0 В или выше 5 В! Если вы используете внешнее опорное напряжение на пине AREF, необходимо установить аналоговое опорное напряжение в EXTERNAL перед вызовом analogRead().
В противном случае вы замкнёте активное опорное напряжение (генерируемое внутренне) и пин AREF, что может повредить микроконтроллер на вашей плате Arduino.
В качестве альтернативы можно подключить внешнее опорное напряжение к пину AREF через резистор 5 кОм, что позволит переключаться между внешним и внутренним опорным напряжением. Обратите внимание, что резистор изменит используемое напряжение, поскольку на пине AREF имеется внутренний резистор 32 кОм. Они работают как делитель напряжения, поэтому, например, 2,5 В, поданные через резистор, дадут 2,5 * 32 / (32 + 5) = ~2,2 В на пине AREF.