drivers/core/Kconfig

   1 menu "Generic Driver Options"
   2
   3 config DM
   4         def_bool y
   5         help
   6           This config option enables Driver Model. This brings in the core
   7           support, including scanning of platform data on start-up. If
   8           CONFIG_OF_CONTROL is enabled, the device tree will be scanned also
   9           when available.
  10
  11 config SPL_DM
  12         bool "Enable Driver Model for SPL"
  13         depends on DM && SPL
  14         help
  15           Enable driver model in SPL. You will need to provide a
  16           suitable malloc() implementation. If you are not using the
  17           full malloc() enabled by CFG_SYS_SPL_MALLOC_START,
  18           consider using CONFIG_SPL_SYS_MALLOC_SIMPLE. In that case you
  19           must provide CONFIG_SPL_SYS_MALLOC_F_LEN to set the size.
  20           In most cases driver model will only allocate a few uclasses
  21           and devices in SPL, so 1KB should be enough. See
  22           CONFIG_SPL_SYS_MALLOC_F_LEN for more details on how to enable it.
  23
  24 config TPL_DM
  25         bool "Enable Driver Model for TPL"
  26         depends on DM && TPL
  27         help
  28           Enable driver model in TPL. You will need to provide a
  29           suitable malloc() implementation. If you are not using the
  30           full malloc() enabled by CFG_SYS_SPL_MALLOC_START,
  31           consider using CONFIG_TPL_SYS_MALLOC_SIMPLE. In that case you
  32           must provide CONFIG_SPL_SYS_MALLOC_F_LEN to set the size.
  33           In most cases driver model will only allocate a few uclasses
  34           and devices in SPL, so 1KB should be enough. See
  35           CONFIG_SPL_SYS_MALLOC_F_LEN for more details on how to enable it.
  36           Disable this for very small implementations.
  37
  38 config VPL_DM
  39         bool "Enable Driver Model for VPL"
  40         depends on DM && VPL
  41         default y if SPL_DM
  42         help
  43           Enable driver model in VPL. You will need to provide a
  44           suitable malloc() implementation. If you are not using the
  45           full malloc() enabled by CFG_SYS_SPL_MALLOC_START,
  46           consider using CONFIG_SPL_SYS_MALLOC_SIMPLE.
  47
  48 config DM_WARN
  49         bool "Enable warnings in driver model"
  50         depends on DM
  51         default y
  52         help
  53           Enable this to see warnings related to driver model.
  54
  55           Warnings may help with debugging, such as when expected devices do
  56           not bind correctly. If the option is disabled, dm_warn() is compiled
  57           out - it will do nothing when called.
  58
  59 config SPL_DM_WARN
  60         bool "Enable warnings in driver model wuth SPL"
  61         depends on SPL_DM
  62         help
  63           Enable this to see warnings related to driver model in SPL
  64
  65           The dm_warn() function can use up quite a bit of space for its
  66           strings. By default this is disabled for SPL builds to save space.
  67
  68           Warnings may help with debugging, such as when expected devices do
  69           not bind correctly. If the option is disabled, dm_warn() is compiled
  70           out - it will do nothing when called.
  71
  72 config DM_DEBUG
  73         bool "Enable debug messages in driver model core"
  74         depends on DM
  75         help
  76           Say Y here if you want to compile in debug messages in DM core.
  77
  78 config DM_STATS
  79         bool "Collect and show driver model stats"
  80         depends on DM
  81         default y if SANDBOX
  82         help
  83           Enable this to collect and display memory statistics about driver
  84           model. This can help to figure out where all the memory is going and
  85           to find optimisations.
  86
  87           To display the memory stats, use the 'dm mem' command.
  88
  89 config SPL_DM_STATS
  90         bool "Collect and show driver model stats in SPL"
  91         depends on DM_SPL
  92         help
  93           Enable this to collect and display memory statistics about driver
  94           model. This can help to figure out where all the memory is going and
  95           to find optimisations.
  96
  97           The stats are displayed just before SPL boots to the next phase.
  98
  99 config DM_DEVICE_REMOVE
 100         bool "Support device removal"
 101         depends on DM
 102         default y
 103         help
 104           We can save some code space by dropping support for removing a
 105           device.
 106
 107           Note that this may have undesirable results in the USB subsystem as
 108           it causes unplugged devices to linger around in the dm-tree, and it
 109           causes USB host controllers to not be stopped when booting the OS.
 110
 111 config DM_EVENT
 112         bool
 113         depends on DM
 114         select EVENT
 115         help
 116           This enables support for generating events related to driver model
 117           operations, such as prbing or removing a device. Subsystems can
 118           register a 'spy' function that is called when the event occurs. Such
 119           subsystems must select this option.
 120
 121 config SPL_DM_DEVICE_REMOVE
 122         bool "Support device removal in SPL"
 123         depends on SPL_DM
 124         help
 125           We can save some code space by dropping support for removing a
 126           device. This is not normally required in SPL, so by default this
 127           option is disabled for SPL.
 128
 129 config DM_STDIO
 130         bool "Support stdio registration"
 131         depends on DM
 132         default y
 133         help
 134           Normally serial drivers register with stdio so that they can be used
 135           as normal output devices. In SPL we don't normally use stdio, so
 136           we can omit this feature.
 137
 138 config DM_SEQ_ALIAS
 139         bool "Support numbered aliases in device tree"
 140         depends on DM
 141         default y
 142         help
 143           Most boards will have a '/aliases' node containing the path to
 144           numbered devices (e.g. serial0 = &serial0). This feature can be
 145           disabled if it is not required.
 146
 147 config SPL_DM_SEQ_ALIAS
 148         bool "Support numbered aliases in device tree in SPL"
 149         depends on SPL_DM
 150         help
 151           Most boards will have a '/aliases' node containing the path to
 152           numbered devices (e.g. serial0 = &serial0). This feature can be
 153           disabled if it is not required, to save code space in SPL.
 154
 155 config VPL_DM_SEQ_ALIAS
 156         bool "Support numbered aliases in device tree in VPL"
 157         depends on VPL_DM
 158         default y
 159         help
 160           Most boards will have a '/aliases' node containing the path to
 161           numbered devices (e.g. serial0 = &serial0). This feature can be
 162           disabled if it is not required, to save code space in VPL.
 163
 164 config SPL_DM_INLINE_OFNODE
 165         bool "Inline some ofnode functions which are seldom used in SPL"
 166         depends on SPL_DM
 167         default y
 168         help
 169           This applies to several ofnode functions (see ofnode.h) which are
 170           seldom used. Inlining them can help reduce code size.
 171
 172 config TPL_DM_INLINE_OFNODE
 173         bool "Inline some ofnode functions which are seldom used in TPL"
 174         depends on TPL_DM
 175         default y
 176         help
 177           This applies to several ofnode functions (see ofnode.h) which are
 178           seldom used. Inlining them can help reduce code size.
 179
 180 config DM_DMA
 181         bool "Support per-device DMA constraints"
 182         depends on DM
 183         help
 184           Enable this to extract per-device DMA constraints, only supported on
 185           device-tree systems for now. This is needed in order translate
 186           addresses on systems where different buses have different views of
 187           the physical address space.
 188
 189 config REGMAP
 190         bool "Support register maps"
 191         depends on DM
 192         help
 193           Hardware peripherals tend to have one or more sets of registers
 194           which can be accessed to control the hardware. A register map
 195           models this with a simple read/write interface. It can in principle
 196           support any bus type (I2C, SPI) but so far this only supports
 197           direct memory access.
 198
 199 config SPL_REGMAP
 200         bool "Support register maps in SPL"
 201         depends on SPL_DM
 202         help
 203           Hardware peripherals tend to have one or more sets of registers
 204           which can be accessed to control the hardware. A register map
 205           models this with a simple read/write interface. It can in principle
 206           support any bus type (I2C, SPI) but so far this only supports
 207           direct memory access.
 208
 209 config TPL_REGMAP
 210         bool "Support register maps in TPL"
 211         depends on TPL_DM
 212         help
 213           Hardware peripherals tend to have one or more sets of registers
 214           which can be accessed to control the hardware. A register map
 215           models this with a simple read/write interface. It can in principle
 216           support any bus type (I2C, SPI) but so far this only supports
 217           direct memory access.
 218
 219 config VPL_REGMAP
 220         bool "Support register maps in VPL"
 221         depends on VPL_DM
 222         help
 223           Hardware peripherals tend to have one or more sets of registers
 224           which can be accessed to control the hardware. A register map
 225           models this with a simple read/write interface. It can in principle
 226           support any bus type (I2C, SPI) but so far this only supports
 227           direct memory access.
 228
 229 config SYSCON
 230         bool "Support system controllers"
 231         depends on REGMAP
 232         help
 233           Many SoCs have a number of system controllers which are dealt with
 234           as a group by a single driver. Some common functionality is provided
 235           by this uclass, including accessing registers via regmap and
 236           assigning a unique number to each.
 237
 238 config SPL_SYSCON
 239         bool "Support system controllers in SPL"
 240         depends on SPL_REGMAP
 241         help
 242           Many SoCs have a number of system controllers which are dealt with
 243           as a group by a single driver. Some common functionality is provided
 244           by this uclass, including accessing registers via regmap and
 245           assigning a unique number to each.
 246
 247 config TPL_SYSCON
 248         bool "Support system controllers in TPL"
 249         depends on TPL_REGMAP
 250         help
 251           Many SoCs have a number of system controllers which are dealt with
 252           as a group by a single driver. Some common functionality is provided
 253           by this uclass, including accessing registers via regmap and
 254           assigning a unique number to each.
 255
 256 config VPL_SYSCON
 257         bool "Support system controllers in VPL"
 258         depends on VPL_REGMAP
 259         help
 260           Many SoCs have a number of system controllers which are dealt with
 261           as a group by a single driver. Some common functionality is provided
 262           by this uclass, including accessing registers via regmap and
 263           assigning a unique number to each.
 264
 265 config DEVRES
 266         bool "Managed device resources"
 267         depends on DM
 268         help
 269           This option enables the Managed device resources core support.
 270           Device resources managed by the devres framework are automatically
 271           released whether initialization fails half-way or the device gets
 272           detached.
 273
 274           If this option is disabled, devres functions fall back to
 275           non-managed variants.  For example, devres_alloc() to kzalloc(),
 276           devm_kmalloc() to kmalloc(), etc.
 277
 278 config DEBUG_DEVRES
 279         bool "Managed device resources debugging functions"
 280         depends on DEVRES
 281         help
 282           If this option is enabled, devres debug messages are printed.
 283           Also, a function is available to dump a list of device resources.
 284           Select this if you are having a problem with devres or want to
 285           debug resource management for a managed device.
 286
 287           If you are unsure about this, Say N here.
 288
 289 config SIMPLE_BUS
 290         bool "Support simple-bus driver"
 291         depends on DM && OF_CONTROL
 292         default y
 293         help
 294           Supports the 'simple-bus' driver, which is used on some systems.
 295
 296 config SPL_SIMPLE_BUS
 297         bool "Support simple-bus driver in SPL"
 298         depends on SPL_DM && SPL_OF_CONTROL
 299         default y
 300         help
 301           Supports the 'simple-bus' driver, which is used on some systems
 302           in SPL.
 303
 304 config SIMPLE_BUS_CORRECT_RANGE
 305         bool "Decode the 'simple-bus' <range> by honoring the #address-cells and #size-cells"
 306         depends on SIMPLE_BUS
 307         default y if SANDBOX
 308         help
 309           Decoding the 'simple-bus' <range> by honoring the #address-cells
 310           and #size-cells of parent/child bus. If unset, #address-cells of
 311           parent bus is assumed to be 1, #address-cells and #size-cells of
 312           child bus is also assumed to be 1, to save some spaces of using
 313           an advanced API to decode the <range>, which benefits SPL image
 314           builds that have size limits.
 315
 316           If you are unsure about this, Say N here.
 317
 318 config SIMPLE_PM_BUS
 319         bool "Support simple-pm-bus driver"
 320         depends on DM && OF_CONTROL && CLK && POWER_DOMAIN
 321         help
 322           Supports the 'simple-pm-bus' driver, which is used for busses that
 323           have power domains and/or clocks which need to be enabled before use.
 324
 325 config OF_TRANSLATE
 326         bool "Translate addresses using fdt_translate_address"
 327         depends on DM && OF_CONTROL
 328         default y
 329         help
 330           If this option is enabled, the reg property will be translated
 331           using the fdt_translate_address() function. This is necessary
 332           on some platforms (e.g. MVEBU) using complex "ranges"
 333           properties in many nodes. As this translation is not handled
 334           correctly in the default simple_bus_translate() function.
 335
 336           If this option is not enabled, simple_bus_translate() will be
 337           used for the address translation. This function is faster and
 338           smaller in size than fdt_translate_address().
 339
 340 config SPL_OF_TRANSLATE
 341         bool "Translate addresses using fdt_translate_address in SPL"
 342         depends on SPL_DM && SPL_OF_CONTROL
 343         help
 344           If this option is enabled, the reg property will be translated
 345           using the fdt_translate_address() function. This is necessary
 346           on some platforms (e.g. MVEBU) using complex "ranges"
 347           properties in many nodes. As this translation is not handled
 348           correctly in the default simple_bus_translate() function.
 349
 350           If this option is not enabled, simple_bus_translate() will be
 351           used for the address translation. This function is faster and
 352           smaller in size than fdt_translate_address().
 353
 354 config TPL_OF_TRANSLATE
 355         bool "Translate addresses using fdt_translate_address in TPL"
 356         depends on TPL_DM && TPL_OF_CONTROL
 357         help
 358           If this option is enabled, the reg property will be translated
 359           using the fdt_translate_address() function. This is necessary
 360           on some platforms (e.g. MVEBU) using complex "ranges"
 361           properties in many nodes. As this translation is not handled
 362           correctly in the default simple_bus_translate() function.
 363
 364           If this option is not enabled, simple_bus_translate() will be
 365           used for the address translation. This function is faster and
 366           smaller in size than fdt_translate_address()
 367
 368 config VPL_OF_TRANSLATE
 369         bool "Translate addresses using fdt_translate_address in SPL"
 370         depends on SPL_DM && VPL_OF_CONTROL
 371         help
 372           If this option is enabled, the reg property will be translated
 373           using the fdt_translate_address() function. This is necessary
 374           on some platforms (e.g. MVEBU) using complex "ranges"
 375           properties in many nodes. As this translation is not handled
 376           correctly in the default simple_bus_translate() function.
 377
 378           If this option is not enabled, simple_bus_translate() will be
 379           used for the address translation. This function is faster and
 380           smaller in size than fdt_translate_address().
 381
 382 config TRANSLATION_OFFSET
 383         bool "Platforms specific translation offset"
 384         depends on DM && OF_CONTROL
 385         help
 386           Some platforms need a special address translation. Those
 387           platforms (e.g. mvebu in SPL) can configure a translation
 388           offset by enabling this option and setting the translation_offset
 389           variable in the GD in their platform- / board-specific code.
 390
 391 config OF_ISA_BUS
 392         bool
 393         depends on OF_TRANSLATE
 394         help
 395           Is this option is enabled then support for the ISA bus will
 396           be included for addresses read from DT. This is something that
 397           should be known to be required or not based upon the board
 398           being targeted, and whether or not it makes use of an ISA bus.
 399
 400           The bus is matched based upon its node name equalling "isa". The
 401           busses #address-cells should equal 2, with the first cell being
 402           used to hold flags & flag 0x1 indicating that the address range
 403           should be accessed using I/O port in/out accessors. The second
 404           cell holds the offset into ISA bus address space. The #size-cells
 405           property should equal 1, and of course holds the size of the
 406           address range used by a device.
 407
 408           If this option is not enabled then support for the ISA bus is
 409           not included and any such busses used in DT will be treated as
 410           typical simple-bus compatible busses. This will lead to
 411           mistranslation of device addresses, so ensure that this is
 412           enabled if your board does include an ISA bus.
 413
 414 config DM_DEV_READ_INLINE
 415         bool
 416         default y if !OF_LIVE
 417
 418 config OFNODE_MULTI_TREE
 419         bool "Allow the ofnode interface to access any tree"
 420         default y if EVENT && !DM_DEV_READ_INLINE && !DM_INLINE_OFNODE
 421         help
 422           Normally U-Boot makes use of its control FDT, the one used to bind
 423           devices and provide options. In some cases, U-Boot must also process
 424           a separate FDT, e.g. one provided by the operating system, which
 425           needs additions to the /chosen node.
 426
 427           This works fine with live tree (OF_LIVE), but with flat tree the
 428           offset provided in ofnode is only useful with the control FDT. This
 429           option adds a 'tree ID' to the offset, so that multiple trees can
 430           be used. Call oftree_from_fdt() to register a new tree.
 431
 432 config OFNODE_MULTI_TREE_MAX
 433         int "Maximum number of FDTs"
 434         range 2 8
 435         depends on OFNODE_MULTI_TREE
 436         default 4
 437         help
 438           Sets the maximum number of device trees which can be used with the
 439           ofnode interface when using flat trees (OF_LIVE). This is only
 440           available in U-Boot proper and only after relocation.
 441
 442 config ACPIGEN
 443         bool "Support ACPI table generation in driver model"
 444         default y if SANDBOX || (GENERATE_ACPI_TABLE && !QEMU)
 445         select LIB_UUID
 446         help
 447           This option enables generation of ACPI tables using driver-model
 448           devices. It adds a new operation struct to each driver, to support
 449           things like generating device-specific tables and returning the ACPI
 450           name of a device.
 451
 452 config BOUNCE_BUFFER
 453         bool "Include bounce buffer API"
 454         help
 455           Some peripherals support DMA from a subset of physically
 456           addressable memory only.  To support such peripherals, the
 457           bounce buffer API uses a temporary buffer: it copies data
 458           to/from DMA regions while managing cache operations.
 459
 460           A second possible use of bounce buffers is their ability to
 461           provide aligned buffers for DMA operations.
 462
 463 endmenu