Knihovna pro řízení techologií v budovách · 2017. 3. 6. · informaci o krátkém resp. dlouhém stisku poskytuje přímo CIB modul. Doba pro vyhodno-cení dlouhého stisku

Knihovna iControlLib


TXV 003 59.01druhé vydání

únor 2017změny vyhrazeny

1 TXV 003 59.01


Historie změnDatum Vydání Popis změn

Prosinec 2014 1 První vydání, popis odpovídá iControlLib_v10Únor 2017 2 Druhé vydání, popis odpovídá iControlLib_v20

OBSAH1 Úvod........................................................................................................................32 Datové typy.............................................................................................................4

2.1Typ T_SET_RGB_LIGHT...........................................................................................4

3 Konstanty...............................................................................................................44 Globální proměnné................................................................................................45 Funkce ...................................................................................................................46 Funkční bloky.........................................................................................................5

6.1 Funkční blok fb_iAction..........................................................................................66.2 Funkční blok fb_Button1........................................................................................86.3 Funkční blok fb_iDimmer......................................................................................116.4 Funkční blok fb_iDimmerLED .............................................................................156.5 Funkční blok fb_iDimmerRGB...............................................................................196.6 Funkční blok fb_iDisplay_OnOff...........................................................................236.7 Funkční blok fb_iDisplay_Val................................................................................266.8 Funkční blok fb_iDisplay_Edit...............................................................................296.9 Funkční blok fb_JalAlarm......................................................................................326.10 Funkční blok fb_iJalousie....................................................................................376.11 Funkční blok fb_iLight.........................................................................................426.12 Funkční blok fb_iRelay........................................................................................456.13 Funkční blok fb_iScene4, fb_iScene8.................................................................486.14 Funkční blok fb_iSensorPIR ..............................................................................526.15 Funkční blok fb_iSensorTemp...........................................................................546.16 Funkční blok fb_iSocket......................................................................................566.17 Funkční blok fb_iTimeProgWeek........................................................................596.18 Funkční blok fb_iTimeProgWeek1, fb_iTimeProgWeek2.................................736.19 Funkční blok fb_iWebCamera............................................................................746.20 Funkční blok fb_iWebConf.................................................................................766.21 Funkční blok fb_RndPulse.................................................................................796.22 Funkční blok fb_TimeAction...............................................................................81

7 Generování public souboru...............................................................................83

2 TXV 003 59.01


1 ÚVOD

Knihovna iControlLib obsahuje funkční bloky využitelné především v inteligentníchdomech. Tyto bloky jsou připraveny pro ovládání z webového rozhraní a pro snadnou in -tegraci s aplikací iFoxtrot.

Knihovna iControlLib je standardně dodávaná jako součást programovacíhoprostředí Mosaic. Pro knihovnu iControlLib_v20 a vyšší je potřebný Mosaic verze v2017.1,aplikace iFoxtrot musí být verze v2.4.1 nebo vyšší.

Následující obrázek ukazuje strukturu knihovny iControlLib v prostředí Mosaic

Knihovna iControlLib není podporovaná na systémech TC-650, u systému TC700

nelze knihovnu použít s procesorovými moduly CP-7002, CP-7003 a CP-7005.Funkce z knihovny iControlLib v2.0 jsou podporovány v centrálních jednotkách řady

K a L (TC700 CP-7004 a CP-7007, všechny varianty systému Foxtrot) od verze v9.8.Knihovna nevyžaduje aplikační profil.

Objednací číslo dokumentace ke knihovně iControlLib je TXV 003 59.01.

3 TXV 003 59.01


2 DATOVÉ TYPYV knihovně iControlLib jsou definovány následující datové typy:

Typ PopisT_SET_RGB_LIGHT Struktura obsahující hodnoty nastavení pro stmívané RGB světlo

2.1 Typ T_SET_RGB_LIGHTKnihovna : iControlLib

Struktura T_SET_RGB_LIGHT slouží k uchování parametrů pro stmívané barevnésvětlo. Význam jednotlivých položek struktury je následující:

• level úroveň jasu zapnutého světla %• RGB.red červená složka • RGB.green zelená složka • RGB.blue modrá složka • RGB.opacity průhlednost (0 = neprůhledné, 255 = plně průhledné)

Struktura T_SET_RGB_LIGHT je používána blokem fb_iDimmerRGB.

3 KONSTANTYV knihovně iControlLib nejsou definovány žádné konstanty.

4 GLOBÁLNÍ PROMĚNNÉV knihovně iControlLib nejsou definovány žádné globální proměnné.

5 FUNKCE V knihovně iControlLib nejsou definovány žádné funkce.

4 TXV 003 59.01


6 FUNKČNÍ BLOKYV knihovně iControlLib jsou definovány následující funkční bloky:

Funkční blok Popis Bloky s podporou aplikace iFoxtrot

fb_iAction Zachycení požadavku na akcifb_iDimmer Řízení stmívaného světla (0..100%)fb_iDimmerLED Řízení stmívaného LED světla (0..100%)fb_iDimmerRGB Řízení stmívaného RGB světla (0..100%)fb_iDisplay_OnOff Zobrazení BOOL hodnoty v aplikaci iFoxtrotfb_iDisplay_Val Zobrazení REAL hodnoty v aplikaci iFoxtrotfb_iDisplay_Edit Zobrazení a změna REAL hodnoty v aplikaci iFoxtrotfb_iJalousie Ovládání žaluziífb_iLight Řízení spínaného světlafb_iRelay Řízení BOOL proměnné (např. Releový výstup)fb_iScene4 Nastavení jedné ze 4 scénfb_iScene8 Nastavení jedné z 8 scénfb_iSensorPIR Detekce pohybufb_iSensorTemp Měření teplotyfb_iTherm Měření teploty – stejné jako fb_iSensorTempfb_ItimeProgWeek Ukládání a načítání časového programufb_ItimeProgWeek_Control Řízení podle časového programufb_ItimeProgWeek_Web Editace čas. programu z web stránky v PLCfb_iWebCamera Zveřejnění web kamery do aplikace iFoxtrotfb_iWebConf Zveřejnění web stránky do aplikace iFoxtrot

Doplňkové blokyfb_Button1 Vyhodnocení krátkého a dlouhého stisku tlačítkafb_RndPulse Generátor náhodných pulzůfb_JalAlarm Vyhodnocení alarmů pro žaluziefb_TimeAction Jednoduché časové ovládání

5 TXV 003 59.01


6.1 Funkční blok fb_iActionKnihovna : iControlLib

Funkční blok fb_iAction slouží k zachycení požadavku na nějakou akci. Vstup acti-on slouží pro připojení požadavků vznikajících v PLC (například stisknutí tlačítka připo-jeného na binární vstup PLC nebo nastavení BOOL proměnné v PLC programu nahodnotu TRUE). Vstup webAction slouží k zachycení požadavků z web rozhraní (tutoproměnnou je třeba nastavit na TRUE v případě, že chceme vyvolat akci z web stránky).Externí aplikace (iFoxtrot, ...) musí pro vyvolání akce nastavit hodnotu TRUE doproměnné GTSAP1_ACTION_state. Vstup name slouží k pojmenování akce.

Výstup out je nastaven na TRUE v případě, že se na kterémkoliv ze vstupů změníhodnota z FALSE na TRUE. Jinými slovy náběžná hrana na kterémkoliv vstupu nastavívýstup out na dobu jednoho cyklu PLC. Vstupy webAction a GTSAP1_ACTION_state jsoupo zachycení náběžné hrany automaticky vynulovány.

Popis proměnných :Proměnná Typ Význam

VAR_INPUTaction BOOL

R_EDGEŽádost o vyvolání akce z PLCNáběžná hrana této proměnné nastaví výstup out

webAction BOOLR_EDGE

Žádost o vyvolání akce z web stránkyNáběžná hrana této proměnné nastaví výstup out

name STRING[24] Pojmenování bloku pro aplikaci iFoxtrot

VAR_OUTPUTout BOOL TRUE pokud přišel požadavek na akci na některém ze

vstupů, jinak FALSE

Příkladem použití funkčního bloku fb_iAction může být například centrální zhasnutísvětel v domě. Tuto akci chceme vyvolávat jak pomocí odchodového tlačítka, tak z webstránky a také z externí aplikace. V jazyce ST bude program vypadat následovně:

VAR_GLOBAL central_OFF : BOOL;END_VAR

6 TXV 003 59.01


PROGRAM prgMain VAR GoOut : fb_iAction; END_VAR GoOut( action := r0_p3_DI.DI0, out => central_OFF);END_PROGRAM

V programu je založena instance funkčního bloku fb_iAction s názvem GoOut.Program předpokládá, že odchodové tlačítko je připojeno na binární vstup r0_p3_DI.DI0.Výstup funkčního bloku GoOut je zapisován do globální proměnné central_OFF. Tatoproměnná bude pak dále použita pro vstupy všech bloků s funkcí centrálního zhasnutí.

Stejnou funkci jako v předcházejícím příkladu lze naprogramovat v jazyce CFC na-příklad následovně:

Integrace s aplikací iFoxtrot

Pro každou použitou instanci funkčního bloku fb_iAction se do souboru „iFox-trot.pub“ (public soubor) automaticky generuje generuje sada proměnných, která sloužípro integraci s aplikací iFoxtrot.

Každá instance fb_iAction přidá následující public proměnné:Proměnná Typ Význam

R GTSAP1_ACTION_name STRING[24] Kopie vstupu name R GTSAP1_ACTION_enable BOOLW GTSAP1_ACTION_state BOOL Žádost o vyvolání akce z iFoxtrot

R = pouze čtení, W = pouze zápis, RW = čtení i zápis

V našem případě to bude vypadat následovně:

Main.GoOut.GTSAP1_ACTION_name R B 28 STRING[24] PUB_INMain.GoOut.GTSAP1_ACTION_enable R B 53 .0 BOOL PUB_INMain.GoOut.GTSAP1_ACTION_state R B 53 .1 BOOL PUB_OUT

kdeMain instance programu, kde je použit blok fb_iActionGoOut název bloku fb_iAction (jméno instance)GTSAP1_ACTION_state název proměnné pro integraci bloku fb_iAction

7 TXV 003 59.01


6.2 Funkční blok fb_Button1Knihovna : iControlLib

Funkční blok fb_Button1 slouží k vyhodnocení krátkých a dlouhých stisků tlačítka,které je připojeno na běžný binární vstup PLC systému. Tento blok nahrazuje fb_iButton1,který byl v předchozích verzích knihovny iControlLib.

Vstup in slouží pro připojení tlačítka. Vstup pressTime definuje dobu stisknutí, kteráje potřebná pro vyhodnocení dlouhého stisku. Pokud bude na vstupu in hodnota TRUE pokratší dobu než udává pressTime, bude stisknutí považováno za krátký stisk.

Výstup out je kopií vstupu in. Výstup click je nastaven na dobu jednoho cyklu PLC

na hodnotu TRUE v případě, že došlo ke krátkému stisku tlačítka připojeného na vstup in.Výstup press je nastaven na hodnotu TRUE pokud je tlačítko stisknuté delší dobu nežudává vstup pressTime. Výstup press pak setrvá na hodnotě TRUE až do okamžikuuvolnění tlačítka (než bude mít vstup in hodnotu FALSE).


VAR_INPUTin BOOL Vstup pro připojení tlačítka

pressTime TIME Minimální doba pro vyhodnocení dlouhého stisku. Přednastavená hodnota je 750 ms

VAR_OUTPUTout BOOL Kopie vstupu in

click BOOL TRUE na dobu jednoho cyklu PLC, pokud došlo ke krátkému stisku tlačítka

