snd_hda_set_pin_ctl(9)

📦 version 7.3.1, in nixpkgs unstable

💅 snd_hda_set_pin_ctl(9) — like, the safest way to set a pin-control value 🎀

okay bestie, welcome to the Kernel API Manual ✨ this is snd_hda_set_pin_ctl, and honestly? she's giving responsible queen energy. no cap.

✨ NAME ✨

snd_hda_set_pin_ctl — Set a pin-control value safely 🫶 (yes, the "safely" is the whole point, we'll get there)

🌸 SYNOPSIS 🌸

int snd_hda_set_pin_ctl (struct hda_codec *codec , hda_nid_t pin ,
   unsigned int val );

like, that's the whole signature. int going in, int coming out, we love a consistent icon 💖

🦋 ARGUMENTS 🦋

  • codec — the codec instance 💫 the main character of this whole operation
  • pin — the pin NID you wanna set the control on 🎯 the specific little guy
  • val — the pin-control value, and it's made of AC_PINCTL_* bits 🧩 stack 'em up

👑 DESCRIPTION 👑

so here's the tea ☕ this function sets the pin-control value on the given pin, but — and this is the slay part — it filters out the invalid pin-control bits when the pin doesn't actually have those capabilities. it literally does the vibe check for you 💅

for example: when PIN_HP gets passed but the pin has no HP-drive capability? the HP bit is just... omitted. not me quietly deleting the bit you can't have 🙈 iconic behavior honestly.

BUT — and this is a big but, listen up — the function doesn't check the input VREF capability bits, though. like, at all. so if you need to guess the right value, use snd_hda_get_default_vref 🌈 she'll help you out.

also fr fr: this function is only for analog pins, not for HDMI pins. HDMI girlies, this is not your function, sorry not sorry 💀

🎀 SEE ALSO 🎀

all the sisters in the same friend group, go say hi 🫶✨

k that's the whole page, mwah 😘 this came to you from ./sound/hda/common, dated October 2026, and yes she's still serving snd_hda_set_pin_ctl(9) realness ⭐ bye bestie, go set some pins safely 💜🦋

📦 where this page comes from