CSR配置字典之PropertySync类
更新时间： 2026/05/16
在Gitcode上查看源码📋 文档信息
| 项目 | 内容 |
|---|---|
| 文档标题 | PropertySync类配置字典 |
| 版本 | v1.0 |
| 创建日期 | 2025-05-13 |
| 最后更新 | 2026/05/16 |
| 维护状态 | ✅ 活跃维护 |
📋 变更历史记录
文档变更记录
| 版本 | 发布日期 | 变更类型 | 变更内容 | 影响范围 | 维护人员 |
|---|---|---|---|---|---|
| v1.0 | 2026/05/16 | 修订 | 与model.json同步更新，新增分类标准和同步模式说明 | PropertySync类所有CSR属性 | bmc_datasync组件组 |
🎯 类概览
PropertySync 类
| 属性 | 值 |
|---|---|
| 类名称 | PropertySync |
| 功能描述 | 属性同步配置类，用于配置属性同步模式、同步间隔、TTL和同步对象信息 |
| 所属SIG组 | hardware |
| 所属组件 | bmc_datasync |
| 责任人 | 基础服务组 |
| 最后更新 | 2026/05/16 |
| 状态 | 🟢 正常运行 |
📊 属性定义详表
PropertySync 类 - 必选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
TTL | U32 | - | U32，0表示不限制 | - | 当前同步的数据老化时限，超过后同步的数据会被清除，单位：秒，0：表示不限制 | 配置同步数据生命周期 | 3600 | CSR | 软件 |
SyncObjectItems | Array | - | Struct[] | - | 目标同步对象信息，结构参考types.json#defs/SyncObjectItem | 配置需要同步的对象 | 详见示例 | CSR | 软件 |
PropertySync 类 - 可选属性
| 属性名 | 类型 | 默认值 | 取值范围 | 动态关联 | 描述 | 使用场景 | 举例 | 来源 | 分类 |
|---|---|---|---|---|---|---|---|---|---|
SyncMode | U8 | 0 | 0-1 | - | 属性同步的模式 0：实时同步 1：周期性同步 | 配置同步模式 | 0 | CSR | 软件 |
SyncInterval | U8 | 5 | 5-60 | - | 同步间隔，仅周期性同步时使用，单位：秒，取值范围：5~60 | 配置同步间隔 | 30 | CSR | 软件 |
SyncObjectName | String | "" | String | - | 目标同步对象名 | 配置同步目标名称 | "TargetNode" | CSR | 软件 |
📂 同步模式说明
| 值 | 模式 | 描述 |
|---|---|---|
| 0 | 实时同步 | 属性变化立即同步 |
| 1 | 周期性同步 | 按SyncInterval间隔同步 |
📂 SyncObjectItem结构
| 字段 | 类型 | 描述 |
|---|---|---|
Interface | String | 目标同步对象的接口 |
Properties | String[] | 需要同步的属性列表 |
📂 分类标准
硬件属性
- 定义：与硬件特性和物理参数直接相关的属性
- 特点：无
- 示例：无
软件属性
- 定义：用于逻辑控制和软件管理的参数
- 特点：由CSR配置管理，用于属性同步逻辑控制
- 示例：
SyncMode、SyncInterval、TTL、SyncObjectName、SyncObjectItems
📝 配置示例
实时同步配置
json
{
"PropertySync": {
"SyncMode": 0,
"SyncInterval": 5,
"TTL": 3600,
"SyncObjectName": "TargetNode",
"SyncObjectItems": [
{
"Interface": "bmc.kepler.Systems.FruCtrl",
"Properties": ["PowerState", "PowerOnStrategy"]
}
]
}
}周期性同步配置
json
{
"PropertySync": {
"SyncMode": 1,
"SyncInterval": 30,
"TTL": 0,
"SyncObjectName": "BackupNode",
"SyncObjectItems": [
{
"Interface": "bmc.kepler.Systems.ThermalTrip",
"Properties": ["Action", "TimeDelaySeconds"]
}
]
}
}🔧 使用指南
配置步骤
- 设置SyncMode：选择实时同步或周期性同步模式
- 配置SyncInterval：周期性同步时设置间隔（5-60秒）
- 配置TTL：设置同步数据老化时限，0表示不限制
- 配置SyncObjectItems：定义需要同步的对象接口和属性列表
注意事项
- 实时同步 (0)：属性值变化时立即触发同步，适用于对实时性要求高的场景
- 周期性同步 (1)：按固定间隔同步，适用于对带宽敏感的场景
故障排查
- 属性未同步：检查SyncObjectItems配置是否正确
- 同步延迟：检查网络状况和SyncInterval设置
- 数据过期：检查TTL设置是否合理