description: >
    Implement to provide pass-through mechanism to the On Chip Controller (OCC).
methods:
    - name: Send
      description: >
          Pass through a command to the OCC.
      parameters:
          - name: command
            # TODO via https://github.com/openbmc/openbmc/issues/1160. This should
            # change to array[byte]. As of now, the REST server maps any numeric
            # data to int32.
            type: array[int32]
            description: >
                An array of integers representing the command and payload. This
                should still be bytes worth of data (as though using array[byte]),
                so each entry in the array should pack as many bytes as possible.
      returns:
          - name: response
            # TODO via https://github.com/openbmc/openbmc/issues/1160. This should
            # change to array[byte]. As of now, the REST server maps any numeric
            # data to int32.
            type: array[int32]
            description: >
                An array of integers representing the response. This
                should still be bytes worth of data (as though using array[byte]),
                so each entry in the array should pack as many bytes as possible.

    - name: SetMode
      description: >
          Change the power mode of the system.
      parameters:
          - name: mode
            type: byte
            description: >
                Desired power mode of the system.
          - name: frequencyPoint
            type: uint16
            description: >
                Frequency point required by some power modes.
      returns:
          - name: status
            type: boolean
            description: >
                Returns true if the mode change was accepted.