3.6. 通讯配置
通讯配置包括云平台设置，MODBUS 设置，MQTT 设置，数据库设置，网管文件服务器设置，HTTP 设置，HUB 设置，和 MCP 设置等。用户可以根据需要开启一个或多个通讯方式。
通讯配置页面左侧为通讯方式列表（并显示各通讯方式的启用状态），右侧为所选通讯方式的设置。打开对应设置中的“启用”开关后显示全部设置项。除 MCP 设置外，所有设置在点击保存后，需要回到主页点击重启服务以生效。
3.6.1. 云平台配置
Section titled “3.6.1. 云平台配置”点击“启用”开关以启用云平台通讯。
完成云平台设置、保存并重启服务，且网关与云平台连接正常后，可将 HTTP 请求地址改为云平台服务器地址，并在请求 Header 中添加 AccessToken，值为本页设置的网关令牌。操作与示例见 5.1.1. 通过云平台／Hub 转发请求。
启用云平台通讯，完成服务器相关设置，并开启目标机台/机组的自动采集任务（详见 3.3.1.2. 任务设置，与 3.4.1.2. 机组任务设置）后，即可通过标准协议将任务数据实时上传到指定标准云平台，从而实现数据的存储，分析，看板显示等功能。彼络已搭建了一个标准云平台服务器 tb.bivrost.cn，可以联系客服试用。
- 服务器地址处输入云平台地址。
- 网关令牌处输入云平台分配给网关的令牌。
- 启用广播，网关将通过云平台向平台下其它网关广播数据。
- 启用网关关联，网关将通过云平台接收平台下其它网关广播的数据。用户需要在网关关联中补充要关联的网关 UID 和网关令牌。格式如下：
UID,网关令牌;多个关联网关用 ; 隔开。
3.6.2. MODBUS 配置
Section titled “3.6.2. MODBUS 配置”点击“启用”开关以启用 MODBUS 通讯。
启用 MODBUS 通讯，并开启目标机台/机组的自动采集任务（详见 3.3.1.2. 任务设置，与 3.4.1.2. 机组任务设置）后，网关会基于 MODBUS 协议，将任务数据存在相应地址位中，详见六、MODBUS 通讯。
- 32 位型格式选项可以选择 32 位型数据（长型整数 Int32，单精度浮点数 Float 等占用两个寄存器地址的数据）在 MODBUS 通讯中的解码格式。默认为 “DCBA”。
- 64 位型格式选项可以选择 64 位型数据（双精度浮点数 Double 等占用四个寄存器地址的数据）在 MODBUS 通讯中的解码格式。默认为 “HGFEDCBA”。
- 编码选项可以选择 MODBUS 协议字符串编码方式，默认为“中文（GBK）”。
- 反转字符串选项开启后，会反转字符串的顺序。
3.6.3. MQTT 配置
Section titled “3.6.3. MQTT 配置”打开“启用”开关以启用 MQTT 通讯。
启用 MQTT 通讯，并开启目标机台/机组的自动采集任务（详见 3.3.1.2. 任务设置，与 3.4.1.2. 机组任务设置）后，网关会基于 MQTT 协议，将任务数据转化成 JSON 格式的报文，并发布至指定 MQTT 服务器，详见七、MQTT 通讯。
先选择模式，再填写服务器地址与端口。上图展示的是普通 MQTT 模式；此时可设置客户端 ID、匿名登录或用户名和密码，以及数据上报主题和 RPC 主题。选择 GeWu（联通格物云）后，页面改为显示格物专用的网关与子设备产品参数，客户端 ID、普通账号密码和主题不需要手工填写。
- 普通模式的数据上报主题是自动采集任务报告结果时的主题，默认为 “r”。GeWu 模式使用平台规定的子设备属性上报主题，详见 7.1. 数据上报报文格式。
- 普通模式的 RPC 请求主题和 RPC 回复主题用于 RPC 接口，默认为空白，即关闭 RPC 接口。设定这两个选项后，网关会监听 RPC 请求主题，并将请求的结果发布至 RPC 回复主题，详见7.2. RPC 接口。
- 变化值上传选项开启后，机台任务设置与机组任务设置中开启的自动采集任务，只有在采集结果发生变化时才会上传结果。
- 在格物云预先创建物模型、网关产品、机台产品和机组产品，并创建网关设备，取得网关设备密钥。网关采用一机一密认证；机台和机组子设备采用弱校验，无需逐台预创建或填写子设备密钥，但两个子设备产品都必须启用动态注册。
- 将要上报的机台和机组设为启用。其
machineID/groupID会作为格物子设备的deviceKey，必须为 4～32 位 ASCII 字母、数字或下划线；不符合规则的子设备会被跳过。 - 选择 GeWu，填写服务器地址、端口及下表参数，保存后重启服务。网关根据这些参数生成 MQTT 客户端 ID、用户名和签名密码，连接后先把启用的机台和机组添加到网关拓扑，成功后才开始上报数据。
| 页面字段 | 填写内容 |
|---|---|
| 网关产品标识 | 平台上网关产品的 Product Key。 |
| 网关设备标识 | 平台上网关设备的 Device Key，4～32 位 ASCII 字母、数字或下划线。 |
| 网关设备ID | 10～32 位 ASCII 字母、数字或连字符。 |
| 网关设备密钥 | 平台生成的网关设备 Device Secret。 |
| 网关签名算法 | HMAC-SHA256（0）或 HMAC-SM3（1）。 |
| 网关运营商 | 未使用蜂窝网络选 0；中国联通、移动、电信、广电分别选 1、2、3、4。 |
| 机台产品标识 | 平台上机台产品的 Product Key。 |
| 机组产品标识 | 平台上机组产品的 Product Key。 |
三个 Product Key 均为必填，且不能包含 /、+ 或 #。格物云拓扑添加失败时，网关不会开始发送子设备数据；请检查平台产品的动态注册设置和服务日志。
3.6.4. 数据库配置
Section titled “3.6.4. 数据库配置”打开“启用”开关以启用数据库通讯。
启用数据库通讯，并开启目标机台/机组的自动采集任务（详见 3.3.1.2. 任务设置，与 3.4.1.2. 机组任务设置）后，网关将自动采集任务结果数据写入到指定数据库。当前支持的数据库类型包括：SQL Server，MySQL，PostgreSQL，InfluxDB v2.x 等。详见八、数据库通讯。
数据库设置包括：类型，服务器地址，服务器端口，用户名，密码，数据库，表前缀，保存模式，数据保留期限，使用本地时间，启用主键，变化值写入等设置。
- 类型是数据库的类型，包括 SQL Server，MySQL，PostgreSQL，InfluxDB v2.x 等。
- 服务器地址是数据库所在服务器的 IP 地址。
- 服务器端口是数据库所在服务器的端口。
- 用户名密码用于登录数据库。
- 数据库是数据库的名称。
- 表前缀用于在表格默认名称前加上前缀。
- 保存模式选项包括：日志，实时，自定义等。
- 日志模式：每次网关从机台获取到数据时，都会往数据库中写入一条相应记录。数据库中保存所有历史数据记录。
- 实时模式：每次网关从机台获取到数据时，会查找数据库中相应机台的相应记录，并将其更新为最新数据，而不会保存历史数据记录。
- 默认保存模式为自定义模式：点击右侧设置按键，在弹出的“数据库保存模式设置”窗口中，允许用户对每一个任务单独设置为日志模式或实时模式。窗口中，左侧为日志模式，中间为实时模式，右侧为无操作（不记录）。用户可以通过鼠标拖动，将接口移动到需要的模式下。或者点击左右箭头按键将一侧接口全部移动到另一侧。点击窗口外任意位置，退出，然后点击页面保存按键以保存自定义设置。默认当前警报，机台 OEE，机组 OEE 为实时模式，其它数据都为日志模式。
- 数据保留期限，是数据在数据库中保存的期限，单位为小时。如设置为 x，则网关启动后定时执行数据库清理，自动删除 x 小时前的数据。默认为 0，即保留所有数据。
- 使用本地时间选项打开后，在写入数据时，使用 3.12. 设置中所在时区的本地时间，否则使用 UTC 时间。
- 启用主键后，会在数据库所有表格中加一列主键。
- 变化值写入选项开启后，机台任务设置与机组任务设置中开启的自动采集任务，只有在采集结果发生变化时才会写入结果。
3.6.5. 网关文件服务器配置
Section titled “3.6.5. 网关文件服务器配置”打开“启用”开关以启用网关文件服务器。网关文件服务器是网关本地创建的一个文件服务器，机台可通过 FTP 或共享文件夹等方式访问。开启后，3.3.1.3. 程序传输设置中文件服务器类型选项可设置为“网关文件服务器”。
用户名与密码为 FTP 和共享文件夹共用。默认用户名和密码均为 dnc_user。目前仅可以修改密码。
启用 FTP 以支持 FTP 方式登录网关文件服务器。FTP 地址：
ftp://iotgw 或 ftp://网关IP在 FTP 主目录下，每个机台都有单独的文件夹，以机台的 IP 地址命名。
启用共享文件夹以支持共享文件夹方式登录网关文件服务器。每个机台都有单独的共享文件夹，以机台的 IP 地址命名。共享文件夹地址：
\\iotgw\机台IP 或 \\网关IP\机台IP3.6.6. HTTP 设置
Section titled “3.6.6. HTTP 设置”打开“启用”开关以启用 HTTP 设置。
启用 IP 白名单，启用后，除持有有效 JWT 的请求外，其余 API 请求仅限白名单内的 IP。即登录接口不受 IP 白名单限制，登录后以 JWT 方式鉴权的请求跳过白名单检验；以 SecretKey 方式鉴权的请求仍需通过白名单检验。白名单可设置多个 IP 地址，以 “;” 分隔。
3.6.7. Hub 设置
Section titled “3.6.7. Hub 设置”打开“启用”开关以启用 Hub 设置。Hub 服务器用于远程访问网关接口，实现远程修改配置，异地网关数据互通等功能。需联系客服部署。
完成 Hub 设置、保存并重启服务，且网关与 Hub 连接正常后，可将 HTTP 请求地址改为 Hub 服务器地址，并在请求 Header 中添加 AccessToken，值为本页设置的网关令牌。操作与示例见 5.1.1. 通过云平台／Hub 转发请求。
- 服务器地址处输入 Hub 服务器地址。
- 网关令牌处输入 Hub 服务器分配给网关的令牌。
- 启用广播，网关将通过云平台向平台下其它网关广播数据。
- 启用网关关联，网关将通过 Hub 服务器接收其它网关广播的数据。用户需要在网关关联中补充要关联的网关 UID 和网关令牌。格式如下：
UID,网关令牌;多个关联网关用 ; 隔开。
3.6.8. MCP 设置
Section titled “3.6.8. MCP 设置”打开“启用”开关并点击保存以启用 MCP 服务。MCP（Model Context Protocol）服务端把机台数据、数据分析与网关状态以「工具」的形式提供给支持 MCP 的 AI 客户端（如 Claude Code、Claude Desktop 等），用户可以用自然语言查询机台，无需自行调用接口。
接入地址处显示本网关的 MCP 服务端地址（形如 http://192.168.100.1/mcp），供 MCP 客户端配置使用，不可修改。
MCP 服务默认关闭，关闭时访问该地址返回 HTTP 404。当前提供 33 个只读工具，涉及写入、机台控制、程序传输的功能不提供 MCP 工具。鉴权与访问控制沿用 HTTP 接口的设置（密钥、IP 白名单、授权 API），无需在本页单独配置。完整的工具列表、鉴权方式与客户端配置示例详见 九、MCP 服务。
