From: Benjamin Braatz <bb@bbraatz.eu>
Date: Mon, 22 Aug 2022 19:48:49 +0000 (+0200)
Subject: Example conf.json and documentation
X-Git-Url: http://git.graph-it.com/?a=commitdiff_plain;h=4c15966a03d2d4cacd03cdde69122a7436931f01;p=graphit%2Fcontrolpi-nfc.git

Example conf.json and documentation
---

diff --git a/conf.json b/conf.json
new file mode 100644
index 0000000..e391160
--- /dev/null
+++ b/conf.json
@@ -0,0 +1,18 @@
+{
+    "Debug": {
+        "plugin": "WSServer",
+        "web": {
+            "/": {
+                "module": "controlpi_plugins.wsserver",
+                "location": "Debug"
+            }
+        }
+    },
+    "Log": {
+        "plugin": "Log",
+        "filter": [{}]
+    },
+    "NFCReader": {
+        "plugin": "NFCReader"
+    }
+}
diff --git a/doc/DebugView.png b/doc/DebugView.png
new file mode 100644
index 0000000..86ce16c
Binary files /dev/null and b/doc/DebugView.png differ
diff --git a/doc/index.md b/doc/index.md
new file mode 100644
index 0000000..8de581f
--- /dev/null
+++ b/doc/index.md
@@ -0,0 +1,61 @@
+# ControlPi-Plugin für NFC-Kartenleser
+Dieses Paket enthält ein Plugin für das ControlPi-System, mit dem ein
+NFC-Kartenleser eingebunden werden kann. Es wird lediglich die ID der
+aufgelegten NFC-Karte (oder des NFC-Chips oder des Smartphones als
+Nachricht auf den ControlPi-Bus gelegt.
+
+## Installation
+Eine ausführliche Dokumentation ist in der Dokumentation der
+[ControlPi-Infrastruktur](https://docs.graph-it.com/graphit/controlpi) zu
+finden.
+
+Der Code dieses Plugins kann mit git geclonet werden:
+```sh
+$ git clone git://git.graph-it.com/graphit/controlpi-nfc.git
+```
+(Falls Zugang zu diesem Server per SSH besteht und Änderungen gepusht
+werden sollen, sollte stattdessen die SSH-URL benutzt werden.)
+
+Dann kann es editierbar in ein virtuelles Environment installiert werden:
+```sh
+(venv)$ pip install --editable <Pfad zum Code-Repository>
+```
+
+Auf dem Raspberry Pi (oder wenn keine Code-Änderungen gewünscht sind) kann
+es auch direkt, ohne einen git-Clone installiert werden:
+```sh
+(venv)$ pip install git+git://git.graph-it.com/graphit/controlpi-nfc.git
+```
+
+## Benutzung
+Eine minimale ControlPi-Konfiguration, die dieses Plugin benutzt, ist im
+git-Repository enthalten:
+```json
+{
+    "Debug": {
+        "plugin": "WSServer",
+        "web": {
+            "/": {
+                "module": "controlpi_plugins.wsserver",
+                "location": "Debug"
+            }
+        }
+    },
+    "Log": {
+        "plugin": "Log",
+        "filter": [{}]
+    },
+    "NFCReader": {
+        "plugin": "NFCReader"
+    }
+}
+```
+
+Ein `NFCReader`-Plugin hat keine weitere Konfiguration und es ist nur eine
+Instanz pro Konfiguration sinnvoll (da weitere sowieso den gleichen
+NFC-Kartenleser verwenden würden).
+
+Mit dieser Beispiel-Konfiguration können die durch Auflegen und Entfernen
+von NFC-Karten ausgelösten Events in der Debug-Oberfläche des ControlPi und
+im Log in `journalctl -u controlpi` gesehen werden:
+![Debug-Oberfläche](DebugView.png)