SoftwareSerial: listen()

[SoftwareSerial]

Description

Enables the selected software serial port to listen. Only one software serial port can listen at a time; data that arrives for other ports will be discarded. Any data already received is discarded during the call to listen() (unless the given instance is already listening).

Syntax

// set up a new serial port
SoftwareSerial mySerial =  SoftwareSerial(rxPin, txPin);

mySerial.listen()

Parameters

mySerial: the name of the instance to listen

Returns

None

Example

#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()
{
  // Start the hardware serial port
  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!"); 
  }
 
}

See also

Libraries Reference Home

The text of the 86Duino reference is a modification of the Arduino reference and is licensed under a Creative Commons Attribution-ShareAlike 3.0 License. Code samples in the reference are released into the public domain.

Leave a Comment

More Articles

Scroll to Top