Merge branch '2019-10-28-azure-ci-support'
[oweals/u-boot.git] / common / bootstage.c
index d2bbe635e8e0ed8e27644885a56f4b3d0cfb3ed5..56ef91ad85995dde2addef0be43694e4ed3813f6 100644 (file)
+// SPDX-License-Identifier: GPL-2.0+
 /*
  * Copyright (c) 2011, Google Inc. All rights reserved.
- *
- * See file CREDITS for list of people who contributed to this
- * project.
- *
- * This program is free software; you can redistribute it and/or
- * modify it under the terms of the GNU General Public License as
- * published by the Free Software Foundation; either version 2 of
- * the License, or (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with this program; if not, write to the Free Software
- * Foundation, Inc., 59 Temple Place, Suite 330, Boston,
- * MA 02111-1307 USA
  */
 
 
 /*
  * This module records the progress of boot and arbitrary commands, and
  * permits accurate timestamping of each.
- *
- * TBD: Pass timings to kernel in the FDT
  */
 
 #include <common.h>
-#include <libfdt.h>
+#include <linux/libfdt.h>
+#include <malloc.h>
+#include <linux/compiler.h>
 
 DECLARE_GLOBAL_DATA_PTR;
 
-enum bootstage_flags {
-       BOOTSTAGEF_ERROR        = 1 << 0,       /* Error record */
-       BOOTSTAGEF_ALLOC        = 1 << 1,       /* Allocate an id */
+enum {
+       RECORD_COUNT = CONFIG_VAL(BOOTSTAGE_RECORD_COUNT),
 };
 
 struct bootstage_record {
        ulong time_us;
+       uint32_t start_us;
        const char *name;
        int flags;              /* see enum bootstage_flags */
        enum bootstage_id id;
 };
 
-static struct bootstage_record record[BOOTSTAGE_ID_COUNT] = { {1} };
-static int next_id = BOOTSTAGE_ID_USER;
+struct bootstage_data {
+       uint rec_count;
+       uint next_id;
+       struct bootstage_record record[RECORD_COUNT];
+};
+
+enum {
+       BOOTSTAGE_VERSION       = 0,
+       BOOTSTAGE_MAGIC         = 0xb00757a3,
+       BOOTSTAGE_DIGITS        = 9,
+};
+
+struct bootstage_hdr {
+       uint32_t version;       /* BOOTSTAGE_VERSION */
+       uint32_t count;         /* Number of records */
+       uint32_t size;          /* Total data size (non-zero if valid) */
+       uint32_t magic;         /* Unused */
+};
+
+int bootstage_relocate(void)
+{
+       struct bootstage_data *data = gd->bootstage;
+       int i;
+
+       /*
+        * Duplicate all strings.  They may point to an old location in the
+        * program .text section that can eventually get trashed.
+        */
+       debug("Relocating %d records\n", data->rec_count);
+       for (i = 0; i < data->rec_count; i++)
+               data->record[i].name = strdup(data->record[i].name);
+
+       return 0;
+}
+
+struct bootstage_record *find_id(struct bootstage_data *data,
+                                enum bootstage_id id)
+{
+       struct bootstage_record *rec;
+       struct bootstage_record *end;
+
+       for (rec = data->record, end = rec + data->rec_count; rec < end;
+            rec++) {
+               if (rec->id == id)
+                       return rec;
+       }
+
+       return NULL;
+}
+
+struct bootstage_record *ensure_id(struct bootstage_data *data,
+                                  enum bootstage_id id)
+{
+       struct bootstage_record *rec;
+
+       rec = find_id(data, id);
+       if (!rec && data->rec_count < RECORD_COUNT) {
+               rec = &data->record[data->rec_count++];
+               rec->id = id;
+               return rec;
+       }
+
+       return rec;
+}
 
 ulong bootstage_add_record(enum bootstage_id id, const char *name,
-                          int flags)
+                          int flags, ulong mark)
 {
+       struct bootstage_data *data = gd->bootstage;
        struct bootstage_record *rec;
-       ulong mark = timer_get_boot_us();
 
+       /*
+        * initf_bootstage() is called very early during boot but since hang()
+        * calls bootstage_error() we can be called before bootstage is set up.
+        * Add a check to avoid this.
+        */
+       if (!data)
+               return mark;
        if (flags & BOOTSTAGEF_ALLOC)
-               id = next_id++;
+               id = data->next_id++;
 
-       if (id < BOOTSTAGE_ID_COUNT) {
-               rec = &record[id];
-
-               /* Only record the first event for each */
-               if (!rec->time_us) {
-                       rec->time_us = mark;
-                       rec->name = name;
-                       rec->flags = flags;
-                       rec->id = id;
-               }
+       /* Only record the first event for each */
+       rec = find_id(data, id);
+       if (!rec && data->rec_count < RECORD_COUNT) {
+               rec = &data->record[data->rec_count++];
+               rec->time_us = mark;
+               rec->name = name;
+               rec->flags = flags;
+               rec->id = id;
        }
 
        /* Tell the board about this progress */
        show_boot_progress(flags & BOOTSTAGEF_ERROR ? -id : id);
+
        return mark;
 }
 
 
 ulong bootstage_mark(enum bootstage_id id)
 {
-       return bootstage_add_record(id, NULL, 0);
+       return bootstage_add_record(id, NULL, 0, timer_get_boot_us());
 }
 
 ulong bootstage_error(enum bootstage_id id)
 {
-       return bootstage_add_record(id, NULL, BOOTSTAGEF_ERROR);
+       return bootstage_add_record(id, NULL, BOOTSTAGEF_ERROR,
+                                   timer_get_boot_us());
 }
 
 ulong bootstage_mark_name(enum bootstage_id id, const char *name)
@@ -91,35 +143,99 @@ ulong bootstage_mark_name(enum bootstage_id id, const char *name)
 
        if (id == BOOTSTAGE_ID_ALLOC)
                flags = BOOTSTAGEF_ALLOC;
-       return bootstage_add_record(id, name, flags);
+
+       return bootstage_add_record(id, name, flags, timer_get_boot_us());
+}
+
+ulong bootstage_mark_code(const char *file, const char *func, int linenum)
+{
+       char *str, *p;
+       __maybe_unused char *end;
+       int len = 0;
+
+       /* First work out the length we need to allocate */
+       if (linenum != -1)
+               len = 11;
+       if (func)
+               len += strlen(func);
+       if (file)
+               len += strlen(file);
+
+       str = malloc(len + 1);
+       p = str;
+       end = p + len;
+       if (file)
+               p += snprintf(p, end - p, "%s,", file);
+       if (linenum != -1)
+               p += snprintf(p, end - p, "%d", linenum);
+       if (func)
+               p += snprintf(p, end - p, ": %s", func);
+
+       return bootstage_mark_name(BOOTSTAGE_ID_ALLOC, str);
 }
 
