Rajendra Nayak | 8f446e6 | 2011-11-18 16:47:17 +0530 | [diff] [blame] | 1 | /* |
| 2 | * OF helpers for regulator framework |
| 3 | * |
| 4 | * Copyright (C) 2011 Texas Instruments, Inc. |
| 5 | * Rajendra Nayak <rnayak@ti.com> |
| 6 | * |
| 7 | * This program is free software; you can redistribute it and/or modify |
| 8 | * it under the terms of the GNU General Public License as published by |
| 9 | * the Free Software Foundation; either version 2 of the License, or |
| 10 | * (at your option) any later version. |
| 11 | */ |
| 12 | |
Axel Lin | e69af5e | 2011-11-26 18:50:58 +0800 | [diff] [blame] | 13 | #include <linux/module.h> |
Rajendra Nayak | 8f446e6 | 2011-11-18 16:47:17 +0530 | [diff] [blame] | 14 | #include <linux/slab.h> |
| 15 | #include <linux/of.h> |
| 16 | #include <linux/regulator/machine.h> |
Mark Brown | a0c7b16 | 2014-09-09 23:13:57 +0100 | [diff] [blame] | 17 | #include <linux/regulator/driver.h> |
Thierry Reding | 1c8fa58 | 2012-04-26 16:52:20 +0200 | [diff] [blame] | 18 | #include <linux/regulator/of_regulator.h> |
Rajendra Nayak | 8f446e6 | 2011-11-18 16:47:17 +0530 | [diff] [blame] | 19 | |
Mark Brown | a0c7b16 | 2014-09-09 23:13:57 +0100 | [diff] [blame] | 20 | #include "internal.h" |
| 21 | |
Krzysztof Kozlowski | f32fa89 | 2014-10-31 17:04:14 +0100 | [diff] [blame] | 22 | static const char *const regulator_states[PM_SUSPEND_MAX + 1] = { |
Chanwoo Choi | 40e20d6 | 2014-10-10 20:35:33 +0900 | [diff] [blame] | 23 | [PM_SUSPEND_MEM] = "regulator-state-mem", |
| 24 | [PM_SUSPEND_MAX] = "regulator-state-disk", |
| 25 | }; |
| 26 | |
Rajendra Nayak | 8f446e6 | 2011-11-18 16:47:17 +0530 | [diff] [blame] | 27 | static void of_get_regulation_constraints(struct device_node *np, |
Javier Martinez Canillas | 5e5e3a4 | 2014-11-10 14:43:55 +0100 | [diff] [blame] | 28 | struct regulator_init_data **init_data, |
| 29 | const struct regulator_desc *desc) |
Rajendra Nayak | 8f446e6 | 2011-11-18 16:47:17 +0530 | [diff] [blame] | 30 | { |
Sergei Shtylyov | 1e050ea | 2014-05-27 00:27:19 +0400 | [diff] [blame] | 31 | const __be32 *min_uV, *max_uV; |
Rajendra Nayak | 8f446e6 | 2011-11-18 16:47:17 +0530 | [diff] [blame] | 32 | struct regulation_constraints *constraints = &(*init_data)->constraints; |
Chanwoo Choi | 40e20d6 | 2014-10-10 20:35:33 +0900 | [diff] [blame] | 33 | struct regulator_state *suspend_state; |
| 34 | struct device_node *suspend_np; |
| 35 | int ret, i; |
Laxman Dewangan | 00c877c | 2013-09-18 18:18:02 +0530 | [diff] [blame] | 36 | u32 pval; |
Rajendra Nayak | 8f446e6 | 2011-11-18 16:47:17 +0530 | [diff] [blame] | 37 | |
| 38 | constraints->name = of_get_property(np, "regulator-name", NULL); |
| 39 | |
| 40 | min_uV = of_get_property(np, "regulator-min-microvolt", NULL); |
| 41 | if (min_uV) |
| 42 | constraints->min_uV = be32_to_cpu(*min_uV); |
| 43 | max_uV = of_get_property(np, "regulator-max-microvolt", NULL); |
| 44 | if (max_uV) |
| 45 | constraints->max_uV = be32_to_cpu(*max_uV); |
| 46 | |
| 47 | /* Voltage change possible? */ |
| 48 | if (constraints->min_uV != constraints->max_uV) |
| 49 | constraints->valid_ops_mask |= REGULATOR_CHANGE_VOLTAGE; |
Mark Brown | ab62aa9 | 2011-12-05 10:58:41 +0000 | [diff] [blame] | 50 | /* Only one voltage? Then make sure it's set. */ |
Karol Lewandowski | 8a09304 | 2012-01-25 10:31:45 +0100 | [diff] [blame] | 51 | if (min_uV && max_uV && constraints->min_uV == constraints->max_uV) |
Mark Brown | ab62aa9 | 2011-12-05 10:58:41 +0000 | [diff] [blame] | 52 | constraints->apply_uV = true; |
Rajendra Nayak | 8f446e6 | 2011-11-18 16:47:17 +0530 | [diff] [blame] | 53 | |
Sergei Shtylyov | 1e050ea | 2014-05-27 00:27:19 +0400 | [diff] [blame] | 54 | if (!of_property_read_u32(np, "regulator-microvolt-offset", &pval)) |
| 55 | constraints->uV_offset = pval; |
| 56 | if (!of_property_read_u32(np, "regulator-min-microamp", &pval)) |
| 57 | constraints->min_uA = pval; |
| 58 | if (!of_property_read_u32(np, "regulator-max-microamp", &pval)) |
| 59 | constraints->max_uA = pval; |
Rajendra Nayak | 8f446e6 | 2011-11-18 16:47:17 +0530 | [diff] [blame] | 60 | |
Stephen Boyd | 36e4f83 | 2015-06-11 17:37:06 -0700 | [diff] [blame^] | 61 | if (!of_property_read_u32(np, "regulator-input-current-limit-microamp", |
| 62 | &pval)) |
| 63 | constraints->ilim_uA = pval; |
| 64 | |
Rajendra Nayak | 8f446e6 | 2011-11-18 16:47:17 +0530 | [diff] [blame] | 65 | /* Current change possible? */ |
| 66 | if (constraints->min_uA != constraints->max_uA) |
| 67 | constraints->valid_ops_mask |= REGULATOR_CHANGE_CURRENT; |
| 68 | |
Sergei Shtylyov | 1e050ea | 2014-05-27 00:27:19 +0400 | [diff] [blame] | 69 | constraints->boot_on = of_property_read_bool(np, "regulator-boot-on"); |
| 70 | constraints->always_on = of_property_read_bool(np, "regulator-always-on"); |
| 71 | if (!constraints->always_on) /* status change should be possible. */ |
Rajendra Nayak | 8f446e6 | 2011-11-18 16:47:17 +0530 | [diff] [blame] | 72 | constraints->valid_ops_mask |= REGULATOR_CHANGE_STATUS; |
Yadwinder Singh Brar | 6f0b2c6 | 2012-06-11 17:41:08 +0530 | [diff] [blame] | 73 | |
Stephen Boyd | 23c779b | 2015-06-11 17:37:04 -0700 | [diff] [blame] | 74 | constraints->pull_down = of_property_read_bool(np, "regulator-pull-down"); |
| 75 | |
Kishon Vijay Abraham I | 93134c7 | 2013-06-20 14:07:37 +0530 | [diff] [blame] | 76 | if (of_property_read_bool(np, "regulator-allow-bypass")) |
| 77 | constraints->valid_ops_mask |= REGULATOR_CHANGE_BYPASS; |
| 78 | |
Sergei Shtylyov | 1e050ea | 2014-05-27 00:27:19 +0400 | [diff] [blame] | 79 | ret = of_property_read_u32(np, "regulator-ramp-delay", &pval); |
| 80 | if (!ret) { |
| 81 | if (pval) |
| 82 | constraints->ramp_delay = pval; |
Yadwinder Singh Brar | 1653ccf | 2013-06-29 18:21:15 +0530 | [diff] [blame] | 83 | else |
| 84 | constraints->ramp_disable = true; |
| 85 | } |
Laxman Dewangan | 00c877c | 2013-09-18 18:18:02 +0530 | [diff] [blame] | 86 | |
| 87 | ret = of_property_read_u32(np, "regulator-enable-ramp-delay", &pval); |
| 88 | if (!ret) |
| 89 | constraints->enable_time = pval; |
Chanwoo Choi | 40e20d6 | 2014-10-10 20:35:33 +0900 | [diff] [blame] | 90 | |
Stephen Boyd | 57f66b7 | 2015-06-11 17:37:05 -0700 | [diff] [blame] | 91 | constraints->soft_start = of_property_read_bool(np, |
| 92 | "regulator-soft-start"); |
| 93 | |
Javier Martinez Canillas | 5e5e3a4 | 2014-11-10 14:43:55 +0100 | [diff] [blame] | 94 | if (!of_property_read_u32(np, "regulator-initial-mode", &pval)) { |
| 95 | if (desc && desc->of_map_mode) { |
| 96 | ret = desc->of_map_mode(pval); |
| 97 | if (ret == -EINVAL) |
| 98 | pr_err("%s: invalid mode %u\n", np->name, pval); |
| 99 | else |
| 100 | constraints->initial_mode = ret; |
| 101 | } else { |
| 102 | pr_warn("%s: mapping for mode %d not defined\n", |
| 103 | np->name, pval); |
| 104 | } |
| 105 | } |
| 106 | |
Stephen Boyd | 22a10bc | 2015-06-11 17:37:03 -0700 | [diff] [blame] | 107 | if (!of_property_read_u32(np, "regulator-system-load", &pval)) |
| 108 | constraints->system_load = pval; |
| 109 | |
Chanwoo Choi | 40e20d6 | 2014-10-10 20:35:33 +0900 | [diff] [blame] | 110 | for (i = 0; i < ARRAY_SIZE(regulator_states); i++) { |
| 111 | switch (i) { |
| 112 | case PM_SUSPEND_MEM: |
| 113 | suspend_state = &constraints->state_mem; |
| 114 | break; |
| 115 | case PM_SUSPEND_MAX: |
| 116 | suspend_state = &constraints->state_disk; |
| 117 | break; |
| 118 | case PM_SUSPEND_ON: |
| 119 | case PM_SUSPEND_FREEZE: |
| 120 | case PM_SUSPEND_STANDBY: |
| 121 | default: |
| 122 | continue; |
| 123 | }; |
| 124 | |
| 125 | suspend_np = of_get_child_by_name(np, regulator_states[i]); |
| 126 | if (!suspend_np || !suspend_state) |
| 127 | continue; |
| 128 | |
Javier Martinez Canillas | 5e5e3a4 | 2014-11-10 14:43:55 +0100 | [diff] [blame] | 129 | if (!of_property_read_u32(suspend_np, "regulator-mode", |
| 130 | &pval)) { |
| 131 | if (desc && desc->of_map_mode) { |
| 132 | ret = desc->of_map_mode(pval); |
| 133 | if (ret == -EINVAL) |
| 134 | pr_err("%s: invalid mode %u\n", |
| 135 | np->name, pval); |
| 136 | else |
| 137 | suspend_state->mode = ret; |
| 138 | } else { |
| 139 | pr_warn("%s: mapping for mode %d not defined\n", |
| 140 | np->name, pval); |
| 141 | } |
| 142 | } |
| 143 | |
Chanwoo Choi | 40e20d6 | 2014-10-10 20:35:33 +0900 | [diff] [blame] | 144 | if (of_property_read_bool(suspend_np, |
| 145 | "regulator-on-in-suspend")) |
| 146 | suspend_state->enabled = true; |
| 147 | else if (of_property_read_bool(suspend_np, |
| 148 | "regulator-off-in-suspend")) |
| 149 | suspend_state->disabled = true; |
| 150 | |
Doug Anderson | 8cbcaea | 2014-10-31 20:52:58 -0700 | [diff] [blame] | 151 | if (!of_property_read_u32(suspend_np, |
| 152 | "regulator-suspend-microvolt", &pval)) |
| 153 | suspend_state->uV = pval; |
| 154 | |
Javier Martinez Canillas | 4eafec8 | 2014-10-20 16:47:48 +0200 | [diff] [blame] | 155 | of_node_put(suspend_np); |
Chanwoo Choi | 40e20d6 | 2014-10-10 20:35:33 +0900 | [diff] [blame] | 156 | suspend_state = NULL; |
| 157 | suspend_np = NULL; |
| 158 | } |
Rajendra Nayak | 8f446e6 | 2011-11-18 16:47:17 +0530 | [diff] [blame] | 159 | } |
| 160 | |
| 161 | /** |
| 162 | * of_get_regulator_init_data - extract regulator_init_data structure info |
| 163 | * @dev: device requesting for regulator_init_data |
Javier Martinez Canillas | 072e78b | 2014-11-10 14:43:53 +0100 | [diff] [blame] | 164 | * @node: regulator device node |
| 165 | * @desc: regulator description |
Rajendra Nayak | 8f446e6 | 2011-11-18 16:47:17 +0530 | [diff] [blame] | 166 | * |
| 167 | * Populates regulator_init_data structure by extracting data from device |
| 168 | * tree node, returns a pointer to the populated struture or NULL if memory |
| 169 | * alloc fails. |
| 170 | */ |
Shawn Guo | d9a861c | 2011-12-01 17:21:06 +0800 | [diff] [blame] | 171 | struct regulator_init_data *of_get_regulator_init_data(struct device *dev, |
Javier Martinez Canillas | 072e78b | 2014-11-10 14:43:53 +0100 | [diff] [blame] | 172 | struct device_node *node, |
| 173 | const struct regulator_desc *desc) |
Rajendra Nayak | 8f446e6 | 2011-11-18 16:47:17 +0530 | [diff] [blame] | 174 | { |
| 175 | struct regulator_init_data *init_data; |
| 176 | |
Shawn Guo | d9a861c | 2011-12-01 17:21:06 +0800 | [diff] [blame] | 177 | if (!node) |
Rajendra Nayak | 8f446e6 | 2011-11-18 16:47:17 +0530 | [diff] [blame] | 178 | return NULL; |
| 179 | |
| 180 | init_data = devm_kzalloc(dev, sizeof(*init_data), GFP_KERNEL); |
| 181 | if (!init_data) |
| 182 | return NULL; /* Out of memory? */ |
| 183 | |
Javier Martinez Canillas | 5e5e3a4 | 2014-11-10 14:43:55 +0100 | [diff] [blame] | 184 | of_get_regulation_constraints(node, &init_data, desc); |
Rajendra Nayak | 8f446e6 | 2011-11-18 16:47:17 +0530 | [diff] [blame] | 185 | return init_data; |
| 186 | } |
Axel Lin | e69af5e | 2011-11-26 18:50:58 +0800 | [diff] [blame] | 187 | EXPORT_SYMBOL_GPL(of_get_regulator_init_data); |
Thierry Reding | 1c8fa58 | 2012-04-26 16:52:20 +0200 | [diff] [blame] | 188 | |
Charles Keepax | 13b3fde | 2014-04-15 13:34:36 +0100 | [diff] [blame] | 189 | struct devm_of_regulator_matches { |
| 190 | struct of_regulator_match *matches; |
| 191 | unsigned int num_matches; |
| 192 | }; |
| 193 | |
| 194 | static void devm_of_regulator_put_matches(struct device *dev, void *res) |
| 195 | { |
| 196 | struct devm_of_regulator_matches *devm_matches = res; |
| 197 | int i; |
| 198 | |
| 199 | for (i = 0; i < devm_matches->num_matches; i++) |
| 200 | of_node_put(devm_matches->matches[i].of_node); |
| 201 | } |
| 202 | |
Thierry Reding | 1c8fa58 | 2012-04-26 16:52:20 +0200 | [diff] [blame] | 203 | /** |
Stephen Warren | 13511de | 2012-09-24 13:25:00 -0600 | [diff] [blame] | 204 | * of_regulator_match - extract multiple regulator init data from device tree. |
Thierry Reding | 1c8fa58 | 2012-04-26 16:52:20 +0200 | [diff] [blame] | 205 | * @dev: device requesting the data |
| 206 | * @node: parent device node of the regulators |
| 207 | * @matches: match table for the regulators |
| 208 | * @num_matches: number of entries in match table |
| 209 | * |
Stephen Warren | 13511de | 2012-09-24 13:25:00 -0600 | [diff] [blame] | 210 | * This function uses a match table specified by the regulator driver to |
| 211 | * parse regulator init data from the device tree. @node is expected to |
| 212 | * contain a set of child nodes, each providing the init data for one |
| 213 | * regulator. The data parsed from a child node will be matched to a regulator |
| 214 | * based on either the deprecated property regulator-compatible if present, |
| 215 | * or otherwise the child node's name. Note that the match table is modified |
Charles Keepax | bd0dda74 | 2014-04-03 15:32:15 +0100 | [diff] [blame] | 216 | * in place and an additional of_node reference is taken for each matched |
| 217 | * regulator. |
Thierry Reding | 1c8fa58 | 2012-04-26 16:52:20 +0200 | [diff] [blame] | 218 | * |
| 219 | * Returns the number of matches found or a negative error code on failure. |
| 220 | */ |
| 221 | int of_regulator_match(struct device *dev, struct device_node *node, |
| 222 | struct of_regulator_match *matches, |
| 223 | unsigned int num_matches) |
| 224 | { |
| 225 | unsigned int count = 0; |
| 226 | unsigned int i; |
Stephen Warren | 13511de | 2012-09-24 13:25:00 -0600 | [diff] [blame] | 227 | const char *name; |
Laxman Dewangan | 5260cd2 | 2012-06-20 17:53:06 +0530 | [diff] [blame] | 228 | struct device_node *child; |
Charles Keepax | 13b3fde | 2014-04-15 13:34:36 +0100 | [diff] [blame] | 229 | struct devm_of_regulator_matches *devm_matches; |
Thierry Reding | 1c8fa58 | 2012-04-26 16:52:20 +0200 | [diff] [blame] | 230 | |
| 231 | if (!dev || !node) |
| 232 | return -EINVAL; |
| 233 | |
Charles Keepax | 13b3fde | 2014-04-15 13:34:36 +0100 | [diff] [blame] | 234 | devm_matches = devres_alloc(devm_of_regulator_put_matches, |
| 235 | sizeof(struct devm_of_regulator_matches), |
| 236 | GFP_KERNEL); |
| 237 | if (!devm_matches) |
| 238 | return -ENOMEM; |
| 239 | |
| 240 | devm_matches->matches = matches; |
| 241 | devm_matches->num_matches = num_matches; |
| 242 | |
| 243 | devres_add(dev, devm_matches); |
| 244 | |
Stephen Warren | a2f95c3 | 2013-01-29 12:01:13 -0700 | [diff] [blame] | 245 | for (i = 0; i < num_matches; i++) { |
| 246 | struct of_regulator_match *match = &matches[i]; |
| 247 | match->init_data = NULL; |
| 248 | match->of_node = NULL; |
| 249 | } |
| 250 | |
Laxman Dewangan | 5260cd2 | 2012-06-20 17:53:06 +0530 | [diff] [blame] | 251 | for_each_child_of_node(node, child) { |
Stephen Warren | 13511de | 2012-09-24 13:25:00 -0600 | [diff] [blame] | 252 | name = of_get_property(child, |
Laxman Dewangan | 5260cd2 | 2012-06-20 17:53:06 +0530 | [diff] [blame] | 253 | "regulator-compatible", NULL); |
Stephen Warren | 13511de | 2012-09-24 13:25:00 -0600 | [diff] [blame] | 254 | if (!name) |
| 255 | name = child->name; |
Laxman Dewangan | 5260cd2 | 2012-06-20 17:53:06 +0530 | [diff] [blame] | 256 | for (i = 0; i < num_matches; i++) { |
| 257 | struct of_regulator_match *match = &matches[i]; |
| 258 | if (match->of_node) |
| 259 | continue; |
Thierry Reding | 1c8fa58 | 2012-04-26 16:52:20 +0200 | [diff] [blame] | 260 | |
Stephen Warren | 13511de | 2012-09-24 13:25:00 -0600 | [diff] [blame] | 261 | if (strcmp(match->name, name)) |
Laxman Dewangan | 5260cd2 | 2012-06-20 17:53:06 +0530 | [diff] [blame] | 262 | continue; |
| 263 | |
| 264 | match->init_data = |
Javier Martinez Canillas | 75d6b2f | 2014-11-10 14:43:54 +0100 | [diff] [blame] | 265 | of_get_regulator_init_data(dev, child, |
| 266 | match->desc); |
Laxman Dewangan | 5260cd2 | 2012-06-20 17:53:06 +0530 | [diff] [blame] | 267 | if (!match->init_data) { |
| 268 | dev_err(dev, |
| 269 | "failed to parse DT for regulator %s\n", |
| 270 | child->name); |
| 271 | return -EINVAL; |
| 272 | } |
Charles Keepax | bd0dda74 | 2014-04-03 15:32:15 +0100 | [diff] [blame] | 273 | match->of_node = of_node_get(child); |
Laxman Dewangan | 5260cd2 | 2012-06-20 17:53:06 +0530 | [diff] [blame] | 274 | count++; |
| 275 | break; |
| 276 | } |
Thierry Reding | 1c8fa58 | 2012-04-26 16:52:20 +0200 | [diff] [blame] | 277 | } |
| 278 | |
| 279 | return count; |
| 280 | } |
| 281 | EXPORT_SYMBOL_GPL(of_regulator_match); |
Mark Brown | a0c7b16 | 2014-09-09 23:13:57 +0100 | [diff] [blame] | 282 | |
| 283 | struct regulator_init_data *regulator_of_get_init_data(struct device *dev, |
| 284 | const struct regulator_desc *desc, |
Krzysztof Kozlowski | bfa21a0 | 2015-01-05 12:48:42 +0100 | [diff] [blame] | 285 | struct regulator_config *config, |
Mark Brown | a0c7b16 | 2014-09-09 23:13:57 +0100 | [diff] [blame] | 286 | struct device_node **node) |
| 287 | { |
| 288 | struct device_node *search, *child; |
| 289 | struct regulator_init_data *init_data = NULL; |
| 290 | const char *name; |
| 291 | |
| 292 | if (!dev->of_node || !desc->of_match) |
| 293 | return NULL; |
| 294 | |
| 295 | if (desc->regulators_node) |
| 296 | search = of_get_child_by_name(dev->of_node, |
| 297 | desc->regulators_node); |
| 298 | else |
| 299 | search = dev->of_node; |
| 300 | |
| 301 | if (!search) { |
Mark Brown | 7de79a1 | 2014-10-08 23:08:13 +0100 | [diff] [blame] | 302 | dev_dbg(dev, "Failed to find regulator container node '%s'\n", |
| 303 | desc->regulators_node); |
Mark Brown | a0c7b16 | 2014-09-09 23:13:57 +0100 | [diff] [blame] | 304 | return NULL; |
| 305 | } |
| 306 | |
| 307 | for_each_child_of_node(search, child) { |
| 308 | name = of_get_property(child, "regulator-compatible", NULL); |
| 309 | if (!name) |
| 310 | name = child->name; |
| 311 | |
| 312 | if (strcmp(desc->of_match, name)) |
| 313 | continue; |
| 314 | |
Javier Martinez Canillas | 072e78b | 2014-11-10 14:43:53 +0100 | [diff] [blame] | 315 | init_data = of_get_regulator_init_data(dev, child, desc); |
Mark Brown | a0c7b16 | 2014-09-09 23:13:57 +0100 | [diff] [blame] | 316 | if (!init_data) { |
| 317 | dev_err(dev, |
| 318 | "failed to parse DT for regulator %s\n", |
| 319 | child->name); |
| 320 | break; |
| 321 | } |
| 322 | |
Krzysztof Kozlowski | bfa21a0 | 2015-01-05 12:48:42 +0100 | [diff] [blame] | 323 | if (desc->of_parse_cb) { |
| 324 | if (desc->of_parse_cb(child, desc, config)) { |
| 325 | dev_err(dev, |
| 326 | "driver callback failed to parse DT for regulator %s\n", |
| 327 | child->name); |
| 328 | init_data = NULL; |
| 329 | break; |
| 330 | } |
| 331 | } |
| 332 | |
Mark Brown | a0c7b16 | 2014-09-09 23:13:57 +0100 | [diff] [blame] | 333 | of_node_get(child); |
| 334 | *node = child; |
| 335 | break; |
| 336 | } |
| 337 | |
| 338 | of_node_put(search); |
| 339 | |
| 340 | return init_data; |
| 341 | } |