drivers: firmware: scmi: add cpu info get interface

Add scmi_cpu_info_get API to query CPU information via
NXP SCMI CPU domain protocol.

Retrieves run mode, sleep mode, and reset vector addresses
for the specified CPU ID using CPU_INFO_GET command.

Signed-off-by: Yongxu Wang <yongxu.wang@nxp.com>

Author: yongxu-wang15

drivers/firmware/scmi/nxp/cpu.c

@@ -10,6 +10,11 @@
 
 DT_SCMI_PROTOCOL_DEFINE_NODEV(DT_INST(0, nxp_scmi_cpu), NULL);
 
+struct scmi_cpu_info_get_reply {
+	int32_t status;
+	struct scmi_cpu_info data;
+};
+
 int scmi_cpu_sleep_mode_set(struct scmi_cpu_sleep_mode_config *cfg)
 {
 	struct scmi_protocol *proto = &SCMI_PROTOCOL_NAME(SCMI_PROTOCOL_CPU_DOMAIN);
@@ -146,3 +151,38 @@ int scmi_cpu_reset_vector(struct scmi_cpu_vector_config *cfg)
 
 	return scmi_status_to_errno(status);
 }
+
+int scmi_cpu_info_get(uint32_t cpu_id, struct scmi_cpu_info *cfg)
+{
+	struct scmi_protocol *proto = &SCMI_PROTOCOL_NAME(SCMI_PROTOCOL_CPU_DOMAIN);
+	struct scmi_message msg, reply;
+	struct scmi_cpu_info_get_reply reply_buffer;
+	int ret;
+
+	/* sanity checks */
+	if (!proto || !cfg) {
+		return -EINVAL;
+	}
+
+	if (proto->id != SCMI_PROTOCOL_CPU_DOMAIN) {
+		return -EINVAL;
+	}
+
+	msg.hdr = SCMI_MESSAGE_HDR_MAKE(SCMI_CPU_DOMAIN_MSG_CPU_INFO_GET, SCMI_COMMAND,
+					proto->id, 0x0);
+	msg.len = sizeof(uint32_t);
+	msg.content = &cpu_id;
+
+	reply.hdr = msg.hdr;
+	reply.len = sizeof(reply_buffer);
+	reply.content = &reply_buffer;
+
+	ret = scmi_send_message(proto, &msg, &reply, true);
+	if (ret < 0) {
+		return ret;
+	}
+
+	*cfg = reply_buffer.data;
+
+	return scmi_status_to_errno(reply_buffer.status);
+}

include/zephyr/drivers/firmware/scmi/nxp/cpu.h

@@ -87,6 +87,18 @@ struct scmi_cpu_vector_config {
 	uint32_t vector_high;
 };
 
+/**
+ * @struct scmi_cpu_info
+ *
+ * @brief Describes the parameters for the CPU_INFO_GET command
+ */
+struct scmi_cpu_info {
+	uint32_t run_mode;
+	uint32_t sleep_mode;
+	uint32_t vector_low;
+	uint32_t vector_high;
+};
+
 /**
  * @brief CPU domain protocol command message IDs
  */
@@ -148,4 +160,15 @@ int scmi_cpu_set_irq_mask(struct scmi_cpu_irq_mask_config *cfg);
  * @retval negative errno if failure
  */
 int scmi_cpu_reset_vector(struct scmi_cpu_vector_config *cfg);
+
+/**
+ * @brief Send the CPU_INFO_GET command and get its reply
+ *
+ * @param cpu_id CPU ID to query (input)
+ * @param cfg pointer to structure to receive CPU information (output)
+ *
+ * @retval 0 if successful
+ * @retval negative errno if failure
+ */
+int scmi_cpu_info_get(uint32_t cpu_id, struct scmi_cpu_info *cfg);
 #endif /* _INCLUDE_ZEPHYR_DRIVERS_FIRMWARE_SCMI_CPU_H_ */