Something went wrong. Try again.
(I'm so sorry!) Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux
Something went wrong. Try again.
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501// SPDX-License-Identifier: GPL-2.0/* * property.c - Unified device property interface. * * Copyright (C) 2014, Intel Corporation * Authors: Rafael J. Wysocki <rafael.j.wysocki@intel.com> * Mika Westerberg <mika.westerberg@linux.intel.com> */
#include <linux/cleanup.h>#include <linux/device.h>#include <linux/err.h>#include <linux/export.h>#include <linux/of.h>#include <linux/property.h>#include <linux/phy.h>#include <linux/slab.h>#include <linux/string.h>#include <linux/types.h>
struct fwnode_handle *__dev_fwnode(struct device *dev){ return IS_ENABLED(CONFIG_OF) && dev->of_node ? of_fwnode_handle(dev->of_node) : dev->fwnode;}EXPORT_SYMBOL_GPL(__dev_fwnode);
const struct fwnode_handle *__dev_fwnode_const(const struct device *dev){ return IS_ENABLED(CONFIG_OF) && dev->of_node ? of_fwnode_handle(dev->of_node) : dev->fwnode;}EXPORT_SYMBOL_GPL(__dev_fwnode_const);
/** * device_property_present - check if a property of a device is present * @dev: Device whose property is being checked * @propname: Name of the property * * Check if property @propname is present in the device firmware description. * This function is the unambiguous way to check that given property is present * in the device firmware description. * * Return: true if property @propname is present. Otherwise, returns false. */bool device_property_present(const struct device *dev, const char *propname){ return fwnode_property_present(dev_fwnode(dev), propname);}EXPORT_SYMBOL_GPL(device_property_present);
/** * fwnode_property_present - check if a property of a firmware node is present * @fwnode: Firmware node whose property to check * @propname: Name of the property * * Check if property @propname is present in the firmware node description. * This function is the unambiguous way to check that given property is present * in the firmware node description. * * Return: true if property @propname is present. Otherwise, returns false. */bool fwnode_property_present(const struct fwnode_handle *fwnode, const char *propname){ bool ret;
if (IS_ERR_OR_NULL(fwnode)) return false;
ret = fwnode_call_bool_op(fwnode, property_present, propname); if (ret) return ret;
return fwnode_call_bool_op(fwnode->secondary, property_present, propname);}EXPORT_SYMBOL_GPL(fwnode_property_present);
/** * device_property_read_bool - Return the value for a boolean property of a device * @dev: Device whose property is being checked * @propname: Name of the property * * Use device_property_present() to check for the property presence. * * Return: if property @propname is true or false in the device firmware description. */bool device_property_read_bool(const struct device *dev, const char *propname){ return fwnode_property_read_bool(dev_fwnode(dev), propname);}EXPORT_SYMBOL_GPL(device_property_read_bool);
/** * fwnode_property_read_bool - Return the value for a boolean property of a firmware node * @fwnode: Firmware node whose property to check * @propname: Name of the property * * Use fwnode_property_present() to check for the property presence. * * Return: if property @propname is true or false in the firmware node description. */bool fwnode_property_read_bool(const struct fwnode_handle *fwnode, const char *propname){ bool ret;
if (IS_ERR_OR_NULL(fwnode)) return false;
ret = fwnode_call_bool_op(fwnode, property_read_bool, propname); if (ret) return ret;
return fwnode_call_bool_op(fwnode->secondary, property_read_bool, propname);}EXPORT_SYMBOL_GPL(fwnode_property_read_bool);
/** * device_property_read_u8_array - return a u8 array property of a device * @dev: Device to get the property of * @propname: Name of the property * @val: The values are stored here or %NULL to return the number of values * @nval: Size of the @val array * * Function reads an array of u8 properties with @propname from the device * firmware description and stores them to @val if found. * * It's recommended to call device_property_count_u8() instead of calling * this function with @val equals %NULL and @nval equals 0. * * Return: number of values if @val was %NULL, * %0 if the property was found (success), * %-EINVAL if given arguments are not valid, * %-ENODATA if the property does not have a value, * %-EPROTO if the property is not an array of numbers, * %-EOVERFLOW if the size of the property is not as expected. * %-ENXIO if no suitable firmware interface is present. */int device_property_read_u8_array(const struct device *dev, const char *propname, u8 *val, size_t nval){ return fwnode_property_read_u8_array(dev_fwnode(dev), propname, val, nval);}EXPORT_SYMBOL_GPL(device_property_read_u8_array);
/** * device_property_read_u16_array - return a u16 array property of a device * @dev: Device to get the property of * @propname: Name of the property * @val: The values are stored here or %NULL to return the number of values * @nval: Size of the @val array * * Function reads an array of u16 properties with @propname from the device * firmware description and stores them to @val if found. * * It's recommended to call device_property_count_u16() instead of calling * this function with @val equals %NULL and @nval equals 0. * * Return: number of values if @val was %NULL, * %0 if the property was found (success), * %-EINVAL if given arguments are not valid, * %-ENODATA if the property does not have a value, * %-EPROTO if the property is not an array of numbers, * %-EOVERFLOW if the size of the property is not as expected. * %-ENXIO if no suitable firmware interface is present. */int device_property_read_u16_array(const struct device *dev, const char *propname, u16 *val, size_t nval){ return fwnode_property_read_u16_array(dev_fwnode(dev), propname, val, nval);}EXPORT_SYMBOL_GPL(device_property_read_u16_array);
/** * device_property_read_u32_array - return a u32 array property of a device * @dev: Device to get the property of * @propname: Name of the property * @val: The values are stored here or %NULL to return the number of values * @nval: Size of the @val array * * Function reads an array of u32 properties with @propname from the device * firmware description and stores them to @val if found. * * It's recommended to call device_property_count_u32() instead of calling * this function with @val equals %NULL and @nval equals 0. * * Return: number of values if @val was %NULL, * %0 if the property was found (success), * %-EINVAL if given arguments are not valid, * %-ENODATA if the property does not have a value, * %-EPROTO if the property is not an array of numbers, * %-EOVERFLOW if the size of the property is not as expected. * %-ENXIO if no suitable firmware interface is present. */int device_property_read_u32_array(const struct device *dev, const char *propname, u32 *val, size_t nval){ return fwnode_property_read_u32_array(dev_fwnode(dev), propname, val, nval);}EXPORT_SYMBOL_GPL(device_property_read_u32_array);
/** * device_property_read_u64_array - return a u64 array property of a device * @dev: Device to get the property of * @propname: Name of the property * @val: The values are stored here or %NULL to return the number of values * @nval: Size of the @val array * * Function reads an array of u64 properties with @propname from the device * firmware description and stores them to @val if found. * * It's recommended to call device_property_count_u64() instead of calling * this function with @val equals %NULL and @nval equals 0. * * Return: number of values if @val was %NULL, * %0 if the property was found (success), * %-EINVAL if given arguments are not valid, * %-ENODATA if the property does not have a value, * %-EPROTO if the property is not an array of numbers, * %-EOVERFLOW if the size of the property is not as expected. * %-ENXIO if no suitable firmware interface is present. */int device_property_read_u64_array(const struct device *dev, const char *propname, u64 *val, size_t nval){ return fwnode_property_read_u64_array(dev_fwnode(dev), propname, val, nval);}EXPORT_SYMBOL_GPL(device_property_read_u64_array);
/** * device_property_read_string_array - return a string array property of device * @dev: Device to get the property of * @propname: Name of the property * @val: The values are stored here or %NULL to return the number of values * @nval: Size of the @val array * * Function reads an array of string properties with @propname from the device * firmware description and stores them to @val if found. * * It's recommended to call device_property_string_array_count() instead of calling * this function with @val equals %NULL and @nval equals 0. * * Return: number of values read on success if @val is non-NULL, * number of values available on success if @val is NULL, * %-EINVAL if given arguments are not valid, * %-ENODATA if the property does not have a value, * %-EPROTO or %-EILSEQ if the property is not an array of strings, * %-EOVERFLOW if the size of the property is not as expected. * %-ENXIO if no suitable firmware interface is present. */int device_property_read_string_array(const struct device *dev, const char *propname, const char **val, size_t nval){ return fwnode_property_read_string_array(dev_fwnode(dev), propname, val, nval);}EXPORT_SYMBOL_GPL(device_property_read_string_array);
/** * device_property_read_string - return a string property of a device * @dev: Device to get the property of * @propname: Name of the property * @val: The value is stored here * * Function reads property @propname from the device firmware description and * stores the value into @val if found. The value is checked to be a string. * * Return: %0 if the property was found (success), * %-EINVAL if given arguments are not valid, * %-ENODATA if the property does not have a value, * %-EPROTO or %-EILSEQ if the property type is not a string. * %-ENXIO if no suitable firmware interface is present. */int device_property_read_string(const struct device *dev, const char *propname, const char **val){ return fwnode_property_read_string(dev_fwnode(dev), propname, val);}EXPORT_SYMBOL_GPL(device_property_read_string);
/** * device_property_match_string - find a string in an array and return index * @dev: Device to get the property of * @propname: Name of the property holding the array * @string: String to look for * * Find a given string in a string array and if it is found return the * index back. * * Return: index, starting from %0, if the property was found (success), * %-EINVAL if given arguments are not valid, * %-ENODATA if the property does not have a value, * %-EPROTO if the property is not an array of strings, * %-ENXIO if no suitable firmware interface is present. */int device_property_match_string(const struct device *dev, const char *propname, const char *string){ return fwnode_property_match_string(dev_fwnode(dev), propname, string);}EXPORT_SYMBOL_GPL(device_property_match_string);
static int fwnode_property_read_int_array(const struct fwnode_handle *fwnode, const char *propname, unsigned int elem_size, void *val, size_t nval){ int ret;
if (IS_ERR_OR_NULL(fwnode)) return -EINVAL;
ret = fwnode_call_int_op(fwnode, property_read_int_array, propname, elem_size, val, nval); if (ret != -EINVAL) return ret;
return fwnode_call_int_op(fwnode->secondary, property_read_int_array, propname, elem_size, val, nval);}
/** * fwnode_property_read_u8_array - return a u8 array property of firmware node * @fwnode: Firmware node to get the property of * @propname: Name of the property * @val: The values are stored here or %NULL to return the number of values * @nval: Size of the @val array * * Read an array of u8 properties with @propname from @fwnode and stores them to * @val if found. * * It's recommended to call fwnode_property_count_u8() instead of calling * this function with @val equals %NULL and @nval equals 0. * * Return: number of values if @val was %NULL, * %0 if the property was found (success), * %-EINVAL if given arguments are not valid, * %-ENODATA if the property does not have a value, * %-EPROTO if the property is not an array of numbers, * %-EOVERFLOW if the size of the property is not as expected, * %-ENXIO if no suitable firmware interface is present. */int fwnode_property_read_u8_array(const struct fwnode_handle *fwnode, const char *propname, u8 *val, size_t nval){ return fwnode_property_read_int_array(fwnode, propname, sizeof(u8), val, nval);}EXPORT_SYMBOL_GPL(fwnode_property_read_u8_array);
/** * fwnode_property_read_u16_array - return a u16 array property of firmware node * @fwnode: Firmware node to get the property of * @propname: Name of the property * @val: The values are stored here or %NULL to return the number of values * @nval: Size of the @val array * * Read an array of u16 properties with @propname from @fwnode and store them to * @val if found. * * It's recommended to call fwnode_property_count_u16() instead of calling * this function with @val equals %NULL and @nval equals 0. * * Return: number of values if @val was %NULL, * %0 if the property was found (success), * %-EINVAL if given arguments are not valid, * %-ENODATA if the property does not have a value, * %-EPROTO if the property is not an array of numbers, * %-EOVERFLOW if the size of the property is not as expected, * %-ENXIO if no suitable firmware interface is present. */int fwnode_property_read_u16_array(const struct fwnode_handle *fwnode, const char *propname, u16 *val, size_t nval){ return fwnode_property_read_int_array(fwnode, propname, sizeof(u16), val, nval);}EXPORT_SYMBOL_GPL(fwnode_property_read_u16_array);
/** * fwnode_property_read_u32_array - return a u32 array property of firmware node * @fwnode: Firmware node to get the property of * @propname: Name of the property * @val: The values are stored here or %NULL to return the number of values * @nval: Size of the @val array * * Read an array of u32 properties with @propname from @fwnode store them to * @val if found. * * It's recommended to call fwnode_property_count_u32() instead of calling * this function with @val equals %NULL and @nval equals 0. * * Return: number of values if @val was %NULL, * %0 if the property was found (success), * %-EINVAL if given arguments are not valid, * %-ENODATA if the property does not have a value, * %-EPROTO if the property is not an array of numbers, * %-EOVERFLOW if the size of the property is not as expected, * %-ENXIO if no suitable firmware interface is present. */int fwnode_property_read_u32_array(const struct fwnode_handle *fwnode, const char *propname, u32 *val, size_t nval){ return fwnode_property_read_int_array(fwnode, propname, sizeof(u32), val, nval);}EXPORT_SYMBOL_GPL(fwnode_property_read_u32_array);
/** * fwnode_property_read_u64_array - return a u64 array property firmware node * @fwnode: Firmware node to get the property of * @propname: Name of the property * @val: The values are stored here or %NULL to return the number of values * @nval: Size of the @val array * * Read an array of u64 properties with @propname from @fwnode and store them to * @val if found. * * It's recommended to call fwnode_property_count_u64() instead of calling * this function with @val equals %NULL and @nval equals 0. * * Return: number of values if @val was %NULL, * %0 if the property was found (success), * %-EINVAL if given arguments are not valid, * %-ENODATA if the property does not have a value, * %-EPROTO if the property is not an array of numbers, * %-EOVERFLOW if the size of the property is not as expected, * %-ENXIO if no suitable firmware interface is present. */int fwnode_property_read_u64_array(const struct fwnode_handle *fwnode, const char *propname, u64 *val, size_t nval){ return fwnode_property_read_int_array(fwnode, propname, sizeof(u64), val, nval);}EXPORT_SYMBOL_GPL(fwnode_property_read_u64_array);
/** * fwnode_property_read_string_array - return string array property of a node * @fwnode: Firmware node to get the property of * @propname: Name of the property * @val: The values are stored here or %NULL to return the number of values * @nval: Size of the @val array * * Read an string list property @propname from the given firmware node and store * them to @val if found. * * It's recommended to call fwnode_property_string_array_count() instead of calling * this function with @val equals %NULL and @nval equals 0. * * Return: number of values read on success if @val is non-NULL, * number of values available on success if @val is NULL, * %-EINVAL if given arguments are not valid, * %-ENODATA if the property does not have a value, * %-EPROTO or %-EILSEQ if the property is not an array of strings, * %-EOVERFLOW if the size of the property is not as expected, * %-ENXIO if no suitable firmware interface is present. */int fwnode_property_read_string_array(const struct fwnode_handle *fwnode, const char *propname, const char **val, size_t nval){ int ret;
if (IS_ERR_OR_NULL(fwnode)) return -EINVAL;
ret = fwnode_call_int_op(fwnode, property_read_string_array, propname, val, nval); if (ret != -EINVAL) return ret;
return fwnode_call_int_op(fwnode->secondary, property_read_string_array, propname, val, nval);}EXPORT_SYMBOL_GPL(fwnode_property_read_string_array);
/** * fwnode_property_read_string - return a string property of a firmware node * @fwnode: Firmware node to get the property of * @propname: Name of the property * @val: The value is stored here * * Read property @propname from the given firmware node and store the value into * @val if found. The value is checked to be a string. * * Return: %0 if the property was found (success), * %-EINVAL if given arguments are not valid, * %-ENODATA if the property does not have a value, * %-EPROTO or %-EILSEQ if the property is not a string, * %-ENXIO if no suitable firmware interface is present. */int fwnode_property_read_string(const struct fwnode_handle *fwnode, const char *propname, const char **val){ int ret = fwnode_property_read_string_array(fwnode, propname, val, 1);
return ret < 0 ? ret : 0;}EXPORT_SYMBOL_GPL(fwnode_property_read_string);
/** * fwnode_property_match_string - find a string in an array and return index * @fwnode: Firmware node to get the property of * @propname: Name of the property holding the array * @string: String to look for * * Find a given string in a string array and if it is found return the * index back. * * Return: index, starting from %0, if the property was found (success), * %-EINVAL if given arguments are not valid, * %-ENODATA if the property does not have a value, * %-EPROTO if the property is not an array of strings, * %-ENXIO if no suitable firmware interface is present. */int fwnode_property_match_string(const struct fwnode_handle *fwnode, const char *propname, const char *string){ int nval, ret;
nval = fwnode_property_string_array_count(fwnode, propname); if (nval < 0) return nval;
if (nval == 0) return -ENODATA;
const char **values __free(kfree) = kzalloc_objs(*values, nval); if (!values) return -ENOMEM;
ret = fwnode_property_read_string_array(fwnode, propname, values, nval); if (ret < 0) return ret;
ret = match_string(values, nval, string); if (ret < 0) return -ENODATA;
return ret;}EXPORT_SYMBOL_GPL(fwnode_property_match_string);
/** * fwnode_property_match_property_string - find a property string value in an array and return index * @fwnode: Firmware node to get the property of * @propname: Name of the property holding the string value * @array: String array to search in * @n: Size of the @array * * Find a property string value in a given @array and if it is found return * the index back. * * Return: index, starting from %0, if the string value was found in the @array (success), * %-ENOENT when the string value was not found in the @array, * %-EINVAL if given arguments are not valid, * %-ENODATA if the property does not have a value, * %-EPROTO or %-EILSEQ if the property is not a string, * %-ENXIO if no suitable firmware interface is present. */int fwnode_property_match_property_string(const struct fwnode_handle *fwnode, const char *propname, const char * const *array, size_t n){ const char *string; int ret;
ret = fwnode_property_read_string(fwnode, propname, &string); if (ret) return ret;
ret = match_string(array, n, string); if (ret < 0) ret = -ENOENT;
return ret;}EXPORT_SYMBOL_GPL(fwnode_property_match_property_string);
/** * fwnode_property_get_reference_args() - Find a reference with arguments * @fwnode: Firmware node where to look for the reference * @prop: The name of the property * @nargs_prop: The name of the property telling the number of * arguments in the referred node. NULL if @nargs is known, * otherwise @nargs is ignored. * @nargs: Number of arguments. Ignored if @nargs_prop is non-NULL. * @index: Index of the reference, from zero onwards. * @args: Result structure with reference and integer arguments. * May be NULL. * * Obtain a reference based on a named property in an fwnode, with * integer arguments. * * The caller is responsible for calling fwnode_handle_put() on the returned * @args->fwnode pointer. * * Return: %0 on success * %-ENOENT when the index is out of bounds, the index has an empty * reference or the property was not found * %-EINVAL on parse error * %-ENOTCONN when the remote firmware node exists but has not been * registered yet */int fwnode_property_get_reference_args(const struct fwnode_handle *fwnode, const char *prop, const char *nargs_prop, unsigned int nargs, unsigned int index, struct fwnode_reference_args *args){ int ret;
if (IS_ERR_OR_NULL(fwnode)) return -ENOENT;
ret = fwnode_call_int_op(fwnode, get_reference_args, prop, nargs_prop, nargs, index, args); if (ret == 0) return ret;
if (IS_ERR_OR_NULL(fwnode->secondary)) return ret;
return fwnode_call_int_op(fwnode->secondary, get_reference_args, prop, nargs_prop, nargs, index, args);}EXPORT_SYMBOL_GPL(fwnode_property_get_reference_args);
/** * fwnode_find_reference - Find named reference to a fwnode_handle * @fwnode: Firmware node where to look for the reference * @name: The name of the reference * @index: Index of the reference * * @index can be used when the named reference holds a table of references. * * The caller is responsible for calling fwnode_handle_put() on the returned * fwnode pointer. * * Return: a pointer to the reference fwnode, when found. Otherwise, * returns an error pointer. */struct fwnode_handle *fwnode_find_reference(const struct fwnode_handle *fwnode, const char *name, unsigned int index){ struct fwnode_reference_args args; int ret;
ret = fwnode_property_get_reference_args(fwnode, name, NULL, 0, index, &args); return ret ? ERR_PTR(ret) : args.fwnode;}EXPORT_SYMBOL_GPL(fwnode_find_reference);
/** * fwnode_get_name - Return the name of a node * @fwnode: The firmware node * * Return: a pointer to the node name, or %NULL. */const char *fwnode_get_name(const struct fwnode_handle *fwnode){ return fwnode_call_ptr_op(fwnode, get_name);}EXPORT_SYMBOL_GPL(fwnode_get_name);
/** * fwnode_get_name_prefix - Return the prefix of node for printing purposes * @fwnode: The firmware node * * Return: the prefix of a node, intended to be printed right before the node. * The prefix works also as a separator between the nodes. */const char *fwnode_get_name_prefix(const struct fwnode_handle *fwnode){ return fwnode_call_ptr_op(fwnode, get_name_prefix);}
/** * fwnode_name_eq - Return true if node name is equal * @fwnode: The firmware node * @name: The name to which to compare the node name * * Compare the name provided as an argument to the name of the node, stopping * the comparison at either NUL or '@' character, whichever comes first. This * function is generally used for comparing node names while ignoring the * possible unit address of the node. * * Return: true if the node name matches with the name provided in the @name * argument, false otherwise. */bool fwnode_name_eq(const struct fwnode_handle *fwnode, const char *name){ const char *node_name; ptrdiff_t len;
node_name = fwnode_get_name(fwnode); if (!node_name) return false;
len = strchrnul(node_name, '@') - node_name;
return str_has_prefix(node_name, name) == len;}EXPORT_SYMBOL_GPL(fwnode_name_eq);
/** * fwnode_get_parent - Return parent firmware node * @fwnode: Firmware whose parent is retrieved * * The caller is responsible for calling fwnode_handle_put() on the returned * fwnode pointer. * * Return: parent firmware node of the given node if possible or %NULL if no * parent was available. */struct fwnode_handle *fwnode_get_parent(const struct fwnode_handle *fwnode){ return fwnode_call_ptr_op(fwnode, get_parent);}EXPORT_SYMBOL_GPL(fwnode_get_parent);
/** * fwnode_get_next_parent - Iterate to the node's parent * @fwnode: Firmware whose parent is retrieved * * This is like fwnode_get_parent() except that it drops the refcount * on the passed node, making it suitable for iterating through a * node's parents. * * The caller is responsible for calling fwnode_handle_put() on the returned * fwnode pointer. Note that this function also puts a reference to @fwnode * unconditionally. * * Return: parent firmware node of the given node if possible or %NULL if no * parent was available. */struct fwnode_handle *fwnode_get_next_parent(struct fwnode_handle *fwnode){ struct fwnode_handle *parent = fwnode_get_parent(fwnode);
fwnode_handle_put(fwnode);
return parent;}EXPORT_SYMBOL_GPL(fwnode_get_next_parent);
/** * fwnode_count_parents - Return the number of parents a node has * @fwnode: The node the parents of which are to be counted * * Return: the number of parents a node has. */unsigned int fwnode_count_parents(const struct fwnode_handle *fwnode){ struct fwnode_handle *parent; unsigned int count = 0;
fwnode_for_each_parent_node(fwnode, parent) count++;
return count;}EXPORT_SYMBOL_GPL(fwnode_count_parents);
/** * fwnode_get_nth_parent - Return an nth parent of a node * @fwnode: The node the parent of which is requested * @depth: Distance of the parent from the node * * The caller is responsible for calling fwnode_handle_put() on the returned * fwnode pointer. * * Return: the nth parent of a node. If there is no parent at the requested * @depth, %NULL is returned. If @depth is 0, the functionality is equivalent to * fwnode_handle_get(). For @depth == 1, it is fwnode_get_parent() and so on. */struct fwnode_handle *fwnode_get_nth_parent(struct fwnode_handle *fwnode, unsigned int depth){ struct fwnode_handle *parent;
if (depth == 0) return fwnode_handle_get(fwnode);
fwnode_for_each_parent_node(fwnode, parent) { if (--depth == 0) return parent; } return NULL;}EXPORT_SYMBOL_GPL(fwnode_get_nth_parent);
/** * fwnode_get_next_child_node - Return the next child node handle for a node * @fwnode: Firmware node to find the next child node for. * @child: Handle to one of the node's child nodes or a %NULL handle. * * The caller is responsible for calling fwnode_handle_put() on the returned * fwnode pointer. Note that this function also puts a reference to @child * unconditionally. */struct fwnode_handle *fwnode_get_next_child_node(const struct fwnode_handle *fwnode, struct fwnode_handle *child){ const struct fwnode_handle *parent; struct fwnode_handle *child_parent __free(fwnode_handle) = NULL; struct fwnode_handle *next;
/* * If this function is in a loop and the previous iteration returned * an child from fwnode->secondary, then we need to use the secondary * as parent rather than @fwnode. */ if (child) { child_parent = fwnode_get_parent(child); parent = child_parent; } else { parent = fwnode; } if (IS_ERR_OR_NULL(parent)) return NULL;
/* Try to find a child in primary fwnode */ next = fwnode_call_ptr_op(parent, get_next_child_node, child); if (next) return next;
/* When no more children in primary, continue with secondary */ return fwnode_get_next_child_node(parent->secondary, NULL);}EXPORT_SYMBOL_GPL(fwnode_get_next_child_node);
/** * fwnode_get_next_available_child_node - Return the next available child node handle for a node * @fwnode: Firmware node to find the next child node for. * @child: Handle to one of the node's child nodes or a %NULL handle. * * The caller is responsible for calling fwnode_handle_put() on the returned * fwnode pointer. Note that this function also puts a reference to @child * unconditionally. */struct fwnode_handle *fwnode_get_next_available_child_node(const struct fwnode_handle *fwnode, struct fwnode_handle *child){ struct fwnode_handle *next_child = child;
if (IS_ERR_OR_NULL(fwnode)) return NULL;
do { next_child = fwnode_get_next_child_node(fwnode, next_child); if (!next_child) return NULL; } while (!fwnode_device_is_available(next_child));
return next_child;}EXPORT_SYMBOL_GPL(fwnode_get_next_available_child_node);
/** * device_get_next_child_node - Return the next child node handle for a device * @dev: Device to find the next child node for. * @child: Handle to one of the device's child nodes or a %NULL handle. * * The caller is responsible for calling fwnode_handle_put() on the returned * fwnode pointer. Note that this function also puts a reference to @child * unconditionally. */struct fwnode_handle *device_get_next_child_node(const struct device *dev, struct fwnode_handle *child){ return fwnode_get_next_child_node(dev_fwnode(dev), child);}EXPORT_SYMBOL_GPL(device_get_next_child_node);
/** * fwnode_get_named_child_node - Return first matching named child node handle * @fwnode: Firmware node to find the named child node for. * @childname: String to match child node name against. * * The caller is responsible for calling fwnode_handle_put() on the returned * fwnode pointer. */struct fwnode_handle *fwnode_get_named_child_node(const struct fwnode_handle *fwnode, const char *childname){ return fwnode_call_ptr_op(fwnode, get_named_child_node, childname);}EXPORT_SYMBOL_GPL(fwnode_get_named_child_node);
/** * device_get_named_child_node - Return first matching named child node handle * @dev: Device to find the named child node for. * @childname: String to match child node name against. * * The caller is responsible for calling fwnode_handle_put() on the returned * fwnode pointer. */struct fwnode_handle *device_get_named_child_node(const struct device *dev, const char *childname){ return fwnode_get_named_child_node(dev_fwnode(dev), childname);}EXPORT_SYMBOL_GPL(device_get_named_child_node);
/** * fwnode_handle_get - Obtain a reference to a device node * @fwnode: Pointer to the device node to obtain the reference to. * * The caller is responsible for calling fwnode_handle_put() on the returned * fwnode pointer. * * Return: the fwnode handle. */struct fwnode_handle *fwnode_handle_get(struct fwnode_handle *fwnode){ if (!fwnode_has_op(fwnode, get)) return fwnode;
return fwnode_call_ptr_op(fwnode, get);}EXPORT_SYMBOL_GPL(fwnode_handle_get);
/** * fwnode_device_is_available - check if a device is available for use * @fwnode: Pointer to the fwnode of the device. * * Return: true if device is available for use. Otherwise, returns false. * * For fwnode node types that don't implement the .device_is_available() * operation, this function returns true. */bool fwnode_device_is_available(const struct fwnode_handle *fwnode){ if (IS_ERR_OR_NULL(fwnode)) return false;
if (!fwnode_has_op(fwnode, device_is_available)) return true;
return fwnode_call_bool_op(fwnode, device_is_available);}EXPORT_SYMBOL_GPL(fwnode_device_is_available);
/** * fwnode_get_child_node_count - return the number of child nodes for a given firmware node * @fwnode: Pointer to the parent firmware node * * Return: the number of child nodes for a given firmware node. */unsigned int fwnode_get_child_node_count(const struct fwnode_handle *fwnode){ struct fwnode_handle *child; unsigned int count = 0;
fwnode_for_each_child_node(fwnode, child) count++;
return count;}EXPORT_SYMBOL_GPL(fwnode_get_child_node_count);
/** * fwnode_get_named_child_node_count - number of child nodes with given name * @fwnode: Node which child nodes are counted. * @name: String to match child node name against. * * Scan child nodes and count all the nodes with a specific name. Potential * 'number' -ending after the 'at sign' for scanned names is ignored. * E.g.:: * fwnode_get_named_child_node_count(fwnode, "channel"); * would match all the nodes:: * channel { }, channel@0 {}, channel@0xabba {}... * * Return: the number of child nodes with a matching name for a given device. */unsigned int fwnode_get_named_child_node_count(const struct fwnode_handle *fwnode, const char *name){ struct fwnode_handle *child; unsigned int count = 0;
fwnode_for_each_named_child_node(fwnode, child, name) count++;
return count;}EXPORT_SYMBOL_GPL(fwnode_get_named_child_node_count);
bool device_dma_supported(const struct device *dev){ return fwnode_call_bool_op(dev_fwnode(dev), device_dma_supported);}EXPORT_SYMBOL_GPL(device_dma_supported);
enum dev_dma_attr device_get_dma_attr(const struct device *dev){ if (!fwnode_has_op(dev_fwnode(dev), device_get_dma_attr)) return DEV_DMA_NOT_SUPPORTED;
return fwnode_call_int_op(dev_fwnode(dev), device_get_dma_attr);}EXPORT_SYMBOL_GPL(device_get_dma_attr);
/** * fwnode_get_phy_mode - Get phy mode for given firmware node * @fwnode: Pointer to the given node * * The function gets phy interface string from property 'phy-mode' or * 'phy-connection-type', and return its index in phy_modes table, or errno in * error case. */int fwnode_get_phy_mode(const struct fwnode_handle *fwnode){ const char *pm; int err, i;
err = fwnode_property_read_string(fwnode, "phy-mode", &pm); if (err < 0) err = fwnode_property_read_string(fwnode, "phy-connection-type", &pm); if (err < 0) return err;
for (i = 0; i < PHY_INTERFACE_MODE_MAX; i++) if (!strcasecmp(pm, phy_modes(i))) return i;
return -ENODEV;}EXPORT_SYMBOL_GPL(fwnode_get_phy_mode);
/** * device_get_phy_mode - Get phy mode for given device * @dev: Pointer to the given device * * The function gets phy interface string from property 'phy-mode' or * 'phy-connection-type', and return its index in phy_modes table, or errno in * error case. */int device_get_phy_mode(struct device *dev){ return fwnode_get_phy_mode(dev_fwnode(dev));}EXPORT_SYMBOL_GPL(device_get_phy_mode);
/** * fwnode_iomap - Maps the memory mapped IO for a given fwnode * @fwnode: Pointer to the firmware node * @index: Index of the IO range * * Return: a pointer to the mapped memory. */void __iomem *fwnode_iomap(struct fwnode_handle *fwnode, int index){ return fwnode_call_ptr_op(fwnode, iomap, index);}EXPORT_SYMBOL(fwnode_iomap);
/** * fwnode_irq_get - Get IRQ directly from a fwnode * @fwnode: Pointer to the firmware node * @index: Zero-based index of the IRQ * * Return: Linux IRQ number on success. Negative errno on failure. */int fwnode_irq_get(const struct fwnode_handle *fwnode, unsigned int index){ int ret;
ret = fwnode_call_int_op(fwnode, irq_get, index); /* We treat mapping errors as invalid case */ if (ret == 0) return -EINVAL;
return ret;}EXPORT_SYMBOL(fwnode_irq_get);
/** * fwnode_irq_get_byname - Get IRQ from a fwnode using its name * @fwnode: Pointer to the firmware node * @name: IRQ name * * Description: * Find a match to the string @name in the 'interrupt-names' string array * in _DSD for ACPI, or of_node for Device Tree. Then get the Linux IRQ * number of the IRQ resource corresponding to the index of the matched * string. * * Return: Linux IRQ number on success, or negative errno otherwise. */int fwnode_irq_get_byname(const struct fwnode_handle *fwnode, const char *name){ int index;
if (!name) return -EINVAL;
index = fwnode_property_match_string(fwnode, "interrupt-names", name); if (index < 0) return index;
return fwnode_irq_get(fwnode, index);}EXPORT_SYMBOL(fwnode_irq_get_byname);
/** * fwnode_graph_get_next_endpoint - Get next endpoint firmware node * @fwnode: Pointer to the parent firmware node * @prev: Previous endpoint node or %NULL to get the first * * The caller is responsible for calling fwnode_handle_put() on the returned * fwnode pointer. Note that this function also puts a reference to @prev * unconditionally. * * Return: an endpoint firmware node pointer or %NULL if no more endpoints * are available. */struct fwnode_handle *fwnode_graph_get_next_endpoint(const struct fwnode_handle *fwnode, struct fwnode_handle *prev){ const struct fwnode_handle *parent; struct fwnode_handle *port_parent __free(fwnode_handle) = NULL; struct fwnode_handle *ep;
/* * If this function is in a loop and the previous iteration returned * an endpoint from fwnode->secondary, then we need to use the secondary * as parent rather than @fwnode. */ if (prev) { port_parent = fwnode_graph_get_port_parent(prev); parent = port_parent; } else { parent = fwnode; } if (IS_ERR_OR_NULL(parent)) return NULL;
ep = fwnode_call_ptr_op(parent, graph_get_next_endpoint, prev); if (ep) return ep;
return fwnode_graph_get_next_endpoint(parent->secondary, NULL);}EXPORT_SYMBOL_GPL(fwnode_graph_get_next_endpoint);
/** * fwnode_graph_get_port_parent - Return the device fwnode of a port endpoint * @endpoint: Endpoint firmware node of the port * * The caller is responsible for calling fwnode_handle_put() on the returned * fwnode pointer. * * Return: the firmware node of the device the @endpoint belongs to. */struct fwnode_handle *fwnode_graph_get_port_parent(const struct fwnode_handle *endpoint){ struct fwnode_handle *port, *parent;
port = fwnode_get_parent(endpoint); parent = fwnode_call_ptr_op(port, graph_get_port_parent);
fwnode_handle_put(port);
return parent;}EXPORT_SYMBOL_GPL(fwnode_graph_get_port_parent);
/** * fwnode_graph_get_remote_port_parent - Return fwnode of a remote device * @fwnode: Endpoint firmware node pointing to the remote endpoint * * Extracts firmware node of a remote device the @fwnode points to. * * The caller is responsible for calling fwnode_handle_put() on the returned * fwnode pointer. */struct fwnode_handle *fwnode_graph_get_remote_port_parent(const struct fwnode_handle *fwnode){ struct fwnode_handle *endpoint, *parent;
endpoint = fwnode_graph_get_remote_endpoint(fwnode); parent = fwnode_graph_get_port_parent(endpoint);
fwnode_handle_put(endpoint);
return parent;}EXPORT_SYMBOL_GPL(fwnode_graph_get_remote_port_parent);
/** * fwnode_graph_get_remote_port - Return fwnode of a remote port * @fwnode: Endpoint firmware node pointing to the remote endpoint * * Extracts firmware node of a remote port the @fwnode points to. * * The caller is responsible for calling fwnode_handle_put() on the returned * fwnode pointer. */struct fwnode_handle *fwnode_graph_get_remote_port(const struct fwnode_handle *fwnode){ return fwnode_get_next_parent(fwnode_graph_get_remote_endpoint(fwnode));}EXPORT_SYMBOL_GPL(fwnode_graph_get_remote_port);
/** * fwnode_graph_get_remote_endpoint - Return fwnode of a remote endpoint * @fwnode: Endpoint firmware node pointing to the remote endpoint * * Extracts firmware node of a remote endpoint the @fwnode points to. * * The caller is responsible for calling fwnode_handle_put() on the returned * fwnode pointer. */struct fwnode_handle *fwnode_graph_get_remote_endpoint(const struct fwnode_handle *fwnode){ return fwnode_call_ptr_op(fwnode, graph_get_remote_endpoint);}EXPORT_SYMBOL_GPL(fwnode_graph_get_remote_endpoint);
static bool fwnode_graph_remote_available(struct fwnode_handle *ep){ struct fwnode_handle *dev_node; bool available;
dev_node = fwnode_graph_get_remote_port_parent(ep); available = fwnode_device_is_available(dev_node); fwnode_handle_put(dev_node);
return available;}
/** * fwnode_graph_get_endpoint_by_id - get endpoint by port and endpoint numbers * @fwnode: parent fwnode_handle containing the graph * @port: identifier of the port node * @endpoint: identifier of the endpoint node under the port node * @flags: fwnode lookup flags * * The caller is responsible for calling fwnode_handle_put() on the returned * fwnode pointer. * * Return: the fwnode handle of the local endpoint corresponding the port and * endpoint IDs or %NULL if not found. * * If FWNODE_GRAPH_ENDPOINT_NEXT is passed in @flags and the specified endpoint * has not been found, look for the closest endpoint ID greater than the * specified one and return the endpoint that corresponds to it, if present. * * Does not return endpoints that belong to disabled devices or endpoints that * are unconnected, unless FWNODE_GRAPH_DEVICE_DISABLED is passed in @flags. */struct fwnode_handle *fwnode_graph_get_endpoint_by_id(const struct fwnode_handle *fwnode, u32 port, u32 endpoint, unsigned long flags){ struct fwnode_handle *ep, *best_ep = NULL; unsigned int best_ep_id = 0; bool endpoint_next = flags & FWNODE_GRAPH_ENDPOINT_NEXT; bool enabled_only = !(flags & FWNODE_GRAPH_DEVICE_DISABLED);
fwnode_graph_for_each_endpoint(fwnode, ep) { struct fwnode_endpoint fwnode_ep = { 0 }; int ret;
if (enabled_only && !fwnode_graph_remote_available(ep)) continue;
ret = fwnode_graph_parse_endpoint(ep, &fwnode_ep); if (ret < 0) continue;
if (fwnode_ep.port != port) continue;
if (fwnode_ep.id == endpoint) { fwnode_handle_put(best_ep); return ep; }
if (!endpoint_next) continue;
/* * If the endpoint that has just been found is not the first * matching one and the ID of the one found previously is closer * to the requested endpoint ID, skip it. */ if (fwnode_ep.id < endpoint || (best_ep && best_ep_id < fwnode_ep.id)) continue;
fwnode_handle_put(best_ep); best_ep = fwnode_handle_get(ep); best_ep_id = fwnode_ep.id; }
return best_ep;}EXPORT_SYMBOL_GPL(fwnode_graph_get_endpoint_by_id);
/** * fwnode_graph_get_endpoint_count - Count endpoints on a device node * @fwnode: The node related to a device * @flags: fwnode lookup flags * Count endpoints in a device node. * * If FWNODE_GRAPH_DEVICE_DISABLED flag is specified, also unconnected endpoints * and endpoints connected to disabled devices are counted. */unsigned int fwnode_graph_get_endpoint_count(const struct fwnode_handle *fwnode, unsigned long flags){ struct fwnode_handle *ep; unsigned int count = 0;
fwnode_graph_for_each_endpoint(fwnode, ep) { if (flags & FWNODE_GRAPH_DEVICE_DISABLED || fwnode_graph_remote_available(ep)) count++; }
return count;}EXPORT_SYMBOL_GPL(fwnode_graph_get_endpoint_count);
/** * fwnode_graph_parse_endpoint - parse common endpoint node properties * @fwnode: pointer to endpoint fwnode_handle * @endpoint: pointer to the fwnode endpoint data structure * * Parse @fwnode representing a graph endpoint node and store the * information in @endpoint. The caller must hold a reference to * @fwnode. */int fwnode_graph_parse_endpoint(const struct fwnode_handle *fwnode, struct fwnode_endpoint *endpoint){ memset(endpoint, 0, sizeof(*endpoint));
return fwnode_call_int_op(fwnode, graph_parse_endpoint, endpoint);}EXPORT_SYMBOL(fwnode_graph_parse_endpoint);
const void *device_get_match_data(const struct device *dev){ return fwnode_call_ptr_op(dev_fwnode(dev), device_get_match_data, dev);}EXPORT_SYMBOL_GPL(device_get_match_data);
static unsigned int fwnode_graph_devcon_matches(const struct fwnode_handle *fwnode, const char *con_id, void *data, devcon_match_fn_t match, void **matches, unsigned int matches_len){ struct fwnode_handle *node; struct fwnode_handle *ep; unsigned int count = 0; void *ret;
fwnode_graph_for_each_endpoint(fwnode, ep) { if (matches && count >= matches_len) { fwnode_handle_put(ep); break; }
node = fwnode_graph_get_remote_port_parent(ep); if (!fwnode_device_is_available(node)) { fwnode_handle_put(node); continue; }
ret = match(node, con_id, data); fwnode_handle_put(node); if (ret) { if (matches) matches[count] = ret; count++; } } return count;}
static unsigned int fwnode_devcon_matches(const struct fwnode_handle *fwnode, const char *con_id, void *data, devcon_match_fn_t match, void **matches, unsigned int matches_len){ struct fwnode_handle *node; unsigned int count = 0; unsigned int i; void *ret;
for (i = 0; ; i++) { if (matches && count >= matches_len) break;
node = fwnode_find_reference(fwnode, con_id, i); if (IS_ERR(node)) break;
ret = match(node, NULL, data); fwnode_handle_put(node); if (ret) { if (matches) matches[count] = ret; count++; } }
return count;}
/** * fwnode_connection_find_match - Find connection from a device node * @fwnode: Device node with the connection * @con_id: Identifier for the connection * @data: Data for the match function * @match: Function to check and convert the connection description * * Find a connection with unique identifier @con_id between @fwnode and another * device node. @match will be used to convert the connection description to * data the caller is expecting to be returned. */void *fwnode_connection_find_match(const struct fwnode_handle *fwnode, const char *con_id, void *data, devcon_match_fn_t match){ unsigned int count; void *ret;
if (!fwnode || !match) return NULL;
count = fwnode_graph_devcon_matches(fwnode, con_id, data, match, &ret, 1); if (count) return ret;
count = fwnode_devcon_matches(fwnode, con_id, data, match, &ret, 1); return count ? ret : NULL;}EXPORT_SYMBOL_GPL(fwnode_connection_find_match);
/** * fwnode_connection_find_matches - Find connections from a device node * @fwnode: Device node with the connection * @con_id: Identifier for the connection * @data: Data for the match function * @match: Function to check and convert the connection description * @matches: (Optional) array of pointers to fill with matches * @matches_len: Length of @matches * * Find up to @matches_len connections with unique identifier @con_id between * @fwnode and other device nodes. @match will be used to convert the * connection description to data the caller is expecting to be returned * through the @matches array. * * If @matches is %NULL @matches_len is ignored and the total number of resolved * matches is returned. * * Return: Number of matches resolved, or negative errno. */int fwnode_connection_find_matches(const struct fwnode_handle *fwnode, const char *con_id, void *data, devcon_match_fn_t match, void **matches, unsigned int matches_len){ unsigned int count_graph; unsigned int count_ref;
if (!fwnode || !match) return -EINVAL;
count_graph = fwnode_graph_devcon_matches(fwnode, con_id, data, match, matches, matches_len);
if (matches) { matches += count_graph; matches_len -= count_graph; }
count_ref = fwnode_devcon_matches(fwnode, con_id, data, match, matches, matches_len);
return count_graph + count_ref;}EXPORT_SYMBOL_GPL(fwnode_connection_find_matches);