]>
Commit | Line | Data |
---|---|---|
11f1ceca GD |
1 | /* SPDX-License-Identifier: GPL-2.0 */ |
2 | /* | |
3 | * Copyright (c) 2018, Linaro Ltd. | |
4 | * Author: Georgi Djakov <georgi.djakov@linaro.org> | |
5 | */ | |
6 | ||
7 | #ifndef __LINUX_INTERCONNECT_PROVIDER_H | |
8 | #define __LINUX_INTERCONNECT_PROVIDER_H | |
9 | ||
10 | #include <linux/interconnect.h> | |
11 | ||
12 | #define icc_units_to_bps(bw) ((bw) * 1000ULL) | |
13 | ||
14 | struct icc_node; | |
87e3031b GD |
15 | struct of_phandle_args; |
16 | ||
17 | /** | |
18 | * struct icc_onecell_data - driver data for onecell interconnect providers | |
19 | * | |
20 | * @num_nodes: number of nodes in this device | |
21 | * @nodes: array of pointers to the nodes in this device | |
22 | */ | |
23 | struct icc_onecell_data { | |
24 | unsigned int num_nodes; | |
25 | struct icc_node *nodes[]; | |
26 | }; | |
27 | ||
28 | struct icc_node *of_icc_xlate_onecell(struct of_phandle_args *spec, | |
29 | void *data); | |
11f1ceca GD |
30 | |
31 | /** | |
32 | * struct icc_provider - interconnect provider (controller) entity that might | |
33 | * provide multiple interconnect controls | |
34 | * | |
35 | * @provider_list: list of the registered interconnect providers | |
36 | * @nodes: internal list of the interconnect provider nodes | |
37 | * @set: pointer to device specific set operation function | |
38 | * @aggregate: pointer to device specific aggregate operation function | |
87e3031b | 39 | * @xlate: provider-specific callback for mapping nodes from phandle arguments |
11f1ceca GD |
40 | * @dev: the device this interconnect provider belongs to |
41 | * @users: count of active users | |
42 | * @data: pointer to private data | |
43 | */ | |
44 | struct icc_provider { | |
45 | struct list_head provider_list; | |
46 | struct list_head nodes; | |
47 | int (*set)(struct icc_node *src, struct icc_node *dst); | |
48 | int (*aggregate)(struct icc_node *node, u32 avg_bw, u32 peak_bw, | |
49 | u32 *agg_avg, u32 *agg_peak); | |
87e3031b | 50 | struct icc_node* (*xlate)(struct of_phandle_args *spec, void *data); |
11f1ceca GD |
51 | struct device *dev; |
52 | int users; | |
53 | void *data; | |
54 | }; | |
55 | ||
56 | /** | |
57 | * struct icc_node - entity that is part of the interconnect topology | |
58 | * | |
59 | * @id: platform specific node id | |
60 | * @name: node name used in debugfs | |
61 | * @links: a list of targets pointing to where we can go next when traversing | |
62 | * @num_links: number of links to other interconnect nodes | |
63 | * @provider: points to the interconnect provider of this node | |
64 | * @node_list: the list entry in the parent provider's "nodes" list | |
65 | * @search_list: list used when walking the nodes graph | |
66 | * @reverse: pointer to previous node when walking the nodes graph | |
67 | * @is_traversed: flag that is used when walking the nodes graph | |
68 | * @req_list: a list of QoS constraint requests associated with this node | |
69 | * @avg_bw: aggregated value of average bandwidth requests from all consumers | |
70 | * @peak_bw: aggregated value of peak bandwidth requests from all consumers | |
71 | * @data: pointer to private data | |
72 | */ | |
73 | struct icc_node { | |
74 | int id; | |
75 | const char *name; | |
76 | struct icc_node **links; | |
77 | size_t num_links; | |
78 | ||
79 | struct icc_provider *provider; | |
80 | struct list_head node_list; | |
81 | struct list_head search_list; | |
82 | struct icc_node *reverse; | |
83 | u8 is_traversed:1; | |
84 | struct hlist_head req_list; | |
85 | u32 avg_bw; | |
86 | u32 peak_bw; | |
87 | void *data; | |
88 | }; | |
89 | ||
90 | #if IS_ENABLED(CONFIG_INTERCONNECT) | |
91 | ||
92 | struct icc_node *icc_node_create(int id); | |
93 | void icc_node_destroy(int id); | |
94 | int icc_link_create(struct icc_node *node, const int dst_id); | |
95 | int icc_link_destroy(struct icc_node *src, struct icc_node *dst); | |
96 | void icc_node_add(struct icc_node *node, struct icc_provider *provider); | |
97 | void icc_node_del(struct icc_node *node); | |
98 | int icc_provider_add(struct icc_provider *provider); | |
99 | int icc_provider_del(struct icc_provider *provider); | |
100 | ||
101 | #else | |
102 | ||
103 | static inline struct icc_node *icc_node_create(int id) | |
104 | { | |
105 | return ERR_PTR(-ENOTSUPP); | |
106 | } | |
107 | ||
108 | void icc_node_destroy(int id) | |
109 | { | |
110 | } | |
111 | ||
112 | static inline int icc_link_create(struct icc_node *node, const int dst_id) | |
113 | { | |
114 | return -ENOTSUPP; | |
115 | } | |
116 | ||
117 | int icc_link_destroy(struct icc_node *src, struct icc_node *dst) | |
118 | { | |
119 | return -ENOTSUPP; | |
120 | } | |
121 | ||
122 | void icc_node_add(struct icc_node *node, struct icc_provider *provider) | |
123 | { | |
124 | } | |
125 | ||
126 | void icc_node_del(struct icc_node *node) | |
127 | { | |
128 | } | |
129 | ||
130 | static inline int icc_provider_add(struct icc_provider *provider) | |
131 | { | |
132 | return -ENOTSUPP; | |
133 | } | |
134 | ||
135 | static inline int icc_provider_del(struct icc_provider *provider) | |
136 | { | |
137 | return -ENOTSUPP; | |
138 | } | |
139 | ||
140 | #endif /* CONFIG_INTERCONNECT */ | |
141 | ||
142 | #endif /* __LINUX_INTERCONNECT_PROVIDER_H */ |