]> git.ipfire.org Git - people/ms/u-boot.git/blobdiff - include/clk.h
arc/cache: really do invalidate_dcache_all() even if IOC exists
[people/ms/u-boot.git] / include / clk.h
index 254ad2b8761bf4acef3a5b4b06b3c6bc4c11ac11..ca20c3dd27c1c5de8a66c3049c6d042e2b05d433 100644 (file)
@@ -8,6 +8,11 @@
 #ifndef _CLK_H_
 #define _CLK_H_
 
+#include <errno.h>
+#include <linux/types.h>
+
+struct udevice;
+
 int soc_clk_dump(void);
 
 struct clk_ops {
@@ -29,19 +34,28 @@ struct clk_ops {
        ulong (*set_rate)(struct udevice *dev, ulong rate);
 
        /**
-       * clk_set_periph_rate() - Set clock rate for a peripheral
-       *
-       * @dev: Device to adjust (UCLASS_CLK)
-       * @rate:        New clock rate in Hz
-       * @return new clock rate in Hz, or -ve error code
-       */
+        * enable() - Enable the clock for a peripheral
+        *
+        * @dev:        clock provider
+        * @periph:     Peripheral ID to enable
+        * @return zero on success, or -ve error code
+        */
+       int (*enable)(struct udevice *dev, int periph);
+
+       /**
+        * get_periph_rate() - Get clock rate for a peripheral
+        *
+        * @dev:        Device to check (UCLASS_CLK)
+        * @periph:     Peripheral ID to check
+        * @return clock rate in Hz, or -ve error code
+        */
        ulong (*get_periph_rate)(struct udevice *dev, int periph);
 
        /**
-        * clk_set_periph_rate() - Set current clock rate for a peripheral
+        * set_periph_rate() - Set current clock rate for a peripheral
         *
         * @dev:        Device to update (UCLASS_CLK)
-        * @periph:     Peripheral ID to cupdate
+        * @periph:     Peripheral ID to update
         * @return new clock rate in Hz, or -ve error code
         */
        ulong (*set_periph_rate)(struct udevice *dev, int periph, ulong rate);
@@ -58,7 +72,7 @@ struct clk_ops {
 ulong clk_get_rate(struct udevice *dev);
 
 /**
- * set_rate() - Set current clock rate
+ * clk_set_rate() - Set current clock rate
  *
  * @dev:       Device to adjust
  * @rate:      New clock rate in Hz
@@ -66,6 +80,15 @@ ulong clk_get_rate(struct udevice *dev);
  */
 ulong clk_set_rate(struct udevice *dev, ulong rate);
 
+/**
+ * clk_enable() - Enable the clock for a peripheral
+ *
+ * @dev:       clock provider
+ * @periph:    Peripheral ID to enable
+ * @return zero on success, or -ve error code
+ */
+int clk_enable(struct udevice *dev, int periph);
+
 /**
  * clk_get_periph_rate() - Get current clock rate for a peripheral
  *
@@ -78,9 +101,32 @@ ulong clk_get_periph_rate(struct udevice *dev, int periph);
  * clk_set_periph_rate() - Set current clock rate for a peripheral
  *
  * @dev:       Device to update (UCLASS_CLK)
- * @periph:    Peripheral ID to cupdate
+ * @periph:    Peripheral ID to update
  * @return new clock rate in Hz, or -ve error code
  */
 ulong clk_set_periph_rate(struct udevice *dev, int periph, ulong rate);
 
+#if CONFIG_IS_ENABLED(OF_CONTROL)
+/**
+ * clk_get_by_index() - look up a clock referenced by a device
+ *
+ * Parse a device's 'clocks' list, returning information on the indexed clock,
+ * ensuring that it is activated.
+ *
+ * @dev:       Device containing the clock reference
+ * @index:     Clock index to return (0 = first)
+ * @clk_devp:  Returns clock device
+ * @return:    Peripheral ID for the device to control. This is the first
+ *             argument after the clock node phandle. If there is no arguemnt,
+ *             returns 0. Return -ve error code on any error
+ */
+int clk_get_by_index(struct udevice *dev, int index, struct udevice **clk_devp);
+#else
+static inline int clk_get_by_index(struct udevice *dev, int index,
+                                  struct udevice **clk_devp)
+{
+       return -ENOSYS;
+}
+#endif
+
 #endif /* _CLK_H_ */