Serial.write()

Descrição

Escreve dados binários na porta serial. Esses dados são enviados como um byte ou séries de bytes; para enviar os caracteres representando os dígitos de um número, use em vez disso a função print().

Sintaxe

Serial.write(val)

Serial.write(str)

Serial.write(buf, len)

Parâmetros

  • Serial: objeto porta serial. Veja a lista de portas seriais disponíveis em cada placa no Serial - Página principal
  • val: o valor a ser enviado como um único byte.
  • str: uma string a ser enviada como uma série de bytes.
  • buf: um vetor a ser enviado como uma série de bytes.

Retorna

O número de bytes escritos na porta serial - size_t

write() irá retornar o número de bytes escritos, apesar de ler esse valor ser opcional

Código de Exemplo

O código abaixo usa a função Serial.write() para escrever um valor e uma string na porta serial.

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() { }
  • The result on Serial Monitor:
  • COM6
    Send
    - ArduinoGetStarted.com Arduino
    Autoscroll Show timestamp
    Clear output
    9600 baud  
    Newline  

※ Notas e Advertências:

  • Desde a versão 1.0 da IDE do Arduino, a trasmissão serial é assíncrona. Se há espaço livre suficiente no buffer de tranmissão, Serial.write() irá retornar antes que quaisquer caracteres sejam transmitidos pela serial. Se o buffer de transmissão estiver cheio, então Serial.write() irá bloquear o programa até que exista espaço livre suficiente no buffer de transmissão. Para evitar chamadas de Serial.write() que possam bloquear a execução, você pode checar primeiro a quantidade de espaço livre no buffer de tranmissão usando 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)

Ver Também

ARDUINO BUY RECOMMENDATION

Arduino UNO R3
Arduino Starter Kit
Please note: These are affiliate links. If you buy the components through these links, We may get a commission at no extra cost to you. We appreciate it.

※ OUR MESSAGES

  • We are AVAILABLE for HIRE. See how to hire us to build your project
  • Any suggestion, correction, and translation? please email us at ArduinoGetStarted@gmail.com, We appreciate it
  • We mainly keep improving the references in English. See English version of this page for the latest update.