1 // SPDX-License-Identifier: GPL-2.0
3 * Xilinx Zynq MPSoC Firmware driver
5 * Copyright (C) 2018-2019 Xilinx, Inc.
10 #include <dm/device_compat.h>
13 #include <zynqmp_firmware.h>
14 #include <asm/cache.h>
15 #include <asm/ptrace.h>
17 #if defined(CONFIG_ZYNQMP_IPI)
19 #include <asm/arch/sys_proto.h>
21 #define PMUFW_PAYLOAD_ARG_CNT 8
23 #define XST_PM_NO_ACCESS 2002L
24 #define XST_PM_ALREADY_CONFIGURED 2009L
26 static struct zynqmp_power {
27 struct mbox_chan tx_chan;
28 struct mbox_chan rx_chan;
29 } zynqmp_power __section(".data");
31 #define NODE_ID_LOCATION 5
33 static unsigned int xpm_configobject[] = {
34 /**********************************************************************/
36 2, /* Number of remaining words in the header */
37 1, /* Number of sections included in config object */
38 PM_CONFIG_OBJECT_TYPE_OVERLAY, /* Type of Config object as overlay */
39 /**********************************************************************/
42 PM_CONFIG_SLAVE_SECTION_ID, /* Section ID */
43 1, /* Number of slaves */
45 0, /* Node ID which will be changed below */
46 PM_SLAVE_FLAG_IS_SHAREABLE,
47 PM_CONFIG_IPI_PSU_CORTEXA53_0_MASK |
48 PM_CONFIG_IPI_PSU_CORTEXR5_0_MASK |
49 PM_CONFIG_IPI_PSU_CORTEXR5_1_MASK, /* IPI Mask */
52 static unsigned int xpm_configobject_close[] = {
53 /**********************************************************************/
55 2, /* Number of remaining words in the header */
56 1, /* Number of sections included in config object */
57 PM_CONFIG_OBJECT_TYPE_OVERLAY, /* Type of Config object as overlay */
58 /**********************************************************************/
59 /* SET CONFIG SECTION */
60 PM_CONFIG_SET_CONFIG_SECTION_ID,
61 0U, /* Loading permission to Overlay config object */
64 int zynqmp_pmufw_config_close(void)
66 return zynqmp_pmufw_load_config_object(xpm_configobject_close,
67 sizeof(xpm_configobject_close));
70 int zynqmp_pmufw_node(u32 id)
72 static bool check = true;
73 static bool permission = true;
78 if (zynqmp_pmufw_node(NODE_OCM_BANK_0) == -EACCES) {
79 printf("PMUFW: No permission to change config object\n");
87 /* Record power domain id */
88 xpm_configobject[NODE_ID_LOCATION] = id;
90 return zynqmp_pmufw_load_config_object(xpm_configobject,
91 sizeof(xpm_configobject));
94 static int do_pm_probe(void)
99 ret = uclass_get_device_by_driver(UCLASS_FIRMWARE,
100 DM_DRIVER_GET(zynqmp_power),
103 debug("%s: Probing device failed: %d\n", __func__, ret);
108 static int ipi_req(const u32 *req, size_t req_len, u32 *res, size_t res_maxlen)
110 struct zynqmp_ipi_msg msg;
112 u32 buffer[PAYLOAD_ARG_CNT];
117 if (req_len > PMUFW_PAYLOAD_ARG_CNT ||
118 res_maxlen > PMUFW_PAYLOAD_ARG_CNT)
121 if (!(zynqmp_power.tx_chan.dev) || !(zynqmp_power.rx_chan.dev)) {
127 debug("%s, Sending IPI message with ID: 0x%0x\n", __func__, req[0]);
128 msg.buf = (u32 *)req;
130 ret = mbox_send(&zynqmp_power.tx_chan, &msg);
132 debug("%s: Sending message failed\n", __func__);
137 msg.len = res_maxlen;
138 ret = mbox_recv(&zynqmp_power.rx_chan, &msg, 100);
140 debug("%s: Receiving message failed\n", __func__);
145 unsigned int zynqmp_firmware_version(void)
148 u32 ret_payload[PAYLOAD_ARG_CNT];
149 static u32 pm_api_version = ZYNQMP_PM_VERSION_INVALID;
152 * Get PMU version only once and later
153 * just return stored values instead of
154 * asking PMUFW again.
156 if (pm_api_version == ZYNQMP_PM_VERSION_INVALID) {
158 ret = xilinx_pm_request(PM_GET_API_VERSION, 0, 0, 0, 0,
161 panic("PMUFW is not found - Please load it!\n");
163 pm_api_version = ret_payload[1];
164 if (pm_api_version < ZYNQMP_PM_VERSION)
165 panic("PMUFW version error. Expected: v%d.%d\n",
166 ZYNQMP_PM_VERSION_MAJOR, ZYNQMP_PM_VERSION_MINOR);
169 return pm_api_version;
172 int zynqmp_pm_set_gem_config(u32 node, enum pm_gem_config_type config, u32 value)
176 ret = xilinx_pm_request(PM_IOCTL, node, IOCTL_SET_GEM_CONFIG,
177 config, value, NULL);
179 printf("%s: node %d: set_gem_config %d failed\n",
180 __func__, node, config);
185 int zynqmp_pm_set_sd_config(u32 node, enum pm_sd_config_type config, u32 value)
189 ret = xilinx_pm_request(PM_IOCTL, node, IOCTL_SET_SD_CONFIG,
190 config, value, NULL);
192 printf("%s: node %d: set_sd_config %d failed\n",
193 __func__, node, config);
198 int zynqmp_pm_feature(const u32 api_id)
201 u32 ret_payload[PAYLOAD_ARG_CNT];
203 /* Check feature check API version */
204 ret = xilinx_pm_request(PM_FEATURE_CHECK, api_id, 0, 0, 0,
209 /* Return feature check version */
210 return ret_payload[1] & FIRMWARE_VERSION_MASK;
213 int zynqmp_pm_is_function_supported(const u32 api_id, const u32 id)
217 u32 ret_payload[PAYLOAD_ARG_CNT];
219 /* Input arguments validation */
220 if (id >= 64 || (api_id != PM_IOCTL && api_id != PM_QUERY_DATA))
223 /* Check feature check API version */
224 ret = xilinx_pm_request(PM_FEATURE_CHECK, PM_FEATURE_CHECK, 0, 0, 0,
229 /* Check if feature check version 2 is supported or not */
230 if ((ret_payload[1] & FIRMWARE_VERSION_MASK) == PM_API_VERSION_2) {
232 * Call feature check for IOCTL/QUERY API to get IOCTL ID or
233 * QUERY ID feature status.
236 ret = xilinx_pm_request(PM_FEATURE_CHECK, api_id, 0, 0, 0,
241 bit_mask = &ret_payload[2];
242 if ((bit_mask[(id / 32)] & BIT((id % 32))) == 0)
252 * Send a configuration object to the PMU firmware.
254 * @cfg_obj: Pointer to the configuration object
255 * @size: Size of @cfg_obj in bytes
256 * Return: 0 on success otherwise negative errno.
258 int zynqmp_pmufw_load_config_object(const void *cfg_obj, size_t size)
261 u32 ret_payload[PAYLOAD_ARG_CNT];
263 if (IS_ENABLED(CONFIG_SPL_BUILD))
264 printf("Loading new PMUFW cfg obj (%ld bytes)\n", size);
266 flush_dcache_range((ulong)cfg_obj, (ulong)(cfg_obj + size));
268 err = xilinx_pm_request(PM_SET_CONFIGURATION, (u32)(u64)cfg_obj, 0, 0,
270 if (err == XST_PM_NO_ACCESS) {
274 if (err == XST_PM_ALREADY_CONFIGURED) {
275 debug("PMUFW Node is already configured\n");
280 printf("Cannot load PMUFW configuration object (%d)\n", err);
283 printf("PMUFW returned 0x%08x status!\n", ret_payload[0]);
285 if ((err || ret_payload[0]) && IS_ENABLED(CONFIG_SPL_BUILD))
286 panic("PMUFW config object loading failed in EL3\n");
291 static int zynqmp_power_probe(struct udevice *dev)
293 struct udevice *ipi_dev;
297 debug("%s, (dev=%p)\n", __func__, dev);
300 * Probe all IPI parent node driver. It is important to have IPI
301 * devices available when requested by mbox_get_by* API.
302 * If IPI device isn't available, then mailbox request fails and
303 * that causes system boot failure.
304 * To avoid this make sure all IPI parent drivers are probed here,
305 * and IPI parent driver binds each child node to mailbox driver.
306 * This way mbox_get_by_* API will have correct mailbox device
309 ofnode_for_each_compatible_node(ipi_node, "xlnx,zynqmp-ipi-mailbox") {
310 ret = uclass_get_device_by_ofnode(UCLASS_NOP, ipi_node, &ipi_dev);
312 dev_err(dev, "failed to get IPI device from node %s\n",
313 ofnode_get_name(ipi_node));
318 ret = mbox_get_by_name(dev, "tx", &zynqmp_power.tx_chan);
320 debug("%s: Cannot find tx mailbox\n", __func__);
324 ret = mbox_get_by_name(dev, "rx", &zynqmp_power.rx_chan);
326 debug("%s: Cannot find rx mailbox\n", __func__);
330 ret = zynqmp_firmware_version();
331 printf("PMUFW:\tv%d.%d\n",
332 ret >> ZYNQMP_PM_VERSION_MAJOR_SHIFT,
333 ret & ZYNQMP_PM_VERSION_MINOR_MASK);
338 static const struct udevice_id zynqmp_power_ids[] = {
339 { .compatible = "xlnx,zynqmp-power" },
343 U_BOOT_DRIVER(zynqmp_power) = {
344 .name = "zynqmp_power",
345 .id = UCLASS_FIRMWARE,
346 .of_match = zynqmp_power_ids,
347 .probe = zynqmp_power_probe,
351 int __maybe_unused xilinx_pm_request(u32 api_id, u32 arg0, u32 arg1, u32 arg2,
352 u32 arg3, u32 *ret_payload)
354 debug("%s at EL%d, API ID: 0x%0x, 0x%0x, 0x%0x, 0x%0x, 0x%0x\n",
355 __func__, current_el(), api_id, arg0, arg1, arg2, arg3);
357 if (IS_ENABLED(CONFIG_SPL_BUILD) || current_el() == 3) {
358 #if defined(CONFIG_ZYNQMP_IPI)
360 * Use fixed payload and arg size as the EL2 call. The firmware
361 * is capable to handle PMUFW_PAYLOAD_ARG_CNT bytes but the
362 * firmware API is limited by the SMC call size
364 u32 regs[] = {api_id, arg0, arg1, arg2, arg3};
367 if (api_id == PM_FPGA_LOAD) {
368 /* Swap addr_hi/low because of incompatibility */
375 ret = ipi_req(regs, PAYLOAD_ARG_CNT, ret_payload,
384 * Added SIP service call Function Identifier
385 * Make sure to stay in x0 register
389 regs.regs[0] = PM_SIP_SVC | api_id;
390 regs.regs[1] = ((u64)arg1 << 32) | arg0;
391 regs.regs[2] = ((u64)arg3 << 32) | arg2;
396 ret_payload[0] = (u32)regs.regs[0];
397 ret_payload[1] = upper_32_bits(regs.regs[0]);
398 ret_payload[2] = (u32)regs.regs[1];
399 ret_payload[3] = upper_32_bits(regs.regs[1]);
400 ret_payload[4] = (u32)regs.regs[2];
404 return (ret_payload) ? ret_payload[0] : 0;
407 static const struct udevice_id zynqmp_firmware_ids[] = {
408 { .compatible = "xlnx,zynqmp-firmware" },
409 { .compatible = "xlnx,versal-firmware"},
410 { .compatible = "xlnx,versal-net-firmware"},
414 static int zynqmp_firmware_bind(struct udevice *dev)
417 struct udevice *child;
419 if ((IS_ENABLED(CONFIG_SPL_BUILD) &&
420 IS_ENABLED(CONFIG_SPL_POWER_DOMAIN) &&
421 IS_ENABLED(CONFIG_ZYNQMP_POWER_DOMAIN)) ||
422 (!IS_ENABLED(CONFIG_SPL_BUILD) &&
423 IS_ENABLED(CONFIG_ZYNQMP_POWER_DOMAIN))) {
424 ret = device_bind_driver_to_node(dev, "zynqmp_power_domain",
425 "zynqmp_power_domain",
426 dev_ofnode(dev), &child);
428 printf("zynqmp power domain driver is not bound: %d\n", ret);
436 U_BOOT_DRIVER(zynqmp_firmware) = {
437 .id = UCLASS_FIRMWARE,
438 .name = "zynqmp_firmware",
439 .of_match = zynqmp_firmware_ids,
440 .bind = zynqmp_firmware_bind,