Bin Meng | c1bfac6 | 2019-07-18 00:33:50 -0700 | [diff] [blame] | 1 | .. SPDX-License-Identifier: GPL-2.0+ |
| 2 | |
Simon Glass | a4ddff4 | 2017-08-05 15:45:53 -0600 | [diff] [blame] | 3 | Migration Schedule |
Bin Meng | c1bfac6 | 2019-07-18 00:33:50 -0700 | [diff] [blame] | 4 | ================== |
Simon Glass | a4ddff4 | 2017-08-05 15:45:53 -0600 | [diff] [blame] | 5 | |
| 6 | U-Boot has been migrating to a new driver model since its introduction in |
| 7 | 2014. This file describes the schedule for deprecation of pre-driver-model |
| 8 | features. |
| 9 | |
Heinrich Schuchardt | 301c80c | 2019-09-16 18:41:42 +0200 | [diff] [blame] | 10 | CONFIG_DM |
| 11 | --------- |
| 12 | |
| 13 | * Status: In progress |
| 14 | * Deadline: 2020.01 |
| 15 | |
| 16 | Starting with the 2010.01 release CONFIG_DM will be enabled for all boards. |
| 17 | This does not concern CONFIG_DM_SPL and CONFIG_DM_TPL. The conversion date for |
| 18 | these configuration items still needs to be defined. |
| 19 | |
Tom Rini | 47c583c | 2018-11-29 18:21:11 -0500 | [diff] [blame] | 20 | CONFIG_DM_MMC |
| 21 | ------------- |
| 22 | |
Bin Meng | c1bfac6 | 2019-07-18 00:33:50 -0700 | [diff] [blame] | 23 | * Status: In progress |
| 24 | * Deadline: 2019.04 |
Tom Rini | 47c583c | 2018-11-29 18:21:11 -0500 | [diff] [blame] | 25 | |
| 26 | The subsystem itself has been converted and maintainers should submit patches |
| 27 | switching over to using CONFIG_DM_MMC and other base driver model options in |
| 28 | time for inclusion in the 2019.04 rerelease. |
Simon Glass | a4ddff4 | 2017-08-05 15:45:53 -0600 | [diff] [blame] | 29 | |
Tom Rini | 64e6acb | 2018-11-29 18:21:12 -0500 | [diff] [blame] | 30 | CONFIG_DM_USB |
| 31 | ------------- |
| 32 | |
Bin Meng | c1bfac6 | 2019-07-18 00:33:50 -0700 | [diff] [blame] | 33 | * Status: In progress |
| 34 | * Deadline: 2019.07 |
Tom Rini | 64e6acb | 2018-11-29 18:21:12 -0500 | [diff] [blame] | 35 | |
| 36 | The subsystem itself has been converted along with many of the host controller |
| 37 | and maintainers should submit patches switching over to using CONFIG_DM_USB and |
| 38 | other base driver model options in time for inclusion in the 2019.07 rerelease. |
| 39 | |
Tom Rini | a1fdb05 | 2018-11-29 18:21:13 -0500 | [diff] [blame] | 40 | CONFIG_SATA |
| 41 | ----------- |
| 42 | |
Bin Meng | c1bfac6 | 2019-07-18 00:33:50 -0700 | [diff] [blame] | 43 | * Status: In progress |
| 44 | * Deadline: 2019.07 |
Tom Rini | a1fdb05 | 2018-11-29 18:21:13 -0500 | [diff] [blame] | 45 | |
| 46 | The subsystem itself has been converted along with many of the host controller |
| 47 | and maintainers should submit patches switching over to using CONFIG_AHCI and |
| 48 | other base driver model options in time for inclusion in the 2019.07 rerelease. |
| 49 | |
Simon Glass | a4ddff4 | 2017-08-05 15:45:53 -0600 | [diff] [blame] | 50 | CONFIG_BLK |
| 51 | ---------- |
| 52 | |
Bin Meng | c1bfac6 | 2019-07-18 00:33:50 -0700 | [diff] [blame] | 53 | * Status: In progress |
| 54 | * Deadline: 2019.07 |
Simon Glass | a4ddff4 | 2017-08-05 15:45:53 -0600 | [diff] [blame] | 55 | |
Tom Rini | efacd9f | 2018-11-29 18:21:14 -0500 | [diff] [blame] | 56 | In concert with maintainers migrating their block device usage to the |
| 57 | appropriate DM driver, CONFIG_BLK needs to be set as well. The final deadline |
| 58 | here coincides with the final deadline for migration of the various block |
Tom Rini | 1794ae6 | 2018-12-05 08:23:38 -0500 | [diff] [blame] | 59 | subsystems. At this point we will be able to audit and correct the logic in |
Simon Glass | 3bf7d7a | 2022-08-11 19:34:48 -0600 | [diff] [blame] | 60 | Kconfig around using CONFIG_PARTITIONS and CONFIG_SPL_LEGACY_BLOCK and make |
Tom Rini | 1794ae6 | 2018-12-05 08:23:38 -0500 | [diff] [blame] | 61 | use of CONFIG_BLK / CONFIG_SPL_BLK as needed. |
Jagan Teki | 471ecf4 | 2018-03-14 18:58:03 +0530 | [diff] [blame] | 62 | |
Bin Meng | c1bfac6 | 2019-07-18 00:33:50 -0700 | [diff] [blame] | 63 | CONFIG_DM_SPI / CONFIG_DM_SPI_FLASH |
| 64 | ----------------------------------- |
Jagan Teki | 471ecf4 | 2018-03-14 18:58:03 +0530 | [diff] [blame] | 65 | |
| 66 | Board Maintainers should submit the patches for enabling DM_SPI and DM_SPI_FLASH |
| 67 | to move the migration with in the deadline. |
| 68 | |
Bin Meng | c1bfac6 | 2019-07-18 00:33:50 -0700 | [diff] [blame] | 69 | Partially converted:: |
| 70 | |
Jagan Teki | 2538bf8 | 2020-07-09 21:23:58 +0530 | [diff] [blame] | 71 | drivers/spi/fsl_espi.c |
Jagan Teki | 471ecf4 | 2018-03-14 18:58:03 +0530 | [diff] [blame] | 72 | drivers/spi/mxc_spi.c |
Jagan Teki | 3e104a5 | 2019-04-29 01:58:54 +0530 | [diff] [blame] | 73 | drivers/spi/sh_qspi.c |
Jagan Teki | 471ecf4 | 2018-03-14 18:58:03 +0530 | [diff] [blame] | 74 | |
Bin Meng | c1bfac6 | 2019-07-18 00:33:50 -0700 | [diff] [blame] | 75 | * Status: In progress |
| 76 | * Deadline: 2019.07 |
Simon Glass | 90083b4 | 2018-12-28 14:03:07 -0700 | [diff] [blame] | 77 | |
Simon Glass | 8ea538d | 2018-12-28 14:03:08 -0700 | [diff] [blame] | 78 | CONFIG_DM_VIDEO |
| 79 | --------------- |
| 80 | Deadline: 2019.07 |
| 81 | |
| 82 | The video subsystem has supported driver model since early 2016. Maintainers |
Simon Glass | 52cb504 | 2022-10-18 07:46:31 -0600 | [diff] [blame] | 83 | should submit patches switching over to using CONFIG_VIDEO and other base |
Simon Glass | 8ea538d | 2018-12-28 14:03:08 -0700 | [diff] [blame] | 84 | driver model options in time for inclusion in the 2019.07 release. |
Heinrich Schuchardt | c78c379 | 2019-08-10 00:10:37 +0200 | [diff] [blame] | 85 | |
| 86 | CONFIG_DM_ETH |
| 87 | ------------- |
| 88 | Deadline: 2020.07 |
| 89 | |
| 90 | The network subsystem has supported the driver model since early 2015. |
| 91 | Maintainers should submit patches switching over to using CONFIG_DM_ETH and |
| 92 | other base driver model options in time for inclusion in the 2020.07 release. |
Simon Glass | 9a7da3c | 2021-03-25 21:24:44 +1300 | [diff] [blame] | 93 | |
| 94 | CONFIG_DM_I2C |
| 95 | ------------- |
| 96 | Deadline: 2021.10 |
| 97 | |
| 98 | The I2C subsystem has supported the driver model since early 2015. |
| 99 | Maintainers should submit patches switching over to using CONFIG_DM_I2C and |
| 100 | other base driver model options in time for inclusion in the 2021.10 release. |
Simon Glass | f8409e9 | 2021-11-24 09:26:45 -0700 | [diff] [blame] | 101 | |
Simon Glass | e10ae9f | 2021-12-18 11:27:29 -0700 | [diff] [blame] | 102 | CONFIG_SYS_TIMER_RATE and CONFIG_SYS_TIMER_COUNTER |
| 103 | -------------------------------------------------- |
| 104 | Deadline: 2023.01 |
| 105 | |
| 106 | These are legacy options which have been replaced by driver model. |
| 107 | Maintainers should submit patches switching over to using CONFIG_TIMER and |
| 108 | other base driver model options in time for inclusion in the 2022.10 release. |
| 109 | |
| 110 | There is only one method to implement, unless you want to support bootstage, |
| 111 | in which case you need an early timer also. For example drivers, see |
| 112 | sandbox_timer.c and rockchip_timer.c |
Simon Glass | ddb3ada | 2022-01-22 05:03:50 -0700 | [diff] [blame] | 113 | |
| 114 | CONFIG_DM_SERIAL |
| 115 | ---------------- |
| 116 | Deadline: 2023.04 |
| 117 | |
| 118 | The serial subsystem has supported the driver model since late 2014. |
| 119 | Maintainers should submit patches switching over to using CONFIG_DM_SERIAL and |
| 120 | other base driver model options in time for inclusion in the 2022.10 release. |