From patchwork Sun Jun 16 13:19:20 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Krzysztof Kozlowski X-Patchwork-Id: 13699550 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 8BAFBC27C79 for ; Sun, 16 Jun 2024 13:19:53 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender:List-Subscribe:List-Help :List-Post:List-Archive:List-Unsubscribe:List-Id:Cc:To: Content-Transfer-Encoding:Content-Type:MIME-Version:Message-Id:Date:Subject: From:Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:In-Reply-To:References: List-Owner; bh=Y9RC7qP2hOgwXMsoy3J2wjG1fwHEObGM33Zw9CpfKZU=; b=FmFxYZt/ERRDAM zmXUW6u823GAzLeu8rA9Dy3CyZzMe6AMXRNeCmccXOcl7QrHLGCZES9QH7gsZLVk8HNwuK+nGUy9L ndhdHOFc2WvC9A0VoFU4bk/0Vg7abfm8A/4lA8DLj6XdLSJX7B725H/8VeAuBZNv7QGm+rOmJlQSd Vlw/UZ2obOpRXFEuI61kpkYJ9vaedppFxgcwwHdqfpZzszCVTPNuUBnVW5SJhrA++6dNrLpgQkiRV KVZ510Z23ZbtjMFMb9mONdIxpyzCCSPyLDX57scXuhc48GL3aHkSYm9oVoARtfr2EW0polyjtmVF6 MveRSHfANTe7IKr+QkfQ==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.97.1 #2 (Red Hat Linux)) id 1sIpnI-00000007a9F-2i62; Sun, 16 Jun 2024 13:19:40 +0000 Received: from mail-ed1-x530.google.com ([2a00:1450:4864:20::530]) by bombadil.infradead.org with esmtps (Exim 4.97.1 #2 (Red Hat Linux)) id 1sIpnE-00000007a7M-22y5 for linux-arm-kernel@lists.infradead.org; Sun, 16 Jun 2024 13:19:38 +0000 Received: by mail-ed1-x530.google.com with SMTP id 4fb4d7f45d1cf-57c68682d1aso3963489a12.3 for ; Sun, 16 Jun 2024 06:19:35 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; t=1718543974; x=1719148774; darn=lists.infradead.org; h=cc:to:content-transfer-encoding:mime-version:message-id:date :subject:from:from:to:cc:subject:date:message-id:reply-to; bh=Y9RC7qP2hOgwXMsoy3J2wjG1fwHEObGM33Zw9CpfKZU=; b=N+i5LE+ziqp803z/Cb8p4Pjsk9PUkcOqqnQCxrWYImqSAaZvebAVHehmDVIjGHA43Q K8d4Yd3BVSTXLhEzbExFDc4VudZOEPtMl7x5rTuJhec9Nq/fmwnWWnjhzpRVNDFR+0so f/q2VZWBpZ3aA1Wgs+TPDTh0fKjlRmeMZazgCdINFd/u53hgUv63t3NQaIfupc6DbxPf WgbuV4YAFyYILGhPmD+5XQALf4/jVazzUOFALFPC8MAjTV+7so33/kTnkt9xK4ecMgT3 9vfeDTp+rHBEENy5wrFRPzUF/vZodojBHcEJcPQICYur6GzzdswhnV+n/3lFV9JyhdKA IZsQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1718543974; x=1719148774; h=cc:to:content-transfer-encoding:mime-version:message-id:date :subject:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=Y9RC7qP2hOgwXMsoy3J2wjG1fwHEObGM33Zw9CpfKZU=; b=XChq1b0CGisGaZ/Y+5PWPNbSBGuboGOOzKBbNItOR34YTTTH6n2lHLpD0V2SyxBED1 gPsIPOBH1xd9hEK7hsM7VVHyKepeyoWBmD5+x/D8O2qZp4NvVB0ctPAMNPBASC3gGCWH c+Lw0KD4Y28z/jI7MBAmnTLKgaMfhMxcily7XcEBe6gG/ZFVPggSnk8ftRCWrsBn/kGo qWvpF/yfkGAwPrn1auLrcMIilx/xM3+cpmQW+DLBbK3aQrKOHInmReumsqa26RvajK7T AM4YdHnoPmbIkN96sQNi3CdHqjYpB0tprkEGVmjg/geanF6yQ20DjoN22+aZH7rRT1Uz hMLA== X-Forwarded-Encrypted: i=1; AJvYcCWEqETTGVaa+BjFcPXAXiZY/TPyYB3PkkZneMlyV8EfrIveAn94mw4i1nwgQHcKS2Th59M+Rkm4ZTN3xSlxYK1igm5wEKkx16Xp51Gnypo8u4NLWAs= X-Gm-Message-State: AOJu0Yy1PNYUPWXMJrqtc1C2xcJtF6tADfXqfCDqy/BGuhcsZLeo9Iay iuEsu01xLFAPrYOhjrsot7g/NxcO6QEEdW9zZteLw4n4NRCf8QN0nB30wUCx/ks= X-Google-Smtp-Source: AGHT+IGMI/wzpjxIzGob+oc4c+5L+0sBURQOTzW3e+I9pMt6Aj9Zo75Lc2WpGk2lBDIv5UBbbO8UMA== X-Received: by 2002:a50:8714:0:b0:57c:ab84:1095 with SMTP id 4fb4d7f45d1cf-57cbd652420mr4227643a12.7.1718543974453; Sun, 16 Jun 2024 06:19:34 -0700 (PDT) Received: from [127.0.1.1] ([78.10.207.147]) by smtp.gmail.com with ESMTPSA id 4fb4d7f45d1cf-57cb7438815sm5099603a12.80.2024.06.16.06.19.32 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 16 Jun 2024 06:19:33 -0700 (PDT) From: Krzysztof Kozlowski Subject: [PATCH v2 0/7] dt-bindings: mfd: syscon: Document more compatibles and require simpe-mfd description Date: Sun, 16 Jun 2024 15:19:20 +0200 Message-Id: <20240616-dt-bindings-mfd-syscon-split-v2-0-571b5850174a@linaro.org> MIME-Version: 1.0 X-B4-Tracking: v=1; b=H4sIAFjmbmYC/33Nyw6CMBCF4Vchs3YMbUWCK9/DsKj0wiTYkk5DJ IR3t5K4dfmfxXc2YJvIMtyqDZJdiCmGEvJUwTDq4C2SKQ2ylpe6ES2ajE8KhoJnfDmDvPIQA/I 8UUbVWqm67tpIZaAQc7KO3gf/6EuPxDmm9XhbxHf9wd1/eBFYo9au2OVBKH2fKOgUzzF56Pd9/ wAhMnwyyQAAAA== To: Orson Zhai , Baolin Wang , Chunyan Zhang , Vadivel Murugan , Jacky Huang , Shan-Chun Hung , Khuong Dinh , Lee Jones , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Lars Povlsen , Steen Hegelund , Daniel Machon , UNGLinuxDriver@microchip.com, Nishanth Menon , Matthias Brugger , AngeloGioacchino Del Regno Cc: Jiaxun Yang , devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-mediatek@lists.infradead.org, Krzysztof Kozlowski X-Mailer: b4 0.13.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=3459; i=krzysztof.kozlowski@linaro.org; h=from:subject:message-id; bh=KsuesC+AIOWnKwWhlFMQqxP1c7Aqz3KwBjkPKaoEn4s=; b=owEBbQKS/ZANAwAKAcE3ZuaGi4PXAcsmYgBmbuZZ4iKC72/2IrXQ++FeWFww/PEerhVXjYS9F gps/xdFZaaJAjMEAAEKAB0WIQTd0mIoPREbIztuuKjBN2bmhouD1wUCZm7mWQAKCRDBN2bmhouD 13DLD/9rH6dQNL9jR/EbdncCtbVy7XfBgF23WzTSQ+Zetujhw6InK0iBU9oEm1RSW3H741evTzS 1a/HpapRRfre/jtZ28lyZFE5wDJtLVowZIvWiV2jPC7wUUKnfnGG6xy4y+UO8W5ajNybtQ541QU yot4HM7h7n+P3OEtjlAu/pcnQTY04MxIgmVemOiNdK5wVaachnub0WN1lw7kq89xWlOE8fu3uGF tnpdejWgoKJJmv7sGMTWEAZQc8OHoTyKB7yx1oohIa7Cs6hJ8sbOkke3QMD5t3NWu73TKtdH5Nb 859EmTDIORS+lqwHissSo564KiYjXD9R8rP9RbHlnm8z6Ei9M9c9PjRGCumfhcwUeAnl4RMUmyG 2KVhL94LusXQxhLgF7VzRrTd0kWeET5MXGiMPNXOSGONX7hLTF325XYNnwXD422YRnFsz5jeZ3E sYlIHRRhBcSjhWfbP0Qp4HBS26bwIjW0poIo71YXoa1SNEwQoz11kT0lUmeECJlvrQaemHs6gcc QaTo6mmP7lI/Zt3UkwBNGkzXz9kdIlb71FNORzwYJgARNszOWJSOCq1bHLiwfjR4gYkqiOUUphs 9BR9xpFHp42gZ2DHz2Ura9j0DlxBEcJ5gszm3JLaES0vrHheDY/DuIzOhANOqbiCgpIg5vV4zYw 5vzsTOP0J6u1U5Q== X-Developer-Key: i=krzysztof.kozlowski@linaro.org; a=openpgp; fpr=9BD07E0E0C51F8D59677B7541B93437D3B41629B X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20240616_061936_752195_CBDA2E21 X-CRM114-Status: GOOD ( 11.83 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org Hi, Dependency ========== Rebased on Lee's MFD tree, because dependency is there already: https://lore.kernel.org/all/171828959006.2643902.8308227314531523435.b4-ty@kernel.org/ Merging ======= Preferrably everything via MFD tree (file/context dependencies). Changes in v2: =================== - Add acks - lgm-syscon: add ranges to binding and example - syscon.yaml: add big select with all compatibles for older dtschema - Link to v1: https://lore.kernel.org/r/20240519-dt-bindings-mfd-syscon-split-v1-0-aaf996e2313a@linaro.org Description/problem =================== Simple syscon nodes can be documented in common syscon.yaml, however devices with simple-mfd compatible, thus some children, should have their own schema listing these children. Such listing makes the binding specific, allows better validation (so the incorrect child would not appear in the simple-mfd node) and actually enforces repeated rule for simple-mfd devices: "simple-mfd" is only for simple devices, where the children do not depend on the parent. Currently the syscon+simple-mfd binding is quite broad and allows any child or property, thus above rule cannot be enforced. Solution ======== 1. Split the syscon.yaml binding into common syscon properties, used potentially by many bindings, and only simple syscon devices (NO simple-mfd!). 2. Move some known simple-mfd bindings from syscon.yaml to dedicated files. This patchset might introduce new dtbs_check warnings for devices having simple-mfd and being part of syscon.yaml previously. I fixed some of them, but probably not all. Best regards, Krzysztof To: Lee Jones To: Rob Herring To: Krzysztof Kozlowski To: Conor Dooley To: Lars Povlsen To: Steen Hegelund To: Daniel Machon To: UNGLinuxDriver@microchip.com To: Nishanth Menon To: Matthias Brugger To: AngeloGioacchino Del Regno Cc: devicetree@vger.kernel.org Cc: linux-kernel@vger.kernel.org Cc: linux-arm-kernel@lists.infradead.org Cc: linux-mediatek@lists.infradead.org --- Krzysztof Kozlowski (7): dt-bindings: mfd: syscon: Drop hwlocks dt-bindings: soc: sprd: sc9863a-glbregs: Document SC9863A syscon dt-bindings: soc: intel: lgm-syscon: Move to dedicated schema dt-bindings: soc: microchip: sparx5-cpu-syscon: Move to dedicated schema dt-bindings: soc: ti: am654-serdes-ctrl: Move to dedicated schema dt-bindings: mfd: syscon: Split and enforce documenting MFD children dt-bindings: mfd: syscon: Add APM poweroff mailbox .../devicetree/bindings/mfd/syscon-common.yaml | 72 +++++ Documentation/devicetree/bindings/mfd/syscon.yaml | 306 ++++++++++++--------- .../bindings/soc/intel/intel,lgm-syscon.yaml | 56 ++++ .../soc/microchip/microchip,sparx5-cpu-syscon.yaml | 49 ++++ .../bindings/soc/sprd/sprd,sc9863a-glbregs.yaml | 55 ++++ .../bindings/soc/ti/ti,am654-serdes-ctrl.yaml | 42 +++ 6 files changed, 457 insertions(+), 123 deletions(-) --- base-commit: fe6ba540b2ce777eb4f59991c3ef20ad8a319a1a change-id: 20240517-dt-bindings-mfd-syscon-split-37e23996523d Best regards,