• Arduino 串口库函数


    库函数目录

    if (Serial)

    available()

    availableForWrite()

    begin()

    end()

    find()

    findUntil()

    flush()

    parseFloat()

    parseInt()

    peek()

    print()

    println()

    read()

    readBytes()

    readBytesUntil()

    readString()

    readStringUntil()

    setTimeout()

    write()

    serialEvent()

    库函数详解

    if (Serial)

    Description  指示串行口是否准备好

    Indicates if the specified Serial port is ready.

    On 32u4 based boards (Leonardo, Yùn, ecc) , if (Serial) indicates wether or not the USB CDC serial connection is open. For all other instances, including if (Serial1) on the Leonardo, this will always returns true.

    This was introduced in Arduino 1.0.1.

    Syntax

    All boards:
    if (Serial)

    Arduino Leonardo specific:
    if (Serial1)
    Arduino Mega specific:
    if (Serial1)
    if (Serial2)
    if (Serial3)

    Parameters

    none

    Returns

    boolean : returns true if the specified serial port is available. This will only return false if querying the Leonardo's USB CDC serial connection before it is ready.

    Serial.available()

    Description  得到从串行口读回的字节数

    Get the number of bytes (characters) available for reading from the serial port. This is data that's already arrived and stored in the serial receive buffer (which holds 64 bytes). available() inherits from the Stream utility class.

    Syntax

    Serial.available()

    Arduino Mega only:
    Serial1.available()
    Serial2.available()
    Serial3.available()

    Parameters

    none

    Returns

    the number of bytes available to read

    Example

     1 int incomingByte = 0;   // for incoming serial data
     2 
     3 void setup()
     4 
     5 {
     6         Serial.begin(9600);     // opens serial port, sets data rate to 9600 bps
     7 }
     8 void loop() 
     9 
    10 {
    11         // send data only when you receive data:
    12         if (Serial.available() > 0) 
    13 
    14         {
    15                 // read the incoming byte:
    16                 incomingByte = Serial.read();
    17                 // say what you got:
    18                 Serial.print("I received: ");
    19                 Serial.println(incomingByte, DEC);
    20         }
    21 }

    Arduino Mega example:

     1 void setup() 
     2 
     3 {
     4   Serial.begin(9600);
     5   Serial1.begin(9600);
     6 }
     7 
     8 void loop()
     9 
    10 {
    11   // read from port 0, send to port 1:
    12   if (Serial.available())
    13 
    14   { 
    15     int inByte = Serial.read();
    16     Serial1.print(inByte, BYTE); 
    17   }
    18   // read from port 1, send to port 0:
    19   if (Serial1.available())
    20 
    21   {
    22     int inByte = Serial1.read();
    23     Serial.print(inByte, BYTE); 
    24   }
    25 }

      

    availableForWrite()

    Description  得到缓存中可以写出的字节数

    Get the number of bytes (characters) available for writing in the serial buffer without blocking the write operation.

    Syntax

    Serial.availableForWrite()

    Arduino Mega only:
    Serial1.availableForWrite()
    Serial2.availableForWrite()
    Serial3.availableForWrite()

    Parameters

    none

    Returns

    the number of bytes available to write

    begin()

    Description 设置波特率

    Sets the data rate in bits per second (baud) for serial data transmission. For communicating with the computer, use one of these rates: 300, 600, 1200, 2400, 4800, 9600, 14400, 19200, 28800, 38400, 57600, or 115200. You can, however, specify other rates - for example, to communicate over pins 0 and 1 with a component that requires a particular baud rate.

    An optional second argument configures the data, parity, and stop bits. The default is 8 data bits, no parity, one stop bit.

    Syntax

    Serial.begin(speed)
    Serial.begin(speed, config)

    Arduino Mega only:
    Serial1.begin(speed)
    Serial2.begin(speed)
    Serial3.begin(speed)
    Serial1.begin(speed, config)
    Serial2.begin(speed, config)
    Serial3.begin(speed, config)

    Parameters

    speed: in bits per second (baud) - long
    config: sets data, parity, and stop bits. 设置数据长度,极性,停止位。Valid values are :

    SERIAL_5N1

    SERIAL_6N1

    SERIAL_7N1

    SERIAL_8N1 (the default)  缺省配置:8位数据,无校验位,1个停止位

    SERIAL_5N2

    SERIAL_6N2

    SERIAL_7N2

    SERIAL_8N2

    SERIAL_5E1

    SERIAL_6E1

    SERIAL_7E1

    SERIAL_8E1

    SERIAL_5E2

    SERIAL_6E2

    SERIAL_7E2

    SERIAL_8E2

    SERIAL_5O1

    SERIAL_6O1

    SERIAL_7O1

    SERIAL_8O1

    SERIAL_5O2

    SERIAL_6O2

    SERIAL_7O2

    SERIAL_8O2

    Returns

    nothing

    Example:

    void setup()

    {
        Serial.begin(9600); // opens serial port, sets data rate to 9600 bps
    }

    void loop() { }

    Arduino Mega example:

     1 // Arduino Mega using all four of its Serial ports 
     2 // (Serial, Serial1, Serial2, Serial3), 
     3 // with different baud rates:
     4 void setup()
     5 
     6 {
     7   Serial.begin(9600);
     8   Serial1.begin(38400);
     9   Serial2.begin(19200);
    10   Serial3.begin(4800);
    11 
    12   Serial.println("Hello Computer");
    13   Serial1.println("Hello Serial 1");
    14   Serial2.println("Hello Serial 2");
    15   Serial3.println("Hello Serial 3");
    16 } 
    17 
    18 void loop() { }

    Thanks to Jeff Gray for the mega example

    end()

    Description   禁止串行通信,释放RXTX引脚

    Disables serial communication, allowing the RX and TX pins to be used for general input and output. To re-enable serial communication, call Serial.begin().

    Syntax

    Serial.end()

    Arduino Mega only:
    Serial1.end()
    Serial2.end()
    Serial3.end()

    Parameters

    none

    Returns

    nothing

    Serial.find()

    Description  从串行缓存中读数据直到找到目标字符串

    Serial.find() reads data from the serial buffer until the target string of given length is found. The function returns true if target string is found, false if it times out.

    Serial.find() inherits from the Stream utility class.

    Syntax

    Serial.find(target)

    Parameters

    target : the string to search for (char)

    Returns

    boolean

    Serial.findUntil()

    Description  从串行缓存中读数据直到找到目标字符串或停止符

    Serial.findUntil() reads data from the serial buffer until a target string of given length or terminator string is found.

    The function returns true if the target string is found, false if it times out.

    Serial.findUntil() inherits from the Stream utility class.

    Syntax

    Serial.findUntil(target, terminal)

    Parameters

    target : the string to search for (char)
    terminal : the terminal string in the search (char)

    Returns

    boolean

    flush()

    Description  等待数据发送完成

    Waits for the transmission of outgoing serial data to complete. (Prior to Arduino 1.0, this instead removed any buffered incoming serial data.) 

    flush() inherits from the Stream utility class.

    Syntax

    Serial.flush()

    Arduino Mega only:
    Serial1.flush()
    Serial2.flush()
    Serial3.flush()

    Parameters

    none

    Returns

    nothing

    parseFloat()

    Description  从缓冲区返回第一个有效浮点数据

    Serial.parseFloat() returns the first valid floating point number from the Serial buffer. Characters that are not digits (or the minus sign) are skipped. parseFloat() is terminated by the first character that is not a floating point number.

    Serial.parseFloat() inherits from the Stream utility class.

    Syntax

    Serial.parseFloat()

    Parameters

    none

    Returns

    float

    parseInt()

    Description  从新到的串口数据中查找下一个有效的整数

    Looks for the next valid integer in the incoming serial stream. parseInt() inherits from the Stream utility class.

    In particular:

    Initial characters that are not digits or a minus sign, are skipped;

    Parsing stops when no characters have been read for a configurable time-out value, or a non-digit is read;

    If no valid digits were read when the time-out (see Serial.setTimeout()) occurs, 0 is returned;

    Syntax

    Serial.parseInt()

    Serial.parseInt(char skipChar)

    Arduino Mega only:
    Serial1.parseInt()
    Serial2.parseInt()
    Serial3.parseInt()

    Parameters

    skipChar: used to skip the indicated char in the search. Used for example to skip thousands divider.

    Returns

    long : the next valid integer

    peek()

    Description  读取下一个字节的数据,读取后不从缓存中删除

    Returns the next byte (character) of incoming serial data without removing it from the internal serial buffer. That is, successive calls to peek() will return the same character, as will the next call to read(). peek() inherits from the Stream utility class. 

    Syntax

    Serial.peek()

    Arduino Mega only:
    Serial1.peek()
    Serial2.peek()
    Serial3.peek()

    Parameters

    None

    Returns

    the first byte of incoming serial data available (or -1 if no data is available) - int

    print()

    Description   以ASCII形式输出数据到串口。发送方式为:数据转为字符,发送该字符对应的ASCII码,显示时再转换为字符。

    Prints data to the serial port as human-readable ASCII text. This command can take many forms. Numbers are printed using an ASCII character for each digit. Floats are similarly printed as ASCII digits, defaulting to two decimal places. Bytes are sent as a single character. Characters and strings are sent as is. For example:

    Serial.print(78) gives "78"

    Serial.print(1.23456) gives "1.23"

    Serial.print('N') gives "N"

    Serial.print("Hello world.") gives "Hello world."

    An optional second parameter specifies the base (format) to use; permitted values are BIN (binary, or base 2), OCT (octal, or base 8), DEC (decimal, or base 10), HEX (hexadecimal, or base 16). For floating point numbers, this parameter specifies the number of decimal places to use. For example:

    Serial.print(78, BIN) gives "1001110"

    Serial.print(78, OCT) gives "116"

    Serial.print(78, DEC) gives "78"

    Serial.print(78, HEX) gives "4E"

    Serial.println(1.23456, 0) gives "1"

    Serial.println(1.23456, 2) gives "1.23"

    Serial.println(1.23456, 4) gives "1.2346"

    You can pass flash-memory based strings to Serial.print() by wrapping them with F(). For example :

    Serial.print(F(“Hello World”))

    To send a single byte, use Serial.write().

    Syntax

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

    Parameters

    val: the value to print - any data type

    format: specifies the number base (for integral data types) or number of decimal places (for floating point types)

    Returns

    size_t (long): print() returns the number of bytes written, though reading that number is optional

    Example 

     1 /*
     2 Uses a FOR loop for data and prints a number in various formats.
     3 */
     4 int x = 0;    // variable
     5 
     6 void setup()
     7 {
     8   Serial.begin(9600);      // open the serial port at 9600 bps:    
     9 }
    10 void loop()
    11 {  
    12   // print labels 
    13   Serial.print("NF");       // prints a label no format
    14   Serial.print("	");              // prints a tab
    15 
    16   Serial.print("DEC");  
    17   Serial.print("	");      
    18 
    19   Serial.print("HEX"); 
    20   Serial.print("	");   
    21 
    22   Serial.print("OCT");
    23   Serial.print("	");
    24 
    25   Serial.print("BIN");
    26   Serial.print("	"); 
    27 
    28   Serial.println();  加一个回车符切换到下一行
    29 
    30   for(x=0; x<16; x++)
    31   {    // only part of the ASCII chart, change to suit
    32 
    33     // print it out in many formats:
    34     Serial.print(x);       // print as an ASCII-encoded decimal - same as "DEC"
    35     Serial.print("	");    // prints a tab
    36 
    37     Serial.print(x, DEC);  // print as an ASCII-encoded decimal
    38     Serial.print("	");    // prints a tab
    39 
    40     Serial.print(x, HEX);  // print as an ASCII-encoded hexadecimal
    41     Serial.print("	");    // prints a tab
    42 
    43     Serial.print(x, OCT);  // print as an ASCII-encoded octal
    44     Serial.print("	");    // prints a tab
    45 
    46     Serial.println(x, BIN);  // print as an ASCII-encoded binary
    47     //                             then adds the carriage return with "println"
    48     delay(200);            // delay 200 milliseconds
    49    } 
    50   Serial.println("");      // prints another carriage return  加一个回车符切换到下一行
    51   while(1)
    52   { }
    53 }

    运行结果如下图

                           

    Programming Tips

    As of version 1.0, serial transmission is asynchronous; Serial.print() will return before any characters are transmitted.

      

    println()

    Description  ASCII文本行书输出数据到串口,跟着一个回车换行

    Prints data to the serial port as human-readable ASCII text followed by a carriage return character (ASCII 13, or ' ') and a newline character (ASCII 10, or ' '). This command takes the same forms as Serial.print(). 

    Syntax

    Serial.println(val)
    Serial.println(val, format)

    Parameters

    val: the value to print - any data type

    format: specifies the number base (for integral data types) or number of decimal places (for floating point types)

    Returns

    size_t (long): println() returns the number of bytes written, though reading that number is optional

    Example

     1 /*
     2   Analog input
     3  reads an analog input on analog in 0, prints the value out.
     4  created 24 March 2006
     5  by Tom Igoe
     6  */
     7 int analogValue = 0;    // variable to hold the analog value
     8 
     9 void setup() 
    10 {
    11   // open the serial port at 9600 bps:
    12   Serial.begin(9600);
    13 }
    14 void loop() 
    15 {
    16   // read the analog input on pin 0:
    17   analogValue = analogRead(0);
    18 
    19   // print it out in many formats:
    20   Serial.println(analogValue);       // print as an ASCII-encoded decimal
    21   Serial.println(analogValue, DEC);  // print as an ASCII-encoded decimal
    22   Serial.println(analogValue, HEX);  // print as an ASCII-encoded hexadecimal
    23   Serial.println(analogValue, OCT);  // print as an ASCII-encoded octal
    24   Serial.println(analogValue, BIN);  // print as an ASCII-encoded binary
    25 
    26   // delay 10 milliseconds before the next reading:
    27   delay(10);
    28 }

    read()

    Description 从串口中读取数据,每次读1个字节。读取后将该数据从缓存删除。

    Reads incoming serial data. read() inherits from the Stream utility class.

    Syntax

    Serial.read()

    Arduino Mega only:
    Serial1.read()
    Serial2.read()
    Serial3.read()

    Parameters

    None

    Returns

    the first byte of incoming serial data available (or -1 if no data is available) - int

    Example

     1 int incomingByte = 0;   // for incoming serial data
     2 
     3 void setup()
     4 
     5 {
     6         Serial.begin(9600);     // opens serial port, sets data rate to 9600 bps
     7 } 
     8 
     9 void loop()
    10 
    11 {
    12         // send data only when you receive data:
    13         if (Serial.available() > 0)
    14 
    15         {
    16                 // read the incoming byte:
    17                 incomingByte = Serial.read();
    18                 // say what you got:
    19                 Serial.print("I received: ");
    20                 Serial.println(incomingByte, DEC);
    21         }
    22 }

    Serial.readBytes()

    Description  从缓冲区读取指定长度的字符

    Serial.readBytes() reads characters from the serial port into a buffer. The function terminates if the determined length has been read, or it times out (see Serial.setTimeout()).

    Serial.readBytes() returns the number of characters placed in the buffer. A 0 means no valid data was found.

    Serial.readBytes() inherits from the Stream utility class.

    Syntax

    Serial.readBytes(buffer, length)

    Parameters

    buffer: the buffer to store the bytes in (char[] or byte[])
    length : the number of bytes to read (int)

    Returns

    byte

    Serial.readBytesUntil()

    Description  读取指定长度的字符到一个数组中

    Serial.readBytesUntil() reads characters from the serial buffer into an array. The function terminates if the terminator character is detected, the determined length has been read, or it times out (see Serial.setTimeout()).  

    Serial.readBytesUntil() returns the number of characters read into the buffer. A 0 means no valid data was found.

    Serial.readBytesUntil() inherits from the Stream utility class.

    Syntax

    Serial.readBytesUntil(character, buffer, length)

    Parameters

    character : the character to search for (char)
    buffer: the buffer to store the bytes in (char[] or byte[])

    length : the number of bytes to read (int)

    Returns

    byte

    readString()

    Description  读取字符到一个字符串,直到超时

    Serial.readString() reads characters from the serial buffer into a string. The function terminates if it times out (see setTimeout()).

    This function is part of the Stream class, and is called by any class that inherits from it (Wire, Serial, etc). See the Stream class main page for more information.

    Syntax

    Serial.readString()

    Parameters

    none

    Returns

    A string read from the serial buffer

    readStringUntil()

    Description  读取字符到一个字符串,遇到停止符停止读取

    readStringUntil() reads characters from the serial buffer into a string. The function terminates if the terminator character is detected or it times out (see setTimeout()). 

    This function is part of the Stream class, and is called by any class that inherits from it (Wire, Serial, etc). See the Stream class main page for more information.

    Syntax

    Serial.readStringUntil(terminator)

    Parameters

    terminator : the character to search for (char)

    Returns

    The entire string

    Serial.setTimeout()

    Description  等待读数据时的最大时间(单位为毫秒),缺省值为1000

    Serial.setTimeout() sets the maximum milliseconds to wait for serial data when using Serial.readBytesUntil(), Serial.readBytes(), Serial.parseInt() or Serial.parseFloat(). It defaults to 1000 milliseconds.

    Serial.setTimeout() inherits from the Stream utility class.

    Syntax

    Serial.setTimeout(time)

    Parameters

    time : timeout duration in milliseconds (long).

    Returns

    None

    write()

    Description  输出二进制数据到串口。发送数据本身,收到数据后显示时会将该数据当作ASCII码而显示其对应的字符

    Writes binary data to the serial port. This data is sent as a byte or series of bytes; to send the characters representing the digits of a number use the print() function instead.

    Syntax

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

    Arduino Mega also supports: Serial1, Serial2, Serial3 (in place of Serial)

    Parameters

    val: a value to send as a single byte

    str: a string to send as a series of bytes

    buf: an array to send as a series of bytes

    len: the length of the buffer

    Returns

    byte
    write() will return the number of bytes written, though reading that number is optional

    Example

     1 byte BYTE[3]={49,50,51};
     2 
     3 void setup()
     4 
     5 {
     6 
     7   Serial.begin(9600);
     8 
     9 }
    10 
    11 void loop()
    12 
    13 {
    14 
    15   Serial.write(45);  // send a byte with the value 45
    16 
    17   Serial.println();
    18 
    19   Serial.write(BYTE,3);  // send a byte with the value 45
    20 
    21   Serial.println();
    22 
    23   int bytesSent = Serial.write("hello");  //send the string “hello” and return the length of the string.
    24 
    25   Serial.println();
    26 
    27   while(1)
    28 
    29   {  }
    30 
    31 } 

     运行结果如下图

     

    十进制数45对应的ASCII字符为“-”,十进制数49,50,51对应的ASCII字符为1,2,3,字符“HELLO”原码输出。

    serialEvent()

    Description  串口缓冲区有数据则执行该函数

    Called when data is available. Use Serial.read() to capture this data.

    NB : Currently, serialEvent() is not compatible with the Esplora, Leonardo, or Micro

    Syntax

    void serialEvent()

    {
    //statements
    }

    Arduino Mega only:

    void serialEvent1()

    {

    //statements

    }

    void serialEvent2()

    {
    //statements
    }

    void serialEvent3()

    {
    //statements

    }

    Parameters

    statements: any valid statements

  • 相关阅读:
    jQuery基础之让出$,与其他库共存
    什么是闭包
    绑定repeater时三目运算加特殊结果处理
    将同一张表出来的两部分内容再合成一张表
    后台往前台写弹窗代码不显示
    固定行列转换加分段统计
    js调用后台方法(如果你能容忍执行的后台方法变成一个常量)
    javascript遍历数组
    基于SpringMVC框架使用ECharts3.0实现折线图,柱状图,饼状图,的绘制(上篇)
    echarts
  • 原文地址:https://www.cnblogs.com/MyAutomation/p/9539495.html
Copyright © 2020-2023  润新知