Received: by 2002:a05:7412:419a:b0:f3:1519:9f41 with SMTP id i26csp4361497rdh; Tue, 28 Nov 2023 21:45:06 -0800 (PST) X-Google-Smtp-Source: AGHT+IH6UZoEZ7vtAm8KEDHpTaHcqQkskMm65WhkIgdN9N3FMC+8+9eREjMLuWafoBARs3WQuoRz X-Received: by 2002:a17:902:da8e:b0:1cf:b190:ea07 with SMTP id j14-20020a170902da8e00b001cfb190ea07mr19925659plx.21.1701236705821; Tue, 28 Nov 2023 21:45:05 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1701236705; cv=none; d=google.com; s=arc-20160816; b=MVllqbmPmEV5y+lnx//4GGPWTvv0PIeY/0Uh+Fneiepq8t4ThTHbAPL9S6BPmVrOhQ 6JbcqyiF/nruXIunO/6ZlO5/ijdKfCK8hnUO2JhfjpgPw7KKFyzj87028ZXHdOshw9vB fcHzQxaGGD6fdSbGOF9qI91mkRxiGlut79qoMb4HRS1z+gzN0TFfa+SNOkdTSgF7YRkS FDU3PpLARVL8cWXVMQu/jDNZ5lsidRfyJluqrpX3VNWGuTevn+wNdPWbhRNfbu0oujtG vKFqZTqolKfQcAvjYL9fGmmOtibCO9ZJlyaXKpgoFjKxCpY38C4xuWYKJmakQPjmKhci LYZQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from; bh=O1bZCCT5tvQshTc2OVB/8HbLpz9L92MTqjTwIjSvoq4=; fh=WFfSZ30M3MwRSUZws1XCpSZ3KabagKfba+4etJWHuZE=; b=gEqj1jitfiBaAFixc1SYC4slHq8lQ6ATIti94Jpjq5HVHMZk543mRzQVy9HczhW+Td dkjH7t++WB6pRqL9I2ub5mBOoc9QMJm4jaYvdi/3Uhvits+hAZWLb1LNa2ayRlqUI9Ef KdZrkNAxSYs3xjxoJGk5P5QPO9n9o8FrwmNITJ8Qw2gX1Y/6dtp3GnvwUMiT6YV9Mn6Z +vnvZfyvwa5+6OR90RILFLnctGvE8W+FxpFJu7KnvqQd4df7gIFr6o5poEVzB50dyK8o aciR7TpAABGNZfU1oCzrF6vjVc0ET6KpkEQKYvOqFetP42xrfdEOlS4Ag02yxfBg2MUO khKw== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.38 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from fry.vger.email (fry.vger.email. [23.128.96.38]) by mx.google.com with ESMTPS id jg19-20020a17090326d300b001c9af5305dasi7594833plb.126.2023.11.28.21.45.05 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 28 Nov 2023 21:45:05 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.38 as permitted sender) client-ip=23.128.96.38; Authentication-Results: mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.38 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by fry.vger.email (Postfix) with ESMTP id 02DD280A64D9; Tue, 28 Nov 2023 21:44:59 -0800 (PST) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.11 at fry.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1376959AbjK2Foi (ORCPT + 99 others); Wed, 29 Nov 2023 00:44:38 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:41654 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S234682AbjK2Fog (ORCPT ); Wed, 29 Nov 2023 00:44:36 -0500 Received: from rtits2.realtek.com.tw (rtits2.realtek.com [211.75.126.72]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id D398D19B7; Tue, 28 Nov 2023 21:44:41 -0800 (PST) X-SpamFilter-By: ArmorX SpamTrap 5.78 with qID 3AT5iOiX52554686, This message is accepted by code: ctloc85258 Received: from mail.realtek.com (rtexh36506.realtek.com.tw[172.21.6.27]) by rtits2.realtek.com.tw (8.15.2/2.95/5.92) with ESMTPS id 3AT5iOiX52554686 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Wed, 29 Nov 2023 13:44:24 +0800 Received: from RTEXMBS03.realtek.com.tw (172.21.6.96) by RTEXH36506.realtek.com.tw (172.21.6.27) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.17; Wed, 29 Nov 2023 13:44:24 +0800 Received: from james-bs01.realtek.com.tw (172.21.190.247) by RTEXMBS03.realtek.com.tw (172.21.6.96) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2375.7; Wed, 29 Nov 2023 13:44:23 +0800 From: James Tai To: Thomas Gleixner , Marc Zyngier , "Rob Herring" , Krzysztof Kozlowski , Conor Dooley , James Tai CC: , , "kernel test robot" Subject: [PATCH v3 1/6] dt-bindings: interrupt-controller: Add support for Realtek DHC SoCs Date: Wed, 29 Nov 2023 13:43:34 +0800 Message-ID: <20231129054339.3054202-2-james.tai@realtek.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20231129054339.3054202-1-james.tai@realtek.com> References: <20231129054339.3054202-1-james.tai@realtek.com> MIME-Version: 1.0 Content-Transfer-Encoding: 7BIT Content-Type: text/plain; charset=US-ASCII X-Originating-IP: [172.21.190.247] X-ClientProxiedBy: RTEXH36506.realtek.com.tw (172.21.6.27) To RTEXMBS03.realtek.com.tw (172.21.6.96) X-KSE-ServerInfo: RTEXMBS03.realtek.com.tw, 9 X-KSE-AntiSpam-Interceptor-Info: fallback X-KSE-Antivirus-Interceptor-Info: fallback X-KSE-AntiSpam-Interceptor-Info: fallback X-Spam-Status: No, score=-0.8 required=5.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,T_SCC_BODY_TEXT_LINE autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on fry.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (fry.vger.email [0.0.0.0]); Tue, 28 Nov 2023 21:44:59 -0800 (PST) Add the YAML documentation for Realtek DHC (Digital Home Center) SoCs. Reported-by: kernel test robot Closes: https://lore.kernel.org/oe-kbuild-all/202311180921.ayKhiFHL-lkp@intel.com/ CC: Thomas Gleixner CC: Marc Zyngier CC: Rob Herring CC: Krzysztof Kozlowski CC: Conor Dooley CC: linux-kernel@vger.kernel.org CC: devicetree@vger.kernel.org Signed-off-by: James Tai --- v2 to v3 change: - Retested the bindings using the new version of the dtschema - Fixed the order of property items - Removed redundant files and replaced them with 'realtek,intc.yaml' - Replaced 'interrupts-extended' with 'interrupts' - Added a description for 'interrupts' - Reduced the example code v1 to v2 change: - Tested the bindings using 'make dt_binding_check' - Fixed code style issues .../interrupt-controller/realtek,intc.yaml | 76 +++++++++++++++++++ 1 file changed, 76 insertions(+) create mode 100644 Documentation/devicetree/bindings/interrupt-controller/realtek,intc.yaml diff --git a/Documentation/devicetree/bindings/interrupt-controller/realtek,intc.yaml b/Documentation/devicetree/bindings/interrupt-controller/realtek,intc.yaml new file mode 100644 index 000000000000..3aa863b1549d --- /dev/null +++ b/Documentation/devicetree/bindings/interrupt-controller/realtek,intc.yaml @@ -0,0 +1,76 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/interrupt-controller/realtek,intc.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Realtek DHC SoCs Interrupt Controller + +maintainers: + - James Tai + +description: + This interrupt controller is a component of Realtek DHC (Digital Home Center) + SoCs and is designed to receive interrupts from peripheral devices. + + Each DHC SoC has two sets of interrupt controllers, each capable of + handling up to 32 interrupts. + +allOf: + - $ref: /schemas/interrupt-controller.yaml# + +properties: + compatible: + enum: + - realtek,rtd1319-intc-iso + - realtek,rtd1319-intc-misc + - realtek,rtd1319d-intc-iso + - realtek,rtd1319d-intc-misc + - realtek,rtd1325-intc-iso + - realtek,rtd1325-intc-misc + - realtek,rtd1619b-intc-iso + - realtek,rtd1619b-intc-misc + + reg: + maxItems: 1 + + interrupt-controller: true + + '#interrupt-cells': + const: 1 + + '#address-cells': + const: 0 + + interrupts: + description: | + Contains the GIC SPI IRQs mapped to the external interrupt lines. + minItems: 2 + maxItems: 4 + +required: + - compatible + - reg + - interrupt-controller + - '#interrupt-cells' + - '#address-cells' + - interrupts + +additionalProperties: false + +examples: + - | + #include + #include + + realtek_iso_intc: interrupt-controller@40 { + compatible = "realtek,rtd1319-intc-iso"; + reg = <0x00 0x40>; + interrupt-parent = <&gic>; + interrupts = , + ; + interrupt-controller; + #address-cells = <0>; + #interrupt-cells = <1>; + }; +... -- 2.25.1