Skip to content

Remanent handling

Model config

Declare custom data group with remanent flag true to activate UP remanent handling for that data group.

custom-data-group-remanent

Allocate created custom data group to UP - Model config.

Definition of UP default data groups:

Name Remanent
Config X
Parameter X
Recipe X
Current

For different behavior, create project specific custom data group.

Service Ui

Use Import / Export feature to save and restore remanent data groups to JSON files archive.

Beckhoff

Declare remanent behavior for all remanent custom data groups at platform config beckhoff.

beckhoff-remanent-config

Remanent data groups are generated with PERSISTENT or RETAIN flag. Contact Beckhoff information system for further informations about platform specific behavior.

S7 Tia

No additional configuration required. Custom data group is declared as S7 Tia Retain value.

B&R

Declare remanent behavior for all remanent custom data groups at platform config B&R.

br-remanent-store-option

Data Object

br-remanent

Mode Description
none Completely disables file handler.
mode0_OnlyFileDevice create only file device without filehandler functionality.
mode1_VariableStruct If no runtime DM exist or size not equal to struct read default DM -> create DM else read runtime DM.
mode2_FileDefault If no file on device read cnc-Default -> write file else read file from device.
mode3_FileDefaultAutoInit If cold restart(CF change) -> read cnc-Default -> read file if exist -> write file (Default values not existing init with Default!!!!) otherwise 3 has the same behavior as 2.
mode4_RemanentHandler Global remanent handler for all data items of this data group created. No file handler is created for this data group. Same behavior like deprecated remanent property at Controller.specificInterface for Cur variables.

Job index

Type Job index Description
TSK 0 Task job index for enable, simulation, exist, ... flags.
REM 1 Remanent job index.
ACT 2 File handler for B&R UPact.
Custom data group 3+ File handler for custom data groups start index 3. Order is given by ModelConfig, only remanent data groups are taken into account.

File handler

File handler behavior is given if mode mode1_VariableStruct, mode2_FileDefault or mode3_FileDefaultAutoInit is selected.

Behavior of file hander data groups:

  • Default values are given by: DataObjects/d_par_1.cnc, DataObjects/d_cnf_1.cnc, ...
  • Changed values are lost after restart if no action executed.
  • values are stored to USER partition if save is executed (example at Service Ui): USER/par/f_par, USER/cnf/f_cnf, ...
  • Definition of that files are part of B&R Project: DataObjects/c_par.dat, Data/Objects/c_cnf.dat, ...
  • Saved files are loaded after reboot of B&R PLC.

Remanent handler

Remanent handler behavior is more like usual RETAIN, PERSISTENT management of PLC platforms. All data groups with mode4_RemanentHandler configuration are handled as one global remanent data object.

Behavior of remanent handler data groups:

  • Every 30s remanent handler checks values for changes.
  • If changed, values copied to global remanent data object.
  • Remanent global remanent data object is restored to data group values after reboot of B&R PLC.

Init task

No additional declaration required for init task option. Remanent behavior of data groups is disabled with that option. Initialization of data group default values at i_ctrl_Init task.

No storage

No additional declaration required for no storage option. Default and remanent behavior of data groups is disabled.