mirror of
https://github.com/torvalds/linux.git
synced 2026-05-12 16:18:45 +02:00
773a43b862
The second Late Binding version allows to send payload bigger than client MTU by splitting it to chunks and uses separate firmware client for transfer. The component interface is unchanged and driver doing all splitting. Only one Late Binding version is supported by firmware. When Late binding version 2 is supported, the new client is advertised by firmware and existing MKHI will have version 2. This helps driver to select the right mode of work. Reviewed-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com> Reviewed-by: Badal Nilawar <badal.nilawar@intel.com> Signed-off-by: Alexander Usyskin <alexander.usyskin@intel.com> Link: https://patch.msgid.link/20260405112326.1535208-3-alexander.usyskin@intel.com Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
105 lines
4.5 KiB
C
105 lines
4.5 KiB
C
/* SPDX-License-Identifier: MIT */
|
|
/*
|
|
* Copyright (c) 2025 Intel Corporation
|
|
*/
|
|
|
|
#ifndef _INTEL_LB_MEI_INTERFACE_H_
|
|
#define _INTEL_LB_MEI_INTERFACE_H_
|
|
|
|
#include <linux/bits.h>
|
|
#include <linux/types.h>
|
|
|
|
struct device;
|
|
|
|
/**
|
|
* define INTEL_LB_FLAG_IS_PERSISTENT - Mark the payload as persistent
|
|
*
|
|
* This flag indicates that the late binding payload should be stored
|
|
* persistently in flash across warm resets.
|
|
*/
|
|
#define INTEL_LB_FLAG_IS_PERSISTENT BIT(0)
|
|
|
|
/**
|
|
* enum intel_lb_type - enum to determine late binding payload type
|
|
* @INTEL_LB_TYPE_FAN_CONTROL: Fan controller configuration
|
|
* @INTEL_LB_TYPE_OCODE: Ocode firmware
|
|
*/
|
|
enum intel_lb_type {
|
|
INTEL_LB_TYPE_FAN_CONTROL = 1,
|
|
INTEL_LB_TYPE_OCODE = 3,
|
|
};
|
|
|
|
/**
|
|
* enum intel_lb_status - Status codes returned on late binding transmissions
|
|
* @INTEL_LB_STATUS_SUCCESS: Operation completed successfully
|
|
* @INTEL_LB_STATUS_4ID_MISMATCH: Mismatch in the expected 4ID (firmware identity/token)
|
|
* @INTEL_LB_STATUS_ARB_FAILURE: Arbitration failure (e.g. conflicting access or state)
|
|
* @INTEL_LB_STATUS_GENERAL_ERROR: General firmware error not covered by other codes
|
|
* @INTEL_LB_STATUS_INVALID_PARAMS: One or more input parameters are invalid
|
|
* @INTEL_LB_STATUS_INVALID_SIGNATURE: Payload has an invalid or untrusted signature
|
|
* @INTEL_LB_STATUS_INVALID_PAYLOAD: Payload contents are not accepted by firmware
|
|
* @INTEL_LB_STATUS_TIMEOUT: Operation timed out before completion
|
|
* @INTEL_LB_STATUS_BUFFER_TOO_SMALL: Buffer provided is smaller when expected
|
|
* @INTEL_LB_STATUS_INTERNAL_ERROR: Internal firmware error
|
|
* @INTEL_LB_STATUS_INVALID_FPT_TABLE: Invalid firmware format table
|
|
* @INTEL_LB_STATUS_SIGNED_PAYLOAD_VERIFICATION_ERROR: Error in signature verification
|
|
* @INTEL_LB_STATUS_SIGNED_PAYLOAD_INVALID_CPD: Invalid CPD
|
|
* @INTEL_LB_STATUS_SIGNED_PAYLOAD_FW_VERSION_MISMATCH: Firmware version mismatch
|
|
* @INTEL_LB_STATUS_SIGNED_PAYLOAD_INVALID_MANIFEST: Invalid firmware manifest
|
|
* @INTEL_LB_STATUS_SIGNED_PAYLOAD_INVALID_HASH: Wrong hash in signature
|
|
* @INTEL_LB_STATUS_SIGNED_PAYLOAD_BINDING_TYPE_MISMATCH: Wrong firmware type provided
|
|
* @INTEL_LB_STATUS_SIGNED_PAYLOAD_HANDLE_SVN_FAILED: SVN check failed
|
|
* @INTEL_LB_STATUS_DESTINATION_MBOX_FAILURE: Failed to send datat to destination
|
|
* @INTEL_LB_STATUS_MISSING_LOADING_PATCH: No loading patch found
|
|
* @INTEL_LB_STATUS_INVALID_COMMAND: Invalid command number
|
|
* @INTEL_LB_STATUS_INVALID_HECI_HEADER: Invalid transport header
|
|
* @INTEL_LB_STATUS_IP_ERROR_START: Base for internal errors
|
|
*/
|
|
enum intel_lb_status {
|
|
INTEL_LB_STATUS_SUCCESS = 0,
|
|
INTEL_LB_STATUS_4ID_MISMATCH = 1,
|
|
INTEL_LB_STATUS_ARB_FAILURE = 2,
|
|
INTEL_LB_STATUS_GENERAL_ERROR = 3,
|
|
INTEL_LB_STATUS_INVALID_PARAMS = 4,
|
|
INTEL_LB_STATUS_INVALID_SIGNATURE = 5,
|
|
INTEL_LB_STATUS_INVALID_PAYLOAD = 6,
|
|
INTEL_LB_STATUS_TIMEOUT = 7,
|
|
INTEL_LB_STATUS_BUFFER_TOO_SMALL = 8,
|
|
INTEL_LB_STATUS_INTERNAL_ERROR = 9,
|
|
INTEL_LB_STATUS_INVALID_FPT_TABLE = 10,
|
|
INTEL_LB_STATUS_SIGNED_PAYLOAD_VERIFICATION_ERROR = 11,
|
|
INTEL_LB_STATUS_SIGNED_PAYLOAD_INVALID_CPD = 12,
|
|
INTEL_LB_STATUS_SIGNED_PAYLOAD_FW_VERSION_MISMATCH = 13,
|
|
INTEL_LB_STATUS_SIGNED_PAYLOAD_INVALID_MANIFEST = 14,
|
|
INTEL_LB_STATUS_SIGNED_PAYLOAD_INVALID_HASH = 15,
|
|
INTEL_LB_STATUS_SIGNED_PAYLOAD_BINDING_TYPE_MISMATCH = 16,
|
|
INTEL_LB_STATUS_SIGNED_PAYLOAD_HANDLE_SVN_FAILED = 17,
|
|
INTEL_LB_STATUS_DESTINATION_MBOX_FAILURE = 18,
|
|
INTEL_LB_STATUS_MISSING_LOADING_PATCH = 19,
|
|
INTEL_LB_STATUS_INVALID_COMMAND = 20,
|
|
INTEL_LB_STATUS_INVALID_HECI_HEADER = 21,
|
|
INTEL_LB_STATUS_IP_ERROR_START = BIT(31),
|
|
};
|
|
|
|
/**
|
|
* struct intel_lb_component_ops - Ops for late binding services
|
|
*/
|
|
struct intel_lb_component_ops {
|
|
/**
|
|
* @push_payload: Sends a payload to the authentication firmware
|
|
*
|
|
* @dev: Device struct corresponding to the mei device
|
|
* @type: Payload type (see &enum intel_lb_type)
|
|
* @flags: Payload flags bitmap (e.g. %INTEL_LB_FLAGS_IS_PERSISTENT)
|
|
* @payload: Pointer to payload buffer
|
|
* @payload_size: Payload buffer size in bytes
|
|
*
|
|
* Return: 0 success, negative errno value on transport failure,
|
|
* positive error status returned by firmware
|
|
*/
|
|
int (*push_payload)(struct device *dev, u32 type, u32 flags,
|
|
const void *payload, size_t payload_size);
|
|
};
|
|
|
|
#endif /* _INTEL_LB_MEI_INTERFACE_H_ */
|