【已评审】SerialManagement、Uart对象新增CSR属性

评审背景

  • 某机型支持Uart over hisport, 总共支持2路hisport,2路hisport均可以支持Uart。
  • 但是在使用uart over hisport 时 host uart的sol功能不可用。因此需要适配hisport over uart功
  • 由于uart0和uart1无法实现串口录音。因此串口录音,需要将uart0和uart1的接收端互联到UART3或者UART4来做系统录音
  • 系统串口需要支持串口录音,一键收集
  • 系统串口需要支持进互联,切换到面板串口和BMCsol串口

当前现状以及差距

现状和差距

  • 当前不支持uart over hisport功能,需要配置属性表示使能uart over hisport。
  • 系统串口当前支持串口录音,但是在使用uart over hisport 时 host uart的sol功能不可用,需要将host uart的tx连到uart3的rx上进行串口录音记录。这种连接是单向连接,但是当前配置的对象SerialManagement是表示互连。

解决方案

  • 配置使能uart over hisport功能。hisport 和 espi 复用芯片uart0和uart1端口,需要在初始化时按照配置使能uart over hisport功能。新增属性BusType,表示协议类型,通过该值确认初始化时,hisport和espi是否需要复用uart端口

  • 在使用uart over hisport 时 host uart的sol功能不可用,hisport存在多个tx和一个rx,在初始化时需要将host uart的tx连到uart3的rx上进行串口录音记录,这种连接是单向连接。由于不是所有产品都需要此功能,因此此功能需要根据产品配置。由于当前SerialManagement是互连,例如决策点2的案例中port2的tx连接uart2的rx且port2的rx连接在uart2的tx。因此需要新增属性ConnectMode,表示单向连接或者双向连接。

决策点1 Uart对象下新增属性BusType

说明
属性名称 BusType
属性类型 String
属性读写 只读
属性权限 R:ReadOnly
W:不涉及
属性广播 false
属性值来源 CSR
默认值 Uart
持久化
属性说明 串口协议类型
取值:
    Uart – 表示Uart端口
    UartOverHisport – 表示hisport复用Uart端口
    UartOverEspi – 表示Espi复用Uart端口

示例:

        "Uart_0": {
            "Id": 0,
            "Description": "UART0默认不连接",
            "UartConnection": 255,
            "PortConnection": 255,
            "BaudRate": 115200,
            "DataBit": 8,
            "ParityBit": 78,
            "StopBit": 1,
            "SerialSwitch": "<=/Scanner_Gpio31.Value",
            "@Default": {
                "SerialSwitch": 1
            },
            "BusType": "Uart"
        }

决策点2 SerialManagement对象下新增属性ConnectMode

说明
属性名称 ConnectMode
属性类型 U8
属性读写 只读
属性权限 R:ReadOnly
W:不涉及
属性广播 false
属性值来源 CSR
默认值 0
持久化
属性说明 串口连接方式
取值:
    0:表示双向连接
    1:表示单向连接。

示例:

      "SerialManagement_1": {
            "Id": 1,
            "Description": "PORT2连接UART2",
            "Availability": 1,
            "RetainedPolicy": 0,
            "ConnectStatus": 0,
            "ConnectStatusResetPer": 0,
            "SrcSerial": 18,
            "Source": "PANEL COM",
            "SourceId": 1,
            "DestSerial": 2,
            "Destination": "BMC COM",
            "DestinationId": 4,
            "ConnectMode":1
        }

评审结论

  • 评审点1: 评审通过,同意在CSR对象Uart下新增属性 BusType ,表示串口协议类型,String类型 ,只读,读权限:ReadOnly, 默认值Uart,不发送变更通知事件。
  • 评审点2:评审通过,同意在CSR对象SerialManagement下新增属性 ConnectMode ,表示串口连接方式,U8类型 ,只读,读权限:ReadOnly, 默认值 0,不发送变更通知事件。