pinctrl_add_gpio_range(9)

💖 pinctrl_add_gpio_range — the Kernel API Manual, bestie edition 💖

okay so this page is pinctrl_add_gpio_range(9) from the Kernel API Manual and it's literally about registering a GPIO range for a controller ✨ buckle up, it's a short one but the tea is important 🫖

---

🌸 NAME 🌸

pinctrl_add_gpio_range — register a GPIO range for a controller 👑

---

✨ SYNOPSIS ✨

void pinctrl_add_gpio_range (struct pinctrl_dev *pctldev , struct
pinctrl_gpio_range *range );

no cap, that's the whole signature 💅

---

🎀 ARGUMENTS 🎀

• pctldev — the pin controller device you're adding the range to 🦋
• range — the actual GPIO range you're adding, like the thing itself 🌸

---

🔥 DESCRIPTION 🔥

🚨 DEPRECATED: Don't use this function in new code. fr fr. See section 2 of Documentation/devicetree/bindings/gpio/gpio.txt on how to bind pinctrl and gpio drivers. that's the main character doc, go read it 💅

so what does it even do? it adds a range of GPIOs to be handled by a certain pin controller 💖

call this to register handled ranges after registering your pin controller — order matters bestie, don't skip ahead 😭

---

👑 SEE ALSO 👑

Kernel file ./drivers/pinctrl/core.c — and like, the entire extended friend group 💜:

• pinctrl_provide_dummies(9)
• get_pinctrl_dev_from_devname(9)
• pin_get_from_name(9)
• pin_get_name(9)
• gpio_to_pin(9)
• pinctrl_match_gpio_range(9)
• pinctrl_ready_for_gpio_range(9)
• pinctrl_get_device_gpio_range(9)
• pinctrl_find_gpio_range_from_pin(9)
• pinctrl_remove_gpio_range(9)
• pinctrl_generic_get_group_count(9)
• pinctrl_generic_get_group_name(9)
• pinctrl_generic_get_group_pins(9)
• pinctrl_generic_get_group(9)
• pinctrl_generic_add_group(9)
• pinctrl_generic_remove_group(9)
• pinctrl_generic_free_groups(9)
• pinctrl_get_group_selector(9)
• pinctrl_gpio_request(9)
• pinctrl_gpio_free(9)
• pinctrl_gpio_direction_input(9)
• pinctrl_gpio_direction_output(9)
• pinctrl_gpio_set_config(9)
• pinctrl_gpio_get_config(9)
• pinctrl_get(9)
• pinctrl_release(9)
• pinctrl_put(9)
• pinctrl_lookup_state(9)
• pinctrl_commit_state(9)
• pinctrl_select_state(9)
• devm_pinctrl_get(9)
• devm_pinctrl_put(9)
• pinctrl_register_mappings(9)
• pinctrl_unregister_mappings(9)
• devm_pinctrl_register_mappings(9)
• pinctrl_force_sleep(9)
• pinctrl_force_default(9)
• pinctrl_init_done(9)
• pinctrl_select_default_state(9)
• pinctrl_pm_select_default_state(9)
• pinctrl_pm_select_init_state(9)
• pinctrl_pm_select_sleep_state(9)
• pinctrl_pm_select_idle_state(9)
• pinctrl_init_controller(9)
• pinctrl_register(9)
• pinctrl_register_and_init(9)
• pinctrl_unregister(9)
• devm_pinctrl_register(9)
• devm_pinctrl_register_and_init(9)

---

and that's the whole vibe check 🧚 this little page lives in ./drivers/pinctrl and it's dated October 2026 — yes, we're being iconic in the future ⭐💀 bye bestie, go register ur ranges (or don't, it's deprecated 🙈) 🎀🌈💖