From patchwork Mon Feb 12 08:34:25 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Krzysztof Kozlowski X-Patchwork-Id: 199620 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7300:50ea:b0:106:860b:bbdd with SMTP id r10csp2302048dyd; Mon, 12 Feb 2024 00:35:38 -0800 (PST) X-Google-Smtp-Source: AGHT+IFV6leeRZPYAjr3TqCfEWl7tONhLmJkZgyh1XkdZ2cwFWYBX1BqW4Iyo/YggFKY5PGJW1he X-Received: by 2002:a05:6870:d1c4:b0:219:71dd:9cee with SMTP id b4-20020a056870d1c400b0021971dd9ceemr7964408oac.40.1707726938705; Mon, 12 Feb 2024 00:35:38 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1707726938; cv=pass; d=google.com; s=arc-20160816; b=UQK72/KSNsOTldE5InCTUtld8vtwOgnVLchlRZhPBfH3gmVz/GgyGNHA4gCUMdxzuZ ptFQwXV+KS/0Yrmvb5BWKJSa8uIgS84BeAM4AEgldNJpqHaCOKyHSo3mlFKl/wWTLD5n 4AhGzaUif91q1MizXW6lebvlP9zRWS5z2Gbeh+TVYAT+5Nj5mewr6nUNJJ9wkjpVIDSn e/zKjRQYFj+USStgkLaZfq63/ISeSX1STApPxLc+VY1RmLhcMpqyAztLyiwmbFyic67P scQcWHBZszufo9CUwiSADBSXp1y8zvQ4AHY9ZRLYx4mGirfxqNoO12hbqhP3GsIr2Ba6 gaTg== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:references:in-reply-to:message-id :date:subject:cc:to:from:dkim-signature; bh=n00h9GUfOjmdouhiAceBbh8Ez7j7mnB3Royxt1AWIfw=; fh=nbuiulE392sNn4eIHbJ0/m8YQfb0q4QBeglSaDDQMEQ=; b=PmqzkvQm4e/M87TMnjUHe/VqK9g18Ykw4dfglbmT4TVlZ9Q0JCdK34luaH7e9lJM29 EB1M97mKx9se/OHvAUsH8mCXNctKq9pciIantQOiw4p2sWoHyCsmPLRLaBC9Z8FbbFOJ n5hrp2eBJJE+1l12RX070EBQUiShCff2POQb7mnEzkaxM5dhOS1q5yRnnO6SjcisJAfq 7lY3mTYk1Q63EFm3RvoqnUPRSWlAv4nGuX3tJrmZwjMp+O0ktw/vMpOgdYfPLmxYKQHF VLrIJxUSBb3xD1y96xj8vgSg10RwdNlS/8zMWkF950MA3H9FJ4ip6LoQR5Grj7YFX8Gg FPlg==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=pG62keyl; arc=pass (i=1 spf=pass spfdomain=linaro.org dkim=pass dkdomain=linaro.org dmarc=pass fromdomain=linaro.org); spf=pass (google.com: domain of linux-kernel+bounces-61207-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-61207-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org X-Forwarded-Encrypted: i=2; AJvYcCX81bD5LhdLRSjPj9bf5yXikky66sCAuRBYrg/hk4oQI0mqdk8CNOT+ctqc4Ui6zh6MAbbdAIaBWGhAQ+UZfpgvtuRjLg== Received: from sv.mirrors.kernel.org (sv.mirrors.kernel.org. [2604:1380:45e3:2400::1]) by mx.google.com with ESMTPS id x19-20020a63b213000000b005d8b313de26si5944713pge.594.2024.02.12.00.35.38 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 12 Feb 2024 00:35:38 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-61207-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) client-ip=2604:1380:45e3:2400::1; Authentication-Results: mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=pG62keyl; arc=pass (i=1 spf=pass spfdomain=linaro.org dkim=pass dkdomain=linaro.org dmarc=pass fromdomain=linaro.org); spf=pass (google.com: domain of linux-kernel+bounces-61207-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-61207-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.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 sv.mirrors.kernel.org (Postfix) with ESMTPS id BF8102810A7 for ; Mon, 12 Feb 2024 08:35:29 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id B96E612E4A; Mon, 12 Feb 2024 08:34:39 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=linaro.org header.i=@linaro.org header.b="pG62keyl" Received: from mail-wr1-f48.google.com (mail-wr1-f48.google.com [209.85.221.48]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 251D310A1C for ; Mon, 12 Feb 2024 08:34:32 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.48 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1707726875; cv=none; b=LyQnSL8RCjC9JFoIHdEZnE2ss3KjAMyDgcuovjIKtr/jWEMJL7AV0U7+g37lDLgRjWV0+KXJO6bvVWqcpXB5XjWQbZOrvAeAq+uf0qtUSMxgVGYh8Ycap4j+ALKVUa0aZZQ2XgyIZv3+87nhd9h9PA/YM9RJwTAw6/CSfZYhb40= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1707726875; c=relaxed/simple; bh=ezeCOINnmkavLUEDTtpk9CBlRiLMmuI1yO5MV1yO3OU=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=PbwiDpKlTaQzpraeZAo9P/xKeh4vTrTukTXCBt18baYq6yas7BTCI57JUN5SZEZLZpkNmOxIxM4SNfwN9w0eoAGWVNB13a08vEkNXHZCOvMSSIZOB7PIuudkDdvCdj7SAWAvlfZX1bEAOkS0C4y5KBczpsb9QtC82vUHdZ7WZUA= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linaro.org; spf=pass smtp.mailfrom=linaro.org; dkim=pass (2048-bit key) header.d=linaro.org header.i=@linaro.org header.b=pG62keyl; arc=none smtp.client-ip=209.85.221.48 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linaro.org Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=linaro.org Received: by mail-wr1-f48.google.com with SMTP id ffacd0b85a97d-33b815b182fso431858f8f.3 for ; Mon, 12 Feb 2024 00:34:32 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; t=1707726871; x=1708331671; darn=vger.kernel.org; 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=n00h9GUfOjmdouhiAceBbh8Ez7j7mnB3Royxt1AWIfw=; b=pG62keylkMGpnyfmYEtO4cNDmFTbXZDp4dorYvymQ/dEOkX8f1zZTv9/j9O2JBvE6x YzC0mUqeHz7jgfgPvofNB74SYtl2eAeJCcEFxPg13X3B7qh9PpxsqCjgjwWqERrbzByB /EnoUe9uyOD2PlBZjdMFliXOkWsgqD4/BsJgjUv3qHOBtpzoPHkdOqLN4x+YVe8zbSYP VRL6lWFVDe6Vi7Qb2XUzsBXXsyj81zj2RMCIKN8OTQK2KiKX1sx1p6M6Y7BIGY2G7vuv WNxuzlKaOM2mCoCSnRIKVS8ERE3l0ybw1cjqudlfXmezSkPs1Tg2DMqzHmFeStEyDMkp gIkQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1707726871; x=1708331671; 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=n00h9GUfOjmdouhiAceBbh8Ez7j7mnB3Royxt1AWIfw=; b=IeqyQSoUix7ws8ZgsAHZq2HH3/fEdypwoE0K0byL04FDLM6U028AEv60vP01UWk8FL RlfS5ASq+kfcgoLlm64VSqzbTqhr5hiD7j0pHrmxr1QfkokWH8DSRQzpvvbfiK4Y8ddK Mmm8D2WmoFeuM4/tKaYojmImPxXWnbUQ633z7X9hcc8UkyfFlaJNYkb1gkFLUG/MvzfU 6bpUlqdGcRgwnIGh1fAQLVisxAW1nKoEoWdj6XAIWFCFYvWO8rOZml0FQcSlRMExzS79 YklDspX+mnS58Grp4SGWN8aDJBWBkb5NOyZKRFLOHM54A/eqfMt1XYAZJZYK9OKJJGtR RVNw== X-Gm-Message-State: AOJu0YwSpXJ9Bx2W5OBa/aa/AMadEPikP/sE6KOA9Or7MmzrNEqN1JEe qFLvJ0j43x0mEuowDjrbz+J9UvTr4UrzLjduxdX2Yc43PYjkb6CXdjbbmxQ7Q2flhi+QUbTz0/z Z X-Received: by 2002:adf:ffcc:0:b0:33b:72f2:2283 with SMTP id x12-20020adfffcc000000b0033b72f22283mr3898515wrs.17.1707726871337; Mon, 12 Feb 2024 00:34:31 -0800 (PST) X-Forwarded-Encrypted: i=1; AJvYcCWIMPGbPGKj/ISTNTpZQ5sl+ZSeRI5+lO+VSwkznpnFqPHBMRhMJOWz/d+js7L9/KYpGTXAG7BTK/aCsHZfd4LlTrCbcifFKOL4weDCk2KgCjrTMssGtDgsi4ViMi4QnA8zkJ46f+XrHkMNVVR2XozK+PS/NTBD0DGWjdMz8uUcI+MMYe8naqzALQRlgn1gmgs6B/s8IikEtiSroDkNDBjh/XFWj4iM2dPGoxC8L8CYpi+63Hb2YSX7ap+F7ro+O4q4KtcfZxdjzYPl2CmEvFvLKsTrOzv4vGE1b/pcdKEqVrDozwwhJFTDFi9cF+L4TSIM7tN8GSqa4jRCNJcRW+H9AH+sBCjYjY80iYz2e3Tw8tNmaUifylSR1g4coXGoFG61bogPUEA9J7XmJDo= Received: from krzk-bin.. ([178.197.223.6]) by smtp.gmail.com with ESMTPSA id y12-20020a056000108c00b0033b40a3f92asm6111024wrw.25.2024.02.12.00.34.30 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 12 Feb 2024 00:34:30 -0800 (PST) From: Krzysztof Kozlowski To: Linus Walleij , Miguel Ojeda , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Robin van der Gracht , Paul Burton , Geert Uytterhoeven , linux-arm-kernel@lists.infradead.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org Cc: Krzysztof Kozlowski , Andy Shevchenko Subject: [PATCH 2/3] dt-bindings: auxdisplay: adjust example indentation and use generic node names Date: Mon, 12 Feb 2024 09:34:25 +0100 Message-Id: <20240212083426.26757-2-krzysztof.kozlowski@linaro.org> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20240212083426.26757-1-krzysztof.kozlowski@linaro.org> References: <20240212083426.26757-1-krzysztof.kozlowski@linaro.org> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1790681482625687247 X-GMAIL-MSGID: 1790681482625687247 The example DTS should be indented with two or four (preferred) spaces, as mentioned in Writing Schema document. While re-indenting, change the node names to somehow generic names, as expected by Devicetree specification. Cc: Andy Shevchenko Signed-off-by: Krzysztof Kozlowski Reviewed-by: Andy Shevchenko --- .../auxdisplay/arm,versatile-lcd.yaml | 4 +- .../bindings/auxdisplay/hit,hd44780.yaml | 44 ++++++++-------- .../bindings/auxdisplay/holtek,ht16k33.yaml | 50 +++++++++---------- .../bindings/auxdisplay/img,ascii-lcd.yaml | 4 +- 4 files changed, 51 insertions(+), 51 deletions(-) diff --git a/Documentation/devicetree/bindings/auxdisplay/arm,versatile-lcd.yaml b/Documentation/devicetree/bindings/auxdisplay/arm,versatile-lcd.yaml index 5d02bd032a85..439f7b811a94 100644 --- a/Documentation/devicetree/bindings/auxdisplay/arm,versatile-lcd.yaml +++ b/Documentation/devicetree/bindings/auxdisplay/arm,versatile-lcd.yaml @@ -39,6 +39,6 @@ additionalProperties: false examples: - | lcd@10008000 { - compatible = "arm,versatile-lcd"; - reg = <0x10008000 0x1000>; + compatible = "arm,versatile-lcd"; + reg = <0x10008000 0x1000>; }; diff --git a/Documentation/devicetree/bindings/auxdisplay/hit,hd44780.yaml b/Documentation/devicetree/bindings/auxdisplay/hit,hd44780.yaml index 73d07f2cb303..1c7fd29bbcc7 100644 --- a/Documentation/devicetree/bindings/auxdisplay/hit,hd44780.yaml +++ b/Documentation/devicetree/bindings/auxdisplay/hit,hd44780.yaml @@ -84,32 +84,32 @@ additionalProperties: false examples: - | #include - auxdisplay { - compatible = "hit,hd44780"; + display-controller { + compatible = "hit,hd44780"; - data-gpios = <&hc595 0 GPIO_ACTIVE_HIGH>, - <&hc595 1 GPIO_ACTIVE_HIGH>, - <&hc595 2 GPIO_ACTIVE_HIGH>, - <&hc595 3 GPIO_ACTIVE_HIGH>; - enable-gpios = <&hc595 4 GPIO_ACTIVE_HIGH>; - rs-gpios = <&hc595 5 GPIO_ACTIVE_HIGH>; + data-gpios = <&hc595 0 GPIO_ACTIVE_HIGH>, + <&hc595 1 GPIO_ACTIVE_HIGH>, + <&hc595 2 GPIO_ACTIVE_HIGH>, + <&hc595 3 GPIO_ACTIVE_HIGH>; + enable-gpios = <&hc595 4 GPIO_ACTIVE_HIGH>; + rs-gpios = <&hc595 5 GPIO_ACTIVE_HIGH>; - display-height-chars = <2>; - display-width-chars = <16>; + display-height-chars = <2>; + display-width-chars = <16>; }; - | #include - hd44780 { - compatible = "hit,hd44780"; - display-height-chars = <2>; - display-width-chars = <16>; - data-gpios = <&pcf8574 4 0>, - <&pcf8574 5 0>, - <&pcf8574 6 0>, - <&pcf8574 7 0>; - enable-gpios = <&pcf8574 2 0>; - rs-gpios = <&pcf8574 0 0>; - rw-gpios = <&pcf8574 1 0>; - backlight-gpios = <&pcf8574 3 0>; + display-controller { + compatible = "hit,hd44780"; + display-height-chars = <2>; + display-width-chars = <16>; + data-gpios = <&pcf8574 4 0>, + <&pcf8574 5 0>, + <&pcf8574 6 0>, + <&pcf8574 7 0>; + enable-gpios = <&pcf8574 2 0>; + rs-gpios = <&pcf8574 0 0>; + rw-gpios = <&pcf8574 1 0>; + backlight-gpios = <&pcf8574 3 0>; }; diff --git a/Documentation/devicetree/bindings/auxdisplay/holtek,ht16k33.yaml b/Documentation/devicetree/bindings/auxdisplay/holtek,ht16k33.yaml index be95f6b97b41..b90eec2077b4 100644 --- a/Documentation/devicetree/bindings/auxdisplay/holtek,ht16k33.yaml +++ b/Documentation/devicetree/bindings/auxdisplay/holtek,ht16k33.yaml @@ -74,31 +74,31 @@ examples: #include #include i2c { - #address-cells = <1>; - #size-cells = <0>; + #address-cells = <1>; + #size-cells = <0>; - ht16k33: ht16k33@70 { - compatible = "holtek,ht16k33"; - reg = <0x70>; - refresh-rate-hz = <20>; - interrupt-parent = <&gpio4>; - interrupts = <5 (IRQ_TYPE_LEVEL_HIGH | IRQ_TYPE_EDGE_RISING)>; - debounce-delay-ms = <50>; - linux,keymap = , - , - , - , - , - , - , - , - , - ; + display-controller@70 { + compatible = "holtek,ht16k33"; + reg = <0x70>; + refresh-rate-hz = <20>; + interrupt-parent = <&gpio4>; + interrupts = <5 (IRQ_TYPE_LEVEL_HIGH | IRQ_TYPE_EDGE_RISING)>; + debounce-delay-ms = <50>; + linux,keymap = , + , + , + , + , + , + , + , + , + ; - led { - color = ; - function = LED_FUNCTION_BACKLIGHT; - linux,default-trigger = "backlight"; - }; + led { + color = ; + function = LED_FUNCTION_BACKLIGHT; + linux,default-trigger = "backlight"; }; - }; + }; + }; diff --git a/Documentation/devicetree/bindings/auxdisplay/img,ascii-lcd.yaml b/Documentation/devicetree/bindings/auxdisplay/img,ascii-lcd.yaml index 1899b23de7d1..55e9831b3f67 100644 --- a/Documentation/devicetree/bindings/auxdisplay/img,ascii-lcd.yaml +++ b/Documentation/devicetree/bindings/auxdisplay/img,ascii-lcd.yaml @@ -50,6 +50,6 @@ additionalProperties: false examples: - | lcd: lcd@17fff000 { - compatible = "img,boston-lcd"; - reg = <0x17fff000 0x8>; + compatible = "img,boston-lcd"; + reg = <0x17fff000 0x8>; };