1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
|
/* SPDX-License-Identifier: MIT */
/*
* Copyright (c) 2025 Intel Corporation
*/
#ifndef _INTEL_LB_MEI_INTERFACE_H_
#define _INTEL_LB_MEI_INTERFACE_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
*/
enum intel_lb_type {
INTEL_LB_TYPE_FAN_CONTROL = 1,
};
/**
* 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
*/
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,
};
/**
* 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 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_ */
|
