Skip to main content

IPMI Command

The section provides detailed IPMI commands.

  • Name

    GetPSUCollectedData (Sum)

    NetFn

    0x32

    CMD

    0x90

    Request data / Response data

    Request:

    - Byte 1: Input type 1: AC-IN

    2: DC-OUT

    3: PSU fan power

    Response:

    (when AC-IN, DC-OUT)

    Byte 1 – completion code (0x00)

    Byte 2 – Sum of MIN AC-IN /(DC- OUT) LSB

    Byte 3 – Sum of MIN AC-IN /(DC- OUT) MSB

    Byte 4 – Sum of average AC-IN/(DC-OUT) LSB

    Byte 5 – Sum of average AC-IN/(DC-OUT) MSB

    Byte 6 – Sum of MAX AC-IN /(DC- OUT) LSB

    Byte 7 – Sum of MAX AC-IN /(DC- OUT) MSB

    (when Fan power)

    Byte 1 – completion code (0x00)

    Byte 2 - Sum of FAN_Power LSB

    Byte 3 - Sum of FAN_Power Byte 2

    Byte 4 - Sum of FAN_Power MSB

    Comments

    This command is used to show regularly collected data from PMBUS.

    1 Unit = 1 W

    Note
    Only FAN power unit using 10 mW = 0.0.1 W FAN total power = (MSB * 256* 256 ) + Byte2 (256) + LSB (10 mW)
  • Name

    GetPSUStatus

    NetFn

    0x32

    CMD

    0x91

    Request data / Response data

    Request:

    - None

    Response:

    Byte 1 – completion code (0x00)

    Byte 2 – PS_EPOW

    Byte 3 – PS_THROTTLE

    Byte 4 – PS_PRESENT

    Byte 5 – PS_PWR_GOOD

    Byte 6 – EPOW_OUT

    Byte 7 – THROTTLE

    Comments

    This command is used to show the PSU related register or Status (From PSOC)

    Bit: 0-5 = PSU1-6

    0: not trigger , 1: trigger

  • Name

    GetSySLED

    NetFn

    0x32

    CMD

    0x96

    Request data / Response data

    Request:

    - None

    Response:

    Byte 1 – completion code (0x00)

    Byte 2 – SysLocater LED

    Byte 3 – CheckLog LED

    Comments

    This command is used to get the FPC LED status.

    0: Off

    1: On

    2: Blink (Locater only)

  • Name

    SetSySLED

    NetFn

    0x32

    CMD

    0x97

    Request data / Response data

    Request:

    Byte 1: Input type
    • 1: SysLocater LED

    • 2: CheckLog LED

    Byte 2:
    • 0: Disable

    • 1: Enable

    • 2 blink (SysLocater only)

    Response:

    Byte 1 – completion code (0x00) PARAM_OUT_OF_RANGE (0xC9)

    Comments

    This command is used to get the FPC LED status.

    0: Off

    1: On

    2: Blink (Locater only)

  • Name

    ShowNodePowerConsume

    NetFn

    0x32

    CMD

    0x98

    Request data / Response data

    Request:

    Byte 1 –Node number (0x1~0x0d Node 1-12 , Chassis 13)

    Response:

    Byte 1 – completion code

    Byte 2 – Power minimum (LSB)

    Byte 3 – Power minimum (MSB)

    Byte 4 – Power average (LSB)

    Byte 5 – Power average (MSB)

    Byte 6 – Power maximum (LSB)

    Byte 7 – Power maximum (MSB)

    Comments

    This is used to show the Node power consume by MSG_POWER_READING

    command. Unit = 1 W

  • Name

    ShowInfoNodeSize

    NetFn

    0x32

    CMD

    0x99

    Request data / Response data

    Request:

    Byte 1 –Node number (0x1~0x0c Node 1-12)

    Response:

    Byte 1 – completion code

    Byte 2 – Node Phyical Width

    Byte 3 – Node Phyical Hight

    Byte 4 – AddOn Vaild

    Byte 5 – AddOn Width

    Byte 6 – AddOn Hight

    Comments

    This is used to show Node size info by MSG_GET_NODE_SIZE command got from XCC.

  • Name

    SetPSUFFS

    NetFn

    0x32

    CMD

    0x9a

    Request data / Response data

    Request:

    Byte 1: FFS number(1-2)

    Byte 2: input value (0/1)

    Response:

    Byte 1 – completion code OUT_OF_RANGE (0xC9)

    Comments

    This is used to set PSU FFS 0: not triggered

    1: triggered

  • Name

    SetAcousticMode

    NetFn

    0x32

    CMD

    0x9b

    Request data / Response data

    Request:

    Byte 1 – Acoustic mode

    Response:

    Byte 1 – completion code (0x0) OUT_OF_RANGE (0xC9) PCIe priority high(0x01)

    Comments

    0x00 = Disable

    0x01 = Mode1 Enable

    System fan cannot exceed 20 duty.

    0x02 = Mode2 Enable

    System fan cannot exceed 50 duty.

    0x03 = Mode3 Enable

    System fan cannot exceed 80 duty.

  • Name

    SetOverSubMode

    NetFn

    0x32

    CMD

    0x9c

    Request data / Response data

    Request:

    Byte 1 – Over Subscription mode

    Response:

    Byte 1 – completion code (0x00) CUR_NOT_SUPPORT(0xd5) PARAM_OUT_OF_RANGE(0xc9)

    Comments

    0x0 = Disable

    0x1 = Enable

    Note
    The OVS enable.

    Total power bank would become TP *1.20. Only exception is TP * 1.20 > current available power (number of PWRGD * power type). The power bank would be current available power.

  • Name

    GetCappingCapity

    NetFn

    0x32

    CMD

    0x9d

    Request data / Response data

    Request:

    Byte 1 –Node number (0x1~0x0d : Node 0x1~0xc , Chassis 0x0d)

    Response:

    Byte1 – completion code (0x00) Out of Range (0xc9)

    Byte2 – Min. capping value LSB

    Byte3 – Min. capping value MSB

    Byte4 – Max. capping value LSB

    Byte5 – Max. capping value MSB

    Comments

    Node Capping Range:

    (Node min power capacity ) < Cap < (Node max power capacity)

    Chassis Capping Range: (Sum of Node min power capacity ) < Cap ) The Min power should consider the permission pass nodes.

    Note
    Capping will only be applied in OS-runtime. The configuration of chassis level current capping is not the same behavior with sum of node level.
  • Name

    SetCappingValue

    NetFn

    0x32

    CMD

    0x9e

    Request data / Response data

    Request:

    Byte 1 –Node number (0x1~0x0d : Node 0x1~0xc , Chassis 0x0d)

    Byte 2 – Capping Value LSB Byte 3 – Capping Value MSB Response:

    Byte 1 – completion code (0x00) OUT_OF_RANGE (0xC9) CUR_NOT_SUPPORT(0xD5)

    Comments

    Note
    Capping / Saving not support when node with no permission

    Capping value range ( 1~32767)

  • Name

    SetCappingSavingState

    NetFn

    0x32

    CMD

    0x9f

    Request data / Response data

    Request:

    Byte 1 –Node number (0x1~0x0d : Node 0x1~0xc , Chassis 0x0d)

    Byte 2 – Capping disable /enable Byte 3 – Saving mode Response:

    Byte 1 – completion code (0x00) OUT_OF_RANGE (0xC9

    Comments

    Note: Capping / Saving not support when node with no permission

    Byte 3 : Saving mode 0x00 = Disable

    0x01 = Saving mode1

    0x02 = Saving mode2

    0x03 = Saving mode3

  • Name

    GetCappingSavingState

    NetFn

    0x32

    CMD

    0Xa0

    Request data / Response data

    Request:

    Byte 1 –Node number (0x1~0x0d : Node 0x1~0xc , Chassis 0x0d)

    Response:

    Byte 1 – completion code (0x00) OUT_OF_RANGE (0xC9)

    Byte 2 – Capping disable /enable

    Byte 3 – Capping Value LSB

    Byte 4 – Capping Value MSB

    Byte 5 – Saving mode

    Comments

    Capping mode: 0x00 = Disable 0x01 = Enable Saving mode: 0x00 = Disable

    0x01 = Saving mode1 0x02 = Saving mode2 0x03 = Saving mode3

  • Name

    SetSysTime

    NetFn

    0x32

    CMD

    0xa1

    Request data / Response data

    Request:

    Byte 1 – Year_MSB(1970 ~2037)

    Byte 2 – Year_LSB (1970 ~2037)

    Byte 3 – Month (0x01~0x12)

    Byte 4 – Date (0x01~0x31)

    Byte 5 – Hour (0x00~0x23)

    Byte 6 – Minute (0x00~0x59)

    Byte 7 – Second (0x00~0x59)

    Response:

    Byte 1 – completion code (0x00)

    Comments

    For user input convenient, the input data is decimal format.

    Example: Year 2010 byte1 : 0x20

  • Name

    GetPSUPolicyBank

    NetFn

    0x32

    CMD

    0xa2

    Request data / Response data

    Request:

    - None

    Response:

    Byte 1 – completion code (0x00) Byte 2 – PSU_Policy

    Byte 2 – PSU_Policy
    • 0: No-Redundant

    • 1: N+1 Policy

    • 2: N+N Policy

    Byte 3 – Oversubscription Mode
    • 0: disable

    • 1: enable

    Byte 4 – PowerBankLSB

    Byte 5 – PowerBankMSB

    Comments

    This command is used for get PSU policy and total power bank. (Unit :1W)

  • Name

    SetPSUPolicy

    NetFn

    0x32

    CMD

    0xa3

    Request data / Response data

    Request:

    Byte 1 – PSU_Policy: 0: No-Redundant
    • 1: N+1 Policy

    • 2: N+N Policy

    Response:

    Byte 1 – completion code (0x00) Out of Range (0xC9) PSU_CONFIG_NOT_ALLOW(0x01) PSU_BANK_LACK(0x02)

    Comments

    This command is used for set PSU policy.

    We may not set the PSU policy successful because configuration invalid.

  • Name

    ResetNodeByUser

    NetFn

    0x32

    CMD

    0xa4

    Request data / Response data

    Request:

    Byte 1 – Node number (0x1~0x0c Node 1-12 )

    Byte 2 – Reset Action
    • 1: reset (imm-reset)

    • 2: reseat (aux-off -> aux-on)

    Response:

    Byte 1 – completion code (0x00) CUR_NOT_SUPPORT (0xd5)

    Comments

    This command is used for Reset/Reseat node by user If node not present, it would response 0xd5

  • Name

    OEMGetPSUFanStatus

    NetFn

    0x32

    CMD

    0xa5

    Request data / Response data

    Request:

    Byte 1 – PSU FAN number (0x1~0x06 FAN 1-6 )

    Response:

    Byte 1 – FAN_Speed_LSB (rpm)

    Byte 2 – FAN_Speed_MSB (rpm)

    Byte 3 – FAN speed (0~100%)

    Byte 4 – FAN health
    • 0 : Not Present 1 : Ab-Normal

    • 2 : Normal

    Comments

    This command is used for get PSU fan status

    Note
    Ab-Normal means PSU rpm is lower than3000 rpms
  • Name

    OEMSetStorage

    NetFn

    0x32

    CMD

    0xa6

    Request data / Response data

    Request:

    Byte 1 – Actions
    • 1: USB Back Up

    • 2: USB Restore config

    • 3: Get USB restore status

    • 4: Restore to default config

    Response:

    Byte 1 – 0x00 (Action activated)
    • 0x01 (Device busy)

    • 0x02 (Device not installed)

    • 0x03 (BackUp config invalid) Only when Get USB restore status :
      • Byte 1 - Restore status

      • Byte 2 - Node Capping fail LSB

      • Byte 3 - Node Capping fail MSB

      • Byte 4 - Node Saving fail LSB

      • Byte 5 - Node Saving fail MSB

    Comments

    Note
    The input “Get USB restore status” show the Restore action status.

    The restore action must take at least 5 seconds.

    USB restore status: 0x00: Restore success

    Bitmask when bit is on:
    • Bit-0: Set PSU_Policy_fail

    • Bit-1: Set PSU_OVS_fail

    • Bit-2: Chassis Capping fail

    • Bit-3: Chassis Saving fail

    • Bit-4: Acoustic fail

    • Bit-5: Node power restore policy fail

    • Bit-6: Smart Redundant fail

  • Name

    OEMGetNodeStatus

    NetFn

    0x32

    CMD

    0xa7

    Request data / Response data

    Request:

    Byte 1 – Node number (0x1~0x0C )

    Response:

    Byte 1 – completion code (0x00) Out of Range (0xC9)

    Byte 2 – Node Power State Byte 3 – Width

    Byte 4 – Height

    Byte 5 – Permission state

    Comments

    Bit-Mask of Node Power State :
    • 0x00 = Power OFF

    • 0x10 = S3

    • 0x20 = No Permission

    • 0x40 = Fault

    • 0x80 = Power ON

    Permission state :
    • 0x00 = Not present

    • 0x01 = Standby

    • 0x02 = First_permission_fail

    • 0x03 = Second_permission_fail

    • 0x04 = Permission pass (Secondary boot pass)

  • Name

    GetFPCStatus

    NetFn

    0x32

    CMD

    0xa8

    Request data / Response data

    Request:

    - None

    Response:

    Byte 1 – completion code (0x00)

    Byte 2 – FPC major version

    Byte 3 – FPC minor version

    Byte 4 – PSOC major version

    Byte 5 – PSOC minor version

    Byte 6 – Boot Flash number (0x1- 0x2)

    Byte 7 – Build major number

    Byte 8 – Build minor number

    Comments

    The build minor is using ASCII value

    ex: 0x41 = ‘A’

  • Name

    SetRestorePolicy

    NetFn

    0x32

    CMD

    0xa9

    Request data / Response data

    Request:

    Byte 1 – Node number LSB (BIT_MASK : 0x0~0x3F )

    Byte 2 – Node number MSB (BIT_MASK : 0x0~0x3F )

    Response:

    Byte 1 – completion code (0x00) Out of Range (0xC9)

    Comments

    Example:

    If set node 1-3 enable, then Byte 1 = 0x7 (0000 0111)

  • Name

    GetRestorePolicy

    NetFn

    0x32

    CMD

    0xaa

    Request data / Response data

    Request:

    - None

    Response:

    Byte 1 – completion code (0x00)

    Byte 2 – Node number LSB

    Byte 3 – Node number MSB

    Comments

  • Name

    SetSmartRedundant

    NetFn

    0x32

    CMD

    0xab

    Request data / Response data

    Request:

    Byte 1 – mode:

    Response:

    Byte 1 – completion code (0x00) Out of Range (0xC9) Not Support (0x01)

    Comments

    Mode (0-3):

    0 : disable

    1: per 10 minutes update

    2: per 30 minutes update

    3: per 60 minutes update (If PSU in “not support” or “mismatch “stage, the PSU smart-redundant also not support.

  • Name

    GetSmartRedundantStauts

    NetFn

    0x32

    CMD

    0xac

    Request data / Response data

    Request:

    - None

    Response:

    Byte 1 – completion code (0x00)

    Byte 2 – mode

    Byte 3 – Status

    Comments

    Status:

    0x00: Normal

    0x01: Not support

  • Name

    SetFPCResetDefault

    NetFn

    0x32

    CMD

    0xad

    Request data / Response data

    Request:

    - None

    Response:

    Byte 1 – completion code (0x00)

    Comments

    This command is used for reset FPC to default value by user

  • Name

    CmdCipherSuiteChange

    NetFn

    0x32

    CMD

    0xb1

    Request data / Response data

    Request:

    Byte 1 – cipher suite level 0x0: get current cipher suite
    • 0x1: set cipher suite to level 1

    • 0x2: set cipher suite to level 2

    Response:

    Byte 1 – completion code (0x00)

    Comments

    This command is used for get/set current cipher suite level.

  • Name

    Failsafe Logging

    NetFn

    0x32

    CMD

    0xD2

    Request data / Response data

    Request:

    Byte 1 – Status
    • 0x00: Disable (default setting)

    • 0x01: Enable

    Response:

    Byte 00 – Completion code

    Byte 01 – Last status

    Byte 02 – Set status

    Comments

    While enabled, FPC will assert a SELwhen the node enter failsafe state for over 3 seconds;then, FPC will log chassis status in USB dongle when the node enter failsafe state for over 7 minutes.

    Note
    This command is only available for the 1.08, FHET30M or later versions.
  • Name

    Failsafe Virtual Reseat

    NetFn

    0x32

    CMD

    0xD3

    Request data / Response data

    Request:

    Byte 1 – Status
    • 0x00: Disable (default setting)

    • 0x01: Enable

    Response:

    Byte 00 – Completion code

    Byte 01 – Last status

    Byte 02 – Set status

    Comments

    When enabled, FPC will proceed a virtual reseat for the node which enters failsafe state for over 7 minutes.

    Note
    This command is only available for the 1.08, FHET30M or later versions.