Merge tag 'dm-pull-22nov22' of https://source.denx.de/u-boot/custodians/u-boot-dm
[platform/kernel/u-boot.git] / cmd / fdt.c
1 // SPDX-License-Identifier: GPL-2.0+
2 /*
3  * (C) Copyright 2007
4  * Gerald Van Baren, Custom IDEAS, vanbaren@cideas.com
5  * Based on code written by:
6  *   Pantelis Antoniou <pantelis.antoniou@gmail.com> and
7  *   Matthew McClintock <msm@freescale.com>
8  */
9
10 #include <common.h>
11 #include <command.h>
12 #include <env.h>
13 #include <image.h>
14 #include <linux/ctype.h>
15 #include <linux/types.h>
16 #include <asm/global_data.h>
17 #include <linux/libfdt.h>
18 #include <fdt_support.h>
19 #include <mapmem.h>
20 #include <asm/io.h>
21
22 #define MAX_LEVEL       32              /* how deeply nested we will go */
23 #define SCRATCHPAD      1024            /* bytes of scratchpad memory */
24
25 /*
26  * Global data (for the gd->bd)
27  */
28 DECLARE_GLOBAL_DATA_PTR;
29
30 static int fdt_parse_prop(char *const*newval, int count, char *data, int *len);
31 static int fdt_print(const char *pathp, char *prop, int depth);
32 static int is_printable_string(const void *data, int len);
33
34 /*
35  * The working_fdt points to our working flattened device tree.
36  */
37 struct fdt_header *working_fdt;
38
39 void set_working_fdt_addr(ulong addr)
40 {
41         void *buf;
42
43         printf("Working FDT set to %lx\n", addr);
44         buf = map_sysmem(addr, 0);
45         working_fdt = buf;
46         env_set_hex("fdtaddr", addr);
47 }
48
49 /*
50  * Get a value from the fdt and format it to be set in the environment
51  */
52 static int fdt_value_env_set(const void *nodep, int len,
53                              const char *var, int index)
54 {
55         if (is_printable_string(nodep, len)) {
56                 const char *nodec = (const char *)nodep;
57                 int i;
58
59                 /*
60                  * Iterate over all members in stringlist and find the one at
61                  * offset $index. If no such index exists, indicate failure.
62                  */
63                 for (i = 0; i < len; ) {
64                         if (index-- > 0) {
65                                 i += strlen(nodec) + 1;
66                                 nodec += strlen(nodec) + 1;
67                                 continue;
68                         }
69
70                         env_set(var, nodec);
71                         return 0;
72                 }
73
74                 return 1;
75         } else if (len == 4) {
76                 char buf[11];
77
78                 sprintf(buf, "0x%08X", fdt32_to_cpu(*(fdt32_t *)nodep));
79                 env_set(var, buf);
80         } else if (len%4 == 0 && len <= 20) {
81                 /* Needed to print things like sha1 hashes. */
82                 char buf[41];
83                 int i;
84
85                 for (i = 0; i < len; i += sizeof(unsigned int))
86                         sprintf(buf + (i * 2), "%08x",
87                                 *(unsigned int *)(nodep + i));
88                 env_set(var, buf);
89         } else {
90                 printf("error: unprintable value\n");
91                 return 1;
92         }
93         return 0;
94 }
95
96 static const char * const fdt_member_table[] = {
97         "magic",
98         "totalsize",
99         "off_dt_struct",
100         "off_dt_strings",
101         "off_mem_rsvmap",
102         "version",
103         "last_comp_version",
104         "boot_cpuid_phys",
105         "size_dt_strings",
106         "size_dt_struct",
107 };
108
109 static int fdt_get_header_value(int argc, char *const argv[])
110 {
111         fdt32_t *fdtp = (fdt32_t *)working_fdt;
112         ulong val;
113         int i;
114
115         if (argv[2][0] != 'g')
116                 return CMD_RET_FAILURE;
117
118         for (i = 0; i < ARRAY_SIZE(fdt_member_table); i++) {
119                 if (strcmp(fdt_member_table[i], argv[4]))
120                         continue;
121
122                 val = fdt32_to_cpu(fdtp[i]);
123                 env_set_hex(argv[3], val);
124                 return CMD_RET_SUCCESS;
125         }
126
127         return CMD_RET_FAILURE;
128 }
129
130 /*
131  * Flattened Device Tree command, see the help for parameter definitions.
132  */
133 static int do_fdt(struct cmd_tbl *cmdtp, int flag, int argc, char *const argv[])
134 {
135         if (argc < 2)
136                 return CMD_RET_USAGE;
137
138         /* fdt addr: Set the address of the fdt */
139         if (strncmp(argv[1], "ad", 2) == 0) {
140                 unsigned long addr;
141                 int control = 0;
142                 int quiet = 0;
143                 struct fdt_header *blob;
144
145                 /* Set the address [and length] of the fdt */
146                 argc -= 2;
147                 argv += 2;
148                 while (argc > 0 && **argv == '-') {
149                         char *arg = *argv;
150
151                         while (*++arg) {
152                                 switch (*arg) {
153                                 case 'c':
154                                         control = 1;
155                                         break;
156                                 case 'q':
157                                         quiet = 1;
158                                         break;
159                                 default:
160                                         return CMD_RET_USAGE;
161                                 }
162                         }
163                         argc--;
164                         argv++;
165                 }
166                 if (argc == 0) {
167                         if (control)
168                                 blob = (struct fdt_header *)gd->fdt_blob;
169                         else
170                                 blob = working_fdt;
171                         if (!blob || !fdt_valid(&blob))
172                                 return 1;
173                         printf("%s fdt: %08lx\n",
174                                control ? "Control" : "Working",
175                                control ? (ulong)map_to_sysmem(blob) :
176                                env_get_hex("fdtaddr", 0));
177                         return 0;
178                 }
179
180                 addr = hextoul(argv[0], NULL);
181                 blob = map_sysmem(addr, 0);
182                 if ((quiet && fdt_check_header(blob)) ||
183                     (!quiet && !fdt_valid(&blob)))
184                         return 1;
185                 if (control)
186                         gd->fdt_blob = blob;
187                 else
188                         set_working_fdt_addr(addr);
189
190                 if (argc >= 2) {
191                         int  len;
192                         int  err;
193
194                         /* Optional new length */
195                         len = hextoul(argv[1], NULL);
196                         if (len < fdt_totalsize(blob)) {
197                                 if (!quiet)
198                                         printf("New length %d < existing length %d, ignoring\n",
199                                                len, fdt_totalsize(blob));
200                         } else {
201                                 /* Open in place with a new length */
202                                 err = fdt_open_into(blob, blob, len);
203                                 if (!quiet && err != 0) {
204                                         printf("libfdt fdt_open_into(): %s\n",
205                                                fdt_strerror(err));
206                                 }
207                         }
208                 }
209
210                 return CMD_RET_SUCCESS;
211         }
212
213         if (!working_fdt) {
214                 puts("No FDT memory address configured. Please configure\n"
215                      "the FDT address via \"fdt addr <address>\" command.\n"
216                      "Aborting!\n");
217                 return CMD_RET_FAILURE;
218         }
219
220         /*
221          * Move the working_fdt
222          */
223         if (strncmp(argv[1], "mo", 2) == 0) {
224                 struct fdt_header *newaddr;
225                 int  len;
226                 int  err;
227
228                 if (argc < 4)
229                         return CMD_RET_USAGE;
230
231                 /*
232                  * Set the address and length of the fdt.
233                  */
234                 working_fdt = (struct fdt_header *)hextoul(argv[2], NULL);
235                 if (!fdt_valid(&working_fdt))
236                         return 1;
237
238                 newaddr = (struct fdt_header *)hextoul(argv[3], NULL);
239
240                 /*
241                  * If the user specifies a length, use that.  Otherwise use the
242                  * current length.
243                  */
244                 if (argc <= 4) {
245                         len = fdt_totalsize(working_fdt);
246                 } else {
247                         len = hextoul(argv[4], NULL);
248                         if (len < fdt_totalsize(working_fdt)) {
249                                 printf ("New length 0x%X < existing length "
250                                         "0x%X, aborting.\n",
251                                         len, fdt_totalsize(working_fdt));
252                                 return 1;
253                         }
254                 }
255
256                 /*
257                  * Copy to the new location.
258                  */
259                 err = fdt_open_into(working_fdt, newaddr, len);
260                 if (err != 0) {
261                         printf ("libfdt fdt_open_into(): %s\n",
262                                 fdt_strerror(err));
263                         return 1;
264                 }
265                 set_working_fdt_addr((ulong)newaddr);
266 #ifdef CONFIG_OF_SYSTEM_SETUP
267         /* Call the board-specific fixup routine */
268         } else if (strncmp(argv[1], "sys", 3) == 0) {
269                 int err = ft_system_setup(working_fdt, gd->bd);
270
271                 if (err) {
272                         printf("Failed to add system information to FDT: %s\n",
273                                fdt_strerror(err));
274                         return CMD_RET_FAILURE;
275                 }
276 #endif
277         /*
278          * Make a new node
279          */
280         } else if (strncmp(argv[1], "mk", 2) == 0) {
281                 char *pathp;            /* path */
282                 char *nodep;            /* new node to add */
283                 int  nodeoffset;        /* node offset from libfdt */
284                 int  err;
285
286                 /*
287                  * Parameters: Node path, new node to be appended to the path.
288                  */
289                 if (argc < 4)
290                         return CMD_RET_USAGE;
291
292                 pathp = argv[2];
293                 nodep = argv[3];
294
295                 nodeoffset = fdt_path_offset (working_fdt, pathp);
296                 if (nodeoffset < 0) {
297                         /*
298                          * Not found or something else bad happened.
299                          */
300                         printf ("libfdt fdt_path_offset() returned %s\n",
301                                 fdt_strerror(nodeoffset));
302                         return 1;
303                 }
304                 err = fdt_add_subnode(working_fdt, nodeoffset, nodep);
305                 if (err < 0) {
306                         printf ("libfdt fdt_add_subnode(): %s\n",
307                                 fdt_strerror(err));
308                         return 1;
309                 }
310
311         /*
312          * Set the value of a property in the working_fdt.
313          */
314         } else if (strncmp(argv[1], "se", 2) == 0) {
315                 char *pathp;            /* path */
316                 char *prop;             /* property */
317                 int  nodeoffset;        /* node offset from libfdt */
318                 static char data[SCRATCHPAD] __aligned(4);/* property storage */
319                 const void *ptmp;
320                 int  len;               /* new length of the property */
321                 int  ret;               /* return value */
322
323                 /*
324                  * Parameters: Node path, property, optional value.
325                  */
326                 if (argc < 4)
327                         return CMD_RET_USAGE;
328
329                 pathp  = argv[2];
330                 prop   = argv[3];
331
332                 nodeoffset = fdt_path_offset (working_fdt, pathp);
333                 if (nodeoffset < 0) {
334                         /*
335                          * Not found or something else bad happened.
336                          */
337                         printf ("libfdt fdt_path_offset() returned %s\n",
338                                 fdt_strerror(nodeoffset));
339                         return 1;
340                 }
341
342                 if (argc == 4) {
343                         len = 0;
344                 } else {
345                         ptmp = fdt_getprop(working_fdt, nodeoffset, prop, &len);
346                         if (len > SCRATCHPAD) {
347                                 printf("prop (%d) doesn't fit in scratchpad!\n",
348                                        len);
349                                 return 1;
350                         }
351                         if (ptmp != NULL)
352                                 memcpy(data, ptmp, len);
353
354                         ret = fdt_parse_prop(&argv[4], argc - 4, data, &len);
355                         if (ret != 0)
356                                 return ret;
357                 }
358
359                 ret = fdt_setprop(working_fdt, nodeoffset, prop, data, len);
360                 if (ret < 0) {
361                         printf ("libfdt fdt_setprop(): %s\n", fdt_strerror(ret));
362                         return 1;
363                 }
364
365         /********************************************************************
366          * Get the value of a property in the working_fdt.
367          ********************************************************************/
368         } else if (argv[1][0] == 'g') {
369                 char *subcmd;           /* sub-command */
370                 char *pathp;            /* path */
371                 char *prop;             /* property */
372                 char *var;              /* variable to store result */
373                 int  nodeoffset;        /* node offset from libfdt */
374                 const void *nodep;      /* property node pointer */
375                 int  len = 0;           /* new length of the property */
376
377                 /*
378                  * Parameters: Node path, property, optional value.
379                  */
380                 if (argc < 5)
381                         return CMD_RET_USAGE;
382
383                 subcmd = argv[2];
384
385                 if (argc < 6 && subcmd[0] != 's')
386                         return CMD_RET_USAGE;
387
388                 var    = argv[3];
389                 pathp  = argv[4];
390                 prop   = argv[5];
391
392                 nodeoffset = fdt_path_offset(working_fdt, pathp);
393                 if (nodeoffset < 0) {
394                         /*
395                          * Not found or something else bad happened.
396                          */
397                         printf("libfdt fdt_path_offset() returned %s\n",
398                                 fdt_strerror(nodeoffset));
399                         return 1;
400                 }
401
402                 if (subcmd[0] == 'n' || (subcmd[0] == 's' && argc == 5)) {
403                         int req_index = -1;
404                         int startDepth = fdt_node_depth(
405                                 working_fdt, nodeoffset);
406                         int curDepth = startDepth;
407                         int cur_index = -1;
408                         int nextNodeOffset = fdt_next_node(
409                                 working_fdt, nodeoffset, &curDepth);
410
411                         if (subcmd[0] == 'n')
412                                 req_index = hextoul(argv[5], NULL);
413
414                         while (curDepth > startDepth) {
415                                 if (curDepth == startDepth + 1)
416                                         cur_index++;
417                                 if (subcmd[0] == 'n' &&
418                                     cur_index == req_index) {
419                                         const char *node_name;
420
421                                         node_name = fdt_get_name(working_fdt,
422                                                                  nextNodeOffset,
423                                                                  NULL);
424                                         env_set(var, node_name);
425                                         return 0;
426                                 }
427                                 nextNodeOffset = fdt_next_node(
428                                         working_fdt, nextNodeOffset, &curDepth);
429                                 if (nextNodeOffset < 0)
430                                         break;
431                         }
432                         if (subcmd[0] == 's') {
433                                 /* get the num nodes at this level */
434                                 env_set_ulong(var, cur_index + 1);
435                         } else {
436                                 /* node index not found */
437                                 printf("libfdt node not found\n");
438                                 return 1;
439                         }
440                 } else {
441                         nodep = fdt_getprop(
442                                 working_fdt, nodeoffset, prop, &len);
443                         if (len == 0) {
444                                 /* no property value */
445                                 env_set(var, "");
446                                 return 0;
447                         } else if (nodep && len > 0) {
448                                 if (subcmd[0] == 'v') {
449                                         int index = 0;
450                                         int ret;
451
452                                         if (argc == 7)
453                                                 index = simple_strtoul(argv[6], NULL, 10);
454
455                                         ret = fdt_value_env_set(nodep, len,
456                                                                 var, index);
457                                         if (ret != 0)
458                                                 return ret;
459                                 } else if (subcmd[0] == 'a') {
460                                         /* Get address */
461                                         char buf[11];
462
463                                         sprintf(buf, "0x%p", nodep);
464                                         env_set(var, buf);
465                                 } else if (subcmd[0] == 's') {
466                                         /* Get size */
467                                         char buf[11];
468
469                                         sprintf(buf, "0x%08X", len);
470                                         env_set(var, buf);
471                                 } else
472                                         return CMD_RET_USAGE;
473                                 return 0;
474                         } else {
475                                 printf("libfdt fdt_getprop(): %s\n",
476                                         fdt_strerror(len));
477                                 return 1;
478                         }
479                 }
480
481         /*
482          * Print (recursive) / List (single level)
483          */
484         } else if ((argv[1][0] == 'p') || (argv[1][0] == 'l')) {
485                 int depth = MAX_LEVEL;  /* how deep to print */
486                 char *pathp;            /* path */
487                 char *prop;             /* property */
488                 int  ret;               /* return value */
489                 static char root[2] = "/";
490
491                 /*
492                  * list is an alias for print, but limited to 1 level
493                  */
494                 if (argv[1][0] == 'l') {
495                         depth = 1;
496                 }
497
498                 /*
499                  * Get the starting path.  The root node is an oddball,
500                  * the offset is zero and has no name.
501                  */
502                 if (argc == 2)
503                         pathp = root;
504                 else
505                         pathp = argv[2];
506                 if (argc > 3)
507                         prop = argv[3];
508                 else
509                         prop = NULL;
510
511                 ret = fdt_print(pathp, prop, depth);
512                 if (ret != 0)
513                         return ret;
514
515         /*
516          * Remove a property/node
517          */
518         } else if (strncmp(argv[1], "rm", 2) == 0) {
519                 int  nodeoffset;        /* node offset from libfdt */
520                 int  err;
521
522                 /*
523                  * Get the path.  The root node is an oddball, the offset
524                  * is zero and has no name.
525                  */
526                 nodeoffset = fdt_path_offset (working_fdt, argv[2]);
527                 if (nodeoffset < 0) {
528                         /*
529                          * Not found or something else bad happened.
530                          */
531                         printf ("libfdt fdt_path_offset() returned %s\n",
532                                 fdt_strerror(nodeoffset));
533                         return 1;
534                 }
535                 /*
536                  * Do the delete.  A fourth parameter means delete a property,
537                  * otherwise delete the node.
538                  */
539                 if (argc > 3) {
540                         err = fdt_delprop(working_fdt, nodeoffset, argv[3]);
541                         if (err < 0) {
542                                 printf("libfdt fdt_delprop():  %s\n",
543                                         fdt_strerror(err));
544                                 return err;
545                         }
546                 } else {
547                         err = fdt_del_node(working_fdt, nodeoffset);
548                         if (err < 0) {
549                                 printf("libfdt fdt_del_node():  %s\n",
550                                         fdt_strerror(err));
551                                 return err;
552                         }
553                 }
554
555         /*
556          * Display header info
557          */
558         } else if (argv[1][0] == 'h') {
559                 if (argc == 5)
560                         return fdt_get_header_value(argc, argv);
561
562                 u32 version = fdt_version(working_fdt);
563                 printf("magic:\t\t\t0x%x\n", fdt_magic(working_fdt));
564                 printf("totalsize:\t\t0x%x (%d)\n", fdt_totalsize(working_fdt),
565                        fdt_totalsize(working_fdt));
566                 printf("off_dt_struct:\t\t0x%x\n",
567                        fdt_off_dt_struct(working_fdt));
568                 printf("off_dt_strings:\t\t0x%x\n",
569                        fdt_off_dt_strings(working_fdt));
570                 printf("off_mem_rsvmap:\t\t0x%x\n",
571                        fdt_off_mem_rsvmap(working_fdt));
572                 printf("version:\t\t%d\n", version);
573                 printf("last_comp_version:\t%d\n",
574                        fdt_last_comp_version(working_fdt));
575                 if (version >= 2)
576                         printf("boot_cpuid_phys:\t0x%x\n",
577                                 fdt_boot_cpuid_phys(working_fdt));
578                 if (version >= 3)
579                         printf("size_dt_strings:\t0x%x\n",
580                                 fdt_size_dt_strings(working_fdt));
581                 if (version >= 17)
582                         printf("size_dt_struct:\t\t0x%x\n",
583                                 fdt_size_dt_struct(working_fdt));
584                 printf("number mem_rsv:\t\t0x%x\n",
585                        fdt_num_mem_rsv(working_fdt));
586                 printf("\n");
587
588         /*
589          * Set boot cpu id
590          */
591         } else if (strncmp(argv[1], "boo", 3) == 0) {
592                 unsigned long tmp = hextoul(argv[2], NULL);
593                 fdt_set_boot_cpuid_phys(working_fdt, tmp);
594
595         /*
596          * memory command
597          */
598         } else if (strncmp(argv[1], "me", 2) == 0) {
599                 uint64_t addr, size;
600                 int err;
601                 addr = simple_strtoull(argv[2], NULL, 16);
602                 size = simple_strtoull(argv[3], NULL, 16);
603                 err = fdt_fixup_memory(working_fdt, addr, size);
604                 if (err < 0)
605                         return err;
606
607         /*
608          * mem reserve commands
609          */
610         } else if (strncmp(argv[1], "rs", 2) == 0) {
611                 if (argv[2][0] == 'p') {
612                         uint64_t addr, size;
613                         int total = fdt_num_mem_rsv(working_fdt);
614                         int j, err;
615                         printf("index\t\t   start\t\t    size\n");
616                         printf("-------------------------------"
617                                 "-----------------\n");
618                         for (j = 0; j < total; j++) {
619                                 err = fdt_get_mem_rsv(working_fdt, j, &addr, &size);
620                                 if (err < 0) {
621                                         printf("libfdt fdt_get_mem_rsv():  %s\n",
622                                                         fdt_strerror(err));
623                                         return err;
624                                 }
625                                 printf("    %x\t%08x%08x\t%08x%08x\n", j,
626                                         (u32)(addr >> 32),
627                                         (u32)(addr & 0xffffffff),
628                                         (u32)(size >> 32),
629                                         (u32)(size & 0xffffffff));
630                         }
631                 } else if (argv[2][0] == 'a') {
632                         uint64_t addr, size;
633                         int err;
634                         addr = simple_strtoull(argv[3], NULL, 16);
635                         size = simple_strtoull(argv[4], NULL, 16);
636                         err = fdt_add_mem_rsv(working_fdt, addr, size);
637
638                         if (err < 0) {
639                                 printf("libfdt fdt_add_mem_rsv():  %s\n",
640                                         fdt_strerror(err));
641                                 return err;
642                         }
643                 } else if (argv[2][0] == 'd') {
644                         unsigned long idx = hextoul(argv[3], NULL);
645                         int err = fdt_del_mem_rsv(working_fdt, idx);
646
647                         if (err < 0) {
648                                 printf("libfdt fdt_del_mem_rsv():  %s\n",
649                                         fdt_strerror(err));
650                                 return err;
651                         }
652                 } else {
653                         /* Unrecognized command */
654                         return CMD_RET_USAGE;
655                 }
656         }
657 #ifdef CONFIG_OF_BOARD_SETUP
658         /* Call the board-specific fixup routine */
659         else if (strncmp(argv[1], "boa", 3) == 0) {
660                 int err = ft_board_setup(working_fdt, gd->bd);
661
662                 if (err) {
663                         printf("Failed to update board information in FDT: %s\n",
664                                fdt_strerror(err));
665                         return CMD_RET_FAILURE;
666                 }
667 #ifdef CONFIG_ARCH_KEYSTONE
668                 ft_board_setup_ex(working_fdt, gd->bd);
669 #endif
670         }
671 #endif
672         /* Create a chosen node */
673         else if (strncmp(argv[1], "cho", 3) == 0) {
674                 unsigned long initrd_start = 0, initrd_end = 0;
675
676                 if ((argc != 2) && (argc != 4))
677                         return CMD_RET_USAGE;
678
679                 if (argc == 4) {
680                         initrd_start = hextoul(argv[2], NULL);
681                         initrd_end = initrd_start + hextoul(argv[3], NULL) - 1;
682                 }
683
684                 fdt_chosen(working_fdt);
685                 fdt_initrd(working_fdt, initrd_start, initrd_end);
686
687 #if defined(CONFIG_FIT_SIGNATURE)
688         } else if (strncmp(argv[1], "che", 3) == 0) {
689                 int cfg_noffset;
690                 int ret;
691                 unsigned long addr;
692                 struct fdt_header *blob;
693
694                 if (!working_fdt)
695                         return CMD_RET_FAILURE;
696
697                 if (argc > 2) {
698                         addr = hextoul(argv[2], NULL);
699                         blob = map_sysmem(addr, 0);
700                 } else {
701                         blob = (struct fdt_header *)gd->fdt_blob;
702                 }
703                 if (!fdt_valid(&blob))
704                         return 1;
705
706                 gd->fdt_blob = blob;
707                 cfg_noffset = fit_conf_get_node(working_fdt, NULL);
708                 if (!cfg_noffset) {
709                         printf("Could not find configuration node: %s\n",
710                                fdt_strerror(cfg_noffset));
711                         return CMD_RET_FAILURE;
712                 }
713
714                 ret = fit_config_verify(working_fdt, cfg_noffset);
715                 if (ret == 0)
716                         return CMD_RET_SUCCESS;
717                 else
718                         return CMD_RET_FAILURE;
719 #endif
720
721         }
722 #ifdef CONFIG_OF_LIBFDT_OVERLAY
723         /* apply an overlay */
724         else if (strncmp(argv[1], "ap", 2) == 0) {
725                 unsigned long addr;
726                 struct fdt_header *blob;
727                 int ret;
728
729                 if (argc != 3)
730                         return CMD_RET_USAGE;
731
732                 if (!working_fdt)
733                         return CMD_RET_FAILURE;
734
735                 addr = hextoul(argv[2], NULL);
736                 blob = map_sysmem(addr, 0);
737                 if (!fdt_valid(&blob))
738                         return CMD_RET_FAILURE;
739
740                 /* apply method prints messages on error */
741                 ret = fdt_overlay_apply_verbose(working_fdt, blob);
742                 if (ret)
743                         return CMD_RET_FAILURE;
744         }
745 #endif
746         /* resize the fdt */
747         else if (strncmp(argv[1], "re", 2) == 0) {
748                 uint extrasize;
749                 if (argc > 2)
750                         extrasize = hextoul(argv[2], NULL);
751                 else
752                         extrasize = 0;
753                 fdt_shrink_to_minimum(working_fdt, extrasize);
754         }
755         else {
756                 /* Unrecognized command */
757                 return CMD_RET_USAGE;
758         }
759
760         return 0;
761 }
762
763 /****************************************************************************/
764
765 /*
766  * Parse the user's input, partially heuristic.  Valid formats:
767  * <0x00112233 4 05>    - an array of cells.  Numbers follow standard
768  *                      C conventions.
769  * [00 11 22 .. nn] - byte stream
770  * "string"     - If the the value doesn't start with "<" or "[", it is
771  *                      treated as a string.  Note that the quotes are
772  *                      stripped by the parser before we get the string.
773  * newval: An array of strings containing the new property as specified
774  *      on the command line
775  * count: The number of strings in the array
776  * data: A bytestream to be placed in the property
777  * len: The length of the resulting bytestream
778  */
779 static int fdt_parse_prop(char * const *newval, int count, char *data, int *len)
780 {
781         char *cp;               /* temporary char pointer */
782         char *newp;             /* temporary newval char pointer */
783         unsigned long tmp;      /* holds converted values */
784         int stridx = 0;
785
786         *len = 0;
787         newp = newval[0];
788
789         /* An array of cells */
790         if (*newp == '<') {
791                 newp++;
792                 while ((*newp != '>') && (stridx < count)) {
793                         /*
794                          * Keep searching until we find that last ">"
795                          * That way users don't have to escape the spaces
796                          */
797                         if (*newp == '\0') {
798                                 newp = newval[++stridx];
799                                 continue;
800                         }
801
802                         cp = newp;
803                         tmp = simple_strtoul(cp, &newp, 0);
804                         if (*cp != '?')
805                                 *(fdt32_t *)data = cpu_to_fdt32(tmp);
806                         else
807                                 newp++;
808
809                         data  += 4;
810                         *len += 4;
811
812                         /* If the ptr didn't advance, something went wrong */
813                         if ((newp - cp) <= 0) {
814                                 printf("Sorry, I could not convert \"%s\"\n",
815                                         cp);
816                                 return 1;
817                         }
818
819                         while (*newp == ' ')
820                                 newp++;
821                 }
822
823                 if (*newp != '>') {
824                         printf("Unexpected character '%c'\n", *newp);
825                         return 1;
826                 }
827         } else if (*newp == '[') {
828                 /*
829                  * Byte stream.  Convert the values.
830                  */
831                 newp++;
832                 while ((stridx < count) && (*newp != ']')) {
833                         while (*newp == ' ')
834                                 newp++;
835                         if (*newp == '\0') {
836                                 newp = newval[++stridx];
837                                 continue;
838                         }
839                         if (!isxdigit(*newp))
840                                 break;
841                         tmp = hextoul(newp, &newp);
842                         *data++ = tmp & 0xFF;
843                         *len    = *len + 1;
844                 }
845                 if (*newp != ']') {
846                         printf("Unexpected character '%c'\n", *newp);
847                         return 1;
848                 }
849         } else {
850                 /*
851                  * Assume it is one or more strings.  Copy it into our
852                  * data area for convenience (including the
853                  * terminating '\0's).
854                  */
855                 while (stridx < count) {
856                         size_t length = strlen(newp) + 1;
857                         strcpy(data, newp);
858                         data += length;
859                         *len += length;
860                         newp = newval[++stridx];
861                 }
862         }
863         return 0;
864 }
865
866 /****************************************************************************/
867
868 /*
869  * Heuristic to guess if this is a string or concatenated strings.
870  */
871
872 static int is_printable_string(const void *data, int len)
873 {
874         const char *s = data;
875
876         /* zero length is not */
877         if (len == 0)
878                 return 0;
879
880         /* must terminate with zero or '\n' */
881         if (s[len - 1] != '\0' && s[len - 1] != '\n')
882                 return 0;
883
884         /* printable or a null byte (concatenated strings) */
885         while (((*s == '\0') || isprint(*s) || isspace(*s)) && (len > 0)) {
886                 /*
887                  * If we see a null, there are three possibilities:
888                  * 1) If len == 1, it is the end of the string, printable
889                  * 2) Next character also a null, not printable.
890                  * 3) Next character not a null, continue to check.
891                  */
892                 if (s[0] == '\0') {
893                         if (len == 1)
894                                 return 1;
895                         if (s[1] == '\0')
896                                 return 0;
897                 }
898                 s++;
899                 len--;
900         }
901
902         /* Not the null termination, or not done yet: not printable */
903         if (*s != '\0' || (len != 0))
904                 return 0;
905
906         return 1;
907 }
908
909
910 /*
911  * Print the property in the best format, a heuristic guess.  Print as
912  * a string, concatenated strings, a byte, word, double word, or (if all
913  * else fails) it is printed as a stream of bytes.
914  */
915 static void print_data(const void *data, int len)
916 {
917         int j;
918         const char *env_max_dump;
919         ulong max_dump = ULONG_MAX;
920
921         /* no data, don't print */
922         if (len == 0)
923                 return;
924
925         env_max_dump = env_get("fdt_max_dump");
926         if (env_max_dump)
927                 max_dump = hextoul(env_max_dump, NULL);
928
929         /*
930          * It is a string, but it may have multiple strings (embedded '\0's).
931          */
932         if (is_printable_string(data, len)) {
933                 puts("\"");
934                 j = 0;
935                 while (j < len) {
936                         if (j > 0)
937                                 puts("\", \"");
938                         puts(data);
939                         j    += strlen(data) + 1;
940                         data += strlen(data) + 1;
941                 }
942                 puts("\"");
943                 return;
944         }
945
946         if ((len %4) == 0) {
947                 if (len > max_dump)
948                         printf("* 0x%p [0x%08x]", data, len);
949                 else {
950                         const __be32 *p;
951
952                         printf("<");
953                         for (j = 0, p = data; j < len/4; j++)
954                                 printf("0x%08x%s", fdt32_to_cpu(p[j]),
955                                         j < (len/4 - 1) ? " " : "");
956                         printf(">");
957                 }
958         } else { /* anything else... hexdump */
959                 if (len > max_dump)
960                         printf("* 0x%p [0x%08x]", data, len);
961                 else {
962                         const u8 *s;
963
964                         printf("[");
965                         for (j = 0, s = data; j < len; j++)
966                                 printf("%02x%s", s[j], j < len - 1 ? " " : "");
967                         printf("]");
968                 }
969         }
970 }
971
972 /****************************************************************************/
973
974 /*
975  * Recursively print (a portion of) the working_fdt.  The depth parameter
976  * determines how deeply nested the fdt is printed.
977  */
978 static int fdt_print(const char *pathp, char *prop, int depth)
979 {
980         static char tabs[MAX_LEVEL+1] =
981                 "\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t"
982                 "\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t";
983         const void *nodep;      /* property node pointer */
984         int  nodeoffset;        /* node offset from libfdt */
985         int  nextoffset;        /* next node offset from libfdt */
986         uint32_t tag;           /* tag */
987         int  len;               /* length of the property */
988         int  level = 0;         /* keep track of nesting level */
989         const struct fdt_property *fdt_prop;
990
991         nodeoffset = fdt_path_offset (working_fdt, pathp);
992         if (nodeoffset < 0) {
993                 /*
994                  * Not found or something else bad happened.
995                  */
996                 printf ("libfdt fdt_path_offset() returned %s\n",
997                         fdt_strerror(nodeoffset));
998                 return 1;
999         }
1000         /*
1001          * The user passed in a property as well as node path.
1002          * Print only the given property and then return.
1003          */
1004         if (prop) {
1005                 nodep = fdt_getprop (working_fdt, nodeoffset, prop, &len);
1006                 if (len == 0) {
1007                         /* no property value */
1008                         printf("%s %s\n", pathp, prop);
1009                         return 0;
1010                 } else if (nodep && len > 0) {
1011                         printf("%s = ", prop);
1012                         print_data (nodep, len);
1013                         printf("\n");
1014                         return 0;
1015                 } else {
1016                         printf ("libfdt fdt_getprop(): %s\n",
1017                                 fdt_strerror(len));
1018                         return 1;
1019                 }
1020         }
1021
1022         /*
1023          * The user passed in a node path and no property,
1024          * print the node and all subnodes.
1025          */
1026         while(level >= 0) {
1027                 tag = fdt_next_tag(working_fdt, nodeoffset, &nextoffset);
1028                 switch(tag) {
1029                 case FDT_BEGIN_NODE:
1030                         pathp = fdt_get_name(working_fdt, nodeoffset, NULL);
1031                         if (level <= depth) {
1032                                 if (pathp == NULL)
1033                                         pathp = "/* NULL pointer error */";
1034                                 if (*pathp == '\0')
1035                                         pathp = "/";    /* root is nameless */
1036                                 printf("%s%s {\n",
1037                                         &tabs[MAX_LEVEL - level], pathp);
1038                         }
1039                         level++;
1040                         if (level >= MAX_LEVEL) {
1041                                 printf("Nested too deep, aborting.\n");
1042                                 return 1;
1043                         }
1044                         break;
1045                 case FDT_END_NODE:
1046                         level--;
1047                         if (level <= depth)
1048                                 printf("%s};\n", &tabs[MAX_LEVEL - level]);
1049                         if (level == 0) {
1050                                 level = -1;             /* exit the loop */
1051                         }
1052                         break;
1053                 case FDT_PROP:
1054                         fdt_prop = fdt_offset_ptr(working_fdt, nodeoffset,
1055                                         sizeof(*fdt_prop));
1056                         pathp    = fdt_string(working_fdt,
1057                                         fdt32_to_cpu(fdt_prop->nameoff));
1058                         len      = fdt32_to_cpu(fdt_prop->len);
1059                         nodep    = fdt_prop->data;
1060                         if (len < 0) {
1061                                 printf ("libfdt fdt_getprop(): %s\n",
1062                                         fdt_strerror(len));
1063                                 return 1;
1064                         } else if (len == 0) {
1065                                 /* the property has no value */
1066                                 if (level <= depth)
1067                                         printf("%s%s;\n",
1068                                                 &tabs[MAX_LEVEL - level],
1069                                                 pathp);
1070                         } else {
1071                                 if (level <= depth) {
1072                                         printf("%s%s = ",
1073                                                 &tabs[MAX_LEVEL - level],
1074                                                 pathp);
1075                                         print_data (nodep, len);
1076                                         printf(";\n");
1077                                 }
1078                         }
1079                         break;
1080                 case FDT_NOP:
1081                         printf("%s/* NOP */\n", &tabs[MAX_LEVEL - level]);
1082                         break;
1083                 case FDT_END:
1084                         return 1;
1085                 default:
1086                         if (level <= depth)
1087                                 printf("Unknown tag 0x%08X\n", tag);
1088                         return 1;
1089                 }
1090                 nodeoffset = nextoffset;
1091         }
1092         return 0;
1093 }
1094
1095 /********************************************************************/
1096 #ifdef CONFIG_SYS_LONGHELP
1097 static char fdt_help_text[] =
1098         "addr [-c] [-q] <addr> [<size>]  - Set the [control] fdt location to <addr>\n"
1099 #ifdef CONFIG_OF_LIBFDT_OVERLAY
1100         "fdt apply <addr>                    - Apply overlay to the DT\n"
1101 #endif
1102 #ifdef CONFIG_OF_BOARD_SETUP
1103         "fdt boardsetup                      - Do board-specific set up\n"
1104 #endif
1105 #ifdef CONFIG_OF_SYSTEM_SETUP
1106         "fdt systemsetup                     - Do system-specific set up\n"
1107 #endif
1108         "fdt move   <fdt> <newaddr> <length> - Copy the fdt to <addr> and make it active\n"
1109         "fdt resize [<extrasize>]            - Resize fdt to size + padding to 4k addr + some optional <extrasize> if needed\n"
1110         "fdt print  <path> [<prop>]          - Recursive print starting at <path>\n"
1111         "fdt list   <path> [<prop>]          - Print one level starting at <path>\n"
1112         "fdt get value <var> <path> <prop> [<index>] - Get <property> and store in <var>\n"
1113         "                                      In case of stringlist property, use optional <index>\n"
1114         "                                      to select string within the stringlist. Default is 0.\n"
1115         "fdt get name <var> <path> <index>   - Get name of node <index> and store in <var>\n"
1116         "fdt get addr <var> <path> <prop>    - Get start address of <property> and store in <var>\n"
1117         "fdt get size <var> <path> [<prop>]  - Get size of [<property>] or num nodes and store in <var>\n"
1118         "fdt set    <path> <prop> [<val>]    - Set <property> [to <val>]\n"
1119         "fdt mknode <path> <node>            - Create a new node after <path>\n"
1120         "fdt rm     <path> [<prop>]          - Delete the node or <property>\n"
1121         "fdt header [get <var> <member>]     - Display header info\n"
1122         "                                      get - get header member <member> and store it in <var>\n"
1123         "fdt bootcpu <id>                    - Set boot cpuid\n"
1124         "fdt memory <addr> <size>            - Add/Update memory node\n"
1125         "fdt rsvmem print                    - Show current mem reserves\n"
1126         "fdt rsvmem add <addr> <size>        - Add a mem reserve\n"
1127         "fdt rsvmem delete <index>           - Delete a mem reserves\n"
1128         "fdt chosen [<start> <size>]         - Add/update the /chosen branch in the tree\n"
1129         "                                        <start>/<size> - initrd start addr/size\n"
1130 #if defined(CONFIG_FIT_SIGNATURE)
1131         "fdt checksign [<addr>]              - check FIT signature\n"
1132         "                                        <start> - addr of key blob\n"
1133         "                                                  default gd->fdt_blob\n"
1134 #endif
1135         "NOTE: Dereference aliases by omitting the leading '/', "
1136                 "e.g. fdt print ethernet0.";
1137 #endif
1138
1139 U_BOOT_CMD(
1140         fdt,    255,    0,      do_fdt,
1141         "flattened device tree utility commands", fdt_help_text
1142 );