📋 文档信息 ​

📋 变更历史记录 ​

文档变更记录 ​

🎯 类概览 ​

PowerButton 类 ​

ACCycle 类 ​

PGSignal 类 ​

ButtonEvt 类 ​

📊 属性定义详表 ​

PowerButton 必选属性 ​

ACCycle 必选属性 ​

PGSignal 必选属性 ​

PGSignal 可选属性 ​

ButtonEvt 可选属性 ​

🔗 动态关联机制 ​

语法规范 ​

使用 #/xxx 和 <=/xxx 格式实现动态关联：

# PowerButton 关联
ShortPushButton: "#/Accessor_ShortPushButton.Value"
LongPushButton: "#/Accessor_LongPushButton.Value"

# ACCycle 关联
AC: "#/Accessor_AC.Value"

# PGSignal 关联
PowerGDState: "<=/Scanner_PowerGd.Value"

# ButtonEvt 关联
PowerBtnLock: "#/Accessor_PowerBtnLock.Value"
GetPowerBtnEvt: "<=/Scanner_PowerBtnEvt.Value"
SetPowerBtnEvt: "#/Accessor_PowerBtnEvt.Value"
PowerBtnShield: "#/Accessor_PowerBtnShield.Value"

关联说明 ​

• PowerButton: 关联Accessor对象用于按钮控制
• ACCycle: 关联Accessor对象用于AC电源控制
• PGSignal: 关联Scanner对象读取电源良好信号
• ButtonEvt: 关联Scanner和Accessor对象用于按钮事件管理

📂 分类标准 ​

硬件属性 ​

• 定义：与硬件电源控制直接相关的参数
• 特点：通过硬件寄存器实现电源控制功能
• 示例：所有属性均为硬件属性

软件属性 ​

• 定义：用于软件逻辑控制的参数
• 特点：本类集合中暂无纯软件属性
• 示例：无

📝 配置示例 ​

完整电源管理配置 ​

{
  "PowerButton": {
    "ShortPushButton": "#/Accessor_ShortPushButton.Value",
    "LongPushButton": "#/Accessor_LongPushButton.Value"
  },
  "ACCycle": {
    "AC": "#/Accessor_AC.Value"
  },
  "PGSignal": {
    "PowerGDState": "<=/Scanner_PowerGd.Value",
    "@Default": {
      "PowerGDState": 255
    }
  },
  "ButtonEvt": {
    "PowerBtnLock": "#/Accessor_PowerBtnLock.Value",
    "GetPowerBtnEvt": "<=/Scanner_PowerBtnEvt.Value",
    "SetPowerBtnEvt": "#/Accessor_PowerBtnEvt.Value",
    "PowerBtnShield": "#/Accessor_PowerBtnShield.Value"
  }
}

简化配置 ​

{
  "PowerButton": {
    "ShortPushButton": "#/Accessor_ShortPushButton.Value",
    "LongPushButton": "#/Accessor_LongPushButton.Value"
  },
  "PGSignal": {
    "PowerGDState": "<=/Scanner_PowerGd.Value"
  }
}

🔧 使用指南 ​

配置步骤 ​

1. PowerButton配置：关联短按和长按按钮的Accessor对象
2. ACCycle配置：关联AC电源控制的Accessor对象
3. PGSignal配置：关联电源良好信号的Scanner对象
4. ButtonEvt配置：关联按钮事件相关的Scanner和Accessor对象
5. 验证关联：确保所有关联对象已正确定义

注意事项 ​

• 按钮操作：PowerButton需要先写0后写1来执行操作
• AC操作：写寄存器值为1表示执行AC断电
• 信号读取：PGSignal只能从硬件读取，不能写入
• 事件管理：ButtonEvt支持按钮锁定和事件清除功能

性能建议 ​

• 及时处理：及时处理按钮事件和电源状态变化
• 状态监控：实时监控电源良好信号状态
• 安全操作：确保电源操作的安全性和可靠性

故障排查 ​

• 按钮无响应：检查PowerButton关联的Accessor对象
• AC操作失败：检查ACCycle关联的Accessor对象
• 信号读取异常：检查PGSignal关联的Scanner对象
• 事件处理异常：检查ButtonEvt相关的对象关联

电源按钮管理 ​

• 短按功能：通过ShortPushButton实现短按操作
• 长按功能：通过LongPushButton实现长按操作
• 操作方式：先写0后写1来触发按钮操作
• 应用场景：用于系统的上下电控制

AC电源管理 ​

• AC功能：支持AC电源循环操作
• 断电操作：写1到AC寄存器执行断电
• 应用场景：BMC和OS同时断电重启
• 安全机制：提供安全的断电重启功能

电源信号监控 ​

• 信号读取：实时读取电源良好信号
• 状态判断：1表示上电，0表示下电
• 默认值：支持默认值配置
• 应用场景：监控系统电源状态

按钮事件处理 ​

• 按钮锁定：通过PowerBtnLock屏蔽按钮功能
• 事件获取：通过GetPowerBtnEvt获取按钮事件
• 事件清除：通过SetPowerBtnEvt清除按钮事件
• 短按屏蔽：通过PowerBtnShield仅屏蔽短按功能