字符串指令控制

## 字符串指令控制

![](/media/202601/5ed2c383-077e-4bcf-9064-c6bcf778f2e4_1768532768.png)

## 使用场景
用于通讯流程中字符串类型的通讯口（如：普通串口、客户端、服务端等）可以快速实现启动、停止、触发线程、写入全局变量等功能。通讯的格式为：协议头+指令+分隔符+参数1+分隔符+参数2...+协议尾。如：协议头为CY；协议尾为END；分割符为，；当触发线程1指令为T1，则触发线程1的字符串为CYT1END；当触发线程1并写入指定的姿态类型全局变量的指令为T，则写入全局变量后触发线程1的字符串为CYT，1，2，3END。

## 使用方法
前提条件：VG3的工程中配置一个普通串口、TCP客户端或者服务端等类型的通讯口，并建议在全局流程树中创建一个连续运行的通讯流程，并选中编辑这个通讯流程。
1、函数添加树 &rArr; 辅助工具 &rArr; 硬件控制 &rArr; 字符串指令控制，拖拽或者双击添加到指定位置。
2、选中需要读取的通讯口，当通讯口为服务端时，根据具体情况填写指定客户端IP，一般情况下不用填写。
3、根据具体使用情况添加分割头尾字符等，一般情况下不用填写。
4、增删对应的指令、动作类型、动作参数等。
注意：由于字符串通讯读入模块常添加到连续运行的通讯流程中，一般一个通讯口有且只会使用一个字符串通讯读入模块；多个模块时，大概率会出现某些模块读取不到数据的问题。

## 参数配置说明
![](/media/202601/eb321581-7bed-4d39-be4e-d660ef847361_1768532910.png)
1、通讯口选择：选需要读取的通讯口，灰色灯表示通讯口未使用；红色灯表示通讯口连接失败；绿色灯表示通讯口正常连接。指定的通讯口类型为串口、tcp客户端、tcp服务端等支持的字符串通讯的设备时，客户端IP、开始符、结束符等参数信息；否则显示指定通讯口的类型。
2、客户端IP：
3、开始符：用于判断和去除收到的字符串的头部，如果头部不相同则说明不是需要的内容不处理，相同则在处理时去除掉。当开始符为空时，则不进行判断和去除。
4、结束符：用于判断和去除收到的字符串的尾部，如果尾部不相同则说明不是需要的内容不处理，相同则在处理时去除掉。当结束符为空时，则不进行判断和去除。
5、分割符：主要于分割去除开始符和结束符后的字符串，将其转换为指令和参数。

表中的名称列：双击可修改选中的指令的名称。
表中的指令字符串：触发指定动作需要的指令字符串。
表中的动作类型：指定对应的动作类型，支持的动作类型有：启动、停止、复位、切换配方、触发线程、写入全局变量、写入全局变量后触发线程、根据参数切换配方、根据参数触发流程。
表中的动作参数：指令对应的动作的参数，如：触发线程中的线程。
表中的关联全局变量：只有动作类型为写入全局变量、写入全局变量后触发线程时有效，指定要关联的全局变量。
表中的输出值：输出对应的整数值，方便后期还可以进行其他的操作。

表的操作有以下操作：
1、加号：点击添加需要的指令。
2、减号：点击删除选中的指令。
3、清空：点击清空所有添加的指令。

## 输出说明

![](/media/202601/78ede5ae-2246-4e65-a19d-e798ab3e27aa_1768532930.png)
1、运行结果：指定通讯口数据类型错误或者未连接时写入失败，则为false；当指定通讯口类型正确且连接时写入成功，则为true。
2、读取字符串：指定通讯口读取到的字符串。
3、读取字符串长度：指定通讯口读取到的字符串的长度。
4、动作返回值：如果读取到的字符串引发了添加的动作，则返回指定的的动作的输出值。没有动作时，只返回0。

## 其他补充
支持的指令方式有：启动、停止、切换配方、触发流程、写入值（即写入全局变量）、写入值后触发流程、根据参数切换配方、根据参数触发流程。

点击此处跳转到对应的中文说明书文章页:&nbsp;[String Command Control](/doc/564)