字符串通信写出

## [字符串通讯写出]

![](/media/202601/485e1223-8205-479c-bfc4-c4284cf3741c_1768530644.png)

## 模块原理
模块按照设置的协议头、协议尾、分割符号等信息，将连接的图像处理后的数据各种类型的数据类型转换为指定的格式的字符串，并添加协议头尾拼接为一个字符串，最后向指定的普通串口、TCP客户端或者服务端等类型的通讯口写出。

## 使用场景
常用于将连接到模块的图像处理后的数据，按照设置的协议头、协议尾、分割符号等信息转换为指定格式的字符串，并通过指定通讯口输出转换的字符串，。

## 使用方法
前提条件：VG3的工程中配置一个普通串口、TCP客户端或者服务端等类型的通讯口，建立一个图像处理的流程。
1、函数添加树 &rArr; 辅助工具 &rArr; 硬件控制 &rArr; 字符串通讯输出模块，拖拽或者双击添加到流程中的指定位置。
2、选中需要输出的通讯口，当通讯口为服务端时，根据具体情况填写指定客户端IP，一般情况下不用填写。
3、根据具体使用情况添加分割头尾字符、小数处理、连接端口无效时处理等，一般情况下不用填写。

## 参数配置说明
![](/media/202601/522e189c-811f-4cd6-821d-4b56b0bf90aa_1768532694.png)
1、通讯口选择：选需要读取的通讯口，灰色灯表示通讯口未使用；红色灯表示通讯口连接失败；绿色灯表示通讯口正常连接。如果通讯口类型错误则显示通讯口类型，如果通讯口类型为服务端时则显示客户端IP，填写需要输出的客户端IP。
2、客户端IP：当通讯口为服务端时，如果连接的为多个客户端，但只想向指定IP输出值时则需要添加，否则不需要填写。
3、协议头：添加数值转换后的字符串的头部的字符串。
4、协议尾：添加数值转换后的字符串的尾部的字符串。
5、分割符：连接的输入端口之间分隔符；连入的数据之间的分割符号，如：姿态（1，2，3）、点数组（（1，2），（2，3））时，分割符为==,==    则转换为“==1,2,3==”、“==1,2,2,3==”。
6、小数处理：浮点数、点等包含小数的数据类型转字符串时，小数处理：不处理、只保留整数、保留指定位长度的小数。
7、数据无效处理：用于当数字输入端口连接的输出端口的数据为无效时，处理方式：补特殊符输出、默认字符串、不输出。
补特殊符输出：当模块中的数字输入端口连接的输出端口的数据为无效时，需要输出的数据用0补齐。
默认字符串：当模块中有任意一个数字输入端口连接的输出端口的数据为无效时，模块则输出指定的字符串。
不输出：当模块中有任意一个数字输入端口连接的输出端口的数据为无效时，模块则不输出。
8、错误字符串：在补特殊符输出和默认字符串时，用于补值和输出。

![](/media/202601/fefee50d-6cf0-4536-b5ed-d81b21e159fa_1768550116.png)
表中的名称列：双击可修改选中的输入端口的名称。
表中的数据来源：只有在是否订阅列被勾选后，单击可选中模块上方的模块的输出端口。
表中的管脚信息：显示输入端口的数据类型不可修改。
表中的是否订阅：勾选后可以连接外部的模块的输出端口，不勾选则将输入端口数据类型转为字符串，可以通过双击设置输入端口的值。
表中的当前值：只有在是否订阅列不被勾选后，双击可设置输入端口的值。
表的操作有以下操作：
1、加号：点击添加需要输出的输入端口。
2、减号：点击删除选中的输入端口。
3、清空：点击清空所有添加的输入端口。
4、上移：点击上移选中的输入端口。
5、下移：点击下移选中的输入端口。

## 输出说明
![](/media/202601/12d5f2dd-88bd-4376-970b-bf5ee701cd82_1768532708.png)
1、运行结果：指定通讯口数据类型错误或者未连接时写入失败，则为false；当指定通讯口类型正确且连接时写入成功，则为true。
2、写出字符串：将连接到模块的图像处理后的数据，按照设置的协议头、协议尾、分割符号等信息转换为指定格式的字符串。

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