FP_FTP_SET_CONNECTION

用于FTP连接的服务器设置

此FP指令将根据指定参数定义用于连接CPU中指定的FTP客户端的服务器设置。

参数

输入

sServer (STRING)

服务器地址（须输入参数）

关键字：SV

值：SV0–SV3（服务器0–服务器3）
IP地址或主机名称（须输入参数）。
- IP地址
  
  对于IP地址，请在开头指定关键字IPv4或IPv6。
  
  IPv4的语法：例如'IPv4=111.122.133.144'
  
  IPv6的语法：例如'IPv6=1111:122:2:1555:0:0:1888'
  
  请注意，对于IPv4地址有范围限制。当使用指令指定了无效的IP地址时，将不会出现任何运算错误，但输出bError将设置为TRUE。
- 主机名
  
  关键字： HOST
  
  语法：：例如'HOST=FTP.pidsx.com'
端口号（可选参数）

关键字： 'PORT'

语法： 'PORT=xxxxx'

值：1–65535（默认值：21）
打开方法（可选参数）

关键字： OPEN

语法：'OPEN=xxxx'

值： act（主动），pasv（被动）（默认值：act）
SSL3/TSL1验证（可选参数）

指定是否使用SSL3/TSL1验证。

关键字：
- SSL：使用SSL3/TLS1
- NON：不使用SSL3/TLS1（默认）

示例：

要想连接到FTP服务器0（IP地址为192.255.2.10、端口号为21、打开方法为主动），使用SSL3/TLS1身份验证：‘SV0,IPv4=192.255.2.10,PORT=21,OPEN=act,SSL’
要想连接到FTP服务器1（IP地址为1111:1222::1555:0:0:1888、端口号被省略（使用默认端口21）、开放方法被省略（使用默认值 = 主动）），使用SSL3/TLS1身份验证：‘SV1,IPv6=1111:1222::1555:0:0:1888,SSL’
要想连接到FTP服务器2（主机名为FTP.pidsx.com、端口号为28、打开方法为被动），请勿使用身份验证：‘SV2,HOST=FTP.pidsx.com,PORT=28,OPEN=pasv,NON’

sLogin (STRING)

设置登录数据

用户名（最多32个字符）

关键字： USER

语法： 'USER=xxx'（默认：root）。使用'USER='来删除用户名。
密码（最多32个字符，大小写字符均可使用）

关键字： PASS

语法： 'PASS=passwd'（默认：root）。使用'PASS='来删除密码。

对于此参数，还有两个额外的关键字可用：

初始化：将用户名和密码重置为默认设置“root”和“root”。
保留：保留当前登录设置。

示例：

将用户名设置为“Admin”，密码设置为“Panasonic”：'USER=Admin,PASS=Panasonic'
将用户名设置为“Supervisor”并删除密码：'USER=Supervisor,PASS='
将用户名和密码重置为默认值：'INITIAL'
删除用户名和密码：'USER=,PASS='
将用户名和密码重置为默认值：'INITIAL'
保留当前的用户名和密码：'KEEP'

sCommunication (STRING)

根据需要设置可选通信参数。

连接超时

关键字： TOUT

语法： 'TOUT=xxx'（默认：60秒）

值：30–300秒
重试次数

关键字： RTRY

语法： 'RTRY=x'（默认：3次）

值：0–3
重试间隔

关键字： RTTM

语法： 'RTTM=xxxxx'（默认：600秒）

值：10-86400秒

可以10秒为单位指定数值。将向下舍入到整十数。

示例：指定38秒时，将设置为30秒。

对于此参数，还有两个额外的关键字可用：

INITIAL：重置连接超时、重试次数和重试间隔默认设置。
KEEP：保留当前通信设置。

示例：

设置连接超时：30秒，重试次数：2次，重试间隔：500秒：'TOUT=30,RTRY=2,RTTM=500'
设置连接超时：270秒，不可重试，重试间隔：4900秒：'TOUT=270,RTRY=0,RTTM=4900'
设置连接超时：30秒，重试次数：25次，重试间隔：请勿更改：'TOUT=30,RTRY=25'
设置连接超时：请勿更改，重试次数：25次，重试间隔：3000秒：',RTRY=25,RTTM=3000'
重置为默认设置（连接超时：60秒，重试次数：3次，重试间隔：600秒）：'INITIAL'
保留所有当前设置：'KEEP'

输出

bError (BOOL)

在以下情况下将变为TRUE：

如果超过连接超时
如果 IP 地址无效

当发生错误时，针对错误代码编号检查系统变量sys_iEthernetConnectionErrorCode。

标注

