Zephyr API Documentation  2.7.0-rc2
A Scalable Open Source RTOS
Clock Control Interface

Clock Control Interface. More...

Modules

 LiteX Clock Control driver interface
 LiteX Clock Control driver interface.
 

Data Structures

struct  clock_control_driver_api
 

Macros

#define CLOCK_CONTROL_SUBSYS_ALL   NULL
 

Typedefs

typedef voidclock_control_subsys_t
 
typedef void(* clock_control_cb_t) (const struct device *dev, clock_control_subsys_t subsys, void *user_data)
 Callback called on clock started. More...
 
typedef int(* clock_control) (const struct device *dev, clock_control_subsys_t sys)
 
typedef int(* clock_control_get) (const struct device *dev, clock_control_subsys_t sys, uint32_t *rate)
 
typedef int(* clock_control_async_on_fn) (const struct device *dev, clock_control_subsys_t sys, clock_control_cb_t cb, void *user_data)
 
typedef enum clock_control_status(* clock_control_get_status_fn) (const struct device *dev, clock_control_subsys_t sys)
 

Enumerations

enum  clock_control_status {
  CLOCK_CONTROL_STATUS_STARTING , CLOCK_CONTROL_STATUS_OFF , CLOCK_CONTROL_STATUS_ON , CLOCK_CONTROL_STATUS_UNAVAILABLE ,
  CLOCK_CONTROL_STATUS_UNKNOWN
}
 Current clock status. More...
 

Functions

static int clock_control_on (const struct device *dev, clock_control_subsys_t sys)
 Enable a clock controlled by the device. More...
 
static int clock_control_off (const struct device *dev, clock_control_subsys_t sys)
 Disable a clock controlled by the device. More...
 
static int clock_control_async_on (const struct device *dev, clock_control_subsys_t sys, clock_control_cb_t cb, void *user_data)
 Request clock to start with notification when clock has been started. More...
 
static enum clock_control_status clock_control_get_status (const struct device *dev, clock_control_subsys_t sys)
 Get clock status. More...
 
static int clock_control_get_rate (const struct device *dev, clock_control_subsys_t sys, uint32_t *rate)
 Obtain the clock rate of given sub-system. More...
 

Detailed Description

Clock Control Interface.

Macro Definition Documentation

◆ CLOCK_CONTROL_SUBSYS_ALL

#define CLOCK_CONTROL_SUBSYS_ALL   NULL

Typedef Documentation

◆ clock_control

typedef int(* clock_control) (const struct device *dev, clock_control_subsys_t sys)

◆ clock_control_async_on_fn

typedef int(* clock_control_async_on_fn) (const struct device *dev, clock_control_subsys_t sys, clock_control_cb_t cb, void *user_data)

◆ clock_control_cb_t

typedef void(* clock_control_cb_t) (const struct device *dev, clock_control_subsys_t subsys, void *user_data)

#include <include/drivers/clock_control.h>

Callback called on clock started.

Parameters
devDevice structure whose driver controls the clock.
subsysOpaque data representing the clock.
user_dataUser data.

◆ clock_control_get

typedef int(* clock_control_get) (const struct device *dev, clock_control_subsys_t sys, uint32_t *rate)

◆ clock_control_get_status_fn

typedef enum clock_control_status(* clock_control_get_status_fn) (const struct device *dev, clock_control_subsys_t sys)

◆ clock_control_subsys_t

#include <include/drivers/clock_control.h>

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.

Enumeration Type Documentation

◆ clock_control_status

#include <include/drivers/clock_control.h>

Current clock status.

Enumerator
CLOCK_CONTROL_STATUS_STARTING 
CLOCK_CONTROL_STATUS_OFF 
CLOCK_CONTROL_STATUS_ON 
CLOCK_CONTROL_STATUS_UNAVAILABLE 
CLOCK_CONTROL_STATUS_UNKNOWN 

Function Documentation

◆ clock_control_async_on()

static int clock_control_async_on ( const struct device dev,
clock_control_subsys_t  sys,
clock_control_cb_t  cb,
void user_data 
)
inlinestatic

#include <include/drivers/clock_control.h>

Request clock to start with notification when clock has been started.

Function is non-blocking and can be called from any context. User callback is called when clock is started.

Parameters
devDevice.
sysA pointer to an opaque data representing the sub-system.
cbCallback.
user_dataUser context passed to the callback.
Return values
0if start is successfully initiated.
-EALREADYif clock was already started and is starting or running.
-ENOTSUPIf the requested mode of operation is not supported.
-ENOSYSif the interface is not implemented.
othernegative errno on vendor specific error.

◆ clock_control_get_rate()

static int clock_control_get_rate ( const struct device dev,
clock_control_subsys_t  sys,
uint32_t rate 
)
inlinestatic

#include <include/drivers/clock_control.h>

Obtain the clock rate of given sub-system.

Parameters
devPointer to the device structure for the clock controller driver instance
sysA pointer to an opaque data representing the sub-system
[out]rateSubsystem clock rate

◆ clock_control_get_status()

static enum clock_control_status clock_control_get_status ( const struct device dev,
clock_control_subsys_t  sys 
)
inlinestatic

#include <include/drivers/clock_control.h>

Get clock status.

Parameters
devDevice.
sysA pointer to an opaque data representing the sub-system.
Returns
Status.

◆ clock_control_off()

static int clock_control_off ( const struct device dev,
clock_control_subsys_t  sys 
)
inlinestatic

#include <include/drivers/clock_control.h>

Disable a clock controlled by the device.

This function is non-blocking and can be called from any context. On success, the clock is disabled when this function returns.

Parameters
devDevice structure whose driver controls the clock
sysOpaque data representing the clock
Returns
0 on success, negative errno on failure.

◆ clock_control_on()

static int clock_control_on ( const struct device dev,
clock_control_subsys_t  sys 
)
inlinestatic

#include <include/drivers/clock_control.h>

Enable a clock controlled by the device.

On success, the clock is enabled and ready when this function returns. This function may sleep, and thus can only be called from thread context.

Use clock_control_async_on() for non-blocking operation.

Parameters
devDevice structure whose driver controls the clock.
sysOpaque data representing the clock.
Returns
0 on success, negative errno on failure.