Функция Serial.end()

 

Функция Serial.end() закрывает последовательное соединение, порты RX и TX освобождаются и могут быть использованы для ввода/вывода.

Синтаксис функции Serial.end(): Serial.end()

Для Arduino Mega и Arduino Due:

Serial1.end() Serial2.end() Serial3.end()

Параметра нет. Возвращаемого значения нет.

 

Функция Serial.available()

 

Функция Serial.available() получает количество байтов (символов), доступных для чтения из последовательного интерфейса связи. Это те байты, которые уже поступили и записаны в буфер последовательного порта. Буфер может хранить до 128 байтов.

Синтаксис функции Serial.available(): Serial. available()

Для Arduino Mega и Arduino Due:

Serial1.available() Serial2.available() Serial3.available()

Параметра нет.

Возвращаемое значение — количество байтов, доступных для чтения (int).

 

Функция Serial.read()

Функция Serial.read() cчитывает очередной доступный байт из буфера последовательного соединения.

Синтаксис функции Serial.read(): Serial.read()

 

Для Arduino Mega и Arduino Due:

Serial1.read() Serial2.read() Serial3.read()

Параметра нет.

Возвращаемое значение — cледующий доступный байт или -1, если его нет (int).

Примеры использования функций Serial.available() и Serial.read() представлены.

int in=0; // переменная для хранения полученного байта

void setup() {

Serial.begin(9600); // устанавливаем последовательное соединение

}

void loop()

{

if (Serial.available() > 0) // если есть доступные данные

{

// считываем байт in = Serial.read();

// отсылаем то, что получили Serial.println(in,DEC);

}

}

 

Функция Serial.flush()

Функция Serial.flush() ожидает окончания передачи исходящих данных (до версии Arduino 1.0 функция очищала буфер последовательного соединения).

Синтаксис функции Serial.flush(): Serial.flush()

Для Arduino Mega и Arduino Due:

Serial1.flush() Serial2.flush() Serial3.flush()

Параметра нет. Возвращаемого значения нет.

 

Функция Serial.print()

Функция Serial.print() передает данные через последовательный порт как текст ASCII. Эта функция может принимать различные типы данных. С помощью второ- го опционального параметра можно задать базис (систему счисления) для чисел.

Синтаксис функции Serial.print():

Serial.print(val) Serial.print(val, format)

Для Arduino Mega и Arduino Due: Serial1, Serial2, Serial3.

Параметры:

 val — данные для передачи через последовательное соединение;

 format — базис для целых чисел или количество знаков после запятой для вещественных:

• BYTE;

• BIN (двоичный);

• OCT (восьмеричный);

• DEC (десятеричный);

• HEX (шестнадцатеричный);

• для вещественных (дробных) чисел второй параметр задает количество знаков после запятой.

Возвращаемого значения нет.

 

Функция Serial.println()

Функция Serial.println() передает данные через последовательный порт как текст ASCII вместе со следующим за ним символом переноса строки (символ ASCII 13 или '\r') и символом новой строки (ASCII 10 или '\n'). Пераметры и типы данных для этой функции такие же, как и для функции Serial.print().

 

Функция Serial.write()

Функция Serial.write() передает данные как бинарный код через последовательное соединение. Данные посылаются единичным байтом или серией байтов. Для того, чтобы передать данные как символы, следует использовать другую функцию — print().

Синтаксис функции Serial.write():

Serial.write(val) Serial.write(str) Serial.print(buf, len)

Для Arduino Mega: Serial1, Serial2, Serial3. Параметры:

 val — один байт;

 str — строка как серия байтов;

 buf — массив байтов;

 len — длина массива. Возвращаемого значения нет.

 

Функция Serial.peek()

 

Функция Serial.peek() возвращает следующий доступный байт (символ) из буфера входящего последовательно соединения, не удаляя его из этого буфера. То есть успешный вызов этой фунции вернет то же значение, что и следующий за ним вызов функции read().

Синтаксис функции Serial.peek(): Serial.peek()

Для Arduino Mega и Arduino Due:

Serial1.peek() Serial2.peek() Serial3.peek()

Параметра нет.

Возвращаемое значение — cледующий доступный байт или -1, если его нет (int).

 

Функция SoftwareSerial.listen()

 

Функция SoftwareSerial.listen() назначает выбранный порт в качестве "слушателя" данных, при этом только один последовательный порт программное обеспечение может слушать одновременно — данные, которые прибывают для других портов, будут отвергнуты. Любые данные, которые уже получены, во время вызова listen() отбрасываются (если данный экземпляр уже не слушает).

Синтаксис функции SoftwareSerial.listen(): SoftwareSerial.listen(port)

Параметра нет. Возвращаемого значения нет.

 

Функция SoftwareSerial.isListening()

 

Функция SoftwareSerial.isListening() проверяет, выступает ли выбранный порт в данный момент в качестве "слушателя" данных.

Синтаксис функции SoftwareSerial.isListening(): SoftwareSerial.isListening()

Параметра нет.

Возвращаемое значение — boolean: false или true.

Примеры назначения порта слушателем и проверки его состояния

#include <SoftwareSerial.h>

// software serial : TX = digital pin 10, RX = digital pin 11 SoftwareSerial portOne(10, 11);

// software serial : TX = digital pin 8, RX = digital pin 9 SoftwareSerial portTwo(8, 9);

void setup()

{

Serial.begin(9600);

// Start both software serial ports portOne.begin(9600); portTwo.begin(9600);

}

void loop()

{

portOne.listen();

if (portOne.isListening())

{Serial.println("Port One is listening!");} else

{Serial.println("Port One is not listening!");}

if (portTwo.isListening())

{Serial.println("Port Two is listening!");} else

{Serial.println("Port Two is not listening!");}

}

Функция SoftwareSerial.overflow()

 

Функция SoftwareSerial.overflow() проверяет, произошло ли переполнение буфера для данного экземпляра последовательного порта. Размер буфера 64 байта. Вызов этой функции очищает флаг переполнения.

Синтаксис функции SoftwareSerial.overflow(): SoftwareSerial.overflow()

Параметра нет.

Возвращаемое значение — boolean: false или true.