drivers/core/Kconfig

   1 menu "Generic Driver Options"
   2
   3 config DM
   4         bool "Enable Driver Model"
   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 CONFIG_SYS_SPL_MALLOC_START,
  18           consider using CONFIG_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 enable. 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 CONFIG_SYS_SPL_MALLOC_START,
  31           consider using CONFIG_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 DM_WARN
  39         bool "Enable warnings in driver model"
  40         depends on DM
  41         default y
  42         help
  43           Enable this to see warnings related to driver model.
  44
  45           Warnings may help with debugging, such as when expected devices do
  46           not bind correctly. If the option is disabled, dm_warn() is compiled
  47           out - it will do nothing when called.
  48
  49 config SPL_DM_WARN
  50         bool "Enable warnings in driver model wuth SPL"
  51         depends on SPL_DM
  52         help
  53           Enable this to see warnings related to driver model in SPL
  54
  55           The dm_warn() function can use up quite a bit of space for its
  56           strings. By default this is disabled for SPL builds to save space.
  57
  58           Warnings may help with debugging, such as when expected devices do
  59           not bind correctly. If the option is disabled, dm_warn() is compiled
  60           out - it will do nothing when called.
  61
  62 config DM_DEBUG
  63         bool "Enable debug messages in driver model core"
  64         depends on DM
  65         help
  66           Say Y here if you want to compile in debug messages in DM core.
  67
  68 config DM_DEVICE_REMOVE
  69         bool "Support device removal"
  70         depends on DM
  71         default y
  72         help
  73           We can save some code space by dropping support for removing a
  74           device.
  75
  76           Note that this may have undesirable results in the USB subsystem as
  77           it causes unplugged devices to linger around in the dm-tree, and it
  78           causes USB host controllers to not be stopped when booting the OS.
  79
  80 config SPL_DM_DEVICE_REMOVE
  81         bool "Support device removal in SPL"
  82         depends on SPL_DM
  83         default n
  84         help
  85           We can save some code space by dropping support for removing a
  86           device. This is not normally required in SPL, so by default this
  87           option is disabled for SPL.
  88
  89 config DM_STDIO
  90         bool "Support stdio registration"
  91         depends on DM
  92         default y
  93         help
  94           Normally serial drivers register with stdio so that they can be used
  95           as normal output devices. In SPL we don't normally use stdio, so
  96           we can omit this feature.
  97
  98 config DM_SEQ_ALIAS
  99         bool "Support numbered aliases in device tree"
 100         depends on DM
 101         default y
 102         help
 103           Most boards will have a '/aliases' node containing the path to
 104           numbered devices (e.g. serial0 = &serial0). This feature can be
 105           disabled if it is not required.
 106
 107 config SPL_DM_SEQ_ALIAS
 108         bool "Support numbered aliases in device tree in SPL"
 109         depends on SPL_DM
 110         default n
 111         help
 112           Most boards will have a '/aliases' node containing the path to
 113           numbered devices (e.g. serial0 = &serial0). This feature can be
 114           disabled if it is not required, to save code space in SPL.
 115
 116 config SPL_DM_INLINE_OFNODE
 117         bool "Inline some ofnode functions which are seldom used in SPL"
 118         depends on SPL_DM
 119         default y
 120         help
 121           This applies to several ofnode functions (see ofnode.h) which are
 122           seldom used. Inlining them can help reduce code size.
 123
 124 config TPL_DM_INLINE_OFNODE
 125         bool "Inline some ofnode functions which are seldom used in TPL"
 126         depends on TPL_DM
 127         default y
 128         help
 129           This applies to several ofnode functions (see ofnode.h) which are
 130           seldom used. Inlining them can help reduce code size.
 131
 132 config REGMAP
 133         bool "Support register maps"
 134         depends on DM
 135         help
 136           Hardware peripherals tend to have one or more sets of registers
 137           which can be accessed to control the hardware. A register map
 138           models this with a simple read/write interface. It can in principle
 139           support any bus type (I2C, SPI) but so far this only supports
 140           direct memory access.
 141
 142 config SPL_REGMAP
 143         bool "Support register maps in SPL"
 144         depends on SPL_DM
 145         help
 146           Hardware peripherals tend to have one or more sets of registers
 147           which can be accessed to control the hardware. A register map
 148           models this with a simple read/write interface. It can in principle
 149           support any bus type (I2C, SPI) but so far this only supports
 150           direct memory access.
 151
 152 config TPL_REGMAP
 153         bool "Support register maps in TPL"
 154         depends on TPL_DM
 155         help
 156           Hardware peripherals tend to have one or more sets of registers
 157           which can be accessed to control the hardware. A register map
 158           models this with a simple read/write interface. It can in principle
 159           support any bus type (I2C, SPI) but so far this only supports
 160           direct memory access.
 161
 162 config SYSCON
 163         bool "Support system controllers"
 164         depends on REGMAP
 165         help
 166           Many SoCs have a number of system controllers which are dealt with
 167           as a group by a single driver. Some common functionality is provided
 168           by this uclass, including accessing registers via regmap and
 169           assigning a unique number to each.
 170
 171 config SPL_SYSCON
 172         bool "Support system controllers in SPL"
 173         depends on SPL_REGMAP
 174         help
 175           Many SoCs have a number of system controllers which are dealt with
 176           as a group by a single driver. Some common functionality is provided
 177           by this uclass, including accessing registers via regmap and
 178           assigning a unique number to each.
 179
 180 config TPL_SYSCON
 181         bool "Support system controllers in TPL"
 182         depends on TPL_REGMAP
 183         help
 184           Many SoCs have a number of system controllers which are dealt with
 185           as a group by a single driver. Some common functionality is provided
 186           by this uclass, including accessing registers via regmap and
 187           assigning a unique number to each.
 188
 189 config DEVRES
 190         bool "Managed device resources"
 191         depends on DM
 192         help
 193           This option enables the Managed device resources core support.
 194           Device resources managed by the devres framework are automatically
 195           released whether initialization fails half-way or the device gets
 196           detached.
 197
 198           If this option is disabled, devres functions fall back to
 199           non-managed variants.  For example, devres_alloc() to kzalloc(),
 200           devm_kmalloc() to kmalloc(), etc.
 201
 202 config DEBUG_DEVRES
 203         bool "Managed device resources debugging functions"
 204         depends on DEVRES
 205         help
 206           If this option is enabled, devres debug messages are printed.
 207           Also, a function is available to dump a list of device resources.
 208           Select this if you are having a problem with devres or want to
 209           debug resource management for a managed device.
 210
 211           If you are unsure about this, Say N here.
 212
 213 config SIMPLE_BUS
 214         bool "Support simple-bus driver"
 215         depends on DM && OF_CONTROL
 216         default y
 217         help
 218           Supports the 'simple-bus' driver, which is used on some systems.
 219
 220 config SPL_SIMPLE_BUS
 221         bool "Support simple-bus driver in SPL"
 222         depends on SPL_DM && SPL_OF_CONTROL
 223         default y
 224         help
 225           Supports the 'simple-bus' driver, which is used on some systems
 226           in SPL.
 227
 228 config SIMPLE_PM_BUS
 229         bool "Support simple-pm-bus driver"
 230         depends on DM && OF_CONTROL && CLK && POWER_DOMAIN
 231         help
 232           Supports the 'simple-pm-bus' driver, which is used for busses that
 233           have power domains and/or clocks which need to be enabled before use.
 234
 235 config OF_TRANSLATE
 236         bool "Translate addresses using fdt_translate_address"
 237         depends on DM && OF_CONTROL
 238         default y
 239         help
 240           If this option is enabled, the reg property will be translated
 241           using the fdt_translate_address() function. This is necessary
 242           on some platforms (e.g. MVEBU) using complex "ranges"
 243           properties in many nodes. As this translation is not handled
 244           correctly in the default simple_bus_translate() function.
 245
 246           If this option is not enabled, simple_bus_translate() will be
 247           used for the address translation. This function is faster and
 248           smaller in size than fdt_translate_address().
 249
 250 config SPL_OF_TRANSLATE
 251         bool "Translate addresses using fdt_translate_address in SPL"
 252         depends on SPL_DM && SPL_OF_CONTROL
 253         default n
 254         help
 255           If this option is enabled, the reg property will be translated
 256           using the fdt_translate_address() function. This is necessary
 257           on some platforms (e.g. MVEBU) using complex "ranges"
 258           properties in many nodes. As this translation is not handled
 259           correctly in the default simple_bus_translate() function.
 260
 261           If this option is not enabled, simple_bus_translate() will be
 262           used for the address translation. This function is faster and
 263           smaller in size than fdt_translate_address().
 264
 265 config TRANSLATION_OFFSET
 266         bool "Platforms specific translation offset"
 267         depends on DM && OF_CONTROL
 268         help
 269           Some platforms need a special address translation. Those
 270           platforms (e.g. mvebu in SPL) can configure a translation
 271           offset by enabling this option and setting the translation_offset
 272           variable in the GD in their platform- / board-specific code.
 273
 274 config OF_ISA_BUS
 275         bool
 276         depends on OF_TRANSLATE
 277         help
 278           Is this option is enabled then support for the ISA bus will
 279           be included for addresses read from DT. This is something that
 280           should be known to be required or not based upon the board
 281           being targeted, and whether or not it makes use of an ISA bus.
 282
 283           The bus is matched based upon its node name equalling "isa". The
 284           busses #address-cells should equal 2, with the first cell being
 285           used to hold flags & flag 0x1 indicating that the address range
 286           should be accessed using I/O port in/out accessors. The second
 287           cell holds the offset into ISA bus address space. The #size-cells
 288           property should equal 1, and of course holds the size of the
 289           address range used by a device.
 290
 291           If this option is not enabled then support for the ISA bus is
 292           not included and any such busses used in DT will be treated as
 293           typical simple-bus compatible busses. This will lead to
 294           mistranslation of device addresses, so ensure that this is
 295           enabled if your board does include an ISA bus.
 296
 297 config DM_DEV_READ_INLINE
 298         bool
 299         default y if !OF_LIVE
 300
 301 config ACPIGEN
 302         bool "Support ACPI table generation in driver model"
 303         default y if SANDBOX || (GENERATE_ACPI_TABLE && !QEMU)
 304         help
 305           This option enables generation of ACPI tables using driver-model
 306           devices. It adds a new operation struct to each driver, to support
 307           things like generating device-specific tables and returning the ACPI
 308           name of a device.
 309
 310 config INTEL_ACPIGEN
 311         bool "Support ACPI table generation for Intel SoCs"
 312         depends on ACPIGEN
 313         help
 314           This option adds some functions used for programatic generation of
 315           ACPI tables on Intel SoCs. This provides features for writing CPU
 316           information such as P states and T stages. Also included is a way
 317           to create a GNVS table and set it up.
 318
 319 config BOUNCE_BUFFER
 320         bool "Include bounce buffer API"
 321         help
 322           Some peripherals support DMA from a subset of physically
 323           addressable memory only.  To support such peripherals, the
 324           bounce buffer API uses a temporary buffer: it copies data
 325           to/from DMA regions while managing cache operations.
 326
 327           A second possible use of bounce buffers is their ability to
 328           provide aligned buffers for DMA operations.
 329
 330 endmenu