1 // SPDX-License-Identifier: GPL-2.0-only
3 * ST's Remote Processor Control Driver
5 * Copyright (C) 2015 STMicroelectronics - All Rights Reserved
7 * Author: Ludovic Barre <ludovic.barre@st.com>
10 #include <linux/clk.h>
11 #include <linux/dma-mapping.h>
12 #include <linux/err.h>
13 #include <linux/interrupt.h>
14 #include <linux/kernel.h>
15 #include <linux/mailbox_client.h>
16 #include <linux/mfd/syscon.h>
17 #include <linux/module.h>
19 #include <linux/of_address.h>
20 #include <linux/of_device.h>
21 #include <linux/of_reserved_mem.h>
22 #include <linux/platform_device.h>
23 #include <linux/regmap.h>
24 #include <linux/remoteproc.h>
25 #include <linux/reset.h>
27 #include "remoteproc_internal.h"
29 #define ST_RPROC_VQ0 0
30 #define ST_RPROC_VQ1 1
31 #define ST_RPROC_MAX_VRING 2
37 struct st_rproc_config {
40 unsigned long bootaddr_mask;
44 struct st_rproc_config *config;
45 struct reset_control *sw_reset;
46 struct reset_control *pwr_reset;
49 struct regmap *boot_base;
51 struct mbox_chan *mbox_chan[ST_RPROC_MAX_VRING * MBOX_MAX];
52 struct mbox_client mbox_client_vq0;
53 struct mbox_client mbox_client_vq1;
56 static void st_rproc_mbox_callback(struct device *dev, u32 msg)
58 struct rproc *rproc = dev_get_drvdata(dev);
60 if (rproc_vq_interrupt(rproc, msg) == IRQ_NONE)
61 dev_dbg(dev, "no message was found in vqid %d\n", msg);
65 void st_rproc_mbox_callback_vq0(struct mbox_client *mbox_client, void *data)
67 st_rproc_mbox_callback(mbox_client->dev, 0);
71 void st_rproc_mbox_callback_vq1(struct mbox_client *mbox_client, void *data)
73 st_rproc_mbox_callback(mbox_client->dev, 1);
76 static void st_rproc_kick(struct rproc *rproc, int vqid)
78 struct st_rproc *ddata = rproc->priv;
79 struct device *dev = rproc->dev.parent;
82 /* send the index of the triggered virtqueue in the mailbox payload */
83 if (WARN_ON(vqid >= ST_RPROC_MAX_VRING))
86 ret = mbox_send_message(ddata->mbox_chan[vqid * MBOX_MAX + MBOX_TX],
89 dev_err(dev, "failed to send message via mbox: %d\n", ret);
92 static int st_rproc_mem_alloc(struct rproc *rproc,
93 struct rproc_mem_entry *mem)
95 struct device *dev = rproc->dev.parent;
98 va = ioremap_wc(mem->dma, mem->len);
100 dev_err(dev, "Unable to map memory region: %pa+%zx\n",
101 &mem->dma, mem->len);
105 /* Update memory entry va */
111 static int st_rproc_mem_release(struct rproc *rproc,
112 struct rproc_mem_entry *mem)
119 static int st_rproc_parse_fw(struct rproc *rproc, const struct firmware *fw)
121 struct device *dev = rproc->dev.parent;
122 struct device_node *np = dev->of_node;
123 struct rproc_mem_entry *mem;
124 struct reserved_mem *rmem;
125 struct of_phandle_iterator it;
128 of_phandle_iterator_init(&it, np, "memory-region", NULL, 0);
129 while (of_phandle_iterator_next(&it) == 0) {
130 rmem = of_reserved_mem_lookup(it.node);
132 of_node_put(it.node);
133 dev_err(dev, "unable to acquire memory-region\n");
137 /* No need to map vdev buffer */
138 if (strcmp(it.node->name, "vdev0buffer")) {
139 /* Register memory region */
140 mem = rproc_mem_entry_init(dev, NULL,
141 (dma_addr_t)rmem->base,
142 rmem->size, rmem->base,
144 st_rproc_mem_release,
147 /* Register reserved memory for vdev buffer allocation */
148 mem = rproc_of_resm_mem_entry_init(dev, index,
155 of_node_put(it.node);
159 rproc_add_carveout(rproc, mem);
163 return rproc_elf_load_rsc_table(rproc, fw);
166 static int st_rproc_start(struct rproc *rproc)
168 struct st_rproc *ddata = rproc->priv;
171 regmap_update_bits(ddata->boot_base, ddata->boot_offset,
172 ddata->config->bootaddr_mask, rproc->bootaddr);
174 err = clk_enable(ddata->clk);
176 dev_err(&rproc->dev, "Failed to enable clock\n");
180 if (ddata->config->sw_reset) {
181 err = reset_control_deassert(ddata->sw_reset);
183 dev_err(&rproc->dev, "Failed to deassert S/W Reset\n");
188 if (ddata->config->pwr_reset) {
189 err = reset_control_deassert(ddata->pwr_reset);
191 dev_err(&rproc->dev, "Failed to deassert Power Reset\n");
196 dev_info(&rproc->dev, "Started from 0x%llx\n", rproc->bootaddr);
202 if (ddata->config->pwr_reset)
203 reset_control_assert(ddata->sw_reset);
205 clk_disable(ddata->clk);
210 static int st_rproc_stop(struct rproc *rproc)
212 struct st_rproc *ddata = rproc->priv;
213 int sw_err = 0, pwr_err = 0;
215 if (ddata->config->sw_reset) {
216 sw_err = reset_control_assert(ddata->sw_reset);
218 dev_err(&rproc->dev, "Failed to assert S/W Reset\n");
221 if (ddata->config->pwr_reset) {
222 pwr_err = reset_control_assert(ddata->pwr_reset);
224 dev_err(&rproc->dev, "Failed to assert Power Reset\n");
227 clk_disable(ddata->clk);
229 return sw_err ?: pwr_err;
232 static const struct rproc_ops st_rproc_ops = {
233 .kick = st_rproc_kick,
234 .start = st_rproc_start,
235 .stop = st_rproc_stop,
236 .parse_fw = st_rproc_parse_fw,
237 .load = rproc_elf_load_segments,
238 .find_loaded_rsc_table = rproc_elf_find_loaded_rsc_table,
239 .sanity_check = rproc_elf_sanity_check,
240 .get_boot_addr = rproc_elf_get_boot_addr,
244 * Fetch state of the processor: 0 is off, 1 is on.
246 static int st_rproc_state(struct platform_device *pdev)
248 struct rproc *rproc = platform_get_drvdata(pdev);
249 struct st_rproc *ddata = rproc->priv;
250 int reset_sw = 0, reset_pwr = 0;
252 if (ddata->config->sw_reset)
253 reset_sw = reset_control_status(ddata->sw_reset);
255 if (ddata->config->pwr_reset)
256 reset_pwr = reset_control_status(ddata->pwr_reset);
258 if (reset_sw < 0 || reset_pwr < 0)
261 return !reset_sw && !reset_pwr;
264 static const struct st_rproc_config st40_rproc_cfg = {
267 .bootaddr_mask = GENMASK(28, 1),
270 static const struct st_rproc_config st231_rproc_cfg = {
273 .bootaddr_mask = GENMASK(31, 6),
276 static const struct of_device_id st_rproc_match[] = {
277 { .compatible = "st,st40-rproc", .data = &st40_rproc_cfg },
278 { .compatible = "st,st231-rproc", .data = &st231_rproc_cfg },
281 MODULE_DEVICE_TABLE(of, st_rproc_match);
283 static int st_rproc_parse_dt(struct platform_device *pdev)
285 struct device *dev = &pdev->dev;
286 struct rproc *rproc = platform_get_drvdata(pdev);
287 struct st_rproc *ddata = rproc->priv;
288 struct device_node *np = dev->of_node;
291 if (ddata->config->sw_reset) {
292 ddata->sw_reset = devm_reset_control_get_exclusive(dev,
294 if (IS_ERR(ddata->sw_reset)) {
295 dev_err(dev, "Failed to get S/W Reset\n");
296 return PTR_ERR(ddata->sw_reset);
300 if (ddata->config->pwr_reset) {
301 ddata->pwr_reset = devm_reset_control_get_exclusive(dev,
303 if (IS_ERR(ddata->pwr_reset)) {
304 dev_err(dev, "Failed to get Power Reset\n");
305 return PTR_ERR(ddata->pwr_reset);
309 ddata->clk = devm_clk_get(dev, NULL);
310 if (IS_ERR(ddata->clk)) {
311 dev_err(dev, "Failed to get clock\n");
312 return PTR_ERR(ddata->clk);
315 err = of_property_read_u32(np, "clock-frequency", &ddata->clk_rate);
317 dev_err(dev, "failed to get clock frequency\n");
321 ddata->boot_base = syscon_regmap_lookup_by_phandle(np, "st,syscfg");
322 if (IS_ERR(ddata->boot_base)) {
323 dev_err(dev, "Boot base not found\n");
324 return PTR_ERR(ddata->boot_base);
327 err = of_property_read_u32_index(np, "st,syscfg", 1,
328 &ddata->boot_offset);
330 dev_err(dev, "Boot offset not found\n");
334 err = clk_prepare(ddata->clk);
336 dev_err(dev, "failed to get clock\n");
341 static int st_rproc_probe(struct platform_device *pdev)
343 struct device *dev = &pdev->dev;
344 const struct of_device_id *match;
345 struct st_rproc *ddata;
346 struct device_node *np = dev->of_node;
348 struct mbox_chan *chan;
352 match = of_match_device(st_rproc_match, dev);
353 if (!match || !match->data) {
354 dev_err(dev, "No device match found\n");
358 rproc = rproc_alloc(dev, np->name, &st_rproc_ops, NULL, sizeof(*ddata));
362 rproc->has_iommu = false;
364 ddata->config = (struct st_rproc_config *)match->data;
366 platform_set_drvdata(pdev, rproc);
368 ret = st_rproc_parse_dt(pdev);
372 enabled = st_rproc_state(pdev);
379 atomic_inc(&rproc->power);
380 rproc->state = RPROC_RUNNING;
382 clk_set_rate(ddata->clk, ddata->clk_rate);
385 if (of_property_present(np, "mbox-names")) {
386 ddata->mbox_client_vq0.dev = dev;
387 ddata->mbox_client_vq0.tx_done = NULL;
388 ddata->mbox_client_vq0.tx_block = false;
389 ddata->mbox_client_vq0.knows_txdone = false;
390 ddata->mbox_client_vq0.rx_callback = st_rproc_mbox_callback_vq0;
392 ddata->mbox_client_vq1.dev = dev;
393 ddata->mbox_client_vq1.tx_done = NULL;
394 ddata->mbox_client_vq1.tx_block = false;
395 ddata->mbox_client_vq1.knows_txdone = false;
396 ddata->mbox_client_vq1.rx_callback = st_rproc_mbox_callback_vq1;
399 * To control a co-processor without IPC mechanism.
400 * This driver can be used without mbox and rpmsg.
402 chan = mbox_request_channel_byname(&ddata->mbox_client_vq0, "vq0_rx");
404 dev_err(&rproc->dev, "failed to request mbox chan 0\n");
408 ddata->mbox_chan[ST_RPROC_VQ0 * MBOX_MAX + MBOX_RX] = chan;
410 chan = mbox_request_channel_byname(&ddata->mbox_client_vq0, "vq0_tx");
412 dev_err(&rproc->dev, "failed to request mbox chan 0\n");
416 ddata->mbox_chan[ST_RPROC_VQ0 * MBOX_MAX + MBOX_TX] = chan;
418 chan = mbox_request_channel_byname(&ddata->mbox_client_vq1, "vq1_rx");
420 dev_err(&rproc->dev, "failed to request mbox chan 1\n");
424 ddata->mbox_chan[ST_RPROC_VQ1 * MBOX_MAX + MBOX_RX] = chan;
426 chan = mbox_request_channel_byname(&ddata->mbox_client_vq1, "vq1_tx");
428 dev_err(&rproc->dev, "failed to request mbox chan 1\n");
432 ddata->mbox_chan[ST_RPROC_VQ1 * MBOX_MAX + MBOX_TX] = chan;
435 ret = rproc_add(rproc);
442 for (i = 0; i < ST_RPROC_MAX_VRING * MBOX_MAX; i++)
443 mbox_free_channel(ddata->mbox_chan[i]);
445 clk_unprepare(ddata->clk);
451 static void st_rproc_remove(struct platform_device *pdev)
453 struct rproc *rproc = platform_get_drvdata(pdev);
454 struct st_rproc *ddata = rproc->priv;
459 clk_disable_unprepare(ddata->clk);
461 for (i = 0; i < ST_RPROC_MAX_VRING * MBOX_MAX; i++)
462 mbox_free_channel(ddata->mbox_chan[i]);
467 static struct platform_driver st_rproc_driver = {
468 .probe = st_rproc_probe,
469 .remove_new = st_rproc_remove,
472 .of_match_table = of_match_ptr(st_rproc_match),
475 module_platform_driver(st_rproc_driver);
477 MODULE_DESCRIPTION("ST Remote Processor Control Driver");
478 MODULE_AUTHOR("Ludovic Barre <ludovic.barre@st.com>");
479 MODULE_LICENSE("GPL v2");