Contrôle GPIO

L'OSSM expose quatre broches GPIO qui peuvent être contrôlées via Bluetooth Low Energy (BLE). Utilisez ces broches pour déclencher des accessoires externes, des indicateurs, des relais ou d'autres intégrations matérielles.

Aperçu

La caractéristique GPIO permet de :

• Régler l'une des 4 broches sur HIGH ou LOW
• Lire les capacités actuelles
• Intégrer du matériel externe à votre OSSM

Cas d'utilisation

• Indicateurs LED — Indiquer l'état de l'appareil au moyen d'un éclairage externe
• Contrôle de relais — Déclencher l'activation/la désactivation d'appareils externes
• Synchronisation des accessoires — Coordonner avec d'autres matériels
• Intégrations personnalisées — Créez vos propres systèmes de contrôle

Caractéristique BLE

Cartographie des broches

Le firmware expose 4 broches logiques qui correspondent aux numéros GPIO ESP32 :

Format de commande

Écriture (définition de l'état des broches)

Envoyez une chaîne au format :

<pin_number>:<state>

Numéro de broche : 1, 2, 3 ou 4

Valeurs d'état :

• high ou 1 — Définir la broche sur HIGH (3,3 V)
• low ou 0 — Définir la broche sur LOW (0 V)

Exemples :

Réponses d'écriture

Lecture (capacités)

La lecture de la caractéristique renvoie une indication des capacités disponibles :

pins:[1,2,3,4]

Cela indique quelles broches logiques sont disponibles pour le contrôle.

Exemple de code

// Connect to OSSM (assumes already connected to service)
const gpioChar = await service.getCharacteristic(
  "522b443a-4f53-534d-4000-420badbabe69"
);

// Set pin 1 HIGH
await gpioChar.writeValue(new TextEncoder().encode("1:high"));

// Read the response
const response = await gpioChar.readValue();
console.log(new TextDecoder().decode(response));
// Output: "ok:1:high"

// Set pin 2 LOW
await gpioChar.writeValue(new TextEncoder().encode("2:low"));

// Read capabilities
const caps = await gpioChar.readValue();
console.log(new TextDecoder().decode(caps));
// Output: "pins:[1,2,3,4]"

import asyncio
from bleak import BleakClient

GPIO_UUID = "522b443a-4f53-534d-4000-420badbabe69"

async def control_gpio():
    async with BleakClient("OSSM") as client:
        # Set pin 1 HIGH
        await client.write_gatt_char(GPIO_UUID, b"1:high")

        # Read response
        response = await client.read_gatt_char(GPIO_UUID)
        print(response.decode())  # "ok:1:high"

        # Set pin 2 LOW
        await client.write_gatt_char(GPIO_UUID, b"2:low")

        # Set multiple pins
        await client.write_gatt_char(GPIO_UUID, b"3:high")
        await client.write_gatt_char(GPIO_UUID, b"4:low")

asyncio.run(control_gpio())

Intégration matérielle

Indicateur LED de base

Connectez une LED avec une résistance de limitation de courant :

GPIO Pin → 220Ω Resistor → LED Anode (+)
                           LED Cathode (-) → GND

Contrôle des relais

Pour les charges à courant plus élevé, utilisez un module relais opto-isolé :

GPIO Pin → Relay Module Signal
3.3V     → Relay Module VCC
GND      → Relay Module GND

La plupart des modules de relais avec opto-isolation fonctionnent avec une logique 3,3 V. Vérifiez les spécifications de votre module.

Conversion de niveau logique

Si vous avez besoin d'une sortie logique 5 V :

GPIO Pin → Level Shifter 3.3V Side
5V       → Level Shifter 5V Side
GND      → Level Shifter GND
           Level Shifter 5V Output → Your 5V Device

Limites

• Pas de prise en charge PWM — Les broches sont uniquement numériques HIGH/LOW
• Aucune lecture d'entrée — Le GPIO est uniquement utilisable en sortie via cette interface
• Pas de persistance — Les états des broches sont réinitialisés à LOW au redémarrage de l'appareil
• Aucune interruption – Impossible de déclencher en fonction de signaux externes
• Limites de courant — GPIO ESP32 : ~12 mA maximum par broche, 40 mA au total

Dépannage

Pages connexes