Arduino:Справочник языка Arduino/Функции/Аналоговый ввод/вывод/analogRead(): различия между версиями / Онлайн справочник

Проверка/Оформление/Редактирование: Мякишев Е.А.

Функция analogRead()

Функция считывает значение с указанного аналогового входа. Большинство плат Arduino имеют 6 каналов (8 каналов у платы Mini и Nano, 16 у Mega) c 10-битным аналого-цифровым преобразователем (АЦП). Напряжение поданное на аналоговый вход, обычно от 0 до 5 вольт будет преобразовано в значение от 0 до 1023, это 1024 шага с разрешением 0.0049 Вольт. Разброс напряжения и шаг может быть изменен функцией analogReference().

Считывание значения с аналогового входа занимает примерно 100 микросекунд (0.0001 сек), т.е. максимальная частота считывания приблизительно 10,000 раз в секунду.

Синтаксис

analogRead(pin)

Параметры

pin: номер порта аналогового входа с которого будет производиться считывание (0..5 для большинства плат, 0..7 для Mini и Nano и 0..15 для Mega)

Возвращаемое значение

int // от 0 до 1023

Замечание

Если аналоговый вход не подключен, то значения возвращаемые функцией analogRead() могут принимать случайные значения.

Пример

int analogPin = 3;     // номер порта к которому подключен потенциометр
int val = 0;           // переменная для хранения считываемого значения
 
void setup()
{
  Serial.begin(9600);              //  установка связи по serial
}
 
void loop()
{
  val = analogRead(analogPin);     // считываем значение
  Serial.println(val);             // выводим полученное значение
}

См.также

Внешние ссылки

Справочник языка Arduino
Конструкции языка
-	setup()‎ • loop()
Управляющие операторы	if • if...else • for • switch case • while • do... while • break • continue • return • goto
Синтаксис	; (точка с запятой) • () (фигурные скобки) • // (однострочный комментарий) • /* */ (многострочный комментарий) • #define • #include
Арифметические операторы	= (оператор присваивания) • + (оператор сложения) • - (оператор вычитания) • * (оператор умножения) • / (оператор деления) • % (оператор деления по модулю)
Операторы сравнения	== (оператор равенства) • != (оператор неравенства) • < (оператор меньше) • > (оператор больше) • Arduino:Справочник языка Arduino/Операторы сравнения/оператор меньше или равно • Arduino:Справочник языка Arduino/Операторы сравнения/оператор больше или равно
Логические операторы	&& (И) • ИЛИ • ! (Отрицание)
Указатели	* (оператор разыменования) • & (оператор ссылки)
Побитовые операторы	Побитовый оператор AND (&) • Побитовый оператор OR • Побитовый оператор XOR (^) • Побитовый оператор NOT (~) • Побитовый оператор сдвига влево (<<) • Побитовый оператор сдвига вправо (>>)
Унарные операторы	++ (инкремент) • -- (декремент) • += (сложение с присваиванием) • -= (вычитание с присваиванием) • *= (умножение с присваиванием) • /= (деление с присваиванием) • &= (побитовый оператор AND, совмещенный с присваиванием) • [1]
Данные
Константы	Константы • HIGH • LOW • INPUT • OUTPUT • INPUT_PULLUP • LED_BUILTIN • true • false • Целочисленные константы • Константы с плавающей запятой
Типы данных	boolean • char • byte • int • unsigned int • word • long • unsigned long • float • double • string • String • array • void
Преобразование типов данных	char() • byte() • int() • word() • long() • float()
Область видимости переменных и квалификаторы	Область видимости • static • volatile • const
Utilities	sizeof() • PROGMEM
Функции
Цифровой ввод/вывод	pinMode() • digitalWrite() • digitalRead()
Аналоговый ввод/вывод	analogRead() • analogReference() • analogWrite()
Due & Zero	analogReadResolution() • analogWriteResolution()
Дополнительные функции ввода/вывода	tone() • noTone() • shiftOut() • shiftIn() • pulseIn()
Работа со временем	millis() • micros() • delay() • delayMicroseconds()
Математические функции	min() • max() • abs() • constrain() • map() • pow() • sq() • sqrt()
Тригонометрические функции	sin() • cos() • tan()
Функции для символьного анализа	isAlphaNumeric() • isAlpha() • isAscii() • isWhitespace() • isControl() • isDigit() • isGraph() • isLowerCase() • isPrintable() • isPunct() • isSpace() • isUpperCase() • isHexadecimalDigit()
Генераторы случайных значений	randomSeed() • random()
Работа с битами и байтами	lowByte() • highByte() • bitRead() • bitWrite() • bitSet() • bitClear() • bit()
Внешние прерывания	attachInterrupt() • detachInterrupt()
Прерывания	interrupts() • noInterrupts()
Функции передачи данных	Serial: if (Serial) • available() • availableForWrite() • begin() • end() • find() • findUntil() • flush() • parseFloat() • parseInt() • peek() • print() • println() • read() • readBytes() • readBytesUntil() • readString() • readStringUntil() • setTimeout() • write() • serialEvent() Stream: available() • read() • flush() • find() • findUntil() • peek() • readBytes() • readBytesUntil() • readString() • readStringUntil() • parseInt() • parsefloat() • setTimeout()
USB (Leonardo based boards and Due only)	Keyboard • Mouse

