1 // SPDX-License-Identifier: GPL-2.0
3 * Xilinx Zynq MPSoC Power Management
5 * Copyright (C) 2014-2019 Xilinx, Inc.
12 #include <linux/mailbox_client.h>
13 #include <linux/module.h>
14 #include <linux/platform_device.h>
15 #include <linux/reboot.h>
16 #include <linux/suspend.h>
18 #include <linux/firmware/xlnx-zynqmp.h>
19 #include <linux/firmware/xlnx-event-manager.h>
20 #include <linux/mailbox/zynqmp-ipi-message.h>
23 * struct zynqmp_pm_work_struct - Wrapper for struct work_struct
24 * @callback_work: Work structure
25 * @args: Callback arguments
27 struct zynqmp_pm_work_struct {
28 struct work_struct callback_work;
32 static struct zynqmp_pm_work_struct *zynqmp_pm_init_suspend_work;
33 static struct mbox_chan *rx_chan;
34 static bool event_registered;
36 enum pm_suspend_mode {
37 PM_SUSPEND_MODE_FIRST = 0,
38 PM_SUSPEND_MODE_STD = PM_SUSPEND_MODE_FIRST,
39 PM_SUSPEND_MODE_POWER_OFF,
42 #define PM_SUSPEND_MODE_FIRST PM_SUSPEND_MODE_STD
44 static const char *const suspend_modes[] = {
45 [PM_SUSPEND_MODE_STD] = "standard",
46 [PM_SUSPEND_MODE_POWER_OFF] = "power-off",
49 static enum pm_suspend_mode suspend_mode = PM_SUSPEND_MODE_STD;
51 static void zynqmp_pm_get_callback_data(u32 *buf)
53 zynqmp_pm_invoke_fn(GET_CALLBACK_DATA, 0, 0, 0, 0, buf);
56 static void suspend_event_callback(const u32 *payload, void *data)
58 /* First element is callback API ID, others are callback arguments */
59 if (work_pending(&zynqmp_pm_init_suspend_work->callback_work))
62 /* Copy callback arguments into work's structure */
63 memcpy(zynqmp_pm_init_suspend_work->args, &payload[1],
64 sizeof(zynqmp_pm_init_suspend_work->args));
66 queue_work(system_unbound_wq, &zynqmp_pm_init_suspend_work->callback_work);
69 static irqreturn_t zynqmp_pm_isr(int irq, void *data)
71 u32 payload[CB_PAYLOAD_SIZE];
73 zynqmp_pm_get_callback_data(payload);
75 /* First element is callback API ID, others are callback arguments */
76 if (payload[0] == PM_INIT_SUSPEND_CB) {
78 case SUSPEND_SYSTEM_SHUTDOWN:
79 orderly_poweroff(true);
81 case SUSPEND_POWER_REQUEST:
82 pm_suspend(PM_SUSPEND_MEM);
85 pr_err("%s Unsupported InitSuspendCb reason "
86 "code %d\n", __func__, payload[1]);
93 static void ipi_receive_callback(struct mbox_client *cl, void *data)
95 struct zynqmp_ipi_message *msg = (struct zynqmp_ipi_message *)data;
96 u32 payload[CB_PAYLOAD_SIZE];
99 memcpy(payload, msg->data, sizeof(msg->len));
100 /* First element is callback API ID, others are callback arguments */
101 if (payload[0] == PM_INIT_SUSPEND_CB) {
102 if (work_pending(&zynqmp_pm_init_suspend_work->callback_work))
105 /* Copy callback arguments into work's structure */
106 memcpy(zynqmp_pm_init_suspend_work->args, &payload[1],
107 sizeof(zynqmp_pm_init_suspend_work->args));
109 queue_work(system_unbound_wq,
110 &zynqmp_pm_init_suspend_work->callback_work);
112 /* Send NULL message to mbox controller to ack the message */
113 ret = mbox_send_message(rx_chan, NULL);
115 pr_err("IPI ack failed. Error %d\n", ret);
120 * zynqmp_pm_init_suspend_work_fn - Initialize suspend
121 * @work: Pointer to work_struct
123 * Bottom-half of PM callback IRQ handler.
125 static void zynqmp_pm_init_suspend_work_fn(struct work_struct *work)
127 struct zynqmp_pm_work_struct *pm_work =
128 container_of(work, struct zynqmp_pm_work_struct, callback_work);
130 if (pm_work->args[0] == SUSPEND_SYSTEM_SHUTDOWN) {
131 orderly_poweroff(true);
132 } else if (pm_work->args[0] == SUSPEND_POWER_REQUEST) {
133 pm_suspend(PM_SUSPEND_MEM);
135 pr_err("%s Unsupported InitSuspendCb reason code %d.\n",
136 __func__, pm_work->args[0]);
140 static ssize_t suspend_mode_show(struct device *dev,
141 struct device_attribute *attr, char *buf)
146 for (md = PM_SUSPEND_MODE_FIRST; md < ARRAY_SIZE(suspend_modes); md++)
147 if (suspend_modes[md]) {
148 if (md == suspend_mode)
149 s += sprintf(s, "[%s] ", suspend_modes[md]);
151 s += sprintf(s, "%s ", suspend_modes[md]);
154 /* Convert last space to newline */
160 static ssize_t suspend_mode_store(struct device *dev,
161 struct device_attribute *attr,
162 const char *buf, size_t count)
164 int md, ret = -EINVAL;
166 for (md = PM_SUSPEND_MODE_FIRST; md < ARRAY_SIZE(suspend_modes); md++)
167 if (suspend_modes[md] &&
168 sysfs_streq(suspend_modes[md], buf)) {
173 if (!ret && md != suspend_mode) {
174 ret = zynqmp_pm_set_suspend_mode(md);
179 return ret ? ret : count;
182 static DEVICE_ATTR_RW(suspend_mode);
184 static int zynqmp_pm_probe(struct platform_device *pdev)
188 struct mbox_client *client;
190 zynqmp_pm_get_api_version(&pm_api_version);
192 /* Check PM API version number */
193 if (pm_api_version < ZYNQMP_PM_VERSION)
197 * First try to use Xilinx Event Manager by registering suspend_event_callback
198 * for suspend/shutdown event.
199 * If xlnx_register_event() returns -EACCES (Xilinx Event Manager
200 * is not available to use) or -ENODEV(Xilinx Event Manager not compiled),
201 * then use ipi-mailbox or interrupt method.
203 ret = xlnx_register_event(PM_INIT_SUSPEND_CB, 0, 0, false,
204 suspend_event_callback, NULL);
206 zynqmp_pm_init_suspend_work = devm_kzalloc(&pdev->dev,
207 sizeof(struct zynqmp_pm_work_struct),
209 if (!zynqmp_pm_init_suspend_work) {
210 xlnx_unregister_event(PM_INIT_SUSPEND_CB, 0, 0,
211 suspend_event_callback, NULL);
214 event_registered = true;
216 INIT_WORK(&zynqmp_pm_init_suspend_work->callback_work,
217 zynqmp_pm_init_suspend_work_fn);
218 } else if (ret != -EACCES && ret != -ENODEV) {
219 dev_err(&pdev->dev, "Failed to Register with Xilinx Event manager %d\n", ret);
221 } else if (of_find_property(pdev->dev.of_node, "mboxes", NULL)) {
222 zynqmp_pm_init_suspend_work =
223 devm_kzalloc(&pdev->dev,
224 sizeof(struct zynqmp_pm_work_struct),
226 if (!zynqmp_pm_init_suspend_work)
229 INIT_WORK(&zynqmp_pm_init_suspend_work->callback_work,
230 zynqmp_pm_init_suspend_work_fn);
231 client = devm_kzalloc(&pdev->dev, sizeof(*client), GFP_KERNEL);
235 client->dev = &pdev->dev;
236 client->rx_callback = ipi_receive_callback;
238 rx_chan = mbox_request_channel_byname(client, "rx");
239 if (IS_ERR(rx_chan)) {
240 dev_err(&pdev->dev, "Failed to request rx channel\n");
241 return PTR_ERR(rx_chan);
243 } else if (of_find_property(pdev->dev.of_node, "interrupts", NULL)) {
244 irq = platform_get_irq(pdev, 0);
248 ret = devm_request_threaded_irq(&pdev->dev, irq, NULL,
250 IRQF_NO_SUSPEND | IRQF_ONESHOT,
251 dev_name(&pdev->dev),
254 dev_err(&pdev->dev, "devm_request_threaded_irq '%d' "
255 "failed with %d\n", irq, ret);
259 dev_err(&pdev->dev, "Required property not found in DT node\n");
263 ret = sysfs_create_file(&pdev->dev.kobj, &dev_attr_suspend_mode.attr);
265 if (event_registered) {
266 xlnx_unregister_event(PM_INIT_SUSPEND_CB, 0, 0, suspend_event_callback,
268 event_registered = false;
270 dev_err(&pdev->dev, "unable to create sysfs interface\n");
277 static int zynqmp_pm_remove(struct platform_device *pdev)
279 sysfs_remove_file(&pdev->dev.kobj, &dev_attr_suspend_mode.attr);
280 if (event_registered)
281 xlnx_unregister_event(PM_INIT_SUSPEND_CB, 0, 0, suspend_event_callback, NULL);
284 mbox_free_channel(rx_chan);
289 static const struct of_device_id pm_of_match[] = {
290 { .compatible = "xlnx,zynqmp-power", },
291 { /* end of table */ },
293 MODULE_DEVICE_TABLE(of, pm_of_match);
295 static struct platform_driver zynqmp_pm_platform_driver = {
296 .probe = zynqmp_pm_probe,
297 .remove = zynqmp_pm_remove,
299 .name = "zynqmp_power",
300 .of_match_table = pm_of_match,
303 module_platform_driver(zynqmp_pm_platform_driver);