drivers/pinctrl/pinctrl-scmi.c
Source file repositories/reference/linux-study-clean/drivers/pinctrl/pinctrl-scmi.c
File Facts
- System
- Linux kernel
- Corpus path
drivers/pinctrl/pinctrl-scmi.c- Extension
.c- Size
- 15299 bytes
- Lines
- 601
- 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.
- 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/device.hlinux/err.hlinux/errno.hlinux/module.hlinux/mod_devicetable.hlinux/of.hlinux/scmi_protocol.hlinux/slab.hlinux/types.hlinux/pinctrl/machine.hlinux/pinctrl/pinconf.hlinux/pinctrl/pinconf-generic.hlinux/pinctrl/pinctrl.hlinux/pinctrl/pinmux.hpinctrl-utils.hcore.hpinconf.h
Detected Declarations
struct scmi_pinctrlfunction pinctrl_scmi_get_groups_countfunction pinctrl_scmi_get_group_pinsfunction pinctrl_scmi_get_functions_countfunction pinctrl_scmi_get_function_groupsfunction pinctrl_scmi_func_set_muxfunction pinctrl_scmi_requestfunction pinctrl_scmi_freefunction pinctrl_scmi_map_pinconf_typefunction pinctrl_scmi_map_pinconf_type_getfunction pinctrl_scmi_map_pinconf_type_setfunction pinctrl_scmi_pinconf_getfunction pinctrl_scmi_alloc_configsfunction pinctrl_scmi_free_configsfunction pinctrl_scmi_pinconf_setfunction pinctrl_scmi_pinconf_group_setfunction pinctrl_scmi_pinconf_group_getfunction pinctrl_scmi_get_pinsfunction scmi_pinctrl_probe
Annotated Snippet
struct scmi_pinctrl {
struct device *dev;
struct scmi_protocol_handle *ph;
struct pinctrl_dev *pctldev;
struct pinctrl_desc pctl_desc;
struct pinfunction *functions;
unsigned int nr_functions;
};
static int pinctrl_scmi_get_groups_count(struct pinctrl_dev *pctldev)
{
struct scmi_pinctrl *pmx = pinctrl_dev_get_drvdata(pctldev);
return pinctrl_ops->count_get(pmx->ph, GROUP_TYPE);
}
static const char *pinctrl_scmi_get_group_name(struct pinctrl_dev *pctldev,
unsigned int selector)
{
int ret;
const char *name;
struct scmi_pinctrl *pmx = pinctrl_dev_get_drvdata(pctldev);
ret = pinctrl_ops->name_get(pmx->ph, selector, GROUP_TYPE, &name);
if (ret) {
dev_err(pmx->dev, "get name failed with err %d", ret);
return NULL;
}
return name;
}
static int pinctrl_scmi_get_group_pins(struct pinctrl_dev *pctldev,
unsigned int selector,
const unsigned int **pins,
unsigned int *num_pins)
{
struct scmi_pinctrl *pmx = pinctrl_dev_get_drvdata(pctldev);
return pinctrl_ops->group_pins_get(pmx->ph, selector, pins, num_pins);
}
static const struct pinctrl_ops pinctrl_scmi_pinctrl_ops = {
.get_groups_count = pinctrl_scmi_get_groups_count,
.get_group_name = pinctrl_scmi_get_group_name,
.get_group_pins = pinctrl_scmi_get_group_pins,
#ifdef CONFIG_OF
.dt_node_to_map = pinconf_generic_dt_node_to_map_all,
.dt_free_map = pinconf_generic_dt_free_map,
#endif
};
static int pinctrl_scmi_get_functions_count(struct pinctrl_dev *pctldev)
{
struct scmi_pinctrl *pmx = pinctrl_dev_get_drvdata(pctldev);
return pinctrl_ops->count_get(pmx->ph, FUNCTION_TYPE);
}
static const char *pinctrl_scmi_get_function_name(struct pinctrl_dev *pctldev,
unsigned int selector)
{
int ret;
const char *name;
struct scmi_pinctrl *pmx = pinctrl_dev_get_drvdata(pctldev);
ret = pinctrl_ops->name_get(pmx->ph, selector, FUNCTION_TYPE, &name);
if (ret) {
dev_err(pmx->dev, "get name failed with err %d", ret);
return NULL;
}
return name;
}
static int pinctrl_scmi_get_function_groups(struct pinctrl_dev *pctldev,
unsigned int selector,
const char * const **p_groups,
unsigned int * const p_num_groups)
{
struct pinfunction *func;
const unsigned int *group_ids;
unsigned int num_groups;
const char **groups;
int ret, i;
struct scmi_pinctrl *pmx = pinctrl_dev_get_drvdata(pctldev);
if (!p_groups || !p_num_groups)
return -EINVAL;
Annotation
- Immediate include surface: `linux/device.h`, `linux/err.h`, `linux/errno.h`, `linux/module.h`, `linux/mod_devicetable.h`, `linux/of.h`, `linux/scmi_protocol.h`, `linux/slab.h`.
- Detected declarations: `struct scmi_pinctrl`, `function pinctrl_scmi_get_groups_count`, `function pinctrl_scmi_get_group_pins`, `function pinctrl_scmi_get_functions_count`, `function pinctrl_scmi_get_function_groups`, `function pinctrl_scmi_func_set_mux`, `function pinctrl_scmi_request`, `function pinctrl_scmi_free`, `function pinctrl_scmi_map_pinconf_type`, `function pinctrl_scmi_map_pinconf_type_get`.
- Atlas domain: Driver Families / drivers/pinctrl.
- Implementation status: source 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.