Версия от 19:09, 15 февраля 2023

Перевод: Максим Кузьмин

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

Функции Serial^[1]

Эти функции используются для передачи данных между платой Arduino и компьютером или другими девайсами. У всех плат Arduino есть как минимум один последовательный порт (также именуемый UART или USART) — Serial. Для обмена данными эти функции используют 0-ой (RX) и 1-ый (TX) цифровые контакты, а также USB. Таким образом, если вы пользуетесь функциями Serial, то эти контакты уже нельзя будет использовать для цифрового ввода и вывода данных.

Для коммуникации с платой Arduino можно использовать монитор последовательного порта (Serial Monitor), встроенный в среду разработки Arduino. Чтобы вызвать его, кликните на кнопку Serial Monitor и задайте ту же скорость передачи данных, что указали в функции begin().

Плата Arduino Mega имеет три дополнительных последовательных порта: Serial1 — на 19-ом (RX) и 18-ом (TX) контактах, Serial2 — на 17-ом (RX) и 16-ом (TX) контактах и Serial3 — на 15-ом (RX) и 14-ом (TX) контактах. Чтобы использовать эти контакты для коммуникации с ПК, вам понадобится дополнительный адаптер USB-Serial, т.к. они не подсоединены к встроенному в Mega адаптеру USB-Serial. Чтобы использовать их с внешним TTL-девайсом, подключите TX-контакт платы к RX-контакту этого девайса, а RX-контакт платы — к TX-контакту девайса, а «землю» Mega подключите к «земле» девайса. Не подключайте эти контакты к последовательному порту RS232 напрямую , т.к. он работает со значениями +/- 12V и может запросто повредить вашу Arduino.

Плата Arduino Due имеет три дополнительных последовательных 3,3-вольтовых TTL-порта: Serial1 – на 19-ом (RX) и 18-ом (TX) контактах, Serial2 — на 17-ом (RX) и 16-ом (TX) контактах и Serial3 — на 15-ом (RX) и 14-ом (TX) контактах. Кроме того, контакты 0 и 1 подключены к соответствующим контактам чипа Atmega16U2 с прошивкой USB-TTL, который в свою очередь подключен к отладочному USB-порту. Вдобавок на чипе SAM3X имеется родной порт USB-Serial – SerialUSB.

Плата Arduino Leonardo использует Serial1 для коммуникации через последовательный 5-вольтовый TTL-порт с помощью контактов 0 (RX) и 1 (TX). Serial отведен под коммуникацию типа USB CDC. Более подробно об этом можно прочесть на странице, описывающей начало работы с Leonardo, и на странице с аппаратным описанием Leonardo.

Функции

Примеры

ReadASCIIString
ASCII Table
Dimmer
Graph
Physical Pixel
Virtual Color Mixer
Serial Call Response
Serial Call Response ASCII

См.также

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

↑ Serial

[1] Serial

[1]

