dm: blk: Tidy up obtaining a block device from its parent

This function now finds its block-device child by looking for a child
device of the correct uclass (UCLASS_BLK). It cannot produce a device of
any other type, so drop the superfluous check.

Provide a version which does not probe the device, since that is often
needed when setting up the device's platdata.

Also fix up the function's comment.

Signed-off-by: Simon Glass <sjg@chromium.org>
This commit is contained in:
Simon Glass
2022-10-29 19:47:14 -06:00
parent d1b4659570
commit 41e751091d
3 changed files with 43 additions and 13 deletions

View File

@@ -453,10 +453,36 @@ int blk_next_free_devnum(enum uclass_id uclass_id);
*/
int blk_select_hwpart(struct udevice *dev, int hwpart);
/**
* blk_find_from_parent() - find a block device by looking up its parent
*
* All block devices have a parent 'media' device which provides the block
* driver for the block device, ensuring that access to the underlying medium
* is available.
*
* The block device is not activated by this function. See
* blk_get_from_parent() for that.
*
* @parent: Media device
* @devp: Returns the associated block device, if any
* Returns: 0 if OK, -ENODEV if @parent is not a media device and has no
* UCLASS_BLK child
*/
int blk_find_from_parent(struct udevice *parent, struct udevice **devp);
/**
* blk_get_from_parent() - obtain a block device by looking up its parent
*
* All devices with
* All block devices have a parent 'media' device which provides the block
* driver for the block device, ensuring that access to the underlying medium
* is available.
*
* The block device is probed and ready for use.
*
* @parent: Media device
* @devp: Returns the associated block device, if any
* Returns: 0 if OK, -ENODEV if @parent is not a media device and has no
* UCLASS_BLK child
*/
int blk_get_from_parent(struct udevice *parent, struct udevice **devp);