devm_fwnode_...get_optional(9)

💖 devm_fwnode_gpiod_get_optional — obtain an optional GPIO from firmware node 💖

okay so bestie, welcome to the devm_fwnode_...get_optional(9) page from the Kernel API Manual ✨ (yes the title is a whole abbreviation situation, the full name is devm_fwnode_gpiod_get_optional, and like… it's a mouthful but we move 💅).

---

✨ SYNOPSIS ✨

struct gpio_desc * devm_fwnode_gpiod_get_optional (struct device *dev ,
struct fwnode_handle *fwnode , const char *con_id , enum gpiod_flags
flags , const char *label );

like just look at that signature, she's got five arguments and she's serving 💅

---

🫶 ARGUMENTS 🫶

• dev — the GPIO consumer. the main character, basically 👑
• fwnode — handle of the firmware node 🦋
• con_id — the function within the GPIO consumer 🌸
• flags — GPIO initialization flags, the little settings gremlins ⚙️✨
• label — the label you attach to the requested GPIO 🎀

---

🌈 DESCRIPTION 🌈

so this function is lowkey made for drivers that get their configuration from opaque firmware 👀 — like, the driver doesn't know the details, it just asks the firmware and the firmware knows. iykyk.

and here's the iconic part: the GPIO descriptors you get back from this function are automatically disposed on driver detach 🧚✨ like bestie it cleans up after itself, no manual freeing, we love a self-sufficient queen 💅

---

🔥 RETURN 🔥

so what do you get back? it's giving multiple possibilities, keep up:

• the GPIO descriptor corresponding to the optional function con_id of device dev 💖
• NULL if no GPIO has been assigned to the requested function 🙈
• or another IS_ERR code if an error occurred while trying to acquire the GPIO 💀

fr fr check for errors, don't just assume it worked 😭

---

🦋 SEE ALSO 🦋

• Kernel file ./include/linux/gpio/consumer.h
• struct gpio_descs(9)
• enum gpiod_flags(9)

---

and that's the whole vibe bestie, go forth and get those optional GPIOs 🍓💜

sign-off szn: this lil masterpiece comes from the ./include/linux/gpio source, dated October 2026, and it's filed under devm_fwnode_...get_optional(9) — periodt 💅✨🎀