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