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

wanshenmean

2026-03-26 8e42d0c1b7ae36cff2e7c69999117911a4b6f300

 Code/WCS/WIDESEAWCS_Server/WIDESEAWCS_Tasks/StackerCraneJob/StackerCraneDBName.cs

@@ -1,85 +1,109 @@
#region << 版 本 注 释 >>
/*----------------------------------------------------------------
 * 命名空间：WIDESEAWCS_Tasks.StackerCraneJob
 * 创建者：胡童庆
 * 创建时间：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.StackerCraneJob
{
    /// <summary>
    /// 堆垛机 PLC 寄存器名称枚举
    /// </summary>
    /// <remarks>
    /// 定义堆垛机与 WCS 通信时使用的 PLC 寄存器地址名称。
    /// 包含任务号、作业类型、起止位置等信息。
    /// </remarks>
    public enum StackerCraneDBName
    {
        /// <summary>
        /// 任务号
        /// </summary>
        /// <remarks>
        /// WCS 分配的任务唯一标识号。
        /// 用于 WCS 和堆垛机之间建立任务对应的关联。
        /// </remarks>
        TaskNum,

        /// <summary>
        /// 作业类型
        /// </summary>
        /// <remarks>
        /// 标识任务的类型。
        /// </remarks>
        WorkType,

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

        /// <summary>
        /// 起始行
        /// </summary>
        /// <remarks>
        /// 任务的起始位置-行坐标。
        /// 用于确定库位在货架中的行位置。
        /// </remarks>
        StartRow,

        /// <summary>
        /// 起始列
        /// </summary>
        /// <remarks>
        /// 任务的起始位置-列坐标。
        /// 用于确定库位在货架中的列位置。
        /// </remarks>
        StartColumn,

        /// <summary>
        /// 起始层
        /// </summary>
        /// <remarks>
        /// 任务的起始位置-层坐标。
        /// 用于确定库位在货架中的层位置。
        /// </remarks>
        StartLayer,

        /// <summary>
        /// 目标行
        /// </summary>
        /// <remarks>
        /// 任务的目标位置-行坐标。
        /// 入库时表示货物存放的行位置，出库时表示货物来源的行位置。
        /// </remarks>
        EndRow,

        /// <summary>
        /// 目标列
        /// </summary>
        /// <remarks>
        /// 任务的目标位置-列坐标。
        /// 入库时表示货物存放的列位置，出库时表示货物来源的列位置。
        /// </remarks>
        EndColumn,

        /// <summary>
        /// 目标层
        /// </summary>
        /// <remarks>
        /// 任务的目标位置-层坐标。
        /// 入库时表示货物存放的层位置，出库时表示货物来源的层位置。
        /// </remarks>
        EndLayer,

        /// <summary>
        /// 作业指令
        /// </summary>
        /// <remarks>
        /// 控制堆垛机的动作：
        /// - 1: 开始执行任务
        /// - 2: 任务完成/停止
        /// </remarks>
        WorkAction,

        ///// <summary>
        ///// 托盘号
        ///// </summary>
        //Barcode,

        /// <summary>
        /// 当前任务号
        /// </summary>
        /// <remarks>
        /// 堆垛机当前正在执行的任务号。
        /// </remarks>
        CurrentTaskNum
    }
}