KMC CONTROLS UNO420-WIFI Wi-Fi
Zavedení
Node-RED se může objevit na dvou místech v KMC Commanderu. Síťový protokol Node-RED (v Network Exploreru pod Přidat síť) je primárně pro budoucí použití. Viz Síťový protokol (pro specifická předprogramovaná zařízení) na straně 2. Tato aplikační příručka je však primárně o doplňku Node-RED. Doplněk Node-RED funguje v KMC Commanderu, pokud byla zakoupena dodatečná licence. Klikněte na ikonu Doplňky (cloud) (vlevo pod ikonou Dashboard) a kliknutím na ikonu Node-RED otevřete Node-RED. Viz Doplněk (pro zákaznické uživatelské programování) na straně 3.
POZNÁMKA
Pokud nevidíte ikonu doplňku Node-RED, nemáte potřebnou extra licenci. Další pokyny k nákupu a instalaci získáte od společnosti KMC Controls.
„Typy“ Node-RED s KMC Commander
Síťový protokol (pro specifická předprogramovaná zařízení)
Volba protokolu node-RED je určena pro propojení s místními zařízeními (jako je sada pro detekci netěsností). Pro takové aplikace musí být Node-RED snap (aplikační balíček) také nainstalován v místním zařízení/bráně IoT KMC Commander. Pokud Node-RED snap nebyl předinstalován nebo automaticky nainstalován, musí jej uživatel nainstalovat pomocí PuTTy (nebo ekvivalentního terminálového softwaru) a pověření SSH (Secure SHell) pro toto zařízení.
POZNÁMKA
PuTTY je emulátor terminálu s otevřeným zdrojovým kódem. Další informace o SSH naleznete v tématu Konfigurace nastavení SSH v nápovědě ke KMC Commander (nebo na stejné téma v PDF instalační příručka KMC Commander).
Chcete-li nainstalovat Node-RED snap a objevit síť Node-RED
- Pokyny k instalaci Node-RED na místní zařízení/bránu KMC Commander získáte od KMC Controls.
- Pokyny ke konfiguraci a zjišťování sítě Node-RED naleznete v tématu Konfigurace sítě Node-RED v nápovědě KMC Commander (nebo ve stejném tématu v PDF s instalační příručkou KMC Commander).
Doplněk (pro zákaznické zákaznické programování)
Doplněk Node-RED je licence pro spuštění Node-RED na cloudovém serveru. Kliknutím na zástupce doplňku Node-RED se přesměrujete na tento server. Zobrazení a používání tohoto doplňku vyžaduje zakoupení další licence doplňku. Ohledně nákupu kontaktujte KMC Controls.asinlicenci. Node-RED je vizuální programovací nástroj s funkcí drag-and-drop a editorem v prohlížeči. Používá programování založené na toku dat, což je programovací paradigma, které definuje aplikace jako sítě procesů typu „černá skříňka“. „Černé skříňky“ (uzly nebo bloky) si vyměňují data přes předdefinovaná připojení předáváním zpráv. Node-RED byl původně vyvinut společností IBM, ale nyní je open source, což vygenerovalo mnoho bezplatných vývojových zdrojů. Doplněk Node-RED poskytuje prostředky pro rozšíření a integraci funkcí KMC Commanderu. Některé aplikace Node-RED např.ampzahrnují:
- Integrace KMC Commander s rozhraními API.
- Připojení dat KMC Commander k jiným zařízením a databázím.
- Vytváření na zakázku web stránky a dashboardy.
- Spuštění řídicího kódu pro KMC Commander pro ovládání funkcí v ovladačích HVAC nebo jiných zařízeních.
Rozhraní Node-RED, je-li správně licencováno, je přístupné prostřednictvím vašeho prohlížeče. Chcete-li jej používat, nemusíte do počítače instalovat žádný další software. Verze KMC Commander Node-RED obsahuje palety specifické pro KMC Commander. Viz Palety Commander a Users na straně 6.
Spuštění doplňku Node-RED
Chcete-li začít používat doplněk Node-RED
- Klikněte na ikonu Doplňky (cloud).
- Klikněte na ikonu Node-RED (která otevře přihlašovací stránku Node-RED na nové kartě prohlížeče).
- Zadejte přihlašovací údaje. (V případě potřeby kontaktujte KMC Controls pro výchozí uživatelské jméno a heslo Node-RED.)
- Klikněte na Přihlásit.
Karty a nasazení
POZOR
NEODSTRAŇUJTE JWT (JSON Web Token) Karta Přihlášení nebo upravte její obsah! (Pokud tak učiníte, možná se nebudete moci znovu přihlásit.)
NEODSTRAŇUJTE kartu Initialize Globals a buďte velmi opatrní při úpravách jejího obsahu! (Pokud tak učiníte, může přestat fungovat řada funkcí.)–Příkladamples tab poskytuje sampsoubory opakovaně použitelných toků týkajících se KMC Commander. Chcete-li najít další examples:
- Přejděte do nabídky (tři řádky v pravém horním rohu).
- Vyberte Import, čímž se otevře okno Import uzlů.
- Vyberte kartu Místní.
Vytvořte nové karty toku kliknutím na + napravo od karet. Poklepáním na novou kartu ji můžete přejmenovat, přidat popis a/nebo odstranit. Tlačítko Deploy (u pravého horního rohu) nasadí uzly z editoru na server. Po kliknutí má čtyři možnosti (popsané v tlačítkách).
Palety velitelů a uživatelů
Pro usnadnění programování je v paletě Commander v levém panelu zahrnuta knihovna příkazů specifických pro KMC Commander. Paleta Uživatelé obsahuje uzly týkající se uživatelských oprávnění a přihlášení KMC.
POZNÁMKA
Většina uzlů specifických pro KMC Commander je rozpoznatelná podle ikony trojúhelníků nahoru a dolů.
POZNÁMKA
Další palety lze přidat klepnutím na tlačítko Nabídka (tři řádky), výběrem palety Spravovat, klepnutím na kartu Instalovat a vyhledáním klíčových slov (např. řídicí panel).
Pro přístup k uzlům
- Přetáhněte uzel/blok z palety na list/okno.
- Poklepáním na uzel zadejte vlastnosti.
POZNÁMKA
Chcete-li získat další informace o konkrétním uzlu, klikněte na uzel a podívejte se na kartu informace.
Mezi uzly palety Commander a jejich stručně popsané funkce patří
- Baddeck — přidá balíček na palubní desku.
- kontrolní dotaz – poskytuje standardní vlastnosti výsledku dotazu.
- vytvořit kartu – přidá kartu na řídicí panel.
- createConnection — nastavuje spojení (zprávy) mezi zařízením a sítí v databázi.
- vytvořit zařízení – nastaví užitečné zatížení pro vytvoření zařízení v databázi KMC Commander.
- vytvořit síť – nastaví užitečné zatížení pro vytvoření sítě v databázi KMC Commander.
- vytvořit bod – nastaví užitečné zatížení pro vytvoření bodu v databázi KMC Commander.
- tvůrce – vytvoří proměnnou pro přidání do databáze KMC Commander.
- dělit bod — dělí aktuální hodnotu bodu buď pevnou hodnotou, nebo aktuální hodnotou jiného objektu.
- globální – poskytuje přístup ke globálním proměnným načteným z KMC Com-mander na kartě Inicializovat globální hodnoty.
- get props – poskytuje vlastnosti bodu z uzlu Query Check plus další filtr.
- invertCurVal — invertuje aktuální hodnotu bodu (např. 1 na 1/2, 10 na 1/10).
- max point—zjistí maximální aktuální hodnotu dvou nebo více bodů v datovém toku.
- pinpoint — zjistí minimální aktuální hodnotu dvou nebo více bodů v toku dat.
- name objects — nastaví užitečné zatížení na název bodu na daném zařízení v databázi Com-mander. Uzel vytváří šablony pro body, zařízení a sítě v objektovém „tématu“.
- negateCurVal—neguje aktuální hodnotu bodu (např. 1 až –1 nebo 10 až –10).
- round point — zaokrouhlí aktuální hodnotu bodů na přiřazenou přesnost (např. 12.3456 na 12).
- selectTrendData – poskytuje vlastnosti trendu ze vstupního bodu plus další filtr časového období.
- selectTrendTimeRange – vytvoří časové rozpětí (rozsah dat) pro dotazování API na data trendů.
- subpoints — sečte aktuální hodnotu dvou nebo více bodů v databázi KMC Com-mander.
- syncToClock – Přebírá vstup z uzlu do inject (nastaveno na opakující se 1sekundový interval) a vydává zprávu synchronizovanou se skutečným (systémové hodiny) časem ve zvoleném časovém intervalu synchronizace (1 minuta, výchozí).
- TrackPoint – přidává tags na jeden nebo více bodů v databázi KMC Commander.
- do bodu — odstraňuje tags z jednoho nebo více bodů v databázi KMC Commander.
- v1Parser – převádí zinek na JSON pro dřívější KMC Commander BX/V1 API.
Mezi uzly uživatelské palety a jejich funkce patří
- getPage – kontroluje odpověď HTTP GET z rozhraní KMC Commander API, aby zjistila, zda jsou výsledky úplné, a pokud ne, spustí se „další“ výstup, který provede další GET.
- hash8 – vygeneruje hash hesla bcrypt.
- soubor Url—poskytuje autorizaci pro požadavky http přistupující k API. Obsahuje volitelné pole dotazu pro použití při odesílání argumentu dotazu do rozhraní API a podporuje názvy proměnných pro knír web šablonový systém.
- ukládat soubory cookie – pomáhá ukládat soubory cookie globálním uživatelům.
- uživatelské přihlašovací údaje – nastavuje uživatelské jméno a heslo pro projekt.
- v1Login – používá se k šifrování v dřívějších rozhraních API KMC Commander BX/V1.
- ověřit – nastaví ID uživatele pro použití při vytváření objektů specifických pro uživatele.
Tipy pro použití
Níže jsou uvedeny některé důležité tipy pro používání Node-RED s KMC Commander
- Uzly mají pouze jeden vstup (na rozdíl od některých bloků v programování bloků KMC), ale výstupy z více uzlů lze připojit k jedinému vstupu uzlu.
- K zobrazení výsledků na obrazovce karty ladění je na řetězci potřeba (výstupní) ladicí uzel. Pokud se na obrazovce zobrazují výsledky z více ladicích uzlů, umístění ukazatele myši nad určitým textem označí příslušný uzel.
- (Vstupní) uzel pro vkládání spouští tok (ručně nebo pravidelně) a může do toku vkládat data.
- Přepínací uzel (funkce) vám dává schopnost logiky, jako je (mimo jiné) větší než, je mezi, obsahuje a je pravdivé.
- Uzel změny (funkce) je užitečný pro zúžení informací o objektu (jako je snížení všech vlastností objektu pouze na aktuální hodnotu). Uzel změn také umožňuje nastavit hodnoty.
- Pokud chcete získat bod z rozhraní API KMC Com-mander, použijte několik (uživatelských) uzlů. Změňte řetězec dotazu na požadovaný tag. Použijte AND/OR pro zúžení možností. Syntaxe je stejná jako v Průzkumníku dat (viz téma Průzkumník dat v nápovědě ke KMC Commander nebo stejná část v PDF instalační příručka KMC Commander).
- Uzel getGlobal (Commander) získává informace o objektu z karty Initialize Globals, aby bylo možné zjednodušit toky. Napřample, pokud potřebujete zapisovat do setpointu přes API, můžete použít globální pro přístup k ID a použít ID v POST k aktualizaci hodnoty.
- KMC Commander může poskytovat data pouze konečnou rychlostí, takže je vždy třeba zvážit efektivní využití šířky pásma. Napřample, nedotazujte se neustále na všechny body v systému, když bude stačit omezený dotaz (např. „senzor a teplota“ pro získání teplotních senzorů).
Zdroje Node-RED
Doplněk Node-RED je určen pro pokročilé uživatele KMC Commander a pokyny pro použití Node-RED jsou nad rámec tohoto dokumentu. Další informace o Node-RED:
- Viz Přampkarta les pro opakovaně použitelné toky týkající se KMC Commander.
- Kliknutím na uzel/blok zobrazíte informace o něm na kartě info na pravé straně obrazovky. Klepnutím na tlačítko Zobrazit nápovědu (ikona knihy) zobrazíte další informace nápovědy o daném uzlu. (Dvojitým kliknutím na uzel se také otevře panel vlastností úprav.) Klepnutím na tlačítko i (vedle karty nápovědy) se vrátíte zpět na kartu info.
- Kliknutím na logo KMC Commander v levé horní části obrazovky přejdete na tipy na api.kmccommander.com.
- Obecné informace najdete na nodered.org.
- Nápovědu viz nodered.org/docs/. Viz zejména Kuchařka napřampsoubory, které lze zkopírovat a poté importovat do Node-RED ze schránky.
Důležitá upozornění
Materiál v tomto dokumentu slouží pouze pro informační účely. Obsah a produkt, který popisuje, se mohou bez upozornění změnit. Společnost KMC Controls, Inc. neposkytuje žádná prohlášení ani záruky s ohledem na tento dokument. Společnost KMC Controls, Inc. v žádném případě nenese odpovědnost za žádné přímé nebo náhodné škody, které vzniknou nebo souvisejí s používáním tohoto dokumentu.
KMC Controls® a logo KMC jsou registrované ochranné známky společnosti KMC Controls. KMC Commander™ je ochranná známka společnosti KMC Controls. Všechny ostatní uvedené produkty nebo názvy značek jsou ochrannými známkami příslušných společností nebo organizací. Všechna práva vyhrazena. Žádná část této publikace nesmí být reprodukována, přenášena, přepisována, ukládána do vyhledávacího systému nebo překládána do jakéhokoli jazyka v jakékoli formě jakýmkoli způsobem bez písemného souhlasu společnosti KMC Controls, Inc.
Podpůrné dokumenty velitele KMC
Všechny dokumenty podpory KMC Commander jsou k dispozici na ovládacích prvcích KMC webmísto. Do pole Hledat zadejte číslo dílu KMC Commander (např. CMDR-ADVT-WIFI-BASE). Přihlaste se, abyste viděli všechny dostupné files. Informace v PDF Instalační příručka KMC Commander jsou k dispozici také v online formátu na adrese help.kmccommander.com.
Pro pokročilé aplikace má api.kmccommander.com informace o aplikačním programovacím rozhraní KMC Commander.
POZNÁMKA: Dokumenty, design produktu a specifikace produktu se mohou bez upozornění změnit.
2022 KMC ContrKMC Commander a Node-RED Aols, Inc.
Dokumenty / zdroje
 |
Základní balíček Wi-Fi KMC CONTROLS UNO420-WIFI s příslušenstvím IoT Gateway [pdf] Instalační průvodce Základní balíček UNO420-WIFI Wi-Fi s příslušenstvím IoT Gateway, UNO420-WIFI, Wi-Fi Base Bundle s příslušenstvím IoT Gateway, Balíček s příslušenstvím IoT Gateway, w- Příslušenství IoT Gateway, Příslušenství IoT Gateway, IoT Gateway |
