of_property_read_u8_array(9)

🦋 of_property_read_u8_array(9) 🦋

okay so this is a page from the Kernel API Manual, and honestly? it's a little icon of a function. let's get into it ✨

---

🌸 NAME 🌸

of_property_read_u8_array — find a property and read an array of u8 out of it. yes bestie, an array, plural, multiple lil bytes. 💅

---

🎀 SYNOPSIS 🎀

int of_property_read_u8_array (const struct device_node *np , const char
*propname , u8 *out_values , size_t sz );

---

💖 ARGUMENTS 💖

• np — the device node you're reading the property value from. your starting point, your home base 🏠
• propname — the name of the property we're out here searching for, like a lil scavenger hunt 🔍
• out_values — pointer to the return value. heads up though: it's modified only if the return value is 0. no success, no touchy 🙈
• sz — how many array elements we're reading. the count. the amount. the vibe check number 💫

---

✨ DESCRIPTION ✨

so what it does: search for a property inside a device node and read 8-bit value(s) from it. that's it, that's the gig 🫶

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

property = /bits/ 8 <0x50 0x60 0x70>;

and the out_values? it's modified only if a valid u8 value can be decoded. no valid decode = no writes, periodt 💀

---

🔥 RETURN 🔥

• 0 — slay, success 👑
• -EINVAL — the property does not exist 😭
• -ENODATA — the property exists but does not have a value 🫠
• -EOVERFLOW — the property data isn't large enough 💀

---

🌈 SEE ALSO 🌈

go read these next, bestie, they're all in the kernel file ./include/linux/of.h:

• 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_u16_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, you ate that 💅✨

mwah 💋 — this one came from ./include/linux, dated October 2026, and it's still signed of_property_read_u8_array(9) because consistency is iconic 🌟