@@ Строка 5: / Строка 5: @@
 =Функции Serial<ref>[https://www.arduino.cc/en/Reference/Serial Serial]</ref>=
-Эти функции используются для передачи данных между платой '''Arduino''' и компьютером или другими девайсами. У всех плат '''Arduino''' есть как минимум один последовательный порт (также именуемый '''UART''' или '''USART''') — '''Serial'''. Для обмена данными эти функции используют '''0-ой (RX)''' и '''1-ый (TX)''' цифровые контакты, а также '''USB'''. Таким образом, если вы пользуетесь функциями '''Serial''', то эти контакты уже нельзя будет использовать для цифрового ввода и вывода данных.
+Эти функции используются для передачи данных между платой Arduino и компьютером или другими девайсами. У всех плат Arduino есть как минимум один последовательный порт (также именуемый UART или USART) — Serial. Для обмена данными эти функции используют 0-ой (RX) и 1-ый (TX) цифровые контакты, а также USB. Таким образом, если вы пользуетесь функциями Serial, то эти контакты уже нельзя будет использовать для цифрового ввода и вывода данных.
-Для коммуникации с платой '''Arduino''' можно использовать монитор последовательного порта ('''Serial Monitor'''), встроенный в среду разработки '''Arduino'''. Чтобы вызвать его, кликните на кнопку '''Serial Monitor''' и задайте ту же скорость передачи данных, что указали в функции begin().
+Для коммуникации с платой Arduino можно использовать монитор последовательного порта (Serial Monitor), встроенный в среду разработки Arduino. Чтобы вызвать его, кликните на кнопку Serial Monitor и задайте ту же скорость передачи данных, что указали в функции begin().
-Плата '''Arduino Mega''' имеет три дополнительных последовательных порта: '''Serial1''' — на '''19-ом (RX)''' и '''18-ом (TX)''' контактах, '''Serial2''' — на '''17-ом (RX)''' и '''16-ом (TX)''' контактах и '''Serial3''' — на '''15-ом (RX)''' и '''14-ом (TX)''' контактах. Чтобы использовать эти контакты для коммуникации с '''ПК''', вам понадобится дополнительный адаптер '''USB-Serial''', т.к. они не подсоединены к встроенному в '''Mega''' адаптеру '''USB-Serial'''. Чтобы использовать их с внешним '''TTL'''-девайсом, подключите '''TX'''-контакт платы к '''RX'''-контакту этого девайса, а '''RX'''-контакт платы — к '''TX'''-контакту девайса, а '''«землю» Mega''' подключите к '''«земле»''' девайса. Не подключайте эти контакты к последовательному порту '''RS232''' напрямую , т.к. он работает со значениями '''+/- 12V''' и может запросто повредить вашу '''Arduino'''.
+Плата Arduino Mega имеет три дополнительных последовательных порта: Serial1 — на 19-ом (RX) и 18-ом (TX) контактах, Serial2 — на 17-ом (RX) и 16-ом (TX) контактах и Serial3 — на 15-ом (RX) и 14-ом (TX) контактах. Чтобы использовать эти контакты для коммуникации с ПК, вам понадобится дополнительный адаптер USB-Serial, т.к. они не подсоединены к встроенному в Mega адаптеру USB-Serial. Чтобы использовать их с внешним TTL-девайсом, подключите TX-контакт платы к RX-контакту этого девайса, а RX-контакт платы — к TX-контакту девайса, а «землю» Mega подключите к «земле» девайса. Не подключайте эти контакты к последовательному порту RS232 напрямую , т.к. он работает со значениями +/- 12V и может запросто повредить вашу Arduino.
-Плата '''Arduino Due''' имеет три дополнительных последовательных '''3,3-вольтовых TTL-порта''': '''Serial1 – на 19-ом (RX) и 18-ом (TX) контактах, Serial2 — на 17-ом (RX) и 16-ом (TX) контактах и Serial3 — на 15-ом (RX) и 14-ом (TX) контактах'''. Кроме того, контакты '''0 и 1''' подключены к соответствующим контактам чипа '''Atmega16U2''' с прошивкой '''USB-TTL''', который в свою очередь подключен к отладочному '''USB'''-порту. Вдобавок на чипе '''SAM3X''' имеется родной порт '''USB-Serial – SerialUSB'''.
+Плата Arduino Due имеет три дополнительных последовательных 3,3-вольтовых TTL-порта: Serial1 – на 19-ом (RX) и 18-ом (TX) контактах, Serial2 — на 17-ом (RX) и 16-ом (TX) контактах и Serial3 — на 15-ом (RX) и 14-ом (TX) контактах. Кроме того, контакты 0 и 1 подключены к соответствующим контактам чипа Atmega16U2 с прошивкой USB-TTL, который в свою очередь подключен к отладочному USB-порту. Вдобавок на чипе SAM3X имеется родной порт USB-Serial – SerialUSB.
-Плата '''Arduino Leonardo''' использует '''Serial1''' для коммуникации через последовательный '''5-вольтовый TTL-порт''' с помощью контактов '''0 (RX) и 1 (TX)'''. '''Serial''' отведен под коммуникацию типа '''USB CDC'''. Более подробно об этом можно прочесть на [https://www.arduino.cc/en/Guide/ArduinoLeonardo странице, описывающей начало работы с Leonardo], и на [https://www.arduino.cc/en/Main/ArduinoBoardLeonardo странице с аппаратным описанием Leonardo].
+Плата Arduino Leonardo использует Serial1 для коммуникации через последовательный 5-вольтовый TTL-порт с помощью контактов 0 (RX) и 1 (TX). Serial отведен под коммуникацию типа USB CDC. Более подробно об этом можно прочесть на [https://www.arduino.cc/en/Guide/ArduinoLeonardo странице, описывающей начало работы с Leonardo], и на [https://www.arduino.cc/en/Main/ArduinoBoardLeonardo странице с аппаратным описанием Leonardo].

Справочник языка 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/Библиотеки/Serial: различия между версиями

Версия от 19:09, 15 февраля 2023

Содержание

Функции Serial^[1]

Функции

Примеры

См.также

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

Навигация

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

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

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

Навигация

Поиск

Инструменты

Arduino:Справочник языка Arduino/Библиотеки/Serial: различия между версиями

Версия от 19:09, 15 февраля 2023

Функции Serial[1]

Функции

Примеры

См.также

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

Навигация

Поиск

Функции Serial^[1]