drivers/core/root.c

   1 // SPDX-License-Identifier: GPL-2.0+
   2 /*
   3  * Copyright (c) 2013 Google, Inc
   4  *
   5  * (C) Copyright 2012
   6  * Pavel Herrmann <morpheus.ibis@gmail.com>
   7  */
   8
   9 #define LOG_CATEGORY UCLASS_ROOT
  10
  11 #include <common.h>
  12 #include <errno.h>
  13 #include <fdtdec.h>
  14 #include <log.h>
  15 #include <malloc.h>
  16 #include <asm-generic/sections.h>
  17 #include <asm/global_data.h>
  18 #include <linux/libfdt.h>
  19 #include <dm/acpi.h>
  20 #include <dm/device.h>
  21 #include <dm/device-internal.h>
  22 #include <dm/lists.h>
  23 #include <dm/of.h>
  24 #include <dm/of_access.h>
  25 #include <dm/platdata.h>
  26 #include <dm/read.h>
  27 #include <dm/root.h>
  28 #include <dm/uclass.h>
  29 #include <dm/uclass-internal.h>
  30 #include <dm/util.h>
  31 #include <linux/list.h>
  32
  33 DECLARE_GLOBAL_DATA_PTR;
  34
  35 static struct driver_info root_info = {
  36         .name           = "root_driver",
  37 };
  38
  39 struct udevice *dm_root(void)
  40 {
  41         if (!gd->dm_root) {
  42                 dm_warn("Virtual root driver does not exist!\n");
  43                 return NULL;
  44         }
  45
  46         return gd->dm_root;
  47 }
  48
  49 void dm_fixup_for_gd_move(struct global_data *new_gd)
  50 {
  51         /* The sentinel node has moved, so update things that point to it */
  52         if (gd->dm_root) {
  53                 new_gd->uclass_root->next->prev = new_gd->uclass_root;
  54                 new_gd->uclass_root->prev->next = new_gd->uclass_root;
  55         }
  56 }
  57
  58 void fix_drivers(void)
  59 {
  60         struct driver *drv =
  61                 ll_entry_start(struct driver, driver);
  62         const int n_ents = ll_entry_count(struct driver, driver);
  63         struct driver *entry;
  64
  65         for (entry = drv; entry != drv + n_ents; entry++) {
  66                 if (entry->of_match)
  67                         entry->of_match = (const struct udevice_id *)
  68                                 ((ulong)entry->of_match + gd->reloc_off);
  69                 if (entry->bind)
  70                         entry->bind += gd->reloc_off;
  71                 if (entry->probe)
  72                         entry->probe += gd->reloc_off;
  73                 if (entry->remove)
  74                         entry->remove += gd->reloc_off;
  75                 if (entry->unbind)
  76                         entry->unbind += gd->reloc_off;
  77                 if (entry->of_to_plat)
  78                         entry->of_to_plat += gd->reloc_off;
  79                 if (entry->child_post_bind)
  80                         entry->child_post_bind += gd->reloc_off;
  81                 if (entry->child_pre_probe)
  82                         entry->child_pre_probe += gd->reloc_off;
  83                 if (entry->child_post_remove)
  84                         entry->child_post_remove += gd->reloc_off;
  85                 /* OPS are fixed in every uclass post_probe function */
  86                 if (entry->ops)
  87                         entry->ops += gd->reloc_off;
  88         }
  89 }
  90
  91 void fix_uclass(void)
  92 {
  93         struct uclass_driver *uclass =
  94                 ll_entry_start(struct uclass_driver, uclass_driver);
  95         const int n_ents = ll_entry_count(struct uclass_driver, uclass_driver);
  96         struct uclass_driver *entry;
  97
  98         for (entry = uclass; entry != uclass + n_ents; entry++) {
  99                 if (entry->post_bind)
 100                         entry->post_bind += gd->reloc_off;
 101                 if (entry->pre_unbind)
 102                         entry->pre_unbind += gd->reloc_off;
 103                 if (entry->pre_probe)
 104                         entry->pre_probe += gd->reloc_off;
 105                 if (entry->post_probe)
 106                         entry->post_probe += gd->reloc_off;
 107                 if (entry->pre_remove)
 108                         entry->pre_remove += gd->reloc_off;
 109                 if (entry->child_post_bind)
 110                         entry->child_post_bind += gd->reloc_off;
 111                 if (entry->child_pre_probe)
 112                         entry->child_pre_probe += gd->reloc_off;
 113                 if (entry->init)
 114                         entry->init += gd->reloc_off;
 115                 if (entry->destroy)
 116                         entry->destroy += gd->reloc_off;
 117         }
 118 }
 119
 120 void fix_devices(void)
 121 {
 122         struct driver_info *dev =
 123                 ll_entry_start(struct driver_info, driver_info);
 124         const int n_ents = ll_entry_count(struct driver_info, driver_info);
 125         struct driver_info *entry;
 126
 127         for (entry = dev; entry != dev + n_ents; entry++) {
 128                 if (entry->plat)
 129                         entry->plat += gd->reloc_off;
 130         }
 131 }
 132
 133 static int dm_setup_inst(void)
 134 {
 135         DM_ROOT_NON_CONST = DM_DEVICE_GET(root);
 136
 137         if (CONFIG_IS_ENABLED(OF_PLATDATA_RT)) {
 138                 struct udevice_rt *urt;
 139                 void *base;
 140                 int n_ents;
 141                 uint size;
 142
 143                 /* Allocate the udevice_rt table */
 144                 n_ents = ll_entry_count(struct udevice, udevice);
 145                 urt = calloc(n_ents, sizeof(struct udevice_rt));
 146                 if (!urt)
 147                         return log_msg_ret("urt", -ENOMEM);
 148                 gd_set_dm_udevice_rt(urt);
 149
 150                 /* Now allocate space for the priv/plat data, and copy it in */
 151                 size = __priv_data_end - __priv_data_start;
 152
 153                 base = calloc(1, size);
 154                 if (!base)
 155                         return log_msg_ret("priv", -ENOMEM);
 156                 memcpy(base, __priv_data_start, size);
 157                 gd_set_dm_priv_base(base);
 158         }
 159
 160         return 0;
 161 }
 162
 163 int dm_init(bool of_live)
 164 {
 165         int ret;
 166
 167         if (gd->dm_root) {
 168                 dm_warn("Virtual root driver already exists!\n");
 169                 return -EINVAL;
 170         }
 171         if (CONFIG_IS_ENABLED(OF_PLATDATA_INST)) {
 172                 gd->uclass_root = &uclass_head;
 173         } else {
 174                 gd->uclass_root = &DM_UCLASS_ROOT_S_NON_CONST;
 175                 INIT_LIST_HEAD(DM_UCLASS_ROOT_NON_CONST);
 176         }
 177
 178         if (IS_ENABLED(CONFIG_NEEDS_MANUAL_RELOC)) {
 179                 fix_drivers();
 180                 fix_uclass();
 181                 fix_devices();
 182         }
 183
 184         if (CONFIG_IS_ENABLED(OF_PLATDATA_INST)) {
 185                 ret = dm_setup_inst();
 186                 if (ret) {
 187                         log_debug("dm_setup_inst() failed: %d\n", ret);
 188                         return ret;
 189                 }
 190         } else {
 191                 ret = device_bind_by_name(NULL, false, &root_info,
 192                                           &DM_ROOT_NON_CONST);
 193                 if (ret)
 194                         return ret;
 195                 if (CONFIG_IS_ENABLED(OF_CONTROL))
 196                         dev_set_ofnode(DM_ROOT_NON_CONST, ofnode_root());
 197                 ret = device_probe(DM_ROOT_NON_CONST);
 198                 if (ret)
 199                         return ret;
 200         }
 201
 202         INIT_LIST_HEAD((struct list_head *)&gd->dmtag_list);
 203
 204         return 0;
 205 }
 206
 207 int dm_uninit(void)
 208 {
 209         /* Remove non-vital devices first */
 210         device_remove(dm_root(), DM_REMOVE_NON_VITAL);
 211         device_remove(dm_root(), DM_REMOVE_NORMAL);
 212         device_unbind(dm_root());
 213         gd->dm_root = NULL;
 214
 215         return 0;
 216 }
 217
 218 #if CONFIG_IS_ENABLED(DM_DEVICE_REMOVE)
 219 int dm_remove_devices_flags(uint flags)
 220 {
 221         device_remove(dm_root(), flags);
 222
 223         return 0;
 224 }
 225 #endif
 226
 227 int dm_scan_plat(bool pre_reloc_only)
 228 {
 229         int ret;
 230
 231         if (CONFIG_IS_ENABLED(OF_PLATDATA_DRIVER_RT)) {
 232                 struct driver_rt *dyn;
 233                 int n_ents;
 234
 235                 n_ents = ll_entry_count(struct driver_info, driver_info);
 236                 dyn = calloc(n_ents, sizeof(struct driver_rt));
 237                 if (!dyn)
 238                         return -ENOMEM;
 239                 gd_set_dm_driver_rt(dyn);
 240         }
 241
 242         ret = lists_bind_drivers(DM_ROOT_NON_CONST, pre_reloc_only);
 243         if (ret == -ENOENT) {
 244                 dm_warn("Some drivers were not found\n");
 245                 ret = 0;
 246         }
 247
 248         return ret;
 249 }
 250
 251 #if CONFIG_IS_ENABLED(OF_REAL)
 252 /**
 253  * dm_scan_fdt_node() - Scan the device tree and bind drivers for a node
 254  *
 255  * This scans the subnodes of a device tree node and and creates a driver
 256  * for each one.
 257  *
 258  * @parent: Parent device for the devices that will be created
 259  * @node: Node to scan
 260  * @pre_reloc_only: If true, bind only drivers with the DM_FLAG_PRE_RELOC
 261  * flag. If false bind all drivers.
 262  * Return: 0 if OK, -ve on error
 263  */
 264 static int dm_scan_fdt_node(struct udevice *parent, ofnode parent_node,
 265                             bool pre_reloc_only)
 266 {
 267         int ret = 0, err = 0;
 268         ofnode node;
 269
 270         if (!ofnode_valid(parent_node))
 271                 return 0;
 272
 273         for (node = ofnode_first_subnode(parent_node);
 274              ofnode_valid(node);
 275              node = ofnode_next_subnode(node)) {
 276                 const char *node_name = ofnode_get_name(node);
 277
 278                 if (!ofnode_is_enabled(node)) {
 279                         pr_debug("   - ignoring disabled device\n");
 280                         continue;
 281                 }
 282                 err = lists_bind_fdt(parent, node, NULL, NULL, pre_reloc_only);
 283                 if (err && !ret) {
 284                         ret = err;
 285                         debug("%s: ret=%d\n", node_name, ret);
 286                 }
 287         }
 288
 289         if (ret)
 290                 dm_warn("Some drivers failed to bind\n");
 291
 292         return ret;
 293 }
 294
 295 int dm_scan_fdt_dev(struct udevice *dev)
 296 {
 297         return dm_scan_fdt_node(dev, dev_ofnode(dev),
 298                                 gd->flags & GD_FLG_RELOC ? false : true);
 299 }
 300
 301 int dm_scan_fdt(bool pre_reloc_only)
 302 {
 303         return dm_scan_fdt_node(gd->dm_root, ofnode_root(), pre_reloc_only);
 304 }
 305
 306 static int dm_scan_fdt_ofnode_path(const char *path, bool pre_reloc_only)
 307 {
 308         ofnode node;
 309
 310         node = ofnode_path(path);
 311
 312         return dm_scan_fdt_node(gd->dm_root, node, pre_reloc_only);
 313 }
 314
 315 int dm_extended_scan(bool pre_reloc_only)
 316 {
 317         int ret, i;
 318         const char * const nodes[] = {
 319                 "/chosen",
 320                 "/clocks",
 321                 "/firmware"
 322         };
 323
 324         ret = dm_scan_fdt(pre_reloc_only);
 325         if (ret) {
 326                 debug("dm_scan_fdt() failed: %d\n", ret);
 327                 return ret;
 328         }
 329
 330         /* Some nodes aren't devices themselves but may contain some */
 331         for (i = 0; i < ARRAY_SIZE(nodes); i++) {
 332                 ret = dm_scan_fdt_ofnode_path(nodes[i], pre_reloc_only);
 333                 if (ret) {
 334                         debug("dm_scan_fdt() scan for %s failed: %d\n",
 335                               nodes[i], ret);
 336                         return ret;
 337                 }
 338         }
 339
 340         return ret;
 341 }
 342 #endif
 343
 344 __weak int dm_scan_other(bool pre_reloc_only)
 345 {
 346         return 0;
 347 }
 348
 349 #if CONFIG_IS_ENABLED(OF_PLATDATA_INST) && CONFIG_IS_ENABLED(READ_ONLY)
 350 void *dm_priv_to_rw(void *priv)
 351 {
 352         long offset = priv - (void *)__priv_data_start;
 353
 354         return gd_dm_priv_base() + offset;
 355 }
 356 #endif
 357
 358 /**
 359  * dm_scan() - Scan tables to bind devices
 360  *
 361  * Runs through the driver_info tables and binds the devices it finds. Then runs
 362  * through the devicetree nodes. Finally calls dm_scan_other() to add any
 363  * special devices
 364  *
 365  * @pre_reloc_only: If true, bind only nodes with special devicetree properties,
 366  * or drivers with the DM_FLAG_PRE_RELOC flag. If false bind all drivers.
 367  */
 368 static int dm_scan(bool pre_reloc_only)
 369 {
 370         int ret;
 371
 372         ret = dm_scan_plat(pre_reloc_only);
 373         if (ret) {
 374                 debug("dm_scan_plat() failed: %d\n", ret);
 375                 return ret;
 376         }
 377
 378         if (CONFIG_IS_ENABLED(OF_REAL)) {
 379                 ret = dm_extended_scan(pre_reloc_only);
 380                 if (ret) {
 381                         debug("dm_extended_scan() failed: %d\n", ret);
 382                         return ret;
 383                 }
 384         }
 385
 386         ret = dm_scan_other(pre_reloc_only);
 387         if (ret)
 388                 return ret;
 389
 390         return 0;
 391 }
 392
 393 int dm_init_and_scan(bool pre_reloc_only)
 394 {
 395         int ret;
 396
 397         ret = dm_init(CONFIG_IS_ENABLED(OF_LIVE));
 398         if (ret) {
 399                 debug("dm_init() failed: %d\n", ret);
 400                 return ret;
 401         }
 402         if (!CONFIG_IS_ENABLED(OF_PLATDATA_INST)) {
 403                 ret = dm_scan(pre_reloc_only);
 404                 if (ret) {
 405                         log_debug("dm_scan() failed: %d\n", ret);
 406                         return ret;
 407                 }
 408         }
 409         if (CONFIG_IS_ENABLED(DM_EVENT)) {
 410                 ret = event_notify_null(EVT_DM_POST_INIT);
 411                 if (ret)
 412                         return log_msg_ret("ev", ret);
 413         }
 414
 415         return 0;
 416 }
 417
 418 void dm_get_stats(int *device_countp, int *uclass_countp)
 419 {
 420         *device_countp = device_get_decendent_count(gd->dm_root);
 421         *uclass_countp = uclass_get_count();
 422 }
 423
 424 #ifdef CONFIG_ACPIGEN
 425 static int root_acpi_get_name(const struct udevice *dev, char *out_name)
 426 {
 427         return acpi_copy_name(out_name, "\\_SB");
 428 }
 429
 430 struct acpi_ops root_acpi_ops = {
 431         .get_name       = root_acpi_get_name,
 432 };
 433 #endif
 434
 435 /* This is the root driver - all drivers are children of this */
 436 U_BOOT_DRIVER(root_driver) = {
 437         .name   = "root_driver",
 438         .id     = UCLASS_ROOT,
 439         ACPI_OPS_PTR(&root_acpi_ops)
 440 };
 441
 442 /* This is the root uclass */
 443 UCLASS_DRIVER(root) = {
 444         .name   = "root",
 445         .id     = UCLASS_ROOT,
 446 };