* [PATCH v3 0/7] Expose SCMI Transport properties
@ 2024-10-28 12:01 Cristian Marussi
2024-10-28 12:01 ` [PATCH v3 1/7] firmware: arm_scmi: Account for SHMEM memory overhead Cristian Marussi
` (7 more replies)
0 siblings, 8 replies; 11+ messages in thread
From: Cristian Marussi @ 2024-10-28 12:01 UTC (permalink / raw)
To: linux-kernel, linux-arm-kernel, arm-scmi
Cc: sudeep.holla, james.quinlan, f.fainelli, vincent.guittot,
etienne.carriere, peng.fan, michal.simek, quic_sibis, quic_nkela,
dan.carpenter, Cristian Marussi
Hi,
SCMI transports are characterized by a number of properties: the values
assumed by some of them tightly depend on the choices taken at design
time and on the overall archiecture of the specific platform: things like
timeouts, maximum message size and number of in-flight messages are closely
tied to the architecture of the platform like number of SCMI agents on the
system, physical memory available to the SCMI server...so on and so forth.
Moreover, since the SCMI specification does not delve into the details
of specific transports, that are, indeed, outside the scope of the
specification itself, such characteristics are NOT even discoverable
at run-time on an SCMI platform.
Currently such properties are simple default values defined at build time,
but the increasing number and variety of platforms using SCMI with a wide
range of designs has increased the need to have a way to describe such
properties across all these platforms.
This series, at first removes a few ambiguities in how some of the current
built-in properties are interpreted, then lays out a way for the core to
propagate back to the transports any possible setting gathered at runtime
from devicetree and finally introduce a pair of new properties used to
describe such per-platform transport characteristics.
Based on v6.12-rc3.
V3 adds 2 additional patches to fix an already existing similar property
that was missing the vendor prefix.
Any feedback welcome.
Thanks,
Cristian
---
v2 --> v3
- unified SHMEM_PAYLOAD_SIZE definition
- fixed format-string
- added reviewed tags
- added missing vendor to existing max-rx-timeout-ms
v1 --> v2
- added arm, vendor prefix to new DT bindings props
- clarified arm,max-msg bindings meaning
- removed useless warning on advised minimum size on arm,max-msg-size
- fixed maintainers CC list
- removed CCed maintainers from commit log
- using new prefixed arm, props
Cristian Marussi (7):
firmware: arm_scmi: Account for SHMEM memory overhead
firmware: arm_scmi: Calculate virtio PDU max size dynamically
dt-bindings: firmware: arm,scmi: Introduce more transport properties
firmware: arm_scmi: Use max_msg and max_msg_size devicetree properties
firmware: arm_scmi: Relocate atomic_threshold to scmi_desc
dt-bindings: firmware: arm,scmi: Add missing vendor string
firmware: arm_scmi: Use vendor string in max-rx-timeout-ms
.../bindings/firmware/arm,scmi.yaml | 17 ++++++-
drivers/firmware/arm_scmi/common.h | 13 +++++-
drivers/firmware/arm_scmi/driver.c | 46 +++++++++++--------
drivers/firmware/arm_scmi/shmem.c | 7 +++
.../firmware/arm_scmi/transports/mailbox.c | 2 +-
drivers/firmware/arm_scmi/transports/optee.c | 8 ++--
drivers/firmware/arm_scmi/transports/smc.c | 2 +-
drivers/firmware/arm_scmi/transports/virtio.c | 15 +++---
8 files changed, 74 insertions(+), 36 deletions(-)
--
2.47.0
^ permalink raw reply [flat|nested] 11+ messages in thread
* [PATCH v3 1/7] firmware: arm_scmi: Account for SHMEM memory overhead
2024-10-28 12:01 [PATCH v3 0/7] Expose SCMI Transport properties Cristian Marussi
@ 2024-10-28 12:01 ` Cristian Marussi
2024-10-28 12:01 ` [PATCH v3 2/7] firmware: arm_scmi: Calculate virtio PDU max size dynamically Cristian Marussi
` (6 subsequent siblings)
7 siblings, 0 replies; 11+ messages in thread
From: Cristian Marussi @ 2024-10-28 12:01 UTC (permalink / raw)
To: linux-kernel, linux-arm-kernel, arm-scmi
Cc: sudeep.holla, james.quinlan, f.fainelli, vincent.guittot,
etienne.carriere, peng.fan, michal.simek, quic_sibis, quic_nkela,
dan.carpenter, Cristian Marussi
Transports using shared memory have to consider the overhead due to the
layout area when determining the area effectively available for messages.
Till now, such definitions were ambiguos across the SCMI stack and the
overhead layout area was not considered at all.
Add proper checks in the shmem layer to validate the provided max_msg_size
against the effectively available memory area, less the layout.
Signed-off-by: Cristian Marussi <cristian.marussi@arm.com>
---
v2 --> v3
- using a single SCMI_SHMEM_PAYLOAD_SIZE common define
---
Note that as a consequence of this fix the default max_msg_size is reduced
to 104 bytes for shmem-based transports, in order to fit into the most
common implementations where the whole shmem area is sized at 128,
including the 24 bytes of standard layout area.
This should have NO bad side effects, since the current maximum payload
size of any messages across any protocol (including all the known vendor
ones) is 76 bytes.
---
drivers/firmware/arm_scmi/common.h | 6 +++++-
drivers/firmware/arm_scmi/driver.c | 1 +
drivers/firmware/arm_scmi/shmem.c | 7 +++++++
drivers/firmware/arm_scmi/transports/mailbox.c | 2 +-
drivers/firmware/arm_scmi/transports/optee.c | 8 +++-----
drivers/firmware/arm_scmi/transports/smc.c | 2 +-
6 files changed, 18 insertions(+), 8 deletions(-)
diff --git a/drivers/firmware/arm_scmi/common.h b/drivers/firmware/arm_scmi/common.h
index 6c2032d4f767..cb39b6bbcffd 100644
--- a/drivers/firmware/arm_scmi/common.h
+++ b/drivers/firmware/arm_scmi/common.h
@@ -31,6 +31,8 @@
#define SCMI_MAX_RESPONSE_TIMEOUT (2 * MSEC_PER_SEC)
+#define SCMI_SHMEM_MAX_PAYLOAD_SIZE 104
+
enum scmi_error_codes {
SCMI_SUCCESS = 0, /* Success */
SCMI_ERR_SUPPORT = -1, /* Not supported */
@@ -165,6 +167,7 @@ void scmi_protocol_release(const struct scmi_handle *handle, u8 protocol_id);
* channel
* @is_p2a: A flag to identify a channel as P2A (RX)
* @rx_timeout_ms: The configured RX timeout in milliseconds.
+ * @max_msg_size: Maximum size of message payload.
* @handle: Pointer to SCMI entity handle
* @no_completion_irq: Flag to indicate that this channel has no completion
* interrupt mechanism for synchronous commands.
@@ -177,6 +180,7 @@ struct scmi_chan_info {
struct device *dev;
bool is_p2a;
unsigned int rx_timeout_ms;
+ unsigned int max_msg_size;
struct scmi_handle *handle;
bool no_completion_irq;
void *transport_info;
@@ -224,7 +228,7 @@ struct scmi_transport_ops {
* @max_msg: Maximum number of messages for a channel type (tx or rx) that can
* be pending simultaneously in the system. May be overridden by the
* get_max_msg op.
- * @max_msg_size: Maximum size of data per message that can be handled.
+ * @max_msg_size: Maximum size of data payload per message that can be handled.
* @force_polling: Flag to force this whole transport to use SCMI core polling
* mechanism instead of completion interrupts even if available.
* @sync_cmds_completed_on_ret: Flag to indicate that the transport assures
diff --git a/drivers/firmware/arm_scmi/driver.c b/drivers/firmware/arm_scmi/driver.c
index dccd066e3ba8..015a4d52ae37 100644
--- a/drivers/firmware/arm_scmi/driver.c
+++ b/drivers/firmware/arm_scmi/driver.c
@@ -2645,6 +2645,7 @@ static int scmi_chan_setup(struct scmi_info *info, struct device_node *of_node,
cinfo->is_p2a = !tx;
cinfo->rx_timeout_ms = info->desc->max_rx_timeout_ms;
+ cinfo->max_msg_size = info->desc->max_msg_size;
/* Create a unique name for this transport device */
snprintf(name, 32, "__scmi_transport_device_%s_%02X",
diff --git a/drivers/firmware/arm_scmi/shmem.c b/drivers/firmware/arm_scmi/shmem.c
index e9f30ab671a8..11c347bff766 100644
--- a/drivers/firmware/arm_scmi/shmem.c
+++ b/drivers/firmware/arm_scmi/shmem.c
@@ -16,6 +16,8 @@
#include "common.h"
+#define SCMI_SHMEM_LAYOUT_OVERHEAD 24
+
/*
* SCMI specification requires all parameters, message headers, return
* arguments or any protocol data to be expressed in little endian
@@ -221,6 +223,11 @@ static void __iomem *shmem_setup_iomap(struct scmi_chan_info *cinfo,
}
size = resource_size(res);
+ if (cinfo->max_msg_size + SCMI_SHMEM_LAYOUT_OVERHEAD > size) {
+ dev_err(dev, "misconfigured SCMI shared memory\n");
+ return IOMEM_ERR_PTR(-ENOSPC);
+ }
+
addr = devm_ioremap(dev, res->start, size);
if (!addr) {
dev_err(dev, "failed to ioremap SCMI %s shared memory\n", desc);
diff --git a/drivers/firmware/arm_scmi/transports/mailbox.c b/drivers/firmware/arm_scmi/transports/mailbox.c
index e7efa3376aae..b66df2981456 100644
--- a/drivers/firmware/arm_scmi/transports/mailbox.c
+++ b/drivers/firmware/arm_scmi/transports/mailbox.c
@@ -371,7 +371,7 @@ static struct scmi_desc scmi_mailbox_desc = {
.ops = &scmi_mailbox_ops,
.max_rx_timeout_ms = 30, /* We may increase this if required */
.max_msg = 20, /* Limited by MBOX_TX_QUEUE_LEN */
- .max_msg_size = 128,
+ .max_msg_size = SCMI_SHMEM_MAX_PAYLOAD_SIZE,
};
static const struct of_device_id scmi_of_match[] = {
diff --git a/drivers/firmware/arm_scmi/transports/optee.c b/drivers/firmware/arm_scmi/transports/optee.c
index 663272879edf..3949a877e17d 100644
--- a/drivers/firmware/arm_scmi/transports/optee.c
+++ b/drivers/firmware/arm_scmi/transports/optee.c
@@ -17,8 +17,6 @@
#include "../common.h"
-#define SCMI_OPTEE_MAX_MSG_SIZE 128
-
enum scmi_optee_pta_cmd {
/*
* PTA_SCMI_CMD_CAPABILITIES - Get channel capabilities
@@ -299,7 +297,7 @@ static int invoke_process_msg_channel(struct scmi_optee_channel *channel, size_t
param[2].attr = TEE_IOCTL_PARAM_ATTR_TYPE_MEMREF_OUTPUT;
param[2].u.memref.shm = channel->tee_shm;
- param[2].u.memref.size = SCMI_OPTEE_MAX_MSG_SIZE;
+ param[2].u.memref.size = SCMI_SHMEM_MAX_PAYLOAD_SIZE;
ret = tee_client_invoke_func(scmi_optee_private->tee_ctx, &arg, param);
if (ret < 0 || arg.ret) {
@@ -332,7 +330,7 @@ static void scmi_optee_clear_channel(struct scmi_chan_info *cinfo)
static int setup_dynamic_shmem(struct device *dev, struct scmi_optee_channel *channel)
{
- const size_t msg_size = SCMI_OPTEE_MAX_MSG_SIZE;
+ const size_t msg_size = SCMI_SHMEM_MAX_PAYLOAD_SIZE;
void *shbuf;
channel->tee_shm = tee_shm_alloc_kernel_buf(scmi_optee_private->tee_ctx, msg_size);
@@ -519,7 +517,7 @@ static struct scmi_desc scmi_optee_desc = {
.ops = &scmi_optee_ops,
.max_rx_timeout_ms = 30,
.max_msg = 20,
- .max_msg_size = SCMI_OPTEE_MAX_MSG_SIZE,
+ .max_msg_size = SCMI_SHMEM_MAX_PAYLOAD_SIZE,
.sync_cmds_completed_on_ret = true,
};
diff --git a/drivers/firmware/arm_scmi/transports/smc.c b/drivers/firmware/arm_scmi/transports/smc.c
index 2f0e981e7599..f632a62cfb3e 100644
--- a/drivers/firmware/arm_scmi/transports/smc.c
+++ b/drivers/firmware/arm_scmi/transports/smc.c
@@ -282,7 +282,7 @@ static struct scmi_desc scmi_smc_desc = {
.ops = &scmi_smc_ops,
.max_rx_timeout_ms = 30,
.max_msg = 20,
- .max_msg_size = 128,
+ .max_msg_size = SCMI_SHMEM_MAX_PAYLOAD_SIZE,
/*
* Setting .sync_cmds_atomic_replies to true for SMC assumes that,
* once the SMC instruction has completed successfully, the issued
--
2.47.0
^ permalink raw reply related [flat|nested] 11+ messages in thread
* [PATCH v3 2/7] firmware: arm_scmi: Calculate virtio PDU max size dynamically
2024-10-28 12:01 [PATCH v3 0/7] Expose SCMI Transport properties Cristian Marussi
2024-10-28 12:01 ` [PATCH v3 1/7] firmware: arm_scmi: Account for SHMEM memory overhead Cristian Marussi
@ 2024-10-28 12:01 ` Cristian Marussi
2024-10-28 12:01 ` [PATCH v3 3/7] dt-bindings: firmware: arm,scmi: Introduce more transport properties Cristian Marussi
` (5 subsequent siblings)
7 siblings, 0 replies; 11+ messages in thread
From: Cristian Marussi @ 2024-10-28 12:01 UTC (permalink / raw)
To: linux-kernel, linux-arm-kernel, arm-scmi
Cc: sudeep.holla, james.quinlan, f.fainelli, vincent.guittot,
etienne.carriere, peng.fan, michal.simek, quic_sibis, quic_nkela,
dan.carpenter, Cristian Marussi, Florian Fainelli
SCMI virtio transport maximum PDU size is currently hardcoded at build
time; this will not play well with the possibile retrieval of a different
size at run-time.
Make the virtio transport derive the maximum PDU size from the max_msg_size
provided by the SCMI core.
No functional change.
Reviewed-by: Florian Fainelli <florian.fainelli@broadcom.com>
Signed-off-by: Cristian Marussi <cristian.marussi@arm.com>
---
drivers/firmware/arm_scmi/transports/virtio.c | 15 ++++++++-------
1 file changed, 8 insertions(+), 7 deletions(-)
diff --git a/drivers/firmware/arm_scmi/transports/virtio.c b/drivers/firmware/arm_scmi/transports/virtio.c
index d349766bc0b2..41aea33776a9 100644
--- a/drivers/firmware/arm_scmi/transports/virtio.c
+++ b/drivers/firmware/arm_scmi/transports/virtio.c
@@ -32,8 +32,8 @@
#define VIRTIO_MAX_RX_TIMEOUT_MS 60000
#define VIRTIO_SCMI_MAX_MSG_SIZE 128 /* Value may be increased. */
-#define VIRTIO_SCMI_MAX_PDU_SIZE \
- (VIRTIO_SCMI_MAX_MSG_SIZE + SCMI_MSG_MAX_PROT_OVERHEAD)
+#define VIRTIO_SCMI_MAX_PDU_SIZE(ci) \
+ ((ci)->max_msg_size + SCMI_MSG_MAX_PROT_OVERHEAD)
#define DESCRIPTORS_PER_TX_MSG 2
/**
@@ -90,6 +90,7 @@ enum poll_states {
* @input: SDU used for (delayed) responses and notifications
* @list: List which scmi_vio_msg may be part of
* @rx_len: Input SDU size in bytes, once input has been received
+ * @max_len: Maximumm allowed SDU size in bytes
* @poll_idx: Last used index registered for polling purposes if this message
* transaction reply was configured for polling.
* @poll_status: Polling state for this message.
@@ -102,6 +103,7 @@ struct scmi_vio_msg {
struct scmi_msg_payld *input;
struct list_head list;
unsigned int rx_len;
+ unsigned int max_len;
unsigned int poll_idx;
enum poll_states poll_status;
/* Lock to protect access to poll_status */
@@ -234,7 +236,7 @@ static int scmi_vio_feed_vq_rx(struct scmi_vio_channel *vioch,
unsigned long flags;
struct device *dev = &vioch->vqueue->vdev->dev;
- sg_init_one(&sg_in, msg->input, VIRTIO_SCMI_MAX_PDU_SIZE);
+ sg_init_one(&sg_in, msg->input, msg->max_len);
spin_lock_irqsave(&vioch->lock, flags);
@@ -439,9 +441,9 @@ static int virtio_chan_setup(struct scmi_chan_info *cinfo, struct device *dev,
if (!msg)
return -ENOMEM;
+ msg->max_len = VIRTIO_SCMI_MAX_PDU_SIZE(cinfo);
if (tx) {
- msg->request = devm_kzalloc(dev,
- VIRTIO_SCMI_MAX_PDU_SIZE,
+ msg->request = devm_kzalloc(dev, msg->max_len,
GFP_KERNEL);
if (!msg->request)
return -ENOMEM;
@@ -449,8 +451,7 @@ static int virtio_chan_setup(struct scmi_chan_info *cinfo, struct device *dev,
refcount_set(&msg->users, 1);
}
- msg->input = devm_kzalloc(dev, VIRTIO_SCMI_MAX_PDU_SIZE,
- GFP_KERNEL);
+ msg->input = devm_kzalloc(dev, msg->max_len, GFP_KERNEL);
if (!msg->input)
return -ENOMEM;
--
2.47.0
^ permalink raw reply related [flat|nested] 11+ messages in thread
* [PATCH v3 3/7] dt-bindings: firmware: arm,scmi: Introduce more transport properties
2024-10-28 12:01 [PATCH v3 0/7] Expose SCMI Transport properties Cristian Marussi
2024-10-28 12:01 ` [PATCH v3 1/7] firmware: arm_scmi: Account for SHMEM memory overhead Cristian Marussi
2024-10-28 12:01 ` [PATCH v3 2/7] firmware: arm_scmi: Calculate virtio PDU max size dynamically Cristian Marussi
@ 2024-10-28 12:01 ` Cristian Marussi
2024-10-28 12:01 ` [PATCH v3 4/7] firmware: arm_scmi: Use max_msg and max_msg_size devicetree properties Cristian Marussi
` (4 subsequent siblings)
7 siblings, 0 replies; 11+ messages in thread
From: Cristian Marussi @ 2024-10-28 12:01 UTC (permalink / raw)
To: linux-kernel, linux-arm-kernel, arm-scmi
Cc: sudeep.holla, james.quinlan, f.fainelli, vincent.guittot,
etienne.carriere, peng.fan, michal.simek, quic_sibis, quic_nkela,
dan.carpenter, Cristian Marussi, Rob Herring (Arm), devicetree
Depending on specific hardware and firmware design choices, it may be
possible for different platforms to end up having different requirements
regarding the same transport characteristics.
Introduce max-msg-size and max-msg properties to describe such platform
specific transport constraints, since they cannot be discovered otherwise.
Reviewed-by: Rob Herring (Arm) <robh@kernel.org>
Signed-off-by: Cristian Marussi <cristian.marussi@arm.com>
---
Cc: devicetree@vger.kernel.org
---
v1 --> v2
- added vendor prefix
- dropped warnings about resonable minimum max-msg-size
- clarified the intended usage of max-msg
- fixed Cc to include all maintainers and using correct e-mails
---
.../devicetree/bindings/firmware/arm,scmi.yaml | 15 +++++++++++++++
1 file changed, 15 insertions(+)
diff --git a/Documentation/devicetree/bindings/firmware/arm,scmi.yaml b/Documentation/devicetree/bindings/firmware/arm,scmi.yaml
index 54d7d11bfed4..9d6e1147f9e9 100644
--- a/Documentation/devicetree/bindings/firmware/arm,scmi.yaml
+++ b/Documentation/devicetree/bindings/firmware/arm,scmi.yaml
@@ -131,6 +131,21 @@ properties:
be a non-zero value if set.
minimum: 1
+ arm,max-msg-size:
+ $ref: /schemas/types.yaml#/definitions/uint32
+ description:
+ An optional value, expressed in bytes, representing the maximum size
+ allowed for the payload of messages transmitted on this transport.
+
+ arm,max-msg:
+ $ref: /schemas/types.yaml#/definitions/uint32
+ description:
+ An optional value representing the maximum number of concurrent in-flight
+ messages allowed by this transport; this number represents the maximum
+ number of concurrently outstanding messages that the server can handle on
+ this platform. If set, the value should be non-zero.
+ minimum: 1
+
arm,smc-id:
$ref: /schemas/types.yaml#/definitions/uint32
description:
--
2.47.0
^ permalink raw reply related [flat|nested] 11+ messages in thread
* [PATCH v3 4/7] firmware: arm_scmi: Use max_msg and max_msg_size devicetree properties
2024-10-28 12:01 [PATCH v3 0/7] Expose SCMI Transport properties Cristian Marussi
` (2 preceding siblings ...)
2024-10-28 12:01 ` [PATCH v3 3/7] dt-bindings: firmware: arm,scmi: Introduce more transport properties Cristian Marussi
@ 2024-10-28 12:01 ` Cristian Marussi
2024-10-28 12:01 ` [PATCH v3 5/7] firmware: arm_scmi: Relocate atomic_threshold to scmi_desc Cristian Marussi
` (3 subsequent siblings)
7 siblings, 0 replies; 11+ messages in thread
From: Cristian Marussi @ 2024-10-28 12:01 UTC (permalink / raw)
To: linux-kernel, linux-arm-kernel, arm-scmi
Cc: sudeep.holla, james.quinlan, f.fainelli, vincent.guittot,
etienne.carriere, peng.fan, michal.simek, quic_sibis, quic_nkela,
dan.carpenter, Cristian Marussi
Override the default built-in max_msg and max_msg_size transport properties
when the corresponding properties were found to be described in the
devicetree.
Signed-off-by: Cristian Marussi <cristian.marussi@arm.com>
---
v1 --> v2
- using new prefixed arm, properties
---
drivers/firmware/arm_scmi/driver.c | 16 ++++++++++++++--
1 file changed, 14 insertions(+), 2 deletions(-)
diff --git a/drivers/firmware/arm_scmi/driver.c b/drivers/firmware/arm_scmi/driver.c
index 015a4d52ae37..b9a1d8c1034f 100644
--- a/drivers/firmware/arm_scmi/driver.c
+++ b/drivers/firmware/arm_scmi/driver.c
@@ -3056,8 +3056,20 @@ static const struct scmi_desc *scmi_transport_setup(struct device *dev)
if (ret && ret != -EINVAL)
dev_err(dev, "Malformed max-rx-timeout-ms DT property.\n");
- dev_info(dev, "SCMI max-rx-timeout: %dms\n",
- trans->desc->max_rx_timeout_ms);
+ ret = of_property_read_u32(dev->of_node, "arm,max-msg-size",
+ &trans->desc->max_msg_size);
+ if (ret && ret != -EINVAL)
+ dev_err(dev, "Malformed arm,max-msg-size DT property.\n");
+
+ ret = of_property_read_u32(dev->of_node, "arm,max-msg",
+ &trans->desc->max_msg);
+ if (ret && ret != -EINVAL)
+ dev_err(dev, "Malformed arm,max-msg DT property.\n");
+
+ dev_info(dev,
+ "SCMI max-rx-timeout: %dms / max-msg-size: %dbytes / max-msg: %d\n",
+ trans->desc->max_rx_timeout_ms, trans->desc->max_msg_size,
+ trans->desc->max_msg);
return trans->desc;
}
--
2.47.0
^ permalink raw reply related [flat|nested] 11+ messages in thread
* [PATCH v3 5/7] firmware: arm_scmi: Relocate atomic_threshold to scmi_desc
2024-10-28 12:01 [PATCH v3 0/7] Expose SCMI Transport properties Cristian Marussi
` (3 preceding siblings ...)
2024-10-28 12:01 ` [PATCH v3 4/7] firmware: arm_scmi: Use max_msg and max_msg_size devicetree properties Cristian Marussi
@ 2024-10-28 12:01 ` Cristian Marussi
2024-10-28 12:01 ` [PATCH v3 6/7] dt-bindings: firmware: arm,scmi: Add missing vendor string Cristian Marussi
` (2 subsequent siblings)
7 siblings, 0 replies; 11+ messages in thread
From: Cristian Marussi @ 2024-10-28 12:01 UTC (permalink / raw)
To: linux-kernel, linux-arm-kernel, arm-scmi
Cc: sudeep.holla, james.quinlan, f.fainelli, vincent.guittot,
etienne.carriere, peng.fan, michal.simek, quic_sibis, quic_nkela,
dan.carpenter, Cristian Marussi
Relocate the atomic_threshold field to scmi_desc and move the related code
to scmi_transport_setup.
No functional change.
Signed-off-by: Cristian Marussi <cristian.marussi@arm.com>
---
v2 --> v3
- fixed format string using %u instead of %d
---
drivers/firmware/arm_scmi/common.h | 7 +++++++
drivers/firmware/arm_scmi/driver.c | 25 +++++++++----------------
2 files changed, 16 insertions(+), 16 deletions(-)
diff --git a/drivers/firmware/arm_scmi/common.h b/drivers/firmware/arm_scmi/common.h
index cb39b6bbcffd..48b12f81141d 100644
--- a/drivers/firmware/arm_scmi/common.h
+++ b/drivers/firmware/arm_scmi/common.h
@@ -229,6 +229,12 @@ struct scmi_transport_ops {
* be pending simultaneously in the system. May be overridden by the
* get_max_msg op.
* @max_msg_size: Maximum size of data payload per message that can be handled.
+ * @atomic_threshold: Optional system wide DT-configured threshold, expressed
+ * in microseconds, for atomic operations.
+ * Only SCMI synchronous commands reported by the platform
+ * to have an execution latency lesser-equal to the threshold
+ * should be considered for atomic mode operation: such
+ * decision is finally left up to the SCMI drivers.
* @force_polling: Flag to force this whole transport to use SCMI core polling
* mechanism instead of completion interrupts even if available.
* @sync_cmds_completed_on_ret: Flag to indicate that the transport assures
@@ -247,6 +253,7 @@ struct scmi_desc {
int max_rx_timeout_ms;
int max_msg;
int max_msg_size;
+ unsigned int atomic_threshold;
const bool force_polling;
const bool sync_cmds_completed_on_ret;
const bool atomic_enabled;
diff --git a/drivers/firmware/arm_scmi/driver.c b/drivers/firmware/arm_scmi/driver.c
index b9a1d8c1034f..9bc1bb7caa55 100644
--- a/drivers/firmware/arm_scmi/driver.c
+++ b/drivers/firmware/arm_scmi/driver.c
@@ -149,12 +149,6 @@ struct scmi_debug_info {
* base protocol
* @active_protocols: IDR storing device_nodes for protocols actually defined
* in the DT and confirmed as implemented by fw.
- * @atomic_threshold: Optional system wide DT-configured threshold, expressed
- * in microseconds, for atomic operations.
- * Only SCMI synchronous commands reported by the platform
- * to have an execution latency lesser-equal to the threshold
- * should be considered for atomic mode operation: such
- * decision is finally left up to the SCMI drivers.
* @notify_priv: Pointer to private data structure specific to notifications.
* @node: List head
* @users: Number of users of this instance
@@ -180,7 +174,6 @@ struct scmi_info {
struct mutex protocols_mtx;
u8 *protocols_imp;
struct idr active_protocols;
- unsigned int atomic_threshold;
void *notify_priv;
struct list_head node;
int users;
@@ -2445,7 +2438,7 @@ static bool scmi_is_transport_atomic(const struct scmi_handle *handle,
ret = info->desc->atomic_enabled &&
is_transport_polling_capable(info->desc);
if (ret && atomic_threshold)
- *atomic_threshold = info->atomic_threshold;
+ *atomic_threshold = info->desc->atomic_threshold;
return ret;
}
@@ -2959,7 +2952,7 @@ static struct scmi_debug_info *scmi_debugfs_common_setup(struct scmi_info *info)
(char **)&dbg->name);
debugfs_create_u32("atomic_threshold_us", 0400, top_dentry,
- &info->atomic_threshold);
+ (u32 *)&info->desc->atomic_threshold);
debugfs_create_str("type", 0400, trans, (char **)&dbg->type);
@@ -3071,6 +3064,13 @@ static const struct scmi_desc *scmi_transport_setup(struct device *dev)
trans->desc->max_rx_timeout_ms, trans->desc->max_msg_size,
trans->desc->max_msg);
+ /* System wide atomic threshold for atomic ops .. if any */
+ if (!of_property_read_u32(dev->of_node, "atomic-threshold-us",
+ &trans->desc->atomic_threshold))
+ dev_info(dev,
+ "SCMI System wide atomic threshold set to %u us\n",
+ trans->desc->atomic_threshold);
+
return trans->desc;
}
@@ -3120,13 +3120,6 @@ static int scmi_probe(struct platform_device *pdev)
handle->devm_protocol_acquire = scmi_devm_protocol_acquire;
handle->devm_protocol_get = scmi_devm_protocol_get;
handle->devm_protocol_put = scmi_devm_protocol_put;
-
- /* System wide atomic threshold for atomic ops .. if any */
- if (!of_property_read_u32(np, "atomic-threshold-us",
- &info->atomic_threshold))
- dev_info(dev,
- "SCMI System wide atomic threshold set to %d us\n",
- info->atomic_threshold);
handle->is_transport_atomic = scmi_is_transport_atomic;
/* Setup all channels described in the DT at first */
--
2.47.0
^ permalink raw reply related [flat|nested] 11+ messages in thread
* [PATCH v3 6/7] dt-bindings: firmware: arm,scmi: Add missing vendor string
2024-10-28 12:01 [PATCH v3 0/7] Expose SCMI Transport properties Cristian Marussi
` (4 preceding siblings ...)
2024-10-28 12:01 ` [PATCH v3 5/7] firmware: arm_scmi: Relocate atomic_threshold to scmi_desc Cristian Marussi
@ 2024-10-28 12:01 ` Cristian Marussi
2024-10-28 12:22 ` Sudeep Holla
2024-10-28 12:01 ` [PATCH v3 7/7] firmware: arm_scmi: Use vendor string in max-rx-timeout-ms Cristian Marussi
2024-11-06 7:26 ` [PATCH v3 0/7] Expose SCMI Transport properties Sudeep Holla
7 siblings, 1 reply; 11+ messages in thread
From: Cristian Marussi @ 2024-10-28 12:01 UTC (permalink / raw)
To: linux-kernel, linux-arm-kernel, arm-scmi
Cc: sudeep.holla, james.quinlan, f.fainelli, vincent.guittot,
etienne.carriere, peng.fan, michal.simek, quic_sibis, quic_nkela,
dan.carpenter, Cristian Marussi, Rob Herring, Krzysztof Kozlowski,
Conor Dooley, devicetree, Peng Fan
Recently introduced max-rx-timeout-ms optionao property is missing a
vendor prefix.
Add the vendor prefix from the original committer.
Fixes: 3a5e6ab06eab ("dt-bindings: firmware: arm,scmi: Introduce property max-rx-timeout-ms")
Signed-off-by: Cristian Marussi <cristian.marussi@arm.com>
---
Note that this fixes a commit that has been merged in v6.12-rc1...so it
should not present any backward compatibility issue.
---
Cc: Rob Herring <robh@kernel.org>
Cc: Krzysztof Kozlowski <krzk+dt@kernel.org>
Cc: Conor Dooley <conor+dt@kernel.org>
Cc: devicetree@vger.kernel.org
Cc: Peng Fan <peng.fan@nxp.com>
---
Documentation/devicetree/bindings/firmware/arm,scmi.yaml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/Documentation/devicetree/bindings/firmware/arm,scmi.yaml b/Documentation/devicetree/bindings/firmware/arm,scmi.yaml
index 9d6e1147f9e9..e331da4d606b 100644
--- a/Documentation/devicetree/bindings/firmware/arm,scmi.yaml
+++ b/Documentation/devicetree/bindings/firmware/arm,scmi.yaml
@@ -124,7 +124,7 @@ properties:
atomic mode of operation, even if requested.
default: 0
- max-rx-timeout-ms:
+ nxp,max-rx-timeout-ms:
description:
An optional time value, expressed in milliseconds, representing the
transport maximum timeout value for the receive channel. The value should
--
2.47.0
^ permalink raw reply related [flat|nested] 11+ messages in thread
* [PATCH v3 7/7] firmware: arm_scmi: Use vendor string in max-rx-timeout-ms
2024-10-28 12:01 [PATCH v3 0/7] Expose SCMI Transport properties Cristian Marussi
` (5 preceding siblings ...)
2024-10-28 12:01 ` [PATCH v3 6/7] dt-bindings: firmware: arm,scmi: Add missing vendor string Cristian Marussi
@ 2024-10-28 12:01 ` Cristian Marussi
2024-11-06 7:26 ` [PATCH v3 0/7] Expose SCMI Transport properties Sudeep Holla
7 siblings, 0 replies; 11+ messages in thread
From: Cristian Marussi @ 2024-10-28 12:01 UTC (permalink / raw)
To: linux-kernel, linux-arm-kernel, arm-scmi
Cc: sudeep.holla, james.quinlan, f.fainelli, vincent.guittot,
etienne.carriere, peng.fan, michal.simek, quic_sibis, quic_nkela,
dan.carpenter, Cristian Marussi, Peng Fan
The original optional property was missing a vendor string prefix; this
has been rectified.
Fix the naming of such optional property in code too.
Cc: Peng Fan <peng.fan@nxp.com>
Fixes: 1780e411ef94 ("firmware: arm_scmi: Use max-rx-timeout-ms from devicetree")
Signed-off-by: Cristian Marussi <cristian.marussi@arm.com>
---
drivers/firmware/arm_scmi/driver.c | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/drivers/firmware/arm_scmi/driver.c b/drivers/firmware/arm_scmi/driver.c
index 9bc1bb7caa55..eed73000c902 100644
--- a/drivers/firmware/arm_scmi/driver.c
+++ b/drivers/firmware/arm_scmi/driver.c
@@ -3044,10 +3044,10 @@ static const struct scmi_desc *scmi_transport_setup(struct device *dev)
dev_info(dev, "Using %s\n", dev_driver_string(trans->supplier));
- ret = of_property_read_u32(dev->of_node, "max-rx-timeout-ms",
+ ret = of_property_read_u32(dev->of_node, "nxp,max-rx-timeout-ms",
&trans->desc->max_rx_timeout_ms);
if (ret && ret != -EINVAL)
- dev_err(dev, "Malformed max-rx-timeout-ms DT property.\n");
+ dev_err(dev, "Malformed nxp,max-rx-timeout-ms DT property.\n");
ret = of_property_read_u32(dev->of_node, "arm,max-msg-size",
&trans->desc->max_msg_size);
--
2.47.0
^ permalink raw reply related [flat|nested] 11+ messages in thread
* Re: [PATCH v3 6/7] dt-bindings: firmware: arm,scmi: Add missing vendor string
2024-10-28 12:01 ` [PATCH v3 6/7] dt-bindings: firmware: arm,scmi: Add missing vendor string Cristian Marussi
@ 2024-10-28 12:22 ` Sudeep Holla
2024-10-28 13:17 ` Cristian Marussi
0 siblings, 1 reply; 11+ messages in thread
From: Sudeep Holla @ 2024-10-28 12:22 UTC (permalink / raw)
To: Cristian Marussi
Cc: linux-kernel, linux-arm-kernel, arm-scmi, james.quinlan,
f.fainelli, vincent.guittot, etienne.carriere, peng.fan,
michal.simek, quic_sibis, quic_nkela, dan.carpenter, Rob Herring,
Krzysztof Kozlowski, Conor Dooley, devicetree, Sudeep Holla,
Peng Fan
On Mon, Oct 28, 2024 at 12:01:50PM +0000, Cristian Marussi wrote:
> Recently introduced max-rx-timeout-ms optionao property is missing a
> vendor prefix.
>
> Add the vendor prefix from the original committer.
>
It should be "arm," not "nxp," just because NXP happens to introduce that.
It just highlight that the property is X vendor specific and here it is
associated with SCMI and specifically Arm SCMI, so "arm,". If for some
reason nxp or any other vendor overrides this definition and need to add
additional property then they can add their own vendor name into that
property.
If there are no objections, I can fix it up when applying.
> Fixes: 3a5e6ab06eab ("dt-bindings: firmware: arm,scmi: Introduce property max-rx-timeout-ms")
> Signed-off-by: Cristian Marussi <cristian.marussi@arm.com>
> ---
> Note that this fixes a commit that has been merged in v6.12-rc1...so it
> should not present any backward compatibility issue.
> ---
> Cc: Rob Herring <robh@kernel.org>
> Cc: Krzysztof Kozlowski <krzk+dt@kernel.org>
> Cc: Conor Dooley <conor+dt@kernel.org>
> Cc: devicetree@vger.kernel.org
> Cc: Peng Fan <peng.fan@nxp.com>
> ---
> Documentation/devicetree/bindings/firmware/arm,scmi.yaml | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/Documentation/devicetree/bindings/firmware/arm,scmi.yaml b/Documentation/devicetree/bindings/firmware/arm,scmi.yaml
> index 9d6e1147f9e9..e331da4d606b 100644
> --- a/Documentation/devicetree/bindings/firmware/arm,scmi.yaml
> +++ b/Documentation/devicetree/bindings/firmware/arm,scmi.yaml
> @@ -124,7 +124,7 @@ properties:
> atomic mode of operation, even if requested.
> default: 0
>
> - max-rx-timeout-ms:
> + nxp,max-rx-timeout-ms:
> description:
> An optional time value, expressed in milliseconds, representing the
> transport maximum timeout value for the receive channel. The value should
> --
> 2.47.0
>
--
Regards,
Sudeep
^ permalink raw reply [flat|nested] 11+ messages in thread
* Re: [PATCH v3 6/7] dt-bindings: firmware: arm,scmi: Add missing vendor string
2024-10-28 12:22 ` Sudeep Holla
@ 2024-10-28 13:17 ` Cristian Marussi
0 siblings, 0 replies; 11+ messages in thread
From: Cristian Marussi @ 2024-10-28 13:17 UTC (permalink / raw)
To: Sudeep Holla
Cc: Cristian Marussi, linux-kernel, linux-arm-kernel, arm-scmi,
james.quinlan, f.fainelli, vincent.guittot, etienne.carriere,
peng.fan, michal.simek, quic_sibis, quic_nkela, dan.carpenter,
Rob Herring, Krzysztof Kozlowski, Conor Dooley, devicetree,
Peng Fan
On Mon, Oct 28, 2024 at 12:22:54PM +0000, Sudeep Holla wrote:
> On Mon, Oct 28, 2024 at 12:01:50PM +0000, Cristian Marussi wrote:
> > Recently introduced max-rx-timeout-ms optionao property is missing a
> > vendor prefix.
> >
> > Add the vendor prefix from the original committer.
> >
>
> It should be "arm," not "nxp," just because NXP happens to introduce that.
> It just highlight that the property is X vendor specific and here it is
> associated with SCMI and specifically Arm SCMI, so "arm,". If for some
> reason nxp or any other vendor overrides this definition and need to add
> additional property then they can add their own vendor name into that
> property.
>
> If there are no objections, I can fix it up when applying.
My bad. Sure go for it.
Thanks,
Cristian
^ permalink raw reply [flat|nested] 11+ messages in thread
* Re: [PATCH v3 0/7] Expose SCMI Transport properties
2024-10-28 12:01 [PATCH v3 0/7] Expose SCMI Transport properties Cristian Marussi
` (6 preceding siblings ...)
2024-10-28 12:01 ` [PATCH v3 7/7] firmware: arm_scmi: Use vendor string in max-rx-timeout-ms Cristian Marussi
@ 2024-11-06 7:26 ` Sudeep Holla
7 siblings, 0 replies; 11+ messages in thread
From: Sudeep Holla @ 2024-11-06 7:26 UTC (permalink / raw)
To: linux-kernel, linux-arm-kernel, arm-scmi, Cristian Marussi
Cc: Sudeep Holla, james.quinlan, f.fainelli, vincent.guittot,
etienne.carriere, peng.fan, michal.simek, quic_sibis, quic_nkela,
dan.carpenter
On Mon, 28 Oct 2024 12:01:44 +0000, Cristian Marussi wrote:
> SCMI transports are characterized by a number of properties: the values
> assumed by some of them tightly depend on the choices taken at design
> time and on the overall archiecture of the specific platform: things like
> timeouts, maximum message size and number of in-flight messages are closely
> tied to the architecture of the platform like number of SCMI agents on the
> system, physical memory available to the SCMI server...so on and so forth.
>
> [...]
Applied to sudeep.holla/linux (for-next/scmi/updates), thanks!
[1/7] firmware: arm_scmi: Account for SHMEM memory overhead
https://git.kernel.org/sudeep.holla/c/5c14f38893d0
[2/7] firmware: arm_scmi: Calculate virtio PDU max size dynamically
https://git.kernel.org/sudeep.holla/c/3229e33311f8
[3/7] dt-bindings: firmware: arm,scmi: Introduce more transport properties
https://git.kernel.org/sudeep.holla/c/5654d37268bc
[4/7] firmware: arm_scmi: Use max_msg and max_msg_size devicetree properties
https://git.kernel.org/sudeep.holla/c/c091de2d383a
[5/7] firmware: arm_scmi: Relocate atomic_threshold to scmi_desc
https://git.kernel.org/sudeep.holla/c/112ffc78dc8f
(The below 2 were applied as fixes and sent for v6.12, sorry I missed
to send confirmation earlier)
[6/7] dt-bindings: firmware: arm,scmi: Add missing vendor string
https://git.kernel.org/sudeep.holla/c/7bf46ec090b9
[7/7] firmware: arm_scmi: Use vendor string in max-rx-timeout-ms
https://git.kernel.org/sudeep.holla/c/54962707f8b8
--
Regards,
Sudeep
^ permalink raw reply [flat|nested] 11+ messages in thread
end of thread, other threads:[~2024-11-06 7:28 UTC | newest]
Thread overview: 11+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2024-10-28 12:01 [PATCH v3 0/7] Expose SCMI Transport properties Cristian Marussi
2024-10-28 12:01 ` [PATCH v3 1/7] firmware: arm_scmi: Account for SHMEM memory overhead Cristian Marussi
2024-10-28 12:01 ` [PATCH v3 2/7] firmware: arm_scmi: Calculate virtio PDU max size dynamically Cristian Marussi
2024-10-28 12:01 ` [PATCH v3 3/7] dt-bindings: firmware: arm,scmi: Introduce more transport properties Cristian Marussi
2024-10-28 12:01 ` [PATCH v3 4/7] firmware: arm_scmi: Use max_msg and max_msg_size devicetree properties Cristian Marussi
2024-10-28 12:01 ` [PATCH v3 5/7] firmware: arm_scmi: Relocate atomic_threshold to scmi_desc Cristian Marussi
2024-10-28 12:01 ` [PATCH v3 6/7] dt-bindings: firmware: arm,scmi: Add missing vendor string Cristian Marussi
2024-10-28 12:22 ` Sudeep Holla
2024-10-28 13:17 ` Cristian Marussi
2024-10-28 12:01 ` [PATCH v3 7/7] firmware: arm_scmi: Use vendor string in max-rx-timeout-ms Cristian Marussi
2024-11-06 7:26 ` [PATCH v3 0/7] Expose SCMI Transport properties Sudeep Holla
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox