]> git.ipfire.org Git - thirdparty/kernel/linux.git/commitdiff
of: base: Add of_property_read_u8_index
authorSrinivas Kandagatla <srinivas.kandagatla@oss.qualcomm.com>
Fri, 12 Sep 2025 08:32:19 +0000 (09:32 +0100)
committerVinod Koul <vkoul@kernel.org>
Mon, 8 Dec 2025 07:07:26 +0000 (12:37 +0530)
Add support for of_property_read_u8_index(), simillar to others
u16 and u32 variants. Having this helper makes the code more tidy in
isome cases, specially when we are parsing multiple of these into
data structures.

Signed-off-by: Srinivas Kandagatla <srinivas.kandagatla@oss.qualcomm.com>
Reviewed-by: Rob Herring (Arm) <robh@kernel.org>
Tested-by: Alexey Klimov <alexey.klimov@linaro.org> # sm8550
Link: https://patch.msgid.link/20250912083225.228778-2-srinivas.kandagatla@oss.qualcomm.com
Signed-off-by: Vinod Koul <vkoul@kernel.org>
drivers/of/property.c
include/linux/of.h

index c1feb631e3831d7d5ec23c606af31731bfc2f8b8..4e3524227720a596b0f12976f83357851e9b94f3 100644 (file)
@@ -147,6 +147,39 @@ static void *of_find_property_value_of_size(const struct device_node *np,
        return prop->value;
 }
 
+/**
+ * of_property_read_u8_index - Find and read a u8 from a multi-value property.
+ *
+ * @np:                device node from which the property value is to be read.
+ * @propname:  name of the property to be searched.
+ * @index:     index of the u8 in the list of values
+ * @out_value: pointer to return value, modified only if no error.
+ *
+ * Search for a property in a device node and read nth 8-bit value from
+ * it.
+ *
+ * Return: 0 on success, -EINVAL if the property does not exist,
+ * -ENODATA if property does not have a value, and -EOVERFLOW if the
+ * property data isn't large enough.
+ *
+ * The out_value is modified only if a valid u8 value can be decoded.
+ */
+int of_property_read_u8_index(const struct device_node *np,
+                                      const char *propname,
+                                      u32 index, u8 *out_value)
+{
+       const u8 *val = of_find_property_value_of_size(np, propname,
+                                       ((index + 1) * sizeof(*out_value)),
+                                       0, NULL);
+
+       if (IS_ERR(val))
+               return PTR_ERR(val);
+
+       *out_value = val[index];
+       return 0;
+}
+EXPORT_SYMBOL_GPL(of_property_read_u8_index);
+
 /**
  * of_property_read_u16_index - Find and read a u16 from a multi-value property.
  *
index 121a288ca92df7d84aa5a0125f6f03c969f97df4..57fb598b72d3db32e146b1085293533b465de756 100644 (file)
@@ -316,6 +316,9 @@ extern struct property *of_find_property(const struct device_node *np,
 extern bool of_property_read_bool(const struct device_node *np, const char *propname);
 extern int of_property_count_elems_of_size(const struct device_node *np,
                                const char *propname, int elem_size);
+extern int of_property_read_u8_index(const struct device_node *np,
+                                      const char *propname,
+                                      u32 index, u8 *out_value);
 extern int of_property_read_u16_index(const struct device_node *np,
                                       const char *propname,
                                       u32 index, u16 *out_value);
@@ -646,6 +649,12 @@ static inline int of_property_count_elems_of_size(const struct device_node *np,
        return -ENOSYS;
 }
 
+static inline int of_property_read_u8_index(const struct device_node *np,
+                       const char *propname, u32 index, u8 *out_value)
+{
+       return -ENOSYS;
+}
+
 static inline int of_property_read_u16_index(const struct device_node *np,
                        const char *propname, u32 index, u16 *out_value)
 {