3. CEID 配置流程总览：从需求分析到上线部署的完整生命周期

CEID（Collection Event ID）配置并非一次性编码活动，而是一个覆盖需求分析、设计、开发、验证到部署的完整工程生命周期。本章从全局视角梳理 CEID 配置的各个阶段，并介绍支撑各阶段的配置工具与接口，帮助你在实际项目中建立清晰的实施路线图。

3.1 CEID 配置生命周期全景图

下图展示了 CEID 配置从启动到上线的 6 个核心阶段，以及每个阶段的关键交付物。

3.2 各阶段详细说明

3.2.1 需求分析阶段

需求分析是 CEID 配置的起点，也是最容易被忽视的环节。此阶段的核心任务是明确“设备需要上报哪些事件”以及“每个事件需要携带哪些数据”。

3.2.2 CEID 设计阶段

CEID 设计阶段将需求转化为具体的 SECS/GEM 配置方案。核心工作包括 CEID 编号分配、VID 映射表设计以及事件组（Event Group）规划。

3.2.3 配置开发阶段

配置开发阶段将设计文档转化为机器可执行的配置。根据设备平台的不同，开发方式分为三类：

// 示例：通过 API 动态注册 CEID（C# 伪代码）
public void ConfigureCEID()
{
    // 1. 创建 CEID 对象
    CollectionEvent ce = new CollectionEvent(1001, "WaferStart");
    
    // 2. 关联 VID（数据变量）
    ce.AddReportItem(new ReportItem(VID: 201, "SlotID"));
    ce.AddReportItem(new ReportItem(VID: 202, "WaferID"));
    ce.AddReportItem(new ReportItem(VID: 301, "ProcessTime"));
    
    // 3. 设置触发条件
    ce.TriggerCondition = TriggerType.OnStateChange;
    
    // 4. 注册到 GEM 层
    gemService.RegisterCEID(ce);
    
    // 5. 启用事件上报
    gemService.EnableCEID(1001);
}

3.2.4 单元测试阶段

单元测试在开发环境中验证 CEID 配置的正确性。推荐使用 SECS/GEM 模拟器进行测试，避免直接操作真实设备。

3.2.5 系统联调阶段

系统联调将设备端与上位系统（MES/EAP）对接，验证端到端的事件上报链路。此阶段需要双方共同制定联调测试用例。

3.2.6 上线部署与监控阶段

上线部署建议采用灰度策略：先在一台设备上部署并观察 24 小时，确认无误后再逐步扩大到全部设备。部署完成后需要建立持续监控机制。

3.3 配置工具与接口介绍

CEID 配置涉及多种工具和接口，下表汇总了各阶段推荐使用的工具及其功能定位：

3.3.1 核心接口：CEID 配置 API

对于需要动态管理 CEID 的场景，通常提供以下 REST 接口：

# CEID 配置管理 REST API 示例

# 1. 查询所有已注册的 CEID
GET /api/v1/gem/ceids
Response: { "ceids": [1001, 1002, 1003, ...] }

# 2. 查询单个 CEID 的详细信息
GET /api/v1/gem/ceids/{ceid}
Response: {
  "ceid": 1001,
  "name": "WaferStart",
  "enabled": true,
  "reports": [
    {"vid": 201, "name": "SlotID"},
    {"vid": 202, "name": "WaferID"}
  ]
}

# 3. 动态启用/禁用 CEID
PUT /api/v1/gem/ceids/{ceid}/state
Body: { "enabled": false }
Response: { "status": "success" }

# 4. 批量导入 CEID 配置（从 CSV 文件）
POST /api/v1/gem/ceids/import
Body: multipart/form-data (file: ceid_config.csv)
Response: { "imported": 15, "failed": 0 }

3.4 生命周期管理最佳实践