mirror of
https://github.com/AsahiLinux/u-boot
synced 2024-11-14 08:57:58 +00:00
02c07b3741
Some uclasses want to set up a device before it is probed. Add a method for this. An example is with PCI, where a PCI uclass wants to set up its private data for later use. This allows the device's uclass() method to make calls whcih use that data (for example, read PCI memory regions from device tree, set up bus numbers). Signed-off-by: Simon Glass <sjg@chromium.org>
120 lines
3.3 KiB
C
120 lines
3.3 KiB
C
/*
|
|
* Copyright (c) 2013 Google, Inc
|
|
*
|
|
* (C) Copyright 2012
|
|
* Pavel Herrmann <morpheus.ibis@gmail.com>
|
|
*
|
|
* SPDX-License-Identifier: GPL-2.0+
|
|
*/
|
|
|
|
#ifndef _DM_UCLASS_INTERNAL_H
|
|
#define _DM_UCLASS_INTERNAL_H
|
|
|
|
/**
|
|
* uclass_find_device() - Return n-th child of uclass
|
|
* @id: Id number of the uclass
|
|
* @index: Position of the child in uclass's list
|
|
* #devp: Returns pointer to device, or NULL on error
|
|
*
|
|
* The device is not prepared for use - this is an internal function
|
|
*
|
|
* @return the uclass pointer of a child at the given index or
|
|
* return NULL on error.
|
|
*/
|
|
int uclass_find_device(enum uclass_id id, int index, struct udevice **devp);
|
|
|
|
/**
|
|
* uclass_bind_device() - Associate device with a uclass
|
|
*
|
|
* Connect the device into uclass's list of devices.
|
|
*
|
|
* @dev: Pointer to the device
|
|
* #return 0 on success, -ve on error
|
|
*/
|
|
int uclass_bind_device(struct udevice *dev);
|
|
|
|
/**
|
|
* uclass_unbind_device() - Deassociate device with a uclass
|
|
*
|
|
* Disconnect the device from uclass's list of devices.
|
|
*
|
|
* @dev: Pointer to the device
|
|
* #return 0 on success, -ve on error
|
|
*/
|
|
int uclass_unbind_device(struct udevice *dev);
|
|
|
|
/**
|
|
* uclass_pre_probe_device() - Deal with a device that is about to be probed
|
|
*
|
|
* Perform any pre-processing that is needed by the uclass before it can be
|
|
* probed. This includes the uclass' pre-probe() method and the parent
|
|
* uclass' child_pre_probe() method.
|
|
*
|
|
* @dev: Pointer to the device
|
|
* #return 0 on success, -ve on error
|
|
*/
|
|
int uclass_pre_probe_device(struct udevice *dev);
|
|
|
|
/**
|
|
* uclass_post_probe_device() - Deal with a device that has just been probed
|
|
*
|
|
* Perform any post-processing of a probed device that is needed by the
|
|
* uclass.
|
|
*
|
|
* @dev: Pointer to the device
|
|
* #return 0 on success, -ve on error
|
|
*/
|
|
int uclass_post_probe_device(struct udevice *dev);
|
|
|
|
/**
|
|
* uclass_pre_remove_device() - Handle a device which is about to be removed
|
|
*
|
|
* Perform any pre-processing of a device that is about to be removed.
|
|
*
|
|
* @dev: Pointer to the device
|
|
* #return 0 on success, -ve on error
|
|
*/
|
|
int uclass_pre_remove_device(struct udevice *dev);
|
|
|
|
/**
|
|
* uclass_find() - Find uclass by its id
|
|
*
|
|
* @id: Id to serach for
|
|
* @return pointer to uclass, or NULL if not found
|
|
*/
|
|
struct uclass *uclass_find(enum uclass_id key);
|
|
|
|
/**
|
|
* uclass_destroy() - Destroy a uclass
|
|
*
|
|
* Destroy a uclass and all its devices
|
|
*
|
|
* @uc: uclass to destroy
|
|
* @return 0 on success, -ve on error
|
|
*/
|
|
int uclass_destroy(struct uclass *uc);
|
|
|
|
/**
|
|
* uclass_find_device_by_seq() - Find uclass device based on ID and sequence
|
|
*
|
|
* This searches for a device with the given seq or req_seq.
|
|
*
|
|
* For seq, if an active device has this sequence it will be returned.
|
|
* If there is no such device then this will return -ENODEV.
|
|
*
|
|
* For req_seq, if a device (whether activated or not) has this req_seq
|
|
* value, that device will be returned. This is a strong indication that
|
|
* the device will receive that sequence when activated.
|
|
*
|
|
* The device is NOT probed, it is merely returned.
|
|
*
|
|
* @id: ID to look up
|
|
* @seq_or_req_seq: Sequence number to find (0=first)
|
|
* @find_req_seq: true to find req_seq, false to find seq
|
|
* @devp: Returns pointer to device (there is only one per for each seq)
|
|
* @return 0 if OK, -ve on error
|
|
*/
|
|
int uclass_find_device_by_seq(enum uclass_id id, int seq_or_req_seq,
|
|
bool find_req_seq, struct udevice **devp);
|
|
|
|
#endif
|