u-boot.git/include/dm/uclass.h, branch v2017.09

dm: core: Add uclass_first/next_device_check()

2017-07-11T16:08:19+00:00

Sometimes it is useful to iterate through all devices in a uclass and
skip over those which do not work correctly (e.g fail to probe). Add two
new functions to provide this feature.

The caller must check the return value each time to make sure that the
device is valid. But the device pointer is always returned.

Signed-off-by: Simon Glass

dm: core: Clarify uclass_first/next_device() comments

2017-07-11T16:08:19+00:00

These are not as clear as they could be. Tidy them up a bit. Also fix a
tiny code-style nit.

Signed-off-by: Simon Glass

dm: core: Add a way to find a device by ofnode

2017-06-01T13:03:08+00:00

Add a function which looks up a device by its node (either in live tree
or flat tree).

Signed-off-by: Simon Glass

dm: core: Add a function to get a uclass name

2016-10-11T03:55:33+00:00

It is useful in debug() statements to display the name of the uclass for a
device. Add a simple function to provide this.

Signed-off-by: Simon Glass 
Reviewed-by: Bin Meng

dm: core: Add a way to find a device by its driver

2016-07-26T02:46:43+00:00

Some SoCs have a single clock device. Provide a way to find it given its
driver name. This is handled by the linker so will fail if the name is not
found, avoiding strange errors when names change and do not match. It is
also faster than a string comparison.

Signed-off-by: Simon Glass

dm: core: Add uclass_first_device_err() to return a valid device

2016-03-14T21:34:50+00:00

A common pattern is to call uclass_first_device() and then check if it
actually returns a device. Add a new function which does this, returning
an error if there are no devices in that uclass.

Signed-off-by: Simon Glass

dm: core: Add safe device iteration macros

2015-11-20T03:27:51+00:00

Add iteration macros which support unbinding a device within the loop.

Signed-off-by: Simon Glass

dm: simplify uclass_foreach_dev() implementation

2015-08-31T13:56:44+00:00

This can be simply written with list_for_each_entry(), maybe
this macro was not necessary in the first place.

Signed-off-by: Masahiro Yamada 
Acked-by: Simon Glass

dm: core: Fix a typo in the uclass_get_device_by_name() comment

2015-08-06T13:44:30+00:00

This function comment has a typo. Fix it.

Signed-off-by: Simon Glass 
Reviewed-by: Bin Meng

dm: core: Support finding a device by phandle

2015-08-06T02:57:51+00:00

It is common for one node to reference another via a phandle. Add support
for obtaining an attached device by this method. As an example, a node may
have a 'power-supply' property which references a regulator, allowing the
driver to turn on its power.

Signed-off-by: Simon Glass