press BOOL TRUE pokud je tlačítko stisknuto déle než udává vstup pressTime

Následující příklad ukazuje použití funkčních bloků fb_Button1 pro ovládání stmíva-cího bloku fb_iDimmer. Krátké stisky zapínají respektive vypínají světlo, dlouhé stiskymění úroveň jasu světla. V jazyce ST bude program vypadat následovně:

8 TXV 003 59.01


VAR_GLOBAL RETAIN dimmer1level : REAL;END_VARVAR_GLOBAL central_OFF : BOOL;END_VARPROGRAM prgMain VAR Button1 : fb_Button1; Button2 : fb_Button1; Dimmer1 : fb_iDimmer; END_VAR // akce centralniho zhasnuti GoOut( action := r0_p3_DI.DI0, out => central_OFF); // stmivac ovladany 2 tlacitky Button1( in := r0_p3_DI.DI1, pressTime := T#500ms); Button2( in := r0_p3_DI.DI2, pressTime := T#0.5s); Dimmer1( lightOn := Button1.click, levelUp := Button1.press, lightOff := Button2.click, levelDw := Button2.press, lightReset := central_OFF, setLevel := dimmer1level, level => r0_p3_AO1.ENG);END_PROGRAM

Funkční bloky Button1 a Button2 zpracovávají signály od tlačítek připojených na bi-nární vstupy DI1 a DI2. Čas pro vyhodnocení dlouhého stisku je nastaven na 0.5 sec.Světlo je připojeno na analogový výstup AO1. Stejnou funkci lze naprogramovat v jazyceCFC například následovně:

9 TXV 003 59.01


Poznámka.Některé CIB moduly z produkce Teco mají integrovanou funkci vyhodnocení krát-

kého a dlouhého stisku. V těchto případech není funkční blok fb_Button1 potřeba, protožeinformaci o krátkém resp. dlouhém stisku poskytuje přímo CIB modul. Doba pro vyhodno-cení dlouhého stisku se pak zadává v HW konfiguraci modulu. Jedná se například o mo-duly C-IB-1800M, C-IR-0203M, C-IT-0908S, C-JC-0201B, C-LC-0202B, C-RQ-0400, C-RQ-0600, C-WS-0200R-LOGUS, C-WS-0400R-LOGUS, C-WS-0200R-OBZOR a C-WS-0400R-OBZOR.

10 TXV 003 59.01


6.3 Funkční blok fb_iDimmerKnihovna : iControlLib

Funkční blok fb_iDimmer je určen k řízení stmívaného světla v rozsahu 0...100%.Výstup bloku je vhodný pro řízení světla např. převodníkem 0...10V.

Vstup lightOn slouží k rozsvícení světla na úroveň nastavenou parametremsetLevel. Světlo se rozsvítí plynule, rychlost rozsvícení určuje vstup offOnRamp. Tenudává celkový čas, za který se světlo rozsvítí z minLevel na 100%. Vstup minLevel určujeminimální úroveň, při které světlo ještě svítí (ta odpovídá např. zapalovacímu napětí záři-vek). Vstup lightOff zhasne světlo. Pomocí vstupů levelUp a levelDw lze nastavovatúroveň, na kterou se světlo bude rozsvěcet. Při nastavování úrovně je rychlost rozsvíceníresp. zhasínání určena vstupem setRamp, který opět udává čas, za který se světlo rozsví-tí z minLevel na 100%. Vstup lightToggle přepne světlo – pokud svítí tak ho zhasne apokud je zhasnuté tak ho rozsvítí. Vstup webToggle funguje stejně jako lightToggle aslouží k zapínání a vypínání světla z web rozhraní (tuto proměnnou je třeba nastavit naTRUE v případě, že chceme přepnout světlo z web stránky). Vstup timeLimit umožňujeomezit dobu svícení. Pokud má hodnotu T#0s tak doba svícení není omezena. A konečněvstup lightReset slouží jako centrální vypnutí všech světel.

Vstup name slouží pro pojmenování světla pro aplikaci iFoxtrot.

Proměnná setLevel slouží k zapamatování poslední nastavené úrovně a měla bybýt založena v sekci VAR_GLOBAL RETAIN.

Výstup out signalizuje, že je světlo zapnuté. Výstup level udává úroveň, na jakouse světlo rozsvítí (0...100%).

Světlo lze ovládat dvoutlačítkově, pomocí vstupů lightOn a lightOff, nebo jednotlačí-tkově pomocí vstupu lightToggle.

11 TXV 003 59.01



VAR_INPUTlightOn BOOL

R_EDGENáběžná hrana zapne světlo na úroveň setLevel Rychlost rozsvícení určuje vstup ramp

levelUp BOOL Zvýšení úrovně, na kterou se světlo bude rozsvěcet(mění proměnnou setLevel)Rychlost změny určuje vstup setRamp

lightOff BOOLR_EDGE

Náběžná hrana vypne světloRychlost zhasnutí určuje vstup ramp

levelDw BOOL Snížení úrovně, na kterou se světlo bude rozsvěcet(mění proměnnou setLevel)Rychlost změny určuje vstup setRamp

lightToggle BOOLR_EDGE

Náběžná hrana přepne světloRychlost rozsvícení/zhasnutí určuje vstup ramp

minLevel REAL Minimální úroveň, ze které se zahájí rozsvícení světla [%]Přednastavená hodnota 10%

offOnRamp TIME Doba, za kterou se světlo rozsvítí z minLevel na 100%pro zapnutí a vypnutí světla [sec]Přednastavená hodnota 5 sec

setRamp TIME Doba, za kterou se světlo rozsvítí z minLevel na 100%pro změnu požadované úrovně [sec]Přednastavená hodnota 8 sec

timeLimit TIME Omezení doby svíceníPři T#0s není doba omezena

webToggle BOOLR_EDGE

ovládání světla z web stránky

lightReset BOOLR_EDGE

Vstup pro centrální vypnutí světel (odchodové tlačítko)


VAR_OUTPUTout BOOL TRUE signalizuje zapnuté světlo

level REAL Aktuální hodnota pro řízení světla [0...100%]

minLev REAL minimální úroveň

VAR_IN_OUTsetLevel REAL Požadovaná úroveň, na kterou se má světlo rozsvítit

[0...100%]

12 TXV 003 59.01


Předpokládejme, že potřebujeme řídit stmívané světlo převodníkem 0...10V připo-jeným na analogový výstup AO1. Světlo budeme ovládat nástěnným ovladačem C-WS-0200R-Logus, který je vybaven dvěma tlačítky. V jazyce ST bude program vypadat násle-dovně:

VAR_GLOBAL RETAIN dimmer2level : REAL;END_VARVAR_GLOBAL central_OFF : BOOL;END_VARPROGRAM prgMain VAR GoOut : fb_iAction; Dimmer2 : fb_iDimmer; END_VAR // akce centralniho zhasnuti GoOut( action := r0_p3_DI.DI0, out => central_OFF); // stmivac ovladany CIB modulem C-WS-0200R-Logus Dimmer2( lightOn := MI_CIB1_IN.ID1_IN.DI.CLICK_UP1, levelUp := MI_CIB1_IN.ID1_IN.DI.PRESS_UP1, lightOff := MI_CIB1_IN.ID1_IN.DI.DOWN1, levelDw := MI_CIB1_IN.ID1_IN.DI.PRESS_DOWN1, minLevel := 20.0, offOnramp := T#6s, setRamp := T#10s, timeLimit := T#12h, lightReset := central_OFF, setLevel := dimmer2level, level => r1_p0_AO1.ENG);END_PROGRAM

Světlo je zapínáno a vypínáno krátkými stisky tlačítek modulu C-WS-0200R-Logus.Dlouhé stisky těchto tlačítek nastavují požadovanou úroveň. Minimální úroveň pro roz-svícení světla je 20% a světlo se z této úrovně rozsvítí na 100% za 6 sec. Maximálnídoba, po kterou bude světlo nepřetržitě svítit je omezena na 12 hodin. Stejnou funkci lzenaprogramovat v jazyce CFC například následovně:

13 TXV 003 59.01



Pro každou použitou instanci funkčního bloku fb_iDimmer se do souboru „iFox-trot.pub“ (public soubor) automaticky generuje generuje sada proměnných, která sloužípro integraci s aplikací iFoxtrot.

Každá instance fb_iDimmer přidá následující public proměnné:Proměnná Typ Význam

R GTSAP1_LIGHT_name STRING Kopie vstupu name R GTSAP1_LIGHT_enable BOOLR GTSAP1_LIGHT_type BOOL Typ světla (1 = stmívané)R GTSAP1_LIGHT_dimtype BOOL Typ stmívače (0 = jedna barva)RW GTSAP1_LIGHT_onoff BOOL Vypínání a zapínání světla z iFoxtrot. RW GTSAP1_LIGHT_dimlevel REAL Úroveň stmívače (pouze při dimtype = 1)


V našem případě to pro instanci Dimmer2 bude vypadat následovně:

Main.Dimmer2.GTSAP1_LIGHT_name R B 727 STRING[24] PUB_INMain.Dimmer2.GTSAP1_LIGHT_enable R B 752 .0 BOOL PUB_INMain.Dimmer2.GTSAP1_LIGHT_type R B 752 .1 BOOL PUB_INMain.Dimmer2.GTSAP1_LIGHT_dimtype R B 752 .2 BOOL PUB_INMain.Dimmer2.GTSAP1_LIGHT_onoff R B 752 .3 BOOL PUB_INOUTMain.Dimmer2.GTSAP1_LIGHT_dimlevel R F 753 REAL PUB_INOUT ;YATUN_dimmer

kdeMain instance programu, kde je použit blok fb_iDimmerDimmer2 název bloku fb_iDimmer (jméno instance)GTSAP1_LIGHT_name název proměnné pro integraci bloku fb_iDimmer

14 TXV 003 59.01


6.4 Funkční blok fb_iDimmerLED Knihovna : iControlLib

Funkční blok fb_iDimmerLED je určen k řízení stmívaného LED světla v rozsahu0...100%.

Vstup lightOn slouží k rozsvícení světla na úroveň nastavenou parametremsetLevel. Světlo se rozsvítí plynule, rychlost rozsvícení určuje vstup offOnRamp. Ten ur-čuje čas potřebný k rozsvícení z minLevel (zapalovací úroveň) na úroveň určenou pomo-cí setLevel. Vstup lightOff se používá stejně ale k vypínání světla. Pomocí vstupů levelUpa levelDw lze nastavit aktuální hodnotu osvětlení. Tato hodnota se zároveň stává úrovnína na kterou se světlo bude rozsvěcet. Vstup lightToggle přepne světlo – pokud svítí takho zhasne a pokud je zhasnuté tak ho rozsvítí. Vstup minLevel určuje minimální úroveň,při které světlo ještě svítí. Proměnná SetRamp představuje čas nastavení úrovně z 0 na100% a určuje rychlost plynulé regulace okamžité úrovně svitu. Vstup timeLimit umožňujeomezit dobu svícení. Vstup webToggle funguje stejně jako lightToggle a slouží k zapínánía vypínání světla z web rozhraní (tuto proměnnou je třeba nastavit na TRUE v případě, žechceme přepnout světlo z web stránky). Proměnná lightReset slouží k centrálnímu vypnutíosvětlení. Vstupní řetězec name slouží k pojmenování bloku pro externí aplikaci.

Proměnná setLevel slouží k zapamatování poslední nastavené úrovně a měla bybýt založena v sekci VAR_GLOBAL RETAIN.

Výstupy level (0..100%) a ramp jsou určeny pro jeden kanál CIB modulu typuULED/ILED/RLC. Výstup out signalizuje, že je světlo zapnuté.

