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 | |
Chanwoo Choi | 40e20d6 | 2014-10-10 20:35:33 +0900 | [diff] [blame^] | 22 | const char *const regulator_states[PM_SUSPEND_MAX + 1] = { |
| 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, |
| 28 | struct regulator_init_data **init_data) |
| 29 | { |
Sergei Shtylyov | 1e050ea | 2014-05-27 00:27:19 +0400 | [diff] [blame] | 30 | const __be32 *min_uV, *max_uV; |
Rajendra Nayak | 8f446e6 | 2011-11-18 16:47:17 +0530 | [diff] [blame] | 31 | struct regulation_constraints *constraints = &(*init_data)->constraints; |
Chanwoo Choi | 40e20d6 | 2014-10-10 20:35:33 +0900 | [diff] [blame^] | 32 | struct regulator_state *suspend_state; |
| 33 | struct device_node *suspend_np; |
| 34 | int ret, i; |
Laxman Dewangan | 00c877c | 2013-09-18 18:18:02 +0530 | [diff] [blame] | 35 | u32 pval; |
Rajendra Nayak | 8f446e6 | 2011-11-18 16:47:17 +0530 | [diff] [blame] | 36 | |
| 37 | constraints->name = of_get_property(np, "regulator-name", NULL); |
| 38 | |
| 39 | min_uV = of_get_property(np, "regulator-min-microvolt", NULL); |
| 40 | if (min_uV) |
| 41 | constraints->min_uV = be32_to_cpu(*min_uV); |
| 42 | max_uV = of_get_property(np, "regulator-max-microvolt", NULL); |
| 43 | if (max_uV) |
| 44 | constraints->max_uV = be32_to_cpu(*max_uV); |
| 45 | |
| 46 | /* Voltage change possible? */ |
| 47 | if (constraints->min_uV != constraints->max_uV) |
| 48 | constraints->valid_ops_mask |= REGULATOR_CHANGE_VOLTAGE; |
Mark Brown | ab62aa9 | 2011-12-05 10:58:41 +0000 | [diff] [blame] | 49 | /* Only one voltage? Then make sure it's set. */ |
Karol Lewandowski | 8a09304 | 2012-01-25 10:31:45 +0100 | [diff] [blame] | 50 | if (min_uV && max_uV && constraints->min_uV == constraints->max_uV) |
Mark Brown | ab62aa9 | 2011-12-05 10:58:41 +0000 | [diff] [blame] | 51 | constraints->apply_uV = true; |
Rajendra Nayak | 8f446e6 | 2011-11-18 16:47:17 +0530 | [diff] [blame] | 52 | |
Sergei Shtylyov | 1e050ea | 2014-05-27 00:27:19 +0400 | [diff] [blame] | 53 | if (!of_property_read_u32(np, "regulator-microvolt-offset", &pval)) |
| 54 | constraints->uV_offset = pval; |
| 55 | if (!of_property_read_u32(np, "regulator-min-microamp", &pval)) |
| 56 | constraints->min_uA = pval; |
| 57 | if (!of_property_read_u32(np, "regulator-max-microamp", &pval)) |
| 58 | constraints->max_uA = pval; |
Rajendra Nayak | 8f446e6 | 2011-11-18 16:47:17 +0530 | [diff] [blame] | 59 | |
| 60 | /* Current change possible? */ |
| 61 | if (constraints->min_uA != constraints->max_uA) |
| 62 | constraints->valid_ops_mask |= REGULATOR_CHANGE_CURRENT; |
| 63 | |
Sergei Shtylyov | 1e050ea | 2014-05-27 00:27:19 +0400 | [diff] [blame] | 64 | constraints->boot_on = of_property_read_bool(np, "regulator-boot-on"); |
| 65 | constraints->always_on = of_property_read_bool(np, "regulator-always-on"); |
| 66 | if (!constraints->always_on) /* status change should be possible. */ |
Rajendra Nayak | 8f446e6 | 2011-11-18 16:47:17 +0530 | [diff] [blame] | 67 | constraints->valid_ops_mask |= REGULATOR_CHANGE_STATUS; |
Yadwinder Singh Brar | 6f0b2c6 | 2012-06-11 17:41:08 +0530 | [diff] [blame] | 68 | |
Kishon Vijay Abraham I | 93134c7 | 2013-06-20 14:07:37 +0530 | [diff] [blame] | 69 | if (of_property_read_bool(np, "regulator-allow-bypass")) |
| 70 | constraints->valid_ops_mask |= REGULATOR_CHANGE_BYPASS; |
| 71 | |
Sergei Shtylyov | 1e050ea | 2014-05-27 00:27:19 +0400 | [diff] [blame] | 72 | ret = of_property_read_u32(np, "regulator-ramp-delay", &pval); |
| 73 | if (!ret) { |
| 74 | if (pval) |
| 75 | constraints->ramp_delay = pval; |
Yadwinder Singh Brar | 1653ccf | 2013-06-29 18:21:15 +0530 | [diff] [blame] | 76 | else |
| 77 | constraints->ramp_disable = true; |
| 78 | } |
Laxman Dewangan | 00c877c | 2013-09-18 18:18:02 +0530 | [diff] [blame] | 79 | |
| 80 | ret = of_property_read_u32(np, "regulator-enable-ramp-delay", &pval); |
| 81 | if (!ret) |
| 82 | constraints->enable_time = pval; |
Chanwoo Choi | 40e20d6 | 2014-10-10 20:35:33 +0900 | [diff] [blame^] | 83 | |
| 84 | for (i = 0; i < ARRAY_SIZE(regulator_states); i++) { |
| 85 | switch (i) { |
| 86 | case PM_SUSPEND_MEM: |
| 87 | suspend_state = &constraints->state_mem; |
| 88 | break; |
| 89 | case PM_SUSPEND_MAX: |
| 90 | suspend_state = &constraints->state_disk; |
| 91 | break; |
| 92 | case PM_SUSPEND_ON: |
| 93 | case PM_SUSPEND_FREEZE: |
| 94 | case PM_SUSPEND_STANDBY: |
| 95 | default: |
| 96 | continue; |
| 97 | }; |
| 98 | |
| 99 | suspend_np = of_get_child_by_name(np, regulator_states[i]); |
| 100 | if (!suspend_np || !suspend_state) |
| 101 | continue; |
| 102 | |
| 103 | if (of_property_read_bool(suspend_np, |
| 104 | "regulator-on-in-suspend")) |
| 105 | suspend_state->enabled = true; |
| 106 | else if (of_property_read_bool(suspend_np, |
| 107 | "regulator-off-in-suspend")) |
| 108 | suspend_state->disabled = true; |
| 109 | |
| 110 | suspend_state = NULL; |
| 111 | suspend_np = NULL; |
| 112 | } |
Rajendra Nayak | 8f446e6 | 2011-11-18 16:47:17 +0530 | [diff] [blame] | 113 | } |
| 114 | |
| 115 | /** |
| 116 | * of_get_regulator_init_data - extract regulator_init_data structure info |
| 117 | * @dev: device requesting for regulator_init_data |
| 118 | * |
| 119 | * Populates regulator_init_data structure by extracting data from device |
| 120 | * tree node, returns a pointer to the populated struture or NULL if memory |
| 121 | * alloc fails. |
| 122 | */ |
Shawn Guo | d9a861c | 2011-12-01 17:21:06 +0800 | [diff] [blame] | 123 | struct regulator_init_data *of_get_regulator_init_data(struct device *dev, |
| 124 | struct device_node *node) |
Rajendra Nayak | 8f446e6 | 2011-11-18 16:47:17 +0530 | [diff] [blame] | 125 | { |
| 126 | struct regulator_init_data *init_data; |
| 127 | |
Shawn Guo | d9a861c | 2011-12-01 17:21:06 +0800 | [diff] [blame] | 128 | if (!node) |
Rajendra Nayak | 8f446e6 | 2011-11-18 16:47:17 +0530 | [diff] [blame] | 129 | return NULL; |
| 130 | |
| 131 | init_data = devm_kzalloc(dev, sizeof(*init_data), GFP_KERNEL); |
| 132 | if (!init_data) |
| 133 | return NULL; /* Out of memory? */ |
| 134 | |
Shawn Guo | d9a861c | 2011-12-01 17:21:06 +0800 | [diff] [blame] | 135 | of_get_regulation_constraints(node, &init_data); |
Rajendra Nayak | 8f446e6 | 2011-11-18 16:47:17 +0530 | [diff] [blame] | 136 | return init_data; |
| 137 | } |
Axel Lin | e69af5e | 2011-11-26 18:50:58 +0800 | [diff] [blame] | 138 | EXPORT_SYMBOL_GPL(of_get_regulator_init_data); |
Thierry Reding | 1c8fa58 | 2012-04-26 16:52:20 +0200 | [diff] [blame] | 139 | |
Charles Keepax | 13b3fde | 2014-04-15 13:34:36 +0100 | [diff] [blame] | 140 | struct devm_of_regulator_matches { |
| 141 | struct of_regulator_match *matches; |
| 142 | unsigned int num_matches; |
| 143 | }; |
| 144 | |
| 145 | static void devm_of_regulator_put_matches(struct device *dev, void *res) |
| 146 | { |
| 147 | struct devm_of_regulator_matches *devm_matches = res; |
| 148 | int i; |
| 149 | |
| 150 | for (i = 0; i < devm_matches->num_matches; i++) |
| 151 | of_node_put(devm_matches->matches[i].of_node); |
| 152 | } |
| 153 | |
Thierry Reding | 1c8fa58 | 2012-04-26 16:52:20 +0200 | [diff] [blame] | 154 | /** |
Stephen Warren | 13511de | 2012-09-24 13:25:00 -0600 | [diff] [blame] | 155 | * of_regulator_match - extract multiple regulator init data from device tree. |
Thierry Reding | 1c8fa58 | 2012-04-26 16:52:20 +0200 | [diff] [blame] | 156 | * @dev: device requesting the data |
| 157 | * @node: parent device node of the regulators |
| 158 | * @matches: match table for the regulators |
| 159 | * @num_matches: number of entries in match table |
| 160 | * |
Stephen Warren | 13511de | 2012-09-24 13:25:00 -0600 | [diff] [blame] | 161 | * This function uses a match table specified by the regulator driver to |
| 162 | * parse regulator init data from the device tree. @node is expected to |
| 163 | * contain a set of child nodes, each providing the init data for one |
| 164 | * regulator. The data parsed from a child node will be matched to a regulator |
| 165 | * based on either the deprecated property regulator-compatible if present, |
| 166 | * 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] | 167 | * in place and an additional of_node reference is taken for each matched |
| 168 | * regulator. |
Thierry Reding | 1c8fa58 | 2012-04-26 16:52:20 +0200 | [diff] [blame] | 169 | * |
| 170 | * Returns the number of matches found or a negative error code on failure. |
| 171 | */ |
| 172 | int of_regulator_match(struct device *dev, struct device_node *node, |
| 173 | struct of_regulator_match *matches, |
| 174 | unsigned int num_matches) |
| 175 | { |
| 176 | unsigned int count = 0; |
| 177 | unsigned int i; |
Stephen Warren | 13511de | 2012-09-24 13:25:00 -0600 | [diff] [blame] | 178 | const char *name; |
Laxman Dewangan | 5260cd2 | 2012-06-20 17:53:06 +0530 | [diff] [blame] | 179 | struct device_node *child; |
Charles Keepax | 13b3fde | 2014-04-15 13:34:36 +0100 | [diff] [blame] | 180 | struct devm_of_regulator_matches *devm_matches; |
Thierry Reding | 1c8fa58 | 2012-04-26 16:52:20 +0200 | [diff] [blame] | 181 | |
| 182 | if (!dev || !node) |
| 183 | return -EINVAL; |
| 184 | |
Charles Keepax | 13b3fde | 2014-04-15 13:34:36 +0100 | [diff] [blame] | 185 | devm_matches = devres_alloc(devm_of_regulator_put_matches, |
| 186 | sizeof(struct devm_of_regulator_matches), |
| 187 | GFP_KERNEL); |
| 188 | if (!devm_matches) |
| 189 | return -ENOMEM; |
| 190 | |
| 191 | devm_matches->matches = matches; |
| 192 | devm_matches->num_matches = num_matches; |
| 193 | |
| 194 | devres_add(dev, devm_matches); |
| 195 | |
Stephen Warren | a2f95c3 | 2013-01-29 12:01:13 -0700 | [diff] [blame] | 196 | for (i = 0; i < num_matches; i++) { |
| 197 | struct of_regulator_match *match = &matches[i]; |
| 198 | match->init_data = NULL; |
| 199 | match->of_node = NULL; |
| 200 | } |
| 201 | |
Laxman Dewangan | 5260cd2 | 2012-06-20 17:53:06 +0530 | [diff] [blame] | 202 | for_each_child_of_node(node, child) { |
Stephen Warren | 13511de | 2012-09-24 13:25:00 -0600 | [diff] [blame] | 203 | name = of_get_property(child, |
Laxman Dewangan | 5260cd2 | 2012-06-20 17:53:06 +0530 | [diff] [blame] | 204 | "regulator-compatible", NULL); |
Stephen Warren | 13511de | 2012-09-24 13:25:00 -0600 | [diff] [blame] | 205 | if (!name) |
| 206 | name = child->name; |
Laxman Dewangan | 5260cd2 | 2012-06-20 17:53:06 +0530 | [diff] [blame] | 207 | for (i = 0; i < num_matches; i++) { |
| 208 | struct of_regulator_match *match = &matches[i]; |
| 209 | if (match->of_node) |
| 210 | continue; |
Thierry Reding | 1c8fa58 | 2012-04-26 16:52:20 +0200 | [diff] [blame] | 211 | |
Stephen Warren | 13511de | 2012-09-24 13:25:00 -0600 | [diff] [blame] | 212 | if (strcmp(match->name, name)) |
Laxman Dewangan | 5260cd2 | 2012-06-20 17:53:06 +0530 | [diff] [blame] | 213 | continue; |
| 214 | |
| 215 | match->init_data = |
| 216 | of_get_regulator_init_data(dev, child); |
| 217 | if (!match->init_data) { |
| 218 | dev_err(dev, |
| 219 | "failed to parse DT for regulator %s\n", |
| 220 | child->name); |
| 221 | return -EINVAL; |
| 222 | } |
Charles Keepax | bd0dda74 | 2014-04-03 15:32:15 +0100 | [diff] [blame] | 223 | match->of_node = of_node_get(child); |
Laxman Dewangan | 5260cd2 | 2012-06-20 17:53:06 +0530 | [diff] [blame] | 224 | count++; |
| 225 | break; |
| 226 | } |
Thierry Reding | 1c8fa58 | 2012-04-26 16:52:20 +0200 | [diff] [blame] | 227 | } |
| 228 | |
| 229 | return count; |
| 230 | } |
| 231 | EXPORT_SYMBOL_GPL(of_regulator_match); |
Mark Brown | a0c7b16 | 2014-09-09 23:13:57 +0100 | [diff] [blame] | 232 | |
| 233 | struct regulator_init_data *regulator_of_get_init_data(struct device *dev, |
| 234 | const struct regulator_desc *desc, |
| 235 | struct device_node **node) |
| 236 | { |
| 237 | struct device_node *search, *child; |
| 238 | struct regulator_init_data *init_data = NULL; |
| 239 | const char *name; |
| 240 | |
| 241 | if (!dev->of_node || !desc->of_match) |
| 242 | return NULL; |
| 243 | |
| 244 | if (desc->regulators_node) |
| 245 | search = of_get_child_by_name(dev->of_node, |
| 246 | desc->regulators_node); |
| 247 | else |
| 248 | search = dev->of_node; |
| 249 | |
| 250 | if (!search) { |
| 251 | dev_err(dev, "Failed to find regulator container node\n"); |
| 252 | return NULL; |
| 253 | } |
| 254 | |
| 255 | for_each_child_of_node(search, child) { |
| 256 | name = of_get_property(child, "regulator-compatible", NULL); |
| 257 | if (!name) |
| 258 | name = child->name; |
| 259 | |
| 260 | if (strcmp(desc->of_match, name)) |
| 261 | continue; |
| 262 | |
| 263 | init_data = of_get_regulator_init_data(dev, child); |
| 264 | if (!init_data) { |
| 265 | dev_err(dev, |
| 266 | "failed to parse DT for regulator %s\n", |
| 267 | child->name); |
| 268 | break; |
| 269 | } |
| 270 | |
| 271 | of_node_get(child); |
| 272 | *node = child; |
| 273 | break; |
| 274 | } |
| 275 | |
| 276 | of_node_put(search); |
| 277 | |
| 278 | return init_data; |
| 279 | } |