include/linux/interconnect.h

   1 /* SPDX-License-Identifier: GPL-2.0 */
   2 /*
   3  * Copyright (c) 2018-2019, Linaro Ltd.
   4  * Author: Georgi Djakov <georgi.djakov@linaro.org>
   5  */
   6
   7 #ifndef __LINUX_INTERCONNECT_H
   8 #define __LINUX_INTERCONNECT_H
   9
  10 #include <linux/mutex.h>
  11 #include <linux/types.h>
  12
  13 /* macros for converting to icc units */
  14 #define Bps_to_icc(x)   ((x) / 1000)
  15 #define kBps_to_icc(x)  (x)
  16 #define MBps_to_icc(x)  ((x) * 1000)
  17 #define GBps_to_icc(x)  ((x) * 1000 * 1000)
  18 #define bps_to_icc(x)   (1)
  19 #define kbps_to_icc(x)  ((x) / 8 + ((x) % 8 ? 1 : 0))
  20 #define Mbps_to_icc(x)  ((x) * 1000 / 8)
  21 #define Gbps_to_icc(x)  ((x) * 1000 * 1000 / 8)
  22
  23 struct icc_path;
  24 struct device;
  25
  26 /**
  27  * struct icc_bulk_data - Data used for bulk icc operations.
  28  *
  29  * @path: reference to the interconnect path (internal use)
  30  * @name: the name from the "interconnect-names" DT property
  31  * @avg_bw: average bandwidth in icc units
  32  * @peak_bw: peak bandwidth in icc units
  33  */
  34 struct icc_bulk_data {
  35         struct icc_path *path;
  36         const char *name;
  37         u32 avg_bw;
  38         u32 peak_bw;
  39 };
  40
  41 #if IS_ENABLED(CONFIG_INTERCONNECT)
  42
  43 struct icc_path *icc_get(struct device *dev, const int src_id,
  44                          const int dst_id);
  45 struct icc_path *of_icc_get(struct device *dev, const char *name);
  46 struct icc_path *devm_of_icc_get(struct device *dev, const char *name);
  47 struct icc_path *of_icc_get_by_index(struct device *dev, int idx);
  48 void icc_put(struct icc_path *path);
  49 int icc_enable(struct icc_path *path);
  50 int icc_disable(struct icc_path *path);
  51 int icc_set_bw(struct icc_path *path, u32 avg_bw, u32 peak_bw);
  52 void icc_set_tag(struct icc_path *path, u32 tag);
  53 const char *icc_get_name(struct icc_path *path);
  54 int __must_check of_icc_bulk_get(struct device *dev, int num_paths,
  55                                  struct icc_bulk_data *paths);
  56 void icc_bulk_put(int num_paths, struct icc_bulk_data *paths);
  57 int icc_bulk_set_bw(int num_paths, const struct icc_bulk_data *paths);
  58 int icc_bulk_enable(int num_paths, const struct icc_bulk_data *paths);
  59 void icc_bulk_disable(int num_paths, const struct icc_bulk_data *paths);
  60
  61 #else
  62
  63 static inline struct icc_path *icc_get(struct device *dev, const int src_id,
  64                                        const int dst_id)
  65 {
  66         return NULL;
  67 }
  68
  69 static inline struct icc_path *of_icc_get(struct device *dev,
  70                                           const char *name)
  71 {
  72         return NULL;
  73 }
  74
  75 static inline struct icc_path *devm_of_icc_get(struct device *dev,
  76                                                 const char *name)
  77 {
  78         return NULL;
  79 }
  80
  81 static inline struct icc_path *of_icc_get_by_index(struct device *dev, int idx)
  82 {
  83         return NULL;
  84 }
  85
  86 static inline void icc_put(struct icc_path *path)
  87 {
  88 }
  89
  90 static inline int icc_enable(struct icc_path *path)
  91 {
  92         return 0;
  93 }
  94
  95 static inline int icc_disable(struct icc_path *path)
  96 {
  97         return 0;
  98 }
  99
 100 static inline int icc_set_bw(struct icc_path *path, u32 avg_bw, u32 peak_bw)
 101 {
 102         return 0;
 103 }
 104
 105 static inline void icc_set_tag(struct icc_path *path, u32 tag)
 106 {
 107 }
 108
 109 static inline const char *icc_get_name(struct icc_path *path)
 110 {
 111         return NULL;
 112 }
 113
 114 static inline int of_icc_bulk_get(struct device *dev, int num_paths, struct icc_bulk_data *paths)
 115 {
 116         return 0;
 117 }
 118
 119 static inline void icc_bulk_put(int num_paths, struct icc_bulk_data *paths)
 120 {
 121 }
 122
 123 static inline int icc_bulk_set_bw(int num_paths, const struct icc_bulk_data *paths)
 124 {
 125         return 0;
 126 }
 127
 128 static inline int icc_bulk_enable(int num_paths, const struct icc_bulk_data *paths)
 129 {
 130         return 0;
 131 }
 132
 133 static inline void icc_bulk_disable(int num_paths, const struct icc_bulk_data *paths)
 134 {
 135 }
 136
 137 #endif /* CONFIG_INTERCONNECT */
 138
 139 #endif /* __LINUX_INTERCONNECT_H */