// SPDX-License-Identifier: GPL-2.0 /* * Texas Instruments System Control Interface Protocol Driver * * Copyright ( C ) 2015 - 2025 Texas Instruments Incorporated - https : //www.ti.com/ * Nishanth Menon #define pr_fmt(fmt) "%s: " fmt, __func__#include <linux/bitmap.h>#include <linux/cpu.h>#include <linux/debugfs.h>#include <linux/export.h>#include <linux/io.h>#include <linux/iopoll.h>#include <linux/kernel.h>#include <linux/mailbox_client.h>#include <linux/module.h>#include <linux/of.h>#include <linux/of_platform.h>#include <linux/platform_device.h>#include <linux/pm_qos.h>#include <linux/property.h>#include <linux/semaphore.h>#include <linux/slab.h>#include <linux/soc/ti/ti-msgmgr.h>#include <linux/soc/ti/ti_sci_protocol.h>#include <linux/suspend.h>#include <linux/sys_soc.h>#include <linux/reboot.h>#include "ti_sci.h" /* List of all TI SCI devices active in system */ static LIST_HEAD(ti_sci_list);/* Protection for the entire list */ static DEFINE_MUTEX(ti_sci_list_mutex);/** * struct ti_sci_xfer - Structure representing a message flow * @ tx_message : Transmit message * @ rx_len : Receive message length * @ xfer_buf : Preallocated buffer to store receive message * Since we work with request - ACK protocol , we can * reuse the same buffer for the rx path as we * use for the tx path . * @ done : completion event struct ti_sci_xfer {struct ti_msgmgr_message tx_message;struct completion done;/** * struct ti_sci_xfers_info - Structure to manage transfer information * @ sem_xfer_count : Counting Semaphore for managing max simultaneous * Messages . * @ xfer_block : Preallocated Message array * @ xfer_alloc_table : Bitmap table for allocated messages . * Index of this bitmap table is also used for message * sequence identifier . * @ xfer_lock : Protection for message allocation struct ti_sci_xfers_info {struct semaphore sem_xfer_count;struct ti_sci_xfer *xfer_block;unsigned long *xfer_alloc_table;/* protect transfer allocation */ /** * struct ti_sci_desc - Description of SoC integration * @ default_host_id : Host identifier representing the compute entity * @ max_rx_timeout_ms : Timeout for communication with SoC ( in Milliseconds ) * @ max_msgs : Maximum number of messages that can be pending * simultaneously in the system * @ max_msg_size : Maximum size of data per message that can be handled . struct ti_sci_desc {int max_rx_timeout_ms;int max_msgs;int max_msg_size;/** * struct ti_sci_info - Structure representing a TI SCI instance * @ dev : Device pointer * @ desc : SoC description for this instance * @ d : Debugfs file entry * @ debug_region : Memory region where the debug message are available * @ debug_region_size : Debug region size * @ debug_buffer : Buffer allocated to copy debug messages . * @ handle : Instance of TI SCI handle to send to clients . * @ cl : Mailbox Client * @ chan_tx : Transmit mailbox channel * @ chan_rx : Receive mailbox channel * @ minfo : Message info * @ node : list head * @ host_id : Host ID * @ fw_caps : FW / SoC low power capabilities * @ users : Number of users of this instance struct ti_sci_info {struct device *dev;const struct ti_sci_desc *desc;struct dentry *d;void __iomem *debug_region;char *debug_buffer;struct ti_sci_handle handle;struct mbox_client cl;struct mbox_chan *chan_tx;struct mbox_chan *chan_rx;struct ti_sci_xfers_info minfo;struct list_head node;/* protected by ti_sci_list_mutex */ int users;#define cl_to_ti_sci_info(c) container_of(c, struct ti_sci_info, cl)#define handle_to_ti_sci_info(h) container_of(h, struct ti_sci_info, handle)#ifdef CONFIG_DEBUG_FS/** * ti_sci_debug_show ( ) - Helper to dump the debug log * @ s : sequence file pointer * @ unused : unused . * * Return : 0 static int ti_sci_debug_show(struct seq_file *s, void *unused)struct ti_sci_info *info = s->private ;/* * We don ' t trust firmware to leave NULL terminated last byte ( hence * we have allocated 1 extra 0 byte ) . Since we cannot guarantee any * specific data format for debug messages , We just present the data * in the buffer as is - we expect the messages to be self explanatory . return 0 ;/* Provide the log file operations interface*/ /** * ti_sci_debugfs_create ( ) - Create log debug file * @ pdev : platform device pointer * @ info : Pointer to SCI entity information * * Return : 0 if all went fine , else corresponding error . static int ti_sci_debugfs_create(struct platform_device *pdev,struct ti_sci_info *info)struct device *dev = &pdev->dev;struct resource *res;char debug_name[50 ];/* Debug region is optional */ "debug_messages" );if (IS_ERR(info->debug_region))return 0 ;1 ,sizeof (char ), GFP_KERNEL);if (!info->debug_buffer)return -ENOMEM;/* Setup NULL termination */ 0 ;sizeof (debug_name), "ti_sci_debug@%s" ,0444 , NULL, info,if (IS_ERR(info->d))return PTR_ERR(info->d);"Debug region => %p, size = %zu bytes, resource: %pr\n" ,return 0 ;#else /* CONFIG_DEBUG_FS */ static inline int ti_sci_debugfs_create(struct platform_device *dev,struct ti_sci_info *info)return 0 ;static inline void ti_sci_debugfs_destroy(struct platform_device *dev,struct ti_sci_info *info)#endif /* CONFIG_DEBUG_FS */ /** * ti_sci_dump_header_dbg ( ) - Helper to dump a message header . * @ dev : Device pointer corresponding to the SCI entity * @ hdr : pointer to header . static inline void ti_sci_dump_header_dbg(struct device *dev,struct ti_sci_msg_hdr *hdr)"MSGHDR:type=0x%04x host=0x%02x seq=0x%02x flags=0x%08x\n" ,/** * ti_sci_rx_callback ( ) - mailbox client callback for receive messages * @ cl : client pointer * @ m : mailbox message * * Processes one received message to appropriate transfer information and * signals completion of the transfer . * * NOTE : This function will be invoked in IRQ context , hence should be * as optimal as possible . static void ti_sci_rx_callback(struct mbox_client *cl, void *m)struct ti_sci_info *info = cl_to_ti_sci_info(cl);struct device *dev = info->dev;struct ti_sci_xfers_info *minfo = &info->minfo;struct ti_msgmgr_message *mbox_msg = m;struct ti_sci_msg_hdr *hdr = (struct ti_sci_msg_hdr *)mbox_msg->buf;struct ti_sci_xfer *xfer;/* * Are we even expecting this ? * NOTE : barriers were implicit in locks used for modifying the bitmap if (!test_bit(xfer_id, minfo->xfer_alloc_table)) {"Message for %d is not expected!\n" , xfer_id);return ;/* Is the message of valid length? */ if (mbox_msg->len > info->desc->max_msg_size) {"Unable to handle %zu xfer(max %d)\n" ,return ;if (mbox_msg->len < xfer->rx_len) {"Recv xfer %zu < expected %d length\n" ,return ;/* Take a copy to the rx buffer.. */ /** * ti_sci_get_one_xfer ( ) - Allocate one message * @ info : Pointer to SCI entity information * @ msg_type : Message type * @ msg_flags : Flag to set for the message * @ tx_message_size : transmit message size * @ rx_message_size : receive message size * * Helper function which is used by various command functions that are * exposed to clients of this driver for allocating a message traffic event . * * This function can sleep depending on pending requests already in the system * for the SCI entity . Further , this also holds a spinlock to maintain integrity * of internal data structures . * * Return : 0 if all went fine , else corresponding error . static struct ti_sci_xfer *ti_sci_get_one_xfer(struct ti_sci_info *info,struct ti_sci_xfers_info *minfo = &info->minfo;struct ti_sci_xfer *xfer;struct ti_sci_msg_hdr *hdr;unsigned long flags;unsigned long bit_pos;int ret;int timeout;/* Ensure we have sane transfer sizes */ if (rx_message_size > info->desc->max_msg_size ||sizeof (*hdr) || tx_message_size < sizeof (*hdr))return ERR_PTR(-ERANGE);/* * Ensure we have only controlled number of pending messages . * Ideally , we might just have to wait a single message , be * conservative and wait 5 times that . . 5 ;if (ret < 0 )return ERR_PTR(ret);/* Keep the locked section as small as possible */ /* * We already ensured in probe that we can have max messages that can * fit in hdr . seq - NOTE : this improves access latencies * to predictable O ( 1 ) access , BUT , it opens us to risk if * remote misbehaves with corrupted message sequence responses . * If that happens , we are going to be messed up anyways . . struct ti_sci_msg_hdr *)xfer->tx_message.buf;return xfer;/** * ti_sci_put_one_xfer ( ) - Release a message * @ minfo : transfer info pointer * @ xfer : message that was reserved by ti_sci_get_one_xfer * * This holds a spinlock to maintain integrity of internal data structures . static void ti_sci_put_one_xfer(struct ti_sci_xfers_info *minfo,struct ti_sci_xfer *xfer)unsigned long flags;struct ti_sci_msg_hdr *hdr;struct ti_sci_msg_hdr *)xfer->tx_message.buf;/* * Keep the locked section as small as possible * NOTE : we might escape with smp_mb and no lock here . . * but just be conservative and symmetric . /* Increment the count for the next user to get through */ /** * ti_sci_do_xfer ( ) - Do one transfer * @ info : Pointer to SCI entity information * @ xfer : Transfer to initiate and wait for response * * Return : - ETIMEDOUT in case of no response , if transmit error , * return corresponding error , else if all goes well , * return 0 . static inline int ti_sci_do_xfer(struct ti_sci_info *info,struct ti_sci_xfer *xfer)int ret;int timeout;struct device *dev = info->dev;bool done_state = true ;if (ret < 0 )return ret;0 ;if (system_state <= SYSTEM_RUNNING) {/* And we wait for the response. */ if (!wait_for_completion_timeout(&xfer->done, timeout))else {/* * If we are ! running , we cannot use wait_for_completion_timeout * during noirq phase , so we must manually poll the completion . 1 ,1000 ,false , &xfer->done);if (ret == -ETIMEDOUT)"Mbox timedout in resp(caller: %pS)\n" ,void *)_RET_IP_);/* * NOTE : we might prefer not to need the mailbox ticker to manage the * transfer queueing since the protocol layer queues things by itself . * Unfortunately , we have to kick the mailbox framework after we have * received our message . return ret;/** * ti_sci_cmd_get_revision ( ) - command to get the revision of the SCI entity * @ info : Pointer to SCI entity information * * Updates the SCI information in the internal data structure . * * Return : 0 if all went fine , else return appropriate error . static int ti_sci_cmd_get_revision(struct ti_sci_info *info)struct device *dev = info->dev;struct ti_sci_handle *handle = &info->handle;struct ti_sci_version_info *ver = &handle->version;struct ti_sci_msg_resp_version *rev_info;struct ti_sci_xfer *xfer;int ret;sizeof (struct ti_sci_msg_hdr),sizeof (*rev_info));if (IS_ERR(xfer)) {"Message alloc failed(%d)\n" , ret);return ret;struct ti_sci_msg_resp_version *)xfer->xfer_buf;if (ret) {"Mbox send fail %d\n" , ret);goto fail;sizeof (ver->firmware_description));return ret;/** * ti_sci_is_response_ack ( ) - Generic ACK / NACK message checkup * @ r : pointer to response buffer * * Return : true if the response was an ACK , else returns false . static inline bool ti_sci_is_response_ack(void *r)struct ti_sci_msg_hdr *hdr = r;return hdr->flags & TI_SCI_FLAG_RESP_GENERIC_ACK ? true : false ;/** * ti_sci_set_device_state ( ) - Set device state helper * @ handle : pointer to TI SCI handle * @ id : Device identifier * @ flags : flags to setup for the device * @ state : State to move the device to * * Return : 0 if all went well , else returns appropriate error value . static int ti_sci_set_device_state(const struct ti_sci_handle *handle,struct ti_sci_info *info;struct ti_sci_msg_req_set_device_state *req;struct ti_sci_msg_hdr *resp;struct ti_sci_xfer *xfer;struct device *dev;int ret = 0 ;if (IS_ERR(handle))return PTR_ERR(handle);if (!handle)return -EINVAL;sizeof (*req), sizeof (*resp));if (IS_ERR(xfer)) {"Message alloc failed(%d)\n" , ret);return ret;struct ti_sci_msg_req_set_device_state *)xfer->xfer_buf;if (ret) {"Mbox send fail %d\n" , ret);goto fail;struct ti_sci_msg_hdr *)xfer->xfer_buf;0 : -ENODEV;return ret;/** * ti_sci_get_device_state ( ) - Get device state helper * @ handle : Handle to the device * @ id : Device Identifier * @ clcnt : Pointer to Context Loss Count * @ resets : pointer to resets * @ p_state : pointer to p_state * @ c_state : pointer to c_state * * Return : 0 if all went fine , else return appropriate error . static int ti_sci_get_device_state(const struct ti_sci_handle *handle,struct ti_sci_info *info;struct ti_sci_msg_req_get_device_state *req;struct ti_sci_msg_resp_get_device_state *resp;struct ti_sci_xfer *xfer;struct device *dev;int ret = 0 ;if (IS_ERR(handle))return PTR_ERR(handle);if (!handle)return -EINVAL;if (!clcnt && !resets && !p_state && !c_state)return -EINVAL;sizeof (*req), sizeof (*resp));if (IS_ERR(xfer)) {"Message alloc failed(%d)\n" , ret);return ret;struct ti_sci_msg_req_get_device_state *)xfer->xfer_buf;if (ret) {"Mbox send fail %d\n" , ret);goto fail;struct ti_sci_msg_resp_get_device_state *)xfer->xfer_buf;if (!ti_sci_is_response_ack(resp)) {goto fail;if (clcnt)if (resets)if (p_state)if (c_state)return ret;/** * ti_sci_cmd_get_device ( ) - command to request for device managed by TISCI * that can be shared with other hosts . * @ handle : Pointer to TISCI handle as retrieved by * ti_sci_get_handle * @ id : Device Identifier * * Request for the device - NOTE : the client MUST maintain integrity of * usage count by balancing get_device with put_device . No refcounting is * managed by driver for that purpose . * * Return : 0 if all went fine , else return appropriate error . static int ti_sci_cmd_get_device(const struct ti_sci_handle *handle, u32 id)return ti_sci_set_device_state(handle, id, 0 ,/** * ti_sci_cmd_get_device_exclusive ( ) - command to request for device managed by * TISCI that is exclusively owned by the * requesting host . * @ handle : Pointer to TISCI handle as retrieved by * ti_sci_get_handle * @ id : Device Identifier * * Request for the device - NOTE : the client MUST maintain integrity of * usage count by balancing get_device with put_device . No refcounting is * managed by driver for that purpose . * * Return : 0 if all went fine , else return appropriate error . static int ti_sci_cmd_get_device_exclusive(const struct ti_sci_handle *handle,return ti_sci_set_device_state(handle, id,/** * ti_sci_cmd_idle_device ( ) - Command to idle a device managed by TISCI * @ handle : Pointer to TISCI handle as retrieved by * ti_sci_get_handle * @ id : Device Identifier * * Request for the device - NOTE : the client MUST maintain integrity of * usage count by balancing get_device with put_device . No refcounting is * managed by driver for that purpose . * * Return : 0 if all went fine , else return appropriate error . static int ti_sci_cmd_idle_device(const struct ti_sci_handle *handle, u32 id)return ti_sci_set_device_state(handle, id, 0 ,/** * ti_sci_cmd_idle_device_exclusive ( ) - Command to idle a device managed by * TISCI that is exclusively owned by * requesting host . * @ handle : Pointer to TISCI handle as retrieved by * ti_sci_get_handle * @ id : Device Identifier * * Request for the device - NOTE : the client MUST maintain integrity of * usage count by balancing get_device with put_device . No refcounting is * managed by driver for that purpose . * * Return : 0 if all went fine , else return appropriate error . static int ti_sci_cmd_idle_device_exclusive(const struct ti_sci_handle *handle,return ti_sci_set_device_state(handle, id,/** * ti_sci_cmd_put_device ( ) - command to release a device managed by TISCI * @ handle : Pointer to TISCI handle as retrieved by * ti_sci_get_handle * @ id : Device Identifier * * Request for the device - NOTE : the client MUST maintain integrity of * usage count by balancing get_device with put_device . No refcounting is * managed by driver for that purpose . * * Return : 0 if all went fine , else return appropriate error . static int ti_sci_cmd_put_device(const struct ti_sci_handle *handle, u32 id)return ti_sci_set_device_state(handle, id,0 , MSG_DEVICE_SW_STATE_AUTO_OFF);/** * ti_sci_cmd_dev_is_valid ( ) - Is the device valid * @ handle : Pointer to TISCI handle as retrieved by * ti_sci_get_handle * @ id : Device Identifier * * Return : 0 if all went fine and the device ID is valid , else return * appropriate error . static int ti_sci_cmd_dev_is_valid(const struct ti_sci_handle *handle, u32 id)/* check the device state which will also tell us if the ID is valid */ return ti_sci_get_device_state(handle, id, NULL, NULL, NULL, &unused);/** * ti_sci_cmd_dev_get_clcnt ( ) - Get context loss counter * @ handle : Pointer to TISCI handle * @ id : Device Identifier * @ count : Pointer to Context Loss counter to populate * * Return : 0 if all went fine , else return appropriate error . static int ti_sci_cmd_dev_get_clcnt(const struct ti_sci_handle *handle, u32 id,return ti_sci_get_device_state(handle, id, count, NULL, NULL, NULL);/** * ti_sci_cmd_dev_is_idle ( ) - Check if the device is requested to be idle * @ handle : Pointer to TISCI handle * @ id : Device Identifier * @ r_state : true if requested to be idle * * Return : 0 if all went fine , else return appropriate error . static int ti_sci_cmd_dev_is_idle(const struct ti_sci_handle *handle, u32 id,bool *r_state)int ret;if (!r_state)return -EINVAL;if (ret)return ret;return 0 ;/** * ti_sci_cmd_dev_is_stop ( ) - Check if the device is requested to be stopped * @ handle : Pointer to TISCI handle * @ id : Device Identifier * @ r_state : true if requested to be stopped * @ curr_state : true if currently stopped . * * Return : 0 if all went fine , else return appropriate error . static int ti_sci_cmd_dev_is_stop(const struct ti_sci_handle *handle, u32 id,bool *r_state, bool *curr_state)int ret;if (!r_state && !curr_state)return -EINVAL;if (ret)return ret;if (r_state)if (curr_state)return 0 ;/** * ti_sci_cmd_dev_is_on ( ) - Check if the device is requested to be ON * @ handle : Pointer to TISCI handle * @ id : Device Identifier * @ r_state : true if requested to be ON * @ curr_state : true if currently ON and active * * Return : 0 if all went fine , else return appropriate error . static int ti_sci_cmd_dev_is_on(const struct ti_sci_handle *handle, u32 id,bool *r_state, bool *curr_state)int ret;if (!r_state && !curr_state)return -EINVAL;if (ret)return ret;if (r_state)if (curr_state)return 0 ;/** * ti_sci_cmd_dev_is_trans ( ) - Check if the device is currently transitioning * @ handle : Pointer to TISCI handle * @ id : Device Identifier * @ curr_state : true if currently transitioning . * * Return : 0 if all went fine , else return appropriate error . static int ti_sci_cmd_dev_is_trans(const struct ti_sci_handle *handle, u32 id,bool *curr_state)int ret;if (!curr_state)return -EINVAL;if (ret)return ret;return 0 ;/** * ti_sci_cmd_set_device_resets ( ) - command to set resets for device managed * by TISCI * @ handle : Pointer to TISCI handle as retrieved by * ti_sci_get_handle * @ id : Device Identifier * @ reset_state : Device specific reset bit field * * Return : 0 if all went fine , else return appropriate error . static int ti_sci_cmd_set_device_resets(const struct ti_sci_handle *handle,struct ti_sci_info *info;struct ti_sci_msg_req_set_device_resets *req;struct ti_sci_msg_hdr *resp;struct ti_sci_xfer *xfer;struct device *dev;int ret = 0 ;if (IS_ERR(handle))return PTR_ERR(handle);if (!handle)return -EINVAL;sizeof (*req), sizeof (*resp));if (IS_ERR(xfer)) {"Message alloc failed(%d)\n" , ret);return ret;struct ti_sci_msg_req_set_device_resets *)xfer->xfer_buf;if (ret) {"Mbox send fail %d\n" , ret);goto fail;struct ti_sci_msg_hdr *)xfer->xfer_buf;0 : -ENODEV;return ret;/** * ti_sci_cmd_get_device_resets ( ) - Get reset state for device managed * by TISCI * @ handle : Pointer to TISCI handle * @ id : Device Identifier * @ reset_state : Pointer to reset state to populate * * Return : 0 if all went fine , else return appropriate error . static int ti_sci_cmd_get_device_resets(const struct ti_sci_handle *handle,return ti_sci_get_device_state(handle, id, NULL, reset_state, NULL,/** * ti_sci_set_clock_state ( ) - Set clock state helper * @ handle : pointer to TI SCI handle * @ dev_id : Device identifier this request is for * @ clk_id : Clock identifier for the device for this request . * Each device has it ' s own set of clock inputs . This indexes * which clock input to modify . * @ flags : Header flags as needed * @ state : State to request for the clock . * * Return : 0 if all went well , else returns appropriate error value . static int ti_sci_set_clock_state(const struct ti_sci_handle *handle,struct ti_sci_info *info;struct ti_sci_msg_req_set_clock_state *req;struct ti_sci_msg_hdr *resp;struct ti_sci_xfer *xfer;struct device *dev;int ret = 0 ;if (IS_ERR(handle))return PTR_ERR(handle);if (!handle)return -EINVAL;sizeof (*req), sizeof (*resp));if (IS_ERR(xfer)) {"Message alloc failed(%d)\n" , ret);return ret;struct ti_sci_msg_req_set_clock_state *)xfer->xfer_buf;if (clk_id < 255 ) {else {255 ;if (ret) {"Mbox send fail %d\n" , ret);goto fail;struct ti_sci_msg_hdr *)xfer->xfer_buf;0 : -ENODEV;return ret;/** * ti_sci_cmd_get_clock_state ( ) - Get clock state helper * @ handle : pointer to TI SCI handle * @ dev_id : Device identifier this request is for * @ clk_id : Clock identifier for the device for this request . * Each device has it ' s own set of clock inputs . This indexes * which clock input to modify . * @ programmed_state : State requested for clock to move to * @ current_state : State that the clock is currently in * * Return : 0 if all went well , else returns appropriate error value . static int ti_sci_cmd_get_clock_state(const struct ti_sci_handle *handle,struct ti_sci_info *info;struct ti_sci_msg_req_get_clock_state *req;struct ti_sci_msg_resp_get_clock_state *resp;struct ti_sci_xfer *xfer;struct device *dev;int ret = 0 ;if (IS_ERR(handle))return PTR_ERR(handle);if (!handle)return -EINVAL;if (!programmed_state && !current_state)return -EINVAL;sizeof (*req), sizeof (*resp));if (IS_ERR(xfer)) {"Message alloc failed(%d)\n" , ret);return ret;struct ti_sci_msg_req_get_clock_state *)xfer->xfer_buf;if (clk_id < 255 ) {else {255 ;if (ret) {"Mbox send fail %d\n" , ret);goto fail;struct ti_sci_msg_resp_get_clock_state *)xfer->xfer_buf;if (!ti_sci_is_response_ack(resp)) {goto fail;if (programmed_state)if (current_state)return ret;/** * ti_sci_cmd_get_clock ( ) - Get control of a clock from TI SCI * @ handle : pointer to TI SCI handle * @ dev_id : Device identifier this request is for * @ clk_id : Clock identifier for the device for this request . * Each device has it ' s own set of clock inputs . This indexes * which clock input to modify . * @ needs_ssc : ' true ' if Spread Spectrum clock is desired , else ' false ' * @ can_change_freq : ' true ' if frequency change is desired , else ' false ' * @ enable_input_term : ' true ' if input termination is desired , else ' false ' * * Return : 0 if all went well , else returns appropriate error value . static int ti_sci_cmd_get_clock(const struct ti_sci_handle *handle, u32 dev_id,bool needs_ssc,bool can_change_freq, bool enable_input_term)0 ;0 ;0 ;0 ;return ti_sci_set_clock_state(handle, dev_id, clk_id, flags,/** * ti_sci_cmd_idle_clock ( ) - Idle a clock which is in our control * @ handle : pointer to TI SCI handle * @ dev_id : Device identifier this request is for * @ clk_id : Clock identifier for the device for this request . * Each device has it ' s own set of clock inputs . This indexes * which clock input to modify . * * NOTE : This clock must have been requested by get_clock previously . * * Return : 0 if all went well , else returns appropriate error value . static int ti_sci_cmd_idle_clock(const struct ti_sci_handle *handle,return ti_sci_set_clock_state(handle, dev_id, clk_id,/** * ti_sci_cmd_put_clock ( ) - Release a clock from our control back to TISCI * @ handle : pointer to TI SCI handle * @ dev_id : Device identifier this request is for * @ clk_id : Clock identifier for the device for this request . * Each device has it ' s own set of clock inputs . This indexes * which clock input to modify . * * NOTE : This clock must have been requested by get_clock previously . * * Return : 0 if all went well , else returns appropriate error value . static int ti_sci_cmd_put_clock(const struct ti_sci_handle *handle,return ti_sci_set_clock_state(handle, dev_id, clk_id,/** * ti_sci_cmd_clk_is_auto ( ) - Is the clock being auto managed * @ handle : pointer to TI SCI handle * @ dev_id : Device identifier this request is for * @ clk_id : Clock identifier for the device for this request . * Each device has it ' s own set of clock inputs . This indexes * which clock input to modify . * @ req_state : state indicating if the clock is auto managed * * Return : 0 if all went well , else returns appropriate error value . static int ti_sci_cmd_clk_is_auto(const struct ti_sci_handle *handle,bool *req_state)0 ;int ret;if (!req_state)return -EINVAL;if (ret)return ret;return 0 ;/** * ti_sci_cmd_clk_is_on ( ) - Is the clock ON * @ handle : pointer to TI SCI handle * @ dev_id : Device identifier this request is for * @ clk_id : Clock identifier for the device for this request . * Each device has it ' s own set of clock inputs . This indexes * which clock input to modify . * @ req_state : state indicating if the clock is managed by us and enabled * @ curr_state : state indicating if the clock is ready for operation * * Return : 0 if all went well , else returns appropriate error value . static int ti_sci_cmd_clk_is_on(const struct ti_sci_handle *handle, u32 dev_id,bool *req_state, bool *curr_state)0 , r_state = 0 ;int ret;if (!req_state && !curr_state)return -EINVAL;if (ret)return ret;if (req_state)if (curr_state)return 0 ;/** * ti_sci_cmd_clk_is_off ( ) - Is the clock OFF * @ handle : pointer to TI SCI handle * @ dev_id : Device identifier this request is for * @ clk_id : Clock identifier for the device for this request . * Each device has it ' s own set of clock inputs . This indexes * which clock input to modify . * @ req_state : state indicating if the clock is managed by us and disabled * @ curr_state : state indicating if the clock is NOT ready for operation * * Return : 0 if all went well , else returns appropriate error value . static int ti_sci_cmd_clk_is_off(const struct ti_sci_handle *handle, u32 dev_id,bool *req_state, bool *curr_state)0 , r_state = 0 ;int ret;if (!req_state && !curr_state)return -EINVAL;if (ret)return ret;if (req_state)if (curr_state)return 0 ;/** * ti_sci_cmd_clk_set_parent ( ) - Set the clock source of a specific device clock * @ handle : pointer to TI SCI handle * @ dev_id : Device identifier this request is for * @ clk_id : Clock identifier for the device for this request . * Each device has it ' s own set of clock inputs . This indexes * which clock input to modify . * @ parent_id : Parent clock identifier to set * * Return : 0 if all went well , else returns appropriate error value . static int ti_sci_cmd_clk_set_parent(const struct ti_sci_handle *handle,struct ti_sci_info *info;struct ti_sci_msg_req_set_clock_parent *req;struct ti_sci_msg_hdr *resp;struct ti_sci_xfer *xfer;struct device *dev;int ret = 0 ;if (IS_ERR(handle))return PTR_ERR(handle);if (!handle)return -EINVAL;sizeof (*req), sizeof (*resp));if (IS_ERR(xfer)) {"Message alloc failed(%d)\n" , ret);return ret;struct ti_sci_msg_req_set_clock_parent *)xfer->xfer_buf;if (clk_id < 255 ) {else {255 ;if (parent_id < 255 ) {else {255 ;if (ret) {"Mbox send fail %d\n" , ret);goto fail;struct ti_sci_msg_hdr *)xfer->xfer_buf;0 : -ENODEV;return ret;/** * ti_sci_cmd_clk_get_parent ( ) - Get current parent clock source * @ handle : pointer to TI SCI handle * @ dev_id : Device identifier this request is for * @ clk_id : Clock identifier for the device for this request . * Each device has it ' s own set of clock inputs . This indexes * which clock input to modify . * @ parent_id : Current clock parent * * Return : 0 if all went well , else returns appropriate error value . static int ti_sci_cmd_clk_get_parent(const struct ti_sci_handle *handle,struct ti_sci_info *info;struct ti_sci_msg_req_get_clock_parent *req;struct ti_sci_msg_resp_get_clock_parent *resp;struct ti_sci_xfer *xfer;struct device *dev;int ret = 0 ;if (IS_ERR(handle))return PTR_ERR(handle);if (!handle || !parent_id)return -EINVAL;sizeof (*req), sizeof (*resp));if (IS_ERR(xfer)) {"Message alloc failed(%d)\n" , ret);return ret;struct ti_sci_msg_req_get_clock_parent *)xfer->xfer_buf;if (clk_id < 255 ) {else {255 ;if (ret) {"Mbox send fail %d\n" , ret);goto fail;struct ti_sci_msg_resp_get_clock_parent *)xfer->xfer_buf;if (!ti_sci_is_response_ack(resp)) {else {if (resp->parent_id < 255 )else return ret;/** * ti_sci_cmd_clk_get_num_parents ( ) - Get num parents of the current clk source * @ handle : pointer to TI SCI handle * @ dev_id : Device identifier this request is for * @ clk_id : Clock identifier for the device for this request . * Each device has it ' s own set of clock inputs . This indexes * which clock input to modify . * @ num_parents : Returns he number of parents to the current clock . * * Return : 0 if all went well , else returns appropriate error value . static int ti_sci_cmd_clk_get_num_parents(const struct ti_sci_handle *handle,struct ti_sci_info *info;struct ti_sci_msg_req_get_clock_num_parents *req;struct ti_sci_msg_resp_get_clock_num_parents *resp;struct ti_sci_xfer *xfer;struct device *dev;int ret = 0 ;if (IS_ERR(handle))return PTR_ERR(handle);if (!handle || !num_parents)return -EINVAL;sizeof (*req), sizeof (*resp));if (IS_ERR(xfer)) {"Message alloc failed(%d)\n" , ret);return ret;struct ti_sci_msg_req_get_clock_num_parents *)xfer->xfer_buf;if (clk_id < 255 ) {else {255 ;if (ret) {"Mbox send fail %d\n" , ret);goto fail;struct ti_sci_msg_resp_get_clock_num_parents *)xfer->xfer_buf;if (!ti_sci_is_response_ack(resp)) {else {if (resp->num_parents < 255 )else return ret;/** * ti_sci_cmd_clk_get_match_freq ( ) - Find a good match for frequency * @ handle : pointer to TI SCI handle * @ dev_id : Device identifier this request is for * @ clk_id : Clock identifier for the device for this request . * Each device has it ' s own set of clock inputs . This indexes * which clock input to modify . * @ min_freq : The minimum allowable frequency in Hz . This is the minimum * allowable programmed frequency and does not account for clock * tolerances and jitter . * @ target_freq : The target clock frequency in Hz . A frequency will be * processed as close to this target frequency as possible . * @ max_freq : The maximum allowable frequency in Hz . This is the maximum * allowable programmed frequency and does not account for clock * tolerances and jitter . * @ match_freq : Frequency match in Hz response . * * Return : 0 if all went well , else returns appropriate error value . static int ti_sci_cmd_clk_get_match_freq(const struct ti_sci_handle *handle,struct ti_sci_info *info;struct ti_sci_msg_req_query_clock_freq *req;struct ti_sci_msg_resp_query_clock_freq *resp;struct ti_sci_xfer *xfer;struct device *dev;int ret = 0 ;if (IS_ERR(handle))return PTR_ERR(handle);if (!handle || !match_freq)return -EINVAL;sizeof (*req), sizeof (*resp));if (IS_ERR(xfer)) {"Message alloc failed(%d)\n" , ret);return ret;struct ti_sci_msg_req_query_clock_freq *)xfer->xfer_buf;if (clk_id < 255 ) {else {255 ;if (ret) {"Mbox send fail %d\n" , ret);goto fail;struct ti_sci_msg_resp_query_clock_freq *)xfer->xfer_buf;if (!ti_sci_is_response_ack(resp))else return ret;/** * ti_sci_cmd_clk_set_freq ( ) - Set a frequency for clock * @ handle : pointer to TI SCI handle * @ dev_id : Device identifier this request is for * @ clk_id : Clock identifier for the device for this request . * Each device has it ' s own set of clock inputs . This indexes * which clock input to modify . * @ min_freq : The minimum allowable frequency in Hz . This is the minimum * allowable programmed frequency and does not account for clock * tolerances and jitter . * @ target_freq : The target clock frequency in Hz . A frequency will be * processed as close to this target frequency as possible . * @ max_freq : The maximum allowable frequency in Hz . This is the maximum * allowable programmed frequency and does not account for clock * tolerances and jitter . * * Return : 0 if all went well , else returns appropriate error value . static int ti_sci_cmd_clk_set_freq(const struct ti_sci_handle *handle,struct ti_sci_info *info;struct ti_sci_msg_req_set_clock_freq *req;struct ti_sci_msg_hdr *resp;struct ti_sci_xfer *xfer;struct device *dev;int ret = 0 ;if (IS_ERR(handle))return PTR_ERR(handle);if (!handle)return -EINVAL;sizeof (*req), sizeof (*resp));if (IS_ERR(xfer)) {"Message alloc failed(%d)\n" , ret);return ret;struct ti_sci_msg_req_set_clock_freq *)xfer->xfer_buf;if (clk_id < 255 ) {else {255 ;if (ret) {"Mbox send fail %d\n" , ret);goto fail;struct ti_sci_msg_hdr *)xfer->xfer_buf;0 : -ENODEV;return ret;/** * ti_sci_cmd_clk_get_freq ( ) - Get current frequency * @ handle : pointer to TI SCI handle * @ dev_id : Device identifier this request is for * @ clk_id : Clock identifier for the device for this request . * Each device has it ' s own set of clock inputs . This indexes * which clock input to modify . * @ freq : Currently frequency in Hz * * Return : 0 if all went well , else returns appropriate error value . static int ti_sci_cmd_clk_get_freq(const struct ti_sci_handle *handle,struct ti_sci_info *info;struct ti_sci_msg_req_get_clock_freq *req;struct ti_sci_msg_resp_get_clock_freq *resp;struct ti_sci_xfer *xfer;struct device *dev;int ret = 0 ;if (IS_ERR(handle))return PTR_ERR(handle);if (!handle || !freq)return -EINVAL;sizeof (*req), sizeof (*resp));if (IS_ERR(xfer)) {"Message alloc failed(%d)\n" , ret);return ret;struct ti_sci_msg_req_get_clock_freq *)xfer->xfer_buf;if (clk_id < 255 ) {else {255 ;if (ret) {"Mbox send fail %d\n" , ret);goto fail;struct ti_sci_msg_resp_get_clock_freq *)xfer->xfer_buf;if (!ti_sci_is_response_ack(resp))else return ret;/** * ti_sci_cmd_prepare_sleep ( ) - Prepare system for system suspend * @ handle : pointer to TI SCI handle * @ mode : Device identifier * @ ctx_lo : Low part of address for context save * @ ctx_hi : High part of address for context save * @ debug_flags : Debug flags to pass to firmware * * Return : 0 if all went well , else returns appropriate error value . static int ti_sci_cmd_prepare_sleep(const struct ti_sci_handle *handle, u8 mode,struct ti_sci_info *info;struct ti_sci_msg_req_prepare_sleep *req;struct ti_sci_msg_hdr *resp;struct ti_sci_xfer *xfer;struct device *dev;int ret = 0 ;if (IS_ERR(handle))return PTR_ERR(handle);if (!handle)return -EINVAL;sizeof (*req), sizeof (*resp));if (IS_ERR(xfer)) {"Message alloc failed(%d)\n" , ret);return ret;struct ti_sci_msg_req_prepare_sleep *)xfer->xfer_buf;if (ret) {"Mbox send fail %d\n" , ret);goto fail;struct ti_sci_msg_hdr *)xfer->xfer_buf;if (!ti_sci_is_response_ack(resp)) {"Failed to prepare sleep\n" );return ret;/** * ti_sci_msg_cmd_query_fw_caps ( ) - Get the FW / SoC capabilities * @ handle : Pointer to TI SCI handle * @ fw_caps : Each bit in fw_caps indicating one FW / SOC capability * * Check if the firmware supports any optional low power modes . * Old revisions of TIFS ( < 08 . 04 ) will NACK the request which results in * - ENODEV being returned . * * Return : 0 if all went well , else returns appropriate error value . static int ti_sci_msg_cmd_query_fw_caps(const struct ti_sci_handle *handle,struct ti_sci_info *info;struct ti_sci_xfer *xfer;struct ti_sci_msg_resp_query_fw_caps *resp;struct device *dev;int ret = 0 ;if (IS_ERR(handle))return PTR_ERR(handle);if (!handle)return -EINVAL;sizeof (struct ti_sci_msg_hdr),sizeof (*resp));if (IS_ERR(xfer)) {"Message alloc failed(%d)\n" , ret);return ret;if (ret) {"Mbox send fail %d\n" , ret);goto fail;struct ti_sci_msg_resp_query_fw_caps *)xfer->xfer_buf;if (!ti_sci_is_response_ack(resp)) {"Failed to get capabilities\n" );goto fail;if (fw_caps)return ret;/** * ti_sci_cmd_set_io_isolation ( ) - Enable IO isolation in LPM * @ handle : Pointer to TI SCI handle * @ state : The desired state of the IO isolation * * Return : 0 if all went well , else returns appropriate error value . static int ti_sci_cmd_set_io_isolation(const struct ti_sci_handle *handle,struct ti_sci_info *info;struct ti_sci_msg_req_set_io_isolation *req;struct ti_sci_msg_hdr *resp;struct ti_sci_xfer *xfer;struct device *dev;int ret = 0 ;if (IS_ERR(handle))return PTR_ERR(handle);if (!handle)return -EINVAL;sizeof (*req), sizeof (*resp));if (IS_ERR(xfer)) {"Message alloc failed(%d)\n" , ret);return ret;struct ti_sci_msg_req_set_io_isolation *)xfer->xfer_buf;if (ret) {"Mbox send fail %d\n" , ret);goto fail;struct ti_sci_msg_hdr *)xfer->xfer_buf;if (!ti_sci_is_response_ack(resp)) {"Failed to set IO isolation\n" );return ret;/** * ti_sci_msg_cmd_lpm_wake_reason ( ) - Get the wakeup source from LPM * @ handle : Pointer to TI SCI handle * @ source : The wakeup source that woke the SoC from LPM * @ timestamp : Timestamp of the wakeup event * @ pin : The pin that has triggered wake up * @ mode : The last entered low power mode * * Return : 0 if all went well , else returns appropriate error value . static int ti_sci_msg_cmd_lpm_wake_reason(const struct ti_sci_handle *handle,struct ti_sci_info *info;struct ti_sci_xfer *xfer;struct ti_sci_msg_resp_lpm_wake_reason *resp;struct device *dev;int ret = 0 ;if (IS_ERR(handle))return PTR_ERR(handle);if (!handle)return -EINVAL;sizeof (struct ti_sci_msg_hdr),sizeof (*resp));if (IS_ERR(xfer)) {"Message alloc failed(%d)\n" , ret);return ret;if (ret) {"Mbox send fail %d\n" , ret);goto fail;struct ti_sci_msg_resp_lpm_wake_reason *)xfer->xfer_buf;if (!ti_sci_is_response_ack(resp)) {"Failed to get wake reason\n" );goto fail;if (source)if (timestamp)if (pin)if (mode)return ret;/** * ti_sci_cmd_set_device_constraint ( ) - Set LPM constraint on behalf of a device * @ handle : pointer to TI SCI handle * @ id : Device identifier * @ state : The desired state of device constraint : set or clear * * Return : 0 if all went well , else returns appropriate error value . static int ti_sci_cmd_set_device_constraint(const struct ti_sci_handle *handle,struct ti_sci_info *info;struct ti_sci_msg_req_lpm_set_device_constraint *req;struct ti_sci_msg_hdr *resp;struct ti_sci_xfer *xfer;struct device *dev;int ret = 0 ;if (IS_ERR(handle))return PTR_ERR(handle);if (!handle)return -EINVAL;sizeof (*req), sizeof (*resp));if (IS_ERR(xfer)) {"Message alloc failed(%d)\n" , ret);return ret;struct ti_sci_msg_req_lpm_set_device_constraint *)xfer->xfer_buf;if (ret) {"Mbox send fail %d\n" , ret);goto fail;struct ti_sci_msg_hdr *)xfer->xfer_buf;if (!ti_sci_is_response_ack(resp)) {"Failed to set device constraint\n" );return ret;/** * ti_sci_cmd_set_latency_constraint ( ) - Set LPM resume latency constraint * @ handle : pointer to TI SCI handle * @ latency : maximum acceptable latency ( in ms ) to wake up from LPM * @ state : The desired state of latency constraint : set or clear * * Return : 0 if all went well , else returns appropriate error value . static int ti_sci_cmd_set_latency_constraint(const struct ti_sci_handle *handle,struct ti_sci_info *info;struct ti_sci_msg_req_lpm_set_latency_constraint *req;struct ti_sci_msg_hdr *resp;struct ti_sci_xfer *xfer;struct device *dev;int ret = 0 ;if (IS_ERR(handle))return PTR_ERR(handle);if (!handle)return -EINVAL;sizeof (*req), sizeof (*resp));if (IS_ERR(xfer)) {"Message alloc failed(%d)\n" , ret);return ret;struct ti_sci_msg_req_lpm_set_latency_constraint *)xfer->xfer_buf;if (ret) {"Mbox send fail %d\n" , ret);goto fail;struct ti_sci_msg_hdr *)xfer->xfer_buf;if (!ti_sci_is_response_ack(resp)) {"Failed to set device constraint\n" );return ret;/** * ti_sci_cmd_lpm_abort ( ) - Abort entry to LPM by clearing selection of LPM to enter * @ dev : Device pointer corresponding to the SCI entity * * Return : 0 if all went well , else returns appropriate error value . static int ti_sci_cmd_lpm_abort(struct device *dev)struct ti_sci_info *info = dev_get_drvdata(dev);struct ti_sci_msg_hdr *req;struct ti_sci_msg_hdr *resp;struct ti_sci_xfer *xfer;int ret = 0 ;sizeof (*req), sizeof (*resp));if (IS_ERR(xfer)) {"Message alloc failed(%d)\n" , ret);return ret;struct ti_sci_msg_hdr *)xfer->xfer_buf;if (ret) {"Mbox send fail %d\n" , ret);goto fail;struct ti_sci_msg_hdr *)xfer->xfer_buf;if (!ti_sci_is_response_ack(resp))return ret;static int ti_sci_cmd_core_reboot(const struct ti_sci_handle *handle)struct ti_sci_info *info;struct ti_sci_msg_req_reboot *req;struct ti_sci_msg_hdr *resp;struct ti_sci_xfer *xfer;struct device *dev;int ret = 0 ;if (IS_ERR(handle))return PTR_ERR(handle);if (!handle)return -EINVAL;sizeof (*req), sizeof (*resp));if (IS_ERR(xfer)) {"Message alloc failed(%d)\n" , ret);return ret;struct ti_sci_msg_req_reboot *)xfer->xfer_buf;if (ret) {"Mbox send fail %d\n" , ret);goto fail;struct ti_sci_msg_hdr *)xfer->xfer_buf;if (!ti_sci_is_response_ack(resp))else 0 ;return ret;/** * ti_sci_get_resource_range - Helper to get a range of resources assigned * to a host . Resource is uniquely identified by * type and subtype . * @ handle : Pointer to TISCI handle . * @ dev_id : TISCI device ID . * @ subtype : Resource assignment subtype that is being requested * from the given device . * @ s_host : Host processor ID to which the resources are allocated * @ desc : Pointer to ti_sci_resource_desc to be updated with the * resource range start index and number of resources * * Return : 0 if all went fine , else return appropriate error . static int ti_sci_get_resource_range(const struct ti_sci_handle *handle,struct ti_sci_resource_desc *desc)struct ti_sci_msg_resp_get_resource_range *resp;struct ti_sci_msg_req_get_resource_range *req;struct ti_sci_xfer *xfer;struct ti_sci_info *info;struct device *dev;int ret = 0 ;if (IS_ERR(handle))return PTR_ERR(handle);if (!handle || !desc)return -EINVAL;sizeof (*req), sizeof (*resp));if (IS_ERR(xfer)) {"Message alloc failed(%d)\n" , ret);return ret;struct ti_sci_msg_req_get_resource_range *)xfer->xfer_buf;if (ret) {"Mbox send fail %d\n" , ret);goto fail;struct ti_sci_msg_resp_get_resource_range *)xfer->xfer_buf;if (!ti_sci_is_response_ack(resp)) {else if (!resp->range_num && !resp->range_num_sec) {/* Neither of the two resource range is valid */ else {return ret;/** * ti_sci_cmd_get_resource_range - Get a range of resources assigned to host * that is same as ti sci interface host . * @ handle : Pointer to TISCI handle . * @ dev_id : TISCI device ID . * @ subtype : Resource assignment subtype that is being requested * from the given device . * @ desc : Pointer to ti_sci_resource_desc to be updated with the * resource range start index and number of resources * * Return : 0 if all went fine , else return appropriate error . static int ti_sci_cmd_get_resource_range(const struct ti_sci_handle *handle,struct ti_sci_resource_desc *desc)return ti_sci_get_resource_range(handle, dev_id, subtype,/** * ti_sci_cmd_get_resource_range_from_shost - Get a range of resources * assigned to a specified host . * @ handle : Pointer to TISCI handle . * @ dev_id : TISCI device ID . * @ subtype : Resource assignment subtype that is being requested * from the given device . * @ s_host : Host processor ID to which the resources are allocated * @ desc : Pointer to ti_sci_resource_desc to be updated with the * resource range start index and number of resources * * Return : 0 if all went fine , else return appropriate error . static int ti_sci_cmd_get_resource_range_from_shost(const struct ti_sci_handle *handle,struct ti_sci_resource_desc *desc)return ti_sci_get_resource_range(handle, dev_id, subtype, s_host, desc);/** * ti_sci_manage_irq ( ) - Helper api to configure / release the irq route between * the requested source and destination * @ handle : Pointer to TISCI handle . * @ valid_params : Bit fields defining the validity of certain params * @ src_id : Device ID of the IRQ source * @ src_index : IRQ source index within the source device * @ dst_id : Device ID of the IRQ destination * @ dst_host_irq : IRQ number of the destination device * @ ia_id : Device ID of the IA , if the IRQ flows through this IA * @ vint : Virtual interrupt to be used within the IA * @ global_event : Global event number to be used for the requesting event * @ vint_status_bit : Virtual interrupt status bit to be used for the event * @ s_host : Secondary host ID to which the irq / event is being * requested for . * @ type : Request type irq set or release . * * Return : 0 if all went fine , else return appropriate error . static int ti_sci_manage_irq(const struct ti_sci_handle *handle,struct ti_sci_msg_req_manage_irq *req;struct ti_sci_msg_hdr *resp;struct ti_sci_xfer *xfer;struct ti_sci_info *info;struct device *dev;int ret = 0 ;if (IS_ERR(handle))return PTR_ERR(handle);if (!handle)return -EINVAL;sizeof (*req), sizeof (*resp));if (IS_ERR(xfer)) {"Message alloc failed(%d)\n" , ret);return ret;struct ti_sci_msg_req_manage_irq *)xfer->xfer_buf;if (ret) {"Mbox send fail %d\n" , ret);goto fail;struct ti_sci_msg_hdr *)xfer->xfer_buf;0 : -ENODEV;return ret;/** * ti_sci_set_irq ( ) - Helper api to configure the irq route between the * requested source and destination * @ handle : Pointer to TISCI handle . * @ valid_params : Bit fields defining the validity of certain params * @ src_id : Device ID of the IRQ source * @ src_index : IRQ source index within the source device * @ dst_id : Device ID of the IRQ destination * @ dst_host_irq : IRQ number of the destination device * @ ia_id : Device ID of the IA , if the IRQ flows through this IA * @ vint : Virtual interrupt to be used within the IA * @ global_event : Global event number to be used for the requesting event * @ vint_status_bit : Virtual interrupt status bit to be used for the event * @ s_host : Secondary host ID to which the irq / event is being * requested for . * * Return : 0 if all went fine , else return appropriate error . static int ti_sci_set_irq(const struct ti_sci_handle *handle, u32 valid_params,"%s: IRQ set with valid_params = 0x%x from src = %d, index = %d, to dst = %d, irq = %d,via ia_id = %d, vint = %d, global event = %d,status_bit = %d\n" ,return ti_sci_manage_irq(handle, valid_params, src_id, src_index,/** * ti_sci_free_irq ( ) - Helper api to free the irq route between the * requested source and destination * @ handle : Pointer to TISCI handle . * @ valid_params : Bit fields defining the validity of certain params * @ src_id : Device ID of the IRQ source * @ src_index : IRQ source index within the source device * @ dst_id : Device ID of the IRQ destination * @ dst_host_irq : IRQ number of the destination device * @ ia_id : Device ID of the IA , if the IRQ flows through this IA * @ vint : Virtual interrupt to be used within the IA * @ global_event : Global event number to be used for the requesting event * @ vint_status_bit : Virtual interrupt status bit to be used for the event * @ s_host : Secondary host ID to which the irq / event is being * requested for . * * Return : 0 if all went fine , else return appropriate error . static int ti_sci_free_irq(const struct ti_sci_handle *handle, u32 valid_params,"%s: IRQ release with valid_params = 0x%x from src = %d, index = %d, to dst = %d, irq = %d,via ia_id = %d, vint = %d, global event = %d,status_bit = %d\n" ,return ti_sci_manage_irq(handle, valid_params, src_id, src_index,/** * ti_sci_cmd_set_irq ( ) - Configure a host irq route between the requested * source and destination . * @ handle : Pointer to TISCI handle . * @ src_id : Device ID of the IRQ source * @ src_index : IRQ source index within the source device * @ dst_id : Device ID of the IRQ destination * @ dst_host_irq : IRQ number of the destination device * * Return : 0 if all went fine , else return appropriate error . static int ti_sci_cmd_set_irq(const struct ti_sci_handle *handle, u16 src_id,return ti_sci_set_irq(handle, valid_params, src_id, src_index, dst_id,0 , 0 , 0 , 0 , 0 );/** * ti_sci_cmd_set_event_map ( ) - Configure an event based irq route between the * requested source and Interrupt Aggregator . * @ handle : Pointer to TISCI handle . * @ src_id : Device ID of the IRQ source * @ src_index : IRQ source index within the source device * @ ia_id : Device ID of the IA , if the IRQ flows through this IA * @ vint : Virtual interrupt to be used within the IA * @ global_event : Global event number to be used for the requesting event * @ vint_status_bit : Virtual interrupt status bit to be used for the event * * Return : 0 if all went fine , else return appropriate error . static int ti_sci_cmd_set_event_map(const struct ti_sci_handle *handle,return ti_sci_set_irq(handle, valid_params, src_id, src_index, 0 , 0 ,0 );/** * ti_sci_cmd_free_irq ( ) - Free a host irq route between the between the * requested source and destination . * @ handle : Pointer to TISCI handle . * @ src_id : Device ID of the IRQ source * @ src_index : IRQ source index within the source device * @ dst_id : Device ID of the IRQ destination * @ dst_host_irq : IRQ number of the destination device * * Return : 0 if all went fine , else return appropriate error . static int ti_sci_cmd_free_irq(const struct ti_sci_handle *handle, u16 src_id,return ti_sci_free_irq(handle, valid_params, src_id, src_index, dst_id,0 , 0 , 0 , 0 , 0 );/** * ti_sci_cmd_free_event_map ( ) - Free an event map between the requested source * and Interrupt Aggregator . * @ handle : Pointer to TISCI handle . * @ src_id : Device ID of the IRQ source * @ src_index : IRQ source index within the source device * @ ia_id : Device ID of the IA , if the IRQ flows through this IA * @ vint : Virtual interrupt to be used within the IA * @ global_event : Global event number to be used for the requesting event * @ vint_status_bit : Virtual interrupt status bit to be used for the event * * Return : 0 if all went fine , else return appropriate error . static int ti_sci_cmd_free_event_map(const struct ti_sci_handle *handle,return ti_sci_free_irq(handle, valid_params, src_id, src_index, 0 , 0 ,0 );/** * ti_sci_cmd_rm_ring_cfg ( ) - Configure a NAVSS ring * @ handle : Pointer to TI SCI handle . * @ params : Pointer to ti_sci_msg_rm_ring_cfg ring config structure * * Return : 0 if all went well , else returns appropriate error value . * * See @ ti_sci_msg_rm_ring_cfg and @ ti_sci_msg_rm_ring_cfg_req for * more info . static int ti_sci_cmd_rm_ring_cfg(const struct ti_sci_handle *handle,const struct ti_sci_msg_rm_ring_cfg *params)struct ti_sci_msg_rm_ring_cfg_req *req;struct ti_sci_msg_hdr *resp;struct ti_sci_xfer *xfer;struct ti_sci_info *info;struct device *dev;int ret = 0 ;if (IS_ERR_OR_NULL(handle))return -EINVAL;sizeof (*req), sizeof (*resp));if (IS_ERR(xfer)) {"RM_RA:Message config failed(%d)\n" , ret);return ret;struct ti_sci_msg_rm_ring_cfg_req *)xfer->xfer_buf;if (ret) {"RM_RA:Mbox config send fail %d\n" , ret);goto fail;struct ti_sci_msg_hdr *)xfer->xfer_buf;0 : -EINVAL;"RM_RA:config ring %u ret:%d\n" , params->index, ret);return ret;/** * ti_sci_cmd_rm_psil_pair ( ) - Pair PSI - L source to destination thread * @ handle : Pointer to TI SCI handle . * @ nav_id : Device ID of Navigator Subsystem which should be used for * pairing * @ src_thread : Source PSI - L thread ID * @ dst_thread : Destination PSI - L thread ID * * Return : 0 if all went well , else returns appropriate error value . static int ti_sci_cmd_rm_psil_pair(const struct ti_sci_handle *handle,struct ti_sci_msg_psil_pair *req;struct ti_sci_msg_hdr *resp;struct ti_sci_xfer *xfer;struct ti_sci_info *info;struct device *dev;int ret = 0 ;if (IS_ERR(handle))return PTR_ERR(handle);if (!handle)return -EINVAL;sizeof (*req), sizeof (*resp));if (IS_ERR(xfer)) {"RM_PSIL:Message reconfig failed(%d)\n" , ret);return ret;struct ti_sci_msg_psil_pair *)xfer->xfer_buf;if (ret) {"RM_PSIL:Mbox send fail %d\n" , ret);goto fail;struct ti_sci_msg_hdr *)xfer->xfer_buf;0 : -EINVAL;return ret;/** * ti_sci_cmd_rm_psil_unpair ( ) - Unpair PSI - L source from destination thread * @ handle : Pointer to TI SCI handle . * @ nav_id : Device ID of Navigator Subsystem which should be used for * unpairing * @ src_thread : Source PSI - L thread ID * @ dst_thread : Destination PSI - L thread ID * * Return : 0 if all went well , else returns appropriate error value . static int ti_sci_cmd_rm_psil_unpair(const struct ti_sci_handle *handle,struct ti_sci_msg_psil_unpair *req;struct ti_sci_msg_hdr *resp;struct ti_sci_xfer *xfer;struct ti_sci_info *info;struct device *dev;int ret = 0 ;if (IS_ERR(handle))return PTR_ERR(handle);if (!handle)return -EINVAL;sizeof (*req), sizeof (*resp));if (IS_ERR(xfer)) {"RM_PSIL:Message reconfig failed(%d)\n" , ret);return ret;struct ti_sci_msg_psil_unpair *)xfer->xfer_buf;if (ret) {"RM_PSIL:Mbox send fail %d\n" , ret);goto fail;struct ti_sci_msg_hdr *)xfer->xfer_buf;0 : -EINVAL;return ret;/** * ti_sci_cmd_rm_udmap_tx_ch_cfg ( ) - Configure a UDMAP TX channel * @ handle : Pointer to TI SCI handle . * @ params : Pointer to ti_sci_msg_rm_udmap_tx_ch_cfg TX channel config * structure * * Return : 0 if all went well , else returns appropriate error value . * * See @ ti_sci_msg_rm_udmap_tx_ch_cfg and @ ti_sci_msg_rm_udmap_tx_ch_cfg_req for * more info . static int ti_sci_cmd_rm_udmap_tx_ch_cfg(const struct ti_sci_handle *handle,const struct ti_sci_msg_rm_udmap_tx_ch_cfg *params)struct ti_sci_msg_rm_udmap_tx_ch_cfg_req *req;struct ti_sci_msg_hdr *resp;struct ti_sci_xfer *xfer;struct ti_sci_info *info;struct device *dev;int ret = 0 ;if (IS_ERR_OR_NULL(handle))return -EINVAL;sizeof (*req), sizeof (*resp));if (IS_ERR(xfer)) {"Message TX_CH_CFG alloc failed(%d)\n" , ret);return ret;struct ti_sci_msg_rm_udmap_tx_ch_cfg_req *)xfer->xfer_buf;if (ret) {"Mbox send TX_CH_CFG fail %d\n" , ret);goto fail;struct ti_sci_msg_hdr *)xfer->xfer_buf;0 : -EINVAL;"TX_CH_CFG: chn %u ret:%u\n" , params->index, ret);return ret;/** * ti_sci_cmd_rm_udmap_rx_ch_cfg ( ) - Configure a UDMAP RX channel * @ handle : Pointer to TI SCI handle . * @ params : Pointer to ti_sci_msg_rm_udmap_rx_ch_cfg RX channel config * structure * * Return : 0 if all went well , else returns appropriate error value . * * See @ ti_sci_msg_rm_udmap_rx_ch_cfg and @ ti_sci_msg_rm_udmap_rx_ch_cfg_req for * more info . static int ti_sci_cmd_rm_udmap_rx_ch_cfg(const struct ti_sci_handle *handle,const struct ti_sci_msg_rm_udmap_rx_ch_cfg *params)struct ti_sci_msg_rm_udmap_rx_ch_cfg_req *req;struct ti_sci_msg_hdr *resp;struct ti_sci_xfer *xfer;struct ti_sci_info *info;struct device *dev;int ret = 0 ;if (IS_ERR_OR_NULL(handle))return -EINVAL;sizeof (*req), sizeof (*resp));if (IS_ERR(xfer)) {"Message RX_CH_CFG alloc failed(%d)\n" , ret);return ret;struct ti_sci_msg_rm_udmap_rx_ch_cfg_req *)xfer->xfer_buf;if (ret) {"Mbox send RX_CH_CFG fail %d\n" , ret);goto fail;struct ti_sci_msg_hdr *)xfer->xfer_buf;0 : -EINVAL;"RX_CH_CFG: chn %u ret:%d\n" , params->index, ret);return ret;/** * ti_sci_cmd_rm_udmap_rx_flow_cfg ( ) - Configure UDMAP RX FLOW * @ handle : Pointer to TI SCI handle . * @ params : Pointer to ti_sci_msg_rm_udmap_flow_cfg RX FLOW config * structure * * Return : 0 if all went well , else returns appropriate error value . * * See @ ti_sci_msg_rm_udmap_flow_cfg and @ ti_sci_msg_rm_udmap_flow_cfg_req for * more info . static int ti_sci_cmd_rm_udmap_rx_flow_cfg(const struct ti_sci_handle *handle,const struct ti_sci_msg_rm_udmap_flow_cfg *params)struct ti_sci_msg_rm_udmap_flow_cfg_req *req;struct ti_sci_msg_hdr *resp;struct ti_sci_xfer *xfer;struct ti_sci_info *info;struct device *dev;int ret = 0 ;if (IS_ERR_OR_NULL(handle))return -EINVAL;sizeof (*req), sizeof (*resp));if (IS_ERR(xfer)) {"RX_FL_CFG: Message alloc failed(%d)\n" , ret);return ret;struct ti_sci_msg_rm_udmap_flow_cfg_req *)xfer->xfer_buf;if (ret) {"RX_FL_CFG: Mbox send fail %d\n" , ret);goto fail;struct ti_sci_msg_hdr *)xfer->xfer_buf;0 : -EINVAL;"RX_FL_CFG: %u ret:%d\n" , params->flow_index, ret);return ret;/** * ti_sci_cmd_proc_request ( ) - Command to request a physical processor control * @ handle : Pointer to TI SCI handle * @ proc_id : Processor ID this request is for * * Return : 0 if all went well , else returns appropriate error value . static int ti_sci_cmd_proc_request(const struct ti_sci_handle *handle,struct ti_sci_msg_req_proc_request *req;struct ti_sci_msg_hdr *resp;struct ti_sci_info *info;struct ti_sci_xfer *xfer;struct device *dev;int ret = 0 ;if (!handle)return -EINVAL;if (IS_ERR(handle))return PTR_ERR(handle);sizeof (*req), sizeof (*resp));if (IS_ERR(xfer)) {"Message alloc failed(%d)\n" , ret);return ret;struct ti_sci_msg_req_proc_request *)xfer->xfer_buf;if (ret) {"Mbox send fail %d\n" , ret);goto fail;struct ti_sci_msg_hdr *)xfer->tx_message.buf;0 : -ENODEV;return ret;/** * ti_sci_cmd_proc_release ( ) - Command to release a physical processor control * @ handle : Pointer to TI SCI handle * @ proc_id : Processor ID this request is for * * Return : 0 if all went well , else returns appropriate error value . static int ti_sci_cmd_proc_release(const struct ti_sci_handle *handle,struct ti_sci_msg_req_proc_release *req;struct ti_sci_msg_hdr *resp;struct ti_sci_info *info;struct ti_sci_xfer *xfer;struct device *dev;int ret = 0 ;if (!handle)return -EINVAL;if (IS_ERR(handle))return PTR_ERR(handle);sizeof (*req), sizeof (*resp));if (IS_ERR(xfer)) {"Message alloc failed(%d)\n" , ret);return ret;struct ti_sci_msg_req_proc_release *)xfer->xfer_buf;if (ret) {"Mbox send fail %d\n" , ret);goto fail;struct ti_sci_msg_hdr *)xfer->tx_message.buf;0 : -ENODEV;return ret;/** * ti_sci_cmd_proc_handover ( ) - Command to handover a physical processor * control to a host in the processor ' s access * control list . * @ handle : Pointer to TI SCI handle * @ proc_id : Processor ID this request is for * @ host_id : Host ID to get the control of the processor * * Return : 0 if all went well , else returns appropriate error value . static int ti_sci_cmd_proc_handover(const struct ti_sci_handle *handle,struct ti_sci_msg_req_proc_handover *req;struct ti_sci_msg_hdr *resp;struct ti_sci_info *info;struct ti_sci_xfer *xfer;struct device *dev;int ret = 0 ;if (!handle)return -EINVAL;if (IS_ERR(handle))return PTR_ERR(handle);sizeof (*req), sizeof (*resp));if (IS_ERR(xfer)) {"Message alloc failed(%d)\n" , ret);return ret;struct ti_sci_msg_req_proc_handover *)xfer->xfer_buf;if (ret) {"Mbox send fail %d\n" , ret);goto fail;struct ti_sci_msg_hdr *)xfer->tx_message.buf;0 : -ENODEV;return ret;/** * ti_sci_cmd_proc_set_config ( ) - Command to set the processor boot * configuration flags * @ handle : Pointer to TI SCI handle * @ proc_id : Processor ID this request is for * @ bootvector : Processor Boot vector ( start address ) * @ config_flags_set : Configuration flags to be set * @ config_flags_clear : Configuration flags to be cleared . * * Return : 0 if all went well , else returns appropriate error value . static int ti_sci_cmd_proc_set_config(const struct ti_sci_handle *handle,struct ti_sci_msg_req_set_config *req;struct ti_sci_msg_hdr *resp;struct ti_sci_info *info;struct ti_sci_xfer *xfer;struct device *dev;int ret = 0 ;if (!handle)return -EINVAL;if (IS_ERR(handle))return PTR_ERR(handle);sizeof (*req), sizeof (*resp));if (IS_ERR(xfer)) {"Message alloc failed(%d)\n" , ret);return ret;struct ti_sci_msg_req_set_config *)xfer->xfer_buf;if (ret) {"Mbox send fail %d\n" , ret);goto fail;struct ti_sci_msg_hdr *)xfer->tx_message.buf;0 : -ENODEV;return ret;/** * ti_sci_cmd_proc_set_control ( ) - Command to set the processor boot * control flags * @ handle : Pointer to TI SCI handle * @ proc_id : Processor ID this request is for * @ control_flags_set : Control flags to be set * @ control_flags_clear : Control flags to be cleared * * Return : 0 if all went well , else returns appropriate error value . static int ti_sci_cmd_proc_set_control(const struct ti_sci_handle *handle,struct ti_sci_msg_req_set_ctrl *req;struct ti_sci_msg_hdr *resp;struct ti_sci_info *info;struct ti_sci_xfer *xfer;struct device *dev;int ret = 0 ;if (!handle)return -EINVAL;if (IS_ERR(handle))return PTR_ERR(handle);sizeof (*req), sizeof (*resp));if (IS_ERR(xfer)) {"Message alloc failed(%d)\n" , ret);return ret;struct ti_sci_msg_req_set_ctrl *)xfer->xfer_buf;if (ret) {"Mbox send fail %d\n" , ret);goto fail;struct ti_sci_msg_hdr *)xfer->tx_message.buf;0 : -ENODEV;return ret;/** * ti_sci_cmd_proc_get_status ( ) - Command to get the processor boot status * @ handle : Pointer to TI SCI handle * @ proc_id : Processor ID this request is for * @ bv : Processor Boot vector ( start address ) * @ cfg_flags : Processor specific configuration flags * @ ctrl_flags : Processor specific control flags * @ sts_flags : Processor specific status flags * * Return : 0 if all went well , else returns appropriate error value . static int ti_sci_cmd_proc_get_status(const struct ti_sci_handle *handle,struct ti_sci_msg_resp_get_status *resp;struct ti_sci_msg_req_get_status *req;struct ti_sci_info *info;struct ti_sci_xfer *xfer;struct device *dev;int ret = 0 ;if (!handle)return -EINVAL;if (IS_ERR(handle))return PTR_ERR(handle);sizeof (*req), sizeof (*resp));if (IS_ERR(xfer)) {"Message alloc failed(%d)\n" , ret);return ret;struct ti_sci_msg_req_get_status *)xfer->xfer_buf;if (ret) {"Mbox send fail %d\n" , ret);goto fail;struct ti_sci_msg_resp_get_status *)xfer->tx_message.buf;if (!ti_sci_is_response_ack(resp)) {else {return ret;/* * ti_sci_setup_ops ( ) - Setup the operations structures * @ info : pointer to TISCI pointer static void ti_sci_setup_ops(struct ti_sci_info *info)struct ti_sci_ops *ops = &info->handle.ops;struct ti_sci_core_ops *core_ops = &ops->core_ops;struct ti_sci_dev_ops *dops = &ops->dev_ops;struct ti_sci_clk_ops *cops = &ops->clk_ops;struct ti_sci_pm_ops *pmops = &ops->pm_ops;struct ti_sci_rm_core_ops *rm_core_ops = &ops->rm_core_ops;struct ti_sci_rm_irq_ops *iops = &ops->rm_irq_ops;struct ti_sci_rm_ringacc_ops *rops = &ops->rm_ring_ops;struct ti_sci_rm_psil_ops *psilops = &ops->rm_psil_ops;struct ti_sci_rm_udmap_ops *udmap_ops = &ops->rm_udmap_ops;struct ti_sci_proc_ops *pops = &ops->proc_ops;if (info->fw_caps & MSG_FLAG_CAPS_LPM_DM_MANAGED) {"detected DM managed LPM in fw_caps\n" );/** * ti_sci_get_handle ( ) - Get the TI SCI handle for a device * @ dev : Pointer to device for which we want SCI handle * * NOTE : The function does not track individual clients of the framework * and is expected to be maintained by caller of TI SCI protocol library . * ti_sci_put_handle must be balanced with successful ti_sci_get_handle * Return : pointer to handle if successful , else : * - EPROBE_DEFER if the instance is not ready * - ENODEV if the required node handler is missing * - EINVAL if invalid conditions are encountered . const struct ti_sci_handle *ti_sci_get_handle(struct device *dev)struct device_node *ti_sci_np;struct ti_sci_handle *handle = NULL;struct ti_sci_info *info;if (!dev) {"I need a device pointer\n" );return ERR_PTR(-EINVAL);if (!ti_sci_np) {"No OF information\n" );return ERR_PTR(-EINVAL);if (ti_sci_np == info->dev->of_node) {break ;if (!handle)return ERR_PTR(-EPROBE_DEFER);return handle;/** * ti_sci_put_handle ( ) - Release the handle acquired by ti_sci_get_handle * @ handle : Handle acquired by ti_sci_get_handle * * NOTE : The function does not track individual clients of the framework * and is expected to be maintained by caller of TI SCI protocol library . * ti_sci_put_handle must be balanced with successful ti_sci_get_handle * * Return : 0 is successfully released * if an error pointer was passed , it returns the error value back , * if null was passed , it returns - EINVAL ; int ti_sci_put_handle(const struct ti_sci_handle *handle)struct ti_sci_info *info;if (IS_ERR(handle))return PTR_ERR(handle);if (!handle)return -EINVAL;if (!WARN_ON(!info->users))return 0 ;static void devm_ti_sci_release(struct device *dev, void *res)const struct ti_sci_handle **ptr = res;const struct ti_sci_handle *handle = *ptr;int ret;if (ret)"failed to put handle %d\n" , ret);/** * devm_ti_sci_get_handle ( ) - Managed get handle * @ dev : device for which we want SCI handle for . * * NOTE : This releases the handle once the device resources are * no longer needed . MUST NOT BE released with ti_sci_put_handle . * The function does not track individual clients of the framework * and is expected to be maintained by caller of TI SCI protocol library . * * Return : 0 if all went fine , else corresponding error . const struct ti_sci_handle *devm_ti_sci_get_handle(struct device *dev)const struct ti_sci_handle **ptr;const struct ti_sci_handle *handle;sizeof (*ptr), GFP_KERNEL);if (!ptr)return ERR_PTR(-ENOMEM);if (!IS_ERR(handle)) {else {return handle;/** * ti_sci_get_by_phandle ( ) - Get the TI SCI handle using DT phandle * @ np : device node * @ property : property name containing phandle on TISCI node * * NOTE : The function does not track individual clients of the framework * and is expected to be maintained by caller of TI SCI protocol library . * ti_sci_put_handle must be balanced with successful ti_sci_get_by_phandle * Return : pointer to handle if successful , else : * - EPROBE_DEFER if the instance is not ready * - ENODEV if the required node handler is missing * - EINVAL if invalid conditions are encountered . const struct ti_sci_handle *ti_sci_get_by_phandle(struct device_node *np,const char *property)struct ti_sci_handle *handle = NULL;struct device_node *ti_sci_np;struct ti_sci_info *info;if (!np) {"I need a device pointer\n" );return ERR_PTR(-EINVAL);0 );if (!ti_sci_np)return ERR_PTR(-ENODEV);if (ti_sci_np == info->dev->of_node) {break ;if (!handle)return ERR_PTR(-EPROBE_DEFER);return handle;/** * devm_ti_sci_get_by_phandle ( ) - Managed get handle using phandle * @ dev : Device pointer requesting TISCI handle * @ property : property name containing phandle on TISCI node * * NOTE : This releases the handle once the device resources are * no longer needed . MUST NOT BE released with ti_sci_put_handle . * The function does not track individual clients of the framework * and is expected to be maintained by caller of TI SCI protocol library . * * Return : 0 if all went fine , else corresponding error . const struct ti_sci_handle *devm_ti_sci_get_by_phandle(struct device *dev,const char *property)const struct ti_sci_handle *handle;const struct ti_sci_handle **ptr;sizeof (*ptr), GFP_KERNEL);if (!ptr)return ERR_PTR(-ENOMEM);if (!IS_ERR(handle)) {else {return handle;/** * ti_sci_get_free_resource ( ) - Get a free resource from TISCI resource . * @ res : Pointer to the TISCI resource * * Return : resource num if all went ok else TI_SCI_RESOURCE_NULL . struct ti_sci_resource *res)unsigned long flags;for (set = 0 ; set < res->sets; set++) {struct ti_sci_resource_desc *desc = &res->desc[set];int res_count = desc->num + desc->num_sec;if (free_bit != res_count) {if (desc->num && free_bit < desc->num)return desc->start + free_bit;else return desc->start_sec + free_bit;return TI_SCI_RESOURCE_NULL;/** * ti_sci_release_resource ( ) - Release a resource from TISCI resource . * @ res : Pointer to the TISCI resource * @ id : Resource id to be released . void ti_sci_release_resource(struct ti_sci_resource *res, u16 id)unsigned long flags;for (set = 0 ; set < res->sets; set++) {struct ti_sci_resource_desc *desc = &res->desc[set];if (desc->num && desc->start <= id &&else if (desc->num_sec && desc->start_sec <= id &&/** * ti_sci_get_num_resources ( ) - Get the number of resources in TISCI resource * @ res : Pointer to the TISCI resource * * Return : Total number of available resources . struct ti_sci_resource *res)0 ;for (set = 0 ; set < res->sets; set++)return count;/** * devm_ti_sci_get_resource_sets ( ) - Get a TISCI resources assigned to a device * @ handle : TISCI handle * @ dev : Device pointer to which the resource is assigned * @ dev_id : TISCI device id to which the resource is assigned * @ sub_types : Array of sub_types assigned corresponding to device * @ sets : Number of sub_types * * Return : Pointer to ti_sci_resource if all went well else appropriate * error pointer . static struct ti_sci_resource *const struct ti_sci_handle *handle,struct device *dev, u32 dev_id, u32 *sub_types,struct ti_sci_resource *res;bool valid_set = false ;int i, ret, res_count;sizeof (*res), GFP_KERNEL);if (!res)return ERR_PTR(-ENOMEM);sizeof (*res->desc),if (!res->desc)return ERR_PTR(-ENOMEM);for (i = 0 ; i < res->sets; i++) {if (ret) {"dev = %d subtype %d not allocated for this host\n" ,0 , sizeof (res->desc[i]));continue ;"dev/sub_type: %d/%d, start/num: %d/%d | %d/%d\n" ,true ;if (!res->desc[i].res_map)return ERR_PTR(-ENOMEM);if (valid_set)return res;return ERR_PTR(-EINVAL);/** * devm_ti_sci_get_of_resource ( ) - Get a TISCI resource assigned to a device * @ handle : TISCI handle * @ dev : Device pointer to which the resource is assigned * @ dev_id : TISCI device id to which the resource is assigned * @ of_prop : property name by which the resource are represented * * Return : Pointer to ti_sci_resource if all went well else appropriate * error pointer . struct ti_sci_resource *const struct ti_sci_handle *handle,struct device *dev, u32 dev_id, char *of_prop)struct ti_sci_resource *res;int sets;sizeof (u32));if (sets < 0 ) {"%s resource type ids not available\n" , of_prop);return ERR_PTR(sets);sizeof (*sub_types), GFP_KERNEL);if (!sub_types)return ERR_PTR(-ENOMEM);return res;/** * devm_ti_sci_get_resource ( ) - Get a resource range assigned to the device * @ handle : TISCI handle * @ dev : Device pointer to which the resource is assigned * @ dev_id : TISCI device id to which the resource is assigned * @ sub_type : TISCI resource subytpe representing the resource . * * Return : Pointer to ti_sci_resource if all went well else appropriate * error pointer . struct ti_sci_resource *const struct ti_sci_handle *handle, struct device *dev,return devm_ti_sci_get_resource_sets(handle, dev, dev_id, &sub_type, 1 );static int tisci_reboot_handler(struct sys_off_data *data)struct ti_sci_info *info = data->cb_data;const struct ti_sci_handle *handle = &info->handle;/* call fail OR pass, we should not be here in the first place */ return NOTIFY_BAD;static int ti_sci_prepare_system_suspend(struct ti_sci_info *info)/* * Map and validate the target Linux suspend state to TISCI LPM . * Default is to let Device Manager select the low power mode . switch (pm_suspend_target_state) {case PM_SUSPEND_MEM:if (info->fw_caps & MSG_FLAG_CAPS_LPM_DM_MANAGED) {/* * For the DM_MANAGED mode the context is reserved for * internal use and can be 0 return ti_sci_cmd_prepare_sleep(&info->handle,0 , 0 , 0 );else {/* DM Managed is not supported by the firmware. */ "Suspend to memory is not supported by the firmware\n" );return -EOPNOTSUPP;break ;default :/* * Do not fail if we don ' t have action to take for a * specific suspend mode . return 0 ;static int __maybe_unused ti_sci_suspend(struct device *dev)struct ti_sci_info *info = dev_get_drvdata(dev);struct device *cpu_dev, *cpu_dev_max = NULL;0 ;int i, ret;if (info->fw_caps & MSG_FLAG_CAPS_LPM_DM_MANAGED) {if (val != PM_QOS_RESUME_LATENCY_NO_CONSTRAINT) {if (cpu_dev_max) {/* * PM QoS latency unit is usecs , device manager uses msecs . * Convert to msecs and round down for device manager . "%s: sending max CPU latency=%u ms\n" , __func__,if (ret)return ret;if (ret)return ret;return 0 ;static int __maybe_unused ti_sci_suspend_noirq(struct device *dev)struct ti_sci_info *info = dev_get_drvdata(dev);int ret = 0 ;if (ret)return ret;return 0 ;static int __maybe_unused ti_sci_resume_noirq(struct device *dev)struct ti_sci_info *info = dev_get_drvdata(dev);int ret = 0 ;if (ret)return ret;/* Do not fail to resume on error as the wake reason is not critical */ if (!ret)"ti_sci: wakeup source:0x%x, pin:0x%x, mode:0x%x\n" ,return 0 ;static void __maybe_unused ti_sci_pm_complete(struct device *dev)struct ti_sci_info *info = dev_get_drvdata(dev);if (info->fw_caps & MSG_FLAG_CAPS_LPM_ABORT) {if (ti_sci_cmd_lpm_abort(dev))"LPM clear selection failed.\n" );static const struct dev_pm_ops ti_sci_pm_ops = {#ifdef CONFIG_PM_SLEEP#endif /* Description for K2G */ static const struct ti_sci_desc ti_sci_pmmc_k2g_desc = {2 ,/* Conservative duration */ 1000 ,/* Limited by MBOX_TX_QUEUE_LEN. K2G can handle upto 128 messages! */ 20 ,64 ,/* Description for AM654 */ static const struct ti_sci_desc ti_sci_pmmc_am654_desc = {12 ,/* Conservative duration */ 10000 ,/* Limited by MBOX_TX_QUEUE_LEN. K2G can handle upto 128 messages! */ 20 ,60 ,static const struct of_device_id ti_sci_of_match[] = {"ti,k2g-sci" , .data = &ti_sci_pmmc_k2g_desc},"ti,am654-sci" , .data = &ti_sci_pmmc_am654_desc},/* Sentinel */ }, static int ti_sci_probe(struct platform_device *pdev)struct device *dev = &pdev->dev;const struct ti_sci_desc *desc;struct ti_sci_xfer *xfer;struct ti_sci_info *info = NULL;struct ti_sci_xfers_info *minfo;struct mbox_client *cl;int ret = -EINVAL;int i;sizeof (*info), GFP_KERNEL);if (!info)return -ENOMEM;"ti,host-id" , &h_id);/* if the property is not present in DT, use a default from desc */ if (ret < 0 ) {else {if (!h_id) {"Host ID 0 is reserved for firmware\n" );else {/* * Pre - allocate messages * NEVER allocate more than what we can indicate in hdr . seq * if we have data description bug , force a fix . . if (WARN_ON(desc->max_msgs >=1 << 8 * sizeof (((struct ti_sci_msg_hdr *)0 )->seq)))return -EINVAL;sizeof (*minfo->xfer_block),if (!minfo->xfer_block)return -ENOMEM;if (!minfo->xfer_alloc_table)return -ENOMEM;/* Pre-initialize the buffer pointer to pre-allocated buffers */ for (i = 0 , xfer = minfo->xfer_block; i < desc->max_msgs; i++, xfer++) {1 , desc->max_msg_size,if (!xfer->xfer_buf)return -ENOMEM;if (ret)"Failed to create debug file\n" );false ;true ;"rx" );if (IS_ERR(info->chan_rx)) {goto out;"tx" );if (IS_ERR(info->chan_tx)) {goto out;if (ret) {"Unable to communicate with TISCI(%d)\n" , ret);goto out;"Detected firmware capabilities: %s%s%s%s\n" ,"Generic" : "" ," Partial-IO" : "" ," DM-Managed" : "" ," LPM-Abort" : "" if (ret) {"reboot registration fail(%d)\n" , ret);goto out;"ABI: %d.%d (firmware rev 0x%04x '%s')\n" ,return of_platform_populate(dev->of_node, NULL, NULL, dev);if (!IS_ERR(info->chan_tx))if (!IS_ERR(info->chan_rx))return ret;static struct platform_driver ti_sci_driver = {"ti-sci" ,true ,"GPL v2" );"TI System Control Interface(SCI) driver" );"Nishanth Menon" );"platform:ti-sci" );
Messung V0.5 in Prozent C=97 H=95 G=95
¤ Dauer der Verarbeitung: 0.144 Sekunden
(vorverarbeitet am 2026-09-27)
¤ *© Formatika GbR, Deutschland
