【已评审】新增资源协作接口和redfish属性，用于控制BMC是否向LCNE同步时间

Interface SIG Interface评审
1

背景

BMC需支持是否开启对LCNE的时间同步功能，供网管或用户进行设置，BMC默认不同步时间给LCNE

关联ISSUE

暂无

整体方案

新增交换侧TimeSyncEnabled属性，用于开启或关闭BMC给LCNE同步时间功能

评审点

1、资源协作接口bmc.kepler.LCN.Manage新增属性TimeSyncEnabled，用于开启或关闭BMC向LCNE同步时间功能

2、redfish接口/redfish/v1/Oem/{{OemIdentifier}}/LCNService/LCNDevices/{LCNDeviceId}新增属性TimeSyncEnabled，用于查询和设置BMC向LCNE同步时间功能的开启和关闭

详细描述

1、新增资源协作接口属性：

资源path：/bmc/kepler/LCNs/:Id

资源interface：bmc.kepler.LCN.Manage

变化类型：新增属性TimeSyncEnabled

持久化类型：掉电持久化

操作权限：读写。R: ReadOnly、W：BasicSetting

详细描述：

属性名称 变化类型 签名 读写&权限 持久化 发送变化通知 接口说明 接口约束
TimeSyncEnabled 新增属性 b 读写。R: ReadOnly、W：BasicSetting 掉电持久化 true BMC是否向LCNE同步时间 取值范围：true、false；true为开启，false为关闭，默认值false

2、新增设置同步时间功能是否开启的redfish接口属性：

URI：/redfish/v1/Oem/{{OemIdentifier}}/LCNService/LCNDevices/{LCNDeviceId}

接口类型：GET/PATCH

变化类型：新增属性TimeSyncEnabled

属性说明：用于查询和设置BMC向LCNE同步时间的使能状态

属性名称 变化类型 数据类型 说明 默认值 约束
TimeSyncEnabled 新增属性 boolean BMC是否向LCNE同步时间，true为开启，false为关闭 false

请求举例：

{ 
    "ManagedByBMC"：true,
    "TimeSyncEnabled"：false,
    "EventRecieveEnabled"：true
}

schema说明：

"TimeSyncEnabled": {
     "type": "boolean",
     "readonly": false,
     "description": "Indicates that whether the BMC synchronizes time with the LCN device. If this property is absent, the default is 'false'.",
     "longDescription": "This property indicates that whether the BMC synchronizes time with the LCN device. If this property is absent, the default is 'false'."
     },

评审结论

1、同意资源协作接口bmc.kepler.LCN.Manage新增如下属性：

  • TimeSyncEnabled：签名为b，表示BMC是否向LCNE同步时间，true - 同步，false - 不同步，可读写，读权限：ReadOnly，写权限：BasicSetting

2、同意/redfish/v1/Oem/{{OemIdentifier}}/LCNService/LCNDevices/{LCNDeviceId}GET响应体新增属性TimeSyncEnabled，类型为boolean，并支持PATCH操作

遗留问题

无