版本变更历史记录

v1.19.7.60（2026-10-16）

发布时间：2026-10-16

1. 新增汇川 PLC Easy、H5U、H3U/S、H1U/S、EVO、AM、AC 系列及其它型号的数据读写支持，按型号提供网口、串口转网口、EasyNet、Connected CIP 和 OPC UA 连接。

v1.19.7.57（2026-10-13）

发布时间：2026-10-13

1. 机台配置中哈斯型号“串口”统一显示为“串口转网口”，已有机台配置保持兼容。
2. 修正中文机台配置窗口的必填项提示，统一使用简体中文。

v1.19.7.56（2026-10-12）

发布时间：2026-10-12

1. 3.12.6.3. 恢复出厂配置：移至“备份与恢复”卡片，窗口标题与按钮统一为“恢复出厂配置”；在网关本地网页和 Hub 中均需输入网关管理员用户名和密码，完成后需等待数分钟初始化本地数据库。
2. 3.12. 设置：按账户菜单与设置卡片顺序介绍，补充并更新中英文截图，修正文中加粗显示。
3. 修复在线文档搜索部分中文短语无结果的问题。

v1.19.7.55（2026-10-12）

发布时间：2026-10-12

1. 3.12.6.3. 恢复出厂配置：管理员可在设置页清除业务配置、账号、本地采集数据、日志、积压队列和加工程序，保留许可、网络及安装配置；支持从 Hub 发起，集群成员须先退出集群，完成后使用 admin/admin 登录。

v1.19.7.54（2026-10-08）

发布时间：2026-10-08

1. 优化管理界面显示。

v1.19.7.53（2026-09-29）

发布时间：2026-09-29

1. 《3.9.3. 发送本地文件到机台》：新代机台发送文件中途断线时返回新错误码 132（CNCWRAPPER_SEND_FILE_INTERRUPTED，机台上可能留有不完整的程序），原先返回网络错误；网页随后刷新该机台目录以显示残留，重试发送即覆盖。

v1.19.7.51（2026-09-28）

发布时间：2026-09-28

1. 5.9.3.7. duplicate-machine 复制机台配置按授权数控制激活：模板机台已激活时，超出授权数的复制机台改为未激活，statusMsg 返回 More activated machines than licensed.。

v1.19.7.48（2026-09-23）

发布时间：2026-09-23

1. 3.6.3. MQTT 配置新增联通格物云 GeWu 接入：网关使用一机一密，机台与机组作为启用动态注册的弱校验子设备；7.1. 数据上报报文格式新增其上报主题和报文结构。
2. 【breaking】7.1. IoTDA 模式的 service_id 改为 fieldID，properties 的键改为原字段名；原先依赖标签前缀属性名的接收端需调整解析。5.9.6. MQTT 设置接口同步说明 GeWu 配置字段。

v1.19.7.47（2026-09-23）

发布时间：2026-09-23

1. 5.7.2.3. count 机组计数数据分析新增请求参数 sumByGroup：为 true 时每个分组间隔只返回一条机组记录，count 为组内各机台计数 × 产量系数之和；《3.10.2. 产量分析》新增「按产量系数汇总机组产量」开关，《九、MCP 服务》analyze 新增同名参数。

v1.19.7.46（2026-09-21）

发布时间：2026-09-21

1. 5.5.1.20. readPlcData 读取 PLC 数据与 5.5.1.21. writePlcData 写入 PLC 数据：马扎克 [Smart，Smooth] 的 R 区支持 Int16、UInt16、Int32、UInt32 读写（每个 R 区地址占 16 位），PLC 数据类型表相应更新。

v1.19.7.45（2026-09-21）

发布时间：2026-09-21

1. 《3.11.1. 机台监控》：顶部的「当前产量」卡片移入「产量」卡片，显示在其标题右侧。

v1.19.7.44（2026-09-18）

发布时间：2026-09-18

1. 5.10.1.7. settings 获取 Core 运行配置新增看门狗配置 watchdogEnabled、watchdogUnhealthyMinutes、watchdogCooldownMinutes、watchdogProbeTimeoutMs：Core 与 Gateway 每分钟互相探测，对方服务停止或连续 3 分钟无响应时自动拉起/强制重启；serviceQueueCapacity 改为关闭磁盘溢出时的固定上限，不再随内存自动增长。
2. 《3.2. 主页》：本地缓存（数据库）连不上时状态停在「等待连接」而非「运行中」；Hub 广播通道的积压同样落盘，可在数据链路行清空。

v1.19.7.43（2026-09-17）

发布时间：2026-09-17

1. 《九、MCP 服务》改写：工具由 33 个合并为 13 个，新增 get_fleet_status（全厂缓存状态快照）、read_machine（按 items 一次实时读取多项）、analyze / query_history（合并机台与机组分析、历史查询，newestFirst 取最新数据）、read_task_data（任意数据类缓存样本）、get_system_info；原 read_cnc_status、analyze_oee、batch_read_errors 等旧工具名全部移除。
2. 《9.4. 工具列表》新增时间参数写法说明（Unix 秒、ISO-8601、日期、相对时间、now/today/yesterday）；《9.5. 返回结果与错误》改为直通类与组合类两种返回，错误消息格式增加 Hint: 处理提示。

v1.19.7.42（2026-09-16）

发布时间：2026-09-16

1. 《3.11.1. 机台监控》改为“当前产量”卡片固定标注“当前计数周期”，删去计数周期显示所需的“监控”权限说明；监控台正文与历史条目中的“磁贴”“状态砖”统一改称“卡片”。

v1.19.7.41（2026-09-15）

发布时间：2026-09-15

1. 《3.11.1. 机台监控》补充“当前产量”卡片及其计数周期的说明。

v1.19.7.40（2026-09-14）

发布时间：2026-09-14

1. 新增 CNC 系统 Makino 牧野［通用型］（基于 Fanuc），接口行为与 Fanuc 发那科 30i 系列一致，相应在数据标签组合、时间数据、刀具寿命、文件管理与 PLC 特殊区域/数据类型各表中补充 Makino 牧野。
2. 支持机型列表新增 CNC 系统 Makino 牧野。

