8e96801aa6
Adds resources for SCMI protocols to possibly use a dedicated SCMI channel instead of the default channel allocated by the SCMI agent during initialization. As per DT binding documentation, some SCMI transports can define a specific SCMI communication channel for given SCMI protocols. It allows SCMI protocols to pass messages concurrently each other. This change introduces new scmi agent uclass API function devm_scmi_of_get_channel() for SCMI drivers probe sequences to get a reference to the SCMI channel assigned to its related SCMI protocol. The function queries the channel reference to its SCMI transport driver through new scmi agent uclass operator .of_get_channel that uses Device Tree information from related SCMI agent node. Operator .of_get_channel returns a reference to the SCMI channel assigned to SCMI protocol used by the caller device. SCMI transport drivers that do not support multi-channel are not mandated to register this operator. When so, API function devm_scmi_of_get_channel() returns NULL and SCMI transport driver are expected to retrieve by their own means the reference to the unique SCMI channel, for example using platform data as these drivers currently do in U-Boot source tree. Signed-off-by: Etienne Carriere <etienne.carriere@linaro.org>
81 lines
2.5 KiB
C
81 lines
2.5 KiB
C
/* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause */
|
|
/*
|
|
* Copyright (c) 2015-2019, Arm Limited and Contributors. All rights reserved.
|
|
* Copyright (C) 2019-2020, Linaro Limited
|
|
*
|
|
* An SCMI agent device represent on communication path from a
|
|
* device driver to the remote SCMI server which driver sends
|
|
* messages to and receives response messages from.
|
|
*/
|
|
#ifndef SCMI_AGENT_H
|
|
#define SCMI_AGENT_H
|
|
|
|
#include <asm/types.h>
|
|
|
|
struct udevice;
|
|
struct scmi_channel;
|
|
|
|
/*
|
|
* struct scmi_msg - Context of a SCMI message sent and the response received
|
|
*
|
|
* @protocol_id: SCMI protocol ID
|
|
* @message_id: SCMI message ID for a defined protocol ID
|
|
* @in_msg: Pointer to the message payload sent by the driver
|
|
* @in_msg_sz: Byte size of the message payload sent
|
|
* @out_msg: Pointer to buffer to store response message payload
|
|
* @out_msg_sz: Byte size of the response buffer and response payload
|
|
*/
|
|
struct scmi_msg {
|
|
unsigned int protocol_id;
|
|
unsigned int message_id;
|
|
u8 *in_msg;
|
|
size_t in_msg_sz;
|
|
u8 *out_msg;
|
|
size_t out_msg_sz;
|
|
};
|
|
|
|
/* Helper macro to match a message on input/output array references */
|
|
#define SCMI_MSG_IN(_protocol, _message, _in_array, _out_array) \
|
|
(struct scmi_msg){ \
|
|
.protocol_id = (_protocol), \
|
|
.message_id = (_message), \
|
|
.in_msg = (uint8_t *)&(_in_array), \
|
|
.in_msg_sz = sizeof(_in_array), \
|
|
.out_msg = (uint8_t *)&(_out_array), \
|
|
.out_msg_sz = sizeof(_out_array), \
|
|
}
|
|
|
|
/**
|
|
* devm_scmi_of_get_channel() - Get SCMI channel handle from SCMI agent DT node
|
|
*
|
|
* @dev: Device requesting a channel
|
|
* @channel: Output reference to the SCMI channel upon success
|
|
* @return 0 on success and a negative errno on failure
|
|
*/
|
|
int devm_scmi_of_get_channel(struct udevice *dev, struct scmi_channel **channel);
|
|
|
|
/**
|
|
* devm_scmi_process_msg() - Send and process an SCMI message
|
|
*
|
|
* Send a message to an SCMI server through a target SCMI agent device.
|
|
* Caller sets scmi_msg::out_msg_sz to the output message buffer size.
|
|
* On return, scmi_msg::out_msg_sz stores the response payload size.
|
|
*
|
|
* @dev: SCMI device
|
|
* @channel: Communication channel for the device
|
|
* @msg: Message structure reference
|
|
* Return: 0 on success and a negative errno on failure
|
|
*/
|
|
int devm_scmi_process_msg(struct udevice *dev, struct scmi_channel *channel,
|
|
struct scmi_msg *msg);
|
|
|
|
/**
|
|
* scmi_to_linux_errno() - Convert an SCMI error code into a Linux errno code
|
|
*
|
|
* @scmi_errno: SCMI error code value
|
|
* Return: 0 for successful status and a negative errno otherwise
|
|
*/
|
|
int scmi_to_linux_errno(s32 scmi_errno);
|
|
|
|
#endif /* SCMI_H */
|