Fonction utilisable sur les cartes Arduino
– communication I2c –

Bibliothèque ( fonction ) vous permettant  de communiquer avec des appareils I2C

  • begin() 
    • Description : Initialise la librairie Wire et se connecte au bus I2C en tant que maître ou esclave. Cette instruction ne doit normalement n’être appelée qu’une seule fois au début du programme.
    • Syntaxe : 
      • Wire.begin()
      • Wire.begin(adresse)
    • Paramètres : 
      • addresse : l’adresse 7-bit esclave (optionnel); si non spécifiée, la connexion au bus se fait en mode maître.

.

.

  • requestFrom() 
    • Description : Fonction utilisée par le périphérique maître, elle sert à demander une information à un esclave. L’argument de cette fonction est l’adresse de l’esclave à interroger.
    • Syntaxe : 
      • Wire.requestFrom(address, quantity)
      • Wire.requestFrom(address, quantity, stop)
    • Paramètres :

.

  • beginTransmission() 
    • Description : Cette fonction commence la transmission vers un esclave sur le bus de communication. L’adresse de ce périphérique doit être passée en argument.
    • Syntaxe : 
      • Wire.beginTransmission(adresse)
    • Paramètres :

.

.

  • endTransmission() 
    • Description : Termine une transmission à un périphérique esclave qui a été commencée par beginTransmission () et transmet les octets qui ont été mis en file d’attente par write () .
    • Syntaxe :  
      • Wire.endTransmission()
      • Wire.endTransmission(stop)
    • Paramètres :

.


  • write() 
    • Description : Cette fonction écrit le paramètre qu’on lui donne (le premier) sur le bus de communication. Elle est commune aux deux types de périphériques .  
      • le maître écrit sur le bus ,fonction utilisée entre beginTransmission() et   endTransmission() .
      • l’esclave écrit sur le bus mais après requête du maître, il ne peut pas écrire de son propre chef.
    • Syntaxe : 
      • Wire.write(value) 
      • Wire.write(string)
      • Wire.write(data, length) 
    • Paramètres : 
      • value: une valeur à envoyer en un seul octet .
      • string: une chaîne à envoyer en tant que série d’octets.
      • data: un tableau de données à envoyer en octets
      • length: le nombre d’octets à transmettre

.


  • available() 
    • Description : Cette fonction retourne le nombre d’octets disponibles à la lecture. Cette fonction est à appeler après requestFrom() sur un maître ou dans dans la fonction onReceive() sur l’esclave. Elle sert à savoir s’il y a quelque chose à lire ou pas et surtout combien d’octets seront à recevoir/stocker et analyser par le programme.
    • Syntaxe : Wire.available()
    • Paramètres : aucun

.

 
  • read()
                  
    • Description : Lit un octet qui a été transmis d’un périphérique esclave à un maître après un appel à requestFrom () ou a été transmis d’un maître à un esclave. 
    • Syntaxe : 
      • Wire.read () 
    • Paramètres : Aucun

.


.

  • SetClock() 

      • Description : Cette fonction modifie la fréquence d’horloge pour la communication I2C . Les appareils esclaves I2C n’ont pas de fréquence minimale d’horloge de travail, mais 100KHz est généralement la ligne de base.
      • Syntaxe : 
        • Wire.setClock(clockFrequency)
    • Paramètres : la valeur (en Hertz) de l’horloge de communication souhaitée. Les valeurs acceptées sont 100000 (mode standard) et 400000 (mode rapide). Certains processeurs prennent également en charge 10000 (mode basse vitesse), 1000000 (mode rapide plus) et 3400000 (mode haute vitesse). Reportez-vous à la documentation du processeur spécifique pour vous assurer que le mode souhaité est pris en charge.

.

.

  • onReceive()
                  
    • Description : Enregistre une fonction à appeler lorsqu’un périphérique esclave reçoit une transmission d’un maître.
    • Syntaxe : Wire.onReceive(handler)
    • Paramètres :

.

.

  • onRequest() 
    • Description : Enregistrer une fonction à appeler lorsqu’un maître demande des données à ce périphérique esclave.
    • Syntaxe : Wire.onRequest(handler)
    • Paramètres :

Information d’aprés le site : Arduino 

Créé avec HelpNDoc Personal Edition: Créer des documents d'aide HTML facilement