v1.19.7.38（2026-09-15）

发布时间：2026-09-15

1. 《11.2.4.3. $POST$ 后处理可用函数》新增 PToStringArray 与 GetActiveBits 函数说明。

v1.19.7.37（2026-09-09）

发布时间：2026-09-09

1. 【breaking】5.10.2.7. internet-connection 获取网关网络状态返回的 isOnline 改为可空：网关首轮外网探测出结果前（约启动后数秒）或探测被配置关闭时返回 null。按 isOnline == true 判断在线的调用方不受影响，按 false 判断离线的需区分 null。同时新增 checkedAtUnix、lastOkUnix 字段。
2. 该接口改为读取网关后台外网探测的缓存结果，不再在请求时实时建连。5.10.1.7. settings 获取 Core 运行配置新增探测配置 internetProbeTargets、internetProbeIntervalMs、internetProbeTimeoutMs、internetProbeFailuresBeforeOffline。
3. 主页「网络」一栏改为「外网」，并补充状态说明与判定方式，见《3.2. 主页》。

v1.19.7.36（2026-09-08）

发布时间：2026-09-08

1. 5.10.2.17. wifi 获取无线网设置与 5.10.2.19. search-wifi 搜索无线网在网关没有可用无线网卡时返回错误码 10051（GENERAL_WIFI_NOT_AVAILABLE），statusMsg 附带具体原因，原先返回 1（Unexpected Error.）。

v1.19.7.31（2026-09-15）

发布时间：2026-09-15

1. 《3.12.2.2. 升级网关》补充上传过程中可取消上传。

v1.19.7.30（2026-09-02）

发布时间：2026-09-02

1. 5.10.1.7. settings 获取 Core 运行配置新增 processMetricsIntervalMs（进程指标日志的输出间隔）。

v1.19.7.29（2026-09-01）

发布时间：2026-09-01

1. 新增 5.10.1.8. drop-service-queue 清空服务发送队列，按服务永久丢弃内存与磁盘中待发送的数据；MQTT RPC 同步支持该命令。
2. 新增《3.2.2.1. 队列积压与清空》，说明数据链路的队列积压显示、“恢复中”状态，以及新增的清空队列数据按钮。

v1.19.7.24（2026-08-27）

发布时间：2026-08-27

1. 【breaking】MCP 服务新增开关，且默认关闭，关闭时 /mcp 返回 HTTP 404。网关在网页「通讯配置」页开启，立即生效。升级后原有 MCP 客户端需先开启开关才能继续使用。详见九、MCP 服务。
2. MCP 服务新增开关，默认关闭，需在3.6.8. MCP 设置中开启后才可访问；相应更新《九、MCP 服务》。

v1.19.7.22（2026-08-20）

发布时间：2026-08-20

1. 新增 MCP 服务。网关与云平台新增 MCP 服务端 /mcp，以 33 个只读工具向 AI 客户端提供机台配置、实时状态、数据分析与网关系统信息，鉴权方式与 HTTP 接口一致。详见九、MCP 服务。
2. 新增《11.3. 集群故障切换（选装）》，说明共享备机池的工作方式、组建步骤、切换与回切行为、强制接管，以及不在复制范围内的内容。

v1.19.7.18 后续更新（2026-08-05）

发布时间：2026-08-06

1. 【breaking】CNC-Siemens 型号名称变更（v1.19.7.16）。机台配置相关接口返回的西门子型号名称改变，原有机台配置不受影响。 原型号 => 新型号（*为升级后原型号默认对应的新型号）：
   • 通用型 => 828D、*840D sl
   • 810D/840D (winXP) => 810D(winXP)、*840D(winXP)
   • 810D/840D (winNT) => 810D(winNT)、*840D(winNT)
   • SINUMERIK ONE => *ONE
2. 新增 CNC-Siemens 型号 802D、808D（v1.19.7.16）。
3. IP 白名单行为变更（v1.19.7.17）。登录接口 /api/auth/login 与产品信息接口 /api/misc/product-details 不再受 IP 白名单限制；使用 JWT 方式鉴权的请求跳过 IP 白名单校验，使用密钥方式鉴权的请求仍需通过白名单校验。详见 5.3.3. IP 白名单。
4. 机台重连等待机制变更（v1.19.7.18）。原为固定等待时间，现改为：第一次连接不等待；连续失败时等待时间为退避序列 2s（失败 1 次）→ 4s → 8s → 16s → 32s → 60s（失败 6 次及以上，封顶）；连接成功后重置退避状态。
5. 本文档据网关源码全面校订，修正了接口地址、字段名称、字段类型、枚举取值与支持机型等处的错误，并补充了此前缺失的字段与接口说明。
6. 调整 CNC 西门子型号：通用型拆分为 828D 与 840D sl；810D/840D (winXP) 拆分为 810D(winXP) 与 840D(winXP)；810D/840D (winNT) 拆分为 810D(winNT) 与 840D(winNT)；SINUMERIK ONE 更名为 ONE；新增型号 802D、808D。原有机台配置不受影响。
7. 修改“启用 IP 白名单”说明：登录接口不受 IP 白名单限制，JWT 方式鉴权跳过白名单检验，SecretKey 方式鉴权仍需白名单检验。

v1.19.7（2026-07-19）

发布时间：2026-07-19

1. 机台配置新增参数 NetworkErrorAsOffline（网络错误视为离线）。
2. 新增广数 25i 机型支持。
3. 任务后处理新增函数 GetSetBitIndices。
4. 新增网关功能接口 hardware-resources 获取网关硬件资源。
5. 新增警报映射功能。
6. 机台配置新增“网络错误视为离线”（NetworkErrorAsOffline）选项。
7. 程序传输下载文件不再带后缀。
8. 兼容旧版 Chrome 内核浏览器。

v1.19.6（2026-07-02）

发布时间：2026-07-02

1. 移除数据类 AlarmHistory 警报历史，AlarmLog 当前警报中失效的字段。
2. CNCStatus 运行状态增加新的细分等待状态，并新增说明列。
3. 修改监控台相关说明。

