include/clk-uclass.h

   1 /* SPDX-License-Identifier: GPL-2.0+ */
   2 /*
   3  * Copyright (c) 2015 Google, Inc
   4  * Written by Simon Glass <sjg@chromium.org>
   5  * Copyright (c) 2016, NVIDIA CORPORATION.
   6  */
   7
   8 #ifndef _CLK_UCLASS_H
   9 #define _CLK_UCLASS_H
  10
  11 /* See clk.h for background documentation. */
  12
  13 #include <clk.h>
  14
  15 struct ofnode_phandle_args;
  16
  17 /**
  18  * struct clk_ops - The functions that a clock driver must implement.
  19  * @of_xlate: Translate a client's device-tree (OF) clock specifier.
  20  * @request: Request a translated clock.
  21  * @rfree: Free a previously requested clock.
  22  * @round_rate: Adjust a rate to the exact rate a clock can provide.
  23  * @get_rate: Get current clock rate.
  24  * @set_rate: Set current clock rate.
  25  * @set_parent: Set current clock parent
  26  * @enable: Enable a clock.
  27  * @disable: Disable a clock.
  28  *
  29  * The individual methods are described more fully below.
  30  */
  31 struct clk_ops {
  32         int (*of_xlate)(struct clk *clock,
  33                         struct ofnode_phandle_args *args);
  34         int (*request)(struct clk *clock);
  35         int (*rfree)(struct clk *clock);
  36         ulong (*round_rate)(struct clk *clk, ulong rate);
  37         ulong (*get_rate)(struct clk *clk);
  38         ulong (*set_rate)(struct clk *clk, ulong rate);
  39         int (*set_parent)(struct clk *clk, struct clk *parent);
  40         int (*enable)(struct clk *clk);
  41         int (*disable)(struct clk *clk);
  42 };
  43
  44 #if 0 /* For documentation only */
  45 /**
  46  * of_xlate() - Translate a client's device-tree (OF) clock specifier.
  47  * @clock:      The clock struct to hold the translation result.
  48  * @args:       The clock specifier values from device tree.
  49  *
  50  * The clock core calls this function as the first step in implementing
  51  * a client's clk_get_by_*() call.
  52  *
  53  * If this function pointer is set to NULL, the clock core will use a
  54  * default implementation, which assumes #clock-cells = <1>, and that
  55  * the DT cell contains a simple integer clock ID.
  56  *
  57  * At present, the clock API solely supports device-tree. If this
  58  * changes, other xxx_xlate() functions may be added to support those
  59  * other mechanisms.
  60  *
  61  * Return: 0 if OK, or a negative error code.
  62  */
  63 int of_xlate(struct clk *clock, struct ofnode_phandle_args *args);
  64
  65 /**
  66  * request() - Request a translated clock.
  67  * @clock:      The clock struct to request; this has been fille in by
  68  *              a previoux xxx_xlate() function call, or by the caller
  69  *              of clk_request().
  70  *
  71  * The clock core calls this function as the second step in
  72  * implementing a client's clk_get_by_*() call, following a successful
  73  * xxx_xlate() call, or as the only step in implementing a client's
  74  * clk_request() call.
  75  *
  76  * Return: 0 if OK, or a negative error code.
  77  */
  78 int request(struct clk *clock);
  79
  80 /**
  81  * rfree() - Free a previously requested clock.
  82  * @clock:      The clock to free.
  83  *
  84  * This is the implementation of the client clk_free() API.
  85  *
  86  * Return: 0 if OK, or a negative error code.
  87  */
  88 int rfree(struct clk *clock);
  89
  90 /**
  91  * round_rate() - Adjust a rate to the exact rate a clock can provide.
  92  * @clk:        The clock to manipulate.
  93  * @rate:       Desidered clock rate in Hz.
  94  *
  95  * Return: rounded rate in Hz, or -ve error code.
  96  */
  97 ulong round_rate(struct clk *clk, ulong rate);
  98
  99 /**
 100  * get_rate() - Get current clock rate.
 101  * @clk:        The clock to query.
 102  *
 103  * Return: clock rate in Hz, or -ve error code
 104  */
 105 ulong get_rate(struct clk *clk);
 106
 107 /**
 108  * set_rate() - Set current clock rate.
 109  * @clk:        The clock to manipulate.
 110  * @rate:       New clock rate in Hz.
 111  *
 112  * Return: new rate, or -ve error code.
 113  */
 114 ulong set_rate(struct clk *clk, ulong rate);
 115
 116 /**
 117  * set_parent() - Set current clock parent
 118  * @clk:        The clock to manipulate.
 119  * @parent:     New clock parent.
 120  *
 121  * Return: zero on success, or -ve error code.
 122  */
 123 int set_parent(struct clk *clk, struct clk *parent);
 124
 125 /**
 126  * enable() - Enable a clock.
 127  * @clk:        The clock to manipulate.
 128  *
 129  * Return: zero on success, or -ve error code.
 130  */
 131 int enable(struct clk *clk);
 132
 133 /**
 134  * disable() - Disable a clock.
 135  * @clk:        The clock to manipulate.
 136  *
 137  * Return: zero on success, or -ve error code.
 138  */
 139 int disable(struct clk *clk);
 140 #endif
 141
 142 #endif