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 19f1896c45SAndy Yan must provide CONFIG_SPL_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 22f1896c45SAndy Yan CONFIG_SPL_SYS_MALLOC_F_LEN for more details on how to enable it. 2391a91ff8SSimon Glass 245a6f06f6SSimon Glassconfig TPL_DM 255a6f06f6SSimon Glass bool "Enable Driver Model for TPL" 265a6f06f6SSimon Glass depends on DM && TPL 275a6f06f6SSimon Glass help 285a6f06f6SSimon Glass Enable driver model in TPL. You will need to provide a 295a6f06f6SSimon Glass suitable malloc() implementation. If you are not using the 305a6f06f6SSimon Glass full malloc() enabled by CONFIG_SYS_SPL_MALLOC_START, 315a6f06f6SSimon Glass consider using CONFIG_SYS_MALLOC_SIMPLE. In that case you 32f1896c45SAndy Yan must provide CONFIG_SPL_SYS_MALLOC_F_LEN to set the size. 335a6f06f6SSimon Glass In most cases driver model will only allocate a few uclasses 345a6f06f6SSimon Glass and devices in SPL, so 1KB should be enough. See 35f1896c45SAndy Yan CONFIG_SPL_SYS_MALLOC_F_LEN for more details on how to enable it. 365a6f06f6SSimon Glass Disable this for very small implementations. 375a6f06f6SSimon Glass 3891a91ff8SSimon Glassconfig DM_WARN 3991a91ff8SSimon Glass bool "Enable warnings in driver model" 40d648964fSMasahiro Yamada depends on DM 41d648964fSMasahiro Yamada default y 4291a91ff8SSimon Glass help 4391a91ff8SSimon Glass The dm_warn() function can use up quite a bit of space for its 4491a91ff8SSimon Glass strings. By default this is disabled for SPL builds to save space. 4591a91ff8SSimon Glass This will cause dm_warn() to be compiled out - it will do nothing 4691a91ff8SSimon Glass when called. 4791a91ff8SSimon Glass 4891a91ff8SSimon Glassconfig DM_DEVICE_REMOVE 4991a91ff8SSimon Glass bool "Support device removal" 50d648964fSMasahiro Yamada depends on DM 51d648964fSMasahiro Yamada default y 5291a91ff8SSimon Glass help 5391a91ff8SSimon Glass We can save some code space by dropping support for removing a 5491a91ff8SSimon Glass device. This is not normally required in SPL, so by default this 5591a91ff8SSimon Glass option is disabled for SPL. 5691a91ff8SSimon Glass 57e5c4564eSHans de Goede Note that this may have undesirable results in the USB subsystem as 58e5c4564eSHans de Goede it causes unplugged devices to linger around in the dm-tree, and it 59e5c4564eSHans de Goede causes USB host controllers to not be stopped when booting the OS. 60e5c4564eSHans de Goede 6191a91ff8SSimon Glassconfig DM_STDIO 6291a91ff8SSimon Glass bool "Support stdio registration" 63d648964fSMasahiro Yamada depends on DM 64d648964fSMasahiro Yamada default y 6591a91ff8SSimon Glass help 6691a91ff8SSimon Glass Normally serial drivers register with stdio so that they can be used 6791a91ff8SSimon Glass as normal output devices. In SPL we don't normally use stdio, so 6891a91ff8SSimon Glass we can omit this feature. 6936fa61dcSSimon Glass 7036fa61dcSSimon Glassconfig DM_SEQ_ALIAS 7136fa61dcSSimon Glass bool "Support numbered aliases in device tree" 7236fa61dcSSimon Glass depends on DM 7336fa61dcSSimon Glass default y 7436fa61dcSSimon Glass help 7536fa61dcSSimon Glass Most boards will have a '/aliases' node containing the path to 7636fa61dcSSimon Glass numbered devices (e.g. serial0 = &serial0). This feature can be 774f627c5aSNathan Rossi disabled if it is not required. 784f627c5aSNathan Rossi 794f627c5aSNathan Rossiconfig SPL_DM_SEQ_ALIAS 804f627c5aSNathan Rossi bool "Support numbered aliases in device tree in SPL" 814f627c5aSNathan Rossi depends on DM 824f627c5aSNathan Rossi default n 834f627c5aSNathan Rossi help 844f627c5aSNathan Rossi Most boards will have a '/aliases' node containing the path to 854f627c5aSNathan Rossi numbered devices (e.g. serial0 = &serial0). This feature can be 8636fa61dcSSimon Glass disabled if it is not required, to save code space in SPL. 8712dc8e75SSimon Glass 8812dc8e75SSimon Glassconfig REGMAP 8912dc8e75SSimon Glass bool "Support register maps" 9012dc8e75SSimon Glass depends on DM 9112dc8e75SSimon Glass help 9212dc8e75SSimon Glass Hardware peripherals tend to have one or more sets of registers 9312dc8e75SSimon Glass which can be accessed to control the hardware. A register map 9412dc8e75SSimon Glass models this with a simple read/write interface. It can in principle 9512dc8e75SSimon Glass support any bus type (I2C, SPI) but so far this only supports 9612dc8e75SSimon Glass direct memory access. 9712dc8e75SSimon Glass 9841c7f664Shuang linconfig SPL_REGMAP 9941c7f664Shuang lin bool "Support register maps in SPL" 1009c447370SPhilipp Tomsich depends on SPL_DM 10141c7f664Shuang lin help 10241c7f664Shuang lin Hardware peripherals tend to have one or more sets of registers 10341c7f664Shuang lin which can be accessed to control the hardware. A register map 10441c7f664Shuang lin models this with a simple read/write interface. It can in principle 10541c7f664Shuang lin support any bus type (I2C, SPI) but so far this only supports 10641c7f664Shuang lin direct memory access. 10741c7f664Shuang lin 108*c6ac6c1bSPhilipp Tomsichconfig TPL_REGMAP 109*c6ac6c1bSPhilipp Tomsich bool "Support register maps in TPL" 110*c6ac6c1bSPhilipp Tomsich depends on TPL_DM 111*c6ac6c1bSPhilipp Tomsich help 112*c6ac6c1bSPhilipp Tomsich Hardware peripherals tend to have one or more sets of registers 113*c6ac6c1bSPhilipp Tomsich which can be accessed to control the hardware. A register map 114*c6ac6c1bSPhilipp Tomsich models this with a simple read/write interface. It can in principle 115*c6ac6c1bSPhilipp Tomsich support any bus type (I2C, SPI) but so far this only supports 116*c6ac6c1bSPhilipp Tomsich direct memory access. 117*c6ac6c1bSPhilipp Tomsich 11812dc8e75SSimon Glassconfig SYSCON 11912dc8e75SSimon Glass bool "Support system controllers" 12012dc8e75SSimon Glass depends on REGMAP 12112dc8e75SSimon Glass help 12212dc8e75SSimon Glass Many SoCs have a number of system controllers which are dealt with 12312dc8e75SSimon Glass as a group by a single driver. Some common functionality is provided 12412dc8e75SSimon Glass by this uclass, including accessing registers via regmap and 12512dc8e75SSimon Glass assigning a unique number to each. 126608f26c5SMasahiro Yamada 12741c7f664Shuang linconfig SPL_SYSCON 12841c7f664Shuang lin bool "Support system controllers in SPL" 1299c447370SPhilipp Tomsich depends on SPL_REGMAP 13041c7f664Shuang lin help 13141c7f664Shuang lin Many SoCs have a number of system controllers which are dealt with 13241c7f664Shuang lin as a group by a single driver. Some common functionality is provided 13341c7f664Shuang lin by this uclass, including accessing registers via regmap and 13441c7f664Shuang lin assigning a unique number to each. 13541c7f664Shuang lin 136*c6ac6c1bSPhilipp Tomsichconfig TPL_SYSCON 137*c6ac6c1bSPhilipp Tomsich bool "Support system controllers in TPL" 138*c6ac6c1bSPhilipp Tomsich depends on TPL_REGMAP 139*c6ac6c1bSPhilipp Tomsich help 140*c6ac6c1bSPhilipp Tomsich Many SoCs have a number of system controllers which are dealt with 141*c6ac6c1bSPhilipp Tomsich as a group by a single driver. Some common functionality is provided 142*c6ac6c1bSPhilipp Tomsich by this uclass, including accessing registers via regmap and 143*c6ac6c1bSPhilipp Tomsich assigning a unique number to each. 144*c6ac6c1bSPhilipp Tomsich 145e2282d70SMasahiro Yamadaconfig DEVRES 146e2282d70SMasahiro Yamada bool "Managed device resources" 147e2282d70SMasahiro Yamada depends on DM 148e2282d70SMasahiro Yamada help 149e2282d70SMasahiro Yamada This option enables the Managed device resources core support. 150e2282d70SMasahiro Yamada Device resources managed by the devres framework are automatically 151e2282d70SMasahiro Yamada released whether initialization fails half-way or the device gets 152e2282d70SMasahiro Yamada detached. 153e2282d70SMasahiro Yamada 154e2282d70SMasahiro Yamada If this option is disabled, devres functions fall back to 155e2282d70SMasahiro Yamada non-managed variants. For example, devres_alloc() to kzalloc(), 156e2282d70SMasahiro Yamada devm_kmalloc() to kmalloc(), etc. 157e2282d70SMasahiro Yamada 158608f26c5SMasahiro Yamadaconfig DEBUG_DEVRES 15940b6f2d0SMasahiro Yamada bool "Managed device resources debugging functions" 160e2282d70SMasahiro Yamada depends on DEVRES 161608f26c5SMasahiro Yamada help 162608f26c5SMasahiro Yamada If this option is enabled, devres debug messages are printed. 16340b6f2d0SMasahiro Yamada Also, a function is available to dump a list of device resources. 164608f26c5SMasahiro Yamada Select this if you are having a problem with devres or want to 165608f26c5SMasahiro Yamada debug resource management for a managed device. 166608f26c5SMasahiro Yamada 167608f26c5SMasahiro Yamada If you are unsure about this, Say N here. 1680b11dbf7SMasahiro Yamada 169628d792cSMarek Vasutconfig SIMPLE_BUS 170628d792cSMarek Vasut bool "Support simple-bus driver" 171628d792cSMarek Vasut depends on DM && OF_CONTROL 172628d792cSMarek Vasut default y 173628d792cSMarek Vasut help 174628d792cSMarek Vasut Supports the 'simple-bus' driver, which is used on some systems. 175628d792cSMarek Vasut 176628d792cSMarek Vasutconfig SPL_SIMPLE_BUS 177628d792cSMarek Vasut bool "Support simple-bus driver in SPL" 178628d792cSMarek Vasut depends on SPL_DM && SPL_OF_CONTROL 1798bebf03cSMichal Simek default y 180628d792cSMarek Vasut help 181628d792cSMarek Vasut Supports the 'simple-bus' driver, which is used on some systems 182628d792cSMarek Vasut in SPL. 183628d792cSMarek Vasut 184ef5cd330SStefan Roeseconfig OF_TRANSLATE 185ef5cd330SStefan Roese bool "Translate addresses using fdt_translate_address" 186ef5cd330SStefan Roese depends on DM && OF_CONTROL 187ef5cd330SStefan Roese default y 188ef5cd330SStefan Roese help 189ef5cd330SStefan Roese If this option is enabled, the reg property will be translated 190ef5cd330SStefan Roese using the fdt_translate_address() function. This is necessary 191ef5cd330SStefan Roese on some platforms (e.g. MVEBU) using complex "ranges" 192ef5cd330SStefan Roese properties in many nodes. As this translation is not handled 193ef5cd330SStefan Roese correctly in the default simple_bus_translate() function. 194ef5cd330SStefan Roese 195ef5cd330SStefan Roese If this option is not enabled, simple_bus_translate() will be 196ef5cd330SStefan Roese used for the address translation. This function is faster and 197ef5cd330SStefan Roese smaller in size than fdt_translate_address(). 198ef5cd330SStefan Roese 199ef5cd330SStefan Roeseconfig SPL_OF_TRANSLATE 2007b98a3b6SStefan Roese bool "Translate addresses using fdt_translate_address in SPL" 201ef5cd330SStefan Roese depends on SPL_DM && SPL_OF_CONTROL 202ef5cd330SStefan Roese default n 203ef5cd330SStefan Roese help 204ef5cd330SStefan Roese If this option is enabled, the reg property will be translated 205ef5cd330SStefan Roese using the fdt_translate_address() function. This is necessary 206ef5cd330SStefan Roese on some platforms (e.g. MVEBU) using complex "ranges" 207ef5cd330SStefan Roese properties in many nodes. As this translation is not handled 208ef5cd330SStefan Roese correctly in the default simple_bus_translate() function. 209ef5cd330SStefan Roese 210ef5cd330SStefan Roese If this option is not enabled, simple_bus_translate() will be 211ef5cd330SStefan Roese used for the address translation. This function is faster and 212ef5cd330SStefan Roese smaller in size than fdt_translate_address(). 213ef5cd330SStefan Roese 2140a222d53SPaul Burtonconfig OF_ISA_BUS 2150a222d53SPaul Burton bool 2160a222d53SPaul Burton depends on OF_TRANSLATE 2170a222d53SPaul Burton help 2180a222d53SPaul Burton Is this option is enabled then support for the ISA bus will 2190a222d53SPaul Burton be included for addresses read from DT. This is something that 2200a222d53SPaul Burton should be known to be required or not based upon the board 2210a222d53SPaul Burton being targetted, and whether or not it makes use of an ISA bus. 2220a222d53SPaul Burton 2230a222d53SPaul Burton The bus is matched based upon its node name equalling "isa". The 2240a222d53SPaul Burton busses #address-cells should equal 2, with the first cell being 2250a222d53SPaul Burton used to hold flags & flag 0x1 indicating that the address range 2260a222d53SPaul Burton should be accessed using I/O port in/out accessors. The second 2270a222d53SPaul Burton cell holds the offset into ISA bus address space. The #size-cells 2280a222d53SPaul Burton property should equal 1, and of course holds the size of the 2290a222d53SPaul Burton address range used by a device. 2300a222d53SPaul Burton 2310a222d53SPaul Burton If this option is not enabled then support for the ISA bus is 2320a222d53SPaul Burton not included and any such busses used in DT will be treated as 2330a222d53SPaul Burton typical simple-bus compatible busses. This will lead to 2340a222d53SPaul Burton mistranslation of device addresses, so ensure that this is 2350a222d53SPaul Burton enabled if your board does include an ISA bus. 2360a222d53SPaul Burton 237f11c7ab9SSimon Glassconfig DM_DEV_READ_INLINE 238f11c7ab9SSimon Glass bool 239f11c7ab9SSimon Glass default y if !OF_LIVE 240f11c7ab9SSimon Glass 2410b11dbf7SMasahiro Yamadaendmenu 242