drivers/soc/fsl/qe/gpio.c
Source file repositories/reference/linux-study-clean/drivers/soc/fsl/qe/gpio.c
File Facts
- System
- Linux kernel
- Corpus path
drivers/soc/fsl/qe/gpio.c- Extension
.c- Size
- 8633 bytes
- Lines
- 351
- Domain
- Driver Families
- Bucket
- drivers/soc
- 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.
- Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
- 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/kernel.hlinux/init.hlinux/spinlock.hlinux/err.hlinux/io.hlinux/gpio/consumer.hlinux/gpio/driver.hlinux/slab.hlinux/export.hlinux/platform_device.hsoc/fsl/qe/qe.h
Detected Declarations
struct qe_gpio_chipstruct qe_pinfunction qe_gpio_save_regsfunction qe_gpio_getfunction qe_gpio_setfunction qe_gpio_set_multiplefunction qe_gpio_dir_infunction qe_gpio_dir_outfunction qe_pin_requestfunction qe_pin_set_dedicatedfunction qe_pin_set_gpiofunction qe_gpio_probefunction qe_gpio_initexport qe_pin_requestexport qe_pin_freeexport qe_pin_set_dedicatedexport qe_pin_set_gpio
Annotated Snippet
struct qe_gpio_chip {
struct gpio_chip gc;
void __iomem *regs;
spinlock_t lock;
/* shadowed data register to clear/set bits safely */
u32 cpdata;
/* saved_regs used to restore dedicated functions */
struct qe_pio_regs saved_regs;
};
static void qe_gpio_save_regs(struct qe_gpio_chip *qe_gc)
{
struct qe_pio_regs __iomem *regs = qe_gc->regs;
qe_gc->cpdata = ioread32be(®s->cpdata);
qe_gc->saved_regs.cpdata = qe_gc->cpdata;
qe_gc->saved_regs.cpdir1 = ioread32be(®s->cpdir1);
qe_gc->saved_regs.cpdir2 = ioread32be(®s->cpdir2);
qe_gc->saved_regs.cppar1 = ioread32be(®s->cppar1);
qe_gc->saved_regs.cppar2 = ioread32be(®s->cppar2);
qe_gc->saved_regs.cpodr = ioread32be(®s->cpodr);
}
static int qe_gpio_get(struct gpio_chip *gc, unsigned int gpio)
{
struct qe_gpio_chip *qe_gc = gpiochip_get_data(gc);
struct qe_pio_regs __iomem *regs = qe_gc->regs;
u32 pin_mask = PIN_MASK(gpio);
return !!(ioread32be(®s->cpdata) & pin_mask);
}
static int qe_gpio_set(struct gpio_chip *gc, unsigned int gpio, int val)
{
struct qe_gpio_chip *qe_gc = gpiochip_get_data(gc);
struct qe_pio_regs __iomem *regs = qe_gc->regs;
unsigned long flags;
u32 pin_mask = PIN_MASK(gpio);
spin_lock_irqsave(&qe_gc->lock, flags);
if (val)
qe_gc->cpdata |= pin_mask;
else
qe_gc->cpdata &= ~pin_mask;
iowrite32be(qe_gc->cpdata, ®s->cpdata);
spin_unlock_irqrestore(&qe_gc->lock, flags);
return 0;
}
static int qe_gpio_set_multiple(struct gpio_chip *gc,
unsigned long *mask, unsigned long *bits)
{
struct qe_gpio_chip *qe_gc = gpiochip_get_data(gc);
struct qe_pio_regs __iomem *regs = qe_gc->regs;
unsigned long flags;
int i;
spin_lock_irqsave(&qe_gc->lock, flags);
for (i = 0; i < gc->ngpio; i++) {
if (*mask == 0)
break;
if (__test_and_clear_bit(i, mask)) {
if (test_bit(i, bits))
qe_gc->cpdata |= PIN_MASK(i);
else
qe_gc->cpdata &= ~PIN_MASK(i);
}
}
iowrite32be(qe_gc->cpdata, ®s->cpdata);
spin_unlock_irqrestore(&qe_gc->lock, flags);
return 0;
}
static int qe_gpio_dir_in(struct gpio_chip *gc, unsigned int gpio)
{
struct qe_gpio_chip *qe_gc = gpiochip_get_data(gc);
unsigned long flags;
spin_lock_irqsave(&qe_gc->lock, flags);
Annotation
- Immediate include surface: `linux/kernel.h`, `linux/init.h`, `linux/spinlock.h`, `linux/err.h`, `linux/io.h`, `linux/gpio/consumer.h`, `linux/gpio/driver.h`, `linux/slab.h`.
- Detected declarations: `struct qe_gpio_chip`, `struct qe_pin`, `function qe_gpio_save_regs`, `function qe_gpio_get`, `function qe_gpio_set`, `function qe_gpio_set_multiple`, `function qe_gpio_dir_in`, `function qe_gpio_dir_out`, `function qe_pin_request`, `function qe_pin_set_dedicated`.
- Atlas domain: Driver Families / drivers/soc.
- Implementation status: integration implementation candidate.
- Synchronization appears in or near this file; preserve lock ordering, sleepability, and interrupt-context constraints.
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.