From patchwork Fri Feb 23 03:49:46 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Yang Xiwen via B4 Relay X-Patchwork-Id: 205189 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7300:a81b:b0:108:e6aa:91d0 with SMTP id bq27csp368245dyb; Thu, 22 Feb 2024 19:52:57 -0800 (PST) X-Forwarded-Encrypted: i=3; AJvYcCWU2aCZmefC0Acp4ImzORjB7RRh3uOq2yv8t1o+gITI0lvUrb9tD4bXZ1OCRaJkz7Gf6cnrnoEUaiR8icR3/DU0AZk4VA== X-Google-Smtp-Source: AGHT+IH7Cbhixyw+JIyXWLfkCr0J60lPNNSELpG7zIvxMwXxYZIf4aMGazi9FFW1f+XDU7kEVMgq X-Received: by 2002:aa7:d794:0:b0:565:1ee9:4f11 with SMTP id s20-20020aa7d794000000b005651ee94f11mr802654edq.15.1708660376995; Thu, 22 Feb 2024 19:52:56 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1708660376; cv=pass; d=google.com; s=arc-20160816; b=AbUF7vSVFOL1MLqAfhhAxLNfGgBnGbjWFszvJzRuc3hi3xLSG0T/5HdIY75sVCc8mV rRdYt3AGntqLg+I37wb1AcQhkUz8jLeHLSbzuPY2D/yiw0kbQOJK5VTuSqq/j+DD2/0R en+wB+inXQHTgmkmsFPDaRRP2ZOmN3onHq2MWdMypllc2aVParEzn1Y6HKbG6jfLxgNM FLexB6oht4sZ07Ik0MFeViorId+cEQ+fF9f3JIAAa1tuVpfqKnQmXI96Cb/Ub+VWR913 T+X+SNPbT8G4FA37F342eqHt4RJez39FNp9dOsQO+QTWNdyu6o7t/TkZFhMa0/DXrbjP gmmw== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=reply-to:cc:to:in-reply-to:references:message-id :content-transfer-encoding:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:subject:date:from:dkim-signature; bh=Bh69/YmjTj7KF/agYYpxeqPhxBBHW1N9gTnv2h+f6Zw=; fh=v9eDaXLBM4EIWvXGxm7HVV0FdJjPOnBmQsTyxhEFunc=; b=WjNdFKk1A1G6b93P+doH5YZbMUsO/Uv7T2RNx1i+LlT/wt5EYGg5FsJYKyUs24g/a7 6PUvEcfRYCSj82iwDbbf6Nne29cuu7Mi/5BlyVZqWlGEQaOIpSYOpfrt8qLeUYd+GJSk AVbmL567TTN2QsJ61eH+p12/uSoO84b0++WOeVJDohwv/3AIC3vRIm+Sjqn4KqFgDG8q ukIjSOULJlTz0doXQbUy49XuDEGK/iFWpSYTV7zBnIsyEOX/2Z8yGLKXKHmVWjiZzhcG xuZJPSPwtvd7SfHjBoG2VVSQ8bom3VlETXWRwwvNd4JcRwItT6EFWRsPnWbTEfnw5QLU xJJg==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=Ya0ITmGn; arc=pass (i=1 dkim=pass dkdomain=kernel.org); spf=pass (google.com: domain of linux-kernel+bounces-77744-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) smtp.mailfrom="linux-kernel+bounces-77744-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: from am.mirrors.kernel.org (am.mirrors.kernel.org. [2604:1380:4601:e00::3]) by mx.google.com with ESMTPS id u4-20020a509504000000b0056459db288dsi4692538eda.277.2024.02.22.19.52.56 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 22 Feb 2024 19:52:56 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-77744-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) client-ip=2604:1380:4601:e00::3; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=Ya0ITmGn; arc=pass (i=1 dkim=pass dkdomain=kernel.org); spf=pass (google.com: domain of linux-kernel+bounces-77744-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) smtp.mailfrom="linux-kernel+bounces-77744-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by am.mirrors.kernel.org (Postfix) with ESMTPS id 98B211F2671B for ; Fri, 23 Feb 2024 03:52:56 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id A373112B8F; Fri, 23 Feb 2024 03:49:53 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="Ya0ITmGn" Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 0B220111AD; Fri, 23 Feb 2024 03:49:50 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1708660191; cv=none; b=GkMFxlqxfFx/3nALp0zmDN5tuM3WlDxIzGVUTZTKqIm2mpRKXc2M1mwq7STOiLt61POIDhyN32C8FymIopJY+lDJW7KvWcilQ1FiJiN90Yk9dQ5wzvLgEbVIbP4YDCd/zvdD//I2BLZBn5v5mBdNsLhp7SHBxdbZwAZOlDExx4Q= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1708660191; c=relaxed/simple; bh=UboJhJ2Na49LW6G1cI5tL0fPvFZ/OZtE9CHN8NnGtQg=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=nAWm+2qFTos/DU/Jtfqyqon5Dpv+UFiAd8DGMldXQiOetroI/f79dcEd9x0ziHHtcV0EZvtMDF2Gu+7J1mZAiU2gnXJwJCyemM1FCVFwHqjYW8hZQyI9pMpGo+N5mFTvbv0fhcC0Tujv4sBF9Vgth5qERACkQIO5z7RdSy7tb0k= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=Ya0ITmGn; arc=none smtp.client-ip=10.30.226.201 Received: by smtp.kernel.org (Postfix) with ESMTPS id 8F7E6C43390; Fri, 23 Feb 2024 03:49:50 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1708660190; bh=UboJhJ2Na49LW6G1cI5tL0fPvFZ/OZtE9CHN8NnGtQg=; h=From:Date:Subject:References:In-Reply-To:To:Cc:Reply-To:From; b=Ya0ITmGnjSbud6eY+M2zJYNLSPlF/cHUyzAAwLl/fcuEGiN+S5QyQvNxNzXtpY0k1 y+OdiwNDq8OIpP8AcNXy2F+Bv7+PyX5P/oUI3MQ0Z/fbtQWgyl8nJwrJkluxHpz72w S6DRCL/8bcl7yGpSS/n7HBc9yY9PrA0zS/MGQ7tm8Wm0szgb3u6hrsk111OUdp9GW+ cyMHm3gEmg7aZ/AHh2K9ZgySOmGLJzAcdKMBrnD0QZo4b76rjekoQFNyFCb/iDIGCL An5dQBtVJHyQcXVLvqIDCiGl/inHk5ZgT1V54IxlVlpMzAv4yYrfW3gWRiQpeEbjni PBas63Jh1GzzQ== Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id 6D7F7C54E41; Fri, 23 Feb 2024 03:49:50 +0000 (UTC) From: Yang Xiwen via B4 Relay Date: Fri, 23 Feb 2024 11:49:46 +0800 Subject: [PATCH 1/2] dt-bindings: simple-pm-bus: Add optional resets Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Message-Id: <20240223-b4-bus-v1-1-2803c3ac4673@outlook.com> References: <20240223-b4-bus-v1-0-2803c3ac4673@outlook.com> In-Reply-To: <20240223-b4-bus-v1-0-2803c3ac4673@outlook.com> To: Rob Herring , Krzysztof Kozlowski , Conor Dooley , Geert Uytterhoeven , Philipp Zabel Cc: devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, Yang Xiwen X-Mailer: b4 0.12.4 X-Developer-Signature: v=1; a=ed25519-sha256; t=1708660187; l=1458; i=forbidden405@outlook.com; s=20230724; h=from:subject:message-id; bh=eDExkZ8ch9F2IC6H0Bh6sbmnrZwqE83QU/hncSN1udA=; b=Ix+IGJnk37tLr6KiqN56bHt+twAmHGwLNjd3rCsPg1w/s3+c1zqNBQAm4VYR5tNYNB3gGUKd4 lH6Meg3a0efD6SNUtc6v4IvRoM3GZA/sMRdx2ufsfbT63ahePugNiRL X-Developer-Key: i=forbidden405@outlook.com; a=ed25519; pk=qOD5jhp891/Xzc+H/PZ8LWVSWE3O/XCQnAg+5vdU2IU= X-Endpoint-Received: by B4 Relay for forbidden405@outlook.com/20230724 with auth_id=67 X-Original-From: Yang Xiwen Reply-To: X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1791660263481164032 X-GMAIL-MSGID: 1791660263481164032 From: Yang Xiwen For some on-soc buses, it is also needed to deassert the resets before access. Document it in the binding. Signed-off-by: Yang Xiwen Reviewed-by: Geert Uytterhoeven --- Documentation/devicetree/bindings/bus/simple-pm-bus.yaml | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/Documentation/devicetree/bindings/bus/simple-pm-bus.yaml b/Documentation/devicetree/bindings/bus/simple-pm-bus.yaml index 182134d7a6a3..430638104980 100644 --- a/Documentation/devicetree/bindings/bus/simple-pm-bus.yaml +++ b/Documentation/devicetree/bindings/bus/simple-pm-bus.yaml @@ -14,8 +14,9 @@ description: | driver, as it's typically initialized by the boot loader. However, its bus controller is part of a PM domain, or under the control - of a functional clock. Hence, the bus controller's PM domain and/or - clock must be enabled for child devices connected to the bus (either + of a functional clock, and it might have a reset control signal. Hence, + the bus controller's PM domain and/or clock must be enabled, reset control + signal must be deasserted for child devices connected to the bus (either on-SoC or externally) to function. While "simple-pm-bus" follows the "simple-bus" set of properties, as @@ -49,6 +50,8 @@ properties: # Required if clocks is absent, optional otherwise minItems: 1 + resets: true + required: - compatible - '#address-cells'