mirror of
https://github.com/zephyrproject-rtos/zephyr
synced 2025-08-25 08:25:21 +00:00
Replace the existing Apache 2.0 boilerplate header with an SPDX tag throughout the zephyr code tree. This patch was generated via a script run over the master branch. Also updated doc/porting/application.rst that had a dependency on line numbers in a literal include. Manually updated subsys/logging/sys_log.c that had a malformed header in the original file. Also cleanup several cases that already had a SPDX tag and we either got a duplicate or missed updating. Jira: ZEP-1457 Change-Id: I6131a1d4ee0e58f5b938300c2d2fc77d2e69572c Signed-off-by: David B. Kinder <david.b.kinder@intel.com> Signed-off-by: Kumar Gala <kumar.gala@linaro.org>
97 lines
2.4 KiB
C
97 lines
2.4 KiB
C
/* clock_control.h - public clock controller driver API */
|
|
|
|
/*
|
|
* Copyright (c) 2015 Intel Corporation
|
|
*
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
|
|
#ifndef __CLOCK_CONTROL_H__
|
|
#define __CLOCK_CONTROL_H__
|
|
|
|
#include <stdint.h>
|
|
#include <stddef.h>
|
|
#include <device.h>
|
|
#include <misc/__assert.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/* Clock control API */
|
|
|
|
/* Used to select all subsystem of a clock controller */
|
|
#define CLOCK_CONTROL_SUBSYS_ALL NULL
|
|
|
|
/**
|
|
* clock_control_subsys_t is a type to identify a clock controller sub-system.
|
|
* Such data pointed is opaque and relevant only to the clock controller
|
|
* driver instance being used.
|
|
*/
|
|
typedef void *clock_control_subsys_t;
|
|
|
|
typedef int (*clock_control)(struct device *dev, clock_control_subsys_t sys);
|
|
|
|
typedef int (*clock_control_get)(struct device *dev,
|
|
clock_control_subsys_t sys,
|
|
uint32_t *rate);
|
|
|
|
struct clock_control_driver_api {
|
|
clock_control on;
|
|
clock_control off;
|
|
clock_control_get get_rate;
|
|
};
|
|
|
|
/**
|
|
* @brief Enable the clock of a sub-system controlled by the device
|
|
* @param dev Pointer to the device structure for the clock controller driver
|
|
* instance
|
|
* @param sys A pointer to an opaque data representing the sub-system
|
|
*/
|
|
static inline int clock_control_on(struct device *dev,
|
|
clock_control_subsys_t sys)
|
|
{
|
|
const struct clock_control_driver_api *api = dev->driver_api;
|
|
|
|
return api->on(dev, sys);
|
|
}
|
|
|
|
/**
|
|
* @brief Disable the clock of a sub-system controlled by the device
|
|
* @param dev Pointer to the device structure for the clock controller driver
|
|
* instance
|
|
* @param sys A pointer to an opaque data representing the sub-system
|
|
*/
|
|
static inline int clock_control_off(struct device *dev,
|
|
clock_control_subsys_t sys)
|
|
{
|
|
const struct clock_control_driver_api *api = dev->driver_api;
|
|
|
|
return api->off(dev, sys);
|
|
}
|
|
|
|
/**
|
|
* @brief Obtain the clock rate of given sub-system
|
|
* @param dev Pointer to the device structure for the clock controller driver
|
|
* instance
|
|
* @param sys A pointer to an opaque data representing the sub-system
|
|
* @param[out] rate Subsystem clock rate
|
|
*/
|
|
static inline int clock_control_get_rate(struct device *dev,
|
|
clock_control_subsys_t sys,
|
|
uint32_t *rate)
|
|
{
|
|
const struct clock_control_driver_api *api = dev->driver_api;
|
|
|
|
__ASSERT(api->get_rate, "%s not implemented for device %s",
|
|
__func__, dev->config->name);
|
|
|
|
return api->get_rate(dev, sys, rate);
|
|
}
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* __CLOCK_CONTROL_H__ */
|