| description: > |
| Implement to fetch the PDRs. PDRs are Platform Descriptor |
| Records which are the collection of information that includes semantic |
| and association information. |
| |
| This API would be used by PLDM Requester apps on the BMC. |
| |
| An implementation of this interface should maintain the primary PDR |
| repository on the BMC. |
| |
| A OpenBMC implementation should implement the xyz.openbmc_project.PLDM.PDR |
| interface on the path /xyz/openbmc_project/pldm. |
| |
| More information about PDR can be found at DSP0248 version 1.2.0 section 25. |
| |
| methods: |
| - name: FindStateEffecterPDR |
| description: > |
| Obtain the state effecter PDR, for the input TID, entity ID and state |
| set id. If multiple PLDM entity instances(in state effecter PDRs) |
| match the EntityId and StateSetId below,all the corresponding state |
| effecter PDRs are returned. More than one PDR can be returned for the |
| same state set id. |
| |
| When the PDR for the given input TID, entity id and state set id is |
| not found, then the xyz.openbmc_project.Common.Error.ResourceNotFound |
| exception will be thrown. |
| |
| parameters: |
| - name: TID |
| type: byte |
| description: > |
| A terminus id. |
| |
| - name: EntityID |
| type: uint16 |
| description: > |
| A numeric value that represents an entity that can be associated to |
| a PLDM state set. |
| |
| More information is found at |
| http://dmtf.org/sites/default/files/standards/documents/DSP0249_1.0.0.pdf |
| section 7. |
| |
| - name: StateSetId |
| type: uint16 |
| description: > |
| A numeric value that identifies the PLDM State Set that is used with |
| this sensor. |
| |
| More information is found at |
| http://dmtf.org/sites/default/files/standards/documents/DSP0249_1.0.0.pdf |
| section 6. |
| |
| returns: |
| - name: StateEffecterPDR |
| type: array[array[byte]] |
| description: > |
| Array of State Effecter PDRs, where a PDR is an array[byte]. |
| Multiple PDRs of the format present in table 89 of DSP0248 version |
| 1.2.0 are returned. Each of the PDRs returned has the common header |
| along with all the other fields in table 89 and 90 of |
| DSP0248 of version 1.2.0 . |
| |
| errors: |
| - xyz.openbmc_project.Common.Error.ResourceNotFound |
| |
| - name: FindStateSensorPDR |
| description: > |
| Obtain the state sensor PDR, for the input TID, |
| entity ID and state set id. If multiple PLDM entity instances |
| (in state sensor PDRs) match the EntityId and StateSetId below, |
| all the corresponding state sensor PDRs are returned. More than one PDR |
| can be returned for the same state set id. |
| |
| When the PDR for the given input TID, entity id |
| and state set id is not found, then the |
| xyz.openbmc_project.Common.Error.ResourceNotFound exception will be thrown. |
| |
| parameters: |
| - name: TID |
| type: byte |
| description: > |
| A terminus id. |
| |
| - name: EntityID |
| type: uint16 |
| description: > |
| A numeric value that represents an entity that can be associated to a PLDM state set. |
| More information is found at |
| http://dmtf.org/sites/default/files/standards/documents/DSP0249_1.0.0.pdf section 7. |
| |
| - name: StateSetId |
| type: uint16 |
| description: > |
| A numeric value that identifies the PLDM State Set that is used with this sensor. |
| More information is found at |
| http://dmtf.org/sites/default/files/standards/documents/DSP0249_1.0.0.pdf section 6. |
| |
| returns: |
| - name: StateSensorPDR |
| type: array[array[byte]] |
| description: > |
| Array of State Sensor PDRs, where a PDR is an array[byte]. Multiple PDRs of the |
| format present in table 80 of DSP0248 version 1.2.0 are returned. Each of the PDRs |
| returned has the common header along with all the other fields in table 80 and 81 of |
| DSP0248 of version 1.2.0 . |
| |
| errors: |
| - xyz.openbmc_project.Common.Error.ResourceNotFound |