Mitsubishi Electric MELSEC iQ-R Series, Programming Manual

Page: 1128 / 2110

1126
8 BUILT-IN ETHERNET FUNCTION INSTRUCTIONS
8.5 File Transfer Function Instructions
• Specify the folder path of the transfer destination FTP server in (s3) in Unicode string. The specified folder path shall be a
relative path from home directory of the FTP server. Use one-byte '\' or '/' as a delimiter to specify the boundary of the folder
path.
*1
The maximum number of characters used in the folder path is 255. Note that the total number of characters in a
folder path (including the delimiter at the end) and the file name specified in (s2) must be within the maximum path length
supported by the transfer destination FTP server. The delimiter at the end of a string can be omitted. When omitted, '\' is
assumed to be set at the end. If a nonexistent folder path is specified, a folder is automatically created by the system at
execution of the instruction, and then the processing is performed.
*1 Note that '\' cannot be used as a delimiter for some FTP servers.
• If a NULL character is specified by (s3) or only "0000H" is specified for the device, the CPU module directly accesses under
the home directory of the FTP server. For details, follow the FTP server specifications.
• If a file with the same name exists in the transfer destination, the file will be overwritten.
• The maximum size of a file that can be send is 4G bytes.
• The execution status and the completion status of the SP.FTPPUT instruction can be checked with the completion device
(d) and the completion status indication device (d)+1.
• The following figure shows the execution timing of the SP.FTPPUT instruction.
• SM1392 (FTP client connection status) is on while the CPU module is connected to the FTP server, and SM1392 turns off
when disconnected.
• SM753 (File access in progress) turns on while the SP.FTPPUT instruction is being executed. While SM753 is on, the
SP.FTPPUT instruction cannot be executed. If executed, no processing is performed.
• If the SP.FTPPUT instruction is executed while the SP.FTPPUT or SP.FTPGET instruction is being executed, the instruction
is ignored and not executed until the currently executing instruction completes. When the instruction is ignored, SM699
(Dedicated instruction skip flag) turns on.
(1)Use one-byte '\' or '/' as a delimiter to specify the boundary of the folder path.
*1
(2)The delimiter at the end of string can be omitted.
• Completion device (d)
This device turns on during END processing of the scan where the SP.FTPPUT instruction completes, and turns off during the next END processing.
• Completion status indication device (d)+1
This device turns on or off depending on the completion status of the SP.FTPPUT instruction.
When completed successfully: The device remains off.
When completed with an error: The device turns on during END processing of the scan where the SP.FTPPUT instruction completes, and turns off during the
next END processing. In addition, an error code is stored in the device specified by (s1)+1.
(1)SM1392 turns on during the END processing after the CPU module is connected to the FTP server.
(2)Values are stored upon completion of the instruction.
(3)When all files have been transferred, SM1392 turns off.
255 characters maximum
[… "\database1\recipe\" …]
(2) (1)
END 0 END 0 END 0 END 0
OFF
OFF
(2)
(1)
(3)
OFF
OFF
ON
ON
Sequence scan
FTP client connection status
(SM1392)
Total number of files to be
transferred (s1)+2
Completion status (s1)+1
Number of transferred files
(s1)+3
SP.FTPPUT instruction
Completion device (d)
Completion status
indication device (d)+1
Execution of the instruction
File transfer
Completed with an error
Completed successfully
1 scan