通信
TCP服务端
作为 TCP 服务端监听本地端口并管理多个客户端，可启停监听、向客户端下发数据、取出排队帧或断开连接，收到的帧按客户端分别缓存TcpServerTool · v1.0 · by system
输入参数 9
| 名称 | keyId | 类型 | 默认值 | 可连接 | 说明 |
|---|---|---|---|---|---|
| 通信配置ID | commId | enum | （空） | 否 | 填入 HardwareConfig 通信配置编号后改用 hub 常驻服务端并共享接收状态，留空则由本工具自建监听、自行维护客户端集合与帧队列 |
| 监听端口 | port | int | 9000 | 否 | 服务端监听的本地端口，合法范围 1~65535，默认 9000；start 时取 0、负数或大于 65535 会返回 -1 并在运行信息提示 port 缺失或非法 |
| 最大连接数 | maxConnections | int | 64 | 否 | 允许同时接入的最大客户端数量，默认 64，start 操作时把该上限交给底层监听组件；未填写时底层采用其自带的默认接入上限 |
| 操作 | operation | enum | start | 否 | 指定本次执行的动作，默认 start：start 启动监听、stop 停止服务、send 向指定客户端下发数据、disconnect 断开指定客户端，另可用 recv 从某客户端取出一帧 |
| 客户端fd | clientFd | int | -1 | 否 | send、disconnect 与 recv 操作定位目标客户端所用的文件描述符编号，默认 -1；这些操作在未填写该编号时返回 -1 并在运行信息提示 clientFd 缺失 |
| 发送数据 | data | string | （空） | 否 | send 操作要下发给指定客户端的文本内容，仅在服务端已运行且 clientFd 有效时发送；服务器未运行或该字段缺失都会返回 -1 并在运行信息给出原因 |
| 组帧模式 | frameMode | enum | length-prefix | 否 | 接收与下发采用的组帧方式，默认 length-prefix：长度前缀帧或 delimiter 分隔符帧可用，服务端不支持 raw 原始流，start 时选 raw 或配置非法返回 -1 |
| 长度字段字节数 | lengthFieldBytes | int | 4 | 否 | 仅 length-prefix 模式下长度字段所占字节数，默认 4，可取 1、2、4、8；取值非法使组帧配置校验失败，start 返回 -1 并提示组帧参数错误 |
| 帧分隔符 | frameDelimiter | string | \r\n | 否 | 仅 delimiter 模式下切帧所用的分隔符，默认回车换行且允许多字节，解帧后从载荷中剔除；服务端 start 时组帧配置非法会返回 -1 并提示错误 |
输出参数 5
| 名称 | keyId | 类型 | 默认值 | 可连接 | 说明 |
|---|---|---|---|---|---|
| 运行结果 | resultCode | int | — | 否 | 0=对应操作成功完成并写出该操作的状态与数据；-1=参数非法、服务器未运行、发送失败、队列无完整帧或未知操作时返回，运行信息给出具体原因 |
| 运行信息 | resultInfo | string | — | 否 | 本次操作的执行状态描述，成功时写明服务器已启动、已发送到某 fd 或已取到完整帧，失败时给出端口非法、组帧参数错误、暂无完整帧等具体原因 |
| 当前连接数 | active_count | int | — | 否 | 当前已接入的客户端数量，每次操作开始都会写出；stop 停止服务时清零，disconnect 移除目标客户端后同步减小，常驻路径从共享接收态读取该计数 |
| 帧数据 | response | string | — | 否 | recv 操作从指定客户端帧队列取出的一帧载荷，仅在成功取到完整帧时写出；队列中没有完整帧时该操作返回 -1 且本输出不产生 |
| 待取帧数 | pending_count | int | — | 否 | recv 操作取走一帧后目标客户端队列中剩余的待取帧数，无论本次是否取到帧都会写出；配合帧数据可用于判断该客户端是否还有积压帧 |
接入方式
联系与反馈
获取安装包与技术反馈
安装包通过微信二维码获取。安装部署、界面组态与工具配置过程中的问题，可通过同一渠道反馈，无需注册或填写表单。
- 安装包获取与部署说明
- 界面组态与工具配置
- 功能建议与问题反馈
微信扫码 · 安装包与问题反馈