Function Block FS_TOUCH

The Function Block FS_TOUCH creates a new file or changes the date of the last modification on a file system.

The file system must have been initialized beforehand using FS_INIT. All operations are performed asynchronously per storage medium created.

Input DO

A new file is created or the date is changed on a positive edge, provided that the protocol supports the method.

Input DEV

Defines the device from which files are to be accessed. The device is used per project and can be managed in the context menu under Project ▸ External Storage.

Input PATH

Specifies the path to the file on the storage medium. The path corresponds to a Unix file path in UTF-8 format, if this is supported. The path is represented as follows:

Folder/Subfolder/File.txt

Input MTIME

If specified, sets a date and time of the last modification. The format is specified using DT#. If the date is not specified, the current system time of the server is used.

Input ATIME

If specified, sets a date and time of the last access. The format is specified using DT#. If the date is not specified, the time from input MTIME is used.

Output DONE

The output returns a pulse on success to perform the next operation. The pulse occurs at the end of the process, even if an error has occurred.

Output ERROR

In case of an error, returns a text with an error message. This is FALSE if no error has occurred. The state is stored for later use.

Possible causes:

• The service of the storage medium was not started.
• The memory was not initialized.
• The login credentials are invalid.
• The remote server could not be reached.
• The storage medium does not exist.
• The specified path is invalid.
• Writing to the storage medium is not possible.
• No more storage space on the memory or the memory is write-protected.
• The function is not supported by the file system.