FP_HTTP_SET_CONNECTION

用于HTTP连接的服务器设置

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

参数

输入

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=HTTP.pidsx.com'

  • 端口号 （可选参数）

    关键字： 'PORT'

    语法：'PORT=xxxxx'

    值：1–65535（默认值：80）

  • SSL3/TSL1验证（可选参数）

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

    关键字：

    • SSL：使用SSL3/TLS1

    • NON：不使用SSL3/TLS1（默认）

示例：

  1. 要想连接到HTTP服务器0（IP地址为192.255.2.10、端口号为80），使用SSL3/TLS1身份验证：‘SV0,IPv4=192.255.2.10,PORT=80,SSL’

  2. 要想连接到HTTP服务器1（IP地址为1111:1222::1555:0:0:1888、端口号为8080），使用SSL3/TLS1身份验证：‘SV1,IPv6=1111:1222::1555:0:0:1888,PORT=8080,SSL’

  3. 要想连接到HTTP服务器2（主机名为HTTP.pidsx.com、端口号为80），请勿使用身份验证：‘SV2,HOST=HTTP.pidsx.com,PORT=80,NON’

sLogin (STRING)

设置登录数据

  • 用户名（最多32个字符）

    关键字： USER

    语法： 'USER=xxx'（默认：root）。使用'USER='来删除用户名。

  • 密码（最多32个字符，大小写字符均可使用）

    关键字： PASS

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

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

  • 初始化：将用户名和密码重置为默认设置“root”和“root”。

  • 保留：保留当前登录设置。

示例：

  1. 将用户名设置为“Admin”，密码设置为“Panasonic”：'USER=Admin,PASS=Panasonic'

  2. 将用户名设置为“Supervisor”并删除密码：'USER=Supervisor,PASS='

  3. 将用户名设置为“Support”，请勿更改密码：'USER=Support'

  4. 删除用户名和密码：'USER=,PASS='

  5. 将用户名和密码重置为默认值：'INITIAL'

  6. 保留当前的用户名和密码：'KEEP'
sCommunication (STRING)

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

  • 连接超时

    关键字： TOUT

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

    值：30–300秒

  • 重试次数

    关键字： RTRY

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

    值：0–3

  • 重试间隔

    关键字： RTTM

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

    值：10-86400秒

    可以10秒为单位指定数值。将向下舍入到整十数。 示例：指定38秒时，将设置为30秒。

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

  • 初始化：重置连接超时、重试次数和重试间隔默认设置。

  • KEEP：保留当前通信设置。

示例：

  1. 设置连接超时：30秒，重试次数：2次，重试间隔：500秒：'TOUT=30,RTRY=2,RTTM=500'

  2. 设置连接超时：270秒，不可重试，重试间隔：4900秒：'TOUT=270,RTRY=0,RTTM=4900'

  3. 设置连接超时：30秒，重试次数：25次，重试间隔：请勿更改：'TOUT=30,RTRY=25'

  4. 设置连接超时：请勿更改，重试次数：25次，重试间隔：3000秒：',RTRY=25,RTTM=3000'

  5. 重置为默认设置（连接超时：60秒，重试次数：3次，重试间隔：600秒）：'INITIAL'

  6. 保留所有当前设置：'KEEP'

输出

bError (BOOL)

在以下情况下将变为TRUE：

  • 如果超过连接超时

  • 如果 IP 地址无效

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

标注

  • 通过逗号分隔所有关键字输入。例如：'NAME=abcd,FROM=sender@server.com'

  • 字符串数据的字符数不得超过256。

  • 此指令不可用于中断程序。

  • 请勿更改关键字的顺序。按照此处所列顺序指定关键字及其设置参数。

  • 可省略部分参数语法。省略部分参数时不会更改设置。

  • 省略指定关键字前面的部分时，仅省略该关键字，而不省略分隔关键字的逗号“,”：',RTRY=25,RTTM=3000'。

  • 省略指定关键字后面的部分时，同时省略逗号“,”和关键字：'TOUT=30,RTRY=25'。

  • 请勿指定相同关键字超过一次。如果指定相同关键字超过一次，则会发生错误。

  • 大小写字符均可用于可指定字符常量的操作数。“Abcd”、“ABCD”和“abcd”意义相同，但是，文件名区分大小写。

  • 执行此指令前，确保sys_bIsEthernetInitializing为FALSE。sys_bIsEthernetInitializing在执行指令后将变为TRUE。sys_bIsEthernetInitializing为TRUE时，执行指令将发生错误。

  • 仅当指定传输设置的传输请求标志为“FALSE: No transfer request”时，可以执行该指令。当传输请求标志为“TRUE: Transfer requested”时，将出现操作错误。

  • 成功执行此指令后，会重置系统变量sys_bIsCarry和sys_iEthernetConnectionErrorCode。

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

