drivers/base/regmap/regmap-mmio.c
Source file repositories/reference/linux-study-clean/drivers/base/regmap/regmap-mmio.c
File Facts
- System
- Linux kernel
- Corpus path
drivers/base/regmap/regmap-mmio.c- Extension
.c- Size
- 13537 bytes
- Lines
- 614
- Domain
- Driver Families
- Bucket
- drivers/base
- Inferred role
- Driver Families: exported/initcall integration point
- Status
- integration 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.
- Exports symbols or registers init work; inspect boot/module ordering and who consumes the exported contract.
- 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/clk.hlinux/err.hlinux/io.hlinux/module.hlinux/regmap.hlinux/slab.hlinux/swab.hinternal.h
Detected Declarations
struct regmap_mmio_contextfunction regmap_mmio_regbits_checkfunction regmap_mmio_get_min_stridefunction regmap_mmio_write8function regmap_mmio_write8_relaxedfunction regmap_mmio_iowrite8function regmap_mmio_write16lefunction regmap_mmio_write16le_relaxedfunction regmap_mmio_iowrite16lefunction regmap_mmio_write16befunction regmap_mmio_iowrite16befunction regmap_mmio_write32lefunction regmap_mmio_write32le_relaxedfunction regmap_mmio_iowrite32lefunction regmap_mmio_write32befunction regmap_mmio_iowrite32befunction regmap_mmio_writefunction regmap_mmio_noinc_writefunction regmap_mmio_read8function regmap_mmio_read8_relaxedfunction regmap_mmio_ioread8function regmap_mmio_read16lefunction regmap_mmio_read16le_relaxedfunction regmap_mmio_ioread16lefunction regmap_mmio_read16befunction regmap_mmio_ioread16befunction regmap_mmio_read32lefunction regmap_mmio_read32le_relaxedfunction regmap_mmio_ioread32lefunction regmap_mmio_read32befunction regmap_mmio_ioread32befunction regmap_mmio_readfunction regmap_mmio_noinc_readfunction regmap_mmio_free_contextfunction regmap_mmio_attach_clkfunction regmap_mmio_detach_clkexport __regmap_init_mmio_clkexport __devm_regmap_init_mmio_clkexport regmap_mmio_attach_clkexport regmap_mmio_detach_clk
Annotated Snippet
struct regmap_mmio_context {
void __iomem *regs;
unsigned int val_bytes;
bool big_endian;
bool attached_clk;
struct clk *clk;
void (*reg_write)(struct regmap_mmio_context *ctx,
unsigned int reg, unsigned int val);
unsigned int (*reg_read)(struct regmap_mmio_context *ctx,
unsigned int reg);
};
static int regmap_mmio_regbits_check(size_t reg_bits)
{
switch (reg_bits) {
case 8:
case 16:
case 32:
return 0;
default:
return -EINVAL;
}
}
static int regmap_mmio_get_min_stride(size_t val_bits)
{
int min_stride;
switch (val_bits) {
case 8:
/* The core treats 0 as 1 */
min_stride = 0;
break;
case 16:
min_stride = 2;
break;
case 32:
min_stride = 4;
break;
default:
return -EINVAL;
}
return min_stride;
}
static void regmap_mmio_write8(struct regmap_mmio_context *ctx,
unsigned int reg,
unsigned int val)
{
writeb(val, ctx->regs + reg);
}
static void regmap_mmio_write8_relaxed(struct regmap_mmio_context *ctx,
unsigned int reg,
unsigned int val)
{
writeb_relaxed(val, ctx->regs + reg);
}
static void regmap_mmio_iowrite8(struct regmap_mmio_context *ctx,
unsigned int reg, unsigned int val)
{
iowrite8(val, ctx->regs + reg);
}
static void regmap_mmio_write16le(struct regmap_mmio_context *ctx,
unsigned int reg,
unsigned int val)
{
writew(val, ctx->regs + reg);
}
static void regmap_mmio_write16le_relaxed(struct regmap_mmio_context *ctx,
unsigned int reg,
unsigned int val)
{
writew_relaxed(val, ctx->regs + reg);
}
static void regmap_mmio_iowrite16le(struct regmap_mmio_context *ctx,
unsigned int reg, unsigned int val)
{
iowrite16(val, ctx->regs + reg);
}
static void regmap_mmio_write16be(struct regmap_mmio_context *ctx,
unsigned int reg,
Annotation
- Immediate include surface: `linux/clk.h`, `linux/err.h`, `linux/io.h`, `linux/module.h`, `linux/regmap.h`, `linux/slab.h`, `linux/swab.h`, `internal.h`.
- Detected declarations: `struct regmap_mmio_context`, `function regmap_mmio_regbits_check`, `function regmap_mmio_get_min_stride`, `function regmap_mmio_write8`, `function regmap_mmio_write8_relaxed`, `function regmap_mmio_iowrite8`, `function regmap_mmio_write16le`, `function regmap_mmio_write16le_relaxed`, `function regmap_mmio_iowrite16le`, `function regmap_mmio_write16be`.
- Atlas domain: Driver Families / drivers/base.
- Implementation status: integration implementation candidate.
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.