GPIO-Steuerung

Das OSSM stellt vier GPIO-Pins zur Verfügung, die über Bluetooth Low Energy (BLE) gesteuert werden können. Verwenden Sie diese Pins, um externes Zubehör, Anzeigen, Relais oder andere Hardware-Integrationen auszulösen.

Überblick

Die GPIO-Charakteristik ermöglicht Ihnen:

• Einen der 4 Pins auf HIGH oder LOW setzen
• Aktuelle Fähigkeiten auslesen
• Externe Hardware in Ihr OSSM integrieren

Anwendungsfälle

• LED-Anzeigen – Den Gerätezustand an eine externe Beleuchtung signalisieren
• Relaissteuerung – Externe Geräte ein- und ausschalten
• Zubehörsynchronisierung – Mit anderer Hardware koordinieren
• Benutzerdefinierte Integrationen – Eigene Steuerungssysteme entwickeln

BLE-Charakteristik

Pin-Zuordnung

Die Firmware stellt 4 logische Pins bereit, die ESP32-GPIO-Nummern zugeordnet sind:

Befehlsformat

Schreiben (Pin-Status festlegen)

Senden Sie eine Zeichenfolge im Format:

<pin_number>:<state>

Pin-Nummer: 1, 2, 3 oder 4

Statuswerte:

• high oder 1 – Pin auf HIGH (3,3 V) setzen
• low oder 0 – Pin auf LOW (0 V) setzen

Beispiele:

Schreibantworten

Lesen (Fähigkeiten)

Das Lesen der Charakteristik gibt einen Hinweis auf verfügbare GPIO-Fähigkeiten zurück:

pins:[1,2,3,4]

Dies zeigt an, welche logischen Pins zur Steuerung verfügbar sind.

Beispielcode

// 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())

Hardware-Integration

Einfache LED-Anzeige

Schließen Sie eine LED mit Strombegrenzungswiderstand an:

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

Relaissteuerung

Für Lasten mit höherem Strom verwenden Sie ein optoisoliertes Relaismodul:

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

Die meisten optoisolierten Relaismodule arbeiten mit 3,3-V-Logik. Überprüfen Sie die Spezifikationen Ihres Moduls.

Umsetzung von Logikpegeln

Wenn Sie einen 5-V-Logikausgang benötigen:

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

Einschränkungen

• Keine PWM-Unterstützung – Pins sind nur digital HIGH/LOW
• Kein Eingabelesen – GPIO kann über diese Schnittstelle nur als Ausgang verwendet werden
• Keine Persistenz – Pin-Zustände werden beim Neustart des Geräts auf LOW zurückgesetzt
• Keine Interrupts – Keine Auslösung anhand externer Signale möglich
• Stromgrenzen – ESP32-GPIO: maximal ~12 mA pro Pin, insgesamt 40 mA

Fehlerbehebung

Verwandte Seiten