# TCPServer

您可以使用 TCPServer 函数将电子表格单元格定义为 TCP/IP 服务器，它监听另一个 TCP/IP 设备的连接以通过网络连接和共享数据。

注意:

- TCPServer 在收到数据包后生成事件。此事件更新电子表格。

- TCPServer 只接受一个已建立的连接。如果在已有连接的情况下出现新的连接请求，则旧连接将关闭，新连接将取代它。

## TCPServer 输入

参数 | 说明
--- | ---
端口号 | 指定端口号，TCPServer从该端口号接收 TCP/IP 设备的连接。端口号是一个无符号的 16 位端口号。0 不是有效端口。默认端口号为 3000。 注意: 您需要在服务器上分配此处输入的端口号。
数据包类型 | 定义在 TCP/IP 设备之间通信的数据字符串的格式。
类型 | 说明
--- | ---
0 = 字符串 CR+LF（默认） | ASCII 格式。在 TCP Spreadsheet 函数发送时，软件将 ASCII 字符 13（回车）和 10（换行）追加到数据字符串；接收时，CR+LF 结束数据字符串。
1 = 字符串 CR (13) | ASCII 格式。在 TCP Spreadsheet 函数发送时，软件将 ASCII 字符 13（回车）追加到数据字符串；接收时，CR 终止数据字符串。
2 = 字符串 LF (10) | ASCII 格式。在发送 TCP 电子表格函数时，软件将 ASCII 字符 10（换行）追加到数据字符串；接收时，LF 终止数据字符串。
3 = 字符串 Nullchar (0) | ASCII 格式。在发送 TCP 电子表格函数时，软件将 ASCII 字符 0 (Nullchar) 追加到数据字符串；接收时，Nullchar 终止数据字符串。 注意: 无论数据包类型如何，在 In-Sight 视觉系统 接收数据时，ASCII 字符 0 (Nullchar) 终止数据字符串。
5 = 带有自定义终止符的字符串 | ASCII 格式。TCP Spreadsheet 函数发送时，软件将指定的终止符追加到数据字符串；接收时，指定的终止符终止数据字符串。
终止符 | 指定在为数据包类型指定带客户终止符的字符串或带客户终止符的二进制时使用的字节值。
最大数据包大小 | 指定 TCPServer 可以接收的最大数据包大小。如果远程发送者超过最大数据包大小，ReadDevice 显示 #ERR。

## TCPServer 输出

返回 | Device 数据结构。如果任何输入参数无效，则返回 #ERR。
结果 | 在将 TCPServer 函数插入单元格时，WriteDevice 函数会自动插入到右侧的相邻单元格中。