Voir la source de GPIO-PI

= Utilisation des GPIO avec Python et libgpiod 2.x =

Cette page décrit l'utilisation des GPIO d'un Raspberry Pi sous Debian 13 / Raspberry Pi OS avec la bibliothèque '''libgpiod 2.x'''.

== Prérequis ==

Vérifier la version installée :

<syntaxhighlight lang="bash">
python3 -c "import gpiod; print(gpiod.__version__)"
</syntaxhighlight>

Exemple :

<syntaxhighlight lang="text">
2.2.0
</syntaxhighlight>

Les exemples de cette page sont compatibles avec libgpiod 2.x.

== GPIO utilisés ==

{| class="wikitable"
! GPIO BCM
! Usage
|-
| 20
| Relais 1
|-
| 21
| Relais 2
|}

== Déclaration des GPIO ==

<syntaxhighlight lang="python">
import gpiod

req = gpiod.request_lines(
    "/dev/gpiochip0",
    consumer="relays",
    config={
        20: gpiod.LineSettings(
            direction=gpiod.line.Direction.OUTPUT
        ),
        21: gpiod.LineSettings(
            direction=gpiod.line.Direction.OUTPUT
        ),
    }
)
</syntaxhighlight>

== Activation d'un relais ==

Activation du relais connecté au GPIO20 :

<syntaxhighlight lang="python">
req.set_value(20, gpiod.line.Value.ACTIVE)
</syntaxhighlight>

Activation du relais connecté au GPIO21 :

<syntaxhighlight lang="python">
req.set_value(21, gpiod.line.Value.ACTIVE)
</syntaxhighlight>

== Désactivation d'un relais ==

Désactivation du relais connecté au GPIO20 :

<syntaxhighlight lang="python">
req.set_value(20, gpiod.line.Value.INACTIVE)
</syntaxhighlight>

Désactivation du relais connecté au GPIO21 :

<syntaxhighlight lang="python">
req.set_value(21, gpiod.line.Value.INACTIVE)
</syntaxhighlight>

== Programme complet ==

<syntaxhighlight lang="python">
#!/usr/bin/env python3

import gpiod
import time

with gpiod.request_lines(
    "/dev/gpiochip0",
    consumer="relays",
    config={
        20: gpiod.LineSettings(
            direction=gpiod.line.Direction.OUTPUT
        ),
        21: gpiod.LineSettings(
            direction=gpiod.line.Direction.OUTPUT
        ),
    }
) as req:

    # activation des deux relais
    req.set_value(20, gpiod.line.Value.ACTIVE)
    req.set_value(21, gpiod.line.Value.ACTIVE)

    time.sleep(5)

    # arrêt des deux relais
    req.set_value(20, gpiod.line.Value.INACTIVE)
    req.set_value(21, gpiod.line.Value.INACTIVE)
</syntaxhighlight>

== Fonction utilitaire ==

<syntaxhighlight lang="python">
def relay(req, gpio, state):
    req.set_value(
        gpio,
        gpiod.line.Value.ACTIVE
        if state
        else gpiod.line.Value.INACTIVE
    )
</syntaxhighlight>

Utilisation :

<syntaxhighlight lang="python">
relay(req, 20, True)   # ON
relay(req, 20, False)  # OFF

relay(req, 21, True)   # ON
relay(req, 21, False)  # OFF
</syntaxhighlight>