1 // SPDX-License-Identifier: GPL-2.0
2 /*
3 * Microchip PolarFire SoC (MPFS) system controller/mailbox controller driver
4 *
5 * Copyright (c) 2020-2022 Microchip Corporation. All rights reserved.
6 *
7 * Author: Conor Dooley <conor.dooley@microchip.com>
8 *
9 */
10
11 #include <linux/io.h>
12 #include <linux/err.h>
13 #include <linux/init.h>
14 #include <linux/module.h>
15 #include <linux/kernel.h>
16 #include <linux/regmap.h>
17 #include <linux/interrupt.h>
18 #include <linux/mfd/syscon.h>
19 #include <linux/mod_devicetable.h>
20 #include <linux/platform_device.h>
21 #include <linux/mailbox_controller.h>
22 #include <soc/microchip/mpfs.h>
23
24 #define MESSAGE_INT_OFFSET 0x18cu
25 #define SERVICES_CR_OFFSET 0x50u
26 #define SERVICES_SR_OFFSET 0x54u
27 #define MAILBOX_REG_OFFSET 0x800u
28 #define MSS_SYS_MAILBOX_DATA_OFFSET 0u
29 #define SCB_MASK_WIDTH 16u
30
31 /* SCBCTRL service control register */
32
33 #define SCB_CTRL_REQ (0)
34 #define SCB_CTRL_REQ_MASK BIT(SCB_CTRL_REQ)
35
36 #define SCB_CTRL_BUSY (1)
37 #define SCB_CTRL_BUSY_MASK BIT(SCB_CTRL_BUSY)
38
39 #define SCB_CTRL_ABORT (2)
40 #define SCB_CTRL_ABORT_MASK BIT(SCB_CTRL_ABORT)
41
42 #define SCB_CTRL_NOTIFY (3)
43 #define SCB_CTRL_NOTIFY_MASK BIT(SCB_CTRL_NOTIFY)
44
45 #define SCB_CTRL_POS (16)
46 #define SCB_CTRL_MASK GENMASK(SCB_CTRL_POS + SCB_MASK_WIDTH - 1, SCB_CTRL_POS)
47
48 /* SCBCTRL service status register */
49
50 #define SCB_STATUS_REQ (0)
51 #define SCB_STATUS_REQ_MASK BIT(SCB_STATUS_REQ)
52
53 #define SCB_STATUS_BUSY (1)
54 #define SCB_STATUS_BUSY_MASK BIT(SCB_STATUS_BUSY)
55
56 #define SCB_STATUS_ABORT (2)
57 #define SCB_STATUS_ABORT_MASK BIT(SCB_STATUS_ABORT)
58
59 #define SCB_STATUS_NOTIFY (3)
60 #define SCB_STATUS_NOTIFY_MASK BIT(SCB_STATUS_NOTIFY)
61
62 #define SCB_STATUS_POS (16)
63 #define SCB_STATUS_MASK GENMASK(SCB_STATUS_POS + SCB_MASK_WIDTH - 1, SCB_STATUS_POS)
64
65 struct mpfs_mbox {
66 struct mbox_controller controller;
67 struct device *dev;
68 int irq;
69 void __iomem *ctrl_base;
70 void __iomem *mbox_base;
71 void __iomem *int_reg;
72 struct mbox_chan chans[1];
73 struct mpfs_mss_response *response;
74 struct regmap *sysreg_scb, *control_scb;
75 u16 resp_offset;
76 };
77
mpfs_mbox_busy(struct mpfs_mbox * mbox)78 static bool mpfs_mbox_busy(struct mpfs_mbox *mbox)
79 {
80 u32 status;
81
82 if (mbox->control_scb)
83 regmap_read(mbox->control_scb, SERVICES_SR_OFFSET, &status);
84 else
85 status = readl_relaxed(mbox->ctrl_base + SERVICES_SR_OFFSET);
86
87 return status & SCB_STATUS_BUSY_MASK;
88 }
89
mpfs_mbox_last_tx_done(struct mbox_chan * chan)90 static bool mpfs_mbox_last_tx_done(struct mbox_chan *chan)
91 {
92 struct mpfs_mbox *mbox = (struct mpfs_mbox *)chan->con_priv;
93 struct mpfs_mss_response *response = mbox->response;
94 u32 val;
95
96 if (mpfs_mbox_busy(mbox))
97 return false;
98
99 /*
100 * The service status is stored in bits 31:16 of the SERVICES_SR
101 * register & is only valid when the system controller is not busy.
102 * Failed services are intended to generated interrupts, but in reality
103 * this does not happen, so the status must be checked here.
104 */
105 if (mbox->control_scb)
106 regmap_read(mbox->control_scb, SERVICES_SR_OFFSET, &val);
107 else
108 val = readl_relaxed(mbox->ctrl_base + SERVICES_SR_OFFSET);
109
110 response->resp_status = (val & SCB_STATUS_MASK) >> SCB_STATUS_POS;
111
112 return true;
113 }
114
mpfs_mbox_send_data(struct mbox_chan * chan,void * data)115 static int mpfs_mbox_send_data(struct mbox_chan *chan, void *data)
116 {
117 struct mpfs_mbox *mbox = (struct mpfs_mbox *)chan->con_priv;
118 struct mpfs_mss_msg *msg = data;
119 u32 tx_trigger;
120 u16 opt_sel;
121 u32 val = 0u;
122
123 mbox->response = msg->response;
124 mbox->resp_offset = msg->resp_offset;
125
126 if (mpfs_mbox_busy(mbox))
127 return -EBUSY;
128
129 if (msg->cmd_data_size) {
130 u32 index;
131 u8 extra_bits = msg->cmd_data_size & 3;
132 u32 *word_buf = (u32 *)msg->cmd_data;
133
134 for (index = 0; index < (msg->cmd_data_size / 4); index++)
135 writel_relaxed(word_buf[index],
136 mbox->mbox_base + msg->mbox_offset + index * 0x4);
137 if (extra_bits) {
138 u8 i;
139 u8 byte_off = ALIGN_DOWN(msg->cmd_data_size, 4);
140 u8 *byte_buf = msg->cmd_data + byte_off;
141
142 val = readl_relaxed(mbox->mbox_base + msg->mbox_offset + index * 0x4);
143
144 for (i = 0u; i < extra_bits; i++) {
145 val &= ~(0xffu << (i * 8u));
146 val |= (byte_buf[i] << (i * 8u));
147 }
148
149 writel_relaxed(val, mbox->mbox_base + msg->mbox_offset + index * 0x4);
150 }
151 }
152
153 opt_sel = ((msg->mbox_offset << 7u) | (msg->cmd_opcode & 0x7fu));
154
155 tx_trigger = (opt_sel << SCB_CTRL_POS) & SCB_CTRL_MASK;
156 tx_trigger |= SCB_CTRL_REQ_MASK | SCB_STATUS_NOTIFY_MASK;
157
158 if (mbox->control_scb)
159 regmap_write(mbox->control_scb, SERVICES_CR_OFFSET, tx_trigger);
160 else
161 writel_relaxed(tx_trigger, mbox->ctrl_base + SERVICES_CR_OFFSET);
162
163
164 return 0;
165 }
166
mpfs_mbox_rx_data(struct mbox_chan * chan)167 static void mpfs_mbox_rx_data(struct mbox_chan *chan)
168 {
169 struct mpfs_mbox *mbox = (struct mpfs_mbox *)chan->con_priv;
170 struct mpfs_mss_response *response = mbox->response;
171 u16 num_words = ALIGN((response->resp_size), (4)) / 4U;
172 u32 i;
173
174 if (!response->resp_msg) {
175 dev_err(mbox->dev, "failed to assign memory for response %d\n", -ENOMEM);
176 return;
177 }
178
179 /*
180 * We should *never* get an interrupt while the controller is
181 * still in the busy state. If we do, something has gone badly
182 * wrong & the content of the mailbox would not be valid.
183 */
184 if (mpfs_mbox_busy(mbox)) {
185 dev_err(mbox->dev, "got an interrupt but system controller is busy\n");
186 response->resp_status = 0xDEAD;
187 return;
188 }
189
190 for (i = 0; i < num_words; i++) {
191 response->resp_msg[i] =
192 readl_relaxed(mbox->mbox_base
193 + mbox->resp_offset + i * 0x4);
194 }
195
196 mbox_chan_received_data(chan, response);
197 }
198
mpfs_mbox_inbox_isr(int irq,void * data)199 static irqreturn_t mpfs_mbox_inbox_isr(int irq, void *data)
200 {
201 struct mbox_chan *chan = data;
202 struct mpfs_mbox *mbox = (struct mpfs_mbox *)chan->con_priv;
203
204 if (mbox->control_scb)
205 regmap_write(mbox->sysreg_scb, MESSAGE_INT_OFFSET, 0);
206 else
207 writel_relaxed(0, mbox->int_reg);
208
209 mpfs_mbox_rx_data(chan);
210
211 return IRQ_HANDLED;
212 }
213
mpfs_mbox_startup(struct mbox_chan * chan)214 static int mpfs_mbox_startup(struct mbox_chan *chan)
215 {
216 struct mpfs_mbox *mbox = (struct mpfs_mbox *)chan->con_priv;
217 int ret = 0;
218
219 if (!mbox)
220 return -EINVAL;
221
222 ret = devm_request_irq(mbox->dev, mbox->irq, mpfs_mbox_inbox_isr, 0, "mpfs-mailbox", chan);
223 if (ret)
224 dev_err(mbox->dev, "failed to register mailbox interrupt:%d\n", ret);
225
226 return ret;
227 }
228
mpfs_mbox_shutdown(struct mbox_chan * chan)229 static void mpfs_mbox_shutdown(struct mbox_chan *chan)
230 {
231 struct mpfs_mbox *mbox = (struct mpfs_mbox *)chan->con_priv;
232
233 devm_free_irq(mbox->dev, mbox->irq, chan);
234 }
235
236 static const struct mbox_chan_ops mpfs_mbox_ops = {
237 .send_data = mpfs_mbox_send_data,
238 .startup = mpfs_mbox_startup,
239 .shutdown = mpfs_mbox_shutdown,
240 .last_tx_done = mpfs_mbox_last_tx_done,
241 };
242
mpfs_mbox_syscon_probe(struct mpfs_mbox * mbox,struct platform_device * pdev)243 static inline int mpfs_mbox_syscon_probe(struct mpfs_mbox *mbox, struct platform_device *pdev)
244 {
245 mbox->control_scb = syscon_regmap_lookup_by_compatible("microchip,mpfs-control-scb");
246 if (IS_ERR(mbox->control_scb))
247 return PTR_ERR(mbox->control_scb);
248
249 mbox->sysreg_scb = syscon_regmap_lookup_by_compatible("microchip,mpfs-sysreg-scb");
250 if (IS_ERR(mbox->sysreg_scb))
251 return PTR_ERR(mbox->sysreg_scb);
252
253 mbox->mbox_base = devm_platform_ioremap_resource(pdev, 0);
254 if (IS_ERR(mbox->ctrl_base))
255 return PTR_ERR(mbox->mbox_base);
256
257 return 0;
258 }
259
mpfs_mbox_old_format_probe(struct mpfs_mbox * mbox,struct platform_device * pdev)260 static inline int mpfs_mbox_old_format_probe(struct mpfs_mbox *mbox, struct platform_device *pdev)
261 {
262 dev_warn(&pdev->dev, "falling back to old devicetree format");
263
264 mbox->ctrl_base = devm_platform_ioremap_resource(pdev, 0);
265 if (IS_ERR(mbox->ctrl_base))
266 return PTR_ERR(mbox->ctrl_base);
267
268 mbox->int_reg = devm_platform_ioremap_resource(pdev, 1);
269 if (IS_ERR(mbox->int_reg))
270 return PTR_ERR(mbox->int_reg);
271
272 mbox->mbox_base = devm_platform_ioremap_resource(pdev, 2);
273 if (IS_ERR(mbox->mbox_base)) // account for the old dt-binding w/ 2 regs
274 mbox->mbox_base = mbox->ctrl_base + MAILBOX_REG_OFFSET;
275
276 return 0;
277 }
278
mpfs_mbox_probe(struct platform_device * pdev)279 static int mpfs_mbox_probe(struct platform_device *pdev)
280 {
281 struct mpfs_mbox *mbox;
282 int ret;
283
284 mbox = devm_kzalloc(&pdev->dev, sizeof(*mbox), GFP_KERNEL);
285 if (!mbox)
286 return -ENOMEM;
287
288 ret = mpfs_mbox_syscon_probe(mbox, pdev);
289 if (ret) {
290 /*
291 * set this to null, so it can be used as the decision for to
292 * regmap or not to regmap
293 */
294 mbox->control_scb = NULL;
295 ret = mpfs_mbox_old_format_probe(mbox, pdev);
296 if (ret)
297 return ret;
298 }
299 mbox->irq = platform_get_irq(pdev, 0);
300 if (mbox->irq < 0)
301 return mbox->irq;
302
303 mbox->dev = &pdev->dev;
304
305 mbox->chans[0].con_priv = mbox;
306 mbox->controller.dev = mbox->dev;
307 mbox->controller.num_chans = 1;
308 mbox->controller.chans = mbox->chans;
309 mbox->controller.ops = &mpfs_mbox_ops;
310 mbox->controller.txdone_poll = true;
311 mbox->controller.txpoll_period = 10u;
312
313 ret = devm_mbox_controller_register(&pdev->dev, &mbox->controller);
314 if (ret) {
315 dev_err(&pdev->dev, "Registering MPFS mailbox controller failed\n");
316 return ret;
317 }
318 dev_info(&pdev->dev, "Registered MPFS mailbox controller driver\n");
319
320 return 0;
321 }
322
323 static const struct of_device_id mpfs_mbox_of_match[] = {
324 {.compatible = "microchip,mpfs-mailbox", },
325 {},
326 };
327 MODULE_DEVICE_TABLE(of, mpfs_mbox_of_match);
328
329 static struct platform_driver mpfs_mbox_driver = {
330 .driver = {
331 .name = "mpfs-mailbox",
332 .of_match_table = mpfs_mbox_of_match,
333 },
334 .probe = mpfs_mbox_probe,
335 };
336 module_platform_driver(mpfs_mbox_driver);
337
338 MODULE_LICENSE("GPL v2");
339 MODULE_AUTHOR("Conor Dooley <conor.dooley@microchip.com>");
340 MODULE_DESCRIPTION("MPFS mailbox controller driver");
341