Verwenden von GPIO für binäre Eingaben

Allgemeine I/O-Pins (GPIO) können so konfiguriert werden, dass elektrische Signale als Eingang empfangen werden. Dies ist auf der einfachsten Ebene nützlich für Szenarien, die das Öffnen/Schließen eines Schaltkreises erkennen. Solche Schaltkreise können Drucktasten, Kippschalter, Reedschalter, Druckschalter und andere Geräte enthalten, die binäre Werte (Ein/Aus) darstellen, indem sie einen Stromkreis schließen.

In diesem Lernprogramm verwenden Sie .NET und die GPIO-Pins Ihres Raspberry Pi, um das Öffnen und Schließen eines Schaltkreises zu erkennen.

Voraussetzungen

• ARM-basierter (ARMv7 oder höher) Single-Board-Computer (SBC)
• Jumper-Kabel
• Steckplatine (optional)
• Raspberry Pi GPIO Breakout Board (optional)
• .NET SDK 10 oder höher

Stellen Sie sicher, dass SSH auf Ihrem Gerät aktiviert ist. Zur Einrichtung eines SSH-Servers auf dem Raspberry Pi lesen Sie bitte den Abschnitt "Einen SSH-Server einrichten" in der Raspberry-Pi-Dokumentation.

Vorbereiten der Hardware

Verwenden Sie die Hardwarekomponenten, um den Schaltkreis wie im folgenden Diagramm dargestellt zu erstellen:

Das Bild oben zeigt eine direkte Verbindung zwischen einem Erdungsstift und Stift 21.

Sehen Sie sich bei Bedarf das folgende Pinout-Diagramm an:

Bild mit freundlicher Genehmigung der Raspberry Pi Foundation.

Erstellen der App

Führen Sie in Ihrer bevorzugten Entwicklungsumgebung die folgenden Schritte aus:

1. Erstellen Sie eine neue .NET Konsolen-App entweder mithilfe der .NET CLI oder Visual Studio. Nennen Sie es InputTutorial.

   dotnet new console -o InputTutorial
   cd InputTutorial
   

2. Fügen Sie das System.Device.Gpio-Paket zum Projekt hinzu. Verwenden Sie entweder .NET CLI aus dem Projektverzeichnis oder Visual Studio.

   dotnet package add System.Device.Gpio --version 4.0.1
   

3. Ersetzen Sie den Inhalt von Program.cs durch den folgenden Code:

   using System.Device.Gpio;
   using System.Threading.Tasks;
   
   const int Pin = 21;
   const string Alert = "ALERT 🚨";
   const string Ready = "READY ✅";
   
   using var controller = new GpioController();
   controller.OpenPin(Pin, PinMode.InputPullUp);
   
   Console.WriteLine(
       $"Initial status ({DateTime.Now}): {(controller.Read(Pin) == PinValue.High ? Alert : Ready)}");
   
   controller.RegisterCallbackForPinValueChangedEvent(
       Pin,
       PinEventTypes.Falling | PinEventTypes.Rising,
       OnPinEvent);
   
   await Task.Delay(Timeout.Infinite);
   
   static void OnPinEvent(object sender, PinValueChangedEventArgs args)
   {     
       Console.WriteLine(
           $"({DateTime.Now}) {(args.ChangeType is PinEventTypes.Rising ? Alert : Ready)}");
   }
   

   Im vorhergehenden Code:

   • Eine using-Deklaration erstellt eine Instanz von GpioController. Die using Deklaration stellt sicher, dass das Objekt beendet wird und Hardwareressourcen ordentlich freigegeben werden.
     • GpioController wird ohne Parameter instanziiert und gibt an, dass sie erkennen soll, auf welcher Hardwareplattform sie ausgeführt wird, und das logische Pinnummerierungsschema verwenden.
   • GPIO-Pin 21 wird mit PinMode.InputPullUpgeöffnet.
     • Dadurch wird der Pin mit einem PullUp-Widerstand geöffnet. In diesem Modus wird PinValue.Low zurückgegeben, wenn der Pin mit der Masse verbunden ist. Wenn der Pin vom Boden getrennt wird und der Schaltkreis geöffnet ist, wird der Pin zurückgegeben PinValue.High.
   • Der Anfangsstatus wird mithilfe eines ternären Ausdrucks in eine Konsole geschrieben. Der aktuelle Zustand des Pins wird mit Read() gelesen. Wenn es PinValue.High ist, schreibt es die Zeichenfolge Alert in die Konsole. Andernfalls schreibt sie die Ready Zeichenfolge.
   • RegisterCallbackForPinValueChangedEvent() registriert eine Rückruffunktion sowohl für das PinEventTypes.Rising- als auch für das PinEventTypes.Falling-Ereignis an dem Pin. Diese Ereignisse entsprechen den Pin-Zuständen von PinValue.High und PinValue.Low entsprechend.
   • Die Rückruffunktion verweist auf eine Methode namens OnPinEvent(). OnPinEvent() verwendet einen weiteren ternären Ausdruck, der auch die entsprechenden Alert oder Ready Zeichenfolgen schreibt.
   • Der Hauptthread verbleibt unbegrenzt im Ruhezustand, während auf Stiftereignisse gewartet wird.

