Arduino:Справочник языка Arduino/Функции/Дополнительные функции ввода/вывода/pulseIn() / Онлайн справочник

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

pulseIn()

Считывает длину сигнала на заданном порту (HIGH или LOW). Например, если задано считывание HIGH функцией pulseIn(), функция ожидает пока на заданном порту не появиться HIGH. Когда HIGH получен, включается таймер, который будет остановлен когда на порту вход/выхода будет LOW. Функция pulseIn() возвращает длину сигнала в микросекундах. Функция возвращает 0, если в течение заданного времени (таймаута) не был зафиксирован сигнал на порту.

Возможны некоторые погрешности в измерение длинных сигналов. Функция может измерять сигналы длиной от 10 микросекунд до 3 минут.

Синтаксис

pulseIn(pin, value)
pulseIn(pin, value, timeout)

Параметры

pin: номер порта входа/выхода, на котором будет ожидаться сигнал. (int)
value: тип ожидаемого сигнала — HIGH или LOW.
timeout (опционально): время ожидания сигнала (таймаут) в микросекундах; по умолчанию - одна секунда. (unsigned long)

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

Длина сигнала в микросекундах или 0, если сигнал не получен до истечения таймаута. (unsigned long)

Пример

int pin = 7;
unsigned long duration;
 
void setup()
{
  pinMode(pin, INPUT);
}
 
void loop()
{
  duration = pulseIn(pin, HIGH);
}

См.также

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

Справочник языка 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	-

Arduino продукты
Начальный уровень	Arduino Uno • Arduino Leonardo • Arduino 101 • Arduino Robot • Arduino Esplora • Arduino Micro • Arduino Nano • Arduino Mini • Arduino Starter Kit • Arduino Basic Kit • MKR2UNO • TFT-дисплей Arduino
Продвинутые функции	Arduino Mega 2560 • Arduino Zero • Arduino Due • Arduino Mega ADK • Arduino Pro • Arduino Motor Shield • Arduino USB Host Shield • Arduino Proto Shield • MKR Proto Shield • MKR Proto Large Shield • Arduino ISP • Arduino USB 2 Serial Micro • Arduino Mini USB Serial Adapter
Интернет вещей	Arduino Yun • Arduino Ethernet • Arduino MKR1000 • Arduino WiFi 101 Shield • Arduino GSM Shield V2 • Arduino WiFi Shield • Arduino Wireless SD Shield • Arduino Wireless Proto Shield • Arduino Ethernet Shield V2 • Arduino Yun Shield • Arduino MKR1000 Bundle
Носимые устройства	Arduino Gemma • Lilypad Arduino Simple • Lilypad Arduino Main Board • Lilypad Arduino USB • LilyPad Arduino SimpleSnap
3D-печать	Arduino Materia 101
Устаревшие устройства	-

