drivers/remoteproc/stm32_rproc.c
Source file repositories/reference/linux-study-clean/drivers/remoteproc/stm32_rproc.c
File Facts
- System
- Linux kernel
- Corpus path
drivers/remoteproc/stm32_rproc.c- Extension
.c- Size
- 23522 bytes
- Lines
- 961
- Domain
- Driver Families
- Bucket
- drivers/remoteproc
- Inferred role
- Driver Families: implementation source
- Status
- source implementation candidate
Why This File Exists
Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
- Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
- Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
- Touches IRQ or DMA behavior; this matters for the representative real-device path.
- Allocates kernel memory; connect allocation flags and lifetime to context constraints.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
linux/arm-smccc.hlinux/dma-mapping.hlinux/interrupt.hlinux/io.hlinux/mailbox_client.hlinux/mfd/syscon.hlinux/module.hlinux/of.hlinux/of_reserved_mem.hlinux/platform_device.hlinux/pm_wakeirq.hlinux/regmap.hlinux/remoteproc.hlinux/reset.hlinux/slab.hlinux/workqueue.hremoteproc_internal.h
Detected Declarations
struct stm32_sysconstruct stm32_rproc_memstruct stm32_rproc_mem_rangesstruct stm32_mboxstruct stm32_rprocfunction stm32_rproc_pa_to_dafunction stm32_rproc_mem_allocfunction stm32_rproc_mem_releasefunction stm32_rproc_of_memory_translationsfunction stm32_rproc_mbox_idxfunction stm32_rproc_preparefunction stm32_rproc_parse_fwfunction stm32_rproc_wdgfunction stm32_rproc_mb_vq_workfunction stm32_rproc_mb_callbackfunction stm32_rproc_free_mboxfunction stm32_rproc_request_mboxfunction stm32_rproc_set_hold_bootfunction stm32_rproc_add_coredump_tracefunction list_for_each_entryfunction list_for_each_entryfunction stm32_rproc_startfunction stm32_rproc_attachfunction stm32_rproc_detachfunction stm32_rproc_stopfunction stm32_rproc_kickfunction stm32_rproc_da_to_pafunction stm32_rproc_get_loaded_rsc_tablefunction stm32_rproc_get_sysconfunction stm32_rproc_parse_dtfunction stm32_rproc_get_m4_statusfunction stm32_rproc_probefunction stm32_rproc_removefunction stm32_rproc_suspendfunction stm32_rproc_resume
Annotated Snippet
struct stm32_syscon {
struct regmap *map;
u32 reg;
u32 mask;
};
struct stm32_rproc_mem {
char name[20];
void __iomem *cpu_addr;
phys_addr_t bus_addr;
u32 dev_addr;
size_t size;
};
struct stm32_rproc_mem_ranges {
u32 dev_addr;
u32 bus_addr;
u32 size;
};
struct stm32_mbox {
const unsigned char name[10];
struct mbox_chan *chan;
struct mbox_client client;
struct work_struct vq_work;
int vq_id;
};
struct stm32_rproc {
struct reset_control *rst;
struct reset_control *hold_boot_rst;
struct stm32_syscon hold_boot;
struct stm32_syscon pdds;
struct stm32_syscon m4_state;
struct stm32_syscon rsctbl;
int wdg_irq;
u32 nb_rmems;
struct stm32_rproc_mem *rmems;
struct stm32_mbox mb[MBOX_NB_MBX];
struct workqueue_struct *workqueue;
bool hold_boot_smc;
void __iomem *rsc_va;
};
static int stm32_rproc_pa_to_da(struct rproc *rproc, phys_addr_t pa, u64 *da)
{
unsigned int i;
struct stm32_rproc *ddata = rproc->priv;
struct stm32_rproc_mem *p_mem;
for (i = 0; i < ddata->nb_rmems; i++) {
p_mem = &ddata->rmems[i];
if (pa < p_mem->bus_addr ||
pa >= p_mem->bus_addr + p_mem->size)
continue;
*da = pa - p_mem->bus_addr + p_mem->dev_addr;
dev_dbg(rproc->dev.parent, "pa %pa to da %llx\n", &pa, *da);
return 0;
}
return -EINVAL;
}
static int stm32_rproc_mem_alloc(struct rproc *rproc,
struct rproc_mem_entry *mem)
{
struct device *dev = rproc->dev.parent;
void *va;
dev_dbg(dev, "map memory: %pad+%zx\n", &mem->dma, mem->len);
va = (__force void *)ioremap_wc(mem->dma, mem->len);
if (IS_ERR_OR_NULL(va)) {
dev_err(dev, "Unable to map memory region: %pad+0x%zx\n",
&mem->dma, mem->len);
return -ENOMEM;
}
/* Update memory entry va */
mem->va = va;
return 0;
}
static int stm32_rproc_mem_release(struct rproc *rproc,
struct rproc_mem_entry *mem)
{
dev_dbg(rproc->dev.parent, "unmap memory: %pa\n", &mem->dma);
iounmap((__force __iomem void *)mem->va);
Annotation
- Immediate include surface: `linux/arm-smccc.h`, `linux/dma-mapping.h`, `linux/interrupt.h`, `linux/io.h`, `linux/mailbox_client.h`, `linux/mfd/syscon.h`, `linux/module.h`, `linux/of.h`.
- Detected declarations: `struct stm32_syscon`, `struct stm32_rproc_mem`, `struct stm32_rproc_mem_ranges`, `struct stm32_mbox`, `struct stm32_rproc`, `function stm32_rproc_pa_to_da`, `function stm32_rproc_mem_alloc`, `function stm32_rproc_mem_release`, `function stm32_rproc_of_memory_translations`, `function stm32_rproc_mbox_idx`.
- Atlas domain: Driver Families / drivers/remoteproc.
- Implementation status: source implementation candidate.
- Synchronization appears in or near this file; preserve lock ordering, sleepability, and interrupt-context constraints.
- IRQ or DMA behavior appears here, which is relevant to the selected PCIe/NVMe device path.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.