Světlo lze ovládat jak dvoutlačítkově pomocí vstupů lightOn a lightOff, tak jednotla-čítkově pomocí vstupů lightToggle resp. webToggle.

15 TXV 003 59.01




R_EDGENáběžná hrana zapne světlo na úroveň setLevel Rychlost rozsvícení určuje vstup cffOnRamp


lightOff BOOLR_EDGE

Náběžná hrana vypne světloRychlost zhasnutí určuje vstup cffOnRamp



Náběžná hrana přepne světlo. Rychlost rozsvícení/zhasnutí určuje vstup cffOnRamp

minLevel REAL Minimální úroveň, ze které se zahájí rozsvícení světla [%] Přednastavená hodnota 10%

cffOnRamp TIME Doba, za kterou se světlo rozsvítí z minLevel na 100% pro zapnutí a vypnutí světla [sec]Přednastavená hodnota 5 sec

setRamp TIME Doba, za kterou se světlo rozsvítí z minLevel na 100% pro změnu požadované úrovně [sec]Přednastavená hodnota 8 sec

timeLimit TIME Omezení doby svícení


Omezení doby svíceníPři T#0s není doba omezena





level REAL Aktuální hodnota pro řízení světla [0...100%]

Ramp USINT Aktuální pracovní rampa pro řízení světla [sec]

minLev REAL minimální úroveň 0..90 [%]

VAR_IN_OUTsetLevel REAL Požadovaná úroveň, na kterou se má světlo rozsvítit

[0...100%] umístit do VAR_GLOBAL RETAIN.

16 TXV 003 59.01


Předpokládejme, že potřebujeme řídit stmívané LED světlo připojené na výstupCIB modulu C-DM-0006M-ULED. Světlo budeme ovládat nástěnným ovladačem C-WS-0200R-Logus se dvěma tlačítky. V jazyce ST bude program vypadat následovně:

VAR_GLOBAL RETAIN dimmerLEDlevel : REAL;END_VARVAR_GLOBAL central_OFF : BOOL;END_VARPROGRAM prgMain VAR DimmerLED : fb_iDimmerLED; GoOut : fb_iAction; END_VAR // akce centralniho zhasnuti GoOut( action := r0_p3_DI.DI0, out => central_OFF); // stmivac ovladany CIB modulem C-WS-0200R-Logus DimmerLED( lightOn := MI_CIB1_IN.ID1_IN.DI.CLICK_UP1, levelUp := MI_CIB1_IN.ID1_IN.DI.PRESS_UP1, lightOff := MI_CIB1_IN.ID1_IN.DI.CLICK_DOWN1, levelDw := MI_CIB1_IN.ID1_IN.DI.PRESS_DOWN1, minLevel := 20.0, offOnRamp := T#6s, setRamp := T#10s, timeLimit := T#12h, lightReset := central_OFF, name :='kitchen LED', setLevel := dimmerLEDlevel, level => MI_CIB1_OUT.ID2_OUT.LEDa.LED1, ramp => MI_CIB1_OUT.ID2_OUT.LEDa.ramp1);END_PROGRAM

Světlo je zapínáno a vypínáno krátkými stisky tlačítek modulu C-WS-0200R-Logus.Dlouhé stisky těchto tlačítek nastavují požadovanou úroveň. Minimální úroveň pro roz-svícení světla je 20% a světlo se z této úrovně rozsvítí na 100% za 6 sec. Maximálnídoba, po kterou bude světlo nepřetržitě svítit je omezena na 12 hodin. Stejnou funkci lzenaprogramovat v jazyce CFC například následovně:

17 TXV 003 59.01



Pro každou použitou instanci funkčního bloku fb_iDimmerLED se do souboru „iFox-trot.pub“ (public soubor) automaticky generuje generuje sada proměnných, která sloužípro integraci s aplikací iFoxtrot.

Každá instance fb_iDimmerLED přidá následující public proměnné:Proměnná Typ Význam

R GTSAP1_LIGHT_name STRING Kopie vstupu name R GTSAP1_LIGHT_enable BOOLR GTSAP1_LIGHT_type BOOL Typ světla (1 = stmívané)R GTSAP1_LIGHT_dimtype BOOL Typ stmívače (0 = jedna barva)RW GTSAP1_LIGHT_onoff BOOL Vypínání a zapínání světla z iFoxtrot. RW GTSAP1_LIGHT_dimlevel REAL Úroveň stmívače (pouze při dimtype = 1)


V našem případě to pro instanci DimmerLED bude vypadat následovně:

Main.DimmerLED.GTSAP1_LIGHT_name R B 901 STRING[24] PUB_INMain.DimmerLED.GTSAP1_LIGHT_enable R B 926 .0 BOOL PUB_INMain.DimmerLED.GTSAP1_LIGHT_type R B 926 .1 BOOL PUB_INMain.DimmerLED.GTSAP1_LIGHT_dimtype R B 926 .2 BOOL PUB_INMain.DimmerLED.GTSAP1_LIGHT_onoff R B 926 .3 BOOL PUB_INOUTMain.DimmerLED.GTSAP1_LIGHT_dimlevel R F 927 REAL PUB_INOUT

kdeMain instance programu, kde je použit blok fb_iDimmerLEDDimmerLED název bloku fb_iDimmerLED (jméno instance)GTSAP1_LIGHT_name název proměnné pro integraci bloku fb_iDimmerLED

18 TXV 003 59.01


6.5 Funkční blok fb_iDimmerRGBKnihovna : iControlLib

Funkční blok fb_iDimmerRGB je určen k řízení stmívaného RGB světla v rozsahu0...100%. Výstup bloku je vhodný pro řízení světla CIB modulem ULED/ILED.

Vstup lightOn slouží k rozsvícení světla na úroveň nastavenou parametremsetLevel. Světlo se rozsvítí plynule, rychlost rozsvícení určuje vstup offOnRamp. Ten ur-čuje čas potřebný k rozsvícení na úroveň určenou pomocí setLevel. Vstup lightOff se pou-žívá stejně ale k vypínání světla. Pomocí vstupů levelUp a levelDw lze nastavit aktuálníhodnotu osvětlení. Tato hodnota se zároveň stává úrovní na na kterou se světlo bude roz-svěcet. Vstup lightToggle přepne světlo – pokud svítí tak ho zhasne a pokud je zhasnutétak ho rozsvítí. Vstup minLevel určuje minimální úroveň, při které světlo ještě svítí.VstupsetRamp představuje čas nastavení úrovně z 0 na 100%, určuje rychlost plynulé regulaceokamžité úrovně svitu. Vstup timeLimit umožňuje omezit dobu svícení. Vstup webTogglefunguje stejně jako lightToggle a slouží k zapínání a vypínání světla z web rozhraní (tutoproměnnou je třeba nastavit na TRUE v případě, že chceme přepnout světlo z webstránky). Vstup lightReset slouží k centrálnímu vypnutí osvětlení. Vstupní řetězec nameslouží k pojmenování bloku pro aplikaci iFoxtrot.

Proměnná setLight slouží k zapamatování poslední nastavené úrovně a barvy svět-la a měla by být založena v sekci VAR_GLOBAL RETAIN.

Výstupy levelRed(Geen,Blue) 0..100% a rampRed(Geen,Blue) – slouží pro připo-jení k CIB modulu ULED/ILED. Výstup out signalizuje, že je světlo zapnuté. Světlo lzeovládat jak dvoutlačítkově pomocí vstupů lightOn a lightOff, tak jednotlačítkově pomocívstupu lightToggle.

19 TXV 003 59.01




R_EDGENáběžná hrana zapne světlo na úroveň setLevel Rychlost rozsvícení určuje vstup cffOnRamp


lightOff BOOLR_EDGE

Náběžná hrana vypne světloRychlost zhasnutí určuje vstup cffOnRamp



Náběžná hrana přepne světlo. Rychlost rozsvícení/zhasnutí určuje vstup cffOnRamp

offOnRamp TIME Doba, za kterou se světlo rozsvítí z 0 na 100% pro za-pnutí a vypnutí světla [sec]Přednastavená hodnota 5 sec

setRamp TIME Doba, za kterou se světlo rozsvítí z minLevel na 100% pro změnu požadované úrovně [sec]Přednastavená hodnota 8 sec

timeLimit TIME Omezení doby svícení


Přepínání světla z webu





levelRed REAL Aktuální hodnota pro řízení červené barvy [0...100%]

levelGreen REAL Aktuální hodnota pro řízení zelené barvy [0...100%]

levelBlue REAL Aktuální hodnota pro řízení modré barvy [0...100%]

rampRed USINT Aktuální pracovní rampa pro řízení červené barvy

rampGreen USINT Aktuální pracovní rampa pro řízení zelené barvy

rampBlue USINT Aktuální pracovní rampa pro řízení modré barvy

20 TXV 003 59.01


VAR_IN_OUTSetLight

.level

.RGB

T_SET_RGB_LIGHT

Parametry pro rozsvícení světla (umístit do VAR_GLOBAL RETAIN)

Úroveň, na kterou se má světlo rozsvítit [0...100%]Struktura pro zadání barvy světla (red, green, blue)

Předpokládejme, že potřebujeme řídit stmívané RGB světlo CIB modulem C-DM-0006M-ULED. Světlo budeme ovládat nástěnným ovladačem C-WS-0200R-Logus, kterýje vybaven dvěma tlačítky. V jazyce ST bude program vypadat následovně:

VAR_GLOBAL RETAIN dimmerRGBset : T_SET_RGB_LIGHT;END_VARVAR_GLOBAL central_OFF : BOOL;END_VARPROGRAM prgMain VAR DimmerRGB : fb_iDimmerRGB; GoOut : fb_iAction; END_VAR // nastaveni barvy R=255 G=255 B=255 bila; R=255,G=30, B=80 magenta; ... dimmerRGBset.RGB.red := 255; dimmerRGBset.RGB.green := 255; dimmerRGBset.RGB.blue := 255; // akce centralniho zhasnuti GoOut( action := r0_p3_DI.DI0, out => central_OFF); // stmivac ovladany CIB modulem C-WS-0200R-Logus DimmerRGB(lightOn := MI_CIB1_IN.ID1_IN.DI.CLICK_UP1, levelUp := MI_CIB1_IN.ID1_IN.DI.PRESS_UP1, lightOff := MI_CIB1_IN.ID1_IN.DI.CLICK_DOWN1, levelDw := MI_CIB1_IN.ID1_IN.DI.PRESS_DOWN1, offOnRamp := T#6s, setRamp := T#10s, timeLimit := T#12h, lightReset := central_OFF, name := 'RGB light', setLight := dimmerRGBset, levelRed => MI_CIB1_OUT.ID2_OUT.LEDb.LED4,

levelGreen => MI_CIB1_OUT.ID2_OUT.LEDb.LED5,levelBlue => MI_CIB1_OUT.ID2_OUT.LEDb.LED6,

rampRed => MI_CIB1_OUT.ID2_OUT.LEDb.ramp4,rampGreen => MI_CIB1_OUT.ID2_OUT.LEDb.ramp5,rampBlue => MI_CIB1_OUT.ID2_OUT.LEDb.ramp6);

END_PROGRAM

Světlo je zapínáno a vypínáno krátkými stisky tlačítek modulu C-WS-0200R-Logus.Dlouhé stisky těchto tlačítek nastavují požadovanou úroveň jasu. Z úrovně 0% se rozsvítína 100% za 6 sec. Maximální doba, po kterou bude světlo nepřetržitě svítit je omezena na12 hodin. Stejnou funkci lze naprogramovat v jazyce CFC například následovně:

21 TXV 003 59.01



Pro každou použitou instanci funkčního bloku fb_iDimmerRGB se do souboru „iFo-xtrot.pub“ (public soubor) automaticky generuje generuje sada proměnných, která sloužípro integraci s aplikací iFoxtrot.

Každá instance fb_iDimmerRGB přidá následující public proměnné:Proměnná Typ Význam

R GTSAP1_LIGHT_name STRING Kopie vstupu name R GTSAP1_LIGHT_enable BOOLR GTSAP1_LIGHT_type BOOL Typ světla (1 = stmívané)R GTSAP1_LIGHT_dimtype BOOL Typ stmívače (1 = RGB)RW GTSAP1_LIGHT_onoff BOOL Vypínání a zapínání světla z iFoxtrot. RW GTSAP1_LIGHT_dimlevel REAL Úroveň stmívače [0...100%]RW GTSAP1_LIGHT_rgb STRUCT Barva světla


V našem případě to pro instanci DimmerRGB bude vypadat následovně:

Main.DimmerRGB.GTSAP1_LIGHT_name R B 1027 STRING[24] PUB_INMain.DimmerRGB.GTSAP1_LIGHT_enable R B 1052 .0 BOOL PUB_INMain.DimmerRGB.GTSAP1_LIGHT_type R B 1052 .1 BOOL PUB_INMain.DimmerRGB.GTSAP1_LIGHT_dimtype R B 1052 .2 BOOL PUB_INMain.DimmerRGB.GTSAP1_LIGHT_onoff R B 1052 .3 BOOL PUB_INOUTMain.DimmerRGB.GTSAP1_LIGHT_dimlevel R F 1053 REAL PUB_INOUTMain.DimmerRGB.GTSAP1_LIGHT_rgb R L 1057 UDINT PUB_INOUT

kdeMain instance programu, kde je použit blok fb_iDimmerRGBDimmerRGB název bloku fb_iDimmerRGB (jméno instance)GTSAP1_LIGHT_name název proměnné pro integraci bloku fb_iDimmerRGB

22 TXV 003 59.01


6.6 Funkční blok fb_iDisplay_OnOffKnihovna : iControlLib

Funkční blok fb_iDisplay_OnOff je určen k zobrazení BOOL hodnoty v aplikaci iFo-xtrot. Zobrazovaná hodnota je daná vstupem value. Pokud má vstup value hodnotuTRUE, pak bude zobrazena ikona daná vstupem symbolOn. Pokud má vstup valuehodnotu FALSE, pak bude zobrazena ikona daná vstupem symbolOff. Vstupní řetězecname slouží k pojmenování bloku pro aplikaci iFoxtrot.

Definice ikonUživatelsky definované ikony začínají hodnotou 10000. Pokud je například sym-

bolOn := 10000 tak aplikace při value = TRUE zobrazí ikonu danou obrázkem s názvem10000.png, který musí být uložen v adresáři WWW/iFOX/ na SD kartě v PLC systému.Pokud soubor 10000.png uložíme v projektu Mosaicu do složky SendRoot\WWW\iFOX\pak se soubor automaticky uloží na SD kartu v PLC při prvním odeslání přeloženéhoprogramu do PLC.

Výstup out kopíruje hodnotu value.


VAR_INPUTvalue BOOL Zobrazovaná hodnota

symbolOn UINT Ikona, která bude zobrazena při value = TRUE

symbolOff UINT Ikona, která bude zobrazena při value = FALSE


VAR_OUTPUTout BOOL Kopíruje hodnotu na vstupu value

Předpokládejme, že chceme v aplikaci iFoxtrot signalizovat stav vstupních dveří(otevřené / zavřené). Dveřní kontakt bude připojen na digitální vstup PLC systému. V jazy-ce ST bude program vypadat následovně:

23 TXV 003 59.01


PROGRAM prgMain VAR Display1 : fb_iDisplay_OnOff; END_VAR VAR CONSTANT APP_ICON_DOOR_OPEN : UINT := 10000; // tato ikona se nacte z PLC // WWW/iFOX/10000.png APP_ICON_DOOR_CLOSE : UINT := 10001; // tato ikona se nacte z PLC // WWW/iFOX/10001.png END_VAR Display1( value := r0_p3_DI.DI5, symbolOn := APP_ICON_DOOR_CLOSE, symbolOff := APP_ICON_DOOR_OPEN, name := 'Vstupní dveře');END_PROGRAM

Stejnou funkci lze naprogramovat v jazyce CFC například následovně:


Pro každou použitou instanci funkčního bloku fb_iDisplay_OnOff se do souboru„iFoxtrot.pub“ (public soubor) automaticky generuje generuje sada proměnných, kteráslouží pro integraci s aplikací iFoxtrot.

Každá instance fb_iDisplay_OnOff přidá následující public proměnné:Proměnná Typ Význam

R GTSAP1_DISPLAY_name STRING Kopie vstupu name R GTSAP1_DISPLAY_enable BOOLR GTSAP1_DISPLAY_edit BOOL Povolení editace (0 = editace zakázaná)R GTSAP1_DISPLAY_type USINT Typ zobrazení (0 = BOOL)R GTSAP1_DISPLAY_symbol UINT Aktuální kód symboluR GTSAP1_DISPLAY_onOff BOOL Zobrazovaná BOOL hodnota


V našem případě to pro instanci Display1 bude vypadat následovně:

Main.Display1.GTSAP1_DISPLAY_name R B 2040 STRING[24] PUB_IN Main.Display1.GTSAP1_DISPLAY_enable R B 2065 .0 BOOL PUB_INMain.Display1.GTSAP1_DISPLAY_edit R B 2065 .1 BOOL PUB_INMain.Display1.GTSAP1_DISPLAY_type R B 2066 USINT PUB_IN

24 TXV 003 59.01


Main.Display1.GTSAP1_DISPLAY_symbol R W 2067 UINT PUB_INMain.Display1.GTSAP1_DISPLAY_onOff R B 2069 .0 BOOL PUB_IN

kdeMain instance programu, kde je blok fb_iDisplay_OnOffDisplay1 název bloku fb_iDisplay_OnOff (jméno instance)GTSAP1_DISPLAY_name název proměnné pro integraci bloku fb_iDisplay_OnOff

25 TXV 003 59.01


6.7 Funkční blok fb_iDisplay_ValKnihovna : iControlLib

Funkční blok fb_iDisplay_Val je určen k zobrazení REAL hodnoty v aplikaci iFox-trot. Zobrazovaná hodnota je daná vstupem value. Vstup precision udává kolik dese-tinných míst bude zobrazeno. Vstup unit umožňuje specifikovat fyzikální jednotku (např.°C, mA, atd.). Vstupem link lze zadat vazbu na konkrétní web stránku v PLC. Prvek disp-leje v aplikaci iFoxtrot pak nabídne možnost zobrazení této web stránky v aplikaci.

Vstup symbol udává ikonu, která bude zobrazena v aplikaci u zobrazené hodnoty.Pokud má hodnotu 0, pak bude zobrazeno výchozí ikona pro displej. Vstupní řetězecname slouží k pojmenování bloku pro aplikaci iFoxtrot.





VAR_INPUTvalue REAL Zobrazená hodnota

unit STRING[8] Fyzikální jednotka zobrazené hodnoty

precision INT Počet zobrazených desetinných míst

link STRING Odkaz na web stránku v PLC s doplňujícími informace-mi (nepovinný)

symbol UINT Kód ikony zobrazené v aplikaci iFoxtrot


26 TXV 003 59.01



Předpokládejme, že chceme v aplikaci iFoxtrot zobrazit venkovní teplotu měřenouvstupem r0_p3_AI0.ENG. Teplota bude zobrazená na jedno desetinné místo, jednotkybudou °C. V jazyce ST bude program vypadat následovně:

PROGRAM prgMain VAR Display2 : fb_iDisplay_Val; END_VAR VAR CONSTANT APP_ICON_OUTSIDE_TEMP : UINT := 10002; // tato ikona se nacte z PLC // WWW/iFOX/10002.png END_VAR Display2( value := r0_p3_AI0.ENG, unit := '°C', precision := 1, symbol := APP_ICON_OUTSIDE_TEMP, name := 'Venkovní teplota');END_PROGRAM



Pro každou použitou instanci funkčního bloku fb_iDisplay_Val se do souboru „iFox-trot.pub“ (public soubor) automaticky generuje generuje sada proměnných, která sloužípro integraci s aplikací iFoxtrot.


R GTSAP1_DISPLAY_name STRING Kopie vstupu name R GTSAP1_DISPLAY_enable BOOLR GTSAP1_DISPLAY_edit BOOL Povolení editace (0 = editace za-

kázaná)R GTSAP1_DISPLAY_type USINT Typ zobrazení (1 = REAL)

27 TXV 003 59.01


Proměnná Typ VýznamR GTSAP1_DISPLAY_symbol UINT Aktuální kód symboluR GTSAP1_DISPLAY_value REAL Zobrazovaná REAL hodnotaR GTSAP1_DISPLAY_unit STRING[

8]Fyzikální jednotka zobrazené hodnoty

R GTSAP1_DISPLAY_precision INT Počet zobrazených desetinných místR GTSAP1_DISPLAY_url STRING Odkaz na web stránku



Test.Display2.GTSAP1_DISPLAY_name R B 2277 STRING[24] PUB_INTest.Display2.GTSAP1_DISPLAY_enable R B 2302 .0 BOOL PUB_INTest.Display2.GTSAP1_DISPLAY_edit R B 2302 .1 BOOL PUB_INTest.Display2.GTSAP1_DISPLAY_type R B 2303 USINT PUB_INTest.Display2.GTSAP1_DISPLAY_symbol R W 2304 UINT PUB_INTest.Display2.GTSAP1_DISPLAY_value R F 2306 REAL PUB_INTest.Display2.GTSAP1_DISPLAY_unit R B 2310 STRING[8] PUB_INTest.Display2.GTSAP1_DISPLAY_precision R W 2319 INT PUB_INTest.Display2.GTSAP1_DISPLAY_url R B 2321 STRING[80] PUB_IN

kdeMain instance programu, kde je blok fb_iDisplay_ValDisplay2 název bloku fb_iDisplay_Val (jméno instance)GTSAP1_DISPLAY_name název proměnné pro integraci bloku fb_iDisplay_Val

28 TXV 003 59.01


6.8 Funkční blok fb_iDisplay_EditKnihovna : iControlLib

Funkční blok fb_iDisplay_Edit je určen k zobrazení a editaci REAL hodnoty vaplikaci iFoxtrot. Zobrazovaná hodnota je daná vstupem value. Vstup precision udává ko-lik desetinných míst bude zobrazeno. Vstup unit umožňuje specifikovat fyzikální jednotku(např. °C, mA, atd.). Vstupy limitUp a limitDw určují horní a dolní mez, mezi kterými jemožné hodnotu editovat, vstup step udává přírůstek o který bude hodnota zvýšena resp.snížena v každém kroku. Vstupy webUp a webDw umožňují editovat zobrazenou hodnotuz web stránky v PLC. Zápis hodnoty TRUE do těchto proměnných zvýší resp. sníží zob-razenou hodnotu o přírůstek daný vstupem step.

Vstupem link lze zadat vazbu na konkrétní web stránku v PLC. Prvek displeje vaplikaci iFoxtrot pak nabídne možnost zobrazení této web stránky v aplikaci.

Vstup symbol udává ikonu, která bude zobrazena v aplikaci u zobrazené hodnoty.Pokud má hodnotu 0, pak bude zobrazeno výchozí ikona pro displej. Vstupní řetězecname slouží k pojmenování bloku pro aplikaci iFoxtrot.





