Dynamické změny

Od verze IDE 2.5.0.x.

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.

Domat IDE obsahuje ve FUPLA prohlížeči základní funkční bloky pro dynamické změny.

Funkční bloky pro konfiguraci PLC

DateTimeSettings

DatabaseParameters

Networking

Network Card

ProxyParameters

RestartPLC

SSCPParameters

Storage

UsersDefinition

Funkční bloky pro dynamické změny vlastností komunikačních kanálů

Serial Channel

TCP/UDP Channel

Funkční bloky pro dynamické změny vlastností komunikačních zařízení

BACnet Client Device

BACnet Server Device

Daikin iTC Device

Mbus Device

Modbus RTU Device

Modbus TCP Device

SoftPLC-Link Device

SSCP TCP Device

Funkční bloky pro dynamické změny vlastností alarmových kanálů

GSM

SMTP

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.

Základní funkce

Funkce dynpar.setdynamicparamstr

Slouží k zápisu textových řetezců.

Volání v ST:

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

  • Vstupní parametry

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

  • Výstupní parametry

    • Žádné výstupní parametry

  • Návratové hodnoty

    • 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 dynpar.setdynamicparamint

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

Volání v ST:

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

  • Vstupní parametry

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

  • Výstupní parametry

    • Žádné výstupní parametry

  • Návratové hodnoty

    • 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 dynpar.setdynamicparambool

Slouží k zápisu logické hodnoty.

Volání v ST:

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

  • Vstupní parametry

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

  • Výstupní parametry

    • Žádné výstupní parametry

  • Návratové hodnoty

    • 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 dynpar.setdynamicparamtime

Slouží k zápisu časové hodnoty.

Volání v ST:

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

  • Vstupní parametry

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

  • Výstupní parametry

    • Žádné výstupní parametry

  • Návratové hodnoty

    • 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 dynpar.setdynamicparamdt

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

Volání v ST:

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

  • Vstupní parametry

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

  • Výstupní parametry

    • Žádné výstupní parametry

  • Návratové hodnoty

    • 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 dynpar.trygetdynamicparamstr

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

Volání v ST:

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

  • Vstupní parametry

    • id: string_ref - název parametru

  • Výstupní parametry

    • value: string - vrácená hodnota parametru

  • Návratové hodnoty

    • 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 dynpar.trygetdynamicparamint

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

Volání v ST:

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

  • Vstupní parametry

    • id: string_ref - název parametru

  • Výstupní parametry

    • value: int - vrácená hodnota parametru

  • Návratové hodnoty

    • 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 dynpar.trygetdynamicparambool

Slouží ke čtení logické hodnoty.

Volání v ST:

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

  • Vstupní parametry

    • id: string_ref - název parametru

  • Výstupní parametry

    • value: bool - vrácená hodnota parametru

  • Návratové hodnoty

    • 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 dynpar.trygetdynamicparamtime

Slouží ke čtení časové hodnoty.

Volání v ST:

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

  • Vstupní parametry

    • id: string_ref - název parametru

  • Výstupní parametry

    • value: time - vrácená hodnota parametru

  • Návratové hodnoty

    • 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 dynpar.trygetdynamicparamdt

Slouží ke čtení data a časové hodnoty.

Volání v ST:

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

  • Vstupní parametry

    • id: string_ref - název parametru

  • Výstupní parametry

    • value: dt - vrácená hodnota parametru

  • Návratové hodnoty

    • 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 dynpar.deletedynamicparam

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

Volání v ST:

DeleteResult := dynpar.deletedynamicparam(ParamToDelete);

  • Vstupní parametry

    • id: string_ref - název parametru

  • Výstupní parametry

    • Žádné výstupní parametry

  • Návratové hodnoty

    • 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 dynpar.commithwconfiguration

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

Volání v ST:

CommitResult := dynpar.commithwconfiguration();

  • Návratové hodnoty

    • 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 ReloadApplication

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).

Volání v ST:

RestartResult := reloadapplication(Flag);

  • Vstupní parametry - Flags (udint)

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

  • Výstupní parametry

    • Žádné výstupní parametry

  • Návratové hodnoty

    • 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

Klíče pro konfiguraci PLC

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".

Tabulka klíčů pro konfiguraci PLC

Networking