v1.19.5（2026-06-15）

发布时间：2026-06-15

1. 接口 selectProgram 选择程序修改，新增参数 mode 执行模式。
2. 程序传输页新增查看刀路功能。

v1.19.4（2026-02-11）

发布时间：2026-06-05

1. 鉴权方式修改，原 API Key 方式改为 Secret Key 方式。
2. 原机台任务 Cumulative Status Time 累计状态时间合并入 Machine Status 机台状态任务，获取机台状态的同时自动累计时间。
3. Cycle 节拍数据新增变量 LastTotalTime 上次节拍总时间。
4. /api/analysis/cycle 机台节拍数据分析接口，/api/group-analysis/cycle 机组节拍数据分析接口，新增输出变量 StartTime 节拍开始时间。
5. 机组号由 1-8 扩展到 1-16。
6. 修订支持的 RPC 接口表。
7. Feed 数据类新增 CmdFeed 字段。FeedAndSpindle 数据类新增 CmdFeed 与 CmdSpindle 字段。
8. 《说明书》章节变动，变更相应引用位置。
9. 修改 MODBUS 通讯中从站 ID 相关说明。
10. 更换新 UI，相应调整内容。
11. 新增监控台页。
12. 新增 PLC 任务后处理说明。
13. 新增自定义任务说明。

v1.19.3（2025-12-22）

发布时间：2025-12-22

1. 修正错误描述。readCount 读取加工计数接口，返回响应，数据 count 的类型，修正为 Int32。
2. 移除不再使用的数据类 AxialLoad 伺服轴负载类与 SpindleLoad 主轴负载类。如需相关数据，应使用数据类 Load 负载数据。
3. 合并数据类 ToolLife 刀具寿命与 ToolLifeDetails 刀具寿命详情类。
4. 新增鉴权方式与鉴权接口说明。
5. 修订接口分类，文件传输接口更名为文件管理接口。
6. 新增接口：readErrorSummary 读取状态简报，searchFile 搜索机台文件。
7. 新增数据类型 LogHistory 日志历史，新增相应机台任务。
8. 从 MQTT 设置参数中移除已失效参数，UseGatewayAlias 引用网关名，和 KeepAliveInterval 保活周期。
9. 机台配置参数新增 numberOfTasks 启用的任务数，自定义状态相关参数，自定义警报相关参数，自定义加工计数相关参数。
10. 更新刀具补偿数据标签组合表。
11. 更新刀具寿命数据标签组合表。
12. 新增接口 remote-access 获取远程访问设置与 update-remote-access 修改远程访问设置。
13. ReadPlcData 接口，WritePlcData 接口，新增请求参数 Channel（通道号）支持。
14. 修改以下接口：

• /api/gateway/wifi
• /api/gateway/update-wifi
• /api/gateway/search-wifi
• /api/config/gateway-info
• /api/config/cloud-settings
• /api/config/update-cloud-settings

15. 新增接口 /core/license-info。

v1.19.2（2025-06-03）

发布时间：2025-06-03

1. 新增以下接口
   • /config/batch-delete-machines
   • /config/batch-delete-groups
   • /analysis/cycle
   • /group-analysis/cycle
2. 原机台任务 alarm 警报信息，拆分为 alarm 当前警报与 alarmHistory 警报历史。
3. 调整部分机台配置接口的变量名与顺序。
4. 移除过载监控设置中的变量 monitorOverloadInterval，在机台任务间隔设置中新增变量 readOverloadInteral 代替。

v1.19.1（2025-05-14）

发布时间：2025-05-14

1. Fanuc 型号 PMi 改为 Power Motion i-A。
2. 修复失效超链接。
3. 更新刀具寿命数据标签组合表。
4. 新增以下接口
   • /core/restart
   • /config/settings
   • /config/update-settings
   • /config/update-security
   • /config/remote-access
   • /config/update-remote-access
   • /gateway/alias
   • /gateway/update-alias
   • /gateway/time
   • /gateway/sync-time
   • /gateway/time-zone
   • /gateway/update-time-zone
   • /gateway/system-locale
   • /gateway/update-system-locale
   • /gateway/lan
   • /gateway/update-lan
   • /gateway/wifi
   • /gateway/update-wifi
   • /gateway/search-wifi
   • /gateway/connect-wifi
   • /gateway/disconnect-wifi
   • /gateway/static-routing
   • /gateway/update-static-routing
   • /gateway/connect-remote-host
   • /gateway/disconnect-remote-host
   • /gateway/list-file-server-items
   • /gateway/delete-file-server-item
   • /gateway/network-adapters
   • /api/cnc/readLog
5. 调整部分机台配置接口的变量名与顺序。

v1.18.8（2024-11-08）

发布时间：2024-11-08

1. 新增机台配置接口中的大量字段。
2. 修正机台配置接口中的 taskEnergy 的拼写错误。
3. 新增获取机台状态监控设置接口的部分字段。

v1.18.1（2024-06-14）

发布时间：2024-06-14

1. 新增网关功能接口与配置接口。
2. 新增 ID 数据库标识说明。
3. 修正接口 batchDeleteFile 批量删除机台文件内容。

v1.18.0（2024-04-29）

发布时间：2024-04-29

1. 调整部分文档内容。
2. 修改“设置”窗口，原“时间设置”改为“时间与地区设置”。新增“自动同步时间间隔”，“系统区域设置”设置。修改“时间服务器地址”设置，允许设置多个地址。
3. “通讯配置”页，调整各项通讯协议的启用开关位置。

v1.17.6（2024-04-16）

发布时间：2024-04-16

1. 新增 HTTP 接口，RPC 接口：readAllPrograms 浏览所有文件。此接口用于获取指定路径下所有的程序名及其路径，包括子文件夹下的（如果机台支持切换目录）。
2. 新增 MAZAK 马扎克机床刀具补偿刀具寿命相关说明。
3. 调整程序传输（专业版）相关描述。

v1.17.5（2024-04-01）