VAR_INPUTunit STRING[8] Fyzikální jednotka zobrazené hodnoty

29 TXV 003 59.01


precision INT Počet zobrazených desetinných míst

limitUp REAL Horní mez pro edici hodnoty

limitDw REAL Spodní mez pro edici hodnoty

step REAL Přírůstek pro edici hodnoty

webUp BOOL Žádost o zvýšení hodnoty o přírůstek (určeno pro ovládání z web stránky)

webDw BOOL Žádost o snížení hodnoty o přírůstek(určeno pro ovládání z web stránky)

link STRING Odkaz na web stránku v PLC s doplňujícími informace-mi (nepovinný)




VAR_IN_OUTvalue REAL Editovaná hodnota

Předpokládejme, že chceme v aplikaci iFoxtrot umožnit nastavení žádané hodnotyteploty pro topení. Teplota bude zobrazená na jedno desetinné místo, jednotky budou °C.V jazyce ST bude program vypadat následovně:

VAR_GLOBAL RETAIN setPoint : REAL := 22.5;END_VARPROGRAM prgMain15 VAR Display3 : fb_iDisplay_Edit; END_VAR VAR CONSTANT APP_ICON_SET_POINT : UINT := 10003; // tato ikona se nacte z PLC // WWW/iFOX/10003.png END_VAR Display3( unit := '°C', precision := 1, limitUp := 33.0, limitDw := 2.0, step := 0.5, symbol := APP_ICON_SET_POINT, name := 'Žádaná hodnota', value := setPoint);END_PROGRAM

30 TXV 003 59.01


Žádanou hodnotu bude možné editovat v mezích . Přírůstek na jedenkrok bude 0.5. Stejnou funkci lze naprogramovat v jazyce CFC například následovně:


Pro každou použitou instanci funkčního bloku fb_iDisplay_Edit se do souboru „iFo-xtrot.pub“ (public soubor) automaticky generuje generuje sada proměnných, která sloužípro integraci s aplikací iFoxtrot.



kázaná)R GTSAP1_DISPLAY_type USINT Typ zobrazení (1 = REAL)R GTSAP1_DISPLAY_symbol UINT Aktuální kód symboluR GTSAP1_DISPLAY_value REAL Zobrazovaná REAL hodnotaR GTSAP1_DISPLAY_unit STRING[8] Fyzikální jednotka zobrazené

hodnotyR GTSAP1_DISPLAY_precision INT Počet zobrazených desetinných místR GTSAP1_DISPLAY_url STRING Odkaz na web stránkuW GTSAP1_DISPLAY_incValue BOOL Zvýšení hodnoty o přírůstekW GTSAP1_DISPLAY_decValue BOOL Snížení hodnoty o přírůstek



Test.Display3.GTSAP1_DISPLAY_name R B 2542 STRING[24] PUB_IN

31 TXV 003 59.01


Test.Display3.GTSAP1_DISPLAY_enable R B 2567 .0 BOOL PUB_INTest.Display3.GTSAP1_DISPLAY_edit R B 2567 .1 BOOL PUB_INTest.Display3.GTSAP1_DISPLAY_type R B 2568 USINT PUB_INTest.Display3.GTSAP1_DISPLAY_symbol R W 2569 UINT PUB_INTest.Display3.GTSAP1_DISPLAY_value R F 2571 REAL PUB_INTest.Display3.GTSAP1_DISPLAY_unit R B 2575 STRING[8] PUB_INTest.Display3.GTSAP1_DISPLAY_precision R W 2584 INT PUB_INTest.Display3.GTSAP1_DISPLAY_url R B 2586 STRING[80] PUB_INTest.Display3.GTSAP1_DISPLAY_incValue R B 2667 .0 BOOL PUB_OUTTest.Display3.GTSAP1_DISPLAY_decValue R B 2667 .1 BOOL PUB_OUT

kdeMain instance programu, kde je blok fb_iDisplay_EditDisplay3 název bloku fb_iDisplay_Edit (jméno instance)GTSAP1_DISPLAY_name název proměnné pro integraci bloku fb_iDisplay_Edit

6.9 Funkční blok fb_JalAlarmKnihovna : iControlLib

Funkční blok fb_JalAlarm slouží k vyhodnocení poplachů pro žaluzie. Používá sejako předřadný blok pro fb_iJalousie, což je funkční blok na ovládání žaluzií. Informace opoplachu se připojuje na některý z následujících vstupů:

• fire požární poplach (nejvyšší priorita)• ice námraza• wind velký vítr• glass rozbité sklo (nejnižší priorita)

Pokud je některý z uvedených vstupů nastaven na hodnotu TRUE, funkční blokfb_JalAlarm ovládá svoje výstupy následovně: požární poplach (fire) vytáhne žaluzie a za-blokuje vstupy pro ovládání žaluzie, poplach námrazy (ice) zastaví případný pohyb žaluziea zablokuje vstupy pro ovládání žaluzie, poplach překročení rychlosti větru (wind) vytáhnežaluzie a zablokuje vstupy pro ovládání žaluzie a poplach rozbití skla (glass) zavře žalu-zie. Poplach je aktivní po celou dobu, kdy je na příslušný vstup přivedena hodnota TRUE.Deaktivovat poplach lze pouze nastavením vstupu na FALSE nebo aktivací poplachu svyšší prioritou.

32 TXV 003 59.01


Další vstupy slouží k centrálnímu ovládání a mají následující význam:• blockJal blokuje ovládací vstupy připojené žaluzie• stopJal zastaví pohyb připojené žaluzie• ctrUp centrální otevření žaluzií• ctrDw centrální zavření žaluzií

Vstupy centrálního ovládání mají nižší prioritu než poplachové vstupy.

Výstupy fb_JalAlarm se připojují na stejnojmenné vstupy bloku fb_iJalousie.

33 TXV 003 59.01



VAR_INPUTfire BOOL Poplach „oheň“: vytáhne žaluzie a blokuje vstupy

ice BOOL Poplach „námraza“: zastaví pohyb a blokuje vstupy

wind BOOL Poplach „vítr“: vytáhne žaluzie a blokuje vstupy

glass BOOL Poplach „sklo“: zavře žaluzie

blockJal BOOL Blokování ovládacích vstupů připojené žaluzie

stopJal BOOLR_EDGE

Zastavení pohybu žaluzie

ctrUpJal BOOLR_EDGE

Centrální otevření žaluzií

ctrDwJal BOOLR_EDGE

Centrální zavření žaluzií

VAR_OUTPUTblock BOOL Propojit se vstupem „fb_iJalousie.block“

stop BOOL Propojit se vstupem „fb_iJalousie.stop“

ctrUp BOOL Propojit se vstupem „fb_iJalousie.ctrUp“

ctrDw BOOL Propojit se vstupem „fb_iJalousie.ctrDwI“

Příklad propojení fb_JalAlarm s blokem fb_iJalousie vytvořený v jazyce ST. Proovládání fb_Jalousie je použit nástěnný ovladač C-WS-0200R-Logus. Pro spínání pohonužaluzie je použit CIB modul reléových výstupů C-OR-0202B. Předpokládáme že samotnéaktivační signály poplachů jsou vyřešeny v programu.

PROGRAM prgMain5 VAR Jalousie1 : fb_iJalousie; Alarm1 : fb_JalAlarm; fire : bool; ice : bool; wind : bool; glass : bool; blocking : bool; stop : bool; centralUp : bool; centralDown : bool; END_VAR

34 TXV 003 59.01

http://www.tecomat.com/clanek-1090-c-or-0202b-modul-releovych-vystupu-16a.htmlhttp://www.tecomat.com/clanek-1090-c-or-0202b-modul-releovych-vystupu-16a.htmlhttp://www.tecomat.com/clanek-1090-c-or-0202b-modul-releovych-vystupu-16a.htmlhttp://www.tecomat.com/clanek-1090-c-or-0202b-modul-releovych-vystupu-16a.htmlhttp://www.tecomat.com/clanek-1090-c-or-0202b-modul-releovych-vystupu-16a.html


// vyhodnoceni alarmu Alarm1 (fire := fire, ice := ice, wind := wind, glass := glass, blockJal := blocking, stopJal := stop, ctrUpJal := centralUp, ctrDwJal := centralDown); // ovladani zaluzii Jalousie1 (rotUp := MI_CIB1_IN.ID1_IN.DI.CLICK_UP1, up := MI_CIB1_IN.ID1_IN.DI.PRESS_UP1, rotDw := MI_CIB1_IN.ID1_IN.DI.CLICK_DOWN1, dw := MI_CIB1_IN.ID1_IN.DI.PRESS_DOWN1, block := Alarm1.block, stop := Alarm1.stop, ctrUp := Alarm1.ctrUp, ctrDw := Alarm1.ctrDw, upDwTime := T#20s, rotTime := T#0.5s, pauseTime := T#0.5s, ctrTime := T#5s,

name := 'blind1', outUp => MI_CIB1_OUT.ID4_OUT.DOs.DO1, outDw => MI_CIB1_OUT.ID4_OUT.DOs.DO2);END_PROGRAM

Žaluzie jsou ovládány dlouhými a krátkými stisky tlačítka a zároveň signály z blokualarmů. Tlačítko UP1 ovládá pohyb vzhůru a tlačítko DOWN1 pohyb dolu. Krátký stisk tla-čítka aktivuje pootočení o časový krok 500ms. Dlouhý stisk aktivuje kompletní vytaženínebo otevření žaluzie podle aktivovaného tlačítka. Stejnou funkci lze v jazyce CFC napro-gramovat například následovně:

35 TXV 003 59.01


Stejný blok alarmů lze použít k ovládání většího počtu žaluzií. Je doporučenojedním blokem fb_iJalAlarm ovládat více žaluzií pouze v rámci jedné místnosti. Příklad vCFC:

Žaluzie jsou ovládány CIB modulem tlačítek C-WS-0400R-Logus a každou žaluziispíná vlastní CIB modul reléových výstupů C-OR-0202B. Funkce poplachu a vstupy blo-ck, stop, ctrUp a ctrDw jsou společné.

36 TXV 003 59.01



6.10 Funkční blok fb_iJalousieKnihovna : iControlLib

Funkční blok fb_iJalousie slouží k ovládání žaluzií bez zpětné vazby aktuální pozi-ce. Je schopen žaluzii posunout o přednastavený krok, sloužící k překlopení lamel, neboaktivovat kompletní vytažení/zavření stínidla. Dále dokáže pracovat s prodlevou proreverzaci směru pohybu použitého motoru.

Vstup rotUp slouží k posunu stínidla směrem vzhůru o jeden krok zatímco vstup upspouští kompletní vytažení žaluzie. Vstup rotDw aktivuje krok směrem dolů a dw komplet-ní zavření stínidla. Započatý kompletní pohyb lze přerušit aktivací jednoho z vstupů vyvo-lání pohybu ( rotUp, up, rotDw, dw) stejně tak jako pomocí aktivace z web rozhraní, jednéz proměnných určené pro iFoxtrot nebo vstupu stop. Vstup block = 1 zablokuje ovládacírozhraní daného bloku po dobu přítomnosti „1“. Vstupy ctrUp a ctrDw slouží pro připojenícentrálního ovládání všech žaluzií. Z důvodu omezení proudového rázu je funkční blok vy-baven vstupem ctrTime který slouží pro zadání zpoždění rozběhu pří aktivaci centrálníhovytažení/spuštění. Zadáním různých hodnot se velikost proudového rázu omezí. VstupywebUp a webDw fungují stejně jako up a dw a jsou určeny pro ovládání z web stránky.Pojmenování bloku pomocí proměnné name je určeno pro rozeznání bloku v aplikaci iFo-xtrot.

