1*** Settings ***
2
3Documentation    Module to test PLDM platform commands.
4
5Library           ../lib/pldm_utils.py
6Variables         ../data/pldm_variables.py
7Resource          ../lib/openbmc_ffdc.robot
8Resource          ../lib/bmc_redfish_resource.robot
9Resource          ../lib/boot_utils.robot
10
11Test Setup        Printn
12Test Teardown     FFDC On Test Case Fail
13Suite Teardown    Pldmtool Platform Suite Cleanup
14
15*** Test Cases ***
16Verify GetPDR
17    [Documentation]  Verify GetPDR (Platform Descpritor Record) response message.
18    [Tags]  Verify_GetPDR
19
20    ${record_handle}=  Set Variable  ${1}
21    # Note: Record handle count is unknown and it is dynamic in nature.
22    #       Assuming there are 100 record handle.
23    FOR   ${i}  IN RANGE  100
24       ${next_record_handle}=  Run Keyword  Verify GetPDR For Record Handle  ${record_handle}
25       Exit For Loop If  ${next_record_handle} == 0
26       ${record_handle}=  Set Variable  ${next_record_handle}
27    END
28
29Verify SetStateEffecterStates
30    [Documentation]  Verify set state effecter states response message.
31    [Tags]  Verify_SetStateEffecterStates
32    [Template]  Verify SetStateEffecterStates For Effecter States
33
34    # EffecterHandle  Count  EffecterStates (effecterID effecterState)
35
36    '1'              '1'    '1 1'  # (effecterState -> 1 -> 'Boot Not Active')
37    '1'              '1'    '1 2'  # (effecterState -> 2 -> 'Boot Completed')
38    '2'              '1'    '1 9'  # (effecterState -> 9 -> 'System Power is in soft off mode')
39    '3'              '1'    '1 6'  # (effecterState -> 6 -> 'Graceful Restart Requested')
40
41*** Keywords ***
42
43Verify GetPDR For Record Handle
44    [Documentation]  Verify GetPDR (Platform Descpritor Record) for given input
45    ...              record handle and return next record handle.
46    [Arguments]  ${record_handle}
47
48    # Description of argument(s):
49    # ${record_handle}  Record handle.
50    #                   e.g. '1' is record handle 'Boot Progress' (196).
51    #                        '2' is record handle 'System Power State (260)'.
52    #                        '3' is record handle 'Software Termination Status (129)'.
53
54    # pldm_output:
55    # [responseCount]:                               29
56    # [recordHandle]:                                1
57    # [PDRHeaderVersion]:                            1
58    # [PDRType]:                                     11
59    # [recordChangeNumber]:                          0
60    # [dataLength]:                                  19
61    # [PLDMTerminusHandle]:                          0
62    # [effecterID]:                                  1
63    # [entityType]:                                  33
64    # [entityInstanceNumber]:                        0
65    # [containerID]:                                 0
66    # [effecterSemanticID]:                          0
67    # [effecterInit]:                                0
68    # [effecterDescriptionPDR]:                      false
69    # [compositeEffecterCount]:                      1
70    # [stateSetID]:                                  196
71    # [possibleStatesSize]:                          1
72    # [possibleStates]:                              6
73
74    ${pldm_cmd}=  Evaluate  $CMD_GETPDR % ${record_handle}
75    ${pldm_output}=  Pldmtool  ${pldm_cmd}
76    Rprint Vars  pldm_output
77
78    Run Keyword If  '${pldm_output['PDRType']}' == '${PLDM_PDR_TYPES['PLDM_STATE_EFFECTER_PDR']}'
79    ...  Valid Dict  pldm_output  valid_values=${RESPONSE_DICT_GETPDR_SETSTATEEFFECTER}
80
81    ...  ELSE IF  '${pldm_output['PDRType']}' == '${PLDM_PDR_TYPES['PLDM_PDR_FRU_RECORD_SET']}'
82    ...  Valid Dict  pldm_output  valid_values=${RESPONSE_DICT_GETPDR_FRURECORDSETIDENTIFIER}
83
84    ...  ELSE IF  '${pldm_output['PDRType']}' == '${PLDM_PDR_TYPES['PLDM_PDR_ENTITY_ASSOCIATION']}'
85    ...  Log To Console  "Found PDR Type - PLDM_ENTITY_ASSOCIATION_PDR"
86
87    ...  ELSE IF  '${pldm_output['PDRType']}' == '${PLDM_PDR_TYPES['PLDM_STATE_SENSOR_PDR']}'
88    ...  Valid Dict  pldm_output  valid_values=${RESPONSE_DICT_GETPDR_STATESENSORPDR}
89
90    ...  ELSE IF  '${pldm_output['PDRType']}' == '${PLDM_PDR_TYPES['PLDM_NUMERIC_EFFECTER_PDR']}'
91    ...  Valid Dict  pldm_output  valid_values=${RESPONSE_DICT_GETPDR_NUMERICEFFECTERPDR}
92
93    ...  ELSE IF  '${pldm_output['PDRType']}' == '${PLDM_PDR_TYPES['PLDM_TERMINUS_LOCATOR_PDR']}'
94    ...  Valid Dict  pldm_output  valid_values=${RESPONSE_DICT_GETPDR_TERMINUSLOCATORPDR}
95
96    ...  ELSE IF  '${pldm_output['PDRType']}' == '${PLDM_PDR_TYPES['PLDM_COMPACT_NUMERIC_SENSOR_PDR']}'
97    ...  Log To Console  "Found PDR Type - PLDM_COMPACT_NUMERIC_SENSOR_PDR'
98
99    ...  ELSE  Fail  msg="Unknown PDR Type is received"
100
101    Should be equal as strings  ${pldm_output['recordHandle']}  ${record_handle}
102    [Return]  ${pldm_output['nextRecordHandle']}
103
104Verify SetStateEffecterStates For Effecter States
105    [Documentation]  Verify set state effecter states for given input effecter states.
106    [Arguments]  ${effecter_handle}  ${count}  ${effecter_states}
107
108    # Description of argument(s):
109    # ${effecter_handle}   A handle that is used to identify and access the effecter (e.g. '1').
110    #                      e.g. '1' is effecter handle 'Boot Progress'.
111    #                           '2' is effecter handle 'System Power State'.
112    # ${count}             The number of individual sets of effecter information (e.g. '1').
113    # ${effecter_states}   (effecterID effecterState).
114    #                      e.g. '1 1'.
115
116    # Example output:
117    # {
118    #     "Response": "SUCCESS"
119    # }
120
121    ${pldm_cmd}=  Evaluate  $CMD_SETSTATEEFFECTERSTATES % (${effecter_handle}, ${count}, ${effecter_states})
122    ${pldm_output}=  Pldmtool  ${pldm_cmd}
123    Rprint Vars  pldm_output
124    Valid Value  pldm_output['Response']  ['SUCCESS']
125
126Pldmtool Platform Suite Cleanup
127    [Documentation]    Reset BMC at suite cleanup.
128
129    Redfish.Login
130    Redfish Hard Power Off
131    Redfish Power On
132    Redfish.Logout
133