1 // SPDX-License-Identifier: GPL-2.0+
3 * Copyright (c) 2017 Intel Corporation
5 * Intel Mobile Internet Devices (MID) based on Intel Atom SoCs have few
6 * microcontrollers inside to do some auxiliary tasks. One of such
7 * microcontroller is System Controller Unit (SCU) which, in particular,
8 * is servicing watchdog and controlling system reset function.
10 * This driver enables IPC channel to SCU.
18 #include <linux/errno.h>
20 #include <linux/kernel.h>
22 /* SCU register map */
34 struct ipc_regs *regs;
38 * scu_ipc_send_command() - send command to SCU
39 * @regs: register map of SCU
42 * Command Register (Write Only):
43 * A write to this register results in an interrupt to the SCU core processor
45 * |rfu2(8) | size(8) | command id(4) | rfu1(3) | ioc(1) | command(8)|
47 static void scu_ipc_send_command(struct ipc_regs *regs, u32 cmd)
49 writel(cmd, ®s->cmd);
53 * scu_ipc_check_status() - check status of last command
54 * @regs: register map of SCU
56 * Status Register (Read Only):
57 * Driver will read this register to get the ready/busy status of the IPC
58 * block and error status of the IPC command that was just processed by SCU
60 * |rfu3(8)|error code(8)|initiator id(8)|cmd id(4)|rfu1(2)|error(1)|busy(1)|
62 static int scu_ipc_check_status(struct ipc_regs *regs)
64 int loop_count = 100000;
68 status = readl(®s->status);
69 if (!(status & BIT(0)))
73 } while (--loop_count);
77 if (status & BIT(1)) {
78 printf("%s() status=0x%08x\n", __func__, status);
85 static int scu_ipc_cmd(struct ipc_regs *regs, u32 cmd, u32 sub,
86 u32 *in, int inlen, u32 *out, int outlen)
90 for (i = 0; i < inlen; i++)
91 writel(*in++, ®s->wbuf[i]);
93 scu_ipc_send_command(regs, (inlen << 16) | (sub << 12) | cmd);
94 err = scu_ipc_check_status(regs);
97 for (i = 0; i < outlen; i++)
98 *out++ = readl(®s->rbuf[i]);
105 * scu_ipc_raw_command() - IPC command with data and pointers
106 * @cmd: IPC command code
107 * @sub: IPC command sub type
108 * @in: input data of this IPC command
109 * @inlen: input data length in dwords
110 * @out: output data of this IPC command
111 * @outlen: output data length in dwords
112 * @dptr: data writing to SPTR register
113 * @sptr: data writing to DPTR register
115 * Send an IPC command to SCU with input/output data and source/dest pointers.
117 * Return: an IPC error code or 0 on success.
119 int scu_ipc_raw_command(u32 cmd, u32 sub, u32 *in, int inlen, u32 *out,
120 int outlen, u32 dptr, u32 sptr)
122 int inbuflen = DIV_ROUND_UP(inlen, 4);
127 ret = syscon_get_by_driver_data(X86_SYSCON_SCU, &dev);
131 scu = dev_get_priv(dev);
137 writel(dptr, &scu->regs->dptr);
138 writel(sptr, &scu->regs->sptr);
141 * SRAM controller doesn't support 8-bit writes, it only
142 * supports 32-bit writes, so we have to copy input data into
143 * the temporary buffer, and SCU FW will use the inlen to
144 * determine the actual input data length in the temporary
150 memcpy(inbuf, in, inlen);
152 return scu_ipc_cmd(scu->regs, cmd, sub, inbuf, inlen, out, outlen);
156 * scu_ipc_simple_command() - send a simple command
160 * Issue a simple command to the SCU. Do not use this interface if
161 * you must then access data as any data values may be overwritten
162 * by another SCU access by the time this function returns.
164 * This function may sleep. Locking for SCU accesses is handled for
167 int scu_ipc_simple_command(u32 cmd, u32 sub)
173 ret = syscon_get_by_driver_data(X86_SYSCON_SCU, &dev);
177 scu = dev_get_priv(dev);
179 scu_ipc_send_command(scu->regs, sub << 12 | cmd);
180 return scu_ipc_check_status(scu->regs);
184 * scu_ipc_command - command with data
188 * @inlen: input length in dwords
190 * @outlen: output length in dwords
192 * Issue a command to the SCU which involves data transfers.
194 int scu_ipc_command(u32 cmd, u32 sub, u32 *in, int inlen, u32 *out, int outlen)
200 ret = syscon_get_by_driver_data(X86_SYSCON_SCU, &dev);
204 scu = dev_get_priv(dev);
206 return scu_ipc_cmd(scu->regs, cmd, sub, in, inlen, out, outlen);
209 static int scu_ipc_probe(struct udevice *dev)
211 struct scu *scu = dev_get_priv(dev);
213 scu->regs = syscon_get_first_range(X86_SYSCON_SCU);
218 static const struct udevice_id scu_ipc_match[] = {
219 { .compatible = "intel,scu-ipc", .data = X86_SYSCON_SCU },
223 U_BOOT_DRIVER(scu_ipc) = {
226 .of_match = scu_ipc_match,
227 .probe = scu_ipc_probe,
228 .priv_auto_alloc_size = sizeof(struct scu),