设备采集周期、打包与并发

设备配置把协议插件、关联通道和执行策略组合成采集任务。调整周期前，先用一个已知点位建立正常基线；扩大变量规模后，再根据实际请求量和更新速度调整打包、并发和重试。

进入“开发配置 → 采集配置”，选择设备并打开编辑器。“基本信息”维护名称、关联通道、执行间隔、使能、日志和备注；“插件属性”维护当前协议的读写、打包和格式选项。

设置采集节奏

正确理解设备状态

状态或字段	如何判断
使能	配置是否许可当前设备任务运行。开启后还需等待初始化与连接。
运行	设备任务的生命周期状态。运行中的任务仍可能因协议错误而离线。
在线	当前通信质量。查看变量质量及最近错误，避免把连接存在当成所有地址可读。
主备角色	当前由哪一方工作。主备关系见冗余与主备。
变量数量	配置在该设备下的变量总量；它不等于当前在线数或每秒更新数。

设备名称用于搜索、日志、模板和脚本引用。改名后对象仍是原设备，但依赖名称的计算、路由和外部配置也需要核对。描述、单位和备注分别表达业务含义，备注不会自动完成数值换算或权限控制。

设置执行间隔

1. 在设备基本信息中将执行间隔填写为 1000，保存后重新打开，确认值已保留。
2. 等待设备恢复正常，观察一段连续的新采样和协议请求。
3. 仅将执行间隔改为 2000，再次观察同长度窗口，对比真实请求间隔。
4. 根据业务允许的数据新鲜度选择周期，并恢复长期运行的日志等级。

填写方式	含义
1000	整数单位为毫秒，表示按该间隔调度任务。
2000	按约两秒的调度间隔执行。实际完成时间还包含通信、打包、等待及重试。
*/2 * * * * *	六段 Cron，依次为秒、分、时、日、月、周，按时间表每两秒触发。

整数间隔和 Cron 分别按间隔与时间表调度；相同示例周期不意味着它们在所有负载下完全一致。固定源值一直不变时，应观察采集时间或源端请求，不能只比较显示数值。

协调超时、重试和打包

参数	使用方法
读写超时	留足现场设备正常响应时间。过短会放大短时抖动，过长会延迟异常设备的失败返回。
失败重试	请求失败后按当前插件策略再次尝试。重试增加真实通信工作量，应与超时和设备数量一起评估。
协议打包上限	限制一次协议请求覆盖的数据量。Modbus 按功能码分别配置，数量单位可能是位或寄存器，不能按变量行数理解。
读写占空比	持续读写竞争下，用写操作次数协调等待读取的机会，不是百分比，也不保证每段报文都有固定读写比。当前插件是否应用该设置，按专题确认。
帧前时间	发送前等待，多个读包会累计等待成本；与执行间隔、读写超时和 RTU 帧边界分别设置。
写优先	当前插件支持时，为写请求安排优先处理；仍需检查现场协议约束和实际写回结果。
通道最大并发数	限制同一通道的同时通信任务数。共享通道中的多个设备会受同一限制。

例如一个 Float 变量可能占用两个 16 位寄存器。将每包上限设为 100 个寄存器，并不表示每次总能读取 100 个变量；地址连续性、数据宽度、跨区限制及协议最大长度都会影响打包结果。

单点成功而批量失败时，先降低对应功能码的打包数量，再检查点表是否跨越不可读区间。不同协议的具体上限见对应采集插件。

维护通道与可用性

变更关联通道

关联通道表示设备实际引用的连接对象。修改通道的远程地址会影响该通道的引用者；为设备关联另一条通道则改变该设备的数据路径。

1. 记录当前通道、设备和变量地址。
2. 在关联通道旁使用编辑或新增入口，先保存独立通道，再保存设备引用。
3. 等待设备重建通信，以源端实际值、新采集时间和通道日志核对结果。
4. 确认原通道是否还被其他设备使用，再处理不再需要的通道。

通道内部的“备用远程地址”与设备主备、关联另一条通道分别属于不同层次，选择方法见通道传输。

日志等级的实际作用

设备编辑器提供 Trace、Debug、Info、Warning、Error。等级限制新日志的输出范围，不改变协议地址或当前值。健康链路在 Warning 或 Error 下没有新日志属于正常情况。

排障时临时提高等级，按本次保存后的时间窗口查看记录；降低等级不会删除历史日志。Trace 的逐次通信细节在大量点位下会增加日志负担，完成检查后恢复项目使用的等级。

配置设备级冗余

设备级冗余在同一网关内选择另一台采集设备工作。先分别验证主、备设备的通道、协议参数和变量，让两个源返回不同的已知值，才能看清实际来源。

1. 编辑主设备，开启“启用冗余”，选择使用相同插件、未被其他设备占用的备用设备；备用设备不再开启自己的冗余。
2. 备用设备需要保持使能并具备可启动的任务。仅创建备用对象不能完成接管。
3. 选择故障切换，扫描间隔先使用 10000 毫秒或更长。它是冗余判断周期，当前编辑器最小值为 10000，与设备采集周期分别设置。
4. 先手动切换，核对运行角色和实际源值；再在维护窗口中断主源，验证离线条件触发接管。恢复主源后检查当前角色，不要凭主源恢复就判断已经回切。
5. 脚本切换时，先创建并编译“数据转换”脚本，再选择它。该入口传入当前设备运行信息，返回布尔值决定是否提出切换；它不是普通变量原始值转换，也没有独立的参数编辑区。

手动切换从配置主设备的详情进入；备用设备没有开启自己的冗余时，其详情不显示该按钮。切换后仍从配置主设备入口操作，并用运行角色和实际源值确认当前工作的一侧。

脚本条件需要能在目标角色上保持稳定。例如只在备用设备需要回切时返回 true，在正常主设备上返回 false；若两侧都持续返回 true，后续扫描可能反复提出切换。先用返回 false 的脚本验证绑定，再加入明确的角色或业务条件。

保存设备配置会重建设备任务，可能恢复配置主设备；应把保存引起的重建与后续扫描触发的切换分开观察。关闭冗余只解除配对，不会删除备用设备及其通道。整套 Runtime 的业务接管见网关冗余。

扩大点位前的验证

1. 验证一个点的读数、类型和质量。
2. 添加同一区域的少量点位，确认连续地址能正确打包。
3. 扩大到计划数量，记录实际在线设备、连接数、成功与失败增量。
4. 使用实际经过秒数计算请求速率，并观察 CPU、内存及完整扫描时间。
5. 再调整一个参数，保持其余条件一致，比较业务结果。

设备成功次数、协议请求次数、在线变量数和每秒变量更新量是不同指标。容量测试方法见规模验证与容量规划。