Typ klíčeKlíč
IP Addresshwcfg.hwconfiguration.runtime.lwip.ipv4.@ipaddress
Network Maskhwcfg.hwconfiguration.runtime.lwip.ipv4.@mask
Gatewayhwcfg.hwconfiguration.runtime.lwip.ipv4.@gateway
DNShwcfg.hwconfiguration.runtime.lwip.ipv4.@nameserver
Static/DHCPhwcfg.hwconfiguration.runtime.lwip.ipv4.@mode
Network Interface Controller Counthwcfg.hwconfiguration.runtime.advanced.@niccount
Enable Configuration over UDPhwcfg.hwconfiguration.runtime.configservice.@enabled
Config Service Porthwcfg.hwconfiguration.runtime.configservice.@port
Enable HTTPhwcfg.hwconfiguration.runtime.httpservice.@enabled
HTTP Porthwcfg.hwconfiguration.runtime.httpservice.@port
Enable HTTPShwcfg.hwconfiguration.runtime.httpsservice.@enabled
HTTPS Porthwcfg.hwconfiguration.runtime.httpsservice.@port
Redirect HTTP to HTTPShwcfg.hwconfiguration.runtime.httpservice.@redirect

Network Card

Typ klíčeKlíč
Enabled Eth1hwcfg.hwconfiguration.runtime.advanced.nic.@enabled
Ip Configurationhwcfg.hwconfiguration.runtime.advanced.nic.ipv4.@mode
IP Addresshwcfg.hwconfiguration.runtime.advanced.nic.ipv4.@ipaddress
Maskhwcfg.hwconfiguration.runtime.advanced.nic.ipv4.@mask

SSCP Parameters

Typ klíčeKlíč
SSCP Addresshwcfg.hwconfiguration.runtime.sscp.@slaveid
Number of Registrable Groupshwcfg.hwconfiguration.runtime.sscp.@groupscount
Number of Variables in Grouphwcfg.hwconfiguration.runtime.sscp.@groupvariablecount
Enable TCP Serverhwcfg.hwconfiguration.runtime.sscp.tcp.@enabled
TCP Server Porthwcfg.hwconfiguration.runtime.sscp.tcp.@port
Enable SSCP Serialhwcfg.hwconfiguration.runtime.sscp.serial.@enabled
SSCP Serial Porthwcfg.hwconfiguration.runtime.sscp.serial.@port
SSCP Serial Baudratehwcfg.hwconfiguration.runtime.sscp.serial.@baudrate
SSCP Serial Mode (Server/Router)hwcfg.hwconfiguration.runtime.sscp.serial.@mode
Enable SSL Serverhwcfg.hwconfiguration.runtime.sscp.ssl.@enabled
SSL Server Porthwcfg.hwconfiguration.runtime.sscp.ssl.@port

Users Definition

Typ klíčeKlíč
Engineeringhwcfg.hwconfiguration.runtime.sscp.users.user[1].@name
Full Controlhwcfg.hwconfiguration.runtime.sscp.users.user[2].@name
Read Onlyhwcfg.hwconfiguration.runtime.sscp.users.user[3].@name
First Userhwcfg.hwconfiguration.runtime.sscp.users.user[first()].@name
Last Userhwcfg.hwconfiguration.runtime.sscp.users.user[last()].@name

Database Parameters

Typ klíčeKlíč
Enabledhwcfg.hwconfiguration.runtime.rcwaredb.@enabled
Protocolhwcfg.hwconfiguration.runtime.rcwaredb.urls.url[1].@protocol
Hosthwcfg.hwconfiguration.runtime.rcwaredb.urls.url[1].@host
Pathhwcfg.hwconfiguration.runtime.rcwaredb.urls.url[1].@path
Porthwcfg.hwconfiguration.runtime.rcwaredb.urls.url[1].@port
User Namehwcfg.hwconfiguration.runtime.rcwaredb.urls.url[1].@username
Passwordhwcfg.hwconfiguration.runtime.rcwaredb.urls.url[1].@password
Certificate Validationhwcfg.hwconfiguration.runtime.rcwaredb.urls.url[1].@certificatevalidation
Communication Periodhwcfg.hwconfiguration.runtime.rcwaredb.@updateperiod

Proxy Parameters

Typ klíčeKlíč
Enabledhwcfg.hwconfiguration.runtime.proxy.@enabled
Proxy IDhwcfg.hwconfiguration.runtime.proxy.@id
Protocolhwcfg.hwconfiguration.runtime.proxy.urls.url[1].@protocol
Hosthwcfg.hwconfiguration.runtime.proxy.urls.url[1].@host
Pathhwcfg.hwconfiguration.runtime.proxy.urls.url[1].@path
Porthwcfg.hwconfiguration.runtime.proxy.urls.url[1].@port
Certificate Validationhwcfg.hwconfiguration.runtime.proxy.urls.url[1].@certificatevalidation
Keep-alive Periodhwcfg.hwconfiguration.runtime.proxy.@keepalive

Date/Time Settings