发布时间：2024-04-01

1. 移除 Cycle：节拍数据中不再使用的字段 runningPrgName。
2. CNCStatus：机台状态数据中，新增字段 adjustedStatus。
3. “任务配置”页，新增机台状态监控设置。

v1.17.4（2024-03-28）

发布时间：2024-03-28

1. “程序传输”页，新增程序传输（专业版）。

v1.17.3（2024-03-29）

发布时间：2024-03-29

1. 移除 Cycle：节拍数据中不再使用的字段 runningPrgName。
2. readPlcData 接口，如果获取的 Double 类型数值为 double.Nan，原先会转为 double.Min 输出，现在支持直接输出 double.Nan。

v1.17.2（2024-03-19）

发布时间：2024-03-19

1. 新增 HTTP 接口，RPC 接口：selectProgram 选择程序。

v1.17.1（2024-03-19）

发布时间：2024-03-19

1. 新增 HTTP 接口，RPC 接口：batchReadErrors 批量读取机台连接状态。

v1.17.0（2024-03-15）

发布时间：2024-03-15

1. 修改批量处理任务接口 batchReadOffsetData，batchReadToolLife，batchReadToolLifeDetails 的返回体，现在如果某条请求失败时，返回体数组对应位置为其错误信息。

v1.16.5（2024-03-08）

发布时间：2024-03-08

1. HTTP 接口，RPC 接口中的文件传输接口分类，新增接口 batchDeleteFile 批量删除机台文件。

v1.16.4（2024-03-08）

发布时间：2024-03-08

1. HTTP 接口，RPC 接口中的文件传输接口分类，新增接口 batchSendFile 批量发送文件至机台。

v1.16.3（2024-03-08）

发布时间：2024-03-08

1. HTTP 接口，RPC 接口中的文件传输接口分类，新增接口 backupFiles 备份机台文件。

v1.16.2（2024-03-04）

发布时间：2024-03-04

1. HTTP 接口，RPC 接口新增接口分类，历史数据接口，包括 machine 机台历史数据和 group-machine 机组内所有机台历史数据。
2. 数据读写接口中的 readTaskData 读取机台任务数据，batchReadTaskData 批量读取机台任务数据，readGroupTaskData 读取机组任务数据，batchReadGroupTaskData 批量读取机组任务数据，新增返回参数 time 数据的获取时间。
3. MQTT 通讯，新增 MQTT 模式 IoTDA 相关说明。
4. 调整 readPlcData 读取 PLC 数据与 writePlcData 写入 PLC 数据接口相关内容，新增部分支持机床系统说明。
5. 修订部分说明内容。

v1.16.1（2024-02-21）

发布时间：2024-02-21

1. 调整文档内容结构，新增章节《一、重要说明》，将各通讯方式通用的说明内容移入新章节。其它章节序号顺应调整。
2. 新增数据类 AxialLoad：伺服轴负载，LaserPower：激光功率，Offset：刀补数据，SpindleLoad：主轴负载。
3. 部分数据类增加新标签 channel 通道号。
4. 调整引用《通讯协议》内容的章节号。

v1.16.0（2024-01-30）

发布时间：2024-02-05

1. HTTP 接口，RPC 接口，MQTT 与数据库中的机组号 groupNum 被替代为机组标识 groupID。
2. “机组配置”页-“添加机组”/“编辑机组”，新增“高级”标签页。

v1.15.8（2024-02-20）

发布时间：2024-02-20

1. “网络配置”页，新增 WiFi 搜索，设置功能。
2. 网关管理页面-网络配置，新增对中文 SSID 的 WiFi 支持，新增对 WPA3SAE 网络支持，修复常用 WiFi 网络的连接问题。

v1.15.7（2024-01-20）

发布时间：2024-02-04

1. 修改 Fanuc [0i-D, 0i-F, 30i, 31i, 32i, 35i, PMi]的默认根目录路径为 //CNC_MEM/。
2. “机台配置”页-“添加机台”/“编辑机台”-“程序传输”标签页，“文件服务器类型”新增“无线网盘”选项。

v1.15.5（2024-01-22）

发布时间：2024-02-04

1. 更新文件传输接口支持系统型号相关表格。
2. “通讯配置”页-“网关文件服务器配置”，新增“启用共享文件夹”开关。
3. “程序传输”页，新增一次发送多个文件支持。

v1.15.4（2024-02-20）

发布时间：2024-02-20

1. “通讯配置”页-“网关文件服务器配置”，新增“启用共享文件夹”开关。
2. “程序传输”页，新增一次发送多个文件支持。

v1.15.3（2023-12-26）

发布时间：2024-02-04

1. 所有文件传输接口新增 subDir 参数支持。
2. HTTP 与 RPC 接口 /ToolLife 接口的 rawRemainingCount，rawPrewarningRemainingCount 类型由 Double 改为 Int32。
3. “机台配置”页-“添加机台”/“编辑机台”-“程序传输”标签页，新增“网关文件服务器”相关设置选项。
4. “通讯配置”页，新增“网关文件服务器配置”相关设置选项。

v1.15.2（2023-12-18）

发布时间：2024-02-04

1. 新增 HTTP 接口 /sendFileStream 和 /receiveFileStream 接口以支持大文件传输。
2. “通讯配置”页，“数据库设置”-“保存模式”默认选项由“日志”改为“自定义”。此变更不影响用户当前设置。

v1.15.1（2023-12-06）

发布时间：2024-02-02

1. 修订部分说明内容。
2. “通讯配置”页，“数据库设置”新增“主键”开关。
3. “通讯配置”页，“数据库设置”新增“保存模式”选项“自定义”，允许用户对每一个任务单独设置日志模式或实时模式。
4. “数据分析”页，分析器选项顺序变更。
5. “任务配置”页，“OEE 监控设置”与“加工计数监控设置”下的“监控模式”，默认为“到点重置”。此变更不影响用户当前设置。
6. 修订部分说明内容。

v1.15.0（2023-11-28）

发布时间：2023-11-28

