IEC_BACNET_BACKUPRESTORE_INFO (STRUCT)

TYPE IEC_BACNET_BACKUPRESTORE_INFO : STRUCT

This structure contains information for backup and restore procedures started on an BACnet device.

InOut:

Name

Type

Comment

deviceInstance

IEC_BACNET_INST_NUMBER

The device instance number to backup/restore.

password

IEC_BACNET_STRING

The optional password needed for the backup/restore procedure. If no password is needed for this procedure set the string type to BACNET_STRING_NONE.

pszPathToStoredFiles

POINTER TO IEC_BACNET_BYTE

The path to the storage location of file object data received. verbatim This function will store ONE file for each file object which is part of the backup/restore procedure. The filename will have the following format: file-<device-instance>-<index in config file array>-<fileobject instance>.bin An additional file with the name backup-restore-<device-instance>.xml will be created on backup AND is needed on restore which contains information about device file sorting and file data contents.n n <backup-restore> <date>dd-mm-jjjj hh:mm:ss</date> <device> <instance></instance> <object-name>[as hex data first byte encoding next two codepage]</object-name> <location>[as hex data first byte encoding next two codepage]</location> <description>[as hex data first byte encoding next two codepage]</description> <vendor-name>[as hex data first byte encoding next two codepage]</vendor-name> <vendor-id></vendor-id> <model-name>[as hex data first byte encoding next two codepage]</model-name> <firmware-revision>[as hex data first byte encoding next two codepage]</firmware-revision> <application-software-revision>[as hex data first byte encoding next two codepage]</application-software-revision> <database-revision></database-revision> </device> <file> <instance></instance> <file-name></file-name> <access-method></access-method> <object-name>[as hex data first byte encoding next two codepage]</object-name> <description>[as hex data first byte encoding next two codepage]</description> <reported-size></reported-size> <real-size></real-size> <checksum></checksum> </file> … </backup-restore> endverbatim n The stored file data in case of an stream access will be the RAW received octets. In case of an record accessed file there is an 4 byte magic pattern 0xA55AA55A followed by 4 byte octet count in little endian followed by N octets data.