Примеры Arduino
Стандартные функции
Основы	BareMinimum - Допустимый минимум кода для начала работы. Blink - Включаем и отключаем светодиод. DigitalReadSerial - Считывание последовательной передачи данных через цифровой контакт. AnalogReadSerial - Считывание последовательной передачи данных через аналоговый контакт. Fade - Затухание-загорание светодиода с помощью Arduino. ReadAnalogVoltage - Считывание напряжения, проходящего через аналоговый контакт.
Цифровой сигнал	BlinkWithoutDelay - Мигание без команды Delay Button - Управление светодиодом при помощи кнопки Debounce - Антидребезг Debounce2 - Антидребезг2 ButtonStateChange - Определение изменения состояния кнопки InputPullupSerial - Отслеживание состояния кнопки с помощью встроенного подтягивающего резистора Tone - Проигрывание мелодии с помощью функции Tone Pitch follower - Звук, реагирующий на изменяющуюся информацию Simple keyboard - Простая клавиатура при помощи функции Tone Tone4 - Проигрывание нот на разных динамиках с помощью функции Tone
Аналоговый сигнал	AnalogInPotSerial - Чтение данных от потенциометра и вывод через последовательный порт AnalogInOutSerial - «Сырые» данные на входе, преобразованные на выходе, вывод результата на Serial Monitor AnalogInput - Управление миганием светодиода при помощи потенциометра. AnalogWriteMega - Затухание/загорание (один за одним) 12 светодиодов. Используется плата Arduino Mega. Calibration - Определение максимума и минимума для данных от аналогового датчика. Fading - Использование выходного аналогового контакта (ШИМ) для затухания/загорания светодиода. Smoothing - Сглаживание серии данных, считанных с входного аналогового контакта.
Связь	ReadASCIIString - Анализ строки, состоящей из разделенных запятыми int-значений, и их последующее использование для управления RGB-светодиодом. ASCII Table - Демонстрирует продвинутые способы вывода данных на Serial Monitor. Dimmer - Изменение яркости светодиода при помощи движения мышкой. Graph - Отправка данных на компьютер и их графическое отображение в скетче Processing. Physical Pixel - Включение/выключение светодиода путем отправки данных со скетча Processing (или Max/MSP) на Arduino. Virtual Color Mixer - Отправка с Arduino на компьютер сразу нескольких значений, а затем их считывание при помощи скетча для Processing или Max/MSP. Serial Call Response - Многобайтная передача данных при помощи метода вызова и ответа (метода «рукопожатия»). Serial Call Response ASCII - Многобайтная передача данных при помощи метода вызова и ответа (метода «рукопожатия»). До передачи данные зашифровываются в ASCII. SerialEvent - Демонстрирует использование SerialEvent(). Serial input (Switch (case) Statement) - Как совершать различные действия, беря за основу символы, присланные через последовательный порт. MIDI - Передача через последовательный порт сообщений с MIDI-нотами. MultiSerialMega - Использование двух последовательных портов на Arduino Mega.
Управляющие структуры	If Statement - Как использовать оператор «if» для создания условий, опирающихся на входные аналоговые данные, при которых светодиод будет либо включаться, либо оставаться выключенным. For Loop - Управление несколькими светодиодами, чтобы они мигали, как LED-полоска у автомобиля Китт из сериала «Рыцарь дорог». Array - Вариация примера «For Loop», но с использованием массива. While Loop - Использование цикла while() для калибровки датчика. Калибровка включается при нажатии на кнопку. Switch Case - Как совершать какие-либо действия в зависимости от значений, полученных от датчика. Эквивалент примера «If Statement», но если бы условий было не два, а четыре. Этот пример демонстрирует, как дробить диапазон данных от датчика на четыре «суб-диапазона», а затем в зависимости от полученных результатов совершать одно из четырех действий. Switch Case 2 - Второй пример, демонстрирующий использование оператора switch. Показывает, как совершать различные действия в зависимости от определенных символов, полученных через последовательный порт.
Датчики	ADXL3xx - Считывание данных с акселерометра ADXL3xx. Knock - Определение стука при помощи пьезоэлемента. Memsic2125 - Считывание данных с 2-осевого акселерометра Memsic2125. Ping - Определение объектов при помощи ультразвукового дальномера.
Дисплей	Примеры, объясняющие основы управления дисплеем: LED Bar Graph - Как сделать светодиодную шкалу. Row Column Scanning - Как управлять матрицей светодиодов 8x8.
Строки	StringAdditionOperator - Добавление строк друг к другу различными способами StringAppendOperator - Прибавление данных к строкам. StringCaseChanges - Смена регистра в строках. StringCharacters - Как задать/сосчитать значение определенного символа в строке. StringComparisonOperators - Алфавитное сравнение строк. StringConstructors - Как инициализировать строковые объекты. StringIndexOf - Поиск символов в строке по принципу «столько-то позиций от начала» или «столько-то позиций от конца» StringLength & StringLengthTrim - Как определить длину строки и обрезать ее. StringReplace - Замена отдельных символов в строке. StringStartsWithEndsWith - Как проверить, какими символами/подстроками начинается или заканчивается строка. StringSubstring - Поиск в строке определенных «фраз».
USB (для Leonardo, Micro и Due плат)	В этой секции имеют место примеры, которые демонстрируют использование библиотек, уникальных для плат Leonardo, Micro и Due. KeyboardAndMouseControl - Демонстрирует использование библиотек Mouse и Keyboard в одной программе.
Клавиатура	KeyboardMessage - Отправка текстовой строки при нажатии на кнопку. KeyboardLogout - Выход из текущей пользовательской сессии при помощи клавиатурных комманд. KeyboardSerial - Считывает байт, присланный через последовательный порт, а в ответ отсылает другой байт. KeyboardReprogram - Открывает новое окно в среде разработки Arduino, а затем перешивает Leonardo скетчем «Моргание».
Мышь	ButtonMouseControl - Управление экранным курсором при помощи пяти кнопок. JoystickMouseControl - Управление экранным курсором при помощи джойстика (условие – нажатая кнопка).
Разное

Arduino:Справочник языка Arduino/Функции/Дополнительные функции ввода/вывода/pulseIn()

Содержание

pulseIn()

Синтаксис

Параметры

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

Пример

См.также

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

Навигация

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

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

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

Навигация

Поиск

Инструменты