Typ klíčeKlíč
UTC Offsethwcfg.hwconfiguration.runtime.sscp.users.user[1].@name
Daylight Offsets Numberhwcfg.hwconfiguration.runtime.sscp.users.user[2].@name
Year 1hwcfg.hwconfiguration.timetransformation.daylights.daylight[1].@year
Year 20hwcfg.hwconfiguration.timetransformation.daylights.daylight[20].@year
First Yearhwcfg.hwconfiguration.timetransformation.daylights.daylight[first].@year
Last Yearhwcfg.hwconfiguration.timetransformation.daylights.daylight[last].@year
Offset Starthwcfg.hwconfiguration.timetransformation.daylights.daylight[1].@start
Offset Endhwcfg.hwconfiguration.timetransformation.daylights.daylight[1].@end
Daylight Offsetshwcfg.hwconfiguration.timetransformation.daylights.daylight[1].@daylightoffset

NTP Server

Typ klíčeKlíč
Protocolhwcfg.hwconfiguration.timetransformation.ntp.urls.url[1].@protocol
Hosthwcfg.hwconfiguration.timetransformation.ntp.urls.url[1].@host
Pathhwcfg.hwconfiguration.timetransformation.ntp.urls.url[1].@path
Porthwcfg.hwconfiguration.timetransformation.ntp.urls.url[1].@port
Certificate Validationhwcfg.hwconfiguration.timetransformation.ntp.urls.url[1].@certificatevalidation
Keep-alive Periodhwcfg.hwconfiguration.timetransformation.ntp.@keepalive

SD Card

Typ klíčeKlíč
Use for Historyhwcfg.hwconfiguration.memorylayout.sdcard.@useforhistory
History Sizehwcfg.hwconfiguration.memorylayout.sdcard.@historysize

Klíče pro dynamické změny v image

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".

Tabulka klíčů pro dynamické změny vlastností komunikačních kanálů

Serial Channel

Typ klíčeKlíč
Port Numberimage."channel_name">ComPort
Baud Rateimage."channel_name">Baudrate
Data Bitsimage."channel_name">Databits
Parityimage."channel_name">Parity
Stop Bitsimage."channel_name">Stopbits
Channel Enableimage."channel_name">Enable

TCP/UDP Channel

Typ klíčeKlíč
Channel Enableimage."channel_name">Enable

Tabulka klíčů pro dynamické změny vlastností komunikačních zařízení

Modbus RTU Device

Typ klíčeKlíč
Device Addressimage."channel_name"."device_name">Address
Device Enableimage."channel_name"."device_name">Enable

Modbus TCP Device

Typ klíčeKlíč
Device Enableimage."channel_name"."device_name">Enable
IPv4image."channel_name"."device_name">Ipv4
Portimage."channel_name"."device_name">Port
Hostimage."channel_name"."device_name">Host
Addressimage."channel_name"."device_name">Address

BACnet Client

Typ klíčeKlíč
IPv4image."channel_name"."device_name">Ipv4
Portimage."channel_name"."device_name">Port
Hostimage."channel_name"."device_name">Host
Device Instanceimage."channel_name"."device_name">DeviceInstance
Device Enableimage."channel_name"."device_name">Enable

BACnet Server

Typ klíčeKlíč
IPv4image."channel_name"."device_name">Ipv4
Portimage."channel_name"."device_name">Port
Device Instanceimage."channel_name"."device_name">DeviceInstance
Management Passwordimage."channel_name"."device_name">MgmtPassword

Daikin

Typ klíčeKlíč
IPv4image."channel_name"."device_name">Ipv4
Portimage."channel_name"."device_name">Port
Hostimage."channel_name"."device_name">Host

Mbus

Typ klíčeKlíč
Primary Addressimage."channel_name"."device_name">Primary
Secondary Addressimage."channel_name"."device_name">Secondary
Use Secondary Addressimage."channel_name"."device_name">UseSecondary
Device Enableimage."channel_name"."device_name">Enable

Tabulka klíčů pro dynamické změny vlastností alarmových kanálů

SMTP

Typ klíčeKlíč
Serverimage."channel_name".Host
Portimage."channel_name".Port
Use Authenticationimage."channel_name".UseAuth
Usernameimage."channel_name".Username
Passwordimage."channel_name".Password
Enable SSLimage."channel_name".Ssl
Certificate Validationimage."channel_name".CertificateValidation

GSM

Typ klíčeKlíč
Port Numberimage."channel_name".ComPort
Baud Rateimage."channel_name".Baudrate
Data Bitsimage."channel_name".Databits
Parityimage."channel_name".Parity
Stop Bitsimage."channel_name".Stopbits