4. Erstellen Sie die App. Wenn Sie die .NET CLI verwenden, führen Sie dotnet build aus. Zum Erstellen in Visual Studio drücken Sie Ctrl+Shift+B.

5. Stellen Sie die App auf dem SBC als eigenständige App bereit. Anweisungen finden Sie unter Deploy .NET apps to Raspberry Pi. Stellen Sie sicher, dass Sie der ausführbaren Datei mit chmod +x die Berechtigung zum Ausführen erteilen.

6. Führen Sie die App auf dem Raspberry Pi aus, indem Sie zum Bereitstellungsverzeichnis wechseln und die ausführbare Datei ausführen.

   ./InputTutorial
   

   Die Konsole zeigt Text ähnlich wie folgt an:

   Initial status (05/10/2022 15:59:25): READY ✅
   

7. Trennen Sie den Pin 21 vom Boden. Die Konsole zeigt Text ähnlich wie folgt an:

   (05/10/2022 15:59:59) ALERT 🚨
   

8. Verbinden Sie Stift 21 wieder mit der Erde. Die Konsole zeigt Text ähnlich wie folgt an:

   (05/10/2022 16:00:25) READY ✅
   

9. Beenden Sie das Programm, indem Sie STRG+C drücken.

Glückwunsch! Sie haben GPIO verwendet, um Eingaben mithilfe des System.Device.Gpio NuGet-Pakets zu erkennen! Für diese Art von Eingabe gibt es viele Verwendungsmöglichkeiten. Dieses Beispiel kann für jedes Szenario verwendet werden, in dem ein Schalter eine Verbindung herstellt oder einen Schaltkreis umbricht. Hier ist ein Beispiel für die Verwendung mit einem magnetischen Reedschalter, der häufig verwendet wird, um offene Türen oder Fenster zu erkennen.

Laser-Stolperdraht

Wenn Sie das vorherige Beispielkonzept noch etwas weiter erweitern, sehen wir uns an, wie dies auf die Erstellung eines Lasertripwires angewendet werden könnte. Für die Erstellung eines Lasertripwires sind die folgenden zusätzlichen Komponenten erforderlich:

• KY-008 Lasersendermodul
• Laserempfängersensormodul (siehe Hinweis unten)
• 2 Widerstände zu 10 KΩ

Verbinden von Lasertripwire-Hardware

Verbinden Sie die Komponenten wie im folgenden Diagramm beschrieben.

Achten Sie auf die 10K Ω Widerstände. Diese implementieren einen Spannungsteiler. Dies liegt daran, dass das Laserempfängermodul 5V ausgibt, um anzugeben, dass der Strahl unterbrochen ist. Raspberry Pi unterstützt nur bis zu 3,3V für GPIO-Eingaben. Da das Senden der vollen 5V an den Pin den Raspberry Pi beschädigen könnte, wird der Strom aus dem Empfängermodul durch eine Spannungstrennlinie übergeben, um die Spannung auf 2,5V zu halbieren.

Anwenden von Quellcodeupdates

Sie können fast den gleichen Code wie früher verwenden, mit einer Ausnahme. In den anderen Beispielen haben wir PinMode.InputPullUp verwendet, damit, wenn der Pin vom Massepotential getrennt und der Schaltkreis offen ist, der Pin PinValue.High zurückgegeben wird.

Im Fall des Laserempfängermoduls erkennen wir jedoch keine offene Schaltung. Stattdessen soll der Pin als Spüle für Strom aus dem Laserempfängermodul fungieren. In diesem Fall öffnen wir den Pin mit PinMode.InputPullDown. Auf diese Weise gibt der Pin zurück PinValue.Low , wenn er keinen Strom erhält und PinValue.High wann er strom vom Laserempfängermodul empfängt.

controller.OpenPin(pin, PinMode.InputPullDown);

Herunterladen des Quellcodes

Die Quelle für dieses Lernprogramm ist auf GitHub verfügbar.

Nächste Schritte