Pi-WiringPi-Reference-Core-Functions

De MCHobby - Wiki
Sauter à la navigation Sauter à la recherche


MCHobby investit du temps et de l'argent dans la réalisation de traduction et/ou documentation. C'est un travail long et fastidieux réalisé dans l'esprit Open-Source... donc gratuit et librement accessible.
SI vous aimez nos traductions et documentations ALORS aidez nous à en produire plus en achetant vos produits chez MCHobby.

Qu'est-ce que les "Fonctions du noyaux"?

Ces fonctions fonctionnent direction sur le Raspberry Pi et aussi avec les modules GPIO externes tel que les "GPIO expanders" (ex: MCP23017) et autres. Cependant, tous les modules ne fonctionnent pas – par exemple, le PiFace à ses entrées et sorties pré-configurées et le Raspberry Pi ne dispose pas de convertisseur analogique/digital sur sa carte.

Les fonctions du noyaux

pinMode

void pinMode(int pin, int mode);

Fixe le modde d'une broche.

  • pin: la broche dont vous voulez modifier le mode.
  • mode: Le mode désiré parmi les options suivantes:
    • INPUT pour en faire une entrée.
    • OUTPUT pour en faire une sortie.
    • PWM_OUTPUT pour en faire une sortie PWM.
    • GPIO_CLOCK (par encore identifié mais son nom laisse à penser qu'il s'agit d'un signal d'horloge

Limitations:

  • Seule la broche 1 de wiringPi (BCM_GPIO 18) supporte la sortie PWM.
  • Seule la broche 7 wiringPi (BCM_GPIO 4) supporte le mode CLOCK output modes.

Mode Sys:

Cette fonction n'a aucun effet lorsque l'on est en mode Sys. Si vous avez besoin de changer le mode d'une broche alors vous pouvez le faire avec le programme gpio dans un script avant de démarrer le programme.

pullUpDnControl

void pullUpDnControl(int pin, int pud);

Permet d'activer les résistances pull-up ou pull-down sur une broche donnée, qui doit bien entendu être une broche d'entrée.

A la différence des Arduino, le BCM2835 dispose des deux types de résistances internes. Les résistances pull-up servent à ramener le potentiel à +vcc et les pull-down ramène le potentiel à GND (0v).

  • pin: Broche d'entrée dont vous coulez modifier la configuration de la résistance pull-up/down.
  • pud: le mode d'activation de la résistance parmi les valeurs suivantes:
    • PUD_OFF pas de résistance pull up/down.
    • PUD_DOWN activer la résistance pull-down (vers la masse).
    • PUD_UP activer la résistance pull-up (vers 3.3v).

Les résistance pull-up/down internes ont une valeur approximative de 50KΩ (50 000Ω) sur un Raspberry Pi.

Mode sys:
Cette fonction n'a aucun effet sur les broches GPIO du Raspberry Pi lorsque l'on est en mode Sys. Si vous avez besoin d'activer les pull-up/dow, alors vous pouvez le faire à l'aide du programme gpio (que vous utilisez dans un script juste avant de démarrer votre programme).

digitalWrite

void digitalWrite(int pin, int value);

Ecrire un niveau haut ou bas sur une broche préalablement configurée en sortie.

  • pin: la broche dont vous voulez modifier l'état.
  • value: Le nouvel état de la broche parmi les valeurs suivantes.
    • HIGH ou 1 pour placer la broche à l'état haut (soit 3.3v)
    • LOW ou 0 pour placer la broche à l'état bas (soit la masse/gnd).

WiringPi traite toutes les valeurs différentes de zéro comme HIGH (état haut). 0 est la seule représentation de LOW.

pwmWrite

void pwmWrite(int pin, int value);

Ecrit une valeur dans le registre PWM pour une broche donnée. Raspberry Pi dispose d'une broche PWM, la broche 1 (BMC_GPIO 18, broche physique 12) dont la valeur varie entre 0 et 1024. D'autre périphériques PWM pourrait disposer d'autre gamme de valeur PWM.

Cette fonction n'est pas capable de contrôler le broche PWM du Pi lorsque l'on est en mode Sys.

digitalRead

int digitalRead(int pin);

Cette fonction retourne la valeur lue sur une broche spécifiée.

Paramètre:

  • pin: broche dont vous voulez lire l'état.

La valeur retournée sera:

  • HIGH ou 1 si la broches est à un état logique haut (3.3 volts).
  • LOW ou 0 si la broche est à un état logique bas (0 volt/masse/GND).

analogRead

analogRead(int pin);

Retourne la valeur lue sur une broche d'entrée analogique. Vous devrez enregistrer un module complémentaire capable de lire des valeurs analogiques pour pouvoir utiliser cette fonction.

C'est par exemple le cas de Gertboard, carte analogique de quick2Wire, etc.

Paramètre:

  • pin: broche analogique que vous désirez lire.

analogWrite

analogWrite(int pin, int value);

Ecrit une valeur analogique sur la broche désignée. Vous devez enregistrer un module analogique complémentaire tel que Gertboard pour pouvoir utiliser cette fonction sur un Pi.

Paramètres:

  • pin: Broche dont vous voulez modifier la valeur analogique
  • value: La nouvelle valeur analogique de la broche.

Source: WiringPi.com. WiringPi est une libraire sous licence GPL écrite par Gordon Henderson. Crédit: wiringpi.com

Traduit de l'anglais par Meurisse D. pour MCHobby.be

Traduit avec l'accord de Gordon Henderson, créateur de wiringPi - Translated with authorization of Gordon Henderson, creator of wiringPi

Toute référence, mention ou extrait de cette traduction doit être explicitement accompagné du texte suivant : «  Traduction par MCHobby (www.MCHobby.be) - Vente de kit et composants » avec un lien vers la source (donc cette page) et ce quelque soit le média utilisé.

L'utilisation commercial de la traduction (texte) et/ou réalisation, même partielle, pourrait être soumis à redevance. Dans tous les cas de figures, vous devez également obtenir l'accord du(des) détenteur initial des droits. Celui de MC Hobby s'arrêtant au travail de traduction proprement dit.

Récupérée de « https://wiki.mchobby.be/index.php?title=Pi-WiringPi-Reference-Core-Functions&oldid=7673 »