Erstellen einer Control App

Erstellen einer Control app

Um auf API1.docs zuzugreifen, klicken Sie auf Ihren Benutzernamen in der unteren linken Ecke des Frontends und wählen Sie das Dokument im angezeigten Menü aus.

Scrollen Sie zum Abschnitt Controls und klicken Sie auf POST/v2/controls/app:

Geben Sie die project_id, componentinproject_id, den Algorithmus sowie optional eine Variation, einen Namen und eine Beschreibung ein. Zusätzlich müssen priority und reset_value im Request-Body konfiguriert werden. Klicken Sie auf „try“, um die POST-Anfrage zu senden und die App zu erstellen.

Informationen zu den Regelungsalgorithmen und deren Varianten finden Sie in der Dokumentation: https://docs.emalyticscloud.com/en/products/controls/algorithms/

Die project_id und componentinproject_id einer bestimmten Komponente können in der URL gefunden werden, wenn im Abschnitt Optimierung des Frontends eine Komponente ausgewählt ist.

Die erste Zahl in der URL nach „…/optimization/components/…“ ist die project_id (z. B. 2 im obigen Beispiel), die zweite Zahl ist die componentinproject_id (z. B. 9 im obigen Beispiel).

Der name der Control-App wird im Frontend im Abschnitt AI Controls angezeigt. Daher sollte ein aussagekräftiger Name gewählt werden (z. B. App-Name + Komponentenname: „hero AHU 2“).

Für jede Ausgabe der Control-App müssen priority und reset_value angegeben werden. Die meisten Control-Apps haben nur eine Ausgabe, sodass der Request-Body für die Control-App „hero“ wie folgt aussieht:

SUP_T_AIR_SP ist die pin_alphanumeric_id des Sollwert-Pins, auf den die Hero Controls-App die berechneten Werte schreibt (in diesem Fall (in diesem Fall "Zuftlufttemperatur-Sollwert"). Die pin_aphanumeric_ids finden Sie in der Dokumentation.

{
  "setpoint_writing_params": {
                 "SUP_T_AIR_SP": {
                                   "keep_out_of_service": false,
                                   "priority": 13,
                                    "reset_value": "null"
    }
  }
}

Der Parameter priority ist die BACnet-Priorität (in der Regel sollte ein Wert über 8 gewählt werden).

Der reset_value wird aktiviert, wenn die Control-App deaktiviert wird oder die Verbindung zum Emalytics Connector verloren geht. Null bedeutet, dass der Wert im BACnet-Array mit der gewählten Priorität freigegeben wird. Der Wert mit der nächsthöheren Priorität wird nach dem Senden von Null aktiv. Neben null können auch numerische Werte angegeben werden.

Die Konfiguration einer Hero-Control-App ist unten dargestellt:

Wenn die Antwortnachricht die erfolgreiche Erstellung der App bestätigt, kann diese im nächsten Schritt gestartet werden.

Um die Control-App zu starten, gehen Sie im Frontend zum Abschnitt KI Regelung - App, wählen Sie die neu erstellte App aus und klicken Sie auf den Umschaltknopf neben dem App-Namen.

Wenn der Umschaltknopf nicht grün wird, laden Sie die Seite bitte neu.

Die Control-Apps können auch über den Umschaltknopf deaktiviert werden.

Löschen einer Control app

Um eine bestimmte Control-App zu löschen, kann DELETE/v2/controls/app verwendet werden. Die App muss vor dem Löschen im Abschnitt AI Controls ausgeschaltet sein:

Die project_id kann in der URL gefunden werden (siehe Abschnitt oben). Um die controls_app_id zu erhalten, verwenden Sie den API-Endpunkt GET/v2/controls/apps. Dieser GET-Endpunkt listet alle Apps eines Projekts mit ihren IDs, Metadaten und Status auf.