of_property_read_u16_array(9)

💅 of_property_read_u16_array(9) 💅

okay so this is a page straight out of the Kernel API Manual, bestie — yes the actual kernel API manual, we're in the big leagues now 🎀 — and it's all about of_property_read_u16_array, which is the little function that goes "hey, does this device node have that property? cool, gimme the 16-bit numbers in it" ✨

---

🌸 NAME 🌸

of_property_read_u16_array — find and read an array of u16 from a property. that's it, that's the whole vibe 🫶

---

🦋 SYNOPSIS 🦋

int of_property_read_u16_array (const struct device_node *np , const
char *propname , u16 *out_values , size_t sz );

literally just copy that exactly, no cap 💀

---

✨ ARGUMENTS ✨

• np — the device node you're reading the property value from. your starting point, your main character 🫶
• propname — the name of the property we're searching for, iykyk 🔍
• out_values — pointer to the return value. heads up: it only gets modified if the return value is 0, so don't go reading it before you check 👀
• sz — how many array elements to read. the count, the amount, the numbers, periodt 💅

---

🧚 DESCRIPTION 🧚

so what it does is: it searches for a property inside a device node and reads 16-bit value(s) out of it. simple, iconic, does exactly what it says 🌈

the dts entry of the array should look like this, exactly:

property = /bits/ 16 <0x5000 0x6000 0x7000>;

and one thing to really internalize: out_values is modified only if a valid u16 value can be decoded 💖 like, it's not gonna half-fill your buffer with nonsense and dip — no valid decode, no touch. respect.

---

🔥 RETURN 🔥

• 0 on success — slay, we ate 🎉
• -EINVAL if the property does not exist — it's not there, bestie, it's giving nothing 😭
• -ENODATA if the property does not have a value — the property exists but it's empty inside, relatable 💀
• -EOVERFLOW if the property data isn't large enough — not enough bytes to go around, overflow behavior, no cap ⚠️

---

👑 SEE ALSO 👑

kernel file ./include/linux/of.h, plus the whole friend group:

• of_node_init(9)
• of_machine_is_compatible(9)
• of_parse_phandle(9)
• of_parse_phandle_with_args(9)
• of_parse_phandle_with_fixed_args(9)
• of_parse_phandle_with_optional_args(9)
• of_phandle_args_equal(9)
• of_property_count_u8_elems(9)
• of_property_count_u16_elems(9)
• of_property_count_u32_elems(9)
• of_property_count_u64_elems(9)
• of_property_read_string_array(9)
• of_property_count_strings(9)
• of_property_read_string_index(9)
• of_property_present(9)
• of_property_read_u8_array(9)
• of_property_read_u32_array(9)
• of_property_read_u64_array(9)
• struct of_changeset_entry(9)
• struct of_changeset(9)
• of_device_is_system_power_controller(9)
• of_have_populated_dt(9)

---

and that's the whole page, bestie 🥰 sourced from ./include/linux, dated October 2026, still signed of_property_read_u16_array(9) — mwah, go read some device trees, ily 💜🦋🎀