Comprendre la fonction Serial.readString()
La fonction Serial.readString() fait partie de la bibliothèque série Arduino, qui permet la communication entre le microcontrôleur et l'ordinateur ou d'autres périphériques externes.
Cette fonction permet au microcontrôleur de lire une chaîne de caractères envoyée depuis une connexion série. La fonction lit les données du tampon série et renvoie les données sous la forme d'un objet String.
Cette fonction est héritée de la classe Stream.
Syntaxe
La syntaxe de cette fonction est la suivante :
En série. readString ( )
Paramètres
Cette fonction ne prend aucun paramètre. Il ne lit que l'objet du port série.
Retour
Renvoie une chaîne contenant les caractères reçus via le port série. La chaîne se termine par le dernier caractère reçu, qui est souvent un caractère de saut de ligne (\n). Si aucun caractère n'est disponible dans le tampon série, la fonction renvoie une chaîne vide ('').
Note: Si le caractère de fin de ligne est disponible dans les données, la fonction ne se terminera pas plus tôt. La chaîne renvoyée peut contenir des caractères de retour chariot.
Exemple de code
Le code ci-dessous illustre l'utilisation de la fonction Serial.readString() dans la programmation Arduino :
Le code ci-dessous illustre l'utilisation de la fonction Serial.readString() dans la programmation Arduino :
annuler installation ( ) {En série. commencer ( 9600 ) ;
}
annuler boucle ( ) {
En série. println ( 'Entrer des données:' ) ;
alors que ( En série. disponible ( ) == 0 ) { } // attend que les données soient disponibles
Chaîne teststr = En série. readString ( ) ; // lire jusqu'à l'expiration du délai
teststr. garniture ( ) ; // supprimer tout \r \n espace blanc de la fin de la chaîne
En série. imprimer ( 'Entrée de données: ' ) ;
En série. println ( teststr ) ;
si ( teststr == 'Bonjour' ) {
En série. println ( 'Bonjour à vous aussi!' ) ;
} autre {
En série. println ( 'Je suis désolé, je n'ai pas compris votre entrée.' ) ;
}
}
Dans le installation() la communication série est activée à l'aide d'un débit en bauds de 9600.
Dans le boucle() fonction, le code invite l'utilisateur à entrer des données en imprimant 'Entrer les données :' sur le moniteur série. Il attend ensuite que les données soient disponibles en vérifiant si le tampon série est vide à l'aide de la fonction Serial.available().
Une fois les données disponibles, le code lit les données sous forme de chaîne à l'aide de la fonction Serial.readString() et supprime tous les caractères d'espacement à la fin de la chaîne à l'aide de la fonction trim().
Le code compare ensuite la chaîne d'entrée à la chaîne 'bonjour'. Si la chaîne d'entrée est 'Bonjour' , le code répond en imprimant 'Bonjour à vous aussi!' au moniteur série. Sinon, il affiche 'Je suis désolé, je n'ai pas compris votre entrée.' au moniteur série. La fonction loop() se répète ensuite, invitant l'utilisateur à entrer plus d'informations.
Sortir
Dans la sortie, nous pouvons voir différentes chaînes que le code lit à partir de l'utilisateur et les associe à la chaîne 'bonjour'.
Conclusion
La fonction Serial.readString() d'Arduino lit les données série envoyées depuis un ordinateur ou d'autres appareils vers la carte. À l'aide de cette fonction, nous pouvons lire et comparer les données de chaîne série d'entrée pour générer des réponses de sortie telles que le contrôle de capteurs et de périphériques matériels.