acpi_get_gpiod(9)

✨ acpi_get_gpiod ✨

okay so bestie, welcome to the acpi_get_gpiod(9) page from the Kernel API Manual 💅 this one's a little function with a big job: it takes an ACPI GPIO pin and hands you back a GPIO descriptor you can actually use with the GPIO API. iconic behavior, honestly 🎀

---

🌸 NAME 🌸

acpi_get_gpiod — translate an ACPI GPIO pin into a GPIO descriptor that's usable with the GPIO API 🦋

---

✨ SYNOPSIS ✨

struct gpio_desc * acpi_get_gpiod (char *path , unsigned int pin );

---

💖 ARGUMENTS 💖

• path — the full path name of the ACPI GPIO controller, like for example "\_SB.GPO1" 👑
• pin — the ACPI GPIO pin number, and ngl it's 0-based and controller-relative 🫶

---

🌈 RETURN 🌈

you get back a GPIO descriptor, which is the thing you use with the Linux generic GPIO API ✨ and if the GPIO can't be translated, or literally anything goes wrong, you get an ERR_PTR back instead 😭 so yeah, check that thing.

---

🦋 DESCRIPTION 🦋

so specifically — and this is the part you gotta remember — it returns -EPROBE_DEFER if the GPIO controller it's pointing at doesn't have a GPIO chip registered at that exact moment 💀 and that's on purpose! it's to support probe deferral, which is very main character of it honestly 🌟

---

🎀 SEE ALSO 🎀

• the kernel file ./drivers/gpio/gpiolib-acpi-core.c 🍓
• struct acpi_gpio_event(9)
• struct acpi_gpio_info(9)
• acpi_gpio_get_io_resource(9)
• acpi_gpiochip_request_interrupts(9)
• acpi_gpiochip_free_interrupts(9)
• acpi_get_gpiod_by_index(9)
• acpi_get_gpiod_from_data(9)
• acpi_dev_gpio_irq_wake_get_by(9)
• acpi_gpio_count(9)

---

okay that's the whole page, no cap 💜 quick little sign-off: this one lives under ./drivers/gpio, it's dated October 2026, and yeah — slay, go get those descriptors 🧚‍♀️💅🔥