mirror of
https://github.com/AsahiLinux/u-boot
synced 2024-12-12 06:12:58 +00:00
2983ad55a1
It returns the rate which will be set if you ask clk_set_rate() to set that rate. It provides a way to query exactly what rate you'll get if you call clk_set_rate() with that same argument. So essentially, clk_round_rate() and clk_set_rate() are equivalent except the former does not modify the clock hardware in any way. Signed-off-by: Dario Binacchi <dariobin@libero.it> Reviewed-by: Simon Glass <sjg@chromium.org> Reviewed-by: Sean Anderson <seanga2@gmail.com>
193 lines
5.5 KiB
C
193 lines
5.5 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_UART1,
|
|
SANDBOX_CLK_ID_UART2,
|
|
SANDBOX_CLK_ID_BUS,
|
|
|
|
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_DEVM1,
|
|
SANDBOX_CLK_TEST_ID_DEVM2,
|
|
SANDBOX_CLK_TEST_ID_DEVM_NULL,
|
|
|
|
SANDBOX_CLK_TEST_ID_COUNT,
|
|
};
|
|
|
|
#define SANDBOX_CLK_TEST_NON_DEVM_COUNT SANDBOX_CLK_TEST_ID_DEVM1
|
|
|
|
/**
|
|
* 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_query_requested - Query the requested 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_requested(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_devm_get - Ask the sandbox clock test device to request its
|
|
* clocks using the managed API.
|
|
*
|
|
* @dev: The sandbox clock test (client) devivce.
|
|
* @return: 0 if OK, or a negative error code.
|
|
*/
|
|
int sandbox_clk_test_devm_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_round_rate - Ask the sandbox clock test device to round a
|
|
* clock's rate.
|
|
*
|
|
* @dev: The sandbox clock test (client) device.
|
|
* @id: The test device's clock ID to configure.
|
|
* @return: The rounded rate of the clock.
|
|
*/
|
|
ulong sandbox_clk_test_round_rate(struct udevice *dev, int id, ulong rate);
|
|
/**
|
|
* 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);
|
|
/**
|
|
* 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.
|
|
*/
|
|
struct clk *sandbox_clk_test_get_devm_clk(struct udevice *dev, int id);
|
|
|
|
#endif
|