Escriu dades binàries en el port serie. Aquestes dades s’envien com un byte o sèrie de bytes; per a enviar els caràcters que representen els dígits d’un número, usa la funció print()
en el seu lloc.
Serial.write(val)
Serial.write(str)
Serial.write(buf, len)
Serial
: objecte de port serie. Consulte la llista de ports serie disponibles per a cada placa en la pàgina principal Serial.
val
: un valor per a enviar com un sol byte.
str
: una cadena per a enviar com una sèrie de bytes.
buf
: una matriu per a enviar com una sèrie de bytes.
len
: el nombre de bytes que s’enviaran des de la matriu.
write()
retornarà el nombre de bytes escrits, encara que llegir aqueix número és opcional. Tipus de dades: size_t.
void setup() {
Serial.begin(9600);
}
void loop() {
Serial.write(45); // send a byte with the value 45
int bytesSent = Serial.write("hello"); //send the string "hello" and return the length of the string.
}
A partir d’Arduino IDE 1.0, la transmissió en sèrie és asíncrona. Si hi ha suficient espai buit en el búfer de transmissió, Serial.write()
tornarà abans que es transmeta qualsevol caràcter a través de la sèrie. Si el búfer de transmissió està ple, Serial.write()
es bloquejarà fins que hi haja suficient espai en el búfer. Per a evitar el bloqueig de cridades a Serial.write()
, primer pot verificar la quantitat d’espai lliure en el búfer de transmissió usant availableForWrite()
.