Библиотеки Arduino
Стандартные библиотеки
EEPROM	read() • write() • update() • get() • put() • EEPROM[]
Ethernet	Класс Ethernet: begin() • localIP() • maintain() Класс IPAddress: IPAddress() Класс Server: Класс Server • EthernetServer() • begin() • available() • write() • print() • println() Класс Client: Класс Client • EthernetClient() • if (EthernetClient) • connected() • connect() • write() • print() • println() • available() • read() • flush() • stop() Класс EthernetUDP: begin() • read() • write() • beginPacket() • endPacket() • parsePacket() • available() • stop() • remoteIP() • remotePort()
Firmata	-
GSM	Класс GSM: Класс GSM • begin() • shutdown() Класс GSMVoiceCall: Класс GSMVoiceCall • getVoiceCallStatus() • ready() • voiceCall() • answerCall() • hangCall() • retrieveCallingNumber() Класс GSM SMS: Класс GSM_SMS • beginSMS() • ready() • endSMS() • available() • remoteNumber() • read() • write() • print() • peek() • flush() Класс GPRS: Класс GPRS • attachGPRS() Класс GSMClient:Класс GSMClient • ready() • connect() • beginWrite() • write() • endWrite() • connected() • read() • available() • peek() • flush() • stop() Класс GSMServer: Класс GSMServer • ready() • beginWrite() • write() • endWrite() • read() • available() • stop() Класс GSMModem: Класс GSMModem • begin() • getIMEI() Класс GSMScanner: Класс GSMScanner • begin() • getCurrentCarrier() • getSignalStrength() • readNetworks() Класс GSMPIN: Класс GSMPIN • begin() • isPIN() • checkPIN() • checkPUK() • changePIN() • switchPIN() • checkReg() • getPINUsed() • setPINUsed() Класс GSMBand: Класс GSMBand • begin() • getBand() • setBand()
LiquidCrystal	LiquidCrystal() • begin() • clear() • home() • setCursor() • write() • print() • cursor() • noCursor() • blink() • noBlink() • display() • noDisplay() • scrollDisplayLeft() • scrollDisplayRight() • autoscroll() • noAutoscroll() • leftToRight() • rightToLeft() • createChar()
SD	Класс SD: begin() • exists() • mkdir() • open() • remove() • rmdir() Класс File: available() • close() • flush() • peek() • position() • print() • println() • seek() • size() • read() • write() • isDirectory() • openNextFile() • rewindDirectory()
Servo	attach() • write() • writeMicroseconds() • read() • attached() • detach()
SPI	Класс SPISettings • begin() • end() • beginTransaction() • endTransaction() • setBitOrder() • setClockDivider() • setDataMode() • transfer() • usingInterrupt() • Расширенное использование шины SPI на Due
SoftwareSerial	Класс SoftwareSerial • available() • begin() • isListening() • overflow() • peek() • read() • print() • println() • listen() • write()
Stepper	Stepper(steps, pin1, pin2) • Stepper(steps, pin1, pin2, pin3, pin4) • setSpeed(rpm) • step(steps)
TFT	Класс TFT • Класс EsploraTFT • begin() • background() • stroke() • noStroke() • fill() • noFill() • text() • setTextSize() • point() • line() • rect() • width() • height() • circle() • image() • loadImage() • Класс PImage • PImage.height() • PImage.width() • PImage.isValid()
WiFi	Класс WiFi: • begin() • disconnect() • config() • setDNS() • SSID() • BSSID() • RSSI() • encryptionType() • scanNetworks() • status() • getSocket() • macAddress() Класс IPAddress: • localIP() • subnetMask() • gatewayIP() Класс WiFiServer: • Класс WiFiServer • WiFiServer() • begin() • available() • write() • print() • println() Класс WiFiClient: • Класс WiFiClient • WiFiClient() • connected() • connect() • write() • print() • println() • available() • read() • flush() • stop() Класс UDP: • Класс WiFiUDP • begin() • available() • beginPacket() • endPacket() • write() • parsePacket() • peek() • read() • flush() • stop() • remoteIP() • remotePort()
Wire	begin() • requestFrom() • beginTransmission() • endTransmission() • write() • available() • read() • onReceive() • onRequest()
Только для Arduino 101
CurieBLE	BLEPeripheral: • Класс BLEPeripheral • begin() • poll() • end() • setAdvertisedServiceUuid() • setLocalName() • setDeviceName() • setAppearance() • setEventHandler() • addAttribute() • disconnect() • central() • connected() BLEDescriptor: • Класс BLEDescriptor BLECentral: • Класс BLECentral • connected() • address() • disconnect() • poll() BLECharacteristic: • Класс BLECharacteristic BLEService: • Класс BLEService
CurieIMU	begin() • getGyroRate() • setGyroRate() • getAccelerometerRate() • setAccelerometerRate() • getGyroRange() • setGyroRange() • getAccelerometerRange() • setAccelerometerRange() • autoCalibrateGyroOffset() • autoCalibrateAccelerometerOffset() • noGyroOffset() • noAccelerometerOffset() • gyroOffsetEnabled() • accelerometerOffsetEnabled() • getGyroOffset() • getAccelerometerOffset() • setGyroOffset() • setAccelerometerOffset() • getDetectionThreshold() • setDetectionThreshold() • getDetectionDuration() • setDetectionDuration() • interrupts() • noInterrupts() • interruptEnabled() • getInterruptStatus() • getStepDetectionMode() • setStepDetectionMode() • readMotionSensor() • readAccelerometer() • readGyro() • readTemperature() • shockDetected() • motionDetected() • tapDetected() • stepsDetected() • attachInterrupt() • detachInterrupt()
CurieTimerOne	start() • restart() • kill() • attachInterrupt() • detachInterrupt() • readTickCount() • rdRstTickCount() • pause() • resume() • pwmStart() • pwmStop()
Только для Arduino Due
Audio	begin() • prepare() • write()
Scheduler	startLoop() • yield()
Только для Arduino Due, Zero и MKR1000
USBHost	Класс MouseController:Класс MouseController • mouseMoved() • mouseDragged() • mousePressed() • mouseReleased() • getXChange() • getYChange() • getButton() Класс KeyboardController:Класс KeyboardController • keyPressed() • keyReleased() • getModifiers() • getKey() • getOemKey()
Только для Arduino Zero и MKR1000
Audio Frequency Meter Library	begin() • end() • setClippingPin() • checkClipping() • setAmplitudeThreshold() • setTimerTolerance() • setSlopeTolerance() • setBandwidth() • getFrequency()
AudioZero	begin() • play() • end()
RTC	begin() • setHours() • setMinutes() • setSeconds() • setTime() • setYear() • setMonth() • setDay() • setDate() • getHours() • getMinutes() • getSeconds() • getYear() • getMonth() • getDay() • setAlarmHours() • setAlarmMinutes() • setAlarmSeconds() • setAlarmTime() • setAlarmYear() • setAlarmMonth() • setAlarmDay() • setAlarmDate() • enableAlarm() • disableAlarm() • attachInterrupt() • detachInterrupt() • standbyMode()
Только для WiFi 101 и MKR1000
WiFi101	Класс WiFi: • begin() • disconnect() • config() • setDNS() • SSID() • BSSID() • RSSI() • encryptionType() • scanNetworks() • status() • macAddress() Класс IPAddress: • localIP() • subnetMask() • gatewayIP() Класс WiFiServer: • Класс WiFiServer • WiFiServer() • begin() • available() • write() • print() • println() Класс WiFiClient: • Класс WiFiClient • WiFiClient() • Класс WiFiSSLClient • connected() • connect() • connectSSL() • write() • print() • println() • available() • read() • flush() • stop() Класс WiFiUDP: • Класс WiFiUDP • begin() • available() • beginPacket() • endPacket() • write() • parsePacket() • peek() • read() • flush() • stop() • remoteIP() • remotePort()
Только для Arduino Robot
Robot	RobotControl: • Класс Robot • begin() • setMode() • pauseMode() • isActionDone() • lineFollowConfig() • digitalRead() • digitalWrite() • analogRead() • analogWrite() • updateIR() • knobRead() • compassRead() • keyboardRead() • waitContinue() • motorsWrite() • motorsStop() • turn() • pointTo() • beginSpeaker() • playMelody() • beep() • playFile() • tuneWrite() • tempoWrite() • beginTFT() • text() • drawBMP() • debugPrint() • clearScreen() • displayLogos() • drawCompass() • beginSD() • userNameRead() • userNameWrite() • robotNameRead() • robotNameWrite() • cityNameRead() • cityNameWrite() • countryNameRead() • countryNameWrite() RobotMotor: • Класс RobotMotor • begin() • process() • parseCommand() • motorsWrite() • IRread()
Только для Arduino Yun
Bridge	Класс Bridge: begin() • put() • get() • transfer() Класс Process: begin() • addParameter() • run() • runAsynchronously() • running() • exitValue() • close() • runShellCommand() • runShellCommandAsynchronously() • available() • read() • write() • peek() • flush() Класс Console: begin() • end() • buffer() • noBuffer() • connected() • available() • read() • write() • peek() • flush() Класс FileIO: Класс FileSystem: begin() • open() • exists() • mkdir() • rmdir() • remove() • Класс File • close() • rewindDirectory() • openNextFile() • seek() • position() • size() • available() • read() • write() • peek() • flush() Класс Mailbox: begin() • end() • readMessage() • writeMessage() • writeJSON() • messageAvailable() Класс HttpClient: get() • getAsynchronously() • ready() • getResult() Класс BridgeClient: stop() • connect() • connected() • available() • read() • write() • peek() • flush() Класс BridgeSSLClient: stop() • connect() • connected() • available() • read() • write() • peek() • flush() Класс BridgeServer: begin() • listenOnLocalhost() • noListenOnLocalhost() • write() Deprecated classes: Класс YunClient: stop() • connect() • connected() • available() • read() • write() • peek() • flush() Класс YunServer: begin() • listenOnLocalhost() • noListenOnLocoalhost() • write()
USB-библиотеки (Leonardo, Micro, Due, Zero и Esplora)
Keyboard	begin() • end() • press() • print() • println() • release() • releaseAll() • write()
Mouse	begin() • click() • end() • move() • press() • release() • isPressed()
Коммуникация (сети и протоколы)
CmdMessenger	-
NewSoftSerial	-
OneWire	-
PS2Keyboard	-
SimpleMessageSystem	-
SSerial2Mobile	-
Webduino	-
X10	-
XBee	-
SerialControl	-
Датчики
CapacitiveSensing	-
Bounce	-
Дисплеи и светодиоды
Adafruit GFX	-
GLCD	-
LedControl	-
LedDisplay	-
Matrix	-
PCD8544	-
Sprite	-
ST7735	-