-static void print_time(unsigned long us_time)
+uint32_t bootstage_start(enum bootstage_id id, const char *name)
 {
-       char str[15], *s;
-       int grab = 3;
+       struct bootstage_data *data = gd->bootstage;
+       struct bootstage_record *rec = ensure_id(data, id);
+       ulong start_us = timer_get_boot_us();
 
-       /* We don't seem to have %'d in U-Boot */
-       sprintf(str, "%12lu", us_time);
-       for (s = str + 3; *s; s += grab) {
-               if (s != str + 3)
-                       putc(s[-1] != ' ' ? ',' : ' ');
-               printf("%.*s", grab, s);
-               grab = 3;
+       if (rec) {
+               rec->start_us = start_us;
+               rec->name = name;
        }
+
+       return start_us;
 }
 
-static uint32_t print_time_record(enum bootstage_id id,
-                       struct bootstage_record *rec, uint32_t prev)
+uint32_t bootstage_accum(enum bootstage_id id)
+{
+       struct bootstage_data *data = gd->bootstage;
+       struct bootstage_record *rec = ensure_id(data, id);
+       uint32_t duration;
+
+       if (!rec)
+               return 0;
+       duration = (uint32_t)timer_get_boot_us() - rec->start_us;
+       rec->time_us += duration;
+
+       return duration;
+}
+
+/**
+ * Get a record name as a printable string
+ *
+ * @param buf  Buffer to put name if needed
+ * @param len  Length of buffer
+ * @param rec  Boot stage record to get the name from
+ * @return pointer to name, either from the record or pointing to buf.
+ */
+static const char *get_record_name(char *buf, int len,
+                                  const struct bootstage_record *rec)
 {
-       print_time(rec->time_us);
-       print_time(rec->time_us - prev);
        if (rec->name)
-               printf("  %s\n", rec->name);
-       else if (id >= BOOTSTAGE_ID_USER)
-               printf("  user_%d\n", id - BOOTSTAGE_ID_USER);
+               return rec->name;
+       else if (rec->id >= BOOTSTAGE_ID_USER)
+               snprintf(buf, len, "user_%d", rec->id - BOOTSTAGE_ID_USER);
        else
-               printf("  id=%d\n", id);
+               snprintf(buf, len, "id=%d", rec->id);
+
+       return buf;
+}
+
+static uint32_t print_time_record(struct bootstage_record *rec, uint32_t prev)
+{
+       char buf[20];
+
+       if (prev == -1U) {
+               printf("%11s", "");
+               print_grouped_ull(rec->time_us, BOOTSTAGE_DIGITS);
+       } else {
+               print_grouped_ull(rec->time_us, BOOTSTAGE_DIGITS);
+               print_grouped_ull(rec->time_us - prev, BOOTSTAGE_DIGITS);
+       }
+       printf("  %s\n", get_record_name(buf, sizeof(buf), rec));
+
        return rec->time_us;
 }
 
@@ -130,29 +246,269 @@ static int h_compare_record(const void *r1, const void *r2)
        return rec1->time_us > rec2->time_us ? 1 : -1;
 }
 
