HOWTO · Arduino
Arduino Warten auf Eingabe
Mit der Funktion Serial.available() und der Funktion digitalRead() kann das Arduino so eingestellt werden, dass es auf die Eingabe wartet.
Auf dieser Seite
Wählen Sie die Eingabequelle passend zum Signal: Verwenden Sie die serielle Eingabe für Bytes, die von einem Computer oder einem anderen Gerät gesendet werden, digitalRead() für einen Ein/Aus-Pin wie den eines Tasters und analogRead(), um einen Sensorwert mit einem Schwellenwert zu vergleichen. Die Arduino-Sketches unten verwenden die Standard-Arduino-API. Die begleitenden portablen C++-Testprogramme bilden die Hardware des Boards deterministisch nach, sodass sich ihre Eingabelogik auch ohne Arduino-Board kompilieren und nachvollziehen lässt; elektrisches Verhalten testen sie nicht.
Eingabequelle wählen: seriell, digital oder analog
Verwenden Sie die serielle Schnittstelle, wenn ein Host Zeichen oder Befehle über USB oder eine UART-Verbindung sendet. Ein digitaler Pin eignet sich für ein Signal mit zwei Zuständen. Verwenden Sie einen Analogeingang, wenn der Sensor eine veränderliche Spannung liefert, die Sie erfassen und vergleichen möchten. Wählen Sie Pin und elektrische Beschaltung passend zu Ihrem Board und Sensor; in den Beispielen dient Pin 2 als Tastereingang und A0 als Analogeingang für einen Sensor.
Auf serielle Daten mit Serial.available() warten
Serial.available() gibt an, wie viele Bytes im Empfangspuffer warten. Prüfen Sie den Wert, bevor Sie Serial.read() aufrufen, damit der Sketch nicht versucht, ein noch nicht verfügbares Byte zu lesen. Dieses Beispiel liest und wiederholt jeweils ein Byte. Das eignet sich für einen einfachen Zeichenbefehl. Eine vollständige Zeile setzt es nicht zusammen; sammeln Sie für zeilenbasierte Befehle Bytes bis zum Zeilenumbruch und behandeln Sie das Zeilenende ausdrücklich.
Führen Sie dieses portable Testprogramm aus, um das Muster für die Byteverarbeitung nachzuvollziehen. Behalten Sie im Arduino-Sketch setup() und loop() bei und verwenden Sie statt des hier gezeigten einfachen Ersatzobjekts das Serial-Objekt des Boards.
#include <iostream>
class SerialPort {
public:
void begin(int) {}
int available() const { return next_ < 1; }
int read() { ++next_; return 65; }
void print(const char* text) { std::cout << text; }
void println(int value) { std::cout << value << '\n'; }
private:
int next_ = 0;
};
SerialPort Serial;
void setup() {
Serial.begin(9600);
}
void loop() {
if (Serial.available() > 0) {
int incomingByte = Serial.read();
Serial.print("Received byte: ");
Serial.println(incomingByte);
}
}
int main() {
setup();
loop();
}
Received byte: 65
Stellen Sie im seriellen Monitor oder auf dem sendenden Gerät dieselbe Baudrate ein. Da Serial.read() einen ganzzahligen Bytewert zurückgibt, gibt das Beispiel einen beschrifteten numerischen Byte-Bericht aus – die Beschriftung Received byte: gefolgt vom Zahlenwert des Bytes. Wenn Sie stattdessen das Zeichen selbst ausgeben möchten, wandeln Sie den Wert in char um.
Auf einen digitalen Eingang mit digitalRead() warten
Ein digitaler Eingang wird am Pin gelesen, nicht über die serielle Schnittstelle. Wenn ein Taster zwischen Pin 2 und Masse angeschlossen ist, konfigurieren Sie den Pin als INPUT_PULLUP: Im ungedrückten Zustand wird HIGH gelesen, beim Drücken LOW. Die Schleife wartet zuerst auf das Drücken und anschließend auf das Loslassen. Während sie auf eine der beiden Bedingungen wartet, hält diese Abfrage andere Arbeiten in loop() an.
Dieses portable Testprogramm übergibt der gleichen Wartelogik eine Folge von Pinzuständen. Ersetzen Sie im Arduino-Sketch die Ersatzfunktionen durch die Board-APIs pinMode() und digitalRead().
#include <iostream>
const int INPUT_PULLUP = 2;
const int HIGH = 1;
const int LOW = 0;
const int buttonPin = 2;
int pinStates[] = {HIGH, LOW, LOW, HIGH};
int stateIndex = 0;
void pinMode(int, int) {}
int digitalRead(int) { return pinStates[stateIndex++]; }
class SerialPort {
public:
void begin(int) {}
void println(const char* text) { std::cout << text << '\n'; }
};
SerialPort Serial;
void setup() {
pinMode(buttonPin, INPUT_PULLUP);
Serial.begin(9600);
}
void loop() {
while (digitalRead(buttonPin) == HIGH) {
}
Serial.println("Button pressed");
while (digitalRead(buttonPin) == LOW) {
}
}
int main() {
setup();
loop();
}
Button pressed
Der interne Pull-up-Widerstand hält den Eingang auf einem definierten Pegel, wenn der Taster geöffnet ist. Ist der Taster stattdessen mit einer positiven Versorgungsspannung verbunden und wird ein externer Pull-down-Widerstand verwendet, nutzen Sie INPUT und prüfen Sie beim Drücken auf HIGH. Stimmen Sie die Signalpolarität im Code auf die Schaltung ab, damit der Eingang nicht unbeschaltet bleibt und die Reaktion nicht umgekehrt ist.
Auf einen analogen Schwellenwert mit analogRead() warten
analogRead() erfasst die Spannung an einem Analogeingang und gibt einen Zahlenwert zurück. Vergleichen Sie diesen Wert mit einem Schwellenwert, den Sie passend zu Sensor und Board wählen. Dieser Sketch meldet, wenn ein Messwert über dem Schwellenwert liegt – auch schon beim ersten Durchlauf, falls das bereits zutrifft. Nach der Meldung wartet er, bis ein späterer Messwert den Schwellenwert erreicht oder unterschreitet, bevor er erneut melden kann.
Dieses portable Testprogramm liefert zwei Messwerte: zuerst einen über dem Schwellenwert und danach einen, der ihn erreicht oder unterschreitet. Auf dem Board stellt der Arduino-Core A0 und analogRead() bereit; verfügbare Pins und Messbereich hängen vom Board ab.
#include <iostream>
const int A0 = 0;
const int sensorPin = A0;
const int threshold = 500;
int readings[] = {600, 450};
int readingIndex = 0;
int analogRead(int) { return readings[readingIndex++]; }
class SerialPort {
public:
void begin(int) {}
void println(const char* text) { std::cout << text << '\n'; }
};
SerialPort Serial;
void setup() {
Serial.begin(9600);
}
void loop() {
int sensorValue = analogRead(sensorPin);
if (sensorValue > threshold) {
Serial.println("Threshold exceeded");
while (analogRead(sensorPin) > threshold) {
}
}
}
int main() {
setup();
loop();
}
Threshold exceeded
Der Zahlenbereich und die durch analogRead() dargestellte Spannung hängen vom Board ab. Schlagen Sie die Dokumentation des Boards nach und kalibrieren Sie threshold anhand der Sensorwerte. Dabei werden wiederholt Messwerte erfasst und verglichen; es handelt sich nicht um das Warten auf serielle Bytes.
Verhindern, dass der Rest des Sketches blockiert
Eine enge while-Schleife prüft den Eingang fortlaufend, verhindert aber, dass der übrige Teil von loop() ausgeführt wird, bis sich die Bedingung ändert. Das ist sinnvoll, wenn der Sketch an dieser Stelle anhalten soll, verzögert jedoch andere Aufgaben wie eine Anzeige zu aktualisieren oder einen weiteren Eingang zu prüfen. Wenn der Sketch weiterarbeiten muss, prüfen Sie den Eingang einmal pro Durchlauf und speichern Sie den Zustand, statt in einer Schleife zu warten. Verwenden Sie beispielsweise if (Serial.available() > 0), um verfügbare Bytes zu verarbeiten und anschließend mit dem restlichen loop() fortzufahren.
Wenn der Sketch nicht zu reagieren scheint, prüfen Sie, ob der gewählte Pin zur Verdrahtung passt, der digitale Eingang einen definierten Pegel hat, der Sender die eingestellte Baudrate verwendet und der analoge Schwellenwert zum Messbereich des Boards passt. Eine blockierende Warteschleife endet außerdem erst, wenn sich der geprüfte Zustand ändert.