@@ Строка 10: / Строка 10: @@
 == Синтаксис ==
-<syntaxhighlight lang="c" enclose="div">
+<syntaxhighlight lang="c">
 analogRead(pin)
 </syntaxhighlight>
@@ Строка 16: / Строка 16: @@
 ===Параметры===
-<syntaxhighlight lang="c" enclose="div">
+<syntaxhighlight lang="c">
 pin: номер порта аналогового входа с которого будет производиться считывание (0..5 для большинства плат, 0..7 для Mini и Nano и 0..15 для Mega)
 </syntaxhighlight>
@@ Строка 22: / Строка 22: @@
 === Возвращаемое значение ===
-<syntaxhighlight lang="c" enclose="div">
+<syntaxhighlight lang="c">
 int // от 0 до 1023
 </syntaxhighlight>
@@ Строка 32: / Строка 32: @@
 == Пример ==
-<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS" enclose="div">
+<syntaxhighlight lang="c" line="GESHI_NORMAL_LINE_NUMBERS|GESHI_FANCY_LINE_NUMBERS">
 int analogPin = 3;     // номер порта к которому подключен потенциометр
 int val = 0;           // переменная для хранения считываемого значения

Arduino:Справочник языка Arduino/Функции/Аналоговый ввод/вывод/analogRead(): различия между версиями

Версия от 18:14, 25 декабря 2022

Содержание

Функция analogRead()

Синтаксис

Параметры

Возвращаемое значение

Замечание

Пример

См.также

Внешние ссылки

Навигация

Действия на странице

Действия на странице

Персональные инструменты

Навигация

Поиск

Инструменты