Gitiles
Code Review Sign In
gerrit.devboardsforandroid.linaro.org / platform / external / u-boot / e1910d93b8906f9366f6661adca7a58d4b98dd61 / . / doc / driver-model / migration.rst
blob: a26e7ab7e1aaec7cddda5b20dcb76db6ab8411d1 [file] [log] [blame]
Bin Menge1910d92019-07-18 00:33:50 -0700[diff] [blame^]1.. SPDX-License-Identifier: GPL-2.0+
2
Simon Glass302466d2017-08-05 15:45:53 -0600[diff] [blame]3Migration Schedule
Bin Menge1910d92019-07-18 00:33:50 -0700[diff] [blame^]4==================
Simon Glass302466d2017-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
Tom Rini1cb5d5d2018-11-29 18:21:11 -0500[diff] [blame]10CONFIG_DM_MMC
11-------------
12
Bin Menge1910d92019-07-18 00:33:50 -0700[diff] [blame^]13* Status: In progress
14* Deadline: 2019.04
Tom Rini1cb5d5d2018-11-29 18:21:11 -0500[diff] [blame]15
16The subsystem itself has been converted and maintainers should submit patches
17switching over to using CONFIG_DM_MMC and other base driver model options in
18time for inclusion in the 2019.04 rerelease.
Simon Glass302466d2017-08-05 15:45:53 -0600[diff] [blame]19
Tom Rini109d8bf2018-11-29 18:21:12 -0500[diff] [blame]20CONFIG_DM_USB
21-------------
22
Bin Menge1910d92019-07-18 00:33:50 -0700[diff] [blame^]23* Status: In progress
24* Deadline: 2019.07
Tom Rini109d8bf2018-11-29 18:21:12 -0500[diff] [blame]25
26The subsystem itself has been converted along with many of the host controller
27and maintainers should submit patches switching over to using CONFIG_DM_USB and
28other base driver model options in time for inclusion in the 2019.07 rerelease.
29
Tom Riniea9d7c12018-11-29 18:21:13 -0500[diff] [blame]30CONFIG_SATA
31-----------
32
Bin Menge1910d92019-07-18 00:33:50 -0700[diff] [blame^]33* Status: In progress
34* Deadline: 2019.07
Tom Riniea9d7c12018-11-29 18:21:13 -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_AHCI and
38other base driver model options in time for inclusion in the 2019.07 rerelease.
39
Simon Glass302466d2017-08-05 15:45:53 -0600[diff] [blame]40CONFIG_BLK
41----------
42
Bin Menge1910d92019-07-18 00:33:50 -0700[diff] [blame^]43* Status: In progress
44* Deadline: 2019.07
Simon Glass302466d2017-08-05 15:45:53 -0600[diff] [blame]45
Tom Rini7cfc1a32018-11-29 18:21:14 -0500[diff] [blame]46In concert with maintainers migrating their block device usage to the
47appropriate DM driver, CONFIG_BLK needs to be set as well. The final deadline
48here coincides with the final deadline for migration of the various block
Tom Rini91ff6862018-12-05 08:23:38 -0500[diff] [blame]49subsystems. At this point we will be able to audit and correct the logic in
50Kconfig around using CONFIG_PARTITIONS and CONFIG_HAVE_BLOCK_DEVICE and make
51use of CONFIG_BLK / CONFIG_SPL_BLK as needed.
Jagan Tekic4e68d32018-03-14 18:58:03 +0530[diff] [blame]52
Bin Menge1910d92019-07-18 00:33:50 -0700[diff] [blame^]53CONFIG_DM_SPI / CONFIG_DM_SPI_FLASH
54-----------------------------------
Jagan Tekic4e68d32018-03-14 18:58:03 +0530[diff] [blame]55
56Board Maintainers should submit the patches for enabling DM_SPI and DM_SPI_FLASH
57to move the migration with in the deadline.
58
Bin Menge1910d92019-07-18 00:33:50 -0700[diff] [blame^]59No dm conversion yet::
60
Jagan Tekic4e68d32018-03-14 18:58:03 +0530[diff] [blame]61 drivers/spi/cf_spi.c
62 drivers/spi/fsl_espi.c
63 drivers/spi/lpc32xx_ssp.c
Jagan Tekic4e68d32018-03-14 18:58:03 +0530[diff] [blame]64 drivers/spi/mxs_spi.c
Jagan Tekic4e68d32018-03-14 18:58:03 +0530[diff] [blame]65 drivers/spi/sh_spi.c
66 drivers/spi/soft_spi_legacy.c
67
Bin Menge1910d92019-07-18 00:33:50 -0700[diff] [blame^]68* Status: In progress
69* Deadline: 2019.04
Jagan Teki99a17dd2018-12-14 22:04:12 +0530[diff] [blame]70
Bin Menge1910d92019-07-18 00:33:50 -0700[diff] [blame^]71Partially converted::
72
Jagan Tekic4e68d32018-03-14 18:58:03 +0530[diff] [blame]73 drivers/spi/davinci_spi.c
74 drivers/spi/fsl_dspi.c
Jagan Tekic4e68d32018-03-14 18:58:03 +0530[diff] [blame]75 drivers/spi/kirkwood_spi.c
76 drivers/spi/mxc_spi.c
77 drivers/spi/omap3_spi.c
Jagan Tekid1505ad2019-04-29 01:58:54 +0530[diff] [blame]78 drivers/spi/sh_qspi.c
Jagan Tekic4e68d32018-03-14 18:58:03 +0530[diff] [blame]79
Bin Menge1910d92019-07-18 00:33:50 -0700[diff] [blame^]80* Status: In progress
81* Deadline: 2019.07
Simon Glass1ce689d2018-12-28 14:03:07 -0700[diff] [blame]82
83
84CONFIG_DM_PCI
85-------------
86Deadline: 2019.07
87
88The PCI subsystem has supported driver model since mid 2015. Maintainers should
89submit patches switching over to using CONFIG_DM_PCI and other base driver
90model options in time for inclusion in the 2019.07 release.
91
Simon Glass3e87ffc2018-12-28 14:03:08 -0700[diff] [blame]92
93CONFIG_DM_VIDEO
94---------------
95Deadline: 2019.07
96
97The video subsystem has supported driver model since early 2016. Maintainers
98should submit patches switching over to using CONFIG_DM_VIDEO and other base
99driver model options in time for inclusion in the 2019.07 release.