错误标志

sys_bIsOperationErrorHold（变为TRUE并保持为TRUE）

  • 如果为参数指定的值超出允许的范围。

  • 如果指定相同关键字超过一次

  • 在执行指令后，如果指定传输设置的传输请求标志为“TRUE：请求传输”。

  • 如果未按升序指定服务器编号。

  • 如果指令是在中断程序中执行的。

  • 如果字符串数据的字符数超过256。

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

  • 如果为参数指定的值超出允许的范围。

  • 如果指定相同关键字超过一次

  • 在执行指令后，如果指定传输设置的传输请求标志为“TRUE：请求传输”。

  • 如果未按升序指定服务器编号。

  • 如果指令是在中断程序中执行的。

  • 如果字符串数据的字符数超过256。

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

  • 如果指令是通过错误的IP地址执行的，则sys_iEthernetConnectionErrorCode设置为“1：指定了错误的IP地址”

  • 如果指令是在以太网初始化期间执行的，则sys_iEthernetConnectionErrorCode设置为“11：以太网正在初始化”。

相关主题

sys_iEthernetConnectionErrorCode

系统指令

指令窗格

内存区

数据类型

父主题： FP指令

示例

POU头

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

	VAR
		bSetConnectionError: BOOL:=FALSE;
		bSetConnection: BOOL:=FALSE;
		wErrorCode: WORD:=0;
		bSetConnectionOK: 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 := 10 ;
        NETWORK_BODY
B(B_VARIN,,'SV1~IPv4=192.255.2.10~PORT=21~OPEN=act~SSL',20,6,22,8,);
B(B_VARIN,,'USER=root~PASS=passwd',20,7,22,9,);
B(B_VARIN,,'TOUT=30~RTRY=2~RTTM=500',20,8,22,10,);
B(B_CONTACT,,bSetConnection,4,1,6,3,R);
B(B_VAROUT,,bSetConnectionError,36,6,38,8,);
B(B_CONTACT,,sys_bIsEthernetInitializing,17,1,19,3,N);
B(B_F,FP_HTTP_SET_CONNECTION!,,22,4,36,10,,?DEN?DsServer?DsLogin?DsCommunication?AENO?CbError);
L(1,2,4,2);
L(6,2,17,2);
L(19,2,19,6);
L(19,6,22,6);
L(1,0,1,10);
        END_NETWORK_BODY
    END_NET_WORK
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 4 ;
        NETWORK_BODY
B(B_CONTACT,,bSetConnectionError,4,1,6,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(6,2,25,2);
L(1,2,4,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,,bSetConnectionError,4,1,6,3,N);
B(B_COIL,,bSetConnectionOK,28,1,30,3,);
L(6,2,28,2);
L(1,2,4,2);
L(1,0,1,3);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

ST本体

If DF(bSetConnection) AND NOT sys_bIsEthernetInitializing then
    FP_HTTP_SET_CONNECTION(sServer := 'SV1,IPv4=192.255.2.10,PORT=21,OPEN=act,SSL',
                           sLogin := 'USER=root,PASS=passwd',
                           sCommunication := 'TOUT=30,RTRY=2,RTTM=500', 
                           bError => bSetConnectionError);
End_if;
If (bSetConnectionError) then
    wErrorCode := sys_iEthernetConnectionErrorCode;
Else
    bSetConnectionOK := True;   
End_if;

最后更新日期： 2024-03-07此页面上的反馈松下热线