Skip to content

Command & Control

bkruggelhq edited this page Nov 3, 2025 · 1 revision

Command & Control

This is not part of the Demand Response program APIs. This section concerns direct control of devices via the Hilo Mobile App.

Flow

sequenceDiagram
    actor u as User
    participant ma as Hilo Mobile App
    participant dc as Hilo Discovery Client
    participant hidp as Hilo IDP
    participant pidp as Partner IDP
    participant papi as Partner API
    participant dt as Hilo Digital Twin

    u->>ma: Hilo Login
    ma->>+hidp: Aauth: Auth Code [OpenID, Profile, Email, API*]
    hidp-->>-ma: Access Token
    u->>ma: "Add partner devices..."
    ma->>dc: Begin device linking
    dc->>+pidp: Oauth: Auth Code [OpenID, offline_access, Email, API*]
    pidp-->>ma: Redirect OAuth hosted UI login
    u->>dc: Partner login
    dc->>pidp: OAuth: Continue Auth Code Flow
    pidp-->>-dc: Refresh token, access token
    dc-->>dc: Store/encrypt refresh token
    dc->>+papi: Request device list
    papi-->>dc: Devices, location, metadata
    dc-->>dc: Store devices, location, metadata
    dc->>papi: Request device state
    papi-->>-dc: Device state
    dc-->>+dt: Initialize Digital Twin with device state
    dt-->>-ma: Push device state
Loading

Clone this wiki locally