====== Rozhraní pro definici kaskádního regulátoru (v3.0) ======

===== Popis =====
  * Úplný název funkčního bloku: Lib.Mervis.v3_0.BaseCascadeController
  * Vytvořen rozšířením bloku
    * [[cs:mervis-ide:35-help:035-software_basic:060-libraries:060-lib-mervis:015-utilities:040-base-function-blocks:010-basealarmblock:v2_0|Lib.Mervis.v2_0.BaseAlarmBlock]]
  * Potřebné reference projektu
    * Lib.Mervis
    * Lib.Mervis.Cascade

Blok definuje rozhraní, které musí implementovat funkční blok pro kaskádní regulátor

===== Vstupy =====

^ Jméno ^ Datový typ ^ Povolený rozsah ^ Jednotka ^ Retain ^ Nutno připojit ^ Význam ^
| Rozhraní nedefinuje žádné vstupy |||||||

===== Výstupy =====

^ Jméno ^ Datový typ ^ Jednotka ^ Význam ^
| Cascade | ptr_to Lib.Mervis.v3_0.BaseCascadeController | - | Ukazatel na vlastní implementaci, automaticky inicializováno na hodnotu THIS |

===== Bloky =====

^ Jméno ^ Datový typ ^ Význam ^
| Rozhraní neobsahuje žádné interní bloky k použití |||

===== Metody =====

==== GetState ====
  * Virtualní: Ano
  * Nutno přetížit: Ano
  * Metoda slouží pro získání celkového stavu kaskádního regulátoru

^ Argument ^ Typ ^ Datový typ ^ Význam ^
| _GlobalEnable | Výstup | bool | Indikuje povolení řízení - vstup Enable u kaskádního regulátoru |
| _MeasuredOutput | Výstup | real | Hodnota společného výstupu |
| _SetpointInput | Výstup | real | Požadovaná hodnota společného výstupu - vstup Setpoint u kaskádního regulátoru |
| _Setpoint | Výstup | real | Vypočtená a upravená hodnota společného výstupu - výstup ActualSetpoint |
| _SetpointWithLimits | Výstup | real | Upravena žádaná hodnota společného výstupu se započtením limitů zařízení  - Setpoint_WithLimits |
| _ControlStrategy | Výstup | [[cs:mervis-ide:35-help:035-software_basic:060-libraries:065-lib-mervis-cascade:015-utilities:030-types:010-cascadecontrollerstrategy:v3_0|Lib.Mervis.v3_0.CascadeControllerStrategy]] | Strategie říení |
| _ActualNumberOfActive | Výstup | usint | Aktualní počet aktivních zařízení |
| _ActualMasterIndex | Výstup | [[cs:mervis-ide:35-help:035-software_basic:060-libraries:065-lib-mervis-cascade:015-utilities:030-types:025-cascadesourcenumber:v3_0|Lib.Mervis.v3_0.CascadeSourceNumber]] | Index aktuálního master zaříení |

==== GetCommonLimits ====
  * Virtualní: Ano
  * Nutno přetížit: Ano
  * Metoda slouží pro získání společných limitů na žádanou hodbnotu společného výstupu

^ Argument ^ Typ ^ Datový typ ^ Význam ^
| _MinimalOutput | Výstup | real | Minimální hodnota výstupu |
| _MaximalOutput | Výstup | real | Maximální hodnota výstupu |

==== GetPowerInfo ====
  * Virtualní: Ano
  * Nutno přetížit: Ano
  * Metoda slouží pro získání aktuálního výkonu kaskádního regulátoru

^ Argument ^ Typ ^ Datový typ ^ Význam ^
| _TotalActivePower | Výstup | real | Aktuální výkon aktivních zařízení |
| _MaximalPower | Výstup | real | Maximální výkon kaskády - součet maximálních výkonu všech zařízení |

==== GetSourcesCount ====
  * Virtualní: Ano
  * Nutno přetížit: Ano
  * Metoda slouží pro získání počtu zařízení v kaskádě

^ Argument ^ Typ ^ Datový typ ^ Význam ^
| _SourcesCount | Výstup | usint | Počet zařízení |

==== GetSource ====
  * Virtualní: Ano
  * Nutno přetížit: Ano
  * Metoda slouží pro získání ukazatele na požadované zařízení

^ Argument ^ Typ ^ Datový typ ^ Význam ^
| _Index | Vstup | usint | Index zařízení (1..4) |
| _Source | Výtup | [[cs:mervis-ide:35-help:035-software_basic:060-libraries:065-lib-mervis-cascade:015-utilities:040-base-function-blocks:010-basesource:v3_0|Lib.Mervis.v3_0.BaseSource]] | Požadované zařízení |

==== GetSourceSetpoint ====
  * Virtualní: Ano
  * Nutno přetížit: Ano
  * Metoda slouží pro získání aktuální požadované hodnoty zařízení

^ Argument ^ Typ ^ Datový typ ^ Význam ^
| - | Návratová hodnota | real | Aktuální požadovaná hodnota |

==== IncreaseNumberOfActiveSources ====
  * Virtualní: Ano
  * Nutno přetížit: Ano
  * Metoda slouží pro aktivaci dalšího zaříení bez ohledu na stav kaskádního regulátoru
  * FIXME není definováno

^ Argument ^ Typ ^ Datový typ ^ Význam ^

==== DecreaseNumberOfActiveSources ====
  * Virtualní: Ano
  * Nutno přetížit: Ano
  * Metoda slouží pro deaktivaci dalšího zaříení bez ohledu na stav kaskádního regulátoru
  * FIXME není definováno

^ Argument ^ Typ ^ Datový typ ^ Význam ^

==== IncreaseTotalPower ====
  * Virtualní: Ano
  * Nutno přetížit: Ano
  * Metoda slouží pro zvýšení dodávaného výkonu bez ohledu na stav kaskádního regulátoru

^ Argument ^ Typ ^ Datový typ ^ Význam ^
| _PowerChange | Vstup | real | Požadované navýšení ve výkonových jednotkách (dle zařízení) |

==== DecreaseTotalPower ====
  * Virtualní: Ano
  * Nutno přetížit: Ano
  * Metoda slouží pro snížení dodávaného výkonu bez ohledu na stav kaskádního regulátoru

^ Argument ^ Typ ^ Datový typ ^ Význam ^
| _PowerChange | Vstup | real | Požadované snížení ve výkonových jednotkách (dle zařízení) |



===== Podrobný popis funkce =====

....

===== Verze =====