mirror of
https://github.com/u-boot/u-boot.git
synced 2024-11-29 07:33:29 +08:00
1fe243a1e4
Add clk_valid() to check for optional clocks are valid. Call clk_valid() in test/dm/clk.c and add relevant test routine to sandbox clk tests. Signed-off-by: Fabrice Gasnier <fabrice.gasnier@st.com> Reviewed-by: Simon Glass <sjg@chromium.org>
151 lines
4.2 KiB
C
151 lines
4.2 KiB
C
/* SPDX-License-Identifier: GPL-2.0 */
|
|
/*
|
|
* Copyright (c) 2016, NVIDIA CORPORATION.
|
|
*/
|
|
|
|
#ifndef __SANDBOX_CLK_H
|
|
#define __SANDBOX_CLK_H
|
|
|
|
#include <common.h>
|
|
|
|
struct udevice;
|
|
|
|
/**
|
|
* enum sandbox_clk_id - Identity of clocks implemented by the sandbox clock
|
|
* provider.
|
|
*
|
|
* These IDs are within/relative-to the clock provider.
|
|
*/
|
|
enum sandbox_clk_id {
|
|
SANDBOX_CLK_ID_SPI,
|
|
SANDBOX_CLK_ID_I2C,
|
|
|
|
SANDBOX_CLK_ID_COUNT,
|
|
};
|
|
|
|
/**
|
|
* enum sandbox_clk_test_id - Identity of the clocks consumed by the sandbox
|
|
* clock test device.
|
|
*
|
|
* These are the IDs the clock consumer knows the clocks as.
|
|
*/
|
|
enum sandbox_clk_test_id {
|
|
SANDBOX_CLK_TEST_ID_FIXED,
|
|
SANDBOX_CLK_TEST_ID_SPI,
|
|
SANDBOX_CLK_TEST_ID_I2C,
|
|
|
|
SANDBOX_CLK_TEST_ID_COUNT,
|
|
};
|
|
|
|
/**
|
|
* sandbox_clk_query_rate - Query the current rate of a sandbox clock.
|
|
*
|
|
* @dev: The sandbox clock provider device.
|
|
* @id: The clock to query.
|
|
* @return: The rate of the clock.
|
|
*/
|
|
ulong sandbox_clk_query_rate(struct udevice *dev, int id);
|
|
/**
|
|
* sandbox_clk_query_enable - Query the enable state of a sandbox clock.
|
|
*
|
|
* @dev: The sandbox clock provider device.
|
|
* @id: The clock to query.
|
|
* @return: The rate of the clock.
|
|
*/
|
|
int sandbox_clk_query_enable(struct udevice *dev, int id);
|
|
|
|
/**
|
|
* sandbox_clk_test_get - Ask the sandbox clock test device to request its
|
|
* clocks.
|
|
*
|
|
* @dev: The sandbox clock test (client) devivce.
|
|
* @return: 0 if OK, or a negative error code.
|
|
*/
|
|
int sandbox_clk_test_get(struct udevice *dev);
|
|
/**
|
|
* sandbox_clk_test_get_bulk - Ask the sandbox clock test device to request its
|
|
* clocks with the bulk clk API.
|
|
*
|
|
* @dev: The sandbox clock test (client) devivce.
|
|
* @return: 0 if OK, or a negative error code.
|
|
*/
|
|
int sandbox_clk_test_get_bulk(struct udevice *dev);
|
|
/**
|
|
* sandbox_clk_test_get_rate - Ask the sandbox clock test device to query a
|
|
* clock's rate.
|
|
*
|
|
* @dev: The sandbox clock test (client) devivce.
|
|
* @id: The test device's clock ID to query.
|
|
* @return: The rate of the clock.
|
|
*/
|
|
ulong sandbox_clk_test_get_rate(struct udevice *dev, int id);
|
|
/**
|
|
* sandbox_clk_test_set_rate - Ask the sandbox clock test device to set a
|
|
* clock's rate.
|
|
*
|
|
* @dev: The sandbox clock test (client) devivce.
|
|
* @id: The test device's clock ID to configure.
|
|
* @return: The new rate of the clock.
|
|
*/
|
|
ulong sandbox_clk_test_set_rate(struct udevice *dev, int id, ulong rate);
|
|
/**
|
|
* sandbox_clk_test_enable - Ask the sandbox clock test device to enable a
|
|
* clock.
|
|
*
|
|
* @dev: The sandbox clock test (client) devivce.
|
|
* @id: The test device's clock ID to configure.
|
|
* @return: 0 if OK, or a negative error code.
|
|
*/
|
|
int sandbox_clk_test_enable(struct udevice *dev, int id);
|
|
/**
|
|
* sandbox_clk_test_enable_bulk - Ask the sandbox clock test device to enable
|
|
* all clocks in it's clock bulk struct.
|
|
*
|
|
* @dev: The sandbox clock test (client) devivce.
|
|
* @return: 0 if OK, or a negative error code.
|
|
*/
|
|
int sandbox_clk_test_enable_bulk(struct udevice *dev);
|
|
/**
|
|
* sandbox_clk_test_disable - Ask the sandbox clock test device to disable a
|
|
* clock.
|
|
*
|
|
* @dev: The sandbox clock test (client) devivce.
|
|
* @id: The test device's clock ID to configure.
|
|
* @return: 0 if OK, or a negative error code.
|
|
*/
|
|
int sandbox_clk_test_disable(struct udevice *dev, int id);
|
|
/**
|
|
* sandbox_clk_test_disable_bulk - Ask the sandbox clock test device to disable
|
|
* all clocks in it's clock bulk struct.
|
|
*
|
|
* @dev: The sandbox clock test (client) devivce.
|
|
* @return: 0 if OK, or a negative error code.
|
|
*/
|
|
int sandbox_clk_test_disable_bulk(struct udevice *dev);
|
|
/**
|
|
* sandbox_clk_test_free - Ask the sandbox clock test device to free its
|
|
* clocks.
|
|
*
|
|
* @dev: The sandbox clock test (client) devivce.
|
|
* @return: 0 if OK, or a negative error code.
|
|
*/
|
|
int sandbox_clk_test_free(struct udevice *dev);
|
|
/**
|
|
* sandbox_clk_test_release_bulk - Ask the sandbox clock test device to release
|
|
* all clocks in it's clock bulk struct.
|
|
*
|
|
* @dev: The sandbox clock test (client) devivce.
|
|
* @return: 0 if OK, or a negative error code.
|
|
*/
|
|
int sandbox_clk_test_release_bulk(struct udevice *dev);
|
|
/**
|
|
* sandbox_clk_test_valid - Ask the sandbox clock test device to check its
|
|
* clocks are valid.
|
|
*
|
|
* @dev: The sandbox clock test (client) devivce.
|
|
* @return: 0 if OK, or a negative error code.
|
|
*/
|
|
int sandbox_clk_test_valid(struct udevice *dev);
|
|
|
|
#endif
|