Skip to content

Setup & Build

In diesem Abschnitt werden Vorrausstzungen und Prozess für das Flashen des ESPs und das nutzen der Library erklärt.

Voraussetzungen

Um einen ESP mit der Firmware bespielen zu können, werden folgende Tools benötigt:

  • Visual Studio Code
  • PlatformIO extension für VS Code
  • Serial Monitor Extension für VS Code
  • Ein ESP und ein Kabel
  • Das Actionconnect Framework

Prozess

Das bisherige Arduino Programm, was mit "Action Connect" verbunden werden soll, kann anstelle der main.ino verwendet, oder in einer anderen Datei ausgelagert werden, wie im Bh1750LedExample. Um nun die Library erfolgreich einzubinden müssen folgende Schritte befolgt werden:

  1. in der main oben die Actionconnectlibrary.h includen
  2. void connectHubInit() muss im Setup() Aufgerufen werden, um die Connectlibrary zu initialisieren.
  3. void connectHubProcessTransport() muss im Loop() aufgerufen werden, um auf BLE und MQTT Nachrichten reagieren zu können
  4. das Thing Model muss anhand des Thing Model Artikels oder mit dem Thing Model Builder erstellt und in die ThingModel.h geschrieben werden.
  5. Für jede Capability, die zum Server synchronisiert werden soll, muss an der Stelle im Code, an den Wert abgreifen möchte (z.B direkt nach dem auslesen eines Sensors), die Methode void connectHubSend(String capability,String value) genutzt werden. Wenn nun ein Wert ausgelesen werden soll, der vom Server geschickt wurde, kann String connectHubGetCapability(const char* capability) genutzt werden. Dies gibt den letzten erhaltenen Wert dieser Capability als einen String aus.

Flashen

Um das fertige Programm auf den ESP zu spielen, kann nun die Upload Funktion von Platformio genutzt werden. Dazu muss der ESP per Kabel an den PC angeschlossen werden. Wichtig ist, das der Serial Monitor während des Uploads deaktiviert wird, da er sonst den Port blockiert.

Pairing-Code

Damit ein frisch geflashtes Gerät in der App bzw. im Dashboard hinzugefügt werden kann, wird der Pairing-Code benötigt. Dieser besteht aus den letzten vier Stellen der MAC-Adresse des Geräts und wird beim Provisioning auf der Weboberfläche des Access Points angezeigt; alternativ lässt sich die MAC-Adresse auch über den seriellen Monitor auslesen. Unter „Geräte hinzufügen" → „Per Geräte-ID hinzufügen" werden anschließend die Geräte-ID und der Pairing-Code eingegeben (siehe Getting Started).