| description: > |
| Simple definition of a Software or Firmware version. Note that this |
| interface may be implemented by D-Bus objects that do not necessarily |
| contain a software level. For example an OpenBMC log may implement this |
| interface to store the software level of the BMC or Host for debug purposes. |
| If looking for real software versions associated with a device then ensure |
| this interface is under the /xyz/openbmc_project/software object path. |
| properties: |
| - name: Version |
| type: string |
| description: > |
| The version identifier. |
| - name: Purpose |
| type: enum[self.VersionPurpose] |
| description: > |
| The purpose of the version. As in, what can it be used for or applied |
| to? |
| |
| This property is deprecated in favor of Compatible strings and |
| inventory associations. The enumeration should not be expanded |
| further. |
| enumerations: |
| - name: VersionPurpose |
| description: > |
| An enumeration of possible purposes of the version. |
| values: |
| - name: Unknown |
| description: > |
| The version is of unknown purpose. |
| - name: Other |
| description: > |
| The version is of some other purpose. |
| - name: System |
| description: > |
| The version is an aggregate for the system as a whole. |
| - name: BMC |
| description: > |
| The version is a version for the BMC. |
| - name: Host |
| description: > |
| The version is a version for a managed host. |
| - name: PSU |
| description: > |
| The version is a version for a PSU. |
| |
| associations: |
| - name: running |
| description: > |
| This indicates the current running version for the associated |
| inventory item. |
| reverse_names: |
| - ran_on |
| required_endpoint_interfaces: |
| - xyz.openbmc_project.Inventory.Item |
| - name: activating |
| description: > |
| This indicates the current activated version for the associated |
| inventory item. There can be more than one active version associated |
| with the same inventory item. In such a case, RedundancyPriority |
| interface will help to decide the correct priority order for the |
| active version transition to running. |
| reverse_names: |
| - activated_on |
| required_endpoint_interfaces: |
| - xyz.openbmc_project.Inventory.Item |