Setup Instructions - 100prznt/EzoGateway GitHub Wiki

Step by step instructions currently only available in German language.

Alle zur Systemeinrichtung erforderlichen Schritte werden in dieser Anleitung ausführlich beschrieben. Weitere speziellen Kenntnisse werden nicht vorausgesetzt.

1. Materialbeschaffung

Gemäß Stückliste sind die benötigten Komponenten zu beschaffen. In der Stückliste genannte Bezugsquellen sind nicht bindent und eher als Vorschalg zu sehen. Es kann durchaus sein das es Komponenten bei anderen Anbietern günstiger zu haben gibt.

2. Vorbereitung

2.1 EZO Module auf I2C umstellen

Die Atlas Scientific EZO Module befinden sich bei Auslieferung im RS232 Kommunikationsmodus, dieser muss umgestellt werden. EzoGateway kommuniziert per I2C mit den Modulen. Am einfachsten geht dies mit dem I2C Toggler von Whitbox Labs.

2.2 Windows IoT

Um das Windows 10 IoT Image auf die SD Karte zu kopieren wird das Tool Windows 10 IoT Core-Dashboard benötigt. Microsoft stellt dieses Tool frei zum Download bereit.

TODO! Image auf SD-Karte brennen

3. Aufbau

Der Aufbau umfasst lediglich das Zusammenstecken von Raspberry Pi, Tentacle T3 und den EZO Modulen. Zu beachten ist hierbei, dass das pH und ORP Modul auf den ersten beiden Steckplätzen (links und mitte) des Tentacle T3 sitzen. Das RTD Modul kommt auf Steckplatz 3 (rechts).

4. Systemeinrichtung

4.1 Windows Installation abschließen

4.2 EzoGateway App übertragen

Wahlweise 4.2.1 oder 4.2.2

4.2.1 Fertig kompilierte App

  1. Herunterladen des aktuelle Releases, aus dem Release Feed (Benötigt wird die *.appx Datei welche man unter Assets findet)
  2. Das Windows Device Portal öffnen, erreichbar ist das Portal standardmäßig unter Port 8080 (http://<IP des RaspberryPi>:8080/)
  3. Wechsel zu Apps -> Apps Manager
  4. Auswahl des in Schritt 1 heruntergeladenen App Paketes (*.appx) durch einen Klick auf Install wird die Installation gestartet. Achtung! Vor der Installation muss eine ggf. noch laufende EzoGateway App gestoppt und deinstalliert werden.
  5. Markieren der EzoGateway App als Standard Startup App (Es kann sein, dass man erst die Apps manager Seite einmal neu laden muss, damit die EzoGateway App in der Liste auftaucht)
  6. Wenn die EzoGateway App nicht schon automatisch gestartet wurde, lässt sich der Start manuell über Action -> Start initiieren
  7. Ein paar Sekunden warten und zur EzoGateway - Settings Seite gehen, diese wird unter der Adresse http://<IP des RaspberryPi>:591/web/sys/config.html erreicht
  8. Gewünschte Einstellungen übernehmen and enjoy... :rocket:

4.2.2 Code selber kompilieren (mit Visual Studio)

Da das initiale Einrichten der Toolchain leider nicht Trivial ist, gibt es hierzu eine seperate Wiki-Seite:

Setup Visual Studio

Nachdem Visual Studio installiert ist, wird das Projekt (Quellcode) benötigt. Das Projekt-Repository kann dazu direkt herunter geladen werden oder per "git clone" auf den eigenen Rechner übertragen werden.
Um verfügbare Aktualisierungen schnell beziehen zu können, ist das Clonen dem klassischem Download vorzuziehen. Das Vorgehen wird ebenfalls auf einer seperaten Wiki-Seite beschrieben:

Clone EzoGateway

Nun kann die Projektmappe mit Visual Studio geöffnet werden EzoGateway/source/EzoGateway.sln

5. EzoGateway einrichten

5.1 Hardware prüfen

Um sicher zustellen das die EZO Module ordnungsgemäß kommunizieren ist ein Verbindungstest durchzuführen. Hierzu reicht es die "Sensor Übersicht" der Web Oberfläche aufzurufen.

  • URL: http://<EzoGateway IP>/web/sys/sensors.html ( ist durch die IP Adresse des EzoGateway zu ersetzen.)

5.2 Sensoren kalibrieren

TODO!