Výstup outUp slouží k spínání relé pro směr vzhůru. Výstup outDw slouží k spínánírelé pro směr dolů. Výstup sig funguje jako detekce pohybu stínidla. Výstup sigUp je na-staven na TRUE po kompletním pohybu vzhůru . Výstup sigDw je nastaven na TRUE pokompletním pohybu dolů.

37 TXV 003 59.01


Proměnná Typ Význam

38 TXV 003 59.01


VAR_INPUTrotUp BOOL

R_EDGEPootočit lamely o krok vzhůru

up BOOLR_EDGE

Kompletní pohyb vzhůru

rotDw BOOLR_EDGE

Pootočit lamely o krok dolů

dw BOOLR_EDGE

Kompletní pohyb dolů

block BOOL Blokace vstupů bloku

stop BOOLR_EDGE

Zastavení pohybu

ctrUp BOOLR_EDGE

Centrální pohyb vzhůru

ctrDw BOOLR_EDGE

Centrální pohyb dolů

webUp BOOLR_EDGE

Aktivace "Kompletní pohyb vzhůru" z web rozhraní

webDw BOOLR_EDGE

Aktivace "Kompletní pohyb dolů" z web rozhraní

upDwTime TIME Čas pro kompletní pohyb

rotTime TIME Délka kroku [sec]

pauseTime TIME Prodleva pro reverzaci pohybu[sec]

ctrTime TIME Zpoždění pohybu centrální aktivace [sec]

name STRING[24] Jméno žaluzie[sec]

VAR_OUTPUToutUp BOOL Žaluzie nahoru

outDw BOOL Žaluzie dolů

sig BOOL Signalizace chodu

sigUp BOOL Signalizace žaluzie nahoře

sigDw BOOL Signalizace žaluzie dole

39 TXV 003 59.01


Použití funkčního bloku pro žaluzie připojené k CIB modul reléových výstupů C-OR-0202B. Pro jejich ovládání použijeme tlačítkový CIB modul C-WS-0200R-Logus Vý-robcem udaná prodleva pro reverzaci je 0.5 sec a naměřená doba kompletního pojezdu je20 sec.

PROGRAM prgMainVAR Jalousie3 : fb_iJalousie; blocking : bool; stop : bool; centralUp : bool; centralDown : bool;END_VAR //jednoduche ovladani zaluzii Jalousie3(rotUp := MI_CIB1_IN.ID1_IN.DI.CLICK_UP1, up := MI_CIB1_IN.ID1_IN.DI.PRESS_UP1, rotDw := MI_CIB1_IN.ID1_IN.DI.CLICK_DOWN1, dw := MI_CIB1_IN.ID1_IN.DI.PRESS_DOWN1, block := blocking, stop := stop, ctrUp := centralUp, ctrDw := centralDown, upDwTime := T#20s, rotTime := T#0.5s, pauseTime := T#0.5s, name := 'zaluzie1', outUp => MI_CIB1_OUT.ID4_OUT.DOs.DO1, outDw => MI_CIB1_OUT.ID4_OUT.DOs.DO2);END_PROGRAM

Krátký stisk tlačítka up aktivuje pootočení o krok směrem vzhůru. Dlouhý stisk tlačí-tka up aktivuje kompletní pohyb směrem vzhůru. Tlačítko down funguje obdobně alemísto aktivace pohybu vzhůru aktivuje pohyb dolů. Stejný program vytvořen v jazyce CFCvypadá následně:


40 TXV 003 59.01



Pro každou použitou instanci funkčního bloku fb_iJalousie se do souboru „iFox-trot.pub“ (public soubor) automaticky generuje generuje sada proměnných, která sloužípro integraci s aplikací iFoxtrot.

Každá instance fb_iJalousie přidá následující public proměnné:Proměnná Typ Význam

R GTSAP1_SHUTTER_name STRING Kopie vstupu name R GTSAP1_SHUTTER_enable BOOLR GTSAP1_SHUTTER_up BOOL Žaluzie se pohybuje nahoru R GTSAP1_SHUTTER_down BOOL Žaluzie se pohybuje dolůR GTSAP1_SHUTTER_run BOOL Žaluzie v pohybuR GTSAP1_SHUTTER_uppos BOOL Žaluzie nahořeR GTSAP1_SHUTTER_downpos BOOL Žaluzie doleW GTSAP1_SHUTTER_up_control BOOL Vyvolání pohybu nahoruW GTSAP1_SHUTTER_down_control BOOL Vyvolání pohybu dolůW GTSAP1_SHUTTER_rotup_control BOOL Vyvolání kroku nahoruW GTSAP1_SHUTTER_rotdown_control BOOL Vyvolání kroku dolů


V našem případě to pro instanci Jalousie3 bude vypadat následovně:

Main.Jalousie3.GTSAP1_SHUTTER_name R B 1534 STRING[24] PUB_INMain.Jalousie3.GTSAP1_SHUTTER_enable R B 1559 .0 BOOL PUB_INMain.Jalousie3.GTSAP1_SHUTTER_up R B 1559 .1 BOOL PUB_INMain.Jalousie3.GTSAP1_SHUTTER_down R B 1559 .2 BOOL PUB_INMain.Jalousie3.GTSAP1_SHUTTER_run R B 1559 .3 BOOL PUB_IN Main.Jalousie3.GTSAP1_SHUTTER_uppos R B 1559 .4 BOOL PUB_INMain.Jalousie3.GTSAP1_SHUTTER_downpos R B 1559 .5 BOOL PUB_INMain.Jalousie3.GTSAP1_SHUTTER_up_control R B 1559 .6 BOOL PUB_OUTMain.Jalousie3.GTSAP1_SHUTTER_down_control R B 1559 .7 BOOL PUB_OUTMain.Jalousie3.GTSAP1_SHUTTER_rotup_control R B 1560 .0 BOOL PUB_OUTMain.Jalousie3.GTSAP1_SHUTTER_rotdown_control R B 1560 .1 BOOL PUB_OUT

kdeMain instance programu, kde je použit blok fb_iJalousieJalousie3 název bloku fb_iJalousie (jméno instance)GTSAP1_SHUTTER_name název proměnné pro integraci bloku fb_iJalousie

41 TXV 003 59.01


6.11 Funkční blok fb_iLightKnihovna : iControlLib

Funkční blok fb_iLight je určen k řízení světla pomocí tlačítek. Blok umožňuje jak 2-tlačítkové ovládání (pomocí vstupů lightOn a lightOff) tak 1-tlačítkové ovládání (pomocívstupu lightToggle).

Vstup lightOn zapíná světlo, vstup lightOff světlo vypíná. Vstup lightToggle přepínásvětlo – pokud svítí tak ho zhasne a pokud je zhasnuté tak ho rozsvítí. Vstup webTogglefunguje stejně jako lightToggle a slouží k zapínání a vypínání světla z web rozhraní (tutoproměnnou je třeba nastavit na TRUE v případě, že chceme přepnout světlo z webstránky). Vstup timeLimit umožňuje omezit dobu svícení. Pokud má hodnotu T#0s takdoba svícení není omezena. A konečně vstup lightReset slouží jako centrální vypnutívšech světel. Všechny vstupy typu BOOL reagují na náběžnou hranu vstupního signálu.

Výstup out slouží k ovládání světla.

Proměnná Typ VýznamVAR_INPUT

lightOn BOOLR_EDGE

Náběžná hrana zapne světlo

lightOff BOOLR_EDGE

Náběžná hrana vypne světlo


Náběžná hrana přepne světlo

timeLimit TIME Omezení doby svíceníPři T#0s není doba omezena


Ovládání světla z web stránky


Vstup pro centrální vypnutí světel (odchodové tlačít-ko)

name STRING[24] název světla

VAR_OUTPUTout BOOL Ovládání světla

42 TXV 003 59.01


Předpokládejme, že potřebujeme ovládat světlo připojené v PLC systému na bi-nární výstup DO0. Světlo budeme ovládat tlačítkem připojeným na binární vstup DI1. Vjazyce ST bude program vypadat následovně:

VAR_GLOBAL central_OFF : BOOL;END_VARPROGRAM prgMain VAR GoOut : fb_iAction; Light1 : fb_iLight; END_VAR // akce centralniho zhasnuti GoOut( action := r0_p3_DI.DI0, out => central_OFF, name := 'Odchod'); // 1-tlacitkove ovladani svetla Light1( lightToggle := r0_p3_DI.DI1, lightReset := central_OFF, out => r0_p3_DO.DO0);END_PROGRAM

Každý stisk tlačítka změní stav světla. Pomocí proměnné Main.Light1.webTogglelze světlo ovládat z web stránky. Stejnou funkci lze naprogramovat v jazyce CFC na-příklad následovně:

Funkce centrálního zhasnutí je v tomto příkladu řešena blokem fb_iAction. Cent-rální zhasnutí lze vyvolat i web stránky nastavením proměnné Main.GoOut.webAction naTRUE. Globální proměnná central_OFF pak bude použita pro všechny bloky řídící světlajako vstup pro centrální vypnutí.

43 TXV 003 59.01



Pro každou použitou instanci funkčního bloku fb_iLight se do souboru „iFox-trot.pub“ (public soubor) automaticky generuje generuje sada proměnných, která sloužípro integraci s aplikací iFoxtrot.

Každá instance fb_iLight přidá následující public proměnné:Proměnná Typ Význam

R GTSAP1_LIGHT_name STRING Kopie vstupu name R GTSAP1_LIGHT_enable BOOLR GTSAP1_LIGHT_type BOOL Typ světla (0 = onOff)RW GTSAP1_LIGHT_onoff BOOL Vypínání a zapínání světla z iFoxtrot.


V našem případě to pro instanci Light1 bude vypadat následovně:

Main.Light1.GTSAP1_LIGHT_name R B 1635 STRING[24] PUB_INMain.Light1.GTSAP1_LIGHT_enable R B 1660 .0 BOOL PUB_INMain.Light1.GTSAP1_LIGHT_type R B 1660 .1 BOOL PUB_INMain.Light1.GTSAP1_LIGHT_onoff R B 1660 .2 BOOL PUB_INOUT

kdeMain instance programu, kde je použit blok fb_iLightLight1 název bloku fb_iLight (jméno instance)GTSAP1_LIGHT_name název proměnné pro integraci bloku fb_iLight

44 TXV 003 59.01


6.12 Funkční blok fb_iRelayKnihovna : iControlLib

Funkční blok fb_iRelay je určen k řízení releového výstupu. Vstup relayOn spíná relé, vstup relayOff relé rozpíná. Vstup relayToggle přepíná

stav relé. Vstup webToggle funguje stejně jako relayToggle a slouží k ovládání relé z webrozhraní (tuto proměnnou je třeba nastavit na TRUE v případě, že chceme přepnout relé zweb stránky). Vstup pulseTime určuje jak dlouho bude relé sepnuté. Pokud má hodnotuT#0s tak doba sepnutí relé není omezena. A konečně vstup relayReset slouží jako cent-rální rozepnutí všech relé. Všechny vstupy typu BOOL reagují na náběžnou hranuvstupního signálu.

Výstup out slouží k ovládání relé.


VAR_INPUTrelayOn BOOL

R_EDGENáběžná hrana sepne relé

relayOff BOOLR_EDGE

Náběžná hrana rozepne relé

relayToggle BOOLR_EDGE

Náběžná hrana přepne relé

pulseTime TIME Doba výstupního pulzuPři T#0s není doba sepnutí relé omezena


Ovládání relé z web stránky

relayReset BOOLR_EDGE

