From nobody Mon Feb 9 16:42:47 2026 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 vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 609E6C433FE for ; Wed, 26 Oct 2022 16:43:51 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S233763AbiJZQnp (ORCPT ); Wed, 26 Oct 2022 12:43:45 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:37142 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233692AbiJZQnd (ORCPT ); Wed, 26 Oct 2022 12:43:33 -0400 Received: from mail-qt1-x82c.google.com (mail-qt1-x82c.google.com [IPv6:2607:f8b0:4864:20::82c]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 776EA50B90 for ; Wed, 26 Oct 2022 09:43:32 -0700 (PDT) Received: by mail-qt1-x82c.google.com with SMTP id f22so10334645qto.3 for ; Wed, 26 Oct 2022 09:43:32 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=ofHed6JKbGC+4Jz+O/EarTAHvckHPCUIcHhSeApLDCY=; b=aLHFjwdPYnXhsOuoVkL22zMxztdJ1NzDk0d67uV+NhvXrrXlj+xPGlsIblK1BxbOFM elBxoi2cdqe/RbXw3Iyg9+QptTvx757noY2zmvA7X/I7CVBVddCMN63snWzPgge2D/RC vwrBTEGuKKXinBTMXBekKcHx2BknBzrunN6LdsFUhfZk9zpKKy8K6/T/GmW5LLkf/92d iCHa8iJwdx5dj8++qiim2LwLWdl16iieAqESA4YFhIhsEP3ZKRTMtukqnxwJMXh3zKlP TKtt6DN8TQD3d3ygdGXH9rVzHAMYfPyCJ2quWIbjdvwXku30KgDYT5k0oRZVQbJyoUYW FS8w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=ofHed6JKbGC+4Jz+O/EarTAHvckHPCUIcHhSeApLDCY=; b=sf9BIxMGpSEVPI3nkgQ/qru4OKQc52HNGqtTdZiIxfpfQz+xx5YS9NanYiNVyG4bLq sru45pkRTeFgcHEduozfsuiiAEgNmGAOfXOYjebD54MfyRHdDkjbh4dNUj1Hw1bg7uZC 4NEV1aKhv1gCmjzR5ZossK7NAbayJn0WgW1Y3XGhYHRgCSkUvNGXwPKd3jnoDnWz02bG M0ZhDTjEOvbxzZa8rV0UPqDl+2GoGywvBRpYC+D3Rf1eASBzFnqaoLoWszXOoypVghYe Wbdr0mORhthgSRrHZ3M5DAtRLDfcM+IZ/Y9lZ7DcoSkQx7ojfY0qYqmoBLjaquJ9VXJf TQkQ== X-Gm-Message-State: ACrzQf01x68VTKhcL6jjuLAnTdRtCpLKt03soNhe0dQl/UIHMCGoxIuk k/gEIN3W17H3FFpv7rnj9pWlo9A89kBDQQ== X-Google-Smtp-Source: AMsMyM5KNhaj6JZ7ZYNxNOyH6EoB9XYMvL1EJLKX69PWjefo7oe7gE8B4IZyuqNQbcJWtRMDiq7wdw== X-Received: by 2002:ac8:5b93:0:b0:39b:1a8f:bbbc with SMTP id a19-20020ac85b93000000b0039b1a8fbbbcmr37258513qta.477.1666802601182; Wed, 26 Oct 2022 09:43:21 -0700 (PDT) Received: from krzk-bin.. ([64.57.193.93]) by smtp.gmail.com with ESMTPSA id j6-20020a37c246000000b006eed47a1a1esm3989938qkm.134.2022.10.26.09.43.19 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 26 Oct 2022 09:43:20 -0700 (PDT) From: Krzysztof Kozlowski To: Srinivas Kandagatla , Rob Herring , Krzysztof Kozlowski , Andy Gross , Bjorn Andersson , Konrad Dybcio , alsa-devel@alsa-project.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-arm-msm@vger.kernel.org Cc: Krzysztof Kozlowski , Rob Herring Subject: [PATCH v3 1/3] dt-bindings: slimbus: convert bus description to DT schema Date: Wed, 26 Oct 2022 12:43:13 -0400 Message-Id: <20221026164315.39038-2-krzysztof.kozlowski@linaro.org> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20221026164315.39038-1-krzysztof.kozlowski@linaro.org> References: <20221026164315.39038-1-krzysztof.kozlowski@linaro.org> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" Convert the SLIMbus bus description bindings to DT Schema. Signed-off-by: Krzysztof Kozlowski Reviewed-by: Rob Herring --- .../devicetree/bindings/slimbus/bus.txt | 60 ------------ .../bindings/slimbus/slim-ngd-qcom-ctrl.txt | 2 - .../bindings/slimbus/slim-qcom-ctrl.txt | 3 - .../devicetree/bindings/slimbus/slimbus.yaml | 95 +++++++++++++++++++ 4 files changed, 95 insertions(+), 65 deletions(-) delete mode 100644 Documentation/devicetree/bindings/slimbus/bus.txt create mode 100644 Documentation/devicetree/bindings/slimbus/slimbus.yaml diff --git a/Documentation/devicetree/bindings/slimbus/bus.txt b/Documentat= ion/devicetree/bindings/slimbus/bus.txt deleted file mode 100644 index bbe871f82a8b..000000000000 --- a/Documentation/devicetree/bindings/slimbus/bus.txt +++ /dev/null @@ -1,60 +0,0 @@ -SLIM(Serial Low Power Interchip Media Bus) bus - -SLIMbus is a 2-wire bus, and is used to communicate with peripheral -components like audio-codec. - -Required property for SLIMbus controller node: -- compatible - name of SLIMbus controller - -Child nodes: -Every SLIMbus controller node can contain zero or more child nodes -representing slave devices on the bus. Every SLIMbus slave device is -uniquely determined by the enumeration address containing 4 fields: -Manufacturer ID, Product code, Device index, and Instance value for -the device. -If child node is not present and it is instantiated after device -discovery (slave device reporting itself present). - -In some cases it may be necessary to describe non-probeable device -details such as non-standard ways of powering up a device. In -such cases, child nodes for those devices will be present as -slaves of the SLIMbus controller, as detailed below. - -Required property for SLIMbus child node if it is present: -- reg - Should be ('Device index', 'Instance ID') from SLIMbus - Enumeration Address. - Device Index Uniquely identifies multiple Devices within - a single Component. - Instance ID Is for the cases where multiple Devices of the - same type or Class are attached to the bus. - -- compatible -"slimMID,PID". The textual representation of Manufacturer ID, - Product Code, shall be in lower case hexadecimal with leading - zeroes suppressed - -Optional property for SLIMbus child node if it is present: -- slim-ifc-dev - Should be phandle to SLIMBus Interface device. - Required for devices which deal with streams. - -SLIMbus example for Qualcomm's slimbus manager component: - - slim@28080000 { - compatible =3D "qcom,apq8064-slim", "qcom,slim"; - reg =3D <0x28080000 0x2000>, - interrupts =3D <0 33 0>; - clocks =3D <&lcc SLIMBUS_SRC>, <&lcc AUDIO_SLIMBUS_CLK>; - clock-names =3D "iface", "core"; - #address-cells =3D <2>; - #size-cell =3D <0>; - - codec_ifd: ifd@0,0{ - compatible =3D "slim217,60"; - reg =3D <0 0>; - }; - - codec: wcd9310@1,0{ - compatible =3D "slim217,60"; - reg =3D <1 0>; - slim-ifc-dev =3D <&codec_ifd>; - }; - }; diff --git a/Documentation/devicetree/bindings/slimbus/slim-ngd-qcom-ctrl.t= xt b/Documentation/devicetree/bindings/slimbus/slim-ngd-qcom-ctrl.txt index e94a2ad3a710..7c3d9eb6af5d 100644 --- a/Documentation/devicetree/bindings/slimbus/slim-ngd-qcom-ctrl.txt +++ b/Documentation/devicetree/bindings/slimbus/slim-ngd-qcom-ctrl.txt @@ -5,8 +5,6 @@ with SLIMBus slaves directly over the bus using messaging i= nterface and communicating with master component residing on ADSP for bandwidth and data-channel management =20 -Please refer to slimbus/bus.txt for details of the common SLIMBus bindings. - - compatible: Usage: required Value type: diff --git a/Documentation/devicetree/bindings/slimbus/slim-qcom-ctrl.txt b= /Documentation/devicetree/bindings/slimbus/slim-qcom-ctrl.txt index 922dcb8ff24a..6d955e129f90 100644 --- a/Documentation/devicetree/bindings/slimbus/slim-qcom-ctrl.txt +++ b/Documentation/devicetree/bindings/slimbus/slim-qcom-ctrl.txt @@ -4,9 +4,6 @@ master component. =20 Required properties: =20 - - #address-cells - refer to Documentation/devicetree/bindings/slimbus/bus= .txt - - #size-cells - refer to Documentation/devicetree/bindings/slimbus/bus.txt - - reg : Offset and length of the register region(s) for the device - reg-names : Register region name(s) referenced in reg above Required register resource entries are: diff --git a/Documentation/devicetree/bindings/slimbus/slimbus.yaml b/Docum= entation/devicetree/bindings/slimbus/slimbus.yaml new file mode 100644 index 000000000000..22513fb7c59a --- /dev/null +++ b/Documentation/devicetree/bindings/slimbus/slimbus.yaml @@ -0,0 +1,95 @@ +# SPDX-License-Identifier: GPL-2.0 OR BSD-2-Clause +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/slimbus/slimbus.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: SLIM (Serial Low Power Interchip Media) bus + +maintainers: + - Srinivas Kandagatla + +description: + SLIMbus is a 2-wire bus, and is used to communicate with peripheral + components like audio-codec. + +properties: + $nodename: + pattern: "^slim(@.*|-[0-9a-f])*$" + + "#address-cells": + const: 2 + + "#size-cells": + const: 0 + +patternProperties: + "^.*@[0-9a-f]+,[0-9a-f]+$": + type: object + description: | + Every SLIMbus controller node can contain zero or more child nodes + representing slave devices on the bus. Every SLIMbus slave device is + uniquely determined by the enumeration address containing 4 fields:: + Manufacturer ID, Product code, Device index, and Instance value for = the + device. + + If child node is not present and it is instantiated after device + discovery (slave device reporting itself present). + + In some cases it may be necessary to describe non-probeable device + details such as non-standard ways of powering up a device. In such c= ases, + child nodes for those devices will be present as slaves of the SLIMb= us + controller. + + properties: + compatible: + pattern: "^slim[0-9a-f]+,[0-9a-f]+$" + + reg: + maxItems: 1 + description: | + Pair of (device index, instande ID), where:: + - Device index, which uniquely identifies multiple devices with= in a + single component. + - Instance ID, can be used for the cases where multiple devices= of + the same type or class are attached to the bus. + + required: + - compatible + - reg + + additionalProperties: true + +required: + - "#address-cells" + - "#size-cells" + +additionalProperties: true + +examples: + - | + #include + #include + #include + + soc { + #address-cells =3D <1>; + #size-cells =3D <1>; + ranges; + + slim@28080000 { + compatible =3D "qcom,apq8064-slim", "qcom,slim"; + reg =3D <0x28080000 0x2000>, <0x80207c 4>; + reg-names =3D "ctrl", "slew"; + interrupts =3D ; + clocks =3D <&lcc SLIMBUS_SRC>, <&lcc AUDIO_SLIMBUS_CLK>; + clock-names =3D "iface", "core"; + #address-cells =3D <2>; + #size-cells =3D <0>; + + audio-codec@1,0 { + compatible =3D "slim217,60"; + reg =3D <1 0>; + }; + }; + }; --=20 2.34.1 From nobody Mon Feb 9 16:42:47 2026 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 vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 3C665C38A2D for ; Wed, 26 Oct 2022 16:43:42 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S233657AbiJZQnj (ORCPT ); Wed, 26 Oct 2022 12:43:39 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:37138 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233665AbiJZQna (ORCPT ); Wed, 26 Oct 2022 12:43:30 -0400 Received: from mail-qk1-x730.google.com (mail-qk1-x730.google.com [IPv6:2607:f8b0:4864:20::730]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 16E528E0EF for ; Wed, 26 Oct 2022 09:43:28 -0700 (PDT) Received: by mail-qk1-x730.google.com with SMTP id l9so8450233qkk.11 for ; Wed, 26 Oct 2022 09:43:28 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=BIA0TAnjcVDeqXmtPoACZFO0zgCM9Z55/uYMEChmV1k=; b=DnaSniz76YewGQnj5EPw1fXqIqAMb0oJN8iiXLcbefMKhjPfPPHbH6bqRqpd2R2RQj EB9Wc6g/4HWkAhM7l90AwCxoYAmmzb2ksp9Cy/SjPSJAkUTGdzanA+wNDaCztMH5GdZ0 +cR9SkfGoB76vHIPt/VZejcBEew7qolcfqHe0EFsK57Lu43L7pnJ/un0Vyzu+aecznBf av4EFWZFoZutYrnjJHxY2id52VVEAuJn2PUnQIBTHMo8eUusXOcjz9fqqtGY7E+817CM tRDrNGwU1YMjQcB81ccd7O6vRdP3f1UYupBvxTwFVdvEwGz1nckWr0jRr8Qc1LgTlex+ 7FHA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=BIA0TAnjcVDeqXmtPoACZFO0zgCM9Z55/uYMEChmV1k=; b=mKn8IKlS3wpNhsIVKUQypHfMToqa4D709QGQuUke24yzXuM3K99PrwwehdBn1dbzOr Ts6gIux0OQ8xv37Mn8WpPgZ1MLvW1OgFR/cEPmtp6pUbXP2thGRXbHNz9s3FrFgO7Kx5 +ap2ctLzxy/BJXMiStnFHpZCzltBm30JqBDDjb/Uw7y2TVojgnD8stwefIjxe3I7QhMB qYj4Yty5j9JI0+hzlxNNMcuBD+lkVuYKaVWdAp76eUE8DY3gox9y+bGHq7tfYJr2Jx3E RPJjCoswRr04I/SENbb4WLSeQR+q6qE/Vpy6T8OddVi9vpllU4mCV97rBqeV4JGBKG2/ GnmA== X-Gm-Message-State: ACrzQf3EOn85eSurlyddQ13xuHea0GjHVobnjimr12MRdcysIxSUcu60 qgaC2Gtek/6f2aqki9BWfpxSzQ== X-Google-Smtp-Source: AMsMyM7HETuiwIYKBMytIbgqH9N83uGDN9wZHZlSpMqnIT3Rvsr5r+Cmv0bqKVDzeSHP/bedqZpM0A== X-Received: by 2002:a37:2e84:0:b0:6cf:8dd4:7adc with SMTP id u126-20020a372e84000000b006cf8dd47adcmr32039987qkh.723.1666802602997; Wed, 26 Oct 2022 09:43:22 -0700 (PDT) Received: from krzk-bin.. ([64.57.193.93]) by smtp.gmail.com with ESMTPSA id j6-20020a37c246000000b006eed47a1a1esm3989938qkm.134.2022.10.26.09.43.21 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 26 Oct 2022 09:43:22 -0700 (PDT) From: Krzysztof Kozlowski To: Srinivas Kandagatla , Rob Herring , Krzysztof Kozlowski , Andy Gross , Bjorn Andersson , Konrad Dybcio , alsa-devel@alsa-project.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-arm-msm@vger.kernel.org Cc: Krzysztof Kozlowski , Rob Herring Subject: [PATCH v3 2/3] dt-bindings: slimbus: qcom,slim: convert to DT schema Date: Wed, 26 Oct 2022 12:43:14 -0400 Message-Id: <20221026164315.39038-3-krzysztof.kozlowski@linaro.org> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20221026164315.39038-1-krzysztof.kozlowski@linaro.org> References: <20221026164315.39038-1-krzysztof.kozlowski@linaro.org> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" Convert the Qualcomm SoC SLIMbus controller bindings to DT Schema. Signed-off-by: Krzysztof Kozlowski Reviewed-by: Rob Herring --- .../bindings/slimbus/qcom,slim.yaml | 86 +++++++++++++++++++ .../bindings/slimbus/slim-qcom-ctrl.txt | 36 -------- 2 files changed, 86 insertions(+), 36 deletions(-) create mode 100644 Documentation/devicetree/bindings/slimbus/qcom,slim.yaml delete mode 100644 Documentation/devicetree/bindings/slimbus/slim-qcom-ctr= l.txt diff --git a/Documentation/devicetree/bindings/slimbus/qcom,slim.yaml b/Doc= umentation/devicetree/bindings/slimbus/qcom,slim.yaml new file mode 100644 index 000000000000..883bda58ca97 --- /dev/null +++ b/Documentation/devicetree/bindings/slimbus/qcom,slim.yaml @@ -0,0 +1,86 @@ +# SPDX-License-Identifier: GPL-2.0 OR BSD-2-Clause +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/slimbus/qcom,slim.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Qualcomm SoC SLIMbus controller + +maintainers: + - Krzysztof Kozlowski + - Srinivas Kandagatla + +description: + SLIMbus controller used when applications processor controls SLIMbus mas= ter + component. + +allOf: + - $ref: slimbus.yaml# + +properties: + compatible: + items: + - enum: + - qcom,apq8064-slim + - const: qcom,slim + + reg: + items: + - description: Physical address of controller register blocks + - description: SLEW RATE register + + reg-names: + items: + - const: ctrl + - const: slew + + clocks: + items: + - description: Interface clock for this controller + - description: Interrupt for controller core's BAM + + clock-names: + items: + - const: iface + - const: core + + interrupts: + maxItems: 1 + +required: + - compatible + - reg + - reg-names + - clocks + - clock-names + - interrupts + +unevaluatedProperties: false + +examples: + - | + #include + #include + #include + + soc { + #address-cells =3D <1>; + #size-cells =3D <1>; + ranges; + + slim@28080000 { + compatible =3D "qcom,apq8064-slim", "qcom,slim"; + reg =3D <0x28080000 0x2000>, <0x80207c 4>; + reg-names =3D "ctrl", "slew"; + interrupts =3D ; + clocks =3D <&lcc SLIMBUS_SRC>, <&lcc AUDIO_SLIMBUS_CLK>; + clock-names =3D "iface", "core"; + #address-cells =3D <2>; + #size-cells =3D <0>; + + audio-codec@1,0 { + compatible =3D "slim217,60"; + reg =3D <1 0>; + }; + }; + }; diff --git a/Documentation/devicetree/bindings/slimbus/slim-qcom-ctrl.txt b= /Documentation/devicetree/bindings/slimbus/slim-qcom-ctrl.txt deleted file mode 100644 index 6d955e129f90..000000000000 --- a/Documentation/devicetree/bindings/slimbus/slim-qcom-ctrl.txt +++ /dev/null @@ -1,36 +0,0 @@ -Qualcomm SLIMbus controller -This controller is used if applications processor driver controls SLIMbus -master component. - -Required properties: - - - reg : Offset and length of the register region(s) for the device - - reg-names : Register region name(s) referenced in reg above - Required register resource entries are: - "ctrl": Physical address of controller register blocks - "slew": required for "qcom,apq8064-slim" SOC. - - compatible : should be "qcom,-slim" for SOC specific compatib= le - followed by "qcom,slim" for fallback. - - interrupts : Interrupt number used by this controller - - clocks : Interface and core clocks used by this SLIMbus controller - - clock-names : Required clock-name entries are: - "iface" : Interface clock for this controller - "core" : Interrupt for controller core's BAM - -Example: - - slim@28080000 { - compatible =3D "qcom,apq8064-slim", "qcom,slim"; - reg =3D <0x28080000 0x2000>, <0x80207C 4>; - reg-names =3D "ctrl", "slew"; - interrupts =3D <0 33 0>; - clocks =3D <&lcc SLIMBUS_SRC>, <&lcc AUDIO_SLIMBUS_CLK>; - clock-names =3D "iface", "core"; - #address-cells =3D <2>; - #size-cell =3D <0>; - - wcd9310: audio-codec@1,0{ - compatible =3D "slim217,60"; - reg =3D <1 0>; - }; - }; --=20 2.34.1 From nobody Mon Feb 9 16:42:47 2026 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 vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 970E3C433FE for ; Wed, 26 Oct 2022 16:43:37 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S233706AbiJZQnf (ORCPT ); Wed, 26 Oct 2022 12:43:35 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:36970 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233657AbiJZQna (ORCPT ); Wed, 26 Oct 2022 12:43:30 -0400 Received: from mail-qt1-x82f.google.com (mail-qt1-x82f.google.com [IPv6:2607:f8b0:4864:20::82f]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id A8AC072EC3 for ; Wed, 26 Oct 2022 09:43:27 -0700 (PDT) Received: by mail-qt1-x82f.google.com with SMTP id bb5so10312734qtb.11 for ; Wed, 26 Oct 2022 09:43:27 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=Ap86oaX2me6LTIfHjN4MG9KcHVBwjDqudIZuJpAwdCI=; b=UmtCcKD4KAPnaB2ke6wYCS13xUHB24tXh8DiLOfjGIFkhzqDAiYkLoijyVH6bvtsdN G+paNpE9WfDbFaws+qf/yo2UJPMDAxKjYrwVQ67FdnOeBJqEcI3utIBJFUT50PMx7eSI 424VVhMC81YL2Xnp2MPXuwVdsD/y/ece7QA08tA+udUlutE70e0DnnNaRobtHeEZIkMi T0gEqEEqH0u5fpi91wRFOBv2966MuC58YThD/u8PeEi06+xoOb7qE1DLvRLxlLp70piQ Dch1+VBt7Qjmd9rvckF8fM7lNZCf2qXLY+Kco8xAKGTD5HB349qhEcPOpk8fsQKtf9l1 o55g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=Ap86oaX2me6LTIfHjN4MG9KcHVBwjDqudIZuJpAwdCI=; b=Jsvfxxzf8P7UBGTafVS5qn9okUxLs5FALmuVy5i4xXHS8SG7qTg1vvf8DIbeTsZyxL Q6zGLhdMoKQrSBmsbNm/y/iR9GS0CjOxW0joZNoUeJcL/tobvHMxdSBcbwAlv7DLLLZG /GjvoyeMAzJtorzYfQAfz2NiRTg1NYIlNy9ZWFj5BSBogsv7l+b6gZygMwYn3QAFGLjj zTwOcd6YdjHEUDCsDiiYJvWewG8xmeKY2C05cGxLM19fqv7oZb4T9K8/b1CMWGf4DEhO Kd9oZmm1GhzUB7yB1e15YhPRtuR8/yBR3xxRUG4CeVX5q66daEPyUTlqQi3kGUTt1S1y JVUw== X-Gm-Message-State: ACrzQf0eaQ/X/GmCXEe1umzDsUY+HAyf+VLe9HVhRTlnbDOso0nH8i7x E/0lhyiarxrII72tc0KpZHZwGQ== X-Google-Smtp-Source: AMsMyM7mzANluI1ojMSrgWhKzF9ZFo0jBVVdvaI8FpeHTJXfky9mEFQ+e/VN2xn18XU2F2Hsu9kJAg== X-Received: by 2002:a05:622a:178e:b0:39c:c9ac:b4ad with SMTP id s14-20020a05622a178e00b0039cc9acb4admr38620979qtk.82.1666802606807; Wed, 26 Oct 2022 09:43:26 -0700 (PDT) Received: from krzk-bin.. ([64.57.193.93]) by smtp.gmail.com with ESMTPSA id j6-20020a37c246000000b006eed47a1a1esm3989938qkm.134.2022.10.26.09.43.25 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 26 Oct 2022 09:43:26 -0700 (PDT) From: Krzysztof Kozlowski To: Srinivas Kandagatla , Rob Herring , Krzysztof Kozlowski , Andy Gross , Bjorn Andersson , Konrad Dybcio , alsa-devel@alsa-project.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-arm-msm@vger.kernel.org Cc: Krzysztof Kozlowski , Rob Herring Subject: [PATCH v3 3/3] dt-bindings: slimbus: qcom,slim-ngd: convert to DT schema Date: Wed, 26 Oct 2022 12:43:15 -0400 Message-Id: <20221026164315.39038-4-krzysztof.kozlowski@linaro.org> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20221026164315.39038-1-krzysztof.kozlowski@linaro.org> References: <20221026164315.39038-1-krzysztof.kozlowski@linaro.org> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" Convert the Qualcomm SoC SLIMBus Non Generic Device (NGD) controller bindings to DT Schema. During conversion add iommus already present in DTS and extend the example based on SDM845. Signed-off-by: Krzysztof Kozlowski Reviewed-by: Rob Herring --- .../bindings/slimbus/qcom,slim-ngd.yaml | 120 ++++++++++++++++++ .../bindings/slimbus/slim-ngd-qcom-ctrl.txt | 82 ------------ 2 files changed, 120 insertions(+), 82 deletions(-) create mode 100644 Documentation/devicetree/bindings/slimbus/qcom,slim-ngd= .yaml delete mode 100644 Documentation/devicetree/bindings/slimbus/slim-ngd-qcom= -ctrl.txt diff --git a/Documentation/devicetree/bindings/slimbus/qcom,slim-ngd.yaml b= /Documentation/devicetree/bindings/slimbus/qcom,slim-ngd.yaml new file mode 100644 index 000000000000..abf61c15246e --- /dev/null +++ b/Documentation/devicetree/bindings/slimbus/qcom,slim-ngd.yaml @@ -0,0 +1,120 @@ +# SPDX-License-Identifier: GPL-2.0 OR BSD-2-Clause +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/slimbus/qcom,slim-ngd.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Qualcomm SoC SLIMBus Non Generic Device (NGD) Controller + +maintainers: + - Krzysztof Kozlowski + - Srinivas Kandagatla + +description: + SLIMBus NGD controller is a light-weight driver responsible for communic= ating + with SLIMBus slaves directly over the bus using messaging interface and + communicating with master component residing on ADSP for bandwidth and + data-channel management + +properties: + compatible: + enum: + - qcom,slim-ngd-v1.5.0 # for MSM8996 + - qcom,slim-ngd-v2.1.0 # for SDM845 + + reg: + maxItems: 1 + + "#address-cells": + const: 1 + + "#size-cells": + const: 0 + + dmas: + maxItems: 2 + + dma-names: + items: + - const: rx + - const: tx + + interrupts: + maxItems: 1 + + iommus: + maxItems: 1 + +patternProperties: + "^slim@[0-9a-f]+$": + type: object + $ref: slimbus.yaml# + description: + Each subnode represents an instance of NGD + + properties: + reg: + maxItems: 1 + + unevaluatedProperties: false + +required: + - compatible + - reg + - "#address-cells" + - "#size-cells" + - dmas + - dma-names + - interrupts + +additionalProperties: false + +examples: + - | + #include + #include + + slim-ngd@171c0000 { + compatible =3D "qcom,slim-ngd-v2.1.0"; + reg =3D <0x171c0000 0x2c000>; + interrupts =3D ; + + dmas =3D <&slimbam 3>, <&slimbam 4>; + dma-names =3D "rx", "tx"; + iommus =3D <&apps_smmu 0x1806 0x0>; + #address-cells =3D <1>; + #size-cells =3D <0>; + + slim@1 { + reg =3D <1>; + #address-cells =3D <2>; + #size-cells =3D <0>; + + codec@1,0 { + compatible =3D "slim217,250"; + reg =3D <1 0>; + slim-ifc-dev =3D <&wcd9340_ifd>; + + #sound-dai-cells =3D <1>; + + interrupts-extended =3D <&tlmm 54 IRQ_TYPE_LEVEL_HIGH>; + interrupt-controller; + #interrupt-cells =3D <1>; + + #clock-cells =3D <0>; + clock-frequency =3D <9600000>; + clock-output-names =3D "mclk"; + qcom,micbias1-microvolt =3D <1800000>; + qcom,micbias2-microvolt =3D <1800000>; + qcom,micbias3-microvolt =3D <1800000>; + qcom,micbias4-microvolt =3D <1800000>; + + #address-cells =3D <1>; + #size-cells =3D <1>; + + reset-gpios =3D <&tlmm 64 GPIO_ACTIVE_HIGH>; + + /* Rest of the WCD9340 codec */ + }; + }; + }; diff --git a/Documentation/devicetree/bindings/slimbus/slim-ngd-qcom-ctrl.t= xt b/Documentation/devicetree/bindings/slimbus/slim-ngd-qcom-ctrl.txt deleted file mode 100644 index 7c3d9eb6af5d..000000000000 --- a/Documentation/devicetree/bindings/slimbus/slim-ngd-qcom-ctrl.txt +++ /dev/null @@ -1,82 +0,0 @@ -Qualcomm SLIMBus Non Generic Device (NGD) Controller binding - -SLIMBus NGD controller is a light-weight driver responsible for communicat= ing -with SLIMBus slaves directly over the bus using messaging interface and -communicating with master component residing on ADSP for bandwidth and -data-channel management - -- compatible: - Usage: required - Value type: - Definition: must be "qcom,slim-ngd-v.." - must be one of the following. - "qcom,slim-ngd-v1.5.0" for MSM8996 - "qcom,slim-ngd-v2.1.0" for SDM845 - -- reg: - Usage: required - Value type: - Definition: must specify the base address and size of the controller - register space. -- dmas - Usage: required - Value type: - Definition: List of rx and tx dma channels - -- dma-names - Usage: required - Value type: - Definition: must be "rx" and "tx". - -- interrupts: - Usage: required - Value type: - Definition: must list controller IRQ. - -#address-cells - Usage: required - Value type: - Definition: Should be 1, reflecting the instance id of ngd. - -#size-cells - Usage: required - Value type: - Definition: Should be 0 - -=3D NGD Devices -Each subnode represents an instance of NGD, must contain the following -properties: - -- reg: - Usage: required - Value type: - Definition: Should be instance id of ngd. - -#address-cells - Usage: required - Refer to slimbus/bus.txt for details of the common SLIMBus bindings. - -#size-cells - Usage: required - Refer to slimbus/bus.txt for details of the common SLIMBus bindings. - -=3D EXAMPLE - -slim@91c0000 { - compatible =3D "qcom,slim-ngd-v1.5.0"; - reg =3D <0x91c0000 0x2c000>; - interrupts =3D <0 163 0>; - dmas =3D <&slimbam 3>, <&slimbam 4>; - dma-names =3D "rx", "tx"; - #address-cells =3D <1>; - #size-cells =3D <0>; - ngd@1 { - reg =3D <1>; - #address-cells =3D <1>; - #size-cells =3D <1>; - codec@1 { - compatible =3D "slim217,1a0"; - reg =3D <1 0>; - }; - }; -}; --=20 2.34.1