1#!/usr/bin/python
2
3r"""
4Contains PLDM-related constants.
5"""
6
7PLDM_SUPPORTED_TYPES = ['base', 'platform', 'bios', 'fru', 'oem-ibm']
8
9# PLDM types.
10PLDM_TYPE_BASE = {'VALUE': '00', 'STRING': 'base'}
11PLDM_TYPE_PLATFORM = {'VALUE': '02', 'STRING': 'platform'}
12PLDM_TYPE_BIOS = {'VALUE': '03', 'STRING': 'bios'}
13PLDM_TYPE_FRU = {'VALUE': '04', 'STRING': 'fru'}
14PLDM_TYPE_OEM = {'VALUE': '63', 'STRING': 'oem-ibm'}
15PLDM_SUPPORTED_TYPES = ['0(base)', '2(platform)', '3(bios)', '4(fru)', '63(oem-ibm)']
16
17VERSION_BASE = {'VALUE': ['f1', 'f0', 'f0', '00'], 'STRING': '1.0.0'}
18VERSION_PLATFORM = {'VALUE': ['f1', 'f2', 'f0', '00'], 'STRING': '1.2.0'}
19VERSION_BIOS = {'VALUE': ['f1', 'f1', 'f1', '00'], 'STRING': '1.0.0'}
20VERSION_FRU = {'VALUE': ['f1', 'f0', 'f0', '00'], 'STRING': '1.0.0'}
21VERSION_OEM = {'VALUE': ['f1', 'f0', 'f0', '00'], 'STRING': '1.0.0'}
22
23
24PLDM_BASE_CMDS = ['2(GetTID)', '3(GetPLDMVersion)', '4(GetPLDMTypes)', '5(GetPLDMCommands)']
25PLDM_PLATFORM_CMDS = ['57(SetStateEffecterStates)', '81(GetPDR)']
26PLDM_BIOS_CMDS = ['1(GetBIOSTable)', '7(SetBIOSAttributeCurrentValue)',
27                  '8(GetBIOSAttributeCurrentValueByHandle)', '12(GetDateTime)',
28                  '13(SetDateTime)']
29PLDM_FRU_CMDS = ['1(GetFRURecordTableMetadata)', '2(GetFRURecordTable)', '4(GetFRURecordByOption)']
30PLDM_OEM_CMDS = ['1(GetFileTable)', '4(ReadFile)', '5(WriteFile)', '6(ReadFileInToMemory)',
31                 '7(WriteFileFromMemory)', '8(ReadFileByTypeIntoMemory)',
32                 '9(WriteFileByTypeFromMemory)', '10(NewFileAvailable)',
33                 '11(ReadFileByType)', '12(WriteFileByType)', '13(FileAck)',
34                 '240(GetAlertStatus)']
35
36# PLDM command format.
37
38'''
39e.g. : GetPLDMVersion usage
40
41pldmtool base GetPLDMVersion -t <pldm_type>
42
43pldm supported types
44
45base->0,platform->2,bios->3,fru->4
46
47'''
48CMD_GETPLDMVERSION = 'base GetPLDMVersion -t %s'
49
50'''
51e.g. : PLDM raw command usage
52
53pldmtool raw -d 0x80 0x00 0x03 0x00 0x00 0x00 0x00 0x01 0x00
54
55pldm raw -d 0x<header> 0x<pldm_type> 0x<pldm_cmd_type> 0x<payload_data>
56'''
57
58CMD_PLDMTOOL_RAW = 'raw -d 0x80' + '0x%s' + ' ' + '0x%s'
59
60
61# PLDM command payload data.
62
63PAYLOAD_GetPLDMVersion = \
64    ' 0x00 0x00 0x00 0x00 0x%s 0x%s'    # %(TransferOperationFlag, PLDMType)
65
66
67'''
68e.g. : SetDateTime usage
69
70pldmtool bios SetDateTime -d <YYYYMMDDHHMMSS>
71
72'''
73CMD_SETDATETIME = 'bios SetDateTime -d %s'
74
75
76CMD_GETPDR = 'platform GetPDR -d %s'
77
78'''
79e.g. : SetStateEffecterStates usage
80
81pldmtool platform GetPDR -i <effter_handle> -c <count> -d <effecterID, effecterState>
82
83pldmtool platform SetStateEffecterStates -i 1 -c 1 -d 1 1
84'''
85
86CMD_SETSTATEEFFECTERSTATES = 'platform SetStateEffecterStates -i %s -c %s -d %s'
87
88# GetPDR parsed response message for record handle.
89# Dictionary value array holds the expected output for record handle 1, 2.
90#
91# Note :
92#      Record handle - 0 is default &  has same behaviour as record handle 1
93#      Only record handle 0, 1, 2 are supported as of now.
94
95RESPONSE_DICT_GETPDR_SETSTATEEFFECTER = {
96    'PDRHeaderVersion': [1],
97    'PDRType': ['State Effecter PDR'],
98    'recordChangeNumber': [0],
99    'PLDMTerminusHandle': [0, 1, 2],
100    'effecterID': [0, 1, 2, 3, 4],
101    'entityType': ['Virtual Machine Manager', 'System chassis (main enclosure)',
102                   'System Firmware', 'Processor Module', '32801(OEM)'],
103    'entityInstanceNumber': [0, 1, 2],
104    'containerID': [0, 1],
105    'effecterSemanticID': [0],
106    'effecterInit': ['noInit'],
107    'effecterDescriptionPDR': [False],
108    'compositeEffecterCount': [1]}
109
110RESPONSE_DICT_GETPDR_FRURECORDSETIDENTIFIER = {
111    'PDRHeaderVersion': [1],
112    'PDRType': ['FRU Record Set PDR'],
113    'recordChangeNumber': [0],
114    'dataLength': [10],
115    'PLDMTerminusHandle': [0, 2],
116    'entityType': ['System Board', 'Chassis front panel board (control panel)',
117                   'Management Controller', 'OEM', 'Power converter',
118                   'System (logical)', 'System chassis (main enclosure)',
119                   'Chassis front panel board (control panel)',
120                   'Processor Module', 'Memory Module', 'Power Supply',
121                   '24576(OEM)', '60(OEM)', 'Processor', '142(OEM)'],
122    'containerID': [0, 1, 2, 3]}
123
124RESPONSE_DICT_GETPDR_PDRENTITYASSOCIATION = {
125    'PDRHeaderVersion': [1],
126    'PDRType': ['Entity Association PDR'],
127    'recordChangeNumber': [0],
128    'containerID': [1, 2, 3],
129    'associationtype': ['Physical'],
130    'containerentityType': ['System Board', 'System (logical)',
131                            'System chassis (main enclosure)']}
132
133RESPONSE_DICT_GETPDR_STATESENSORPDR = {
134    'entityType': ['Communication Channel', 'Connector', 'Processor Module',
135                   '32774(OEM)', '57346(OEM)', '57347(OEM)', '32801(OEM)'],
136    'sensorInit': ['noInit'],
137    'sensorAuxiliaryNamesPDR': [False]}
138
139RESPONSE_DICT_GETPDR_TERMINUSLOCATORPDR = {
140    'PDRHeaderVersion': [1],
141    'PDRType': ['Terminus Locator PDR'],
142    'recordChangeNumber': [0],
143    'PLDMTerminusHandle': [1],
144    'validity': ['valid'],
145    'TID': [1, 208],
146    'containerID': [0, 1],
147    'terminusLocatorType': ['MCTP_EID'],
148    'terminusLocatorValueSize': [1]}
149
150RESPONSE_DICT_GETPDR_NUMERICEFFECTERPDR = {
151    'PDRHeaderVersion': [1],
152    'PDRType': ['Numeric Effecter PDR'],
153    'recordChangeNumber': [0],
154    'PLDMTerminusHandle': [0, 1],
155    'entityInstanceNumber': [0, 1],
156    'containerID': [0],
157    'effecterSemanticID': [0],
158    'effecterInit': [0],
159    'effecterAuxiliaryNames': [False],
160    'baseUnit': [0, 72],
161    'unitModifier': [0],
162    'rateUnit': [0],
163    'baseOEMUnitHandle': [0],
164    'auxUnit': [0],
165    'auxUnitModifier': [0],
166    'auxrateUnit': [0],
167    'auxOEMUnitHandle': [0],
168    'resolution': [1, 0],
169    'offset': [0],
170    'accuracy': [0],
171    'plusTolerance': [0],
172    'minusTolerance': [0],
173    'stateTransitionInterval': [0],
174    'TransitionInterval': [0],
175    'minSettable': [0],
176    'rangeFieldSupport': [0],
177    'nominalValue': [0],
178    'normalMax': [0],
179    'normalMin': [0],
180    'ratedMax': [0],
181    'ratedMin': [0]}
182
183PLDM_PDR_TYPES = {
184    'PLDM_STATE_EFFECTER_PDR': 'State Effecter PDR',
185    'PLDM_PDR_FRU_RECORD_SET': 'FRU Record Set PDR',
186    'PLDM_PDR_ENTITY_ASSOCIATION': 'Entity Association PDR',
187    'PLDM_STATE_SENSOR_PDR': 'State Sensor PDR',
188    'PLDM_NUMERIC_EFFECTER_PDR': 'Numeric Effecter PDR',
189    'PLDM_TERMINUS_LOCATOR_PDR': 'Terminus Locator PDR',
190    'PLDM_COMPACT_NUMERIC_SENSOR_PDR': '21'}
191
192RESPONSE_LIST_GETBIOSTABLE_STRTABLE = [
193    'Allowed', 'Disabled', 'Enabled', 'IPv4DHCP', 'IPv4Static', 'Not Allowed',
194    'Perm', 'Temp', 'pvm_fw_boot_side', 'pvm_inband_code_update', 'pvm_os_boot_side',
195    'pvm_pcie_error_inject', 'pvm_surveillance', 'pvm_system_name', 'vmi_hostname',
196    'vmi_if_count', 'vmi_if0_ipv4_ipaddr', 'vmi_if0_ipv4_method',
197    'vmi_if0_ipv4_prefix_length', 'vmi_if1_ipv4_ipaddr', 'vmi_if1_ipv4_method',
198    'vmi_if1_ipv4_prefix_length']
199
200
201RESPONSE_LIST_GETBIOSTABLE_ATTRTABLE = [
202    'pvm_fw_boot_side', 'pvm_inband_code_update', 'pvm_os_boot_side',
203    'pvm_pcie_error_inject', 'pvm_surveillance', 'pvm_system_name', 'vmi_hostname',
204    'vmi_if_count', 'vmi_if0_ipv4_ipaddr', 'vmi_if0_ipv4_method',
205    'vmi_if0_ipv4_prefix_length', 'vmi_if1_ipv4_ipaddr', 'vmi_if1_ipv4_method',
206    'vmi_if1_ipv4_prefix_length']
207
208RESPONSE_LIST_GETBIOSTABLE_ATTRVALTABLE = [
209    'BIOSString', 'BIOSInteger', 'BIOSEnumeration']
210