1. 新增 HTTP 与 RPC 接口 /bathReadGroupTaskData。
2. /readPlcData 接口新增 Siemens 西门子[通用型]对 S7 标签支持的说明。
3. /readTimeData 接口新增返回参数 remainingCycleTimeMin 与 remainingCycleTimeMs。
4. 新增了 Kede 科德机床相关说明。
5. /readProgramInfo，/readProgramBlock 接口说明，新增请求参数 channel 支持。
6. 更正了数据上报报文 type 中 Position 的拼写错误。
7. 修正了文件传输接口中，关键词首字母大写的问题。现在所有接口的关键词首字母均为小写。
8. 修改 Modbus 通讯中轴名称的地址位长度为 2，以支持最多 4 个字符的轴名。
9. 在 MODBUS 通讯与 MQTT 通讯中补充外部 PLC 任务数据相关内容。
10. “接口测试”页，接口“加工程序信息”与“程序段”新增通道号选项。
11. 主页-“网关状态”栏，移除“许可描述”，增加“许可状态”。

v1.14.0（2023-11-01）

发布时间：2023-11-01

1. 新增 HTTP 与 RPC 接口 /readTaskData，/bathReadTaskData，/readGroupTaskData。
2. 修正接口 /readTimeData 中对广数机床能获取到数据的错误描述。补充了新支持设备系统型号的说明。
3. 修改了 /readPlcData 与 /writePlcData 中请求 area 的格式。
4. 修改章节一、HTTP 通讯中接口说明的格式。
5. 修改章节 3.1. 数据上报报文格式中的内容。
6. “机台配置”页-“添加机台”/“编辑机台”新增“高级”标签页，用户可以自定义机台 ID 和 Modbus 从站 ID。
7. PLC 数据任务格式修改。

v1.13.0（2023-10-23）

发布时间：2023-10-23

1. 新增 HTTP 与 RPC 接口 /batchReadOffsetData，/bathReadToolLife，/bathReadToolLifeDetails。
2. 许可策略调整，现在允许同一台网关导入不同类型设备的许可。旧版本升级到 1.13.0 及更新版本时，需要重新生成许可文件。
3. 允许 CNC 以外类型的机台加入机组。
4. “机台配置”页“添加 PLC 机台”/“编辑 PLC 机台”窗口“任务”标签新增任务“机台状态”，“OEE 监控”，和“累计状态时间”。
5. “机台配置”页“添加 CNC 机台”/“编辑 CNC 机台”窗口下的原系统栏选项“IO 外接模块”移动到“添加 PLC 机台”/“编辑 PLC 机台”下的系统栏选项。在旧版本添加的“IO 外接模块”机台必须重新设置。

v1.12.0（2023-09-26）

发布时间：2023-09-26

1. 新增 HTTP 和 RPC 接口 /readTaskData，从网关缓存中获取对应任务的最近一次数据。
2. 数据分析接口新增分组间隔支持。所有分析接口输出新增变量 StartTime 和 EndTime。
3. “程序传输”页，新增“创建目录”与“删除目录”按键。
4. “网络配置”页，“LAN1 设置”与“LAN2 设置”下新增 DNS 服务器设置相关项；新增状态提示 LAN 口是否连接（“已连接”代表 LAN 口适配器检测到网线另一端有设备连接，不代表一定能 Ping 通该设备。）。
5. “机台配置”页“添加 CNC 机台”/“编辑 CNC 机台”窗口“任务”标签新增任务“刀具补偿”。
6. “任务配置”页“机台任务间隔设置”新增“刀具补偿间隔（毫秒）”。

v1.11.0（2023-09-06）

发布时间：2023-09-06

1. 调整部分 RPC 数据分析相关接口，使其与 HTTP 相关接口一致。
2. 新增 /receiveFile 与 /sendFile 接口对二进制文件的支持。
3. “机台配置”页，“添加机台”/“编辑机台”窗口“程序传输”标签，调整布局。

v1.10.0（2023-08-22）

发布时间：2023-08-22

1. 新增 HTTP 与 RPC 接口 /readFeed，适用于 CNC 和激光切割机，获取进给数据。
2. 新增 HTTP 与 RPC 接口 /readEnergyConsumption，适用于 CNC，获取能耗数据。
3. 新增 HTTP 与 RPC 接口 /readLaserPower，适用于激光切割机，获取激光切割机预设功率与实际功率数据。
4. 新增 MODBUS，MQTT，数据库等通讯方式对激光切割机激光功率数据的支持。
5. 修正 MODBUS 机组数据地址错误。每组数据地址位相差 100 而不是 1000。
6. 新增部分 HTTP 与 RPC 接口对多通道系统的支持。
7. 修改 Modbus 通讯，原 3000 及以后的地址位调整为 1000 及以后。
8. “机台配置”页，“添加机台”/“编辑机台”新增“外部 PLC”标签页，用于创建串口采集。
9. 新增激光切割机支持。“机台配置”页，新增“添加激光切割机”按键。“添加激光切割机”/“编辑激光切割机”窗口“任务”标签新增“激光功率”任务。“任务配置”页“机台任务间隔设置”新增“激光功率间隔”。“接口测试”页为激光切割机新增“激光功率”接口选项。
10. “机台配置”页，激光切割机、机器人、PLC“添加机台”/“编辑机台”窗口“常规”标签，“系统”栏新增“模拟机台”选项。
11. “网络配置”页，无线网配置，“状态”中新增当前 WiFi IP 地址。
12. “接口测试”页，部分接口新增“通道”选项，默认为 0，即主通道。

v1.9.3（2023-07-10）

发布时间：2023-07-10

1. 移除数据库通讯按机台写入相关内容。旧版本按机台写入模式在新版本中将会以日志模式运行。（说明书）
2. 补充 MQTT 通讯下的 ToolLife 与 ToolLifeDetails 数据类。
3. 新增接口 /createDir 与 /deleteDir。
4. 新增机台状态 MANUAL_SINGLE_BLOCK（调机状态：单段运行）。
5. 移除数据库通讯按机台写入选项。旧版本按机台写入模式在新版本中将会以日志模式运行。

