Dynamické změny jsou pokročilé funkce, pomocí kterých můžeme měnit buď konfiguraci PLC, nebo samotné vlastnosti komunikačních kanálů nahraných do PLC. Tudíž není potřeba provádět konfiguraci přímo v IDE, ale lze jednotlivé konfigurační proměnné vytáhnout například do HMI.

Pomocí funkcí popsaných níže je možné naprogramovat v ST vlastní funkční bloky podle toho, co je zrovna v projektu vyžadováno.

• pomocí níže uvedených metod nelze zjistit aktuální hodnoty nastavené v konfiguraci/image PLC
• nastavené hodnoty je potřeba „potvrdit“ zavoláním dynpar.commithwconfiguration();
• nastavení se projeví až po restartu, který lze vyvolat voláním: reloadapplication(0);

Funkce slouží k zápisu textových řetězců.

WriteResult := dynpar.setdynamicparamstr(id := ParamId, value := ParamToWrite);

• id: string_ref - název parametru
• value: string_ref - hodnota parametru k zapsání

• Žádné výstupní parametry

• 0 - žádná chyba
• -1 - záznam neexistuje
• -2 - neznámý požadovaný typ (v praxi nemůže nastat)
• -3 - nesoulad velikosti uloženého záznamu a požadovaného záznamu (např. uložen datový typ bool a čteme datový typ int)
• -4 - interní chyba kódu

Funkce slouží k zápisu celočíselné hodnoty.

WriteResult := dynpar.setdynamicparamint(id := ParamId, value := ParamToWrite);

• id: string_ref - název parametru
• value: int - hodnota parametru k zapsání

• Žádné výstupní parametry

• 0 - žádná chyba
• -1 - záznam neexistuje
• -2 - neznámý požadovaný typ (v praxi nemůže nastat)
• -3 - nesoulad velikosti uloženého záznamu a požadovaného záznamu (např. uložen datový typ bool a čteme datový typ int)
• -4 - interní chyba kódu

Funkce slouží k zápisu logické hodnoty.

WriteResult := dynpar.setdynamicparambool(id := ParamId, value := ParamToWrite);

• id: string_ref - název parametru
• value: bool - hodnota parametru k zapsání

• Žádné výstupní parametry

• 0 - žádná chyba
• -1 - záznam neexistuje
• -2 - neznámý požadovaný typ (v praxi nemůže nastat)
• -3 - nesoulad velikosti uloženého záznamu a požadovaného záznamu (např. uložen datový typ bool a čteme datový typ int)
• -4 - interní chyba kódu

Funke slouží k zápisu časové hodnoty.

WriteResult := dynpar.setdynamicparamtime(id := ParamId, value := ParamToWrite);

• id: string_ref - název parametru
• value: time - hodnota parametru k zapsání

• Žádné výstupní parametry

• 0 - žádná chyba
• -1 - záznam neexistuje
• -2 - neznámý požadovaný typ (v praxi nemůže nastat)
• -3 - nesoulad velikosti uloženého záznamu a požadovaného záznamu (např. uložen datový typ bool a čteme datový typ int)
• -4 - interní chyba kódu

Funkce slouží k zápisu data a časové hodnoty.

WriteResult := dynpar.setdynamicparamdt(id := ParamId, value := ParamToWrite);

• id: string_ref - název parametru
• value: dt - hodnota parametru k zapsání

• Žádné výstupní parametry

• 0 - žádná chyba
• -1 - záznam neexistuje
• -2 - neznámý požadovaný typ (v praxi nemůže nastat)
• -3 - nesoulad velikosti uloženého záznamu a požadovaného záznamu (např. uložen datový typ bool a čteme datový typ int)
• -4 - interní chyba kódu

Funkce slouží ke čtení textového řetězce.

ReadResult := dynpar.trygetdynamicparamstr(id := ParamId, value => ReturnValue);

• id: string_ref - název parametru

• value: string - vrácená hodnota parametru

• 0 - žádná chyba
• -1 - záznam neexistuje
• -2 - neznámý požadovaný typ (v praxi nemůže nastat)
• -3 - nesoulad velikosti uloženého záznamu a požadovaného záznamu (např. uložen datový typ bool a čteme datový typ int)
• -4 - interní chyba kódu

Slouží ke čtení celočíselné hodnoty.

ReadResult := dynpar.trygetdynamicparamint(id:= ParamId, value => ReturnValue);

• id: string_ref - název parametru

• value: int - vrácená hodnota parametru

• 0 - žádná chyba
• -1 - záznam neexistuje
• -2 - neznámý požadovaný typ (v praxi nemůže nastat)
• -3 - nesoulad velikosti uloženého záznamu a požadovaného záznamu (např. uložen datový typ bool a čteme datový typ int)
• -4 - interní chyba kódu

