Main

Référence : Langage Arduino : [ Mini | Standard | Etendue | Maxi ] Librairies : [ Vue d'ensemble | Synthèse ] Infos : [ Comparaison | Changements ]

Classe Stream

Classe commune pour les classes de communication (Serial, Wire, EthernetClient, EthernetServer, SD)


1.  Description

Stream (flux en anglais) est une classe de base pour les flux de caractères et de données binaires. Cette classe n'est pas appelée directement, mais est appelée à chaque fois que vous utilisez une fonction qui en dépendent.

La classe Stream définit les fonctions de lecture dans le langage Arduino. En utilisant n'importe quelle fonctionnalité du langage Arduino qui utilise la méthode read(), vous pouvez considérez qu'elle s'appuie sur sur la classe Stream. Pour les fonctions telles que print(), la classe Stream hérite de la classe Print.

  • Pour comprendre : lorsque des octets ou des caractères sont reçus par Arduino sur le port Série ou bien par le shield Ethernet, ils sont stockés au fur et à mesure de leur réception dans un "buffer" ou file d'attente en attendant qu'ils soient lus. C'est l'ensemble des données présentes dans cette file d'attente qui est géré par les fonctions de la classe Stream.
  • Les fonctions de la classe Stream vont ainsi permettre de savoir combien d'octets sont disponibles, de lire les octets un à un, de vider la file d'attente, d'attendre l'arrivée d'un caractère précis, etc...

2.  Les classes utilisant la classe Stream

Plusieurs librairies de communication dépendent de la classe Stream :

  • La librairie Serial - pour les communications séries entre la carte Arduino et l'ordinateur ou d'autres composants
  • La librairie Ethernet - pour se connecter à Internet en utilisant le module Arduino Ethernet
  • La librairie SD - référence - pour utiliser une carte mémoire SD (utiliser des fichiers, stocker des données, ...)
  • La librairie Wire / I2C - référence - Interface "deux fils" ( TWI/I2C) pour envoyer et recevoir des données sur un réseau de modules ou capteurs.

3.  Les fonctions de la classe Stream

4.  Commentaires utilisateurs

  • Cette classe disponible à partir de la version Arduino 1.0 simplifie et améliore l'acquisition et l'analyse des données reçues (notamment les chaines de caractères) par le port série ou en provenance du réseau.

Page d'accueil de la référence Arduino en français

Corrections, suggestions et nouvelle documentation peuvent être postées sur le Forum Arduino ou à l'adresse suivante : support_at_mon-club-elec_point_fr

Le texte original de la référence Arduino est sous licence Creative Commons Attribution-ShareAlike 3.0 . Les exemples de code dans la référence sont dans le domaine public.

La présente traduction française commentée a été réalisée par Xavier HINAULT (2010-2012) (www.mon-club-elec.fr) et est sous licence Creative Commons Attribution-ShareAlike 3.0.