]> git.ipfire.org Git - thirdparty/u-boot.git/blame - cmd/regulator.c
Merge tag 'efi-2025-07-rc6' of https://source.denx.de/u-boot/custodians/u-boot-efi
[thirdparty/u-boot.git] / cmd / regulator.c
CommitLineData
83d290c5 1// SPDX-License-Identifier: GPL-2.0+
6262b72b
PM
2/*
3 * Copyright (C) 2014-2015 Samsung Electronics
4 * Przemyslaw Marczak <p.marczak@samsung.com>
6262b72b 5 */
09140113 6#include <command.h>
6262b72b
PM
7#include <errno.h>
8#include <dm.h>
9#include <dm/uclass-internal.h>
1e94b46f 10#include <linux/printk.h>
6262b72b
PM
11#include <power/regulator.h>
12
6262b72b 13#define LIMIT_DEVNAME 20
e09b2a02
PM
14#define LIMIT_OFNAME 32
15#define LIMIT_INFO 18
6262b72b
PM
16
17static struct udevice *currdev;
18
e09b2a02 19static int failure(int ret)
6262b72b 20{
e09b2a02 21 printf("Error: %d (%s)\n", ret, errno_str(ret));
6262b72b 22
e09b2a02 23 return CMD_RET_FAILURE;
6262b72b
PM
24}
25
09140113 26static int do_dev(struct cmd_tbl *cmdtp, int flag, int argc, char *const argv[])
6262b72b 27{
caa4daa2 28 struct dm_regulator_uclass_plat *uc_pdata;
e09b2a02
PM
29 const char *name;
30 int ret = -ENXIO;
6262b72b
PM
31
32 switch (argc) {
33 case 2:
e09b2a02
PM
34 name = argv[1];
35 ret = regulator_get_by_platname(name, &currdev);
36 if (ret) {
37 printf("Can't get the regulator: %s!\n", name);
38 return failure(ret);
39 }
16abdd42 40 fallthrough;
6262b72b 41 case 1:
e09b2a02
PM
42 if (!currdev) {
43 printf("Regulator device is not set!\n\n");
44 return CMD_RET_USAGE;
45 }
46
caa4daa2 47 uc_pdata = dev_get_uclass_plat(currdev);
e09b2a02
PM
48 if (!uc_pdata) {
49 printf("%s: no regulator platform data!\n", currdev->name);
50 return failure(ret);
51 }
6262b72b 52
e09b2a02 53 printf("dev: %s @ %s\n", uc_pdata->name, currdev->name);
6262b72b
PM
54 }
55
56 return CMD_RET_SUCCESS;
6262b72b
PM
57}
58
8a8d24bd
SG
59static int curr_dev_and_plat(struct udevice **devp,
60 struct dm_regulator_uclass_plat **uc_pdata,
61 bool allow_type_fixed)
6262b72b
PM
62{
63 *devp = NULL;
64 *uc_pdata = NULL;
65
e09b2a02
PM
66 if (!currdev) {
67 printf("First, set the regulator device!\n");
68 return CMD_RET_FAILURE;
69 }
6262b72b
PM
70
71 *devp = currdev;
72
caa4daa2 73 *uc_pdata = dev_get_uclass_plat(*devp);
e09b2a02 74 if (!*uc_pdata) {
71002b50 75 pr_err("Regulator: %s - missing platform data!\n", currdev->name);
e09b2a02
PM
76 return CMD_RET_FAILURE;
77 }
6262b72b
PM
78
79 if (!allow_type_fixed && (*uc_pdata)->type == REGULATOR_TYPE_FIXED) {
80 printf("Operation not allowed for fixed regulator!\n");
81 return CMD_RET_FAILURE;
82 }
83
84 return CMD_RET_SUCCESS;
85}
86
09140113
SG
87static int do_list(struct cmd_tbl *cmdtp, int flag, int argc,
88 char *const argv[])
6262b72b 89{
caa4daa2 90 struct dm_regulator_uclass_plat *uc_pdata;
e09b2a02 91 struct udevice *dev;
6262b72b
PM
92 int ret;
93
e09b2a02
PM
94 printf("| %-*.*s| %-*.*s| %s\n",
95 LIMIT_DEVNAME, LIMIT_DEVNAME, "Device",
96 LIMIT_OFNAME, LIMIT_OFNAME, "regulator-name",
97 "Parent");
6262b72b 98
e09b2a02
PM
99 for (ret = uclass_find_first_device(UCLASS_REGULATOR, &dev); dev;
100 ret = uclass_find_next_device(&dev)) {
101 if (ret)
102 continue;
6262b72b 103
caa4daa2 104 uc_pdata = dev_get_uclass_plat(dev);
e09b2a02
PM
105 printf("| %-*.*s| %-*.*s| %s\n",
106 LIMIT_DEVNAME, LIMIT_DEVNAME, dev->name,
107 LIMIT_OFNAME, LIMIT_OFNAME, uc_pdata->name,
108 dev->parent->name);
109 }
110
111 return ret;
6262b72b
PM
112}
113
114static int constraint(const char *name, int val, const char *val_name)
115{
116 printf("%-*s", LIMIT_INFO, name);
117 if (val < 0) {
118 printf(" %s (err: %d)\n", errno_str(val), val);
119 return val;
120 }
121
122 if (val_name)
123 printf(" %d (%s)\n", val, val_name);
124 else
125 printf(" %d\n", val);
126
127 return 0;
128}
129
130static const char *get_mode_name(struct dm_regulator_mode *mode,
131 int mode_count,
132 int mode_id)
133{
134 while (mode_count--) {
135 if (mode->id == mode_id)
136 return mode->name;
137 mode++;
138 }
139
140 return NULL;
141}
142
09140113
SG
143static int do_info(struct cmd_tbl *cmdtp, int flag, int argc,
144 char *const argv[])
6262b72b
PM
145{
146 struct udevice *dev;
caa4daa2 147 struct dm_regulator_uclass_plat *uc_pdata;
6262b72b
PM
148 struct dm_regulator_mode *modes;
149 const char *parent_uc;
150 int mode_count;
151 int ret;
152 int i;
153
8a8d24bd 154 ret = curr_dev_and_plat(&dev, &uc_pdata, true);
6262b72b
PM
155 if (ret)
156 return ret;
157
158 parent_uc = dev_get_uclass_name(dev->parent);
159
e09b2a02
PM
160 printf("%s\n%-*s %s\n%-*s %s\n%-*s %s\n%-*s %s\n%-*s\n",
161 "Regulator info:",
162 LIMIT_INFO, "* regulator-name:", uc_pdata->name,
163 LIMIT_INFO, "* device name:", dev->name,
164 LIMIT_INFO, "* parent name:", dev->parent->name,
165 LIMIT_INFO, "* parent uclass:", parent_uc,
6262b72b
PM
166 LIMIT_INFO, "* constraints:");
167
168 constraint(" - min uV:", uc_pdata->min_uV, NULL);
169 constraint(" - max uV:", uc_pdata->max_uV, NULL);
170 constraint(" - min uA:", uc_pdata->min_uA, NULL);
171 constraint(" - max uA:", uc_pdata->max_uA, NULL);
172 constraint(" - always on:", uc_pdata->always_on,
173 uc_pdata->always_on ? "true" : "false");
174 constraint(" - boot on:", uc_pdata->boot_on,
175 uc_pdata->boot_on ? "true" : "false");
176
177 mode_count = regulator_mode(dev, &modes);
178 constraint("* op modes:", mode_count, NULL);
179
180 for (i = 0; i < mode_count; i++, modes++)
181 constraint(" - mode id:", modes->id, modes->name);
182
183 return CMD_RET_SUCCESS;
184}
185
931b24c5 186static void do_status_detail(struct udevice *dev,
caa4daa2 187 struct dm_regulator_uclass_plat *uc_pdata)
6262b72b 188{
931b24c5
SG
189 int current, value, mode;
190 const char *mode_name;
6262b72b
PM
191 bool enabled;
192
e09b2a02
PM
193 printf("Regulator %s status:\n", uc_pdata->name);
194
6262b72b
PM
195 enabled = regulator_get_enable(dev);
196 constraint(" * enable:", enabled, enabled ? "true" : "false");
197
198 value = regulator_get_value(dev);
199 constraint(" * value uV:", value, NULL);
200
201 current = regulator_get_current(dev);
202 constraint(" * current uA:", current, NULL);
203
204 mode = regulator_get_mode(dev);
205 mode_name = get_mode_name(uc_pdata->mode, uc_pdata->mode_count, mode);
206 constraint(" * mode id:", mode, mode_name);
931b24c5
SG
207}
208
8676ae36 209static void do_status_line(struct udevice *dev, int status)
931b24c5 210{
caa4daa2 211 struct dm_regulator_uclass_plat *pdata;
931b24c5
SG
212 int current, value, mode;
213 const char *mode_name;
214 bool enabled;
215
caa4daa2 216 pdata = dev_get_uclass_plat(dev);
931b24c5
SG
217 enabled = regulator_get_enable(dev);
218 value = regulator_get_value(dev);
219 current = regulator_get_current(dev);
220 mode = regulator_get_mode(dev);
221 mode_name = get_mode_name(pdata->mode, pdata->mode_count, mode);
222 printf("%-20s %-10s ", pdata->name, enabled ? "enabled" : "disabled");
223 if (value >= 0)
224 printf("%10d ", value);
225 else
226 printf("%10s ", "-");
227 if (current >= 0)
228 printf("%10d ", current);
229 else
230 printf("%10s ", "-");
231 if (mode >= 0)
232 printf("%-10s", mode_name);
233 else
234 printf("%-10s", "-");
8676ae36 235 printf(" %i", status);
931b24c5
SG
236 printf("\n");
237}
238
09140113
SG
239static int do_status(struct cmd_tbl *cmdtp, int flag, int argc,
240 char *const argv[])
931b24c5 241{
caa4daa2 242 struct dm_regulator_uclass_plat *uc_pdata;
931b24c5
SG
243 struct udevice *dev;
244 int ret;
245
246 if (currdev && (argc < 2 || strcmp(argv[1], "-a"))) {
8a8d24bd 247 ret = curr_dev_and_plat(&dev, &uc_pdata, true);
931b24c5
SG
248 if (ret)
249 return CMD_RET_FAILURE;
250 do_status_detail(dev, uc_pdata);
251 return 0;
252 }
253
254 /* Show all of them in a list, probing them as needed */
8676ae36
MS
255 printf("%-20s %-10s %10s %10s %-10s %s\n", "Name", "Enabled", "uV", "mA",
256 "Mode", "Status");
257 for (ret = uclass_first_device_check(UCLASS_REGULATOR, &dev); dev;
258 ret = uclass_next_device_check(&dev))
259 do_status_line(dev, ret);
6262b72b
PM
260
261 return CMD_RET_SUCCESS;
262}
263
09140113
SG
264static int do_value(struct cmd_tbl *cmdtp, int flag, int argc,
265 char *const argv[])
6262b72b
PM
266{
267 struct udevice *dev;
caa4daa2 268 struct dm_regulator_uclass_plat *uc_pdata;
6262b72b
PM
269 int value;
270 int force;
271 int ret;
272
8a8d24bd 273 ret = curr_dev_and_plat(&dev, &uc_pdata, argc == 1);
6262b72b
PM
274 if (ret)
275 return ret;
276
277 if (argc == 1) {
e09b2a02
PM
278 ret = regulator_get_value(dev);
279 if (ret < 0) {
280 printf("Regulator: %s - can't get the Voltage!\n",
281 uc_pdata->name);
282 return failure(ret);
283 }
6262b72b 284
e09b2a02 285 printf("%d uV\n", ret);
6262b72b
PM
286 return CMD_RET_SUCCESS;
287 }
288
289 if (argc == 3)
290 force = !strcmp("-f", argv[2]);
291 else
292 force = 0;
293
294 value = simple_strtoul(argv[1], NULL, 0);
295 if ((value < uc_pdata->min_uV || value > uc_pdata->max_uV) && !force) {
224d1ddc
SG
296 printf("Value exceeds regulator constraint limits %d..%d uV\n",
297 uc_pdata->min_uV, uc_pdata->max_uV);
6262b72b
PM
298 return CMD_RET_FAILURE;
299 }
300
2f5d532f
K
301 if (!force)
302 ret = regulator_set_value(dev, value);
303 else
304 ret = regulator_set_value_force(dev, value);
e09b2a02
PM
305 if (ret) {
306 printf("Regulator: %s - can't set the Voltage!\n",
307 uc_pdata->name);
308 return failure(ret);
309 }
6262b72b
PM
310
311 return CMD_RET_SUCCESS;
312}
313
09140113
SG
314static int do_current(struct cmd_tbl *cmdtp, int flag, int argc,
315 char *const argv[])
6262b72b
PM
316{
317 struct udevice *dev;
caa4daa2 318 struct dm_regulator_uclass_plat *uc_pdata;
6262b72b
PM
319 int current;
320 int ret;
321
8a8d24bd 322 ret = curr_dev_and_plat(&dev, &uc_pdata, argc == 1);
6262b72b
PM
323 if (ret)
324 return ret;
325
326 if (argc == 1) {
e09b2a02
PM
327 ret = regulator_get_current(dev);
328 if (ret < 0) {
329 printf("Regulator: %s - can't get the Current!\n",
330 uc_pdata->name);
331 return failure(ret);
332 }
6262b72b 333
e09b2a02 334 printf("%d uA\n", ret);
6262b72b
PM
335 return CMD_RET_SUCCESS;
336 }
337
338 current = simple_strtoul(argv[1], NULL, 0);
339 if (current < uc_pdata->min_uA || current > uc_pdata->max_uA) {
340 printf("Current exceeds regulator constraint limits\n");
341 return CMD_RET_FAILURE;
342 }
343
344 ret = regulator_set_current(dev, current);
e09b2a02
PM
345 if (ret) {
346 printf("Regulator: %s - can't set the Current!\n",
347 uc_pdata->name);
348 return failure(ret);
349 }
6262b72b
PM
350
351 return CMD_RET_SUCCESS;
352}
353
09140113
SG
354static int do_mode(struct cmd_tbl *cmdtp, int flag, int argc,
355 char *const argv[])
6262b72b
PM
356{
357 struct udevice *dev;
caa4daa2 358 struct dm_regulator_uclass_plat *uc_pdata;
6262b72b
PM
359 int mode;
360 int ret;
361
8a8d24bd 362 ret = curr_dev_and_plat(&dev, &uc_pdata, false);
6262b72b
PM
363 if (ret)
364 return ret;
365
366 if (argc == 1) {
e09b2a02
PM
367 ret = regulator_get_mode(dev);
368 if (ret < 0) {
369 printf("Regulator: %s - can't get the operation mode!\n",
370 uc_pdata->name);
371 return failure(ret);
372 }
6262b72b 373
e09b2a02 374 printf("mode id: %d\n", ret);
6262b72b
PM
375 return CMD_RET_SUCCESS;
376 }
377
e09b2a02 378 mode = simple_strtoul(argv[1], NULL, 0);
6262b72b 379
e09b2a02
PM
380 ret = regulator_set_mode(dev, mode);
381 if (ret) {
382 printf("Regulator: %s - can't set the operation mode!\n",
383 uc_pdata->name);
384 return failure(ret);
385 }
6262b72b
PM
386
387 return CMD_RET_SUCCESS;
388}
389
09140113
SG
390static int do_enable(struct cmd_tbl *cmdtp, int flag, int argc,
391 char *const argv[])
6262b72b
PM
392{
393 struct udevice *dev;
caa4daa2 394 struct dm_regulator_uclass_plat *uc_pdata;
6262b72b
PM
395 int ret;
396
8a8d24bd 397 ret = curr_dev_and_plat(&dev, &uc_pdata, true);
6262b72b
PM
398 if (ret)
399 return ret;
400
401 ret = regulator_set_enable(dev, true);
e09b2a02
PM
402 if (ret) {
403 printf("Regulator: %s - can't enable!\n", uc_pdata->name);
404 return failure(ret);
405 }
6262b72b
PM
406
407 return CMD_RET_SUCCESS;
408}
409
09140113
SG
410static int do_disable(struct cmd_tbl *cmdtp, int flag, int argc,
411 char *const argv[])
6262b72b
PM
412{
413 struct udevice *dev;
caa4daa2 414 struct dm_regulator_uclass_plat *uc_pdata;
6262b72b
PM
415 int ret;
416
8a8d24bd 417 ret = curr_dev_and_plat(&dev, &uc_pdata, true);
6262b72b
PM
418 if (ret)
419 return ret;
420
421 ret = regulator_set_enable(dev, false);
e09b2a02
PM
422 if (ret) {
423 printf("Regulator: %s - can't disable!\n", uc_pdata->name);
424 return failure(ret);
425 }
6262b72b
PM
426
427 return CMD_RET_SUCCESS;
428}
429
09140113 430static struct cmd_tbl subcmd[] = {
6262b72b
PM
431 U_BOOT_CMD_MKENT(dev, 2, 1, do_dev, "", ""),
432 U_BOOT_CMD_MKENT(list, 1, 1, do_list, "", ""),
433 U_BOOT_CMD_MKENT(info, 2, 1, do_info, "", ""),
434 U_BOOT_CMD_MKENT(status, 2, 1, do_status, "", ""),
435 U_BOOT_CMD_MKENT(value, 3, 1, do_value, "", ""),
436 U_BOOT_CMD_MKENT(current, 3, 1, do_current, "", ""),
437 U_BOOT_CMD_MKENT(mode, 2, 1, do_mode, "", ""),
438 U_BOOT_CMD_MKENT(enable, 1, 1, do_enable, "", ""),
439 U_BOOT_CMD_MKENT(disable, 1, 1, do_disable, "", ""),
440};
441
09140113
SG
442static int do_regulator(struct cmd_tbl *cmdtp, int flag, int argc,
443 char *const argv[])
6262b72b 444{
09140113 445 struct cmd_tbl *cmd;
6262b72b
PM
446
447 argc--;
448 argv++;
449
450 cmd = find_cmd_tbl(argv[0], subcmd, ARRAY_SIZE(subcmd));
451 if (cmd == NULL || argc > cmd->maxargs)
452 return CMD_RET_USAGE;
453
454 return cmd->cmd(cmdtp, flag, argc, argv);
455}
456
457U_BOOT_CMD(regulator, CONFIG_SYS_MAXARGS, 1, do_regulator,
458 "uclass operations",
e09b2a02
PM
459 "list - list UCLASS regulator devices\n"
460 "regulator dev [regulator-name] - show/[set] operating regulator device\n"
461 "regulator info - print constraints info\n"
931b24c5 462 "regulator status [-a] - print operating status [for all]\n"
e09b2a02
PM
463 "regulator value [val] [-f] - print/[set] voltage value [uV] (force)\n"
464 "regulator current [val] - print/[set] current value [uA]\n"
465 "regulator mode [id] - print/[set] operating mode id\n"
466 "regulator enable - enable the regulator output\n"
467 "regulator disable - disable the regulator output\n"
6262b72b 468);