📋 文档信息 ​

📋 变更历史记录 ​

文档变更记录 ​

🎯 类概览 ​

DiscreteEvent 类 ​

📊 属性定义详表 ​

必选属性 ​

可选属性 ​

🔗 动态关联机制 ​

语法规范 ​

使用 #/xxx 格式实现属性间的动态关联：

# 语法格式
属性名: "#/目标类.属性名"

# 实际示例
EventDir: "<=/Drive_2.Presence"           # 关联驱动器存在状态
SensorObject: "<=/DiscreteSensor_Disk0"   # 关联离散传感器对象

关联说明 ​

• EventDir: 关联外部状态源，监听事件方向变化
• SensorObject: 关联DiscreteSensor对象，建立事件与传感器的归属关系
• Property: 在组合监听模式下，包含完整的事件数据和方向信息

📂 分类标准 ​

软件属性 ​

• 定义：用于软件层面的事件处理和逻辑控制
• 特点：所有属性均为软件管理，支持复杂的事件监听和处理逻辑
• 示例：Property, ListenType, EventData1, EventData2, EventData3, EventDir, Conversion, InvalidReadingIgnore, InvalidReading, SensorObject

📝 配置示例 ​

组合监听模式配置 ​

{
  "DiscreteEvent": {
    "Property": "expr",
    "ListenType": 0,
    "EventData1": 255,
    "EventData2": 255,
    "EventData3": 255,
    "EventDir": 0,
    "SensorObject": "<=/DiscreteSensor_Disk0",
    "Conversion": 0,
    "InvalidReadingIgnore": 1,
    "InvalidReading": 255
  }
}

独立监听模式配置 ​

{
  "DiscreteEvent": {
    "Property": "expr",
    "ListenType": 1,
    "EventData1": 1,
    "EventData2": 255,
    "EventData3": 255,
    "EventDir": "<=/Drive_2.Presence",
    "SensorObject": "<=/DiscreteSensor_Disk0",
    "Conversion": 0,
    "InvalidReadingIgnore": 1,
    "InvalidReading": 255
  }
}

事件翻转配置 ​

{
  "DiscreteEvent": {
    "Property": "expr",
    "ListenType": 1,
    "EventData1": 1,
    "EventData2": 255,
    "EventData3": 255,
    "EventDir": "<=/Drive_2.Presence",
    "SensorObject": "<=/DiscreteSensor_Disk0",
    "Conversion": 1,
    "InvalidReadingIgnore": 1,
    "InvalidReading": 255
  }
}

简化配置（忽略默认值处理） ​

{
  "DiscreteEvent": {
    "Property": "expr",
    "ListenType": 1,
    "EventData1": 1,
    "EventData2": 255,
    "EventData3": 255,
    "EventDir": "<=/Drive_2.Presence",
    "SensorObject": "<=/DiscreteSensor_Disk0"
  }
}

🔧 使用指南 ​

配置步骤 ​

1. 选择监听模式：根据应用需求配置ListenType（0组合监听/1独立监听）
2. 配置事件数据：根据监听模式配置Property或EventData1-3
3. 设置事件方向：通过EventDir配置事件产生和恢复的监听
4. 关联传感器：通过SensorObject建立与DiscreteSensor的关联关系
5. 可选配置：根据需要配置Conversion、InvalidReadingIgnore等
6. 验证配置：确保事件数据格式符合IPMI标准

注意事项 ​

• 监听模式选择：ListenType决定了事件数据的来源方式
• 事件数据格式：EventData1-3需要符合IPMI 29.7 Event Data Field Formats
• 方向含义：EventDir中0表示恢复，非0表示产生
• 传感器关联：SensorObject必须关联已存在的DiscreteSensor对象
• 默认值处理：合理配置InvalidReading可以避免启动阶段误报警
• 事件翻转：Conversion用于翻转事件方向，谨慎使用

性能建议 ​

• 监听模式优化：根据实际需求选择合适的监听模式
• 事件过滤：使用InvalidReadingIgnore和InvalidReading过滤无效事件
• 关联优化：确保SensorObject关联的传感器配置正确
• 数据校验：EventData配置应符合IPMI标准表格要求

监听模式详解 ​

• 组合监听（ListenType=0）：
  • 事件数据和方向都来自Property属性
  • EventData1-3和EventDir不起作用
  • 适用于简单的事件监听场景
• 独立监听（ListenType=1）：
  • 事件数据来自EventData1-3
  • 事件方向来自EventDir
  • 提供更灵活的事件处理能力

常见问题 ​

• Q: 什么时候使用组合监听？什么时候使用独立监听？
  • A: 组合监听适用于简单场景，独立监听适用于需要精确控制事件数据和方向的复杂场景
• Q: EventData1-3的255默认值是否需要修改？
  • A: 根据IPMI标准和实际应用需求，EventData1通常需要配置具体值，EventData2和EventData3可以保持255默认值
• Q: InvalidReading设置为255的意义？
  • A: 当关联数据源的值为255时，系统不会产生事件，避免启动阶段的误报警