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
23struct icc_path;
24struct 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 */
34struct 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
43struct icc_path *of_icc_get(struct device *dev, const char *name);
44struct icc_path *devm_of_icc_get(struct device *dev, const char *name);
45int devm_of_icc_bulk_get(struct device *dev, int num_paths, struct icc_bulk_data *paths);
46struct icc_path *of_icc_get_by_index(struct device *dev, int idx);
47void icc_put(struct icc_path *path);
48int icc_enable(struct icc_path *path);
49int icc_disable(struct icc_path *path);
50int icc_set_bw(struct icc_path *path, u32 avg_bw, u32 peak_bw);
51void icc_set_tag(struct icc_path *path, u32 tag);
52const char *icc_get_name(struct icc_path *path);
53int __must_check of_icc_bulk_get(struct device *dev, int num_paths,
54				 struct icc_bulk_data *paths);
55void icc_bulk_put(int num_paths, struct icc_bulk_data *paths);
56int icc_bulk_set_bw(int num_paths, const struct icc_bulk_data *paths);
57int icc_bulk_enable(int num_paths, const struct icc_bulk_data *paths);
58void icc_bulk_disable(int num_paths, const struct icc_bulk_data *paths);
59
60#else
61
62static inline struct icc_path *of_icc_get(struct device *dev,
63					  const char *name)
64{
65	return NULL;
66}
67
68static inline struct icc_path *devm_of_icc_get(struct device *dev,
69						const char *name)
70{
71	return NULL;
72}
73
74static inline struct icc_path *of_icc_get_by_index(struct device *dev, int idx)
75{
76	return NULL;
77}
78
79static inline void icc_put(struct icc_path *path)
80{
81}
82
83static inline int icc_enable(struct icc_path *path)
84{
85	return 0;
86}
87
88static inline int icc_disable(struct icc_path *path)
89{
90	return 0;
91}
92
93static inline int icc_set_bw(struct icc_path *path, u32 avg_bw, u32 peak_bw)
94{
95	return 0;
96}
97
98static inline void icc_set_tag(struct icc_path *path, u32 tag)
99{
100}
101
102static inline const char *icc_get_name(struct icc_path *path)
103{
104	return NULL;
105}
106
107static inline int of_icc_bulk_get(struct device *dev, int num_paths, struct icc_bulk_data *paths)
108{
109	return 0;
110}
111
112static inline int devm_of_icc_bulk_get(struct device *dev, int num_paths,
113				       struct icc_bulk_data *paths)
114{
115	return 0;
116}
117
118static inline void icc_bulk_put(int num_paths, struct icc_bulk_data *paths)
119{
120}
121
122static inline int icc_bulk_set_bw(int num_paths, const struct icc_bulk_data *paths)
123{
124	return 0;
125}
126
127static inline int icc_bulk_enable(int num_paths, const struct icc_bulk_data *paths)
128{
129	return 0;
130}
131
132static inline void icc_bulk_disable(int num_paths, const struct icc_bulk_data *paths)
133{
134}
135
136#endif /* CONFIG_INTERCONNECT */
137
138#endif /* __LINUX_INTERCONNECT_H */
139