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