From patchwork Fri Sep 5 13:18:12 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Simon Glass X-Patchwork-Id: 237 Return-Path: X-Original-To: u-boot-concept@u-boot.org Delivered-To: u-boot-concept@u-boot.org DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1757078325; bh=NbSBqeTXsMunv1qUqDT5oH8vv9pcwiFLfQTX4VY//10=; h=From:To:Date:In-Reply-To:References:CC:Subject:List-Id: List-Archive:List-Help:List-Owner:List-Post:List-Subscribe: List-Unsubscribe:From; b=A//saJCOOJ5OVjO9CeVeXtnIBcaNAqPytx7FotbKFVxEcsT7hhnpNyA9f2eFloI9J L0hO6awS8s3PeGTCG4b6sUJ6cj03HnGsIsOgPJxdv9TEtk/LYEPcflxQru4IW7Z+rZ Rteh1Hg2HbIADt73ZKFK7Gta0RzLdLu1Fg6Rsubi+/6/skJOA55sfy0RG8YIZSdL2b m5OLvZV7qzf5olD9xrlwdCinfoxOappWX+aonPFkuS4KuMQ9bp8805IDUp33eBCI+R y3Q33fwH7aY+47kgoZloJfKsJq2qTNDXgD25l6F+vh+LVXrxt82DrCxE+RXaOaGOb0 7HnpcAzRLmrNQ== Received: from localhost (localhost [127.0.0.1]) by mail.u-boot.org (Postfix) with ESMTP id 912C267980 for ; Fri, 5 Sep 2025 07:18:45 -0600 (MDT) X-Virus-Scanned: Debian amavis at Received: from mail.u-boot.org ([127.0.0.1]) by localhost (mail.u-boot.org [127.0.0.1]) (amavis, port 10024) with ESMTP id rrQ3e0ULLtah for ; Fri, 5 Sep 2025 07:18:45 -0600 (MDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1757078325; bh=NbSBqeTXsMunv1qUqDT5oH8vv9pcwiFLfQTX4VY//10=; h=From:To:Date:In-Reply-To:References:CC:Subject:List-Id: List-Archive:List-Help:List-Owner:List-Post:List-Subscribe: List-Unsubscribe:From; b=A//saJCOOJ5OVjO9CeVeXtnIBcaNAqPytx7FotbKFVxEcsT7hhnpNyA9f2eFloI9J L0hO6awS8s3PeGTCG4b6sUJ6cj03HnGsIsOgPJxdv9TEtk/LYEPcflxQru4IW7Z+rZ Rteh1Hg2HbIADt73ZKFK7Gta0RzLdLu1Fg6Rsubi+/6/skJOA55sfy0RG8YIZSdL2b m5OLvZV7qzf5olD9xrlwdCinfoxOappWX+aonPFkuS4KuMQ9bp8805IDUp33eBCI+R y3Q33fwH7aY+47kgoZloJfKsJq2qTNDXgD25l6F+vh+LVXrxt82DrCxE+RXaOaGOb0 7HnpcAzRLmrNQ== Received: from mail.u-boot.org (localhost [127.0.0.1]) by mail.u-boot.org (Postfix) with ESMTP id 7FAD1678DF for ; Fri, 5 Sep 2025 07:18:45 -0600 (MDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1757078323; bh=U1wgVLT7SeJ6F49eFPvJx10evISfx4aY4EiqMFQyuN8=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=pP+9asaOIfqqbZx0h5RAKOHqsAlihnxAf9Ds620yQ0KmuIVJ1DfDw+dkEX4BjsbIA QeAP2ekd6S3LiaR6Y61JG5J1zr/8X2yWKxPrLWw+gWmt6vjJag8Jh/4uhpbBMeYe6h m+zhMNNSXGk8Kh8/6yC3XoJ1AgFc78SQdZWniyYvORbKQ80CS5Ly+rXseaz6LPZmJ6 27FIELiK5mnHfVD6/9bougIqdxuAM2mZejuMBdhClbI1FCiFFM8+tte9FGlFvOT28w E8iDwto4SHyll9jqNADGO4acVte58Y0k38RscmvVFK729fhesU49wHF8C8XznBOMDF D3JFgtxY2hwhQ== Received: from localhost (localhost [127.0.0.1]) by mail.u-boot.org (Postfix) with ESMTP id 5D6D36799E; Fri, 5 Sep 2025 07:18:43 -0600 (MDT) X-Virus-Scanned: Debian amavis at Received: from mail.u-boot.org ([127.0.0.1]) by localhost (mail.u-boot.org [127.0.0.1]) (amavis, port 10026) with ESMTP id YvWgm8Uui7YY; Fri, 5 Sep 2025 07:18:43 -0600 (MDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1757078321; bh=j/hGCoTcXEzsI7LAs5hIqSrNe639TYr0dIlDQRuvgtY=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=keuHppCGgVyXP2UTl5CIrXPv/Rg//BGARzioe2C8ZN6r1dKE2/EMiZP1FnR9fw7Ua GbcKVsR6ZVcKKtIwg/1BXwD0KIphLJ96A4VTbfmP+FyZdojwSvQAC6A6a9SJwg/+X8 Yb3zLXzCdcT3JXGjrSyXDeF+gq348y4rgNstwKe8RInmrg4qpagH5h2JZIBR1+47eQ EKd2yYwCG1RO7YJM2hPOdVtnEFf4vB6c5kGFJrrrYKNhPP9W9b3py2ANIRmo86EgVN 9vhOIVPkRKDteqGp+dRBxGy4Qh73PuqswXaDfpipzjuw76lHaTJPekPplxF5Sx9Tjw 9oQhCuax3F2jw== Received: from u-boot.org (unknown [73.34.74.121]) by mail.u-boot.org (Postfix) with ESMTPSA id 8375F678DF; Fri, 5 Sep 2025 07:18:41 -0600 (MDT) From: Simon Glass To: U-Boot Concept Date: Fri, 5 Sep 2025 07:18:12 -0600 Message-ID: <20250905131816.3344908-6-sjg@u-boot.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20250905131816.3344908-1-sjg@u-boot.org> References: <20250905131816.3344908-1-sjg@u-boot.org> MIME-Version: 1.0 Message-ID-Hash: ZZ4NEIVZKAQEOSFZLFUM66FOUBAEL6HM X-Message-ID-Hash: ZZ4NEIVZKAQEOSFZLFUM66FOUBAEL6HM X-MailFrom: sjg@u-boot.org X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; loop; banned-address; emergency; member-moderation; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header CC: Heinrich Schuchardt , Simon Glass X-Mailman-Version: 3.3.10 Precedence: list Subject: [Concept] [PATCH 5/5] doc: api: Add a migration deadline List-Id: Discussion and patches related to U-Boot Concept Archived-At: List-Archive: List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: From: Simon Glass Set a deadline of the end of 2027 for removal of what is now the legacy API. Signed-off-by: Simon Glass --- doc/develop/driver-model/migration.rst | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/doc/develop/driver-model/migration.rst b/doc/develop/driver-model/migration.rst index b40a6af9d11..50689282b39 100644 --- a/doc/develop/driver-model/migration.rst +++ b/doc/develop/driver-model/migration.rst @@ -118,3 +118,15 @@ Deadline: 2023.04 The serial subsystem has supported the driver model since late 2014. Maintainers should submit patches switching over to using CONFIG_DM_SERIAL and other base driver model options in time for inclusion in the 2022.10 release. + +CONFIG_LEGACY_API +----------------- +Deadline: 2028.01 + +U-Boot has long supported an API which allows external programs to call entry +points in U-Boot. This API does not support driver model and is not widely used. +It is being replaced by a library approach (libu-boot.a/so) which is more +flexible and could potentially support an automatically generated stub with +those entry points. + +The API will be removed for the 2028.01 release.