mirror of
https://github.com/AsahiLinux/u-boot
synced 2024-11-12 07:57:21 +00:00
caa4daa2ae
We use 'priv' for private data but often use 'platdata' for platform data. We can't really use 'pdata' since that is ambiguous (it could mean private or platform data). Rename some of the latter variables to end with 'plat' for consistency. Signed-off-by: Simon Glass <sjg@chromium.org>
240 lines
7.2 KiB
C
240 lines
7.2 KiB
C
/* SPDX-License-Identifier: GPL-2.0+ */
|
|
/*
|
|
* Copyright (C) 2013 Google, Inc
|
|
*
|
|
* (C) Copyright 2012
|
|
* Pavel Herrmann <morpheus.ibis@gmail.com>
|
|
* Marek Vasut <marex@denx.de>
|
|
*/
|
|
|
|
#ifndef _DM_DEVICE_INTERNAL_H
|
|
#define _DM_DEVICE_INTERNAL_H
|
|
|
|
#include <dm/ofnode.h>
|
|
|
|
struct device_node;
|
|
struct udevice;
|
|
|
|
/**
|
|
* device_bind() - Create a device and bind it to a driver
|
|
*
|
|
* Called to set up a new device attached to a driver. The device will either
|
|
* have plat, or a device tree node which can be used to create the
|
|
* plat.
|
|
*
|
|
* Once bound a device exists but is not yet active until device_probe() is
|
|
* called.
|
|
*
|
|
* @parent: Pointer to device's parent, under which this driver will exist
|
|
* @drv: Device's driver
|
|
* @name: Name of device (e.g. device tree node name)
|
|
* @plat: Pointer to data for this device - the structure is device-
|
|
* specific but may include the device's I/O address, etc.. This is NULL for
|
|
* devices which use device tree.
|
|
* @ofnode: Devicetree node for this device. This is ofnode_null() for
|
|
* devices which don't use devicetree or don't have a node.
|
|
* @devp: if non-NULL, returns a pointer to the bound device
|
|
* @return 0 if OK, -ve on error
|
|
*/
|
|
int device_bind(struct udevice *parent, const struct driver *drv,
|
|
const char *name, void *plat, ofnode node,
|
|
struct udevice **devp);
|
|
|
|
/**
|
|
* device_bind_with_driver_data() - Create a device and bind it to a driver
|
|
*
|
|
* Called to set up a new device attached to a driver, in the case where the
|
|
* driver was matched to the device by means of a match table that provides
|
|
* driver_data.
|
|
*
|
|
* Once bound a device exists but is not yet active until device_probe() is
|
|
* called.
|
|
*
|
|
* @parent: Pointer to device's parent, under which this driver will exist
|
|
* @drv: Device's driver
|
|
* @name: Name of device (e.g. device tree node name)
|
|
* @driver_data: The driver_data field from the driver's match table.
|
|
* @node: Device tree node for this device. This is invalid for devices which
|
|
* don't use device tree.
|
|
* @devp: if non-NULL, returns a pointer to the bound device
|
|
* @return 0 if OK, -ve on error
|
|
*/
|
|
int device_bind_with_driver_data(struct udevice *parent,
|
|
const struct driver *drv, const char *name,
|
|
ulong driver_data, ofnode node,
|
|
struct udevice **devp);
|
|
/**
|
|
* device_bind_by_name: Create a device and bind it to a driver
|
|
*
|
|
* This is a helper function used to bind devices which do not use device
|
|
* tree.
|
|
*
|
|
* @parent: Pointer to device's parent
|
|
* @pre_reloc_only: If true, bind the driver only if its DM_FLAG_PRE_RELOC flag
|
|
* is set. If false bind the driver always.
|
|
* @info: Name and plat for this device
|
|
* @devp: if non-NULL, returns a pointer to the bound device
|
|
* @return 0 if OK, -ve on error
|
|
*/
|
|
int device_bind_by_name(struct udevice *parent, bool pre_reloc_only,
|
|
const struct driver_info *info, struct udevice **devp);
|
|
|
|
/**
|
|
* device_reparent: reparent the device to a new parent
|
|
*
|
|
* @dev: pointer to device to be reparented
|
|
* @new_parent: pointer to new parent device
|
|
* @return 0 if OK, -ve on error
|
|
*/
|
|
int device_reparent(struct udevice *dev, struct udevice *new_parent);
|
|
|
|
/**
|
|
* device_ofdata_to_platdata() - Read platform data for a device
|
|
*
|
|
* Read platform data for a device (typically from the device tree) so that
|
|
* the information needed to probe the device is present.
|
|
*
|
|
* This may cause some others devices to be probed if this one depends on them,
|
|
* e.g. a GPIO line will cause a GPIO device to be probed.
|
|
*
|
|
* All private data associated with the device is allocated.
|
|
*
|
|
* @dev: Pointer to device to process
|
|
* @return 0 if OK, -ve on error
|
|
*/
|
|
int device_ofdata_to_platdata(struct udevice *dev);
|
|
|
|
/**
|
|
* device_probe() - Probe a device, activating it
|
|
*
|
|
* Activate a device so that it is ready for use. All its parents are probed
|
|
* first.
|
|
*
|
|
* @dev: Pointer to device to probe
|
|
* @return 0 if OK, -ve on error
|
|
*/
|
|
int device_probe(struct udevice *dev);
|
|
|
|
/**
|
|
* device_remove() - Remove a device, de-activating it
|
|
*
|
|
* De-activate a device so that it is no longer ready for use. All its
|
|
* children are deactivated first.
|
|
*
|
|
* @dev: Pointer to device to remove
|
|
* @flags: Flags for selective device removal (DM_REMOVE_...)
|
|
* @return 0 if OK, -ve on error (an error here is normally a very bad thing)
|
|
*/
|
|
#if CONFIG_IS_ENABLED(DM_DEVICE_REMOVE)
|
|
int device_remove(struct udevice *dev, uint flags);
|
|
#else
|
|
static inline int device_remove(struct udevice *dev, uint flags) { return 0; }
|
|
#endif
|
|
|
|
/**
|
|
* device_unbind() - Unbind a device, destroying it
|
|
*
|
|
* Unbind a device and remove all memory used by it
|
|
*
|
|
* @dev: Pointer to device to unbind
|
|
* @return 0 if OK, -ve on error
|
|
*/
|
|
#if CONFIG_IS_ENABLED(DM_DEVICE_REMOVE)
|
|
int device_unbind(struct udevice *dev);
|
|
#else
|
|
static inline int device_unbind(struct udevice *dev) { return 0; }
|
|
#endif
|
|
|
|
#if CONFIG_IS_ENABLED(DM_DEVICE_REMOVE)
|
|
void device_free(struct udevice *dev);
|
|
#else
|
|
static inline void device_free(struct udevice *dev) {}
|
|
#endif
|
|
|
|
/**
|
|
* device_chld_unbind() - Unbind all device's children from the device if bound
|
|
* to drv
|
|
*
|
|
* On error, the function continues to unbind all children, and reports the
|
|
* first error.
|
|
*
|
|
* @dev: The device that is to be stripped of its children
|
|
* @drv: The targeted driver
|
|
* @return 0 on success, -ve on error
|
|
*/
|
|
#if CONFIG_IS_ENABLED(DM_DEVICE_REMOVE)
|
|
int device_chld_unbind(struct udevice *dev, struct driver *drv);
|
|
#else
|
|
static inline int device_chld_unbind(struct udevice *dev, struct driver *drv)
|
|
{
|
|
return 0;
|
|
}
|
|
#endif
|
|
|
|
/**
|
|
* device_chld_remove() - Stop all device's children
|
|
* @dev: The device whose children are to be removed
|
|
* @drv: The targeted driver
|
|
* @flags: Flag, if this functions is called in the pre-OS stage
|
|
* @return 0 on success, -ve on error
|
|
*/
|
|
#if CONFIG_IS_ENABLED(DM_DEVICE_REMOVE)
|
|
int device_chld_remove(struct udevice *dev, struct driver *drv,
|
|
uint flags);
|
|
#else
|
|
static inline int device_chld_remove(struct udevice *dev, struct driver *drv,
|
|
uint flags)
|
|
{
|
|
return 0;
|
|
}
|
|
#endif
|
|
|
|
/**
|
|
* simple_bus_translate() - translate a bus address to a system address
|
|
*
|
|
* This handles the 'ranges' property in a simple bus. It translates the
|
|
* device address @addr to a system address using this property.
|
|
*
|
|
* @dev: Simple bus device (parent of target device)
|
|
* @addr: Address to translate
|
|
* @return new address
|
|
*/
|
|
fdt_addr_t simple_bus_translate(struct udevice *dev, fdt_addr_t addr);
|
|
|
|
/* Cast away any volatile pointer */
|
|
#define DM_ROOT_NON_CONST (((gd_t *)gd)->dm_root)
|
|
#define DM_UCLASS_ROOT_NON_CONST (((gd_t *)gd)->uclass_root)
|
|
|
|
/* device resource management */
|
|
#ifdef CONFIG_DEVRES
|
|
|
|
/**
|
|
* devres_release_probe - Release managed resources allocated after probing
|
|
* @dev: Device to release resources for
|
|
*
|
|
* Release all resources allocated for @dev when it was probed or later.
|
|
* This function is called on driver removal.
|
|
*/
|
|
void devres_release_probe(struct udevice *dev);
|
|
|
|
/**
|
|
* devres_release_all - Release all managed resources
|
|
* @dev: Device to release resources for
|
|
*
|
|
* Release all resources associated with @dev. This function is
|
|
* called on driver unbinding.
|
|
*/
|
|
void devres_release_all(struct udevice *dev);
|
|
|
|
#else /* ! CONFIG_DEVRES */
|
|
|
|
static inline void devres_release_probe(struct udevice *dev)
|
|
{
|
|
}
|
|
|
|
static inline void devres_release_all(struct udevice *dev)
|
|
{
|
|
}
|
|
|
|
#endif /* ! CONFIG_DEVRES */
|
|
#endif
|