• Post category:Serial
  • Post comments:0 commentaire
  • Post last modified:mars 11, 2022
  • Temps de lecture :3 min de lecture

Serial.write()

Description :

Écrit des données binaires sur le port série. Ces données sont envoyées sous forme d’octet ou de série d’octets ; pour envoyer les caractères représentant les chiffres d’un nombre, utilisez plutôt la fonction print() .

Syntaxe :

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

Paramètres :

Serial : objet port série. Consultez la liste des ports série disponibles pour chaque carte sur la page principale Serial .
val : une valeur à envoyer sous la forme d’un seul octet.
str : une chaîne à envoyer sous forme d’une série d’octets.
buf : un tableau à envoyer sous forme d’une série d’octets.
len : le nombre d’octets à envoyer depuis le tableau.

Retour :

write() renverra le nombre d’octets écrits, bien que la lecture de ce nombre soit facultative. Type de données : size_t .

Exemple de code :

void setup() {
  Serial.begin(9600);
}

void loop() {
  Serial.write(45); // envoyer un octet avec la valeur 45

  int bytesSent = Serial.write("hello");  //envoyer la chaîne "hello" et renvoyer la longueur de la chaîne.
}

 

Remarques et avertissements

Depuis Arduino IDE 1.0, la transmission série est asynchrone. S’il y a suffisamment d’espace vide dans le tampon de transmission, Serial.write()reviendra avant que des caractères ne soient transmis via série. Si le tampon de transmission est plein, Serial.write()bloquera jusqu’à ce qu’il y ait suffisamment d’espace dans le tampon. Pour éviter de bloquer les appels à Serial.write(), vous pouvez d’abord vérifier la quantité d’espace libre dans le tampon de transmission à l’aide de availableForWrite() .

 


 

Source : https://www.arduino.cc/reference/en/language/functions/communication/serial/write/

 

Laisser un commentaire