blob: ad49905d67bb176e59c667c0379a07258f1fd929 [file] [log] [blame]
Tom Rini83d290c2018-05-06 17:58:06 -04001// SPDX-License-Identifier: GPL-2.0+
Moritz Fischerbfeba012016-10-04 17:08:08 -07002/*
3 * Chromium OS cros_ec driver
4 *
5 * Copyright (c) 2016 The Chromium OS Authors.
6 * Copyright (c) 2016 National Instruments Corp
Moritz Fischerbfeba012016-10-04 17:08:08 -07007 */
8
9#include <common.h>
10#include <command.h>
11#include <cros_ec.h>
12#include <dm.h>
Simon Glassb79fdc72020-05-10 11:39:54 -060013#include <flash.h>
Simon Glassf7ae49f2020-05-10 11:40:05 -060014#include <log.h>
Moritz Fischerbfeba012016-10-04 17:08:08 -070015#include <dm/device-internal.h>
16#include <dm/uclass-internal.h>
17
18/* Note: depends on enum ec_current_image */
19static const char * const ec_current_image_name[] = {"unknown", "RO", "RW"};
20
Moritz Fischerbfeba012016-10-04 17:08:08 -070021/**
Moritz Fischera2558e82016-11-03 08:53:52 -060022 * Decode a flash region parameter
23 *
24 * @param argc Number of params remaining
25 * @param argv List of remaining parameters
Heinrich Schuchardt185f8122022-01-19 18:05:50 +010026 * Return: flash region (EC_FLASH_REGION_...) or -1 on error
Moritz Fischera2558e82016-11-03 08:53:52 -060027 */
Simon Glass09140112020-05-10 11:40:03 -060028static int cros_ec_decode_region(int argc, char *const argv[])
Moritz Fischera2558e82016-11-03 08:53:52 -060029{
30 if (argc > 0) {
31 if (0 == strcmp(*argv, "rw"))
Simon Glass6f1c0432018-10-01 12:22:36 -060032 return EC_FLASH_REGION_ACTIVE;
Moritz Fischera2558e82016-11-03 08:53:52 -060033 else if (0 == strcmp(*argv, "ro"))
34 return EC_FLASH_REGION_RO;
35
36 debug("%s: Invalid region '%s'\n", __func__, *argv);
37 } else {
38 debug("%s: Missing region parameter\n", __func__);
39 }
40
41 return -1;
42}
43
44/**
Moritz Fischerbfeba012016-10-04 17:08:08 -070045 * Perform a flash read or write command
46 *
47 * @param dev CROS-EC device to read/write
48 * @param is_write 1 do to a write, 0 to do a read
49 * @param argc Number of arguments
50 * @param argv Arguments (2 is region, 3 is address)
Heinrich Schuchardt185f8122022-01-19 18:05:50 +010051 * Return: 0 for ok, 1 for a usage error or -ve for ec command error
Moritz Fischerbfeba012016-10-04 17:08:08 -070052 * (negative EC_RES_...)
53 */
Simon Glass6322a7b2018-10-01 12:22:22 -060054static int do_read_write(struct udevice *dev, int is_write, int argc,
Simon Glass09140112020-05-10 11:40:03 -060055 char *const argv[])
Moritz Fischerbfeba012016-10-04 17:08:08 -070056{
57 uint32_t offset, size = -1U, region_size;
58 unsigned long addr;
59 char *endp;
60 int region;
61 int ret;
62
63 region = cros_ec_decode_region(argc - 2, argv + 2);
64 if (region == -1)
65 return 1;
66 if (argc < 4)
67 return 1;
Simon Glass7e5f4602021-07-24 09:03:29 -060068 addr = hextoul(argv[3], &endp);
Moritz Fischerbfeba012016-10-04 17:08:08 -070069 if (*argv[3] == 0 || *endp != 0)
70 return 1;
71 if (argc > 4) {
Simon Glass7e5f4602021-07-24 09:03:29 -060072 size = hextoul(argv[4], &endp);
Moritz Fischerbfeba012016-10-04 17:08:08 -070073 if (*argv[4] == 0 || *endp != 0)
74 return 1;
75 }
76
77 ret = cros_ec_flash_offset(dev, region, &offset, &region_size);
78 if (ret) {
79 debug("%s: Could not read region info\n", __func__);
80 return ret;
81 }
82 if (size == -1U)
83 size = region_size;
84
85 ret = is_write ?
86 cros_ec_flash_write(dev, (uint8_t *)addr, offset, size) :
87 cros_ec_flash_read(dev, (uint8_t *)addr, offset, size);
88 if (ret) {
89 debug("%s: Could not %s region\n", __func__,
90 is_write ? "write" : "read");
91 return ret;
92 }
93
94 return 0;
95}
96
Simon Glass8aec32f2021-01-16 14:52:26 -070097static const char *const feat_name[64] = {
98 "limited",
99 "flash",
100 "pwm_fan",
101 "pwm_keyb",
102 "lightbar",
103 "led",
104 "motion_sense",
105 "keyb",
106 "pstore",
107 "port80",
108 "thermal",
109 "bklight_switch",
110 "wifi_switch",
111 "host_events",
112 "gpio",
113 "i2c",
114 "charger",
115 "battery",
116 "smart_battery",
117 "hang_detect",
118 "pmu",
119 "sub_mcu",
120 "usb_pd",
121 "usb_mux",
122 "motion_sense_fifo",
123 "vstore",
124 "usbc_ss_mux_virtual",
125 "rtc",
126 "fingerprint",
127 "touchpad",
128 "rwsig",
129 "device_event",
130 "unified_wake_masks",
131 "host_event64",
132 "exec_in_ram",
133 "cec",
134 "motion_sense_tight_timestamps",
135 "refined_tablet_mode_hysteresis",
136 "efs2",
137 "scp",
138 "ish",
139 "typec_cmd",
140 "typec_require_ap_mode_entry",
141 "typec_mux_require_ap_ack",
142};
143
144static int do_show_features(struct udevice *dev)
145{
146 u64 feat;
147 int ret;
148 uint i;
149
150 ret = cros_ec_get_features(dev, &feat);
151 if (ret)
152 return ret;
153 for (i = 0; i < ARRAY_SIZE(feat_name); i++) {
154 if (feat & (1ULL << i)) {
155 if (feat_name[i])
156 printf("%s\n", feat_name[i]);
157 else
158 printf("unknown %d\n", i);
159 }
160 }
161
162 return 0;
163}
164
Simon Glass3a6c9942021-01-16 14:52:28 -0700165static const char *const switch_name[8] = {
166 "lid open",
167 "power button pressed",
168 "write-protect disabled",
169 NULL,
170 "dedicated recovery",
171 NULL,
172 NULL,
173 NULL,
174};
175
176static int do_show_switches(struct udevice *dev)
177{
178 uint switches;
179 int ret;
180 uint i;
181
182 ret = cros_ec_get_switches(dev);
183 if (ret < 0)
184 return log_msg_ret("get", ret);
185 switches = ret;
186 for (i = 0; i < ARRAY_SIZE(switch_name); i++) {
187 uint mask = 1 << i;
188
189 if (switches & mask) {
190 if (switch_name[i])
191 printf("%s\n", switch_name[i]);
192 else
193 printf("unknown %02x\n", mask);
194 }
195 }
196
197 return 0;
198}
199
Simon Glass3ae33822021-01-16 14:52:29 -0700200static const char *const event_name[] = {
201 "lid_closed",
202 "lid_open",
203 "power_button",
204 "ac_connected",
205 "ac_disconnected",
206 "battery_low",
207 "battery_critical",
208 "battery",
209 "thermal_threshold",
210 "device",
211 "thermal",
212 "usb_charger",
213 "key_pressed",
214 "interface_ready",
215 "keyboard_recovery",
216 "thermal_shutdown",
217 "battery_shutdown",
218 "throttle_start",
219 "throttle_stop",
220 "hang_detect",
221 "hang_reboot",
222 "pd_mcu",
223 "battery_status",
224 "panic",
225 "keyboard_fastboot",
226 "rtc",
227 "mkbp",
228 "usb_mux",
229 "mode_change",
230 "keyboard_recovery_hw_reinit",
231 "extended",
232 "invalid",
233};
234
235static int do_show_events(struct udevice *dev)
236{
237 u32 events;
238 int ret;
239 uint i;
240
241 ret = cros_ec_get_host_events(dev, &events);
242 if (ret)
243 return ret;
244 printf("%08x\n", events);
245 for (i = 0; i < ARRAY_SIZE(event_name); i++) {
246 enum host_event_code code = i + 1;
247 u64 mask = EC_HOST_EVENT_MASK(code);
248
249 if (events & mask) {
250 if (event_name[i])
251 printf("%s\n", event_name[i]);
252 else
253 printf("unknown code %#x\n", code);
254 }
255 }
256
257 return 0;
258}
259
Simon Glass09140112020-05-10 11:40:03 -0600260static int do_cros_ec(struct cmd_tbl *cmdtp, int flag, int argc,
261 char *const argv[])
Moritz Fischerbfeba012016-10-04 17:08:08 -0700262{
Simon Glass6322a7b2018-10-01 12:22:22 -0600263 struct udevice *dev;
Moritz Fischerbfeba012016-10-04 17:08:08 -0700264 const char *cmd;
265 int ret = 0;
266
267 if (argc < 2)
268 return CMD_RET_USAGE;
269
270 cmd = argv[1];
271 if (0 == strcmp("init", cmd)) {
272 /* Remove any existing device */
Simon Glass6322a7b2018-10-01 12:22:22 -0600273 ret = uclass_find_device(UCLASS_CROS_EC, 0, &dev);
Moritz Fischerbfeba012016-10-04 17:08:08 -0700274 if (!ret)
Simon Glass6322a7b2018-10-01 12:22:22 -0600275 device_remove(dev, DM_REMOVE_NORMAL);
276 ret = uclass_get_device(UCLASS_CROS_EC, 0, &dev);
Moritz Fischerbfeba012016-10-04 17:08:08 -0700277 if (ret) {
278 printf("Could not init cros_ec device (err %d)\n", ret);
279 return 1;
280 }
281 return 0;
282 }
283
Simon Glass6322a7b2018-10-01 12:22:22 -0600284 ret = uclass_get_device(UCLASS_CROS_EC, 0, &dev);
Moritz Fischerbfeba012016-10-04 17:08:08 -0700285 if (ret) {
286 printf("Cannot get cros-ec device (err=%d)\n", ret);
287 return 1;
288 }
Moritz Fischerbfeba012016-10-04 17:08:08 -0700289 if (0 == strcmp("id", cmd)) {
290 char id[MSG_BYTES];
291
292 if (cros_ec_read_id(dev, id, sizeof(id))) {
293 debug("%s: Could not read KBC ID\n", __func__);
294 return 1;
295 }
296 printf("%s\n", id);
297 } else if (0 == strcmp("info", cmd)) {
298 struct ec_response_mkbp_info info;
299
300 if (cros_ec_info(dev, &info)) {
301 debug("%s: Could not read KBC info\n", __func__);
302 return 1;
303 }
304 printf("rows = %u\n", info.rows);
305 printf("cols = %u\n", info.cols);
Simon Glass8aec32f2021-01-16 14:52:26 -0700306 } else if (!strcmp("features", cmd)) {
307 ret = do_show_features(dev);
308
309 if (ret)
310 printf("Error: %d\n", ret);
Simon Glass3a6c9942021-01-16 14:52:28 -0700311 } else if (!strcmp("switches", cmd)) {
312 ret = do_show_switches(dev);
313
314 if (ret)
315 printf("Error: %d\n", ret);
Moritz Fischerbfeba012016-10-04 17:08:08 -0700316 } else if (0 == strcmp("curimage", cmd)) {
317 enum ec_current_image image;
318
319 if (cros_ec_read_current_image(dev, &image)) {
320 debug("%s: Could not read KBC image\n", __func__);
321 return 1;
322 }
323 printf("%d\n", image);
324 } else if (0 == strcmp("hash", cmd)) {
325 struct ec_response_vboot_hash hash;
326 int i;
327
Simon Glassa12ef7e2018-10-01 12:22:38 -0600328 if (cros_ec_read_hash(dev, EC_VBOOT_HASH_OFFSET_ACTIVE, &hash)) {
Moritz Fischerbfeba012016-10-04 17:08:08 -0700329 debug("%s: Could not read KBC hash\n", __func__);
330 return 1;
331 }
332
333 if (hash.hash_type == EC_VBOOT_HASH_TYPE_SHA256)
334 printf("type: SHA-256\n");
335 else
336 printf("type: %d\n", hash.hash_type);
337
338 printf("offset: 0x%08x\n", hash.offset);
339 printf("size: 0x%08x\n", hash.size);
340
341 printf("digest: ");
342 for (i = 0; i < hash.digest_size; i++)
343 printf("%02x", hash.hash_digest[i]);
344 printf("\n");
345 } else if (0 == strcmp("reboot", cmd)) {
346 int region;
347 enum ec_reboot_cmd cmd;
348
349 if (argc >= 3 && !strcmp(argv[2], "cold")) {
350 cmd = EC_REBOOT_COLD;
351 } else {
352 region = cros_ec_decode_region(argc - 2, argv + 2);
353 if (region == EC_FLASH_REGION_RO)
354 cmd = EC_REBOOT_JUMP_RO;
Simon Glass6f1c0432018-10-01 12:22:36 -0600355 else if (region == EC_FLASH_REGION_ACTIVE)
Moritz Fischerbfeba012016-10-04 17:08:08 -0700356 cmd = EC_REBOOT_JUMP_RW;
357 else
358 return CMD_RET_USAGE;
359 }
360
361 if (cros_ec_reboot(dev, cmd, 0)) {
362 debug("%s: Could not reboot KBC\n", __func__);
363 return 1;
364 }
365 } else if (0 == strcmp("events", cmd)) {
Simon Glass3ae33822021-01-16 14:52:29 -0700366 ret = do_show_events(dev);
Moritz Fischerbfeba012016-10-04 17:08:08 -0700367
Simon Glass3ae33822021-01-16 14:52:29 -0700368 if (ret)
369 printf("Error: %d\n", ret);
Moritz Fischerbfeba012016-10-04 17:08:08 -0700370 } else if (0 == strcmp("clrevents", cmd)) {
371 uint32_t events = 0x7fffffff;
372
373 if (argc >= 3)
374 events = simple_strtol(argv[2], NULL, 0);
375
376 if (cros_ec_clear_host_events(dev, events)) {
377 debug("%s: Could not clear host events\n", __func__);
378 return 1;
379 }
380 } else if (0 == strcmp("read", cmd)) {
381 ret = do_read_write(dev, 0, argc, argv);
382 if (ret > 0)
383 return CMD_RET_USAGE;
384 } else if (0 == strcmp("write", cmd)) {
385 ret = do_read_write(dev, 1, argc, argv);
386 if (ret > 0)
387 return CMD_RET_USAGE;
388 } else if (0 == strcmp("erase", cmd)) {
389 int region = cros_ec_decode_region(argc - 2, argv + 2);
390 uint32_t offset, size;
391
392 if (region == -1)
393 return CMD_RET_USAGE;
394 if (cros_ec_flash_offset(dev, region, &offset, &size)) {
395 debug("%s: Could not read region info\n", __func__);
396 ret = -1;
397 } else {
398 ret = cros_ec_flash_erase(dev, offset, size);
399 if (ret) {
400 debug("%s: Could not erase region\n",
401 __func__);
402 }
403 }
404 } else if (0 == strcmp("regioninfo", cmd)) {
405 int region = cros_ec_decode_region(argc - 2, argv + 2);
406 uint32_t offset, size;
407
408 if (region == -1)
409 return CMD_RET_USAGE;
410 ret = cros_ec_flash_offset(dev, region, &offset, &size);
411 if (ret) {
412 debug("%s: Could not read region info\n", __func__);
413 } else {
414 printf("Region: %s\n", region == EC_FLASH_REGION_RO ?
415 "RO" : "RW");
416 printf("Offset: %x\n", offset);
417 printf("Size: %x\n", size);
418 }
419 } else if (0 == strcmp("flashinfo", cmd)) {
420 struct ec_response_flash_info p;
421
422 ret = cros_ec_read_flashinfo(dev, &p);
423 if (!ret) {
424 printf("Flash size: %u\n", p.flash_size);
425 printf("Write block size: %u\n", p.write_block_size);
426 printf("Erase block size: %u\n", p.erase_block_size);
427 }
428 } else if (0 == strcmp("vbnvcontext", cmd)) {
429 uint8_t block[EC_VBNV_BLOCK_SIZE];
430 char buf[3];
431 int i, len;
432 unsigned long result;
433
434 if (argc <= 2) {
Simon Glass6322a7b2018-10-01 12:22:22 -0600435 ret = cros_ec_read_nvdata(dev, block,
436 EC_VBNV_BLOCK_SIZE);
Moritz Fischerbfeba012016-10-04 17:08:08 -0700437 if (!ret) {
438 printf("vbnv_block: ");
439 for (i = 0; i < EC_VBNV_BLOCK_SIZE; i++)
440 printf("%02x", block[i]);
441 putc('\n');
442 }
443 } else {
444 /*
445 * TODO(clchiou): Move this to a utility function as
446 * cmd_spi might want to call it.
447 */
448 memset(block, 0, EC_VBNV_BLOCK_SIZE);
449 len = strlen(argv[2]);
450 buf[2] = '\0';
451 for (i = 0; i < EC_VBNV_BLOCK_SIZE; i++) {
452 if (i * 2 >= len)
453 break;
454 buf[0] = argv[2][i * 2];
455 if (i * 2 + 1 >= len)
456 buf[1] = '0';
457 else
458 buf[1] = argv[2][i * 2 + 1];
459 strict_strtoul(buf, 16, &result);
460 block[i] = result;
461 }
Simon Glass6322a7b2018-10-01 12:22:22 -0600462 ret = cros_ec_write_nvdata(dev, block,
463 EC_VBNV_BLOCK_SIZE);
Moritz Fischerbfeba012016-10-04 17:08:08 -0700464 }
465 if (ret) {
466 debug("%s: Could not %s VbNvContext\n", __func__,
467 argc <= 2 ? "read" : "write");
468 }
469 } else if (0 == strcmp("test", cmd)) {
470 int result = cros_ec_test(dev);
471
472 if (result)
473 printf("Test failed with error %d\n", result);
474 else
475 puts("Test passed\n");
476 } else if (0 == strcmp("version", cmd)) {
477 struct ec_response_get_version *p;
478 char *build_string;
479
480 ret = cros_ec_read_version(dev, &p);
481 if (!ret) {
482 /* Print versions */
483 printf("RO version: %1.*s\n",
484 (int)sizeof(p->version_string_ro),
485 p->version_string_ro);
486 printf("RW version: %1.*s\n",
487 (int)sizeof(p->version_string_rw),
488 p->version_string_rw);
489 printf("Firmware copy: %s\n",
490 (p->current_image <
491 ARRAY_SIZE(ec_current_image_name) ?
492 ec_current_image_name[p->current_image] :
493 "?"));
494 ret = cros_ec_read_build_info(dev, &build_string);
495 if (!ret)
496 printf("Build info: %s\n", build_string);
497 }
498 } else if (0 == strcmp("ldo", cmd)) {
499 uint8_t index, state;
500 char *endp;
501
502 if (argc < 3)
503 return CMD_RET_USAGE;
Simon Glass0b1284e2021-07-24 09:03:30 -0600504 index = dectoul(argv[2], &endp);
Moritz Fischerbfeba012016-10-04 17:08:08 -0700505 if (*argv[2] == 0 || *endp != 0)
506 return CMD_RET_USAGE;
507 if (argc > 3) {
Simon Glass0b1284e2021-07-24 09:03:30 -0600508 state = dectoul(argv[3], &endp);
Moritz Fischerbfeba012016-10-04 17:08:08 -0700509 if (*argv[3] == 0 || *endp != 0)
510 return CMD_RET_USAGE;
Simon Glass6322a7b2018-10-01 12:22:22 -0600511 ret = cros_ec_set_ldo(dev, index, state);
Moritz Fischerbfeba012016-10-04 17:08:08 -0700512 } else {
Simon Glass6322a7b2018-10-01 12:22:22 -0600513 ret = cros_ec_get_ldo(dev, index, &state);
Moritz Fischerbfeba012016-10-04 17:08:08 -0700514 if (!ret) {
515 printf("LDO%d: %s\n", index,
516 state == EC_LDO_STATE_ON ?
517 "on" : "off");
518 }
519 }
520
521 if (ret) {
522 debug("%s: Could not access LDO%d\n", __func__, index);
523 return ret;
524 }
Simon Glass7791df52021-01-16 14:52:25 -0700525 } else if (!strcmp("sku", cmd)) {
526 ret = cros_ec_get_sku_id(dev);
527
528 if (ret >= 0) {
529 printf("%d\n", ret);
530 ret = 0;
531 } else {
532 printf("Error: %d\n", ret);
533 }
Moritz Fischerbfeba012016-10-04 17:08:08 -0700534 } else {
535 return CMD_RET_USAGE;
536 }
537
538 if (ret < 0) {
539 printf("Error: CROS-EC command failed (error %d)\n", ret);
540 ret = 1;
541 }
542
543 return ret;
544}
545
546U_BOOT_CMD(
547 crosec, 6, 1, do_cros_ec,
548 "CROS-EC utility command",
549 "init Re-init CROS-EC (done on startup automatically)\n"
550 "crosec id Read CROS-EC ID\n"
551 "crosec info Read CROS-EC info\n"
Simon Glass8aec32f2021-01-16 14:52:26 -0700552 "crosec features Read CROS-EC features\n"
Simon Glass3a6c9942021-01-16 14:52:28 -0700553 "crosec switches Read CROS-EC switches\n"
Moritz Fischerbfeba012016-10-04 17:08:08 -0700554 "crosec curimage Read CROS-EC current image\n"
555 "crosec hash Read CROS-EC hash\n"
556 "crosec reboot [rw | ro | cold] Reboot CROS-EC\n"
557 "crosec events Read CROS-EC host events\n"
Simon Glass3ae33822021-01-16 14:52:29 -0700558 "crosec eventsb Read CROS-EC host events_b\n"
Moritz Fischerbfeba012016-10-04 17:08:08 -0700559 "crosec clrevents [mask] Clear CROS-EC host events\n"
560 "crosec regioninfo <ro|rw> Read image info\n"
561 "crosec flashinfo Read flash info\n"
562 "crosec erase <ro|rw> Erase EC image\n"
563 "crosec read <ro|rw> <addr> [<size>] Read EC image\n"
564 "crosec write <ro|rw> <addr> [<size>] Write EC image\n"
565 "crosec vbnvcontext [hexstring] Read [write] VbNvContext from EC\n"
566 "crosec ldo <idx> [<state>] Switch/Read LDO state\n"
Simon Glass7791df52021-01-16 14:52:25 -0700567 "crosec sku Read board SKU ID\n"
Moritz Fischerbfeba012016-10-04 17:08:08 -0700568 "crosec test run tests on cros_ec\n"
569 "crosec version Read CROS-EC version"
570);