1 // SPDX-License-Identifier: GPL-2.0-only 2 /* 3 * Generic OPP debugfs interface 4 * 5 * Copyright (C) 2015-2016 Viresh Kumar <viresh.kumar@linaro.org> 6 */ 7 8 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt 9 10 #include <linux/debugfs.h> 11 #include <linux/device.h> 12 #include <linux/err.h> 13 #include <linux/of.h> 14 #include <linux/init.h> 15 #include <linux/limits.h> 16 #include <linux/slab.h> 17 18 #include "opp.h" 19 20 static struct dentry *rootdir; 21 22 static void opp_set_dev_name(const struct device *dev, char *name) 23 { 24 if (dev->parent) 25 snprintf(name, NAME_MAX, "%s-%s", dev_name(dev->parent), 26 dev_name(dev)); 27 else 28 snprintf(name, NAME_MAX, "%s", dev_name(dev)); 29 } 30 31 void opp_debug_remove_one(struct dev_pm_opp *opp) 32 { 33 debugfs_remove_recursive(opp->dentry); 34 } 35 36 static ssize_t bw_name_read(struct file *fp, char __user *userbuf, 37 size_t count, loff_t *ppos) 38 { 39 struct icc_path *path = fp->private_data; 40 const char *name = icc_get_name(path); 41 char buf[64]; 42 int i = 0; 43 44 if (name) 45 i = scnprintf(buf, sizeof(buf), "%.62s\n", name); 46 47 return simple_read_from_buffer(userbuf, count, ppos, buf, i); 48 } 49 50 static const struct file_operations bw_name_fops = { 51 .open = simple_open, 52 .read = bw_name_read, 53 .llseek = default_llseek, 54 }; 55 56 static void opp_debug_create_bw(struct dev_pm_opp *opp, 57 struct opp_table *opp_table, 58 struct dentry *pdentry) 59 { 60 struct dentry *d; 61 char name[] = "icc-path-XXXXXXXXXXX"; /* Integers can take 11 chars max */ 62 int i; 63 64 for (i = 0; i < opp_table->path_count; i++) { 65 snprintf(name, sizeof(name), "icc-path-%d", i); 66 67 /* Create per-path directory */ 68 d = debugfs_create_dir(name, pdentry); 69 70 debugfs_create_file("name", S_IRUGO, d, opp_table->paths[i], 71 &bw_name_fops); 72 debugfs_create_u32("peak_bw", S_IRUGO, d, 73 &opp->bandwidth[i].peak); 74 debugfs_create_u32("avg_bw", S_IRUGO, d, 75 &opp->bandwidth[i].avg); 76 } 77 } 78 79 static void opp_debug_create_clks(struct dev_pm_opp *opp, 80 struct opp_table *opp_table, 81 struct dentry *pdentry) 82 { 83 char name[] = "rate_hz_XXXXXXXXXXX"; /* Integers can take 11 chars max */ 84 int i; 85 86 if (opp_table->clk_count == 1) { 87 debugfs_create_ulong("rate_hz", S_IRUGO, pdentry, &opp->rates[0]); 88 return; 89 } 90 91 for (i = 0; i < opp_table->clk_count; i++) { 92 snprintf(name, sizeof(name), "rate_hz_%d", i); 93 debugfs_create_ulong(name, S_IRUGO, pdentry, &opp->rates[i]); 94 } 95 } 96 97 static void opp_debug_create_supplies(struct dev_pm_opp *opp, 98 struct opp_table *opp_table, 99 struct dentry *pdentry) 100 { 101 struct dentry *d; 102 int i; 103 104 for (i = 0; i < opp_table->regulator_count; i++) { 105 char name[] = "supply-XXXXXXXXXXX"; /* Integers can take 11 chars max */ 106 107 snprintf(name, sizeof(name), "supply-%d", i); 108 109 /* Create per-opp directory */ 110 d = debugfs_create_dir(name, pdentry); 111 112 debugfs_create_ulong("u_volt_target", S_IRUGO, d, 113 &opp->supplies[i].u_volt); 114 115 debugfs_create_ulong("u_volt_min", S_IRUGO, d, 116 &opp->supplies[i].u_volt_min); 117 118 debugfs_create_ulong("u_volt_max", S_IRUGO, d, 119 &opp->supplies[i].u_volt_max); 120 121 debugfs_create_ulong("u_amp", S_IRUGO, d, 122 &opp->supplies[i].u_amp); 123 124 debugfs_create_ulong("u_watt", S_IRUGO, d, 125 &opp->supplies[i].u_watt); 126 } 127 } 128 129 void opp_debug_create_one(struct dev_pm_opp *opp, struct opp_table *opp_table) 130 { 131 struct dentry *pdentry = opp_table->dentry; 132 struct dentry *d; 133 char name[36]; /* "opp:"(4) + u64(20) + "-" (1) + u32(10) + NULL(1) */ 134 135 /* 136 * Get directory name for OPP. 137 * 138 * - Normally rate is unique to each OPP, use it to get unique opp-name, 139 * together with performance level if available. 140 * - For some devices rate isn't available or there are multiple, use 141 * index instead for them. 142 */ 143 if (likely(opp_table->clk_count == 1 && opp->rates[0])) { 144 if (opp->level == OPP_LEVEL_UNSET) 145 snprintf(name, sizeof(name), "opp:%lu", opp->rates[0]); 146 else 147 snprintf(name, sizeof(name), "opp:%lu-%u", opp->rates[0], opp->level); 148 } else { 149 snprintf(name, sizeof(name), "opp:%u", _get_opp_count(opp_table)); 150 } 151 152 /* Create per-opp directory */ 153 d = debugfs_create_dir(name, pdentry); 154 155 debugfs_create_bool("available", S_IRUGO, d, &opp->available); 156 debugfs_create_bool("dynamic", S_IRUGO, d, &opp->dynamic); 157 debugfs_create_bool("turbo", S_IRUGO, d, &opp->turbo); 158 debugfs_create_bool("suspend", S_IRUGO, d, &opp->suspend); 159 debugfs_create_u32("level", S_IRUGO, d, &opp->level); 160 debugfs_create_ulong("clock_latency_ns", S_IRUGO, d, 161 &opp->clock_latency_ns); 162 163 opp->of_name = of_node_full_name(opp->np); 164 debugfs_create_str("of_name", S_IRUGO, d, (char **)&opp->of_name); 165 166 opp_debug_create_clks(opp, opp_table, d); 167 opp_debug_create_supplies(opp, opp_table, d); 168 opp_debug_create_bw(opp, opp_table, d); 169 170 opp->dentry = d; 171 } 172 173 static void opp_list_debug_create_dir(struct opp_device *opp_dev, 174 struct opp_table *opp_table) 175 { 176 const struct device *dev = opp_dev->dev; 177 struct dentry *d; 178 179 opp_set_dev_name(dev, opp_table->dentry_name); 180 181 /* Create device specific directory */ 182 d = debugfs_create_dir(opp_table->dentry_name, rootdir); 183 184 opp_dev->dentry = d; 185 opp_table->dentry = d; 186 } 187 188 static void opp_list_debug_create_link(struct opp_device *opp_dev, 189 struct opp_table *opp_table) 190 { 191 char name[NAME_MAX]; 192 193 opp_set_dev_name(opp_dev->dev, name); 194 195 /* Create device specific directory link */ 196 opp_dev->dentry = debugfs_create_symlink(name, rootdir, 197 opp_table->dentry_name); 198 } 199 200 /** 201 * opp_debug_register - add a device opp node to the debugfs 'opp' directory 202 * @opp_dev: opp-dev pointer for device 203 * @opp_table: the device-opp being added 204 * 205 * Dynamically adds device specific directory in debugfs 'opp' directory. If the 206 * device-opp is shared with other devices, then links will be created for all 207 * devices except the first. 208 */ 209 void opp_debug_register(struct opp_device *opp_dev, struct opp_table *opp_table) 210 { 211 if (opp_table->dentry) 212 opp_list_debug_create_link(opp_dev, opp_table); 213 else 214 opp_list_debug_create_dir(opp_dev, opp_table); 215 } 216 217 static void opp_migrate_dentry(struct opp_device *opp_dev, 218 struct opp_table *opp_table) 219 { 220 struct opp_device *new_dev = NULL, *iter; 221 const struct device *dev; 222 int err; 223 224 /* Look for next opp-dev */ 225 list_for_each_entry(iter, &opp_table->dev_list, node) 226 if (iter != opp_dev) { 227 new_dev = iter; 228 break; 229 } 230 231 BUG_ON(!new_dev); 232 233 /* new_dev is guaranteed to be valid here */ 234 dev = new_dev->dev; 235 debugfs_remove_recursive(new_dev->dentry); 236 237 opp_set_dev_name(dev, opp_table->dentry_name); 238 239 err = debugfs_change_name(opp_dev->dentry, "%s", opp_table->dentry_name); 240 if (err) { 241 dev_err(dev, "%s: Failed to rename link from: %s to %s\n", 242 __func__, dev_name(opp_dev->dev), dev_name(dev)); 243 return; 244 } 245 246 new_dev->dentry = opp_table->dentry = opp_dev->dentry; 247 } 248 249 /** 250 * opp_debug_unregister - remove a device opp node from debugfs opp directory 251 * @opp_dev: opp-dev pointer for device 252 * @opp_table: the device-opp being removed 253 * 254 * Dynamically removes device specific directory from debugfs 'opp' directory. 255 */ 256 void opp_debug_unregister(struct opp_device *opp_dev, 257 struct opp_table *opp_table) 258 { 259 if (opp_dev->dentry == opp_table->dentry) { 260 /* Move the real dentry object under another device */ 261 if (!list_is_singular(&opp_table->dev_list)) { 262 opp_migrate_dentry(opp_dev, opp_table); 263 goto out; 264 } 265 opp_table->dentry = NULL; 266 } 267 268 debugfs_remove_recursive(opp_dev->dentry); 269 270 out: 271 opp_dev->dentry = NULL; 272 } 273 274 static int __init opp_debug_init(void) 275 { 276 /* Create /sys/kernel/debug/opp directory */ 277 rootdir = debugfs_create_dir("opp", NULL); 278 279 return 0; 280 } 281 core_initcall(opp_debug_init); 282