Danfoss Ally Cloud

Podporované typy a verzie zariadení
Literatúra
Revízie dokumentu

Podporované typy a verzie zariadení

Protokol Danfoss Ally Cloud umožňuje komunikáciu s cloudovými službami Danfoss Ally (https://developer.danfoss.com) s použitím Danfoss Ally API (https://developer.danfoss.com/catalog/danfoss-ally-api/danfoss-allytm-api).

Protokol Danfoss Ally Cloud je implementovaný ako ESL skript (E.Danfoss_Cloud) s použitím unitu E.Danfoss_Cloud.unit a utility curl na komunikáciu s cloudom. Následne sa v ESL skripte parsujú dáta a ukladajú do štruktúrovaných premenných:

• SV.Danfoss_Ally_Gateway - zariadenia typu "Danfoss Ally™ Gateway"
• SV.Danfoss_Ally_Radiator_Thermostat - zariadenia typu "Danfoss Ally™ Radiator Thermostat"
• SV.Danfoss_Icon_RT - zariadenia typu "Icon RT"  (Room Thermostat)
• SV.Danfoss_Icon_Zigbee_Module - zariadenia typu "Icon Zigbee Module"
• SV.Danfoss_Zigbee_Repeater - zariadenia typu "Danfoss Zigbee Repeater"

Pri nájdení nového zariadenia (unikátne identifikátory sa nachádzajú v stĺpcoch "id") je príslušná štruktúrovaná premenná automaticky zväčšená a nové zariadenie je vložené do pridaného riadku.
Pozn: odporúčame vopred zväčšiť rozmer príslušných štruktúrovaných premenných podľa približného počtu jednotlivých typov zariadení, aby pri prvom parsovaní dát nebol systém zaťažovaný neustálym postupným zväčšovaním ich rozmeru.

Skript je rozširovateľný a je možné doimplementovať parsovanie ďalších typov zariadení a ďalších atribútov existujúcich zariadení.

Je podporovaná práca s viacerými užívateľskými účtami. Každé Danfoss zariadenie je zaregistrované na konkrétny užívateľský účet a v horeuvedené štruktúrované premenné obsahujú prvý stĺpec idCred, v ktorom je pre každé zariadenie uvedené ID účtu (index do štruktúrovanej premennej SV.Danfoss_Credentials s účtami).

Danfoss_cloud_1.4.zip

Konfigurácia v cloude Danfoss a prístupové práva k zariadeniam

• V mobilnej aplikácii Danfoss Ally (https://www.danfoss.com/sk-sk/campaigns/dhs/smart-heating/danfoss-ally) je možné pripojiť zariadenia k zaregistrovanému Danfoss účtu. Registrácia sa vykonáva pri inštalácii mobilnej aplikácie a účet je identifikovaný e-mailovou adresou (napr. ipesoft@ipesoft.sk).
  Pozn: zrejme iba role vlastník (Home Owner) a administrátor (Administrator) majú právo prístupu na zariadenia cez rozhranie "Danfoss Ally API". Ostatné užívateľské role toto právo nemajú.
• Následne je nutné vytvoriť užívateľský účet (pre tú istú e-mailovú adresu) na https://developer.danfoss.com.
• Po prihlásení sa do účtu je nutné vytvoriť aplikáciu kliknutím na položku Apps (https://developer.danfoss.com/user/apps) kliknutím na tlačidlo "Add app".
• Pri vytvorení aplikácie treba pridať rozhranie "Danfoss Ally API".
• Po vytvorení aplikácie je situácia nasledovná: 
  
• Položky "Consumer Key" a "Consumer Secret" je nutné skopírovať a vytvoriť reťazec Consumer Key:Consumer Secret a previesť ho na BASE64 napr. pomocou https://www.base64encode.org 
  Príklad: ak  "Consumer Key" je M2i51jpJrgGpKr4TfwnI0XMLDD1nKMU9G a "Consumer Secret" je 1VT80QedtXJE3Xcu72LUjIvMwyvgVWziQ3NHEg, tak musí byť skonvertovaný reťazec
  M2i51jpJrgGpKr4TfwnI0XMLDD1nKMU9G:1VT80QedtXJE3Xcu72LUjIvMwyvgVWziQ3NHEg a BASE64 výsledok je 
  TTJpNTFqcEpyZ0dwS3I0VGZ3bkkwWE1MREQxbktNVTlHOjFWVDgwUWVkdFhKRTNYY3U3MkxVakl2TXd5dmdWV3ppUTNOSEVn
• Výsledok je nutné vložiť do štruktúrovanej premennej SV.Danfoss_Credentials do stĺpca access_key. Táto štruktúrovaná premenná bude mať teda toľko riadkov, koľko je užívateľských účtov. Odporúčame do stĺpca account zadať identifikácie jednotlivých užívateľských účtov (napr. e-maily).
• Následne je v skripte E.Danfoss_Cloud možné nastaviť iný trigger na spustenie čítania, ako je použitý objekt Min:
  

  ON CHANGE Min GOTO TriggerChanged   ; this trigger can be replaced e.g. by a custom evaluated tag

  
  
• Test zápisu (zvýšenie setpointu teploty pre prvé zariadenia typu "Room Thermostat" / "Radiator Thermostat" o 0.1°C a následné nastavenie pôvodnej teploty) je v skripte E.Danfoss_TestWrite

Literature

• Danfoss Ally
• Danfoss Ally API

Revízie dokumentu

• Ver. 1.0 - 25. marec 2024 - vytvorenie dokumentu.