Entendendo a função Serial.readString()
A função Serial.readString() faz parte da Biblioteca Serial do Arduino, que permite a comunicação entre o microcontrolador e o computador ou outros dispositivos externos.
Esta função permite que o microcontrolador leia uma string de caracteres enviada por uma conexão serial. A função lê dados do buffer serial e retorna os dados na forma de um objeto String.
Essa função é herdada da classe Stream.
Sintaxe
A sintaxe desta função é a seguinte:
Serial. readString ( )
Parâmetros
Esta função não aceita nenhum parâmetro. Ele apenas lê o objeto da porta serial.
devoluções
Retorna uma String contendo os caracteres recebidos pela porta serial. A string termina com o último caractere recebido, que geralmente é um caractere de nova linha (\n). Se nenhum caractere estiver disponível no buffer serial, a função retorna uma string vazia (“”).
Observação: Se o caractere de linha final estiver disponível em dados, a função não será encerrada antecipadamente. A string retornada pode conter os caracteres de retorno de carro.
Exemplo de código
O código abaixo demonstra o uso da função Serial.readString() na programação do Arduino:
O código abaixo demonstra o uso da função Serial.readString() na programação do Arduino:
vazio configurar ( ) {Serial. começar ( 9600 ) ;
}
vazio laço ( ) {
Serial. println ( 'Inserir dados:' ) ;
enquanto ( Serial. disponível ( ) == 0 ) { } //aguarda dados disponíveis
String teststr = Serial. readString ( ) ; //leia até o tempo limite
teststr. aparar ( ) ; // remove qualquer espaço em branco \r \n de String end
Serial. imprimir ( 'Entrada de Dados: ' ) ;
Serial. println ( teststr ) ;
se ( teststr == 'olá' ) {
Serial. println ( 'Olá para você também!' ) ;
} outro {
Serial. println ( 'Me desculpe, eu não entendi sua entrada.' ) ;
}
}
No configurar() A função de comunicação serial é habilitada usando uma taxa de transmissão de 9600.
No laço() função, o código solicita que o usuário insira dados imprimindo “Inserir dados:” no monitor serial. Em seguida, ele espera que os dados estejam disponíveis verificando se o buffer serial está vazio usando a função Serial.available().
Assim que os dados estiverem disponíveis, o código lê os dados como uma String usando a função Serial.readString() e remove todos os caracteres de espaço em branco no final da String usando a função trim().
O código então compara a String de entrada com a String “hello”. Se a string de entrada for 'olá' , o código responde imprimindo 'Olá para você também!' ao monitor serial. Caso contrário, imprime 'Sinto muito, não entendi sua entrada'. ao monitor serial. A função loop() então se repete, solicitando ao usuário mais informações.
Saída
Na saída, podemos ver diferentes strings que o código lê do usuário e as compara com a string “hello”.
Conclusão
A função Serial.readString() no Arduino lê dados seriais enviados de um computador ou outros dispositivos para a placa. Usando esta função, podemos ler e comparar os dados da cadeia serial de entrada para gerar respostas de saída, como sensores de controle e dispositivos de hardware.