Main

Référence : Fonctions Pyduino

analogReadmVRepeat()


Description

Lit plusieurs fois de suite la valeur de la tension présente sur la broche spécifiée et renvoie le résultat de la moyenne de la tension mesurée en mV. L'intérêt majeur de cette fonction comparativement à la fonction analogRead() est de calculer automatiquement la tension en prenant en compte les paramètres techniques de la broche utilisée ( résolution, plage de mesure)

Syntaxe

La syntaxe est la suivante :

analogReadmVRepeat(broche_analogique,repeat)
analogReadmV(broche_analogique, repeat, rangeIn, mVIn)

Paramètres

  • broche_analogique : le numéro de la broche analogique sur laquelle il faut convertir la tension analogique appliquée (de 0 à 5 ou bien de A0 à A5 sur le pcDuino). L'utilisation d'un identifiant Ax, où x est le numéro de la broche analogique, est intégré dans pyDuino et permet de distinguer facilement un numéro de broche analogique d'un numéro de broche numérique.
  • repeat : nombre de mesures successives à réaliser
  • rangeIn : résolution de la mesure de la broche utilisée, typiquement 63, 1023 ou 4095
  • mVIn : valeur de la tension en mV correspondant à la valeur maximale de la résolution.

L'utilisation de la forme analogReadmVRepeat(broche_analogique, repeat, range, mV) permet d'obtenir la mesure la plus précise possible, en étalonnant au préalable la broche analogique en mesurant la valeur réelle de la tension correspondant à la résolution maximale. Exemple : en mesurant à l'aide d'un voltmètre la tension réelle présente sur la broche analogique lorsque la mesure vaut 4095, on obtiendra par exemple 3V (au lieu des 3.3V théoriques).

Valeur renvoyée

  • valeur float correspondant à la moyenne des mesures effectuées en mV

Exemple

Code *.yno à copier/coller dans l'IDE Pyduino
Voir ici si vous préférez convertir le code Pyduino en code Python pour l'utiliser avec l'éditeur Geany par exemple.


# exemple pyDuino - par X. HINAULT - www.mon-club-elec.fr
# Juin 2013 - Tous droits réservés - GPLv3

# test analogRead

# entete declarative

#--- setup ---
def setup():
        return # si vide

# -- fin setup --

# -- loop --
def loop():

        #voie A0
        mesuremV=analogReadmVRepeat(A0,20) # réalise 20 mesure sur mesure la voie A0 - résultat en mV
        Serial.println("Voie A0 = " + str(mesuremV) + " mV.")

        #voie A2
        mesuremV=analogReadmVRepeat(A2,20) # réalise 20 mesures sur la voie A2 - résultat en mV
        Serial.println("Voie A2 = " + str(mesuremV) + " mV.")

        delay(1000)# entre 2 mesures

# -- fin loop --
 

Remarque

Les broches analogiques sont utilisées en entrée. Il n'est pas nécessaire de les configurer avec pinMode() au préalable à l'appel de la fonction analogRead()

Commentaires utilisateurs

Aucun commentaire

Voir également :


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

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

Cette page a été réalisée par Xavier HINAULT (2013) (www.mon-club-elec.fr) et est sous licence Creative Commons Attribution-ShareAlike 3.0.