通过逗号分隔所有关键字输入。例如：'NAME=abcd,FROM=sender@server.com'
字符串数据的字符数不得超过256。
此指令不可用于中断程序。
大小写字符均可用于可指定字符常量的操作数。“Abcd”、“ABCD”和“abcd”意义相同，但是，文件名区分大小写。
执行此指令前，确保sys_bIsEthernetInitializing为FALSE。sys_bIsEthernetInitializing在执行指令后将变为TRUE。sys_bIsEthernetInitializing为TRUE时，执行指令将发生错误。
仅当指定传输设置的传输请求标志或指定的nLogID编号为FALSE时，才能执行该指令。当传输请求标志为TRUE时，将发生运算错误。
成功执行此指令后，会重置系统变量sys_bIsCarry和sys_iEthernetConnectionErrorCode。
当发生错误时，针对错误代码编号检查系统变量sys_iEthernetConnectionErrorCode。

错误标志

sys_bIsOperationErrorHold（变为TRUE并保持为TRUE）

如果为参数指定的值超出允许的范围。
如果指定相同关键字超过一次
在执行指令后，如果指定传输设置的传输请求标志为“TRUE：请求传输”。
如果指定nLogID编号的传输请求标志为TRUE，例如，如果sys_blsLog0DataRecordingActive为TRUE。
如果未按升序指定服务器编号。
如果指令是在中断程序中执行的。
如果字符串数据的字符数超过256。

sys_bIsOperationErrorNonHold（对于一次扫描变为TRUE）

如果为参数指定的值超出允许的范围。
如果指定相同关键字超过一次
在执行指令后，如果指定传输设置的传输请求标志为“TRUE：请求传输”。
如果指定nLogID编号的传输请求标志为TRUE，例如，如果sys_blsLog0DataRecordingActive为TRUE。
如果未按升序指定服务器编号。
如果指令是在中断程序中执行的。
如果字符串数据的字符数超过256。

sys_bIsCarry（对于一次扫描变为TRUE）

如果指令是通过错误的IP地址执行的，则sys_iEthernetConnectionErrorCode设置为“1：指定了错误的IP地址”
如果指令是在以太网初始化期间执行的，则sys_iEthernetConnectionErrorCode设置为“11：以太网正在初始化”。

示例

POU头

所有用于编程此函数的输入和输出变量已在POU头中声明。所有编程语言使用相同的POU头。

	VAR
		bError: BOOL:=FALSE;
		wErrorCode: WORD:=0;
		bSetConnectionOK: BOOL:=FALSE;
		bSetConnectionError: BOOL:=FALSE;
		bSetConnection: BOOL:=FALSE;
	END_VAR

POU本体

如果bSetConnection从FALSE更改为TRUE且sys_bIsEthernetInitializing为FALSE，则执行指令。

LD本体

BODY
    WORKSPACE
        NETWORK_LIST_TYPE := NWTYPELD ;
        ACTIVE_NETWORK := 0 ;
    END_WORKSPACE
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 9 ;
        NETWORK_BODY
B(B_CONTACT,,bSetConnection,5,1,7,3,R);
B(B_CONTACT,,sys_bIsEthernetInitializing,16,1,18,3,N);
B(B_VARIN,,'SV0~IPv4=192.168.178.64~PORT=21~OPEN=pasv~NON',21,5,23,7,);
B(B_VARIN,,'USER=user~PASS=user',21,6,23,8,);
B(B_VARIN,,'TOUT=30~RTRY=0~RTTM=120',21,7,23,9,);
B(B_VAROUT,,bSetConnectionError,36,5,38,7,);
B(B_F,FP_FTP_SET_CONNECTION!,,23,3,36,9,,?DEN?DsServer?DsLogin?DsCommunication?AENO?CbError);
L(7,2,16,2);
L(1,2,5,2);
L(18,2,18,5);
L(18,5,23,5);
L(1,0,1,9);
        END_NETWORK_BODY
    END_NET_WORK
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 4 ;
        NETWORK_BODY
B(B_CONTACT,,bSetConnectionError,6,1,8,3,);
B(B_F,E_MOVE!,,25,0,31,4,,?DEN?D?AENO?C);
B(B_VARIN,,sys_iEthernetConnectionErrorCode,23,2,25,4,);
B(B_VAROUT,,wErrorCode,31,2,33,4,);
L(8,2,25,2);
L(1,2,6,2);
L(1,0,1,4);
        END_NETWORK_BODY
    END_NET_WORK
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 3 ;
        NETWORK_BODY
B(B_CONTACT,,bError,6,1,8,3,N);
B(B_COIL,,bSetConnectionOK,28,1,30,3,);
L(8,2,28,2);
L(1,2,6,2);
L(1,0,1,3);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

ST本体

If DF(bSetConnection) AND NOT sys_bIsEthernetInitializing then
    FP_FTP_SET_CONNECTION(sServer := 'SV0,IPv4=192.168.178.64,PORT=21,OPEN=pasv,NON',
                          sLogin := 'USER=user,PASS=user',
                          sCommunication := 'TOUT=30,RTRY=0,RTTM=120', 
                    bError => bSetConnectionError);
End_if;
If (bSetConnectionError) then
    wErrorCode := sys_iEthernetConnectionErrorCode;
End_if;
If NOT bError then
    bSetConnectionOK := TRUE;
End_if;