Funkce slouží ke čtení logické hodnoty.

ReadResult := dynpar.trygetdynamicparambool(id:= ParamId, value => ReturnValue);

• id: string_ref - název parametru

• value: bool - vrácená hodnota parametru

• 0 - žádná chyba
• -1 - záznam neexistuje
• -2 - neznámý požadovaný typ (v praxi nemůže nastat)
• -3 - nesoulad velikosti uloženého záznamu a požadovaného záznamu (např. uložen datový typ bool a čteme datový typ int)
• -4 - interní chyba kódu

Funkce slouží ke čtení časové hodnoty.

ReadResult := dynpar.trygetdynamicparamtime(id:= ParamId, value => ReturnValue);

• id: string_ref - název parametru

• value: time - vrácená hodnota parametru

• 0 - žádná chyba
• -1 - záznam neexistuje
• -2 - neznámý požadovaný typ (v praxi nemůže nastat)
• -3 - nesoulad velikosti uloženého záznamu a požadovaného záznamu (např. uložen datový typ bool a čteme datový typ int)
• -4 - interní chyba kódu

Funkce slouží ke čtení data a časové hodnoty.

ReadResult := dynpar.trygetdynamicparamdt(id:= ParamId, value => ReturnValue);

• id: string_ref - název parametru

• value: dt - vrácená hodnota parametru

• 0 - žádná chyba
• -1 - záznam neexistuje
• -2 - neznámý požadovaný typ (v praxi nemůže nastat)
• -3 - nesoulad velikosti uloženého záznamu a požadovaného záznamu (např. uložen datový typ bool a čteme datový typ int)
• -4 - interní chyba kódu

Funkce slouží ke smazání dynamického parametru. Dynamické parametry je možné hromadně smazat při nahrání sestavy.

DeleteResult := dynpar.deletedynamicparam(ParamToDelete);

• id: string_ref - název parametru

• Žádné výstupní parametry

• 0 - žádná chyba
• -1 - záznam neexistuje
• -2 - neznámý požadovaný typ (v praxi nemůže nastat)
• -3 - nesoulad velikosti uloženého záznamu a požadovaného záznamu (např. uložen datový typ bool a čteme datový typ int)
• -4 - interní chyba kódu

Funkce slouží pro uložení celého stromu HW konfigurace do paměti PLC. Nemá žádné parametry.

CommitResult := dynpar.commithwconfiguration();

• 0 - žádná chyba
• -1 - záznam neexistuje
• -2 - neznámý požadovaný typ (v praxi nemůže nastat)
• -3 - nesoulad velikosti uloženého záznamu a požadovaného záznamu (např. uložen datový typ bool a čteme datový typ int)
• -4 - interní chyba kódu

Slouží k restartu PLC. Je možné si podle daného flagu určit jaký typ restartu se má provést. Pokud se nenastaví žádný flag, tak se PLC restartuje standardním způsobem (Warm Restart).

RestartResult := reloadapplication(Flag);

Vstupní parametry - Flags (udint)

• 0x00 - Warm Restart
• 0x01 - Cold Restart
• 0x02 - Restart celého systému (reboot)

• Žádné výstupní parametry

• 0 - žádná chyba
• -1 - záznam neexistuje
• -2 - neznámý požadovaný typ (v praxi nemůže nastat)
• -3 - nesoulad velikosti uloženého záznamu a požadovaného záznamu (např. uložen datový typ bool a čteme datový typ int)
• -4 - interní chyba kódu

Tyto klíče se dají najít v adresáři projektu v adresáři bin, kde se nachází soubor s příponou .XML, který se dá otevřít v textovém editoru. Tento soubor vzniká nahráním konfigurace do PLC.

Před klíče pro konfiguraci PLC se dává předpona „hwcfg“. V XML souboru se pohybujeme po jednotlivých uzlech, kde například pro nastavení IP adresy PLC musíme napsat klíč ve tvaru „hwcfg.hwconfiguration.runtime.lwip.ipv4.@ipaddress“.

Klíče pro dynamické změny v image se vypisují v záložce „Výstup“ ve formátu „OEM Key „channel>ComPort“ → 9698843FC46A2D1A, datatype: SignedInteger32“, kde „channel“ je název kanálu a „ComPort“ daný parametr, z kterého chceme číst nebo do něj zapisovat. Za klíčem se dále vypíše, jakého datového typu je daný parametr. V tomto případě bychom pro čtení tohoto klíče vybrali funkci dynpar.trygetdynamicparamint a pro zápis dynpar.setdynamicparamint.

U klíčů pro změnu v image je potřeba přidat před vypsané klíče ještě předponu „image“. Pro příklad pro změnu komunikačního portu u modbusového sériového kanálu s názvem „modbus_channel“ by bylo potřeba napsat klíč ve tvaru „image.modbus_channel>ComPort“.