mirror of
https://xff.cz/git/u-boot/
synced 2025-10-22 10:31:56 +02:00
drivers: reset: Add a managed API to get reset controllers from the DT
Add managed functions to get a reset_ctl from the device-tree, based on a name or an index. Also add a managed functions to get a reset_ctl_bulk (array of reset_ctl) from the device-tree. When the device is unbound, the reset controllers are automatically released and the data structure is freed. Signed-off-by: Jean-Jacques Hiblot <jjhiblot@ti.com> Reviewed-by: Simon Glass <sjg@chromium.org> Signed-off-by: Pratyush Yadav <p.yadav@ti.com>
This commit is contained in:
committed by
Tom Rini
parent
01114adfc1
commit
139e4a1cbe
135
include/reset.h
135
include/reset.h
@@ -7,7 +7,7 @@
|
||||
#define _RESET_H
|
||||
|
||||
#include <dm/ofnode.h>
|
||||
#include <linux/errno.h>
|
||||
#include <linux/err.h>
|
||||
|
||||
/**
|
||||
* A reset is a hardware signal indicating that a HW module (or IP block, or
|
||||
@@ -84,6 +84,98 @@ struct reset_ctl_bulk {
|
||||
};
|
||||
|
||||
#if CONFIG_IS_ENABLED(DM_RESET)
|
||||
|
||||
/**
|
||||
* devm_reset_control_get - resource managed reset_get_by_name()
|
||||
* @dev: device to be reset by the controller
|
||||
* @id: reset line name
|
||||
*
|
||||
* Managed reset_get_by_name(). For reset controllers returned
|
||||
* from this function, reset_free() is called automatically on driver
|
||||
* detach.
|
||||
*
|
||||
* Returns a struct reset_ctl or IS_ERR() condition containing errno.
|
||||
*/
|
||||
struct reset_ctl *devm_reset_control_get(struct udevice *dev, const char *id);
|
||||
|
||||
/**
|
||||
* devm_reset_control_get_optional - resource managed reset_get_by_name() that
|
||||
* can fail
|
||||
* @dev: The client device.
|
||||
* @id: reset line name
|
||||
*
|
||||
* Managed reset_get_by_name(). For reset controllers returned
|
||||
* from this function, reset_free() is called automatically on driver
|
||||
* detach.
|
||||
*
|
||||
* Returns a struct reset_ctl or a dummy reset controller if it failed.
|
||||
*/
|
||||
struct reset_ctl *devm_reset_control_get_optional(struct udevice *dev,
|
||||
const char *id);
|
||||
|
||||
/**
|
||||
* devm_reset_control_get - resource managed reset_get_by_index()
|
||||
* @dev: The client device.
|
||||
* @index: The index of the reset signal to request, within the client's
|
||||
* list of reset signals.
|
||||
*
|
||||
* Managed reset_get_by_index(). For reset controllers returned
|
||||
* from this function, reset_free() is called automatically on driver
|
||||
* detach.
|
||||
*
|
||||
* Returns a struct reset_ctl or IS_ERR() condition containing errno.
|
||||
*/
|
||||
struct reset_ctl *devm_reset_control_get_by_index(struct udevice *dev,
|
||||
int index);
|
||||
|
||||
/**
|
||||
* devm_reset_bulk_get - resource managed reset_get_bulk()
|
||||
* @dev: device to be reset by the controller
|
||||
*
|
||||
* Managed reset_get_bulk(). For reset controllers returned
|
||||
* from this function, reset_free() is called automatically on driver
|
||||
* detach.
|
||||
*
|
||||
* Returns a struct reset_ctl or IS_ERR() condition containing errno.
|
||||
*/
|
||||
struct reset_ctl_bulk *devm_reset_bulk_get(struct udevice *dev);
|
||||
|
||||
/**
|
||||
* devm_reset_bulk_get_optional - resource managed reset_get_bulk() that
|
||||
* can fail
|
||||
* @dev: The client device.
|
||||
*
|
||||
* Managed reset_get_bulk(). For reset controllers returned
|
||||
* from this function, reset_free() is called automatically on driver
|
||||
* detach.
|
||||
*
|
||||
* Returns a struct reset_ctl or NULL if it failed.
|
||||
*/
|
||||
struct reset_ctl_bulk *devm_reset_bulk_get_optional(struct udevice *dev);
|
||||
|
||||
/**
|
||||
* devm_reset_bulk_get_by_node - resource managed reset_get_bulk()
|
||||
* @dev: device to be reset by the controller
|
||||
* @node: ofnode where the "resets" property is. Usually a sub-node of
|
||||
* the dev's node.
|
||||
*
|
||||
* see devm_reset_bulk_get()
|
||||
*/
|
||||
struct reset_ctl_bulk *devm_reset_bulk_get_by_node(struct udevice *dev,
|
||||
ofnode node);
|
||||
|
||||
/**
|
||||
* devm_reset_bulk_get_optional_by_node - resource managed reset_get_bulk()
|
||||
* that can fail
|
||||
* @dev: device to be reset by the controller
|
||||
* @node: ofnode where the "resets" property is. Usually a sub-node of
|
||||
* the dev's node.
|
||||
*
|
||||
* see devm_reset_bulk_get_optional()
|
||||
*/
|
||||
struct reset_ctl_bulk *devm_reset_bulk_get_optional_by_node(struct udevice *dev,
|
||||
ofnode node);
|
||||
|
||||
/**
|
||||
* reset_get_by_index - Get/request a reset signal by integer index.
|
||||
*
|
||||
@@ -265,7 +357,48 @@ static inline int reset_release_bulk(struct reset_ctl_bulk *bulk)
|
||||
{
|
||||
return reset_release_all(bulk->resets, bulk->count);
|
||||
}
|
||||
|
||||
#else
|
||||
static inline struct reset_ctl *devm_reset_control_get(struct udevice *dev,
|
||||
const char *id)
|
||||
{
|
||||
return ERR_PTR(-ENOTSUPP);
|
||||
}
|
||||
|
||||
static inline struct reset_ctl *devm_reset_control_get_optional(struct udevice *dev,
|
||||
const char *id)
|
||||
{
|
||||
return NULL;
|
||||
}
|
||||
|
||||
static inline struct reset_ctl *devm_reset_control_get_by_index(struct udevice *dev,
|
||||
int index)
|
||||
{
|
||||
return ERR_PTR(-ENOTSUPP);
|
||||
}
|
||||
|
||||
static inline struct reset_ctl_bulk *devm_reset_bulk_get(struct udevice *dev)
|
||||
{
|
||||
return ERR_PTR(-ENOTSUPP);
|
||||
}
|
||||
|
||||
static inline struct reset_ctl_bulk *devm_reset_bulk_get_optional(struct udevice *dev)
|
||||
{
|
||||
return NULL;
|
||||
}
|
||||
|
||||
static inline struct reset_ctl_bulk *devm_reset_bulk_get_by_node(struct udevice *dev,
|
||||
ofnode node)
|
||||
{
|
||||
return ERR_PTR(-ENOTSUPP);
|
||||
}
|
||||
|
||||
static inline struct reset_ctl_bulk *devm_reset_bulk_get_optional_by_node(struct udevice *dev,
|
||||
ofnode node)
|
||||
{
|
||||
return NULL;
|
||||
}
|
||||
|
||||
static inline int reset_get_by_index(struct udevice *dev, int index,
|
||||
struct reset_ctl *reset_ctl)
|
||||
{
|
||||
|
||||
Reference in New Issue
Block a user