From patchwork Thu Jul 18 07:33:50 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bin Meng X-Patchwork-Id: 1133565 X-Patchwork-Delegate: trini@ti.com Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=none (mailfrom) smtp.mailfrom=lists.denx.de (client-ip=81.169.180.215; helo=lists.denx.de; envelope-from=u-boot-bounces@lists.denx.de; receiver=) Authentication-Results: ozlabs.org; dmarc=fail (p=none dis=none) header.from=gmail.com Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (2048-bit key; unprotected) header.d=gmail.com header.i=@gmail.com header.b="tnhuMVvE"; dkim-atps=neutral Received: from lists.denx.de (dione.denx.de [81.169.180.215]) by ozlabs.org (Postfix) with ESMTP id 45q5XJ52pRz9s00 for ; Thu, 18 Jul 2019 17:35:44 +1000 (AEST) Received: by lists.denx.de (Postfix, from userid 105) id 55A85C21F3B; Thu, 18 Jul 2019 07:35:30 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on lists.denx.de X-Spam-Level: X-Spam-Status: No, score=-0.0 required=5.0 tests=FREEMAIL_FROM, RCVD_IN_MSPIKE_H3, RCVD_IN_MSPIKE_WL, T_DKIM_INVALID autolearn=unavailable autolearn_force=no version=3.4.0 Received: from lists.denx.de (localhost [IPv6:::1]) by lists.denx.de (Postfix) with ESMTP id BD8ABC21F0B; Thu, 18 Jul 2019 07:34:54 +0000 (UTC) Received: by lists.denx.de (Postfix, from userid 105) id C2AE5C21F50; Thu, 18 Jul 2019 07:34:51 +0000 (UTC) Received: from mail-pf1-f196.google.com (mail-pf1-f196.google.com [209.85.210.196]) by lists.denx.de (Postfix) with ESMTPS id 230F7C21F03 for ; Thu, 18 Jul 2019 07:34:48 +0000 (UTC) Received: by mail-pf1-f196.google.com with SMTP id b13so12199352pfo.1 for ; Thu, 18 Jul 2019 00:34:48 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:subject:date:message-id:in-reply-to:references; bh=No3BrOSaAg4yL27cfRaEzOj0QyKGGOT1Wosazkyp78k=; b=tnhuMVvEDUKJ3e7gFs1GrnM1NqVWcNXR3C/7IaKjppkeVcMgAU6vrJui0DkDhX1WXI 4xQiDvZXfF3LpGtzbkmB/y0jFYoQe2QMf/XjpcXvYSApTIknAv4h5PlOeVOuNc6jVIEc clTtVteXBzNHTP/pEC/bVr/1hAOXoqUqhk9+okQX103ptPpRh2IO0PVply/5tO6YMMxD 9smxiyNaXXvrc9/FirSCHMqrjN68owCHTm75ikYcvwwuwq9R6rRiXfiNDaJKS7meC+h3 EfK+im0QiJs4sPTBil+qcN+SjX91gCY4Tl0qbrtYpWoJYpDJnQrir9KBssFcz9PAOUNv tTSg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:subject:date:message-id:in-reply-to :references; bh=No3BrOSaAg4yL27cfRaEzOj0QyKGGOT1Wosazkyp78k=; b=EoIUGOTLMqsXVtE8B3QFYcO+Z6RIyemObP9mewdFwRJegW3V884wIdg0ieSlncxqKs bZF201/x5OhVWIJgFsp2fPA6CziViuvNg6P8f6b92SrkHxCpi1/fcVUYRAufjYLeUuyb 4MhoT820E8kD6tZnBeGHOwGUsakfSjnrxY2+D5l5impt5jtptG5YMmLwoDKw766erWq2 kHe6FxSSMf7qLUztL3ttt68sHVuV5StCnJPlYosCkBt+N25eucEINCtABs8VTzFUQLGG xMyapZv2IPQEVVgUjhESH8ap5ey8NwwxCU4Utw+XGXLoOSbJkTEwhe4wHEYROYeIuEHe pTkA== X-Gm-Message-State: APjAAAWsB6tZ+q75/NddPAPwwaQpO/TdZQBwXlBA1OLnZpKWLa/iClFf +kVs3HoaYuEo4NqwSQ3QZq4= X-Google-Smtp-Source: APXvYqwtE2FrEHYJfyfqCjMZA3f7MGEhZeL30TLMAr2QtLNpDRsJ2hAe4EhXx+GARQH7qtejYjj4jA== X-Received: by 2002:a63:1c22:: with SMTP id c34mr45891039pgc.56.1563435286726; Thu, 18 Jul 2019 00:34:46 -0700 (PDT) Received: from localhost.localdomain (unknown-224-80.windriver.com. [147.11.224.80]) by smtp.gmail.com with ESMTPSA id q1sm39859821pfn.178.2019.07.18.00.34.45 (version=TLS1 cipher=AES128-SHA bits=128/128); Thu, 18 Jul 2019 00:34:46 -0700 (PDT) From: Bin Meng To: Tom Rini , Simon Glass , Wolfgang Denk , Heinrich Schuchardt , Mario Six , U-Boot Mailing List Date: Thu, 18 Jul 2019 00:33:50 -0700 Message-Id: <1563435275-22326-6-git-send-email-bmeng.cn@gmail.com> X-Mailer: git-send-email 1.7.1 In-Reply-To: <1563435275-22326-1-git-send-email-bmeng.cn@gmail.com> References: <1563435275-22326-1-git-send-email-bmeng.cn@gmail.com> Subject: [U-Boot] [PATCH 05/50] doc: driver-model: Convert MIGRATION.txt to reST X-BeenThere: u-boot@lists.denx.de X-Mailman-Version: 2.1.18 Precedence: list List-Id: U-Boot discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Errors-To: u-boot-bounces@lists.denx.de Sender: "U-Boot" Convert plain text documentation to reStructuredText format and add it to Sphinx TOC tree. No essential content change. Signed-off-by: Bin Meng Reviewed-by: Heinrich Schuchardt --- doc/driver-model/index.rst | 1 + doc/driver-model/{MIGRATION.txt => migration.rst} | 44 +++++++++++------------ 2 files changed, 22 insertions(+), 23 deletions(-) rename doc/driver-model/{MIGRATION.txt => migration.rst} (84%) diff --git a/doc/driver-model/index.rst b/doc/driver-model/index.rst index 96fbd72..663aa5d 100644 --- a/doc/driver-model/index.rst +++ b/doc/driver-model/index.rst @@ -7,3 +7,4 @@ Driver Model :maxdepth: 2 design + migration diff --git a/doc/driver-model/MIGRATION.txt b/doc/driver-model/migration.rst similarity index 84% rename from doc/driver-model/MIGRATION.txt rename to doc/driver-model/migration.rst index d38be35..a26e7ab 100644 --- a/doc/driver-model/MIGRATION.txt +++ b/doc/driver-model/migration.rst @@ -1,5 +1,7 @@ +.. SPDX-License-Identifier: GPL-2.0+ + Migration Schedule -==================== +================== U-Boot has been migrating to a new driver model since its introduction in 2014. This file describes the schedule for deprecation of pre-driver-model @@ -8,8 +10,8 @@ features. CONFIG_DM_MMC ------------- -Status: In progress -Deadline: 2019.04 +* Status: In progress +* Deadline: 2019.04 The subsystem itself has been converted and maintainers should submit patches switching over to using CONFIG_DM_MMC and other base driver model options in @@ -18,8 +20,8 @@ time for inclusion in the 2019.04 rerelease. CONFIG_DM_USB ------------- -Status: In progress -Deadline: 2019.07 +* Status: In progress +* Deadline: 2019.07 The subsystem itself has been converted along with many of the host controller and maintainers should submit patches switching over to using CONFIG_DM_USB and @@ -28,8 +30,8 @@ other base driver model options in time for inclusion in the 2019.07 rerelease. CONFIG_SATA ----------- -Status: In progress -Deadline: 2019.07 +* Status: In progress +* Deadline: 2019.07 The subsystem itself has been converted along with many of the host controller and maintainers should submit patches switching over to using CONFIG_AHCI and @@ -38,8 +40,8 @@ other base driver model options in time for inclusion in the 2019.07 rerelease. CONFIG_BLK ---------- -Status: In progress -Deadline: 2019.07 +* Status: In progress +* Deadline: 2019.07 In concert with maintainers migrating their block device usage to the appropriate DM driver, CONFIG_BLK needs to be set as well. The final deadline @@ -48,14 +50,14 @@ subsystems. At this point we will be able to audit and correct the logic in Kconfig around using CONFIG_PARTITIONS and CONFIG_HAVE_BLOCK_DEVICE and make use of CONFIG_BLK / CONFIG_SPL_BLK as needed. -CONFIG_DM_SPI -CONFIG_DM_SPI_FLASH -------------------- +CONFIG_DM_SPI / CONFIG_DM_SPI_FLASH +----------------------------------- Board Maintainers should submit the patches for enabling DM_SPI and DM_SPI_FLASH to move the migration with in the deadline. -No dm conversion yet: +No dm conversion yet:: + drivers/spi/cf_spi.c drivers/spi/fsl_espi.c drivers/spi/lpc32xx_ssp.c @@ -63,10 +65,11 @@ No dm conversion yet: drivers/spi/sh_spi.c drivers/spi/soft_spi_legacy.c - Status: In progress - Deadline: 2019.04 +* Status: In progress +* Deadline: 2019.04 + +Partially converted:: -Partially converted: drivers/spi/davinci_spi.c drivers/spi/fsl_dspi.c drivers/spi/kirkwood_spi.c @@ -74,13 +77,8 @@ Partially converted: drivers/spi/omap3_spi.c drivers/spi/sh_qspi.c - Status: In progress - Deadline: 2019.07 - --- -Jagan Teki -12/24/2018 -03/14/2018 +* Status: In progress +* Deadline: 2019.07 CONFIG_DM_PCI