Vstup pro centrální rozepnutí relé (odchodové tlačítko)


45 TXV 003 59.01


name STRING[24] název

VAR_OUTPUTout BOOL Ovládání relé

out_on BOOL Pulz při náběžné hraně out (při přechodu 0 → 1)

out_off BOOL Pulz při sestupné hraně out (při přechodu 1 → 0)

Předpokládejme, že potřebujeme ovládat reléový výstup DO3. Při každém sepnutíbinárního vstupu DI1 chceme sepnout relé na dobu 1 minuta. Sepnutím vstupu DI2 relérozepneme. V jazyce ST bude program vypadat následovně:

PROGRAM prgMain VAR Relay1 : fb_iRelay; END_VAR // ovladani rele Relay1( relayOn := r0_p3_DI.DI1, relayOff := r0_p3_DI.DI2, pulseTime := T#1m, name := 'Relay 1', out => r0_p3_DO.DO3);END_PROGRAM



Pro každou použitou instanci funkčního bloku fb_iRelay se do souboru „iFox-trot.pub“ (public soubor) automaticky generuje generuje sada proměnných, která sloužípro integraci s aplikací iFoxtrot.

Každá instance fb_iRelay přidá následující public proměnné:Proměnná Typ Význam

R GTSAP1_RELAY_name STRING Kopie vstupu name

46 TXV 003 59.01


Proměnná Typ VýznamR GTSAP1_RELAY_enable BOOLR GTSAP1_RELAY_type USINT Typ zobrazeni (0 = BOOL)R GTSAP1_RELAY_symbol UINT Kód ikonyRW GTSAP1_RELAY_onoff BOOL Vypínání a zapínání relé z iFoxtrot.


V našem případě to pro instanci Relay1 bude vypadat následovně:

Main.Relay1.GTSAP1_RELAY_name R B 1589 STRING[24] PUB_INMain.Relay1.GTSAP1_RELAY_enable R B 1614 .0 BOOL PUB_INMain.Relay1.GTSAP1_RELAY_type R B 1615 USINT PUB_INMain.Relay1.GTSAP1_RELAY_symbol R W 1616 UINT PUB_INMain.Relay1.GTSAP1_RELAY_onoff R B 1618 .0 BOOL PUB_INOUT

kdeMain instance programu, kde je použit blok fb_iRelayRelay1 název bloku fb_iRelay (jméno instance)GTSAP1_RELAY_name název proměnné pro integraci bloku fb_iRelay

47 TXV 003 59.01


6.13 Funkční blok fb_iScene4, fb_iScene8Knihovna : iControlLib

Funkční bloky fb_iScene4 a fb_iScene8 jsou určeny k nastavení scény. Blok fb_iS-cene4 umožňuje nastavit max. 4 různé scény, blok fb_iScene8 je určen pro 8 různýchscén. Scénou se rozumí konkrétní nastavení pro světla, žaluzie, atd. Sestavení scén seprovede v aplikaci iFoxtrot. Scéna může obsahovat nastavení pro všechny prvky, které lzez aplikace iFoxtrot ovládat. Popis v této kapitole odpovídá bloku fb_iScene4, blok fb_iS-cene8 se chová analogicky.

Vstupy scene1On, scene2On, scene3On a scene4On nastavují scénu odpovídají-

cího čísla. Na tyto vstupy lze připojit tlačítka, pomocí kterých lze volit požadovanou scénu.Pro aktivaci scény z web stránky slouží vstupy webScene1On až webScene4On. Všechnyvstupy typu BOOL reagují na náběžnou hranu vstupního signálu.

Výstup busy je nastaven na TRUE dokud je blok fb_iScene4 zaneprázdněn na-stavováním scény. Pokud dojde při nastavování scény k nějaké chybě, tak je ve výstupulastErr popis chyby. Výstup file obsahuje společný základ jména všech souborů, vekterých jsou popisy s nastavením scén. Pokud bude file = SCN_1399.sc? pak první scénabude popsaná souborem SCN_1399.sc1, druhá scéna bude popsaná souboremSCN_1399.sc2, atd. Soubory s popisem scém jsou generovány aplikací iFoxtrot, mají for-mát JSON a jsou uloženy na SD kartě PLC systému v adresáři WWW/iFOX/.


VAR_INPUTscene1On BOOL

R_EDGENáběžná hrana nastaví 1.scénu

scene2On BOOLR_EDGE

Náběžná hrana nastaví 2.scénu

scene3On BOOLR_EDGE


48 TXV 003 59.01


scene4On BOOLR_EDGE


webScene1On BOOLR_EDGE

Náběžná hrana nastaví 1.scénu(určeno pro ovladání z web stránky)








VAR_OUTPUTbusy BOOL TRUE znamená, že blok je zaneprázdněn na-

stavováním scénylastErr STRING Popis případné chyby

file STRING[12] Základ jména všech souborů s popisem scén

Pokud v programu použijeme jednu instanci funkčního bloku fb_iScene4 pak se vaplikaci iFoxtrot objeví možnost sestavení čtyř různých scén. Do každé scény lze pakumístit libovolné množství prvků, které se v aplikaci ovládají a tyto prvky lze nastavit nakonkrétní hodnoty. Například lze nastavit, že svetlo1 bude ve scéně svítit, zásuvka1bude ve scéně vypnutá, stmívané světlo2 bude svítit na 90% a barevné svetloRGBbude nastaveno na určitou barvu a bude svítit na 100%. Aplikace iFoxtrot uloží nastaveníkaždé scény do JSON souboru, který může vypadat např. následovně:

{ "name": "Moje scény", "index": 3, "scene": { "main": { "svetlo1": { "GTSAP1_LIGHT_onoff": 1 }, "zasuvka1": { "GTSAP1_SOCKET_onoff": false }, "svetlo2": { "GTSAP1_LIGHT_onoff": 1, "GTSAP1_LIGHT_dimlevel": 90.0 }, "svetloRGB": { "GTSAP1_LIGHT_onoff": 1, "GTSAP1_LIGHT_dimlevel": 100.0, "GTSAP1_LIGHT_rgb": 4227264 } } }}

49 TXV 003 59.01


Scény nastavené v aplikaci iFoxtrot bude možné aktivovat (spouštět) také pomocítlačítek (např. modulem C-WS-0400R-Logus). V jazyce ST bude program vypadat násle-dovně:

PROGRAM prgMain16 VAR MyScene : fb_iScene4; END_VAR MyScene( scene1On := r8_p2_IN.DI.CLICK_UP1, scene2On := r8_p2_IN.DI.CLICK_DOWN1, scene3On := r8_p2_IN.DI.CLICK_UP2, scene4On := r8_p2_IN.DI.CLICK_DOWN2, name := 'Moje scény');END_PROGRAM



Pro každou použitou instanci funkčního bloku fb_iScene4 se do souboru „iFox-trot.pub“ (public soubor) automaticky generuje generuje sada proměnných, která sloužípro integraci s aplikací iFoxtrot.

Každá instance fb_iScene4 přidá následující public proměnné:Proměnná Typ Význam

R GTSAP1_SCENE_name STRING Kopie vstupu name R GTSAP1_SCENE_file STRING[24] Společný základ jména JSON souboruR GTSAP1_SCENE_enable BOOLR GTSAP1_SCENE_num USINT Počet scén (4 nebo 8)W GTSAP1_SCENE_set1 BOOL Aktivace 1.scény z aplikace iFoxtrotW GTSAP1_SCENE_set2 BOOL Aktivace 2.scény z aplikace iFoxtrotW GTSAP1_SCENE_set3 BOOL Aktivace 3.scény z aplikace iFoxtrotW GTSAP1_SCENE_set4 BOOL Aktivace 4.scény z aplikace iFoxtrot


50 TXV 003 59.01


V našem případě to pro instanci MyScene bude vypadat následovně:

Main.MyScene.GTSAP1_SCENE_name R B 2794 STRING[24] PUB_INMain.MyScene.GTSAP1_SCENE_file R B 2819 STRING[24] PUB_INMain.MyScene.GTSAP1_SCENE_enable R B 2844 .0 BOOL PUB_INMain.MyScene.GTSAP1_SCENE_num R B 2845 USINT PUB_INMain.MyScene.GTSAP1_SCENE_set1 R B 2846 .0 BOOL PUB_OUTMain.MyScene.GTSAP1_SCENE_set2 R B 2846 .1 BOOL PUB_OUTMain.MyScene.GTSAP1_SCENE_set3 R B 2846 .2 BOOL PUB_OUTMain.MyScene.GTSAP1_SCENE_set4 R B 2846 .3 BOOL PUB_OUT

kdeMain instance programu, kde je použit blok fb_iScene4MyScene název bloku fb_iScene4 (jméno instance)GTSAP1_SCENE_name název proměnné pro integraci bloku fb_iScene4

51 TXV 003 59.01


6.14 Funkční blok fb_iSensorPIR

Funkční blok fb_iSensorPIR slouží k připojení PIR čidla pro vyhodnocení přítom-nosti osob, které se připojuje na vstup in. Vstup delay umožňuje nastavit minimální délkuvstupního pulsu na kterou bude blok reagovat.

Popis proměnných :

Proměnná Typ VýznamVAR_INPUT

in BOOL Vstup pro PIR čidlo (0 = detekuje osobu, 1 = bez detekce)

delay TIME Necitlivost

name STRING[24] Pojmenování bloku

VAR_OUTPUTout BOOL Detekce pohybu

Jednoduchý příklad použití fb_iSensorPIR v jazyce ST.

PROGRAM prgMain VAR roomOccupation : fb_iSensorPIR; alarm : BOOL; END_VAR roomOccupation (in := r0_p3_DI.DI5, delay := T#3s , name := 'senzor1', out => alarm ); END_PROGRAM

Pokud je čidlo aktivováno (0 na vstupu in ) na déle jak 3 sekundy, tak funkční blokvyhodnotí přítomnost osoby a vyšle na výstup out 1. Stejný program lze realizovat v CFCnásledovně:

52 TXV 003 59.01



Pro každou použitou instanci funkčního bloku fb_iSensorPIR se do souboru „iFox-trot.pub“ (public soubor) automaticky generuje generuje sada proměnných, která sloužípro integraci s aplikací iFoxtrot.

Každá instance fb_iSensorPIR přidá následující public proměnné:Proměnná Typ Význam

R GTSAP1_PIRSENSOR_name STRING Kopie vstupu name R GTSAP1_PIRSENSOR_enable BOOLR GTSAP1_PIRSENSOR_value BOOL Stav PIR čidla


V našem případě to pro instanci roomOccupation bude vypadat následovně:

Main.roomOccupation.GTSAP1_PIRSENSOR_name R B 1911 STRING[24] PUB_INMain.roomOccupation.GTSAP1_PIRSENSOR_enable R B 1928 .0 BOOL PUB_INMain.roomOccupation.GTSAP1_PIRSENSOR_value R B 1928 .1 BOOL PUB_IN

kdeMain instance programu, kde je použit blok fb_iSensorPIRroomOccupation název bloku fb_iSensorPIR (jméno instance)GTSAP1_PIRSENSOR_name název proměnné pro integraci bloku fb_iSensorPIR

53 TXV 003 59.01


6.15 Funkční blok fb_iSensorTempKnihovna : iControlLib

Funkční blok fb_iSensorTemp je určen k měření teploty. Měřenou teplotu lze ko-rigovat o pevný offset a filtrovat filtrem 1.řádu. Tento blok nahrazuje blok fb_iTherm, kterýbyl v předchozích verzích knihovny iControlLib a v aplikaci iFoxtrot přestal být podpo-rován.

Vstup in slouží k připojení teplotního čidla. Vstup offset umožňuje korigovat mě-řenou teplotu o zadanou hodnotu. Vstup filterTime udává časovou konstantu pro filtr1.řádu, který filtruje měřenou teplotu. Pokud má vstup filterTime hodnotu T#0s tak je filtra-ce vypnutá. Na výstupu out je k dispozici teplota po filtraci korigovaná o zadaný offset.


VAR_INPUTin REAL Vstup pro připojení teplotního čidla

offset REAL Korekce měřené teploty

filterTime TIME Časová konstanta filtru pro měřenou teplotuPřednastavená hodnota je 30 sec


VAR_OUTPUTout REAL Výsledná teplota

Předpokládejme, že potřebujeme měřit teplotu čidlem připojeným na analogovývstup AI0. V jazyce ST bude program vypadat následovně:

PROGRAM prgMain VAR Therm1 : fb_iSensorTemp; temp : REAL; // teplota END_VAR // mereni teploty Therm1( in := r0_p3_AI0.ENG, offset := -0.5, filterTime := T#1m, out => temp);END_PROGRAM

54 TXV 003 59.01


Měřená teplota bude bude korigovaná o -0.5 °C a filtrovaná filtrem s časovou kon-stantou 1 min. Stejnou funkci lze naprogramovat v jazyce CFC například následovně:


Pro každou použitou instanci funkčního bloku fb_iSensorTemp se do souboru „iFo-xtrot.pub“ (public soubor) automaticky generuje generuje sada proměnných, která sloužípro integraci s aplikací iFoxtrot.

Každá instance fb_iSensorTemp přidá následující public proměnné:Proměnná Typ Význam


kázaná)R GTSAP1_DISPLAY_type USINT Typ zobrazení (1 = REAL)R GTSAP1_DISPLAY_symbol UINT Aktuální kód symbolu (100)R GTSAP1_DISPLAY_value REAL Zobrazovaná teplotaR GTSAP1_DISPLAY_unit STRING[8] Fyzikální jednotka (°C)R GTSAP1_DISPLAY_precision INT Počet zobrazených desetinných míst


