3  * System Control and Management Interface (SCMI) Message Protocol driver
5  * SCMI Message Protocol is used between the System Control Processor(SCP)
37 #include <trace/events/scmi.h>
53 /* List of all SCMI devices active in system */
92  * @handle: Reference to the SCMI handle associated to this protocol instance.
100  * Each protocol is initialized independently once for each SCMI platform in
101  * which is defined by DT and implemented by the SCMI server fw.
115  * struct scmi_info - Structure representing a SCMI instance
119  * @version: SCMI revision information containing protocol version,
121  * @handle: Instance of SCMI handle to send to clients
127  *	       this SCMI instance: populated on protocol's first attempted
322  * @handle: Pointer to SCMI entity handle
453  * SCMI transport can deliver such out-of-order responses.
684  * @cinfo: SCMI channel info
715  * @ph: Pointer to SCMI protocol handle
746  * @ph: Pointer to SCMI protocol handle
858  * @ph: Pointer to SCMI protocol handle
887  * @ph: Pointer to SCMI protocol handle
934  * version_get() - command to get the revision of the SCMI entity
936  * @ph: Pointer to SCMI protocol handle
939  * Updates the SCMI information in the internal data structure.
1009  * A helper to grab the version memory area reference during SCMI Base protocol
1012  * Return: A reference to the version memory area associated to the SCMI
1026  * @info: The reference to the related SCMI instance.
1030  * description, against the specified SCMI instance @info, and initialize it;
1106  * @handle: A reference to the SCMI platform instance.
1145  * @handle: A reference to the SCMI platform instance.
1148  * Register a new user for the requested protocol on the specified SCMI
1160  * @handle: A reference to the SCMI platform instance.
1246  * released, and possibly de-initialized on last user, once the SCMI driver
1319  * scmi_handle_get() - Get the SCMI handle for a device
1321  * @dev: pointer to device for which we want SCMI handle
1324  * and is expected to be maintained by caller of SCMI protocol library.
1354  * and is expected to be maintained by caller of SCMI protocol library.
1505 		dev_err(dev, "unable to allocate SCMI idr slot err %d\n", ret);  in scmi_chan_setup()
1525  * scmi_get_protocol_device  - Helper to get/create an SCMI device.
1528  * SCMI instance.
1529  * @info: The referred SCMI instance for which we are getting/creating this
1534  * Referring to the specific SCMI instance identified by @info, this helper
1537  * child of the specified SCMI instance @info and its transport properly
1540  * Return: A properly initialized scmi device, NULL otherwise.
1548 	/* Already created for this parent SCMI instance ? */  in scmi_get_protocol_device()
1553 	pr_debug("Creating SCMI device (%s) for protocol %x\n", name, prot_id);  in scmi_get_protocol_device()
1587  * this SCMI instance.
1590  * @info: The SCMI instance descriptor
1618  * This helper let an SCMI driver request specific devices identified by the
1619  * @id_table to be created for each active SCMI instance.
1624  * active SCMI instance. (if any)
1627  * initialized(probed) SCMI instances (handles) and it remains also annotated
1628  * as pending creation if the requesting SCMI driver was loaded before some
1629  * SCMI instance and related transports were available: when such late instance
1644 	pr_debug("Requesting SCMI device (%s) for protocol %x\n",  in scmi_protocol_device_request()
1701 			pr_err("Failed to save SCMI device - ret:%d\n", ret);  in scmi_protocol_device_request()
1713 	 * already initialized SCMI instance which has registered the requested  in scmi_protocol_device_request()
1735 				"Failed. SCMI protocol %d not active.\n",  in scmi_protocol_device_request()
1752  * An helper to let an SCMI driver release its request about devices; note that
1753  * devices are created and initialized once the first SCMI driver request them
1754  * but they destroyed only on SCMI core unloading/unbinding.
1756  * The current SCMI transport layer uses such devices as internal references and
1758  * that cannot be safely destroyed till the whole SCMI stack is removed.
1765 	pr_debug("Unrequesting SCMI device (%s) for protocol %x\n",  in scmi_protocol_device_unrequest()
1854 		dev_err(dev, "SCMI Notifications NOT available.\n");  in scmi_probe()
1857 	 * Trigger SCMI Base protocol initialization.  in scmi_probe()
1859 	 * SCMI stack is shutdown/unloaded as a whole.  in scmi_probe()
1863 		dev_err(dev, "unable to communicate with SCMI\n");  in scmi_probe()
1881 			dev_err(dev, "SCMI protocol %d not implemented\n",  in scmi_probe()
1888 		 * @active_protocols for this SCMI instance/  in scmi_probe()
1893 			dev_err(dev, "SCMI protocol %d already activated. Skip\n",  in scmi_probe()
1995 	{ .compatible = "arm,scmi", .data = &scmi_mailbox_desc },
1998 	{ .compatible = "arm,scmi-smc", .data = &scmi_smc_desc},
2001 	{ .compatible = "arm,scmi-virtio", .data = &scmi_virtio_desc},
2010 		   .name = "arm-scmi",
2047 			pr_err("SCMI transport %s FAILED initialization!\n",  in __scmi_transports_setup()
2070 	/* Bail out if no SCMI transport was configured */  in scmi_driver_init()
2115 MODULE_ALIAS("platform: arm-scmi");
2117 MODULE_DESCRIPTION("ARM SCMI protocol driver");