xref: /rk3399_rockchip-uboot/include/dm/uclass-internal.h (revision 54c5d08a09e631f88738db54c75395c6457c2157)
16494d708SSimon Glass /*
26494d708SSimon Glass  * Copyright (c) 2013 Google, Inc
36494d708SSimon Glass  *
46494d708SSimon Glass  * (C) Copyright 2012
56494d708SSimon Glass  * Pavel Herrmann <morpheus.ibis@gmail.com>
66494d708SSimon Glass  *
76494d708SSimon Glass  * SPDX-License-Identifier:	GPL-2.0+
86494d708SSimon Glass  */
96494d708SSimon Glass 
106494d708SSimon Glass #ifndef _DM_UCLASS_INTERNAL_H
116494d708SSimon Glass #define _DM_UCLASS_INTERNAL_H
126494d708SSimon Glass 
136494d708SSimon Glass /**
146494d708SSimon Glass  * uclass_find_device() - Return n-th child of uclass
156494d708SSimon Glass  * @id:		Id number of the uclass
166494d708SSimon Glass  * @index:	Position of the child in uclass's list
176494d708SSimon Glass  * #devp:	Returns pointer to device, or NULL on error
186494d708SSimon Glass  *
196494d708SSimon Glass  * The device is not prepared for use - this is an internal function
206494d708SSimon Glass  *
216494d708SSimon Glass  * @return the uclass pointer of a child at the given index or
226494d708SSimon Glass  * return NULL on error.
236494d708SSimon Glass  */
24*54c5d08aSHeiko Schocher int uclass_find_device(enum uclass_id id, int index, struct udevice **devp);
256494d708SSimon Glass 
266494d708SSimon Glass /**
276494d708SSimon Glass  * uclass_bind_device() - Associate device with a uclass
286494d708SSimon Glass  *
296494d708SSimon Glass  * Connect the device into uclass's list of devices.
306494d708SSimon Glass  *
316494d708SSimon Glass  * @dev:	Pointer to the device
326494d708SSimon Glass  * #return 0 on success, -ve on error
336494d708SSimon Glass  */
34*54c5d08aSHeiko Schocher int uclass_bind_device(struct udevice *dev);
356494d708SSimon Glass 
366494d708SSimon Glass /**
376494d708SSimon Glass  * uclass_unbind_device() - Deassociate device with a uclass
386494d708SSimon Glass  *
396494d708SSimon Glass  * Disconnect the device from uclass's list of devices.
406494d708SSimon Glass  *
416494d708SSimon Glass  * @dev:	Pointer to the device
426494d708SSimon Glass  * #return 0 on success, -ve on error
436494d708SSimon Glass  */
44*54c5d08aSHeiko Schocher int uclass_unbind_device(struct udevice *dev);
456494d708SSimon Glass 
466494d708SSimon Glass /**
476494d708SSimon Glass  * uclass_post_probe_device() - Deal with a device that has just been probed
486494d708SSimon Glass  *
496494d708SSimon Glass  * Perform any post-processing of a probed device that is needed by the
506494d708SSimon Glass  * uclass.
516494d708SSimon Glass  *
526494d708SSimon Glass  * @dev:	Pointer to the device
536494d708SSimon Glass  * #return 0 on success, -ve on error
546494d708SSimon Glass  */
55*54c5d08aSHeiko Schocher int uclass_post_probe_device(struct udevice *dev);
566494d708SSimon Glass 
576494d708SSimon Glass /**
586494d708SSimon Glass  * uclass_pre_remove_device() - Handle a device which is about to be removed
596494d708SSimon Glass  *
606494d708SSimon Glass  * Perform any pre-processing of a device that is about to be removed.
616494d708SSimon Glass  *
626494d708SSimon Glass  * @dev:	Pointer to the device
636494d708SSimon Glass  * #return 0 on success, -ve on error
646494d708SSimon Glass  */
65*54c5d08aSHeiko Schocher int uclass_pre_remove_device(struct udevice *dev);
666494d708SSimon Glass 
676494d708SSimon Glass /**
686494d708SSimon Glass  * uclass_find() - Find uclass by its id
696494d708SSimon Glass  *
706494d708SSimon Glass  * @id:		Id to serach for
716494d708SSimon Glass  * @return pointer to uclass, or NULL if not found
726494d708SSimon Glass  */
736494d708SSimon Glass struct uclass *uclass_find(enum uclass_id key);
746494d708SSimon Glass 
756494d708SSimon Glass /**
766494d708SSimon Glass  * uclass_destroy() - Destroy a uclass
776494d708SSimon Glass  *
786494d708SSimon Glass  * Destroy a uclass and all its devices
796494d708SSimon Glass  *
806494d708SSimon Glass  * @uc: uclass to destroy
816494d708SSimon Glass  * @return 0 on success, -ve on error
826494d708SSimon Glass  */
836494d708SSimon Glass int uclass_destroy(struct uclass *uc);
846494d708SSimon Glass 
856494d708SSimon Glass #endif
86