feat(WCS): 完善 WIDESEAWCS_Tasks 模块代码注释

wanshenmean

2026-03-26 8e42d0c1b7ae36cff2e7c69999117911a4b6f300

 Code/WCS/WIDESEAWCS_Server/WIDESEAWCS_Tasks/ConveyorLineNewJob/ConveyorLine/ConveyorLineDBNameNew.cs

@@ -1,93 +1,164 @@
#region << 版 本 注 释 >>
/*----------------------------------------------------------------
 * 命名空间：WIDESEAWCS_Tasks.ConveyorLineJob
 * 创建者：胡童庆
 * 创建时间：2024/8/2 16:13:36
 * 版本：V1.0.0
 * 描述：
 *
 * ----------------------------------------------------------------
 * 修改人：
 * 修改时间：
 * 版本：V1.0.1
 * 修改说明：
 * 
 *----------------------------------------------------------------*/
#endregion << 版 本 注 释 >>

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace WIDESEAWCS_Tasks
{
    /// <summary>
    /// 输送线 PLC 寄存器名称枚举（新版）
    /// </summary>
    /// <remarks>
    /// 定义输送线与 WCS 通信时使用的 PLC 寄存器地址名称。
    /// 包含任务号、地址、状态标志、条码等字段。
    /// WCS 通过这些寄存器与 PLC 交互，实现任务的下发、状态同步和完成确认。
    /// </remarks>
    public enum ConveyorLineDBNameNew
    {
        /// <summary>
        /// 任务号
        /// </summary>
        /// <remarks>
        /// PLC 和 WCS 之间共享的任务标识号。
        /// WCS 下发任务时写入，PLC 完成任务后保持。
        /// </remarks>
        TaskNo,

        /// <summary>
        /// 开始地址
        /// 开始地址/源地址
        /// </summary>
        /// <remarks>
        /// 任务的起始位置地址。
        /// 用于入库任务时表示货物来源，出库任务时表示货物当前位置。
        /// </remarks>
        Source,

        /// <summary>
        /// 目的地址
        /// 目标地址
        /// </summary>
        /// <remarks>
        /// 任务的目标位置地址。
        /// 用于入库任务时表示货物存放位置，出库任务时表示货物送达位置。
        /// </remarks>
        Target,

        /// <summary>
        /// 托盘类型
        /// </summary>
        /// <remarks>
        /// 标识托盘的规格类型。
        /// </remarks>
        BoxType,

        /// <summary>
        /// 设备空闲状态输送带状态
        /// 输送线空闲状态
        /// </summary>
        /// <remarks>
        /// 输送线当前是否空闲。
        /// 通常用于判断输送线上是否有货物正在移动。
        /// </remarks>
        CV_State,

        /// <summary>
        /// 输送故障代码
        /// 输送线故障代码
        /// </summary>
        /// <remarks>
        /// PLC 报告的设备故障代码。
        /// 0 表示无故障，非零值表示具体故障类型。
        /// </remarks>
        CV_ERRCode,

        /// <summary>
        /// WCS下发完成时，触发为1
        /// WCS 下发完成标志
        /// </summary>
        /// <remarks>
        /// WCS 下发任务完成时置 1。
        /// 通知 PLC 可以开始处理该任务。
        /// PLC 读取后应立即清除此标志。
        /// </remarks>
        WCS_STB,

        /// <summary>
        /// WCS收到完成时，触发为1
        /// WCS 应答标志
        /// </summary>
        /// <remarks>
        /// WCS 收到 PLC 请求后回复的确认标志。
        /// PLC 发出请求后等待 WCS 此标志置 1。
        /// </remarks>
        WCS_ACK,

        /// <summary>
        /// 完成任务时，触发为1
        /// PLC 任务完成标志
        /// </summary>
        /// <remarks>
        /// PLC 完成任务时置 1。
        /// 通知 WCS 任务已完成，可以进行后续处理。
        /// WCS 读取后应立即清除此标志。
        /// </remarks>
        PLC_STB,

        /// <summary>
        /// 收到任务时，触发为1
        /// PLC 应答标志
        /// </summary>
        /// <remarks>
        /// PLC 收到 WCS 命令后回复的确认标志。
        /// WCS 下发命令后等待 PLC 此标志置 1。
        /// </remarks>
        PLC_ACK,

        /// <summary>
        /// 入库站台，到位写1
        /// PLC 请求标志
        /// </summary>
        /// <remarks>
        /// PLC 主动请求服务时置 1。
        /// 通常用于入库站台，表示货物已到位，请求 WCS 下发任务。
        /// </remarks>
        PLC_REQ,

        /// <summary>
        /// WCS故障代码
        /// WCS 错误代码
        /// </summary>
        /// <remarks>
        /// WCS 报告的业务错误代码。
        /// 用于标识任务执行过程中的业务逻辑错误。
        /// </remarks>
        WCS_ERRCode,

        /// <summary>
        /// WCS特殊处理标识(旋转标识、强制放行、循环、特殊申请、是否叠盘、是否堵塞)
        /// WCS 特殊处理标识
        /// </summary>
        /// <remarks>
        /// 用于标识特殊处理需求，包含以下位标志（从低位到高位）：
        /// - 位0: 旋转标识
        /// - 位1: 强制放行
        /// - 位2: 循环
        /// - 位3: 特殊申请
        /// - 位4: 是否叠盘
        /// - 位5: 是否堵塞
        /// </remarks>
        WCS_Special,

        /// <summary>
        /// 手动1，自动2
        /// 设备自动模式
        /// </summary>
        /// <remarks>
        /// 标识设备的运行模式：
        /// - 1: 手动模式
        /// - 2: 自动模式
        /// </remarks>
        Equ_Auto,

        /// <summary>
        /// 尾盘标识
        /// 尾盘/尾板标识
        /// </summary>
        /// <remarks>
        /// 标识当前托盘是否为最后一个（尾盘）。
        /// 用于电池生产线的最后一道工序。
        /// </remarks>
        Last_pallet,

        /// <summary>
        /// 容器条码1,字符数组
        /// 托盘条码
        /// </summary>
        /// <remarks>
        /// 存储托盘的条码信息（22个字符）。
        /// 用于货物追踪和库位管理。
        /// </remarks>
        Barcode
    }
}