| Vishwanatha Subbanna | 93ff4bb | 2017-07-10 15:28:50 +0530 | [diff] [blame] | 1 | description: > |
| 2 | Implement to provide host interface support. |
| 3 | This will define the interfaces using which, a OpenPower |
| 4 | machine can communicate with host on agreed commands. |
| 5 | |
| 6 | This is for Internal use by the Firmware only. The D-Bus object |
| 7 | is visible for the REST but it must not be used. |
| 8 | |
| 9 | methods: |
| 10 | - name: Execute |
| 11 | description: > |
| 12 | Execute the requested command by the caller. This command will be |
| 13 | processed in first in first out order. See the Command enum |
| 14 | description below for details on all supported commands. |
| 15 | parameters: |
| 16 | - name: command |
| 17 | type: enum[self.Command] |
| 18 | description: Requested command to execute against the host |
| Vishwanatha Subbanna | 77e153f | 2017-07-21 11:28:00 +0530 | [diff] [blame] | 19 | - name: data |
| 20 | type: variant[byte] |
| 21 | description: Data associated with the command. |
| Vishwanatha Subbanna | 93ff4bb | 2017-07-10 15:28:50 +0530 | [diff] [blame] | 22 | |
| 23 | signals: |
| 24 | - name: CommandComplete |
| 25 | description: > |
| Vishwanatha Subbanna | 77e153f | 2017-07-21 11:28:00 +0530 | [diff] [blame] | 26 | Signal indicating that a command has completed |
| Vishwanatha Subbanna | 93ff4bb | 2017-07-10 15:28:50 +0530 | [diff] [blame] | 27 | properties: |
| 28 | - name: command |
| 29 | type: enum[self.Command] |
| 30 | description: Executed command |
| 31 | - name: result |
| 32 | type: enum[self.Result] |
| 33 | description: Result of the command execution |
| 34 | |
| 35 | enumerations: |
| 36 | - name: Command |
| 37 | description: > |
| 38 | The command to execute against the host |
| 39 | values: |
| 40 | - name: OCCReset |
| 41 | description: > |
| 42 | Host firmware should reset the OCC. This is invoked by |
| 43 | OCC error monitor application on detecting the error. |
| Vishwanatha Subbanna | 77e153f | 2017-07-21 11:28:00 +0530 | [diff] [blame] | 44 | Sensor ID of the failing OCC will be sent as data. |
| Vishwanatha Subbanna | 93ff4bb | 2017-07-10 15:28:50 +0530 | [diff] [blame] | 45 | This command will return once the command has been placed |
| 46 | in command Queue. |
| 47 | |
| 48 | - name: Result |
| 49 | description: > |
| 50 | The result of the command execution |
| 51 | values: |
| 52 | - name: Success |
| 53 | description: Command execution was a success |
| 54 | - name: Failure |
| 55 | description: Command execution was a failure |