From patchwork Wed May 28 12:11:38 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Dario Binacchi X-Patchwork-Id: 4065 Return-Path: X-Original-To: linux-amarula@patchwork.amarulasolutions.com Delivered-To: linux-amarula@patchwork.amarulasolutions.com Received: from mail-ed1-f69.google.com (mail-ed1-f69.google.com [209.85.208.69]) by ganimede.amarulasolutions.com (Postfix) with ESMTPS id 3DB233F31C for ; Wed, 28 May 2025 14:13:15 +0200 (CEST) Received: by mail-ed1-f69.google.com with SMTP id 4fb4d7f45d1cf-5fffdff91b4sf320620a12.2 for ; Wed, 28 May 2025 05:13:15 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1748434395; cv=pass; d=google.com; s=arc-20240605; b=i+F87K9Q8Sps3ZOoKtJn7mV6WyaOtqu0Ubp6M41ZjR/jG1YB050yH/hJgdiy8Ohtt4 rajDYQwgK5XxE1eAGUlBsJ4ImbSl9FOYrMUHSohlmoJL1Zg+W9nJdRsnIAVeAbNMHrO5 5zRsOq/XYayerlK/8y7TYLqv29VDxmlpXDn/BS0pzuAGnEsxBae55FhHWuBxnvBGLvjQ FgUzDo9IMRhEMAgr3LL3myyWlmq11g/OxsCu3lzDAoQDFLXYRTJe+baSR9qrzKOeMZvY z1rJuvnhJwkWefxdmLgo/x24RwZ4Rd1CW7D2bQj0kwN1rycJF8oXawDcLJh90AcTaUhX Bwlw== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605; h=list-unsubscribe:list-archive:list-help:list-post:list-id :mailing-list:precedence:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:dkim-signature; bh=bDwwBkyDQo3ZYVulYA8YWK9gXS0mHmW3Ntv8d978NLA=; fh=/OH8PO5EqcR5RhM8wrVLTd8giebHWABiBn51oXJwe1Q=; b=Q0qVHAKIG9Wk+U/vxi1HkPaF+fxaYan8f8eiO8it1nEw5WcXHBZ04aicVc/v3mb1YC scaB645W33M5c6pcLAU9LSJJN1sThgSJT2Lo9smi5iAp0b9I59kZLc1yGl3SvkSd9eYG 4dJDUMm4lUZ426UgV7EsM1pv4ElwPJmxkpd/YLjNaxqmZ+rAgsbF1mgPwziWlVFveGoj QILXO3cGEBKPzCKLnDp9j4NwxebPxEt+0HwG+kM1ndArqwCBGFTFuVExd1IeIetTb5ft 0n+XYt1N+l6dIjp3y179th5j0YVpmWWd4YSNGTJp0yME3O/Zf6SyHQ1gcFhENTfXKbCq 4F8Q==; darn=patchwork.amarulasolutions.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@amarulasolutions.com header.s=google header.b=oUqjvpXw; spf=pass (google.com: domain of dario.binacchi@amarulasolutions.com designates 209.85.220.41 as permitted sender) smtp.mailfrom=dario.binacchi@amarulasolutions.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=amarulasolutions.com; dara=pass header.i=@amarulasolutions.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=amarulasolutions.com; s=google; t=1748434395; x=1749039195; darn=patchwork.amarulasolutions.com; h=list-unsubscribe:list-archive:list-help:list-post:list-id :mailing-list:precedence:x-original-authentication-results :x-original-sender:mime-version:references:in-reply-to:message-id :date:subject:cc:to:from:from:to:cc:subject:date:message-id:reply-to; bh=bDwwBkyDQo3ZYVulYA8YWK9gXS0mHmW3Ntv8d978NLA=; b=AQ4joH/CnBaQYEYEaLW+LOp0zrAUzZtev8SwT8gVOzX/Rw4j7nONspgRbclNBpeoT2 YEelmGa1G9sYjqoxXZYj06R4M9r5rEVbkKf1JBoFOKLsERFblBZi//uyoHUkpquF87FS 8mLpI/eWSCXrDXaCsN7JlhM0gtBjUuxgbv/eA= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1748434395; x=1749039195; h=list-unsubscribe:list-archive:list-help:list-post :x-spam-checked-in-group:list-id:mailing-list:precedence :x-original-authentication-results:x-original-sender:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :x-beenthere:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=bDwwBkyDQo3ZYVulYA8YWK9gXS0mHmW3Ntv8d978NLA=; b=X2r2FurbYB0EyRlM38K5ZWThZCv+4KKIg65g6A7ucmcwxgO6m0uVcr5wfFQc8aSuuP k4D2xn1OJaiMeznN73Bm+UM0v83J2uuT+INuLAoc0Rik9xPiXNn199PBlvKtMMXlGNMN cQbeE4GE754Qz7ByrJxcRRax7WT5N8b7zSDR2FJ8b6fvK0tKa3nxYszxlvk2z4FmikOA eGId1y2pjTCaDmzUBF/ggn2AoEo0BomcHA8fo4pTWCBJsaYzqbiqMJ0rDW55FAEcSRwd JmXFvyXn4hjPtH+fm8cJFtaoD3zoWeabvfuDqjrogr/WXrmqgxjTLcduxyqLNEJFUXRu 4U+w== X-Forwarded-Encrypted: i=2; AJvYcCX4sqL/PQ8Ntk1WAlpy0thu78JlS5sEiCQBvaYAgcUqZppkb0oB1Pop/cv4xkr9pVp+dKHcFyP1xoSiec+D@patchwork.amarulasolutions.com X-Gm-Message-State: AOJu0Yz57fGuCOChnFenX2uqOMb8Jl2GUpfMhRk4i++QMZNKyQtc2xUl 1UlOrS+sUyIEfuwhfVUme9TJq+8JPb5YGxLoMizfoPk7nMMKhfIh710Gjxw3s2PnwWnsfg== X-Google-Smtp-Source: AGHT+IFAgrN6CUHKIOBOecaNOvs6pZEib3KXrB+0B+MV0YT5LvvzpIxj2aG+nTHVW7NKbqDT6GCL7w== X-Received: by 2002:a05:6402:3550:b0:602:427c:4570 with SMTP id 4fb4d7f45d1cf-602dafc7e9amr5752836a12.10.1748434394815; Wed, 28 May 2025 05:13:14 -0700 (PDT) X-BeenThere: linux-amarula@amarulasolutions.com; h=AZMbMZeZX6dduYOSclMryW3pYuSdZllA1sHx4VcoGdmOVqVV+Q== Received: by 2002:a05:6402:4307:b0:601:aedc:8e23 with SMTP id 4fb4d7f45d1cf-602cbb60a8bls194925a12.2.-pod-prod-03-eu; Wed, 28 May 2025 05:13:13 -0700 (PDT) X-Forwarded-Encrypted: i=2; AJvYcCVw8lSduvVFIIbBE+9Cfpt4WDEs0xqGzI+vuM+8Uu4iKzil4JOK/T0TuS+/D3u5r1YAD4Ne4i4rz9fr9rnV@amarulasolutions.com X-Received: by 2002:a17:907:7252:b0:aca:c507:a4e8 with SMTP id a640c23a62f3a-ad85b147700mr1253518266b.21.1748434392508; Wed, 28 May 2025 05:13:12 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1748434392; cv=none; d=google.com; s=arc-20240605; b=E6+XEFQEjYzVQAH5mVPKlwJ4GBndgF4si50z/lROSIimMtIb3aPPrdjWCsQrENud+V 3CbxZNkocngBPsEbh2dg5RLXKZfm+CdHtqaAklZghClBDRs72F43RylHFn2beGa4O7ro Nf0zUCvglklEUS0Hfqc7p8iEbuhxpLdPQTrCgqkSj+J5LUS7nQCfPj45xQ55uneCVzws CwXikxb7FlDIo7yZX2C9GcaY8u0TEL01Aw6Wnpt+xMZf2R2PWunafbHgYRe9Co7pkiqP vnhKdO4HZwG33iVfKxanekrthJA9hdindtL0MQOv755PTZ8ytjld9kBdfHL6LqevLJq6 pHOg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:dkim-signature; bh=LbcaZGbt/aOu/lBCcUk69RNM6cMf8NN5vQOyyRIAIOw=; fh=FuINm21K5FNmoX/lwLumO45fCibUkcnXWKpA75H94DE=; b=C29QLdDHR2ArOjn2pkBooiiYky5K9HVuKQaBlkMqovSXkkPWDZcRr9d8Z9FMIYIe5R 92J77Zj+itAfDq7KOVJhIC8+EG2jOIQOjf0q2Cx7MlZ0JMWk1zLSX/zIGfwmaNMSCMlv ZAWrT8+9OdmmsKkE49oYEovfigw4MZIhad/7rR+8LqKqfEIK6EStabsR56/R0Xu9mpnr GnVGaklp1qfgyL+igK1MSeY69Zz4hR4tEg/8NgBsMi6yNJ+ZtMd4othpMrFgYLzcZjg4 0uRH7o7U+DHnN07sna7ZLqFx3PQHh+BXuDCTTZ+s+9TJJdeovVOyqKueCxUhAgxYUHNf Z8uw==; dara=google.com ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@amarulasolutions.com header.s=google header.b=oUqjvpXw; spf=pass (google.com: domain of dario.binacchi@amarulasolutions.com designates 209.85.220.41 as permitted sender) smtp.mailfrom=dario.binacchi@amarulasolutions.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=amarulasolutions.com; dara=pass header.i=@amarulasolutions.com Received: from mail-sor-f41.google.com (mail-sor-f41.google.com. [209.85.220.41]) by mx.google.com with SMTPS id a640c23a62f3a-ad8a5223693sor47471166b.14.2025.05.28.05.13.12 for (Google Transport Security); Wed, 28 May 2025 05:13:12 -0700 (PDT) Received-SPF: pass (google.com: domain of dario.binacchi@amarulasolutions.com designates 209.85.220.41 as permitted sender) client-ip=209.85.220.41; X-Forwarded-Encrypted: i=1; AJvYcCVB5sBmzHLxUGbHRG0Noya5ihsmoud19cxsNnym8+yqsDs58Eb3TLsmt7fbzuYsJRFMi5qsh5CLVnEEKKvj@amarulasolutions.com X-Gm-Gg: ASbGncvBmno4F3kFc2jMtEi6hqbdmCsFZ4pvH9mnnGkKV0KcUkZQlpfRI3fKfGznwFs veH9/OYc1KOhHJbjfzCyUwnM/wwOOx4blNAZt/V1oyR6FDSbFfRbSV7Qi/QrI/jMPPUf1Ok9sNG fDweqO2cNXNMufLv6q6xrK+xCziR2v7ciK64PakIf6qOCzr2c4WKxDzP3C9NaSJyH72Vkq6kbaJ obSLYqNUMi46HAWR9033OopH6wL6Hzy8HJ4sQDon162C8DtW51i1TUlvJS9Dodj0dn7FRfjujWw 4rDfr4FWogtd1EMbKClyLBGsLpMeDtAfXgEeR0+GNckJ+wmOf7YeSOY4NtqTyND/SCQHFD3gw+U i5yUpytU8KYFz X-Received: by 2002:a17:907:2d0e:b0:ad8:89c7:2735 with SMTP id a640c23a62f3a-ad889c72964mr703027166b.58.1748434391971; Wed, 28 May 2025 05:13:11 -0700 (PDT) Received: from localhost.localdomain ([2001:b07:6474:ebbf:5631:61bf:398a:c492]) by smtp.gmail.com with ESMTPSA id a640c23a62f3a-ad8a1b5b8afsm98523266b.170.2025.05.28.05.13.10 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 28 May 2025 05:13:11 -0700 (PDT) From: Dario Binacchi To: linux-kernel@vger.kernel.org Cc: michael@amarulasolutions.com, linux-amarula@amarulasolutions.com, Dario Binacchi , Conor Dooley , Fabio Estevam , Krzysztof Kozlowski , Lee Jones , Pengutronix Kernel Team , Rob Herring , Sascha Hauer , Shawn Guo , devicetree@vger.kernel.org, imx@lists.linux.dev, linux-arm-kernel@lists.infradead.org Subject: [PATCH v2 1/4] dt-bindings: mfd: convert mxs-lradc bindings to json-schema Date: Wed, 28 May 2025 14:11:38 +0200 Message-ID: <20250528121306.1464830-2-dario.binacchi@amarulasolutions.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20250528121306.1464830-1-dario.binacchi@amarulasolutions.com> References: <20250528121306.1464830-1-dario.binacchi@amarulasolutions.com> MIME-Version: 1.0 X-Original-Sender: dario.binacchi@amarulasolutions.com X-Original-Authentication-Results: mx.google.com; dkim=pass header.i=@amarulasolutions.com header.s=google header.b=oUqjvpXw; spf=pass (google.com: domain of dario.binacchi@amarulasolutions.com designates 209.85.220.41 as permitted sender) smtp.mailfrom=dario.binacchi@amarulasolutions.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=amarulasolutions.com; dara=pass header.i=@amarulasolutions.com Content-Type: text/plain; charset="UTF-8" Precedence: list Mailing-list: list linux-amarula@amarulasolutions.com; contact linux-amarula+owners@amarulasolutions.com List-ID: X-Spam-Checked-In-Group: linux-amarula@amarulasolutions.com X-Google-Group-Id: 476853432473 List-Post: , List-Help: , List-Archive: List-Unsubscribe: , Convert the Freescale MXS Low-Resoulution ADC (LRADC) device tree binding documentation to json-schema. The clocks and #io-channel-cells properties have also been added; They are present in the respective SoC DTSI files but were missing from the old mxs-lradc.txt file. Signed-off-by: Dario Binacchi Reviewed-by: Conor Dooley --- (no changes since v1) .../devicetree/bindings/mfd/mxs-lradc.txt | 45 -------- .../devicetree/bindings/mfd/mxs-lradc.yaml | 106 ++++++++++++++++++ 2 files changed, 106 insertions(+), 45 deletions(-) delete mode 100644 Documentation/devicetree/bindings/mfd/mxs-lradc.txt create mode 100644 Documentation/devicetree/bindings/mfd/mxs-lradc.yaml diff --git a/Documentation/devicetree/bindings/mfd/mxs-lradc.txt b/Documentation/devicetree/bindings/mfd/mxs-lradc.txt deleted file mode 100644 index 755cbef0647d..000000000000 --- a/Documentation/devicetree/bindings/mfd/mxs-lradc.txt +++ /dev/null @@ -1,45 +0,0 @@ -* Freescale MXS LRADC device driver - -Required properties: -- compatible: Should be "fsl,imx23-lradc" for i.MX23 SoC and "fsl,imx28-lradc" - for i.MX28 SoC -- reg: Address and length of the register set for the device -- interrupts: Should contain the LRADC interrupts - -Optional properties: -- fsl,lradc-touchscreen-wires: Number of wires used to connect the touchscreen - to LRADC. Valid value is either 4 or 5. If this - property is not present, then the touchscreen is - disabled. 5 wires is valid for i.MX28 SoC only. -- fsl,ave-ctrl: number of samples per direction to calculate an average value. - Allowed value is 1 ... 32, default is 4 -- fsl,ave-delay: delay between consecutive samples. Allowed value is - 2 ... 2048. It is used if 'fsl,ave-ctrl' > 1, counts at - 2 kHz and its default is 2 (= 1 ms) -- fsl,settling: delay between plate switch to next sample. Allowed value is - 1 ... 2047. It counts at 2 kHz and its default is - 10 (= 5 ms) - -Example for i.MX23 SoC: - - lradc@80050000 { - compatible = "fsl,imx23-lradc"; - reg = <0x80050000 0x2000>; - interrupts = <36 37 38 39 40 41 42 43 44>; - fsl,lradc-touchscreen-wires = <4>; - fsl,ave-ctrl = <4>; - fsl,ave-delay = <2>; - fsl,settling = <10>; - }; - -Example for i.MX28 SoC: - - lradc@80050000 { - compatible = "fsl,imx28-lradc"; - reg = <0x80050000 0x2000>; - interrupts = <10 14 15 16 17 18 19 20 21 22 23 24 25>; - fsl,lradc-touchscreen-wires = <5>; - fsl,ave-ctrl = <4>; - fsl,ave-delay = <2>; - fsl,settling = <10>; - }; diff --git a/Documentation/devicetree/bindings/mfd/mxs-lradc.yaml b/Documentation/devicetree/bindings/mfd/mxs-lradc.yaml new file mode 100644 index 000000000000..90391b02c715 --- /dev/null +++ b/Documentation/devicetree/bindings/mfd/mxs-lradc.yaml @@ -0,0 +1,106 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/mfd/mxs-lradc.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Freescale MXS Low-Resoulution ADC (LRADC) + +maintainers: + - Dario Binacchi + +description: | + The LRADC provides 16 physical channels of 12-bit resolution + for analog-to-digital conversion and includes an integrated + 4-wire/5-wire touchscreen controller. + +properties: + compatible: + items: + - enum: + - fsl,imx23-lradc + - fsl,imx28-lradc + + reg: + maxItems: 1 + + clocks: + minItems: 1 + + interrupts: + minItems: 9 + maxItems: 13 + + fsl,lradc-touchscreen-wires: + $ref: /schemas/types.yaml#/definitions/uint32 + description: | + Number of wires used to connect the touchscreen to LRADC. + If this property is not present, then the touchscreen is disabled. + + fsl,ave-ctrl: + $ref: /schemas/types.yaml#/definitions/uint32 + minimum: 1 + maximum: 32 + default: 4 + description: | + Number of samples per direction to calculate an average value. + + fsl,ave-delay: + $ref: /schemas/types.yaml#/definitions/uint32 + minimum: 2 + maximum: 2048 + default: 2 + description: | + Delay between consecutive samples. + It is used if 'fsl,ave-ctrl' > 1, counts at 2 kHz and its + default value (i. e. 2) is 1 ms. + + fsl,settling: + $ref: /schemas/types.yaml#/definitions/uint32 + minimum: 1 + maximum: 2047 + default: 10 + description: | + Delay between plate switch to next sample. + It counts at 2 kHz and its default (i. e. 10) is 5 ms. + + "#io-channel-cells": + const: 1 + +required: + - compatible + - reg + - clocks + - interrupts + +if: + properties: + compatible: + contains: + enum: + - fsl,imx23-lradc +then: + properties: + fsl,lradc-touchscreen-wires: + const: 4 +else: + properties: + fsl,lradc-touchscreen-wires: + enum: [4, 5] + +additionalProperties: false + +examples: + - | + lradc@80050000 { + compatible = "fsl,imx23-lradc"; + reg = <0x80050000 0x2000>; + interrupts = <36>, <37>, <38>, <39>, <40>, + <41>, <42>, <43>, <44>; + clocks = <&clks 26>; + #io-channel-cells = <1>; + fsl,lradc-touchscreen-wires = <4>; + fsl,ave-ctrl = <4>; + fsl,ave-delay = <2>; + fsl,settling = <10>; + };