Serial.write()

Beschreibung

Schreibt binäre Daten an die serielle Schnittstelle. Diese Daten werden als ein Byte oder eine Reihe von Bytes gesendet. Zum Senden der Zeichen, die die Ziffern einer Zahl darstellen, verwende die print()-Funktion.

Syntax

Serial.write(val)

Serial.write(str)

Serial.write(buf, len)

Parameter

  • Serial: Serielles Port-Objekt. Die Liste der verfügbaren seriellen Anschlüsse für jedes Board auf der Serial-Hauptseite.
  • val: Ein Wert, der als einzelnes Byte gesendet werden soll.
  • str: Eine Zeichenfolge, die als Folge von Bytes gesendet werden soll.
  • buf: Ein Array, das als Folge von Bytes gesendet werden soll.
  • len: Die Anzahl der Bytes, die vom Array gesendet werden sollen.

Rückgabewert

Gibt die Anzahl der geschriebenen Bytes zurück, das Lesen dieser Anzahl ist jedoch optional. Datentyp: size_t.

Beispielcode

void setup() { Serial.begin(9600); Serial.write(45); // write a byte with the value 45 => '-' character Serial.write('\n'); // write a newline character Serial.write("ArduinoGetStarted.com\n"); // write a string terminated by a newline character byte buf[] = {'A', 'r', 'd', 'u', 'i', 'n', 'o'}; Serial.write(buf, 7); // write an array } void loop() { }
  • Das ergebnis am seriellen monitor:
COM6
Send
- ArduinoGetStarted.com Arduino
Autoscroll Show timestamp
Clear output
9600 baud  
Newline  

※ Anmerkungen und Warnungen:

  • Seit Arduino IDE 1.0 ist die serielle Übertragung asynchron. Wenn im Sendepuffer genügend freier Speicherplatz vorhanden ist, wird Serial.write() zurückgegeben, bevor Zeichen seriell übertragen werden. Wenn der Sendepuffer voll ist, wird Serial.write() blockiert, bis im Puffer genügend Speicherplatz vorhanden ist. Um das Blockieren von Aufrufen von Serial.write() zu vermeiden, kannst du zunächst den freien Speicherplatz im Sendepuffer mit überprüfen: availableForWrite().
  • Serial functions are not only used for the communication between an Arduino board and Serial Monitor of Arduino IDE but also used for the communication between:
  • An Arduino board and other Arduino board
  • An Arduino board and other sensors/devices
  • An Arduino board and computer (any Serial software on computer)

Siehe Auch

ARDUINO KAUFEMPFEHLUNG

Arduino UNO R3
Arduino Starter Kit
Bitte Beachten: Dies sind Partnerschaftslinks. Wenn Sie die Komponenten über diese Links Kaufen, können wir eine Provision erhalten, ohne weitere Kosten für Sie. Wir Schätzen es.

※ OUR MESSAGES