v1.9.2（2023-06-28）

发布时间：2023-06-28

1. HTTP，MODBUS，MQTT，数据库等通讯方式新增当前刀补号支持。

v1.9.1（2023-06-25）

发布时间：2023-06-25

1. MQTT 通讯协议修改数据类 Plc 为 PLC。改动后不再兼容旧版本 Plc 数据类。

v1.9.0（2023-06-21）

发布时间：2023-06-21

1. 改动 MQTT 通讯数据上报报文格式，改动后仍兼容旧版本除 OverLoadS 与 Plc 以外的所有数据类。
2. MQTT 通讯协议新增数据类 AxialOverLoad。
3. MQTT 通讯协议修改数据类 OverLoadS 为 SpindleOverLoad。改动后不再兼容旧版本 OverLoadS 数据类。
4. Modbus 新增地址位，包括快速进给倍率，与第 1 至第 18 轴累计过载时间。
5. Modbus 调整地址位，包括主轴负载，与主轴累计过载时间。

v1.8.2（2023-06-20）

发布时间：2023-06-20

1. MODBUS，数据库，MQTT 中的 alarmHistory 移除 alarmTime。

v1.8.1（2023-06-19）

发布时间：2023-06-19

1. 从 /readAlarm 接口移除 alarmTime。MODBUS，数据库，MQTT 中的 alarmLog 移除 alarmTime。
2. 现在要获取机台的警报起始时间，可以通过 HTTP 或 RPC 接口 analysis/alarm 获取。或根据 alarmHistory 中警报的激活/解除记录计算时间。

v1.8.0（2023-05-12）

发布时间：2023-05-12

1. 修正三菱系统 CNC 默认根目录路径。
2. 新增 HTTP 与 RPC 接口 /readToolLife 与 /readToolLifeDetails，原接口 /readToolOffset 中寿命相关变量移入新接口。
3. 修正 /sendFile 与 /receiveFile 中关键词 content 为 Content。
4. 新增接口 group-analysis/oee，group-analysis/alarm，group-analysis/count，group-analysis/overall，analysis/overall。
5. 接口 /readProgramInfo 新增 programStack 变量。
6. 调整 HTTP 通讯各接口顺序，将 HTTP 接口分为状态读写，文件传输，与数据分析三类。
7. 主页“网关状态”数据上传相关服务新增“延误”状态。
8. 顶部功能栏新增“诊断”按键。
9. “机台配置”页“添加 CNC 机台”/“编辑 CNC 机台”窗口“任务”标签新增任务“刀具寿命”。
10. “任务配置”页新增“刀具寿命监控设置”。
11. “任务配置”页“机台任务间隔设置”新增“刀具寿命间隔（毫秒）”。
12. “任务配置”页“OEE 监控设置”，新增休息时间段相关设置。
13. “网络配置”页“无线网配置”新增信号强度显示。
14. “接口测试”页新增接口“刀具寿命”与“刀具寿命详情”。
15. “数据分析”页新增分析器综合分析。

v1.7.5（2023-03-10）

发布时间：2023-03-10

1. 修改 HTTP 与 RPC 接口 /readAlarm，增加输出内容警报级别 alarmLevel。
2. 在 MODBUS，MQTT，数据库中为数据 Alarm 增加变量警报级别。
3. 在 MQTT，数据库中为 AlarmHistory 增加变量警报级别。
4. 在 MODBUS，MQTT，数据库中新增机台累计警报时间，使用前需要激活机台警报信息任务。
5. 在 MODBUS，MQTT，数据库中新增机台节拍数据，使用前需要激活机台节拍数据任务。
6. 修改 HTTP 与 RPC 接口 /readPlcData 与 /writePlcData，支持部分型号机台以变量名形式读取与写入。
7. 新增 HTTP 接口 /api/analysis/count。
8. 新增更多 RPC 接口支持，现在所有 HTTP 接口都有对应的 RPC 接口。
9. “任务配置”页新增“警报监控设置”栏。
10. “机台配置”页新增“添加机器人”按键，增加机器人设备采集支持。
11. 修改“设置窗口”，新增“更多”标签页，移入“默认配置”按键，新增“备份配置”与“恢复配置”按键。
12. 新增“重启服务”提醒。
13. 主页“关机按键”整合到新增的“网关关机/重启”功能按键。
14. “数据分析”页，新增“产量分析”。
15. 章节《七、常见问题》新增内容。
16. “机台配置”页“添加机台”与“编辑机台”窗口的“任务”标签，增加“高级”设置。

v1.7.0（2022-12-12）

发布时间：2022-12-12

1. 修改 HTTP 接口 /writePlcData，/writeOffsetData 等请求体结构。
2. 修改 HTTP 接口 /readOffsetData 回复结构。
3. 修改 RPC 接口 /writePlcData，/writeOffsetData，/sendFile 等请求报文结构。
4. “机台配置”页“添加 CNC 机台”/“编辑 CNC 机台”窗口“任务”标签“加工计数”新增“过载”任务。
5. “任务配置”页新增“加工计数监控设置”，“过载监控设置”。
6. “接口测试”页按键“读取”改为“发送”。
7. “接口测试”页接口选项“PLC 数据”改为“读取 PLC 数据”。
8. “接口测试”页新增选项“写入 PLC 数据”，“读取刀补数据”，“写入刀补数据”。
9. “设置”窗口“高级选项”新增权限开关“允许写入 PLC 数据”，“允许写入刀补数据”。

v1.6.2（2022-12-09）

发布时间：2022-12-09

1. 新增 HTTP 接口 /writePlcData。
2. 新增 RPC 接口 /readPlcData 与 /writePlcData。
3. Modbus，MQTT，数据库通讯新增上传数据变量当前加工计数 CurrentCount 与主轴过载时间 OverLoadS<i>。
4. 新增 MQTT 通讯中 PLC 数据对任务命令中设置的标签名的支持。

v1.6.1（2022-11-11）

发布时间：2022-11-11