+#ifdef CONFIG_OF_LIBFDT
+/**
+ * Add all bootstage timings to a device tree.
+ *
+ * @param blob Device tree blob
+ * @return 0 on success, != 0 on failure.
+ */
+static int add_bootstages_devicetree(struct fdt_header *blob)
+{
+       struct bootstage_data *data = gd->bootstage;
+       int bootstage;
+       char buf[20];
+       int recnum;
+       int i;
+
+       if (!blob)
+               return 0;
+
+       /*
+        * Create the node for bootstage.
+        * The address of flat device tree is set up by the command bootm.
+        */
+       bootstage = fdt_add_subnode(blob, 0, "bootstage");
+       if (bootstage < 0)
+               return -EINVAL;
+
+       /*
+        * Insert the timings to the device tree in the reverse order so
+        * that they can be printed in the Linux kernel in the right order.
+        */
+       for (recnum = data->rec_count - 1, i = 0; recnum >= 0; recnum--, i++) {
+               struct bootstage_record *rec = &data->record[recnum];
+               int node;
+
+               if (rec->id != BOOTSTAGE_ID_AWAKE && rec->time_us == 0)
+                       continue;
+
+               node = fdt_add_subnode(blob, bootstage, simple_itoa(i));
+               if (node < 0)
+                       break;
+
+               /* add properties to the node. */
+               if (fdt_setprop_string(blob, node, "name",
+                                      get_record_name(buf, sizeof(buf), rec)))
+                       return -EINVAL;
+
+               /* Check if this is a 'mark' or 'accum' record */
+               if (fdt_setprop_cell(blob, node,
+                               rec->start_us ? "accum" : "mark",
+                               rec->time_us))
+                       return -EINVAL;
+       }
+
+       return 0;
+}
+
+int bootstage_fdt_add_report(void)
+{
+       if (add_bootstages_devicetree(working_fdt))
+               puts("bootstage: Failed to add to device tree\n");
+
+       return 0;
+}
+#endif
+
 void bootstage_report(void)
 {
-       struct bootstage_record *rec = record;
-       int id;
+       struct bootstage_data *data = gd->bootstage;
+       struct bootstage_record *rec = data->record;
        uint32_t prev;
+       int i;
 
-       puts("Timer summary in microseconds:\n");
+       printf("Timer summary in microseconds (%d records):\n",
+              data->rec_count);
        printf("%11s%11s  %s\n", "Mark", "Elapsed", "Stage");
 
-       /* Fake the first record - we could get it from early boot */
-       rec->name = "reset";
-       rec->time_us = 0;
-       prev = print_time_record(BOOTSTAGE_ID_AWAKE, rec, 0);
+       prev = print_time_record(rec, 0);
 
        /* Sort records by increasing time */
-       qsort(record, ARRAY_SIZE(record), sizeof(*rec), h_compare_record);
+       qsort(data->record, data->rec_count, sizeof(*rec), h_compare_record);
 
-       for (id = 0; id < BOOTSTAGE_ID_COUNT; id++, rec++) {
-               if (rec->time_us != 0)
-                       prev = print_time_record(rec->id, rec, prev);
+       for (i = 1, rec++; i < data->rec_count; i++, rec++) {
+               if (rec->id && !rec->start_us)
+                       prev = print_time_record(rec, prev);
        }
-       if (next_id > BOOTSTAGE_ID_COUNT)
-               printf("(Overflowed internal boot id table by %d entries\n"
-                       "- please increase CONFIG_BOOTSTAGE_USER_COUNT\n",
-                      next_id - BOOTSTAGE_ID_COUNT);
+       if (data->rec_count > RECORD_COUNT)
+               printf("Overflowed internal boot id table by %d entries\n"
+                      "Please increase CONFIG_(SPL_)BOOTSTAGE_RECORD_COUNT\n",
+                      data->rec_count - RECORD_COUNT);
+
+       puts("\nAccumulated time:\n");
+       for (i = 0, rec = data->record; i < data->rec_count; i++, rec++) {
+               if (rec->start_us)
+                       prev = print_time_record(rec, -1);
+       }
+}
+
+/**
+ * Append data to a memory buffer
+ *
+ * Write data to the buffer if there is space. Whether there is space or not,
+ * the buffer pointer is incremented.
+ *
+ * @param ptrp Pointer to buffer, updated by this function
+ * @param end  Pointer to end of buffer
+ * @param data Data to write to buffer
+ * @param size Size of data
+ */
+static void append_data(char **ptrp, char *end, const void *data, int size)
+{
+       char *ptr = *ptrp;
+
+       *ptrp += size;
+       if (*ptrp > end)
+               return;
+
+       memcpy(ptr, data, size);
+}
+
+int bootstage_stash(void *base, int size)
+{
+       const struct bootstage_data *data = gd->bootstage;
+       struct bootstage_hdr *hdr = (struct bootstage_hdr *)base;
+       const struct bootstage_record *rec;
+       char buf[20];
+       char *ptr = base, *end = ptr + size;
+       uint32_t count;
+       int i;
+
+       if (hdr + 1 > (struct bootstage_hdr *)end) {
+               debug("%s: Not enough space for bootstage hdr\n", __func__);
+               return -ENOSPC;
+       }
+
+       /* Write an arbitrary version number */
+       hdr->version = BOOTSTAGE_VERSION;
+
+       /* Count the number of records, and write that value first */
+       for (rec = data->record, i = count = 0; i < data->rec_count;
+            i++, rec++) {
+               if (rec->id != 0)
+                       count++;
+       }
+       hdr->count = count;
+       hdr->size = 0;
+       hdr->magic = BOOTSTAGE_MAGIC;
+       ptr += sizeof(*hdr);
+
+       /* Write the records, silently stopping when we run out of space */
+       for (rec = data->record, i = 0; i < data->rec_count; i++, rec++) {
+               append_data(&ptr, end, rec, sizeof(*rec));
+       }
+
+       /* Write the name strings */
+       for (rec = data->record, i = 0; i < data->rec_count; i++, rec++) {
+               const char *name;
+
+               name = get_record_name(buf, sizeof(buf), rec);
+               append_data(&ptr, end, name, strlen(name) + 1);
+       }
+
+       /* Check for buffer overflow */
+       if (ptr > end) {
+               debug("%s: Not enough space for bootstage stash\n", __func__);
+               return -ENOSPC;
+       }
+
+       /* Update total data size */
+       hdr->size = ptr - (char *)base;
+       debug("Stashed %d records\n", hdr->count);
+
+       return 0;
+}
+
+int bootstage_unstash(const void *base, int size)
+{
+       const struct bootstage_hdr *hdr = (struct bootstage_hdr *)base;
+       struct bootstage_data *data = gd->bootstage;
+       const char *ptr = base, *end = ptr + size;
+       struct bootstage_record *rec;
+       uint rec_size;
+       int i;
+
+       if (size == -1)
+               end = (char *)(~(uintptr_t)0);
+
+       if (hdr + 1 > (struct bootstage_hdr *)end) {
+               debug("%s: Not enough space for bootstage hdr\n", __func__);
+               return -EPERM;
+       }
+
+       if (hdr->magic != BOOTSTAGE_MAGIC) {
+               debug("%s: Invalid bootstage magic\n", __func__);
+               return -ENOENT;
+       }
+
+       if (ptr + hdr->size > end) {
+               debug("%s: Bootstage data runs past buffer end\n", __func__);
+               return -ENOSPC;
+       }
+
+       if (hdr->count * sizeof(*rec) > hdr->size) {
+               debug("%s: Bootstage has %d records needing %lu bytes, but "
+                       "only %d bytes is available\n", __func__, hdr->count,
+                     (ulong)hdr->count * sizeof(*rec), hdr->size);
+               return -ENOSPC;
+       }
+
+       if (hdr->version != BOOTSTAGE_VERSION) {
+               debug("%s: Bootstage data version %#0x unrecognised\n",
+                     __func__, hdr->version);
+               return -EINVAL;
+       }
+
+       if (data->rec_count + hdr->count > RECORD_COUNT) {
+               debug("%s: Bootstage has %d records, we have space for %d\n"
+                       "Please increase CONFIG_(SPL_)BOOTSTAGE_RECORD_COUNT\n",
+                     __func__, hdr->count, RECORD_COUNT - data->rec_count);
+               return -ENOSPC;
+       }
+
+       ptr += sizeof(*hdr);
+
+       /* Read the records */
+       rec_size = hdr->count * sizeof(*data->record);
+       memcpy(data->record + data->rec_count, ptr, rec_size);
+
+       /* Read the name strings */
+       ptr += rec_size;
+       for (rec = data->record + data->next_id, i = 0; i < hdr->count;
+            i++, rec++) {
+               rec->name = ptr;
+
+               /* Assume no data corruption here */
+               ptr += strlen(ptr) + 1;
+       }
+
+       /* Mark the records as read */
+       data->rec_count += hdr->count;
+       debug("Unstashed %d records\n", hdr->count);
+
+       return 0;
+}
+
+int bootstage_get_size(void)
+{
+       return sizeof(struct bootstage_data);
+}
+
+int bootstage_init(bool first)
+{
+       struct bootstage_data *data;
+       int size = sizeof(struct bootstage_data);
+
+       gd->bootstage = (struct bootstage_data *)malloc(size);
+       if (!gd->bootstage)
+               return -ENOMEM;
+       data = gd->bootstage;
+       memset(data, '\0', size);
+       if (first) {
+               data->next_id = BOOTSTAGE_ID_USER;
+               bootstage_add_record(BOOTSTAGE_ID_AWAKE, "reset", 0, 0);
+       }
+
+       return 0;
 }