drivers/pinctrl/sunplus/sppctl.c
Source file repositories/reference/linux-study-clean/drivers/pinctrl/sunplus/sppctl.c
File Facts
- System
- Linux kernel
- Corpus path
drivers/pinctrl/sunplus/sppctl.c- Extension
.c- Size
- 32494 bytes
- Lines
- 1130
- Domain
- Driver Families
- Bucket
- drivers/pinctrl
- 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.
- 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/cleanup.hlinux/bitfield.hlinux/device.hlinux/err.hlinux/gpio/driver.hlinux/init.hlinux/module.hlinux/of.hlinux/overflow.hlinux/platform_device.hlinux/seq_file.hlinux/slab.hlinux/pinctrl/pinconf.hlinux/pinctrl/pinconf-generic.hlinux/pinctrl/pinmux.hdt-bindings/pinctrl/sppctl-sp7021.h../core.h../pinctrl-utils.hsppctl.h
Detected Declarations
struct sppctl_gpio_chipfunction sppctl_first_readlfunction sppctl_first_writelfunction sppctl_gpio_master_readlfunction sppctl_gpio_master_writelfunction sppctl_gpio_oe_readlfunction sppctl_gpio_oe_writelfunction sppctl_gpio_out_writelfunction sppctl_gpio_in_readlfunction sppctl_gpio_iinv_readlfunction sppctl_gpio_iinv_writelfunction sppctl_gpio_oinv_readlfunction sppctl_gpio_oinv_writelfunction sppctl_gpio_od_readlfunction sppctl_gpio_od_writelfunction sppctl_get_reg_and_bit_offsetfunction sppctl_get_moon_reg_and_bit_offsetfunction sppctl_prep_moon_reg_and_offsetfunction sppctl_func_setfunction sppctl_gmx_setfunction sppctl_first_getfunction sppctl_master_getfunction sppctl_first_master_setfunction sppctl_gpio_input_inv_setfunction sppctl_gpio_output_inv_setfunction sppctl_gpio_output_od_getfunction sppctl_gpio_output_od_setfunction sppctl_gpio_get_directionfunction sppctl_gpio_inv_getfunction sppctl_gpio_direction_inputfunction sppctl_gpio_direction_outputfunction sppctl_gpio_getfunction sppctl_gpio_setfunction sppctl_gpio_set_configfunction sppctl_gpio_dbg_showfunction sppctl_gpio_newfunction sppctl_pin_config_getfunction sppctl_pin_config_setfunction sppctl_get_functions_countfunction sppctl_get_function_groupsfunction sppctl_fully_pinmux_convfunction sppctl_set_muxfunction sppctl_gpio_request_enablefunction sppctl_get_groups_countfunction sppctl_get_group_pinsfunction sppctl_pin_dbg_showfunction sppctl_dt_node_to_mapfunction of_property_for_each_string
Annotated Snippet
struct sppctl_gpio_chip {
void __iomem *gpioxt_base; /* MASTER, OE, OUT, IN, I_INV, O_INV, OD */
void __iomem *first_base; /* GPIO_FIRST */
struct gpio_chip chip;
spinlock_t lock; /* lock for accessing OE register */
};
static inline u32 sppctl_first_readl(struct sppctl_gpio_chip *spp_gchip, u32 off)
{
return readl(spp_gchip->first_base + SPPCTL_GPIO_OFF_FIRST + off);
}
static inline void sppctl_first_writel(struct sppctl_gpio_chip *spp_gchip, u32 val, u32 off)
{
writel(val, spp_gchip->first_base + SPPCTL_GPIO_OFF_FIRST + off);
}
static inline u32 sppctl_gpio_master_readl(struct sppctl_gpio_chip *spp_gchip, u32 off)
{
return readl(spp_gchip->gpioxt_base + SPPCTL_GPIO_OFF_MASTER + off);
}
static inline void sppctl_gpio_master_writel(struct sppctl_gpio_chip *spp_gchip, u32 val,
u32 off)
{
writel(val, spp_gchip->gpioxt_base + SPPCTL_GPIO_OFF_MASTER + off);
}
static inline u32 sppctl_gpio_oe_readl(struct sppctl_gpio_chip *spp_gchip, u32 off)
{
return readl(spp_gchip->gpioxt_base + SPPCTL_GPIO_OFF_OE + off);
}
static inline void sppctl_gpio_oe_writel(struct sppctl_gpio_chip *spp_gchip, u32 val, u32 off)
{
writel(val, spp_gchip->gpioxt_base + SPPCTL_GPIO_OFF_OE + off);
}
static inline void sppctl_gpio_out_writel(struct sppctl_gpio_chip *spp_gchip, u32 val, u32 off)
{
writel(val, spp_gchip->gpioxt_base + SPPCTL_GPIO_OFF_OUT + off);
}
static inline u32 sppctl_gpio_in_readl(struct sppctl_gpio_chip *spp_gchip, u32 off)
{
return readl(spp_gchip->gpioxt_base + SPPCTL_GPIO_OFF_IN + off);
}
static inline u32 sppctl_gpio_iinv_readl(struct sppctl_gpio_chip *spp_gchip, u32 off)
{
return readl(spp_gchip->gpioxt_base + SPPCTL_GPIO_OFF_IINV + off);
}
static inline void sppctl_gpio_iinv_writel(struct sppctl_gpio_chip *spp_gchip, u32 val,
u32 off)
{
writel(val, spp_gchip->gpioxt_base + SPPCTL_GPIO_OFF_IINV + off);
}
static inline u32 sppctl_gpio_oinv_readl(struct sppctl_gpio_chip *spp_gchip, u32 off)
{
return readl(spp_gchip->gpioxt_base + SPPCTL_GPIO_OFF_OINV + off);
}
static inline void sppctl_gpio_oinv_writel(struct sppctl_gpio_chip *spp_gchip, u32 val,
u32 off)
{
writel(val, spp_gchip->gpioxt_base + SPPCTL_GPIO_OFF_OINV + off);
}
static inline u32 sppctl_gpio_od_readl(struct sppctl_gpio_chip *spp_gchip, u32 off)
{
return readl(spp_gchip->gpioxt_base + SPPCTL_GPIO_OFF_OD + off);
}
static inline void sppctl_gpio_od_writel(struct sppctl_gpio_chip *spp_gchip, u32 val, u32 off)
{
writel(val, spp_gchip->gpioxt_base + SPPCTL_GPIO_OFF_OD + off);
}
static inline u32 sppctl_get_reg_and_bit_offset(unsigned int offset, u32 *reg_off)
{
u32 bit_off;
/* Each register has 32 bits. */
*reg_off = (offset / 32) * 4;
bit_off = offset % 32;
return bit_off;
Annotation
- Immediate include surface: `linux/cleanup.h`, `linux/bitfield.h`, `linux/device.h`, `linux/err.h`, `linux/gpio/driver.h`, `linux/init.h`, `linux/module.h`, `linux/of.h`.
- Detected declarations: `struct sppctl_gpio_chip`, `function sppctl_first_readl`, `function sppctl_first_writel`, `function sppctl_gpio_master_readl`, `function sppctl_gpio_master_writel`, `function sppctl_gpio_oe_readl`, `function sppctl_gpio_oe_writel`, `function sppctl_gpio_out_writel`, `function sppctl_gpio_in_readl`, `function sppctl_gpio_iinv_readl`.
- Atlas domain: Driver Families / drivers/pinctrl.
- Implementation status: source 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.