1. 修改 HTTP 接口 /readOffsetData 与 /writeOffsetData，新增可选输入量 ToolNum 以支持西门子机床刀补读写。
2. 修订 RPC 接口说明。
3. “设置”窗口新增“管理用户”按键，用于添加、编辑、和删除网关用户，以及为用户分配权限。

v1.6.0（2022-10-31）

发布时间：2022-10-31

1. 修改 HTTP 接口 /readPlcData 返回结果，原所有数据类型均返回 UInt16 数组，改为按照用户输入的数据类型返回对应数据。
2. 移除 HTTP 接口 /readPlcData 对数据类型 Char 的支持。如需获取 Char 数据类型，用户可以获取 Byte 类型数据后自行转换。
3. 修改 HTTP 接口 /readPlcData 对 String 类型的支持。当类型为 String 时，Count 表示要读取的数据的最大长度（Byte 数）。
4. 在 HTTP 接口 /readPlcData 集成获取机台宏变量（本地变量，公共变量等）支持。
5. 在 MODBUS，MQTT，数据库通讯中，新增机台累计状态时间和机组累计状态时间。
6. 所有 MODBUS 通讯映射地址位长度调整以扩充容量。PLC 数据映射地址由原 4000 改为 20000，长度由原 1000 改为 10000。
7. 新增 MODBUS 通讯对 64 位型格式数据支持。
8. 调整 MQTT 通讯中 PLC 数据标签与内容。
9. 调整 RPC 接口请求与回复格式。
10. 新增 RPC 接口 /analysisOEE，/analysisAlarm。
11. 新增机台状态 MANUAL_RAPID。
12. “机台配置”页新增“添加机台”按键拆分为“添加 CNC”与“添加 PLC”按键，其中“添加 CNC”按键保留原“添加机台”功能；“添加 PLC”按键打开添加 PLC 配置窗口，增加 PLC 设备采集支持。
13. 新增网关离线升级功能。
14. “通讯配置”页“MODBUS 配置”新增“64 位型格式”选项。
15. “通讯配置”页“数据库配置”新增“保存模式”选项，原“按机台写入”选项合并入“保存模式”选项。

v1.5.9（2022-09-21）

发布时间：2022-09-21

1. 在 MODBUS，MQTT，数据库通讯中，新增累计警报数。

v1.5.8（2022-08-17）

发布时间：2022-09-15

1. 新增 HTTP 接口 /readProgramBlock。新增该接口对应的 MODBUS，MQTT，以及数据库通讯相关内容。
2. 新增 HTTP 接口 /api/analysis/alarm。
3. “机台配置”页“添加机台”与“编辑机台”窗口，“任务”标签新增“程序段”选项。
4. “任务配置”页“机台任务间隔设置”新增“程序段间隔”设置。
5. “接口测试”页新增“程序段”选项。
6. “数据分析”页新增“警报分析”选项。
7. “通讯配置”页“数据库设置”新增“使用本地时间”开关。

v1.5.7（2022-08-03）

发布时间：2022-08-08

1. HTTP 接口 /readPlcData 新增 String 类型数据支持说明。
2. 新增 RPC 接口 /readCurrentProgram。
3. 新增数据库通讯相关内容。
4. 修复 MODBUS 输出轴名称错误的问题。
5. 将《用户调试手册》中的常见问题与已知问题内容移入本文档。
6. “通讯配置”页新增“数据库配置”。
7. “设置”窗口新增开关“LAN2 设置”。
8. 改动默认网关名称为 “iotgw”。
9. “机台配置”页，“添加机台”与“编辑机台”窗口，“常规”标签，新增“编码”设置。

v1.5.6（2022-07-13）

发布时间：2022-07-27

1. 由于《说明书》改动，修改引用《说明书》位置。
2. 增加程序传输的文件服务器类型的说明。修改了 Fanuc [0i-D, 0i-F, 30i, 31i, 32i, PMi]的默认根目录路径。
3. 修改 HTTP 接口 /readPlcData 说明。
4. 重制了“机台配置”页表格：增加了排序，检索，翻页等功能；将“状态”栏改为“激活”栏，以图标显示激活状态；新增“连接”栏，以图标显示连接状态，每十秒更新；新增“任务数”栏，显示机台任务数；原“编辑”，“删除”按键以图标代替；新增移动鼠标到图标上显示悬浮说明；原“机台任务设置”窗口移动到“编辑机台”窗口内的“任务”标签；“编辑机台”窗口新增“程序传输”标签。
5. 重制了“机组配置”页表格：增加了排序，检索，翻页等功能；将“状态”栏改为“激活”栏，以图标显示激活状态；新增“机台数”栏，显示组内机台数；新增“任务数”栏，显示机组任务数；原“编辑”，“删除”按键以图标代替；新增移动鼠标到图标上显示悬浮说明；原“机组任务设置”窗口移动到“编辑机组”窗口内的“任务”标签。
6. “程序传输”增加共享文件夹，共享文件夹 (Win XP)，和 FTP 服务器支持。
7. “接口测试”页读取“PLC 数据”的“数据类型”由输入改为下拉选择。
8. “程序传输”页，“根目录”不可编辑，仅显示“机台配置”页-“编辑机台”窗口-“程序传输”标签下设置的“根目录”。
9. 更新“基本参数”。

v1.5.5（2022-06-19）

发布时间：2022-06-24

1. 由于《说明书》改动，修改引用《说明书》位置。
2. 修订一、HTTP 通讯中文件传输相关接口的描述。
3. 新增 MQTT 通讯 RPC 接口相关内容 3.3. RPC 接口。
4. 调整顶部功能栏与主页布局，将“修改用户名密码”，“修改网关名称”，“创建默认配置”，“高级选项”移入新增加的“设置”窗口。
5. 在“设置”窗口新增“时间设置”。
6. “通讯配置”页“MQTT 配置”新增 RPC 接口相关设置。

v1.5.4（2022-06-17）

发布时间：2022-06-17

