10b11dbf7SMasahiro Yamadamenu "Generic Driver Options" 20b11dbf7SMasahiro Yamada 3da333ae7SMasahiro Yamadaconfig DM 4da333ae7SMasahiro Yamada bool "Enable Driver Model" 5da333ae7SMasahiro Yamada help 6f94a1bedSSimon Glass This config option enables Driver Model. This brings in the core 7f94a1bedSSimon Glass support, including scanning of platform data on start-up. If 8f94a1bedSSimon Glass CONFIG_OF_CONTROL is enabled, the device tree will be scanned also 9f94a1bedSSimon Glass when available. 1091a91ff8SSimon Glass 1191a91ff8SSimon Glassconfig SPL_DM 1291a91ff8SSimon Glass bool "Enable Driver Model for SPL" 1391a91ff8SSimon Glass depends on DM && SPL 1491a91ff8SSimon Glass help 1591a91ff8SSimon Glass Enable driver model in SPL. You will need to provide a 1691a91ff8SSimon Glass suitable malloc() implementation. If you are not using the 1791a91ff8SSimon Glass full malloc() enabled by CONFIG_SYS_SPL_MALLOC_START, 1891a91ff8SSimon Glass consider using CONFIG_SYS_MALLOC_SIMPLE. In that case you 1991a91ff8SSimon Glass must provide CONFIG_SYS_MALLOC_F_LEN to set the size. 2091a91ff8SSimon Glass In most cases driver model will only allocate a few uclasses 2191a91ff8SSimon Glass and devices in SPL, so 1KB should be enable. See 2291a91ff8SSimon Glass CONFIG_SYS_MALLOC_F_LEN for more details on how to enable it. 2391a91ff8SSimon Glass 2491a91ff8SSimon Glassconfig DM_WARN 2591a91ff8SSimon Glass bool "Enable warnings in driver model" 26d648964fSMasahiro Yamada depends on DM 27d648964fSMasahiro Yamada default y 2891a91ff8SSimon Glass help 2991a91ff8SSimon Glass The dm_warn() function can use up quite a bit of space for its 3091a91ff8SSimon Glass strings. By default this is disabled for SPL builds to save space. 3191a91ff8SSimon Glass This will cause dm_warn() to be compiled out - it will do nothing 3291a91ff8SSimon Glass when called. 3391a91ff8SSimon Glass 3491a91ff8SSimon Glassconfig DM_DEVICE_REMOVE 3591a91ff8SSimon Glass bool "Support device removal" 36d648964fSMasahiro Yamada depends on DM 37d648964fSMasahiro Yamada default y 3891a91ff8SSimon Glass help 3991a91ff8SSimon Glass We can save some code space by dropping support for removing a 4091a91ff8SSimon Glass device. This is not normally required in SPL, so by default this 4191a91ff8SSimon Glass option is disabled for SPL. 4291a91ff8SSimon Glass 43e5c4564eSHans de Goede Note that this may have undesirable results in the USB subsystem as 44e5c4564eSHans de Goede it causes unplugged devices to linger around in the dm-tree, and it 45e5c4564eSHans de Goede causes USB host controllers to not be stopped when booting the OS. 46e5c4564eSHans de Goede 4791a91ff8SSimon Glassconfig DM_STDIO 4891a91ff8SSimon Glass bool "Support stdio registration" 49d648964fSMasahiro Yamada depends on DM 50d648964fSMasahiro Yamada default y 5191a91ff8SSimon Glass help 5291a91ff8SSimon Glass Normally serial drivers register with stdio so that they can be used 5391a91ff8SSimon Glass as normal output devices. In SPL we don't normally use stdio, so 5491a91ff8SSimon Glass we can omit this feature. 5536fa61dcSSimon Glass 5636fa61dcSSimon Glassconfig DM_SEQ_ALIAS 5736fa61dcSSimon Glass bool "Support numbered aliases in device tree" 5836fa61dcSSimon Glass depends on DM 5936fa61dcSSimon Glass default y 6036fa61dcSSimon Glass help 6136fa61dcSSimon Glass Most boards will have a '/aliases' node containing the path to 6236fa61dcSSimon Glass numbered devices (e.g. serial0 = &serial0). This feature can be 634f627c5aSNathan Rossi disabled if it is not required. 644f627c5aSNathan Rossi 654f627c5aSNathan Rossiconfig SPL_DM_SEQ_ALIAS 664f627c5aSNathan Rossi bool "Support numbered aliases in device tree in SPL" 674f627c5aSNathan Rossi depends on DM 684f627c5aSNathan Rossi default n 694f627c5aSNathan Rossi help 704f627c5aSNathan Rossi Most boards will have a '/aliases' node containing the path to 714f627c5aSNathan Rossi numbered devices (e.g. serial0 = &serial0). This feature can be 7236fa61dcSSimon Glass disabled if it is not required, to save code space in SPL. 7312dc8e75SSimon Glass 7412dc8e75SSimon Glassconfig REGMAP 7512dc8e75SSimon Glass bool "Support register maps" 7612dc8e75SSimon Glass depends on DM 7712dc8e75SSimon Glass help 7812dc8e75SSimon Glass Hardware peripherals tend to have one or more sets of registers 7912dc8e75SSimon Glass which can be accessed to control the hardware. A register map 8012dc8e75SSimon Glass models this with a simple read/write interface. It can in principle 8112dc8e75SSimon Glass support any bus type (I2C, SPI) but so far this only supports 8212dc8e75SSimon Glass direct memory access. 8312dc8e75SSimon Glass 8441c7f664Shuang linconfig SPL_REGMAP 8541c7f664Shuang lin bool "Support register maps in SPL" 8641c7f664Shuang lin depends on DM 8741c7f664Shuang lin help 8841c7f664Shuang lin Hardware peripherals tend to have one or more sets of registers 8941c7f664Shuang lin which can be accessed to control the hardware. A register map 9041c7f664Shuang lin models this with a simple read/write interface. It can in principle 9141c7f664Shuang lin support any bus type (I2C, SPI) but so far this only supports 9241c7f664Shuang lin direct memory access. 9341c7f664Shuang lin 9412dc8e75SSimon Glassconfig SYSCON 9512dc8e75SSimon Glass bool "Support system controllers" 9612dc8e75SSimon Glass depends on REGMAP 9712dc8e75SSimon Glass help 9812dc8e75SSimon Glass Many SoCs have a number of system controllers which are dealt with 9912dc8e75SSimon Glass as a group by a single driver. Some common functionality is provided 10012dc8e75SSimon Glass by this uclass, including accessing registers via regmap and 10112dc8e75SSimon Glass assigning a unique number to each. 102608f26c5SMasahiro Yamada 10341c7f664Shuang linconfig SPL_SYSCON 10441c7f664Shuang lin bool "Support system controllers in SPL" 10541c7f664Shuang lin depends on REGMAP 10641c7f664Shuang lin help 10741c7f664Shuang lin Many SoCs have a number of system controllers which are dealt with 10841c7f664Shuang lin as a group by a single driver. Some common functionality is provided 10941c7f664Shuang lin by this uclass, including accessing registers via regmap and 11041c7f664Shuang lin assigning a unique number to each. 11141c7f664Shuang lin 112e2282d70SMasahiro Yamadaconfig DEVRES 113e2282d70SMasahiro Yamada bool "Managed device resources" 114e2282d70SMasahiro Yamada depends on DM 115e2282d70SMasahiro Yamada help 116e2282d70SMasahiro Yamada This option enables the Managed device resources core support. 117e2282d70SMasahiro Yamada Device resources managed by the devres framework are automatically 118e2282d70SMasahiro Yamada released whether initialization fails half-way or the device gets 119e2282d70SMasahiro Yamada detached. 120e2282d70SMasahiro Yamada 121e2282d70SMasahiro Yamada If this option is disabled, devres functions fall back to 122e2282d70SMasahiro Yamada non-managed variants. For example, devres_alloc() to kzalloc(), 123e2282d70SMasahiro Yamada devm_kmalloc() to kmalloc(), etc. 124e2282d70SMasahiro Yamada 125608f26c5SMasahiro Yamadaconfig DEBUG_DEVRES 12640b6f2d0SMasahiro Yamada bool "Managed device resources debugging functions" 127e2282d70SMasahiro Yamada depends on DEVRES 128608f26c5SMasahiro Yamada help 129608f26c5SMasahiro Yamada If this option is enabled, devres debug messages are printed. 13040b6f2d0SMasahiro Yamada Also, a function is available to dump a list of device resources. 131608f26c5SMasahiro Yamada Select this if you are having a problem with devres or want to 132608f26c5SMasahiro Yamada debug resource management for a managed device. 133608f26c5SMasahiro Yamada 134608f26c5SMasahiro Yamada If you are unsure about this, Say N here. 1350b11dbf7SMasahiro Yamada 136628d792cSMarek Vasutconfig SIMPLE_BUS 137628d792cSMarek Vasut bool "Support simple-bus driver" 138628d792cSMarek Vasut depends on DM && OF_CONTROL 139628d792cSMarek Vasut default y 140628d792cSMarek Vasut help 141628d792cSMarek Vasut Supports the 'simple-bus' driver, which is used on some systems. 142628d792cSMarek Vasut 143628d792cSMarek Vasutconfig SPL_SIMPLE_BUS 144628d792cSMarek Vasut bool "Support simple-bus driver in SPL" 145628d792cSMarek Vasut depends on SPL_DM && SPL_OF_CONTROL 1468bebf03cSMichal Simek default y 147628d792cSMarek Vasut help 148628d792cSMarek Vasut Supports the 'simple-bus' driver, which is used on some systems 149628d792cSMarek Vasut in SPL. 150628d792cSMarek Vasut 151ef5cd330SStefan Roeseconfig OF_TRANSLATE 152ef5cd330SStefan Roese bool "Translate addresses using fdt_translate_address" 153ef5cd330SStefan Roese depends on DM && OF_CONTROL 154ef5cd330SStefan Roese default y 155ef5cd330SStefan Roese help 156ef5cd330SStefan Roese If this option is enabled, the reg property will be translated 157ef5cd330SStefan Roese using the fdt_translate_address() function. This is necessary 158ef5cd330SStefan Roese on some platforms (e.g. MVEBU) using complex "ranges" 159ef5cd330SStefan Roese properties in many nodes. As this translation is not handled 160ef5cd330SStefan Roese correctly in the default simple_bus_translate() function. 161ef5cd330SStefan Roese 162ef5cd330SStefan Roese If this option is not enabled, simple_bus_translate() will be 163ef5cd330SStefan Roese used for the address translation. This function is faster and 164ef5cd330SStefan Roese smaller in size than fdt_translate_address(). 165ef5cd330SStefan Roese 166ef5cd330SStefan Roeseconfig SPL_OF_TRANSLATE 1677b98a3b6SStefan Roese bool "Translate addresses using fdt_translate_address in SPL" 168ef5cd330SStefan Roese depends on SPL_DM && SPL_OF_CONTROL 169ef5cd330SStefan Roese default n 170ef5cd330SStefan Roese help 171ef5cd330SStefan Roese If this option is enabled, the reg property will be translated 172ef5cd330SStefan Roese using the fdt_translate_address() function. This is necessary 173ef5cd330SStefan Roese on some platforms (e.g. MVEBU) using complex "ranges" 174ef5cd330SStefan Roese properties in many nodes. As this translation is not handled 175ef5cd330SStefan Roese correctly in the default simple_bus_translate() function. 176ef5cd330SStefan Roese 177ef5cd330SStefan Roese If this option is not enabled, simple_bus_translate() will be 178ef5cd330SStefan Roese used for the address translation. This function is faster and 179ef5cd330SStefan Roese smaller in size than fdt_translate_address(). 180ef5cd330SStefan Roese 181*0a222d53SPaul Burtonconfig OF_ISA_BUS 182*0a222d53SPaul Burton bool 183*0a222d53SPaul Burton depends on OF_TRANSLATE 184*0a222d53SPaul Burton help 185*0a222d53SPaul Burton Is this option is enabled then support for the ISA bus will 186*0a222d53SPaul Burton be included for addresses read from DT. This is something that 187*0a222d53SPaul Burton should be known to be required or not based upon the board 188*0a222d53SPaul Burton being targetted, and whether or not it makes use of an ISA bus. 189*0a222d53SPaul Burton 190*0a222d53SPaul Burton The bus is matched based upon its node name equalling "isa". The 191*0a222d53SPaul Burton busses #address-cells should equal 2, with the first cell being 192*0a222d53SPaul Burton used to hold flags & flag 0x1 indicating that the address range 193*0a222d53SPaul Burton should be accessed using I/O port in/out accessors. The second 194*0a222d53SPaul Burton cell holds the offset into ISA bus address space. The #size-cells 195*0a222d53SPaul Burton property should equal 1, and of course holds the size of the 196*0a222d53SPaul Burton address range used by a device. 197*0a222d53SPaul Burton 198*0a222d53SPaul Burton If this option is not enabled then support for the ISA bus is 199*0a222d53SPaul Burton not included and any such busses used in DT will be treated as 200*0a222d53SPaul Burton typical simple-bus compatible busses. This will lead to 201*0a222d53SPaul Burton mistranslation of device addresses, so ensure that this is 202*0a222d53SPaul Burton enabled if your board does include an ISA bus. 203*0a222d53SPaul Burton 2040b11dbf7SMasahiro Yamadaendmenu 205