V našem případě to pro instanci Therm1 bude vypadat následovně:

Main.Therm1.GTSAP1_DISPLAY_name R B 1815 STRING[24] PUB_INOUTMain.Therm1.GTSAP1_DISPLAY_enable R B 1840 .0 BOOL PUB_INOUTMain.Therm1.GTSAP1_DISPLAY_edit R B 1840 .1 BOOL PUB_INOUTMain.Therm1.GTSAP1_DISPLAY_type R B 1841 USINT PUB_INOUTMain.Therm1.GTSAP1_DISPLAY_symbol R W 1842 UINT PUB_INOUTMain.Therm1.GTSAP1_DISPLAY_value R F 1844 REAL PUB_INOUTMain.Therm1.GTSAP1_DISPLAY_unit R B 1848 STRING[8] PUB_INOUTMain.Therm1.GTSAP1_DISPLAY_precision R W 1857 INT PUB_INOUT

kdeMain instance programu, kde je použit blok fb_iSensorTempTherm1 název bloku fb_iSensorTemp (jméno instance)GTSAP1_DISPLAY_name název proměnné pro integraci bloku fb_iSensorTemp

55 TXV 003 59.01


6.16 Funkční blok fb_iSocketKnihovna : iControlLib

Funkční blok fb_iSocket je určen k řízení zásuvky. Vstup socketOn spíná zásuvku, vstup socketOff zásuvku rozpíná. Vstup socket-

Toggle přepíná stav zásuvky. Vstup webToggle funguje stejně jako socketToggle a sloužík ovládání zásuvky z web rozhraní (tuto proměnnou je třeba nastavit na TRUE v případě,že chceme přepnout zásuvku z web stránky). Vstup pulseTime určuje jak dlouho bude zá-suvka sepnutá. Pokud má hodnotu T#0s tak doba sepnutí zásuvky není omezena. A ko-nečně vstup socketReset slouží jako centrální rozepnutí všech zásuvek. Všechny vstupytypu BOOL reagují na náběžnou hranu vstupního signálu.

Výstup out slouží k ovládání zásuvky.


VAR_INPUTsocketOn BOOL

R_EDGENáběžná hrana sepne zásuvku

socketOff BOOLR_EDGE

Náběžná hrana rozepne zásuvku

socketToggle BOOLR_EDGE

Náběžná hrana přepne zásuvku

pulseTime TIME Doba výstupního pulzuPři T#0s není doba sepnutí zásuvky omezena


Ovládání zásuvky z web stránky

socketReset BOOLR_EDGE

Vstup pro centrální rozepnutí zásuvek (odchodové tlačítko)


VAR_OUTPUTout BOOL Ovládání zásuvky

56 TXV 003 59.01


Předpokládejme, že potřebujeme ovládat venkovní zásuvku připojenou na výstupDO3. Zásuvku zapneme sepnutím binárního vstupu DI1. K vypnutí zásuvky dojde při se-pnutí vstupu DI2. V jazyce ST bude program vypadat následovně:

PROGRAM prgMain VAR Socket1 : fb_iSocket; END_VAR // ovladani zasuvky Socket1( socketOn := r1_p1_IN.DIS.DI1, socketOff := r1_p1_IN.DIS.DI2, name := 'Outside socket', out => r1_p2_OUT.DOS.DO3);END_PROGRAM



Pro každou použitou instanci funkčního bloku fb_iSocket se do souboru „iFox-trot.pub“ (public soubor) automaticky generuje generuje sada proměnných, která sloužípro integraci s aplikací iFoxtrot.

Každá instance fb_iSocket přidá následující public proměnné:Proměnná Typ Význam

R GTSAP1_SOCKET_name STRING Kopie vstupu name R GTSAP1_SOCKET_enable BOOLRW GTSAP1_SOCKET_onoff BOOL Vypínání a zapínání zásuvky z iFoxtrot.


V našem případě to pro instanci Socket1 bude vypadat následovně:

Main.Socket1.GTSAP1_SOCKET_name R B 5139 STRING[24]Main.Socket1.GTSAP1_SOCKET_enable R B 5164 .0 BOOLMain.Socket1.GTSAP1_SOCKET_onoff R B 5164 .1 BOOL

kde

57 TXV 003 59.01


Main instance programu, kde je použit blok fb_ iSocketSocket1 název bloku fb_ iSocket (jméno instance)GTSAP1_SOCKET_name název proměnné pro integraci bloku fb_ iSocket

58 TXV 003 59.01


6.17 Funkční blok fb_iTimeProgWeekKnihovna : iControlLib

Funkční blok fb_iTimeProgWeek je určen k řízení topení a chlazení podle týdenní-ho časového programu. Základní funkci lze přirovnat k pokojovému termostatu.

Blok zajišťuje následující činnosti:• dlouhodobé řízení podle časového programu (auto)• krátkodobé korekce požadovaného řízení (ručně)• správu časového programu (ukládání a načítání časového programu na SD kartu)• editaci časového programu z web rozhraní• synchronizaci časového programu s modulem C-RC-0011R• spolupráci s aplikací iFoxtrot

Týdenní časový program

Týdenní časový program definuje nastavení vytápění resp. chlazení pro celý týden.Každý den může být libovolně rozdělen až do 8 intervalů (tj. 7 časových změn) v rastru 15minut. Každému intervalu je přiřazen teplotní režim: komfort, útlum, ekonomy a ochranný.Požadovaná teplota v každém režimu je volitelná.

Týdenní časový program má následující strukturu:

59 TXV 003 59.01


Význam jednotlivých položek je následující:• name název časového programu• update požadavek na update časového programu• typ určuje, jestli se podle programu bude topit nebo chladit nebo obojí• numTimes počet časových značek za den (minimálně 2, maximálně 7)• units jednotky teploty (°C, °F)• heatTemp[ ] pole teplot topení pro program limit, ekonomy, útlum a komfort• coolTemp[ ] pole teplot chlazení pro program limit, ekonomy, útlum a komfort• times[ ] časové značky pro všechny dny v týdnu• values[ ] požadovaný program pro každý zadaný interval• holiday[ ] datum dovolené (od, do)• reserved rezerva• crc zabezpečení dat

Časový program je při každé změně ukládán na SD kartu. Data v souboru jsou veformátu JSON, název souboru je uveden na výstupu jsonFile. Soubor je uložen v adresářiWWW/iFOX/.

{ "Name": "Program topeni", "timeProgWeekData":{ "typ":3, "numTimes":6, "units":0, "heatTemp":[5.0,19.0,21.0,23.0], "coolTemp":[33.0,29.0,25.0,24.0], "times":[ ["00:00:0","06:00:0","08:00:0","15:00:0","21:00:0","24:00:0","24:00:0"], ["01:00:0","06:15:0","08:00:0","15:00:0","21:00:0","24:00:0","24:00:0"], ["02:00:0","06:30:0","08:00:0","15:00:0","19:00:0","23:00:0","24:00:0"], ["03:00:0","06:45:0","09:00:0","13:45:0","21:00:0","24:00:0","24:00:0"], ["04:00:0","07:00:0","08:00:0","15:00:0","21:00:0","24:00:0","24:00:0"], ["05:00:0","07:15:0","22:00:0","24:00:0","24:00:0","24:00:0","24:00:0"], ["00:00:0","07:15:0","22:00:0","24:00:0","24:00:0","24:00:0","24:00:0"] ], "values":[ [1,2,3,2,3,1,1,1], [1,2,3,2,3,1,1,1], [1,2,3,2,3,2,1,1], [1,2,3,2,3,1,1,1], [1,2,3,2,3,1,1,1], [1,2,3,2,1,1,1,1], [1,2,3,2,1,1,1,1] ], "holiday":["1970-01-01-00:00:0","1970-01-01-00:00:0"] }}

Editace časového programu

Editaci časového programu je možné provádět přes web rozhraní (z web stránkyPLC vytvořené nástrojem WebMaker) nebo pomocí modulu C-RC-0011R nebo pomocíaplikace iFoxtrot.

Pro editaci časového programu z web stránky nabízí funkční blok fb_iTime-ProgWeek data pro prvek „kreslící plátno“ (canvas). V nástroji WebMaker tedy stačí vložitdo web stránky prvek „kreslící plátno“ a ve vlastnostech „kreslícího plátna“ nastavit výstup

60 TXV 003 59.01


canvasData jako řídící strukturu. Dále je třeba zatrhnout pole „vracet pozici“. Výsledekbude ve web stránce vypadat např. následovně:

V horní části je možno měnit teploty přiřazené k jednotlivým režimům (zleva ochra-na, ekonomy, útlum a komfort). Spodní část definuje žádanou teplotu pro topení na jedenden. Vybraný den je podbarven fialově, aktuální den v týdnu má bílé orámování. V uve-deném příkladu je zobrazen požadovaný průběh pro topení v úterý, kde je zvolen režimkomfort (žádaná teplota 23°C) od 06:00 do 08:00 a od 14:30 do 22:00, v ostatních časechje zvolen režim útlum (žádaná teplota 21°C). Kliknutím na tlačítko „TOPENÍ“ lze přepnoutzobrazení na „CHLAZENÍ“.

61 TXV 003 59.01


Časové značky ve spodní části lze přesunovat pomocí myši. Při přesouvání změníznačka barvu a časový údaj se objeví na obou koncích čáry definující časový interval.Kliknutím do sloupce v intervalu lze mě

Documents

Knihovna pro řízení techologií v budovách · 2017. 3. 6. · informaci o krátkém resp. dlouhém stisku poskytuje přímo CIB modul. Doba pro vyhodno-cení dlouhého stisku