1. 以下 HTTP 接口名称变动，地址不变：
   • 1.5. CNC 系统时间数据改为机台时间数据；
   • 1.6. CNC 状态改为机台状态；
   • 1.14. CNC 本地程序列表改为机台本地程序列表；
   • 1.15. 接收 CNC 文件改为接收机台文件；
   • 1.16. 发送文件至 CNC 改为发送文件至机台；
   • 1.17. 删除 CNC 本地文件改为删除机台本地文件；
   • 1.18. 锁定/解锁 CNC 本地程序编辑改为锁定/解锁机台本地程序编辑
2. 修订机台 OEE，机组 OEE 相关描述。
3. 新增英文支持。
4. 中文内容调整。“采集配置”页调整为“任务配置”页。“机台配置”页，“机组配置”页操作栏“设置”按键调整为“任务”按键。
5. 机台 OEE 从机组 OEE 中分离，在“机台任务设置”中开启/关闭。
6. 程序传输页，文件列表下文件夹“使用”按键改为“打开文件夹”，点击后直接获取子文件夹的列表。
7. 修订四、联网说明。
8. 新增六、补充说明，将名词解释移动到此章，文档内容相应调整。

v1.5.3（2022-05-31）

发布时间：2022-05-31

1. 更改 HTTP 接口 /readPlcData 的输入量。
2. 新增 CNC 状态“调机：试运行”。
3. 修订支持列表，增加“PLC 数据”。
4. 修订 5.1. 登录说明。
5. 由于“PLC 数据”接口改动，调整“PLC 数据”相关说明。

v1.5.2（2022-05-09）

发布时间：2022-05-09

1. 负载数据 axialLoad 与 spindleLoad 类型由 Int32 变更为 Float。
2. 增加 HTTP 接口 /readPlcData，增加 MODBUS 与 MQTT 输出 PLC 数据。
3. 增加 HTTP 接口 api/analysis/oee。
4. MQTT 通讯增加引用网关名称相关内容，增加引用自定义机组名称内容。
5. 移除多通道相关内容。
6. “机台配置”页“自动采集设置”窗口新增“PLC 数据”选项。
7. “采集配置”页“机台采集间隔设置”新增“PLC 数据间隔”设置。“OEE 监控设置”新增“开动率计算方法”选项。
8. “通讯配置”页“MQTT 配置”新增“引用网关名称”开关。
9. “接口测试”页新增“PLC 数据”选项。
10. 新增“数据分析”页。

v1.5.1（2022-04-26）

发布时间：2022-04-26

1. 更改 OEE 监控设置相关说明。
2. “采集配置”页“数据统计设置”变更为“OEE 监控设置”。新增“监控时间设置”，包括选项“实时窗口”与“到点重置”。

v1.5.0（2022-04-20）

发布时间：2022-04-20

1. 更改 HTTP 协议中刀补相关的接口。
2. 更改 MQTT 协议报文内容结构。
3. MQTT 协议数据种类原 AxisData 拆分为 FeedAndSpindle，Load，和 Position。
4. MQTT 协议 AlarmHistory 改为警报历史。
5. MQTT 协议 CurrentToolNumber 关键字更改。
6. 新增文件传输相关错误代码。
7. 修订部分文字内容。
8. “机台配置”页“添加机台”，“编辑机台”窗口，“系统”选项分拆为“系统”与“型号”两个选项。
9. “机台配置”页“自动采集设置”窗口变动，增加更多采集选项。
10. “采集配置”页“机台采集间隔设置”增加更多采集选项间隔设置。
11. “通讯配置”页 MQTT 配置新增开关“变化值上传”。
12. 网络配置页“无线网配置”新增按键“断开”。

v1.4.3（2022-03-28）

发布时间：2022-03-28

1. 修订部分文字内容。
2. 调整主页布局，移动“重启服务”，“网关关机”，“创建默认配置”按键到主页首行。
3. 调整主页“网络状态”内容与位置。
4. 主页“高级操作”调整为“高级选项”。
5. 主页原“网络状态”下“本地缓存”与“远程协助”开关移动到“高级选项”下。
6. 导航栏“采集测试”页面改为“接口测试”页面，新增更多可调用接口。
7. 导航栏新增“程序传输”页面。

v1.4.2（2022-03-15）

发布时间：2022-02-19

1. 修正 MODBUS 与 MQTT 协议部分输出量数据类型。
2. 修正 CNC 状态，CNC 运行状态，警报状态的表述。
3. 增加新的一章，常见问题。
4. 修正常见错误中的部分说明。
5. 补充修改“采集配置”部分内容。

v1.4.1（2022-02-15）

发布时间：2022-02-15

1. 新增 MODBUS 协议与 MQTT 协议 GroupCount，GroupOEE，OEE 等相关输出量。
2. MODBUS 协议输出量分为机台相关数据与机组相关数据。
3. 补充 MQTT 协议说明。
4. 修正 MQTT 协议中 AxisData 部分的错误信息。
5. 新增五、虚拟机床测试。
6. 更新支持机床列表。
7. 主页“网关状态”下新增开关“启用/关闭本地缓存”。
8. 主页“网关状态”下新增开关“启用/关闭远程协助”。
9. 新增设置页面“机组配置”。
10. “采集配置”页面调整，分为“机台采集间隔设置”，“机组采集间隔设置”，与“数据统计设置”，并新增多个设置选项。
11. “通讯配置”页面新增“云平台配置”选项。

v1.3.5（2021-12-27）

发布时间：2021-12-27

1. 所有警报时间结果由精确到秒改为精确到毫秒。
2. 移除 HTTP 接口 ReadPosition 中的 decPoint。
3. 修改 HTTP 接口 ReadProgramList，增加返回量 dirAtCNC 与 subDirs，保留原返回量 programs 结构不变，继承对旧版接口的支持。
4. 新增 Modbus 协议输出地址位 40260 运行程序段顺序号。
5. 新增 Modbus 协议输出地址位 40500 累计产量。
6. 主页新增网络状态。
7. 统一调整各页面中各采集量的名称与顺序。
8. 采集配置页面中的“频率”改为“间隔”。
9. 通讯配置页面 MQTT 协议支持修改编码，默认编码由 gb2312 改为 utf8。