SendCharacters

通过CPU或MCU端口发送字符

此指令将数据写入发送缓冲区并通过执行F159_MTRN发送数据.。要发送的数据将应用于sString。发送缓冲区为应用于SendBuffer的VAR_IN_OUT变量。如果bSuppressEndCode设置为TRUE，在系统寄存器中选择的结束代码不会增加到发送字符串。

与指令SendCharactersAndClearString不同，应用于sString的字符串变量保持不变。

参数

输入

Port (WORD, INT, UINT)

根据PLC的类型指定通信端口：

COM端口，例如SYS_COM0_PORT
以太网端口，例如SYS_ETHERNET_USER_CONNECTION_1
MCU/SCU，例如COM01中的16#xx01（xx = 插槽编号）

sString (STRING)

存储发送字符串

bSuppressEndCode (BOOL)

在系统寄存器中选择的结束代码不会增加到发送字符串。

输入/输出

SendBuffer (ANY): 暂时存储发送字符串

标注

发送了指定字节数后，"发送完成"标志将变为TRUE。可能会发送或接收新数据。任意发送指令均会将"发送完成"标志变为FALSE并将无法接收数据。在无法期望任何响应的情况时，"发送完成"标志的评价可能会起到作用。例如：广播信息。

错误标志

sys_bIsOperationErrorHold（变为TRUE并保持为TRUE）

如果指定插槽中不存在MCU单元或应发送零字节。
如果在MEWTOCOL-COM主站/从站模式中指定16#8000

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

如果指定插槽中不存在MCU单元或应发送零字节。
如果在MEWTOCOL-COM主站/从站模式中指定16#8000

示例

POU头

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

	VAR
		bSend: BOOL:=FALSE;
			(*activates function*)
		sSendData: STRING[30]:='ABCDEFGH';
			(*up to 30 chars*)
		awSendBuffer: ARRAY [0..15] OF WORD:=[16(0)];
			(*for 30 chars + 1 word*)
		bSuppressEndCode: BOOL:=FALSE;
	END_VAR

LD本体

如果bSend从FALSE变为TRUE，指令将通过MCU端口1发送sSendData的字符。字符被复制到数组awSendBuffer。对要发送的字符串字符数保留awSendBuffer[0]。

BODY
    WORKSPACE
        NETWORK_LIST_TYPE := NWTYPELD ;
        ACTIVE_NETWORK := 0 ;
    END_WORKSPACE
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 7 ;
        NETWORK_BODY
B(B_CONTACT,,bSend,9,1,11,3,R);
B(B_VARIN,,1,11,2,13,4,);
B(B_VARIN,,sSendData,11,3,13,5,);
B(B_VARIN,,awSendBuffer,11,5,13,7,);
B(B_VARIN,,bSuppressEndCode,11,4,13,6,);
B(B_F,E_SendCharacters!,,13,0,24,7,,?DEN?DPort?DsString?DbSuppressEndCode?DSendBuffer?ASendBuffer?AENO);
L(1,2,9,2);
L(11,2,13,2);
L(1,0,1,7);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

ST本体

if (DF(bSend)) then
    SendCharacters(Port := 1, sString := sSendData, bSuppressEndCode := bSuppressEndCode, SendBuffer := awSendBuffer);
end_if;