11df09bc6SSakari Ailus /* 21df09bc6SSakari Ailus * drivers/of/property.c - Procedures for accessing and interpreting 31df09bc6SSakari Ailus * Devicetree properties and graphs. 41df09bc6SSakari Ailus * 51df09bc6SSakari Ailus * Initially created by copying procedures from drivers/of/base.c. This 61df09bc6SSakari Ailus * file contains the OF property as well as the OF graph interface 71df09bc6SSakari Ailus * functions. 81df09bc6SSakari Ailus * 91df09bc6SSakari Ailus * Paul Mackerras August 1996. 101df09bc6SSakari Ailus * Copyright (C) 1996-2005 Paul Mackerras. 111df09bc6SSakari Ailus * 121df09bc6SSakari Ailus * Adapted for 64bit PowerPC by Dave Engebretsen and Peter Bergner. 131df09bc6SSakari Ailus * {engebret|bergner}@us.ibm.com 141df09bc6SSakari Ailus * 151df09bc6SSakari Ailus * Adapted for sparc and sparc64 by David S. Miller davem@davemloft.net 161df09bc6SSakari Ailus * 171df09bc6SSakari Ailus * Reconsolidated from arch/x/kernel/prom.c by Stephen Rothwell and 181df09bc6SSakari Ailus * Grant Likely. 191df09bc6SSakari Ailus * 201df09bc6SSakari Ailus * This program is free software; you can redistribute it and/or 211df09bc6SSakari Ailus * modify it under the terms of the GNU General Public License 221df09bc6SSakari Ailus * as published by the Free Software Foundation; either version 231df09bc6SSakari Ailus * 2 of the License, or (at your option) any later version. 241df09bc6SSakari Ailus */ 251df09bc6SSakari Ailus 261df09bc6SSakari Ailus #define pr_fmt(fmt) "OF: " fmt 271df09bc6SSakari Ailus 281df09bc6SSakari Ailus #include <linux/of.h> 291df09bc6SSakari Ailus #include <linux/of_device.h> 301df09bc6SSakari Ailus #include <linux/of_graph.h> 311df09bc6SSakari Ailus #include <linux/string.h> 321df09bc6SSakari Ailus 331df09bc6SSakari Ailus #include "of_private.h" 341df09bc6SSakari Ailus 351df09bc6SSakari Ailus /** 361df09bc6SSakari Ailus * of_property_count_elems_of_size - Count the number of elements in a property 371df09bc6SSakari Ailus * 381df09bc6SSakari Ailus * @np: device node from which the property value is to be read. 391df09bc6SSakari Ailus * @propname: name of the property to be searched. 401df09bc6SSakari Ailus * @elem_size: size of the individual element 411df09bc6SSakari Ailus * 421df09bc6SSakari Ailus * Search for a property in a device node and count the number of elements of 431df09bc6SSakari Ailus * size elem_size in it. Returns number of elements on sucess, -EINVAL if the 441df09bc6SSakari Ailus * property does not exist or its length does not match a multiple of elem_size 451df09bc6SSakari Ailus * and -ENODATA if the property does not have a value. 461df09bc6SSakari Ailus */ 471df09bc6SSakari Ailus int of_property_count_elems_of_size(const struct device_node *np, 481df09bc6SSakari Ailus const char *propname, int elem_size) 491df09bc6SSakari Ailus { 501df09bc6SSakari Ailus struct property *prop = of_find_property(np, propname, NULL); 511df09bc6SSakari Ailus 521df09bc6SSakari Ailus if (!prop) 531df09bc6SSakari Ailus return -EINVAL; 541df09bc6SSakari Ailus if (!prop->value) 551df09bc6SSakari Ailus return -ENODATA; 561df09bc6SSakari Ailus 571df09bc6SSakari Ailus if (prop->length % elem_size != 0) { 581df09bc6SSakari Ailus pr_err("size of %s in node %s is not a multiple of %d\n", 591df09bc6SSakari Ailus propname, np->full_name, elem_size); 601df09bc6SSakari Ailus return -EINVAL; 611df09bc6SSakari Ailus } 621df09bc6SSakari Ailus 631df09bc6SSakari Ailus return prop->length / elem_size; 641df09bc6SSakari Ailus } 651df09bc6SSakari Ailus EXPORT_SYMBOL_GPL(of_property_count_elems_of_size); 661df09bc6SSakari Ailus 671df09bc6SSakari Ailus /** 681df09bc6SSakari Ailus * of_find_property_value_of_size 691df09bc6SSakari Ailus * 701df09bc6SSakari Ailus * @np: device node from which the property value is to be read. 711df09bc6SSakari Ailus * @propname: name of the property to be searched. 721df09bc6SSakari Ailus * @min: minimum allowed length of property value 731df09bc6SSakari Ailus * @max: maximum allowed length of property value (0 means unlimited) 741df09bc6SSakari Ailus * @len: if !=NULL, actual length is written to here 751df09bc6SSakari Ailus * 761df09bc6SSakari Ailus * Search for a property in a device node and valid the requested size. 771df09bc6SSakari Ailus * Returns the property value on success, -EINVAL if the property does not 781df09bc6SSakari Ailus * exist, -ENODATA if property does not have a value, and -EOVERFLOW if the 791df09bc6SSakari Ailus * property data is too small or too large. 801df09bc6SSakari Ailus * 811df09bc6SSakari Ailus */ 821df09bc6SSakari Ailus static void *of_find_property_value_of_size(const struct device_node *np, 831df09bc6SSakari Ailus const char *propname, u32 min, u32 max, size_t *len) 841df09bc6SSakari Ailus { 851df09bc6SSakari Ailus struct property *prop = of_find_property(np, propname, NULL); 861df09bc6SSakari Ailus 871df09bc6SSakari Ailus if (!prop) 881df09bc6SSakari Ailus return ERR_PTR(-EINVAL); 891df09bc6SSakari Ailus if (!prop->value) 901df09bc6SSakari Ailus return ERR_PTR(-ENODATA); 911df09bc6SSakari Ailus if (prop->length < min) 921df09bc6SSakari Ailus return ERR_PTR(-EOVERFLOW); 931df09bc6SSakari Ailus if (max && prop->length > max) 941df09bc6SSakari Ailus return ERR_PTR(-EOVERFLOW); 951df09bc6SSakari Ailus 961df09bc6SSakari Ailus if (len) 971df09bc6SSakari Ailus *len = prop->length; 981df09bc6SSakari Ailus 991df09bc6SSakari Ailus return prop->value; 1001df09bc6SSakari Ailus } 1011df09bc6SSakari Ailus 1021df09bc6SSakari Ailus /** 1031df09bc6SSakari Ailus * of_property_read_u32_index - Find and read a u32 from a multi-value property. 1041df09bc6SSakari Ailus * 1051df09bc6SSakari Ailus * @np: device node from which the property value is to be read. 1061df09bc6SSakari Ailus * @propname: name of the property to be searched. 1071df09bc6SSakari Ailus * @index: index of the u32 in the list of values 1081df09bc6SSakari Ailus * @out_value: pointer to return value, modified only if no error. 1091df09bc6SSakari Ailus * 1101df09bc6SSakari Ailus * Search for a property in a device node and read nth 32-bit value from 1111df09bc6SSakari Ailus * it. Returns 0 on success, -EINVAL if the property does not exist, 1121df09bc6SSakari Ailus * -ENODATA if property does not have a value, and -EOVERFLOW if the 1131df09bc6SSakari Ailus * property data isn't large enough. 1141df09bc6SSakari Ailus * 1151df09bc6SSakari Ailus * The out_value is modified only if a valid u32 value can be decoded. 1161df09bc6SSakari Ailus */ 1171df09bc6SSakari Ailus int of_property_read_u32_index(const struct device_node *np, 1181df09bc6SSakari Ailus const char *propname, 1191df09bc6SSakari Ailus u32 index, u32 *out_value) 1201df09bc6SSakari Ailus { 1211df09bc6SSakari Ailus const u32 *val = of_find_property_value_of_size(np, propname, 1221df09bc6SSakari Ailus ((index + 1) * sizeof(*out_value)), 1231df09bc6SSakari Ailus 0, 1241df09bc6SSakari Ailus NULL); 1251df09bc6SSakari Ailus 1261df09bc6SSakari Ailus if (IS_ERR(val)) 1271df09bc6SSakari Ailus return PTR_ERR(val); 1281df09bc6SSakari Ailus 1291df09bc6SSakari Ailus *out_value = be32_to_cpup(((__be32 *)val) + index); 1301df09bc6SSakari Ailus return 0; 1311df09bc6SSakari Ailus } 1321df09bc6SSakari Ailus EXPORT_SYMBOL_GPL(of_property_read_u32_index); 1331df09bc6SSakari Ailus 1341df09bc6SSakari Ailus /** 1351df09bc6SSakari Ailus * of_property_read_u64_index - Find and read a u64 from a multi-value property. 1361df09bc6SSakari Ailus * 1371df09bc6SSakari Ailus * @np: device node from which the property value is to be read. 1381df09bc6SSakari Ailus * @propname: name of the property to be searched. 1391df09bc6SSakari Ailus * @index: index of the u64 in the list of values 1401df09bc6SSakari Ailus * @out_value: pointer to return value, modified only if no error. 1411df09bc6SSakari Ailus * 1421df09bc6SSakari Ailus * Search for a property in a device node and read nth 64-bit value from 1431df09bc6SSakari Ailus * it. Returns 0 on success, -EINVAL if the property does not exist, 1441df09bc6SSakari Ailus * -ENODATA if property does not have a value, and -EOVERFLOW if the 1451df09bc6SSakari Ailus * property data isn't large enough. 1461df09bc6SSakari Ailus * 1471df09bc6SSakari Ailus * The out_value is modified only if a valid u64 value can be decoded. 1481df09bc6SSakari Ailus */ 1491df09bc6SSakari Ailus int of_property_read_u64_index(const struct device_node *np, 1501df09bc6SSakari Ailus const char *propname, 1511df09bc6SSakari Ailus u32 index, u64 *out_value) 1521df09bc6SSakari Ailus { 1531df09bc6SSakari Ailus const u64 *val = of_find_property_value_of_size(np, propname, 1541df09bc6SSakari Ailus ((index + 1) * sizeof(*out_value)), 1551df09bc6SSakari Ailus 0, NULL); 1561df09bc6SSakari Ailus 1571df09bc6SSakari Ailus if (IS_ERR(val)) 1581df09bc6SSakari Ailus return PTR_ERR(val); 1591df09bc6SSakari Ailus 1601df09bc6SSakari Ailus *out_value = be64_to_cpup(((__be64 *)val) + index); 1611df09bc6SSakari Ailus return 0; 1621df09bc6SSakari Ailus } 1631df09bc6SSakari Ailus EXPORT_SYMBOL_GPL(of_property_read_u64_index); 1641df09bc6SSakari Ailus 1651df09bc6SSakari Ailus /** 1661df09bc6SSakari Ailus * of_property_read_variable_u8_array - Find and read an array of u8 from a 1671df09bc6SSakari Ailus * property, with bounds on the minimum and maximum array size. 1681df09bc6SSakari Ailus * 1691df09bc6SSakari Ailus * @np: device node from which the property value is to be read. 1701df09bc6SSakari Ailus * @propname: name of the property to be searched. 1711df09bc6SSakari Ailus * @out_values: pointer to return value, modified only if return value is 0. 1721df09bc6SSakari Ailus * @sz_min: minimum number of array elements to read 1731df09bc6SSakari Ailus * @sz_max: maximum number of array elements to read, if zero there is no 1741df09bc6SSakari Ailus * upper limit on the number of elements in the dts entry but only 1751df09bc6SSakari Ailus * sz_min will be read. 1761df09bc6SSakari Ailus * 1771df09bc6SSakari Ailus * Search for a property in a device node and read 8-bit value(s) from 1781df09bc6SSakari Ailus * it. Returns number of elements read on success, -EINVAL if the property 1791df09bc6SSakari Ailus * does not exist, -ENODATA if property does not have a value, and -EOVERFLOW 1801df09bc6SSakari Ailus * if the property data is smaller than sz_min or longer than sz_max. 1811df09bc6SSakari Ailus * 1821df09bc6SSakari Ailus * dts entry of array should be like: 1831df09bc6SSakari Ailus * property = /bits/ 8 <0x50 0x60 0x70>; 1841df09bc6SSakari Ailus * 1851df09bc6SSakari Ailus * The out_values is modified only if a valid u8 value can be decoded. 1861df09bc6SSakari Ailus */ 1871df09bc6SSakari Ailus int of_property_read_variable_u8_array(const struct device_node *np, 1881df09bc6SSakari Ailus const char *propname, u8 *out_values, 1891df09bc6SSakari Ailus size_t sz_min, size_t sz_max) 1901df09bc6SSakari Ailus { 1911df09bc6SSakari Ailus size_t sz, count; 1921df09bc6SSakari Ailus const u8 *val = of_find_property_value_of_size(np, propname, 1931df09bc6SSakari Ailus (sz_min * sizeof(*out_values)), 1941df09bc6SSakari Ailus (sz_max * sizeof(*out_values)), 1951df09bc6SSakari Ailus &sz); 1961df09bc6SSakari Ailus 1971df09bc6SSakari Ailus if (IS_ERR(val)) 1981df09bc6SSakari Ailus return PTR_ERR(val); 1991df09bc6SSakari Ailus 2001df09bc6SSakari Ailus if (!sz_max) 2011df09bc6SSakari Ailus sz = sz_min; 2021df09bc6SSakari Ailus else 2031df09bc6SSakari Ailus sz /= sizeof(*out_values); 2041df09bc6SSakari Ailus 2051df09bc6SSakari Ailus count = sz; 2061df09bc6SSakari Ailus while (count--) 2071df09bc6SSakari Ailus *out_values++ = *val++; 2081df09bc6SSakari Ailus 2091df09bc6SSakari Ailus return sz; 2101df09bc6SSakari Ailus } 2111df09bc6SSakari Ailus EXPORT_SYMBOL_GPL(of_property_read_variable_u8_array); 2121df09bc6SSakari Ailus 2131df09bc6SSakari Ailus /** 2141df09bc6SSakari Ailus * of_property_read_variable_u16_array - Find and read an array of u16 from a 2151df09bc6SSakari Ailus * property, with bounds on the minimum and maximum array size. 2161df09bc6SSakari Ailus * 2171df09bc6SSakari Ailus * @np: device node from which the property value is to be read. 2181df09bc6SSakari Ailus * @propname: name of the property to be searched. 2191df09bc6SSakari Ailus * @out_values: pointer to return value, modified only if return value is 0. 2201df09bc6SSakari Ailus * @sz_min: minimum number of array elements to read 2211df09bc6SSakari Ailus * @sz_max: maximum number of array elements to read, if zero there is no 2221df09bc6SSakari Ailus * upper limit on the number of elements in the dts entry but only 2231df09bc6SSakari Ailus * sz_min will be read. 2241df09bc6SSakari Ailus * 2251df09bc6SSakari Ailus * Search for a property in a device node and read 16-bit value(s) from 2261df09bc6SSakari Ailus * it. Returns number of elements read on success, -EINVAL if the property 2271df09bc6SSakari Ailus * does not exist, -ENODATA if property does not have a value, and -EOVERFLOW 2281df09bc6SSakari Ailus * if the property data is smaller than sz_min or longer than sz_max. 2291df09bc6SSakari Ailus * 2301df09bc6SSakari Ailus * dts entry of array should be like: 2311df09bc6SSakari Ailus * property = /bits/ 16 <0x5000 0x6000 0x7000>; 2321df09bc6SSakari Ailus * 2331df09bc6SSakari Ailus * The out_values is modified only if a valid u16 value can be decoded. 2341df09bc6SSakari Ailus */ 2351df09bc6SSakari Ailus int of_property_read_variable_u16_array(const struct device_node *np, 2361df09bc6SSakari Ailus const char *propname, u16 *out_values, 2371df09bc6SSakari Ailus size_t sz_min, size_t sz_max) 2381df09bc6SSakari Ailus { 2391df09bc6SSakari Ailus size_t sz, count; 2401df09bc6SSakari Ailus const __be16 *val = of_find_property_value_of_size(np, propname, 2411df09bc6SSakari Ailus (sz_min * sizeof(*out_values)), 2421df09bc6SSakari Ailus (sz_max * sizeof(*out_values)), 2431df09bc6SSakari Ailus &sz); 2441df09bc6SSakari Ailus 2451df09bc6SSakari Ailus if (IS_ERR(val)) 2461df09bc6SSakari Ailus return PTR_ERR(val); 2471df09bc6SSakari Ailus 2481df09bc6SSakari Ailus if (!sz_max) 2491df09bc6SSakari Ailus sz = sz_min; 2501df09bc6SSakari Ailus else 2511df09bc6SSakari Ailus sz /= sizeof(*out_values); 2521df09bc6SSakari Ailus 2531df09bc6SSakari Ailus count = sz; 2541df09bc6SSakari Ailus while (count--) 2551df09bc6SSakari Ailus *out_values++ = be16_to_cpup(val++); 2561df09bc6SSakari Ailus 2571df09bc6SSakari Ailus return sz; 2581df09bc6SSakari Ailus } 2591df09bc6SSakari Ailus EXPORT_SYMBOL_GPL(of_property_read_variable_u16_array); 2601df09bc6SSakari Ailus 2611df09bc6SSakari Ailus /** 2621df09bc6SSakari Ailus * of_property_read_variable_u32_array - Find and read an array of 32 bit 2631df09bc6SSakari Ailus * integers from a property, with bounds on the minimum and maximum array size. 2641df09bc6SSakari Ailus * 2651df09bc6SSakari Ailus * @np: device node from which the property value is to be read. 2661df09bc6SSakari Ailus * @propname: name of the property to be searched. 2671df09bc6SSakari Ailus * @out_values: pointer to return value, modified only if return value is 0. 2681df09bc6SSakari Ailus * @sz_min: minimum number of array elements to read 2691df09bc6SSakari Ailus * @sz_max: maximum number of array elements to read, if zero there is no 2701df09bc6SSakari Ailus * upper limit on the number of elements in the dts entry but only 2711df09bc6SSakari Ailus * sz_min will be read. 2721df09bc6SSakari Ailus * 2731df09bc6SSakari Ailus * Search for a property in a device node and read 32-bit value(s) from 2741df09bc6SSakari Ailus * it. Returns number of elements read on success, -EINVAL if the property 2751df09bc6SSakari Ailus * does not exist, -ENODATA if property does not have a value, and -EOVERFLOW 2761df09bc6SSakari Ailus * if the property data is smaller than sz_min or longer than sz_max. 2771df09bc6SSakari Ailus * 2781df09bc6SSakari Ailus * The out_values is modified only if a valid u32 value can be decoded. 2791df09bc6SSakari Ailus */ 2801df09bc6SSakari Ailus int of_property_read_variable_u32_array(const struct device_node *np, 2811df09bc6SSakari Ailus const char *propname, u32 *out_values, 2821df09bc6SSakari Ailus size_t sz_min, size_t sz_max) 2831df09bc6SSakari Ailus { 2841df09bc6SSakari Ailus size_t sz, count; 2851df09bc6SSakari Ailus const __be32 *val = of_find_property_value_of_size(np, propname, 2861df09bc6SSakari Ailus (sz_min * sizeof(*out_values)), 2871df09bc6SSakari Ailus (sz_max * sizeof(*out_values)), 2881df09bc6SSakari Ailus &sz); 2891df09bc6SSakari Ailus 2901df09bc6SSakari Ailus if (IS_ERR(val)) 2911df09bc6SSakari Ailus return PTR_ERR(val); 2921df09bc6SSakari Ailus 2931df09bc6SSakari Ailus if (!sz_max) 2941df09bc6SSakari Ailus sz = sz_min; 2951df09bc6SSakari Ailus else 2961df09bc6SSakari Ailus sz /= sizeof(*out_values); 2971df09bc6SSakari Ailus 2981df09bc6SSakari Ailus count = sz; 2991df09bc6SSakari Ailus while (count--) 3001df09bc6SSakari Ailus *out_values++ = be32_to_cpup(val++); 3011df09bc6SSakari Ailus 3021df09bc6SSakari Ailus return sz; 3031df09bc6SSakari Ailus } 3041df09bc6SSakari Ailus EXPORT_SYMBOL_GPL(of_property_read_variable_u32_array); 3051df09bc6SSakari Ailus 3061df09bc6SSakari Ailus /** 3071df09bc6SSakari Ailus * of_property_read_u64 - Find and read a 64 bit integer from a property 3081df09bc6SSakari Ailus * @np: device node from which the property value is to be read. 3091df09bc6SSakari Ailus * @propname: name of the property to be searched. 3101df09bc6SSakari Ailus * @out_value: pointer to return value, modified only if return value is 0. 3111df09bc6SSakari Ailus * 3121df09bc6SSakari Ailus * Search for a property in a device node and read a 64-bit value from 3131df09bc6SSakari Ailus * it. Returns 0 on success, -EINVAL if the property does not exist, 3141df09bc6SSakari Ailus * -ENODATA if property does not have a value, and -EOVERFLOW if the 3151df09bc6SSakari Ailus * property data isn't large enough. 3161df09bc6SSakari Ailus * 3171df09bc6SSakari Ailus * The out_value is modified only if a valid u64 value can be decoded. 3181df09bc6SSakari Ailus */ 3191df09bc6SSakari Ailus int of_property_read_u64(const struct device_node *np, const char *propname, 3201df09bc6SSakari Ailus u64 *out_value) 3211df09bc6SSakari Ailus { 3221df09bc6SSakari Ailus const __be32 *val = of_find_property_value_of_size(np, propname, 3231df09bc6SSakari Ailus sizeof(*out_value), 3241df09bc6SSakari Ailus 0, 3251df09bc6SSakari Ailus NULL); 3261df09bc6SSakari Ailus 3271df09bc6SSakari Ailus if (IS_ERR(val)) 3281df09bc6SSakari Ailus return PTR_ERR(val); 3291df09bc6SSakari Ailus 3301df09bc6SSakari Ailus *out_value = of_read_number(val, 2); 3311df09bc6SSakari Ailus return 0; 3321df09bc6SSakari Ailus } 3331df09bc6SSakari Ailus EXPORT_SYMBOL_GPL(of_property_read_u64); 3341df09bc6SSakari Ailus 3351df09bc6SSakari Ailus /** 3361df09bc6SSakari Ailus * of_property_read_variable_u64_array - Find and read an array of 64 bit 3371df09bc6SSakari Ailus * integers from a property, with bounds on the minimum and maximum array size. 3381df09bc6SSakari Ailus * 3391df09bc6SSakari Ailus * @np: device node from which the property value is to be read. 3401df09bc6SSakari Ailus * @propname: name of the property to be searched. 3411df09bc6SSakari Ailus * @out_values: pointer to return value, modified only if return value is 0. 3421df09bc6SSakari Ailus * @sz_min: minimum number of array elements to read 3431df09bc6SSakari Ailus * @sz_max: maximum number of array elements to read, if zero there is no 3441df09bc6SSakari Ailus * upper limit on the number of elements in the dts entry but only 3451df09bc6SSakari Ailus * sz_min will be read. 3461df09bc6SSakari Ailus * 3471df09bc6SSakari Ailus * Search for a property in a device node and read 64-bit value(s) from 3481df09bc6SSakari Ailus * it. Returns number of elements read on success, -EINVAL if the property 3491df09bc6SSakari Ailus * does not exist, -ENODATA if property does not have a value, and -EOVERFLOW 3501df09bc6SSakari Ailus * if the property data is smaller than sz_min or longer than sz_max. 3511df09bc6SSakari Ailus * 3521df09bc6SSakari Ailus * The out_values is modified only if a valid u64 value can be decoded. 3531df09bc6SSakari Ailus */ 3541df09bc6SSakari Ailus int of_property_read_variable_u64_array(const struct device_node *np, 3551df09bc6SSakari Ailus const char *propname, u64 *out_values, 3561df09bc6SSakari Ailus size_t sz_min, size_t sz_max) 3571df09bc6SSakari Ailus { 3581df09bc6SSakari Ailus size_t sz, count; 3591df09bc6SSakari Ailus const __be32 *val = of_find_property_value_of_size(np, propname, 3601df09bc6SSakari Ailus (sz_min * sizeof(*out_values)), 3611df09bc6SSakari Ailus (sz_max * sizeof(*out_values)), 3621df09bc6SSakari Ailus &sz); 3631df09bc6SSakari Ailus 3641df09bc6SSakari Ailus if (IS_ERR(val)) 3651df09bc6SSakari Ailus return PTR_ERR(val); 3661df09bc6SSakari Ailus 3671df09bc6SSakari Ailus if (!sz_max) 3681df09bc6SSakari Ailus sz = sz_min; 3691df09bc6SSakari Ailus else 3701df09bc6SSakari Ailus sz /= sizeof(*out_values); 3711df09bc6SSakari Ailus 3721df09bc6SSakari Ailus count = sz; 3731df09bc6SSakari Ailus while (count--) { 3741df09bc6SSakari Ailus *out_values++ = of_read_number(val, 2); 3751df09bc6SSakari Ailus val += 2; 3761df09bc6SSakari Ailus } 3771df09bc6SSakari Ailus 3781df09bc6SSakari Ailus return sz; 3791df09bc6SSakari Ailus } 3801df09bc6SSakari Ailus EXPORT_SYMBOL_GPL(of_property_read_variable_u64_array); 3811df09bc6SSakari Ailus 3821df09bc6SSakari Ailus /** 3831df09bc6SSakari Ailus * of_property_read_string - Find and read a string from a property 3841df09bc6SSakari Ailus * @np: device node from which the property value is to be read. 3851df09bc6SSakari Ailus * @propname: name of the property to be searched. 3861df09bc6SSakari Ailus * @out_string: pointer to null terminated return string, modified only if 3871df09bc6SSakari Ailus * return value is 0. 3881df09bc6SSakari Ailus * 3891df09bc6SSakari Ailus * Search for a property in a device tree node and retrieve a null 3901df09bc6SSakari Ailus * terminated string value (pointer to data, not a copy). Returns 0 on 3911df09bc6SSakari Ailus * success, -EINVAL if the property does not exist, -ENODATA if property 3921df09bc6SSakari Ailus * does not have a value, and -EILSEQ if the string is not null-terminated 3931df09bc6SSakari Ailus * within the length of the property data. 3941df09bc6SSakari Ailus * 3951df09bc6SSakari Ailus * The out_string pointer is modified only if a valid string can be decoded. 3961df09bc6SSakari Ailus */ 3971df09bc6SSakari Ailus int of_property_read_string(const struct device_node *np, const char *propname, 3981df09bc6SSakari Ailus const char **out_string) 3991df09bc6SSakari Ailus { 4001df09bc6SSakari Ailus const struct property *prop = of_find_property(np, propname, NULL); 4011df09bc6SSakari Ailus if (!prop) 4021df09bc6SSakari Ailus return -EINVAL; 4031df09bc6SSakari Ailus if (!prop->value) 4041df09bc6SSakari Ailus return -ENODATA; 4051df09bc6SSakari Ailus if (strnlen(prop->value, prop->length) >= prop->length) 4061df09bc6SSakari Ailus return -EILSEQ; 4071df09bc6SSakari Ailus *out_string = prop->value; 4081df09bc6SSakari Ailus return 0; 4091df09bc6SSakari Ailus } 4101df09bc6SSakari Ailus EXPORT_SYMBOL_GPL(of_property_read_string); 4111df09bc6SSakari Ailus 4121df09bc6SSakari Ailus /** 4131df09bc6SSakari Ailus * of_property_match_string() - Find string in a list and return index 4141df09bc6SSakari Ailus * @np: pointer to node containing string list property 4151df09bc6SSakari Ailus * @propname: string list property name 4161df09bc6SSakari Ailus * @string: pointer to string to search for in string list 4171df09bc6SSakari Ailus * 4181df09bc6SSakari Ailus * This function searches a string list property and returns the index 4191df09bc6SSakari Ailus * of a specific string value. 4201df09bc6SSakari Ailus */ 4211df09bc6SSakari Ailus int of_property_match_string(const struct device_node *np, const char *propname, 4221df09bc6SSakari Ailus const char *string) 4231df09bc6SSakari Ailus { 4241df09bc6SSakari Ailus const struct property *prop = of_find_property(np, propname, NULL); 4251df09bc6SSakari Ailus size_t l; 4261df09bc6SSakari Ailus int i; 4271df09bc6SSakari Ailus const char *p, *end; 4281df09bc6SSakari Ailus 4291df09bc6SSakari Ailus if (!prop) 4301df09bc6SSakari Ailus return -EINVAL; 4311df09bc6SSakari Ailus if (!prop->value) 4321df09bc6SSakari Ailus return -ENODATA; 4331df09bc6SSakari Ailus 4341df09bc6SSakari Ailus p = prop->value; 4351df09bc6SSakari Ailus end = p + prop->length; 4361df09bc6SSakari Ailus 4371df09bc6SSakari Ailus for (i = 0; p < end; i++, p += l) { 4381df09bc6SSakari Ailus l = strnlen(p, end - p) + 1; 4391df09bc6SSakari Ailus if (p + l > end) 4401df09bc6SSakari Ailus return -EILSEQ; 4411df09bc6SSakari Ailus pr_debug("comparing %s with %s\n", string, p); 4421df09bc6SSakari Ailus if (strcmp(string, p) == 0) 4431df09bc6SSakari Ailus return i; /* Found it; return index */ 4441df09bc6SSakari Ailus } 4451df09bc6SSakari Ailus return -ENODATA; 4461df09bc6SSakari Ailus } 4471df09bc6SSakari Ailus EXPORT_SYMBOL_GPL(of_property_match_string); 4481df09bc6SSakari Ailus 4491df09bc6SSakari Ailus /** 4501df09bc6SSakari Ailus * of_property_read_string_helper() - Utility helper for parsing string properties 4511df09bc6SSakari Ailus * @np: device node from which the property value is to be read. 4521df09bc6SSakari Ailus * @propname: name of the property to be searched. 4531df09bc6SSakari Ailus * @out_strs: output array of string pointers. 4541df09bc6SSakari Ailus * @sz: number of array elements to read. 4551df09bc6SSakari Ailus * @skip: Number of strings to skip over at beginning of list. 4561df09bc6SSakari Ailus * 4571df09bc6SSakari Ailus * Don't call this function directly. It is a utility helper for the 4581df09bc6SSakari Ailus * of_property_read_string*() family of functions. 4591df09bc6SSakari Ailus */ 4601df09bc6SSakari Ailus int of_property_read_string_helper(const struct device_node *np, 4611df09bc6SSakari Ailus const char *propname, const char **out_strs, 4621df09bc6SSakari Ailus size_t sz, int skip) 4631df09bc6SSakari Ailus { 4641df09bc6SSakari Ailus const struct property *prop = of_find_property(np, propname, NULL); 4651df09bc6SSakari Ailus int l = 0, i = 0; 4661df09bc6SSakari Ailus const char *p, *end; 4671df09bc6SSakari Ailus 4681df09bc6SSakari Ailus if (!prop) 4691df09bc6SSakari Ailus return -EINVAL; 4701df09bc6SSakari Ailus if (!prop->value) 4711df09bc6SSakari Ailus return -ENODATA; 4721df09bc6SSakari Ailus p = prop->value; 4731df09bc6SSakari Ailus end = p + prop->length; 4741df09bc6SSakari Ailus 4751df09bc6SSakari Ailus for (i = 0; p < end && (!out_strs || i < skip + sz); i++, p += l) { 4761df09bc6SSakari Ailus l = strnlen(p, end - p) + 1; 4771df09bc6SSakari Ailus if (p + l > end) 4781df09bc6SSakari Ailus return -EILSEQ; 4791df09bc6SSakari Ailus if (out_strs && i >= skip) 4801df09bc6SSakari Ailus *out_strs++ = p; 4811df09bc6SSakari Ailus } 4821df09bc6SSakari Ailus i -= skip; 4831df09bc6SSakari Ailus return i <= 0 ? -ENODATA : i; 4841df09bc6SSakari Ailus } 4851df09bc6SSakari Ailus EXPORT_SYMBOL_GPL(of_property_read_string_helper); 4861df09bc6SSakari Ailus 4871df09bc6SSakari Ailus const __be32 *of_prop_next_u32(struct property *prop, const __be32 *cur, 4881df09bc6SSakari Ailus u32 *pu) 4891df09bc6SSakari Ailus { 4901df09bc6SSakari Ailus const void *curv = cur; 4911df09bc6SSakari Ailus 4921df09bc6SSakari Ailus if (!prop) 4931df09bc6SSakari Ailus return NULL; 4941df09bc6SSakari Ailus 4951df09bc6SSakari Ailus if (!cur) { 4961df09bc6SSakari Ailus curv = prop->value; 4971df09bc6SSakari Ailus goto out_val; 4981df09bc6SSakari Ailus } 4991df09bc6SSakari Ailus 5001df09bc6SSakari Ailus curv += sizeof(*cur); 5011df09bc6SSakari Ailus if (curv >= prop->value + prop->length) 5021df09bc6SSakari Ailus return NULL; 5031df09bc6SSakari Ailus 5041df09bc6SSakari Ailus out_val: 5051df09bc6SSakari Ailus *pu = be32_to_cpup(curv); 5061df09bc6SSakari Ailus return curv; 5071df09bc6SSakari Ailus } 5081df09bc6SSakari Ailus EXPORT_SYMBOL_GPL(of_prop_next_u32); 5091df09bc6SSakari Ailus 5101df09bc6SSakari Ailus const char *of_prop_next_string(struct property *prop, const char *cur) 5111df09bc6SSakari Ailus { 5121df09bc6SSakari Ailus const void *curv = cur; 5131df09bc6SSakari Ailus 5141df09bc6SSakari Ailus if (!prop) 5151df09bc6SSakari Ailus return NULL; 5161df09bc6SSakari Ailus 5171df09bc6SSakari Ailus if (!cur) 5181df09bc6SSakari Ailus return prop->value; 5191df09bc6SSakari Ailus 5201df09bc6SSakari Ailus curv += strlen(cur) + 1; 5211df09bc6SSakari Ailus if (curv >= prop->value + prop->length) 5221df09bc6SSakari Ailus return NULL; 5231df09bc6SSakari Ailus 5241df09bc6SSakari Ailus return curv; 5251df09bc6SSakari Ailus } 5261df09bc6SSakari Ailus EXPORT_SYMBOL_GPL(of_prop_next_string); 5271df09bc6SSakari Ailus 5281df09bc6SSakari Ailus /** 5291df09bc6SSakari Ailus * of_graph_parse_endpoint() - parse common endpoint node properties 5301df09bc6SSakari Ailus * @node: pointer to endpoint device_node 5311df09bc6SSakari Ailus * @endpoint: pointer to the OF endpoint data structure 5321df09bc6SSakari Ailus * 5331df09bc6SSakari Ailus * The caller should hold a reference to @node. 5341df09bc6SSakari Ailus */ 5351df09bc6SSakari Ailus int of_graph_parse_endpoint(const struct device_node *node, 5361df09bc6SSakari Ailus struct of_endpoint *endpoint) 5371df09bc6SSakari Ailus { 5381df09bc6SSakari Ailus struct device_node *port_node = of_get_parent(node); 5391df09bc6SSakari Ailus 5401df09bc6SSakari Ailus WARN_ONCE(!port_node, "%s(): endpoint %s has no parent node\n", 5411df09bc6SSakari Ailus __func__, node->full_name); 5421df09bc6SSakari Ailus 5431df09bc6SSakari Ailus memset(endpoint, 0, sizeof(*endpoint)); 5441df09bc6SSakari Ailus 5451df09bc6SSakari Ailus endpoint->local_node = node; 5461df09bc6SSakari Ailus /* 5471df09bc6SSakari Ailus * It doesn't matter whether the two calls below succeed. 5481df09bc6SSakari Ailus * If they don't then the default value 0 is used. 5491df09bc6SSakari Ailus */ 5501df09bc6SSakari Ailus of_property_read_u32(port_node, "reg", &endpoint->port); 5511df09bc6SSakari Ailus of_property_read_u32(node, "reg", &endpoint->id); 5521df09bc6SSakari Ailus 5531df09bc6SSakari Ailus of_node_put(port_node); 5541df09bc6SSakari Ailus 5551df09bc6SSakari Ailus return 0; 5561df09bc6SSakari Ailus } 5571df09bc6SSakari Ailus EXPORT_SYMBOL(of_graph_parse_endpoint); 5581df09bc6SSakari Ailus 5591df09bc6SSakari Ailus /** 5601df09bc6SSakari Ailus * of_graph_get_port_by_id() - get the port matching a given id 5611df09bc6SSakari Ailus * @parent: pointer to the parent device node 5621df09bc6SSakari Ailus * @id: id of the port 5631df09bc6SSakari Ailus * 5641df09bc6SSakari Ailus * Return: A 'port' node pointer with refcount incremented. The caller 5651df09bc6SSakari Ailus * has to use of_node_put() on it when done. 5661df09bc6SSakari Ailus */ 5671df09bc6SSakari Ailus struct device_node *of_graph_get_port_by_id(struct device_node *parent, u32 id) 5681df09bc6SSakari Ailus { 5691df09bc6SSakari Ailus struct device_node *node, *port; 5701df09bc6SSakari Ailus 5711df09bc6SSakari Ailus node = of_get_child_by_name(parent, "ports"); 5721df09bc6SSakari Ailus if (node) 5731df09bc6SSakari Ailus parent = node; 5741df09bc6SSakari Ailus 5751df09bc6SSakari Ailus for_each_child_of_node(parent, port) { 5761df09bc6SSakari Ailus u32 port_id = 0; 5771df09bc6SSakari Ailus 5781df09bc6SSakari Ailus if (of_node_cmp(port->name, "port") != 0) 5791df09bc6SSakari Ailus continue; 5801df09bc6SSakari Ailus of_property_read_u32(port, "reg", &port_id); 5811df09bc6SSakari Ailus if (id == port_id) 5821df09bc6SSakari Ailus break; 5831df09bc6SSakari Ailus } 5841df09bc6SSakari Ailus 5851df09bc6SSakari Ailus of_node_put(node); 5861df09bc6SSakari Ailus 5871df09bc6SSakari Ailus return port; 5881df09bc6SSakari Ailus } 5891df09bc6SSakari Ailus EXPORT_SYMBOL(of_graph_get_port_by_id); 5901df09bc6SSakari Ailus 5911df09bc6SSakari Ailus /** 5921df09bc6SSakari Ailus * of_graph_get_next_endpoint() - get next endpoint node 5931df09bc6SSakari Ailus * @parent: pointer to the parent device node 5941df09bc6SSakari Ailus * @prev: previous endpoint node, or NULL to get first 5951df09bc6SSakari Ailus * 5961df09bc6SSakari Ailus * Return: An 'endpoint' node pointer with refcount incremented. Refcount 5971df09bc6SSakari Ailus * of the passed @prev node is decremented. 5981df09bc6SSakari Ailus */ 5991df09bc6SSakari Ailus struct device_node *of_graph_get_next_endpoint(const struct device_node *parent, 6001df09bc6SSakari Ailus struct device_node *prev) 6011df09bc6SSakari Ailus { 6021df09bc6SSakari Ailus struct device_node *endpoint; 6031df09bc6SSakari Ailus struct device_node *port; 6041df09bc6SSakari Ailus 6051df09bc6SSakari Ailus if (!parent) 6061df09bc6SSakari Ailus return NULL; 6071df09bc6SSakari Ailus 6081df09bc6SSakari Ailus /* 6091df09bc6SSakari Ailus * Start by locating the port node. If no previous endpoint is specified 6101df09bc6SSakari Ailus * search for the first port node, otherwise get the previous endpoint 6111df09bc6SSakari Ailus * parent port node. 6121df09bc6SSakari Ailus */ 6131df09bc6SSakari Ailus if (!prev) { 6141df09bc6SSakari Ailus struct device_node *node; 6151df09bc6SSakari Ailus 6161df09bc6SSakari Ailus node = of_get_child_by_name(parent, "ports"); 6171df09bc6SSakari Ailus if (node) 6181df09bc6SSakari Ailus parent = node; 6191df09bc6SSakari Ailus 6201df09bc6SSakari Ailus port = of_get_child_by_name(parent, "port"); 6211df09bc6SSakari Ailus of_node_put(node); 6221df09bc6SSakari Ailus 6231df09bc6SSakari Ailus if (!port) { 6241df09bc6SSakari Ailus pr_err("graph: no port node found in %s\n", 6251df09bc6SSakari Ailus parent->full_name); 6261df09bc6SSakari Ailus return NULL; 6271df09bc6SSakari Ailus } 6281df09bc6SSakari Ailus } else { 6291df09bc6SSakari Ailus port = of_get_parent(prev); 6301df09bc6SSakari Ailus if (WARN_ONCE(!port, "%s(): endpoint %s has no parent node\n", 6311df09bc6SSakari Ailus __func__, prev->full_name)) 6321df09bc6SSakari Ailus return NULL; 6331df09bc6SSakari Ailus } 6341df09bc6SSakari Ailus 6351df09bc6SSakari Ailus while (1) { 6361df09bc6SSakari Ailus /* 6371df09bc6SSakari Ailus * Now that we have a port node, get the next endpoint by 6381df09bc6SSakari Ailus * getting the next child. If the previous endpoint is NULL this 6391df09bc6SSakari Ailus * will return the first child. 6401df09bc6SSakari Ailus */ 6411df09bc6SSakari Ailus endpoint = of_get_next_child(port, prev); 6421df09bc6SSakari Ailus if (endpoint) { 6431df09bc6SSakari Ailus of_node_put(port); 6441df09bc6SSakari Ailus return endpoint; 6451df09bc6SSakari Ailus } 6461df09bc6SSakari Ailus 6471df09bc6SSakari Ailus /* No more endpoints under this port, try the next one. */ 6481df09bc6SSakari Ailus prev = NULL; 6491df09bc6SSakari Ailus 6501df09bc6SSakari Ailus do { 6511df09bc6SSakari Ailus port = of_get_next_child(parent, port); 6521df09bc6SSakari Ailus if (!port) 6531df09bc6SSakari Ailus return NULL; 6541df09bc6SSakari Ailus } while (of_node_cmp(port->name, "port")); 6551df09bc6SSakari Ailus } 6561df09bc6SSakari Ailus } 6571df09bc6SSakari Ailus EXPORT_SYMBOL(of_graph_get_next_endpoint); 6581df09bc6SSakari Ailus 6591df09bc6SSakari Ailus /** 6601df09bc6SSakari Ailus * of_graph_get_endpoint_by_regs() - get endpoint node of specific identifiers 6611df09bc6SSakari Ailus * @parent: pointer to the parent device node 6621df09bc6SSakari Ailus * @port_reg: identifier (value of reg property) of the parent port node 6631df09bc6SSakari Ailus * @reg: identifier (value of reg property) of the endpoint node 6641df09bc6SSakari Ailus * 6651df09bc6SSakari Ailus * Return: An 'endpoint' node pointer which is identified by reg and at the same 6661df09bc6SSakari Ailus * is the child of a port node identified by port_reg. reg and port_reg are 6671df09bc6SSakari Ailus * ignored when they are -1. 6681df09bc6SSakari Ailus */ 6691df09bc6SSakari Ailus struct device_node *of_graph_get_endpoint_by_regs( 6701df09bc6SSakari Ailus const struct device_node *parent, int port_reg, int reg) 6711df09bc6SSakari Ailus { 6721df09bc6SSakari Ailus struct of_endpoint endpoint; 6731df09bc6SSakari Ailus struct device_node *node = NULL; 6741df09bc6SSakari Ailus 6751df09bc6SSakari Ailus for_each_endpoint_of_node(parent, node) { 6761df09bc6SSakari Ailus of_graph_parse_endpoint(node, &endpoint); 6771df09bc6SSakari Ailus if (((port_reg == -1) || (endpoint.port == port_reg)) && 6781df09bc6SSakari Ailus ((reg == -1) || (endpoint.id == reg))) 6791df09bc6SSakari Ailus return node; 6801df09bc6SSakari Ailus } 6811df09bc6SSakari Ailus 6821df09bc6SSakari Ailus return NULL; 6831df09bc6SSakari Ailus } 6841df09bc6SSakari Ailus EXPORT_SYMBOL(of_graph_get_endpoint_by_regs); 6851df09bc6SSakari Ailus 6861df09bc6SSakari Ailus /** 6871df09bc6SSakari Ailus * of_graph_get_remote_port_parent() - get remote port's parent node 6881df09bc6SSakari Ailus * @node: pointer to a local endpoint device_node 6891df09bc6SSakari Ailus * 6901df09bc6SSakari Ailus * Return: Remote device node associated with remote endpoint node linked 6911df09bc6SSakari Ailus * to @node. Use of_node_put() on it when done. 6921df09bc6SSakari Ailus */ 6931df09bc6SSakari Ailus struct device_node *of_graph_get_remote_port_parent( 6941df09bc6SSakari Ailus const struct device_node *node) 6951df09bc6SSakari Ailus { 6961df09bc6SSakari Ailus struct device_node *np; 6971df09bc6SSakari Ailus unsigned int depth; 6981df09bc6SSakari Ailus 6991df09bc6SSakari Ailus /* Get remote endpoint node. */ 7001df09bc6SSakari Ailus np = of_parse_phandle(node, "remote-endpoint", 0); 7011df09bc6SSakari Ailus 7021df09bc6SSakari Ailus /* Walk 3 levels up only if there is 'ports' node. */ 7031df09bc6SSakari Ailus for (depth = 3; depth && np; depth--) { 7041df09bc6SSakari Ailus np = of_get_next_parent(np); 7051df09bc6SSakari Ailus if (depth == 2 && of_node_cmp(np->name, "ports")) 7061df09bc6SSakari Ailus break; 7071df09bc6SSakari Ailus } 7081df09bc6SSakari Ailus return np; 7091df09bc6SSakari Ailus } 7101df09bc6SSakari Ailus EXPORT_SYMBOL(of_graph_get_remote_port_parent); 7111df09bc6SSakari Ailus 7121df09bc6SSakari Ailus /** 7131df09bc6SSakari Ailus * of_graph_get_remote_port() - get remote port node 7141df09bc6SSakari Ailus * @node: pointer to a local endpoint device_node 7151df09bc6SSakari Ailus * 7161df09bc6SSakari Ailus * Return: Remote port node associated with remote endpoint node linked 7171df09bc6SSakari Ailus * to @node. Use of_node_put() on it when done. 7181df09bc6SSakari Ailus */ 7191df09bc6SSakari Ailus struct device_node *of_graph_get_remote_port(const struct device_node *node) 7201df09bc6SSakari Ailus { 7211df09bc6SSakari Ailus struct device_node *np; 7221df09bc6SSakari Ailus 7231df09bc6SSakari Ailus /* Get remote endpoint node. */ 7241df09bc6SSakari Ailus np = of_parse_phandle(node, "remote-endpoint", 0); 7251df09bc6SSakari Ailus if (!np) 7261df09bc6SSakari Ailus return NULL; 7271df09bc6SSakari Ailus return of_get_next_parent(np); 7281df09bc6SSakari Ailus } 7291df09bc6SSakari Ailus EXPORT_SYMBOL(of_graph_get_remote_port); 7301df09bc6SSakari Ailus 7311df09bc6SSakari Ailus /** 7321df09bc6SSakari Ailus * of_graph_get_remote_node() - get remote parent device_node for given port/endpoint 7331df09bc6SSakari Ailus * @node: pointer to parent device_node containing graph port/endpoint 7341df09bc6SSakari Ailus * @port: identifier (value of reg property) of the parent port node 7351df09bc6SSakari Ailus * @endpoint: identifier (value of reg property) of the endpoint node 7361df09bc6SSakari Ailus * 7371df09bc6SSakari Ailus * Return: Remote device node associated with remote endpoint node linked 7381df09bc6SSakari Ailus * to @node. Use of_node_put() on it when done. 7391df09bc6SSakari Ailus */ 7401df09bc6SSakari Ailus struct device_node *of_graph_get_remote_node(const struct device_node *node, 7411df09bc6SSakari Ailus u32 port, u32 endpoint) 7421df09bc6SSakari Ailus { 7431df09bc6SSakari Ailus struct device_node *endpoint_node, *remote; 7441df09bc6SSakari Ailus 7451df09bc6SSakari Ailus endpoint_node = of_graph_get_endpoint_by_regs(node, port, endpoint); 7461df09bc6SSakari Ailus if (!endpoint_node) { 7471df09bc6SSakari Ailus pr_debug("no valid endpoint (%d, %d) for node %s\n", 7481df09bc6SSakari Ailus port, endpoint, node->full_name); 7491df09bc6SSakari Ailus return NULL; 7501df09bc6SSakari Ailus } 7511df09bc6SSakari Ailus 7521df09bc6SSakari Ailus remote = of_graph_get_remote_port_parent(endpoint_node); 7531df09bc6SSakari Ailus of_node_put(endpoint_node); 7541df09bc6SSakari Ailus if (!remote) { 7551df09bc6SSakari Ailus pr_debug("no valid remote node\n"); 7561df09bc6SSakari Ailus return NULL; 7571df09bc6SSakari Ailus } 7581df09bc6SSakari Ailus 7591df09bc6SSakari Ailus if (!of_device_is_available(remote)) { 7601df09bc6SSakari Ailus pr_debug("not available for remote node\n"); 7611df09bc6SSakari Ailus return NULL; 7621df09bc6SSakari Ailus } 7631df09bc6SSakari Ailus 7641df09bc6SSakari Ailus return remote; 7651df09bc6SSakari Ailus } 7661df09bc6SSakari Ailus EXPORT_SYMBOL(of_graph_get_remote_node); 7673708184aSSakari Ailus 7683708184aSSakari Ailus static void of_fwnode_get(struct fwnode_handle *fwnode) 7693708184aSSakari Ailus { 7703708184aSSakari Ailus of_node_get(to_of_node(fwnode)); 7713708184aSSakari Ailus } 7723708184aSSakari Ailus 7733708184aSSakari Ailus static void of_fwnode_put(struct fwnode_handle *fwnode) 7743708184aSSakari Ailus { 7753708184aSSakari Ailus of_node_put(to_of_node(fwnode)); 7763708184aSSakari Ailus } 7773708184aSSakari Ailus 7783708184aSSakari Ailus static bool of_fwnode_property_present(struct fwnode_handle *fwnode, 7793708184aSSakari Ailus const char *propname) 7803708184aSSakari Ailus { 7813708184aSSakari Ailus return of_property_read_bool(to_of_node(fwnode), propname); 7823708184aSSakari Ailus } 7833708184aSSakari Ailus 7843708184aSSakari Ailus static int of_fwnode_property_read_int_array(struct fwnode_handle *fwnode, 7853708184aSSakari Ailus const char *propname, 7863708184aSSakari Ailus unsigned int elem_size, void *val, 7873708184aSSakari Ailus size_t nval) 7883708184aSSakari Ailus { 7893708184aSSakari Ailus struct device_node *node = to_of_node(fwnode); 7903708184aSSakari Ailus 7913708184aSSakari Ailus if (!val) 7923708184aSSakari Ailus return of_property_count_elems_of_size(node, propname, 7933708184aSSakari Ailus elem_size); 7943708184aSSakari Ailus 7953708184aSSakari Ailus switch (elem_size) { 7963708184aSSakari Ailus case sizeof(u8): 7973708184aSSakari Ailus return of_property_read_u8_array(node, propname, val, nval); 7983708184aSSakari Ailus case sizeof(u16): 7993708184aSSakari Ailus return of_property_read_u16_array(node, propname, val, nval); 8003708184aSSakari Ailus case sizeof(u32): 8013708184aSSakari Ailus return of_property_read_u32_array(node, propname, val, nval); 8023708184aSSakari Ailus case sizeof(u64): 8033708184aSSakari Ailus return of_property_read_u64_array(node, propname, val, nval); 8043708184aSSakari Ailus } 8053708184aSSakari Ailus 8063708184aSSakari Ailus return -ENXIO; 8073708184aSSakari Ailus } 8083708184aSSakari Ailus 8093708184aSSakari Ailus static int of_fwnode_property_read_string_array(struct fwnode_handle *fwnode, 8103708184aSSakari Ailus const char *propname, 8113708184aSSakari Ailus const char **val, size_t nval) 8123708184aSSakari Ailus { 8133708184aSSakari Ailus struct device_node *node = to_of_node(fwnode); 8143708184aSSakari Ailus 8153708184aSSakari Ailus return val ? 8163708184aSSakari Ailus of_property_read_string_array(node, propname, val, nval) : 8173708184aSSakari Ailus of_property_count_strings(node, propname); 8183708184aSSakari Ailus } 8193708184aSSakari Ailus 8203708184aSSakari Ailus static struct fwnode_handle *of_fwnode_get_parent(struct fwnode_handle *fwnode) 8213708184aSSakari Ailus { 8223708184aSSakari Ailus return of_fwnode_handle(of_get_parent(to_of_node(fwnode))); 8233708184aSSakari Ailus } 8243708184aSSakari Ailus 8253708184aSSakari Ailus static struct fwnode_handle * 8263708184aSSakari Ailus of_fwnode_get_next_child_node(struct fwnode_handle *fwnode, 8273708184aSSakari Ailus struct fwnode_handle *child) 8283708184aSSakari Ailus { 8293708184aSSakari Ailus return of_fwnode_handle(of_get_next_available_child(to_of_node(fwnode), 8303708184aSSakari Ailus to_of_node(child))); 8313708184aSSakari Ailus } 8323708184aSSakari Ailus 8333708184aSSakari Ailus static struct fwnode_handle * 8343708184aSSakari Ailus of_fwnode_get_named_child_node(struct fwnode_handle *fwnode, 8353708184aSSakari Ailus const char *childname) 8363708184aSSakari Ailus { 8373708184aSSakari Ailus struct device_node *node = to_of_node(fwnode); 8383708184aSSakari Ailus struct device_node *child; 8393708184aSSakari Ailus 8403708184aSSakari Ailus for_each_available_child_of_node(node, child) 8413708184aSSakari Ailus if (!of_node_cmp(child->name, childname)) 8423708184aSSakari Ailus return of_fwnode_handle(child); 8433708184aSSakari Ailus 8443708184aSSakari Ailus return NULL; 8453708184aSSakari Ailus } 8463708184aSSakari Ailus 8473708184aSSakari Ailus const struct fwnode_operations of_fwnode_ops = { 8483708184aSSakari Ailus .get = of_fwnode_get, 8493708184aSSakari Ailus .put = of_fwnode_put, 8503708184aSSakari Ailus .property_present = of_fwnode_property_present, 8513708184aSSakari Ailus .property_read_int_array = of_fwnode_property_read_int_array, 8523708184aSSakari Ailus .property_read_string_array = of_fwnode_property_read_string_array, 8533708184aSSakari Ailus .get_parent = of_fwnode_get_parent, 8543708184aSSakari Ailus .get_next_child_node = of_fwnode_get_next_child_node, 8553708184aSSakari Ailus .get_named_child_node = of_fwnode_get_named_child_node, 8563708184aSSakari Ailus }; 857