HOWTO · Arduino

Arduino Neue Zeile drucken

Mit der Funktion Serial.print() oder Serial.println() kann eine neue Zeile gedruckt werden.

Auf dieser Seite

Um in einem Arduino-Sketch eine neue Zeile zu beginnen, rufe Serial.println() nach dem Text oder Wert auf, nach dem die Zeile enden soll. Verwende Serial.print(), wenn der nächste Wert in derselben Zeile fortgesetzt werden soll. Du kannst auch das Zeilenumbruchzeichen \n an Serial.print() übergeben, um eine Zeile ausdrücklich zu beenden. Starte die serielle Kommunikation mit Serial.begin(9600) in setup(), bevor du Daten sendest.

Eine Zeile mit Serial.println() beenden

Serial.println() gibt sein Argument und anschließend einen Zeilenumbruch aus. Jeder Aufruf sorgt daher dafür, dass die nächste Ausgabe nach dem Ende der vorherigen Zeile beginnt. Das ist nützlich für einzelne Messwerte, Statusmeldungen und andere Werte, die jeweils in einer eigenen Zeile leichter lesbar sind.

Das folgende eigenständige C++-Beispiel verwendet einen kleinen Serial-Ersatz, sodass sich der aufgezeichnete Text ohne Arduino-Board überprüfen lässt. Auf einem Board stellt der Arduino-Core Serial bereit und ruft setup() auf; die hier gezeigten Sketch-Aufrufe sind dort dieselben. Führe dieses Beispiel aus:

Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.

#include <cassert>
#include <string>

class SerialPort {
 public:
  std::string data;

  void begin(unsigned long) {}
  void print(const char* value) { data += value; }
  void print(char value) { data += value; }
  void println(const char* value) { data += value; data += '\n'; }
  void println(int value) { data += std::to_string(value); data += '\n'; }
};

SerialPort Serial;

void setup() {
  Serial.begin(9600);
  Serial.println("Arduino is ready");
}

int main() {
  setup();
  assert(Serial.data == "Arduino is ready\n");
}

Der Ersatz zeichnet Text auf, und die Assertion prüft, ob println() einen Zeilenumbruch anhängt. Dies ist ein C++-Modell der Aufrufe, keine Firmware für ein Board. Der bereitgestellte Laufzeittest war erfolgreich: Exitcode 0 und leere Standardausgabe. Die Assertion prüft den aufgezeichneten Text, ohne ihn auf stdout auszugeben.

Mit Serial.print() einen Zeilenumbruch ausgeben

Serial.print() lässt den Ausgabecursor hinter den ausgegebenen Zeichen stehen. Um die Zeile ausdrücklich zu beenden, übergib nach dem vorhergehenden Text das Zeilenumbruchzeichen \n als Zeichenliteral. In einem Sketch lauten die Aufrufe Serial.print("Arduino is ready");, gefolgt von Serial.print('\n');. Der erste gibt die Nachricht aus, der zweite den Zeilenumbruch.

In C++ stehen einfache Anführungszeichen für ein einzelnes Zeichen wie '\n', doppelte Anführungszeichen dagegen für eine Zeichenkette wie "Arduino is ready". Dieser Unterschied ist wichtig: Ein Zeilenumbruchzeichen ist ein einzelnes Zeichen, während "\n" eine Zeichenkette ist, die dieses Zeichen enthält.

Mehrere Werte über mehrere Zeilen ausgeben

Du kannst Aufrufe kombinieren, um eine Bezeichnung zusammen mit einem Wert auszugeben und die Zeile anschließend mit Serial.println() zu beenden. Verwende zum Beispiel Serial.print("Temperature: ");, gefolgt von Serial.println(temperature);. Wiederhole das dann mit Serial.print("Humidity: "); und Serial.println(humidity);. Deklariere die Werte, etwa mit int temperature = 25; und int humidity = 60;, im Sketch, bevor du sie verwendest.

Jeder Aufruf von Serial.print() gibt eine Bezeichnung aus, ohne die Zeile zu beenden. Der folgende Aufruf von Serial.println() gibt den Variablenwert aus und beendet die Zeile. Variablen können direkt übergeben werden; die Formatierung von Zahlen ist unabhängig vom Zeilenumbruchverhalten. Diese zusätzlichen Aufrufe sind als Inline-Beispiele und nicht als zweites Programm dargestellt; der Artikel behauptet daher nicht, dass sie ausgeführt wurden.

Die passende Methode für die serielle Ausgabe wählen

Verwende Serial.println(value), wenn jede Nachricht oder jeder Messwert in einer eigenen Zeile stehen soll. Mit Serial.print(value) kannst du eine Zeile aus mehreren Teilen zusammensetzen. Rufe anschließend Serial.println() oder Serial.print('\n') auf, wenn die Zeile fertig ist. Serial.begin(9600) gehört in setup(), damit die serielle Kommunikation initialisiert ist, bevor der Sketch Daten über den seriellen Anschluss ausgibt.

Ein praktisches Muster ist, eine Bezeichnung mit Serial.print() auszugeben, ihren Wert mit Serial.println() anzuhängen und dies für den nächsten Messwert zu wiederholen. So bleiben Bezeichnungen und Werte zusammen, und aufeinanderfolgende Messwerte lassen sich im Serial Monitor leichter überblicken. Der bereitgestellte Laufzeittest für das eigenständige C++-Modell war erfolgreich: Exitcode 0 und leere Standardausgabe. Er prüft den aufgezeichneten Text mit einer Assertion, statt ihn auf stdout auszugeben.