Přeskočit na hlavní obsah

Ruční připojení

Většina zařízení to nepotřebuje

Automatické připojení je jednodušší: přidáte jeden konektor a každé otagované zařízení se objeví samo. Ruční připojení použijte jen pro zařízení, která už v HARDWARIO Dashboards existují, nebo když potřebujete vlastní formát dat.

Při ručním připojení má každé zařízení v HARDWARIO Dashboards svůj access token. Konektor v HARDWARIO Cloud si token přečte z labelu zařízení a pošle na něj data zařízení.


Krok 1: Vytvořte zařízení​

Pokud zařízení v HARDWARIO Dashboards už existuje, tento krok přeskočte.

  1. Otevřete Devices & assets → Devices (správci tenantu Entities → Devices) vpravo nahoře klikněte na Add device a zvolte Add new device.

    Seznam zařízení s otevřenou nabídkou Add device a zvýrazněnou volbou Add new device

  2. Zadejte Name (1), například sériové číslo, a Label (2), tedy srozumitelný název jako Chladírna A. Můžete vybrat i skupiny (Groups). Klikněte na Add (3).

    Dialog Add new device se zvýrazněnými poli Name a Label a tlačítkem Add

Zařízení se objeví v seznamu.


Krok 2: Zkopírujte access token​

Klikněte na zařízení v seznamu. V detailu zařízení klikněte na Copy access token.

Detail zařízení s tlačítkem Copy access token

pozor

S access tokenem může do zařízení posílat data kdokoli. Nesdílejte ho nikde jinde než v konektoru.


Krok 3: Připravte zařízení v HARDWARIO Cloud​

Otevřete zařízení v HARDWARIO Cloud:

  • Přiřaďte mu tag (například dashboards-manual), viz Přiřazování tagů. Konektor posílá data všech zařízení s tímto tagem.
  • Přidejte access token jako label. Úplně dole na stránce zařízení v sekci Labels vytvořte label:
    • Name: thingsboardtoken. Můžete zvolit i jiný název, ale musí být stejný u všech zařízení, která konektor sdílejí, a musí odpovídat názvu v transformačním kódu (job.device.label.thingsboardtoken).
    • Value: access token z kroku 2.

Krok 4: Vytvořte konektor​

  1. V HARDWARIO Cloud otevřete v levém menu Connectors, klikněte na New connector a zvolte Webhook.

    Stránka s výběrem typu konektoru se zvýrazněným Webhookem

  2. Vyplňte nastavení:

    • Name (1): například dashboards-manual,
    • Flows (2): nechte jen Uplink data, tedy data, která zařízení posílá,
    • Tags (3): tag z kroku 3.

    Nastavení nového webhook konektoru se zvýrazněným polem Name (1), flow Uplink data (2) a polem Tags (3)

  3. Klikněte na Create.


Krok 5: Vložte transformační kód​

HARDWARIO Dashboards očekává vlastní formát dat. Transformační kód do něj zprávu zařízení převede.

  1. Na stránce konektoru otevřete záložku Transformation.

    Stránka konektoru se zvýrazněnou záložkou Transformation

  2. Vložte kód níže do prostředního editoru Transformation a klikněte na Save.

    Editor Transformation s transformační funkcí

Kód pokrývá běžná měření CHESTER a BLE tagy. Před zkopírováním ho můžete upravit přímo tady:


Krok 6: Zkontrolujte data​

Na záložce Transformation vyberte zařízení v poli Select device (1). Vlevo (Input, 2) vidíte poslední zprávu ze zařízení, vpravo (Output, 3) transformovaná data, která se posílají do HARDWARIO Dashboards. Pokud zařízení v seznamu ještě není, zapněte Allow devices without connector tags.

Záložka Transformation s vybraným zařízením (1), jeho vstupní zprávou (2) a transformovaným výstupem (3)

Po další zprávě zařízení ho otevřete v HARDWARIO Dashboards a přepněte na Latest telemetry. Hodnoty by se měly objevit a s každou zprávou aktualizovat.

Záložka Latest telemetry zařízení s klíči a hodnotami

Řešení potíží​

ProblémCo dělat
V Latest telemetry nejsou žádná dataZkontrolujte, že zařízení má tag i label a že název labelu odpovídá kódu. Počkejte na další zprávu zařízení.
Transformovaná data vypadají správně, ale nic nepřicházíAccess token v labelu je nejspíš špatně. Zkopírujte ho znovu z detailu zařízení.

Cokoli dalšího: ask@hardwario.com.

Další kroky​

Dokumentace ThingsBoard

HARDWARIO Dashboards jsou postavené na platformě ThingsBoard. Podrobnosti najdete v oficiální dokumentaci ThingsBoard (anglicky): HTTP device API.