From mboxrd@z Thu Jan 1 00:00:00 1970 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 kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id B2E74C25B4E for ; Fri, 20 Jan 2023 14:10:45 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 0D9A96B0083; Fri, 20 Jan 2023 09:10:35 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 08C1F6B0085; Fri, 20 Jan 2023 09:10:35 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id E1D016B0087; Fri, 20 Jan 2023 09:10:34 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0010.hostedemail.com [216.40.44.10]) by kanga.kvack.org (Postfix) with ESMTP id CDCDC6B0083 for ; Fri, 20 Jan 2023 09:10:34 -0500 (EST) Received: from smtpin12.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay05.hostedemail.com (Postfix) with ESMTP id 9ACC840752 for ; Fri, 20 Jan 2023 14:10:34 +0000 (UTC) X-FDA: 80375362788.12.125A1D6 Received: from fx408.security-mail.net (smtpout140.security-mail.net [85.31.212.148]) by imf30.hostedemail.com (Postfix) with ESMTP id 61DBC80012 for ; Fri, 20 Jan 2023 14:10:32 +0000 (UTC) Authentication-Results: imf30.hostedemail.com; dkim=pass header.d=kalray.eu header.s=sec-sig-email header.b=enPtBMlg; dkim=fail ("body hash did not verify") header.d=kalray.eu header.s=32AE1B44-9502-11E5-BA35-3734643DEF29 header.b=oFg5sEcC; dmarc=pass (policy=quarantine) header.from=kalray.eu; spf=pass (imf30.hostedemail.com: domain of ysionneau@kalray.eu designates 85.31.212.148 as permitted sender) smtp.mailfrom=ysionneau@kalray.eu ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1674223832; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=N+buMGQfyj8H9LZfk2bZRB42T0brPjeI6Z2Y51DkaQ0=; b=I4GITlmuEVkLAvgvEPsoGIdXlrJO7WyVxV6xm4TpJK0MNULXWmYPyuL/8eOlp4kaxW00Sx qQOcX4H6v2M9CTFj+j3slu5TYChpxLJ0IJ466uJvmHMl3Bh3QJdidEbjLKwP5SjPm/n/EO Utg6awVA4UcmXzUttWVDfV8mG3ducIo= ARC-Authentication-Results: i=1; imf30.hostedemail.com; dkim=pass header.d=kalray.eu header.s=sec-sig-email header.b=enPtBMlg; dkim=fail ("body hash did not verify") header.d=kalray.eu header.s=32AE1B44-9502-11E5-BA35-3734643DEF29 header.b=oFg5sEcC; dmarc=pass (policy=quarantine) header.from=kalray.eu; spf=pass (imf30.hostedemail.com: domain of ysionneau@kalray.eu designates 85.31.212.148 as permitted sender) smtp.mailfrom=ysionneau@kalray.eu ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1674223832; a=rsa-sha256; cv=none; b=Q7VXE3HeYhnauq0u7Lwe/tq6iQc6uBcOapV5Ip0go8fgit2DKRMDsjdGUnUa+WKorFvfJY SxcvI36anOU8UkinX0HqnUu2ioxzf7u3Ly6RQa21t2iD9Q6V/O6Ci2Arr+JZgeOWXspMqA sr43P4a7mrgue9IutVUzU80+2hVOEzY= Received: from localhost (fx408.security-mail.net [127.0.0.1]) by fx408.security-mail.net (Postfix) with ESMTP id E0D4C322B10 for ; Fri, 20 Jan 2023 15:10:30 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kalray.eu; s=sec-sig-email; t=1674223830; bh=ipV6uYEByPI5c+C5yQy7aqSsXm8TxX991WZckgEkaks=; h=From:To:Cc:Subject:Date:In-Reply-To:References; b=enPtBMlgijWkgJPHy1+C4J8pxkBUdpoe+uRA4SsIH1HR2pZMqYFy1OVZX5Vwf722E H5z3grhM3e3wG87tXJX561kMtxifRtFeny1c+AgH09RsnkUtu5ZB4pvuVIt6Ksr2tO JQnzexogxKmHJnRnAGfgj7Ri8eig2gP1ors0kJX0= Received: from fx408 (fx408.security-mail.net [127.0.0.1]) by fx408.security-mail.net (Postfix) with ESMTP id CD7EA322725; Fri, 20 Jan 2023 15:10:29 +0100 (CET) Received: from zimbra2.kalray.eu (unknown [217.181.231.53]) by fx408.security-mail.net (Postfix) with ESMTPS id 84EBF3229C1; Fri, 20 Jan 2023 15:10:27 +0100 (CET) Received: from zimbra2.kalray.eu (localhost [127.0.0.1]) by zimbra2.kalray.eu (Postfix) with ESMTPS id 4587527E043A; Fri, 20 Jan 2023 15:10:27 +0100 (CET) Received: from localhost (localhost [127.0.0.1]) by zimbra2.kalray.eu (Postfix) with ESMTP id 0E1ED27E0430; Fri, 20 Jan 2023 15:10:27 +0100 (CET) Received: from zimbra2.kalray.eu ([127.0.0.1]) by localhost (zimbra2.kalray.eu [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id qEQcUNiyIIfp; Fri, 20 Jan 2023 15:10:26 +0100 (CET) Received: from junon.lin.mbt.kalray.eu (unknown [192.168.37.161]) by zimbra2.kalray.eu (Postfix) with ESMTPSA id 6DE6527E0437; Fri, 20 Jan 2023 15:10:26 +0100 (CET) X-Virus-Scanned: E-securemail Secumail-id: <1010c.63caa0d3.82e25.0> DKIM-Filter: OpenDKIM Filter v2.10.3 zimbra2.kalray.eu 0E1ED27E0430 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=kalray.eu; s=32AE1B44-9502-11E5-BA35-3734643DEF29; t=1674223827; bh=BhrYTlway6H47k+1WH6tY+7D+lekRPB9kTC8Yr1liXc=; h=From:To:Date:Message-Id:MIME-Version; b=oFg5sEcCLpoupdKUAJVDuBV1Yxh9BZLNZVHVECdDWl/HZrggI6m//7aB/zUkRD5ML GDYlchdCVVn7Xb9cxeNZJNnf8AI3loDdEUh6uWAVMFL+FcHinJp2cSNSasIrxrWySo +2PhSeUvRBMs9MSoflMTXb8aLv5jpAfzT4Fxwp0k= From: Yann Sionneau To: Arnd Bergmann , Jonathan Corbet , Thomas Gleixner , Marc Zyngier , Rob Herring , Krzysztof Kozlowski , Will Deacon , Peter Zijlstra , Boqun Feng , Mark Rutland , Eric Biederman , Kees Cook , Oleg Nesterov , Ingo Molnar , Waiman Long , "Aneesh Kumar K.V" , Andrew Morton , Nick Piggin , Paul Moore , Eric Paris , Christian Brauner , Paul Walmsley , Palmer Dabbelt , Albert Ou , Jules Maselbas , Yann Sionneau , Guillaume Thouvenin , Clement Leger , Vincent Chardon , Marc =?utf-8?b?UG91bGhpw6hz?= , Julian Vetter , Samuel Jones , Ashley Lesdalons , Thomas Costis , Marius Gligor , Jonathan Borne , Julien Villette , Luc Michel , Louis Morhet , Julien Hascoet , Jean-Christophe Pince , Guillaume Missonnier , Alex Michon , Huacai Chen , WANG Xuerui , Shaokun Zhang , John Garry , Guangbin Huang , Bharat Bhushan , Bibo Mao , Atish Patra , "Jason A. Donenfeld" , Qi Liu , Jiaxun Yang , Catalin Marinas , Mark Brown , Janosch Frank , Alexey Dobriyan Cc: Benjamin Mugnier , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, linux-mm@kvack.org, linux-arch@vger.kernel.org, linux-audit@redhat.com, linux-riscv@lists.infradead.org, bpf@vger.kernel.org Subject: [RFC PATCH v2 05/31] Documentation: Add binding for kalray,coolidge-itgen Date: Fri, 20 Jan 2023 15:09:36 +0100 Message-ID: <20230120141002.2442-6-ysionneau@kalray.eu> X-Mailer: git-send-email 2.37.2 In-Reply-To: <20230120141002.2442-1-ysionneau@kalray.eu> References: <20230120141002.2442-1-ysionneau@kalray.eu> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Type: text/plain; charset=utf-8 X-ALTERMIMEV2_out: done X-Rspamd-Queue-Id: 61DBC80012 X-Rspamd-Server: rspam09 X-Rspam-User: X-Stat-Signature: 8jbrbu5qjsh3jyj4c1wrd5aohkwfo3cs X-HE-Tag: 1674223832-293868 X-HE-Meta: U2FsdGVkX187+ug23pvK7QJRrncH4sEjqcKt2b8LPUG9esoSO9oCYbpQHCafFaX1nVgpVIwccg9qw4nnhmJuSphFhyIeJGJTCB46bE+q33Ys7g10eD1vyLao1ywBUT1GUWxfPEKR5qInbOXZKnlOmZRq1d76faFeMFgxlKLG/a6+qjCBZAeYTkRJL87PxJsLNZ1Ka/9BLtjNdJbgwxzaABVaVJMgmpLiM6Kv9WY6eodmTMspTxjtaFwofcfkc+ZsIo/dE41jgZ/ULZnfcVlb0il9F5SrLb9DrxpHlknduLl1cYi7uH9O5Tw/jgF4LgWhnCbP5TbEL5vdTm6q5v+Txnbv5XfrCnae9FKuh23CFLLdFW+cvtKhSWhgkTLparZ+237VWneacRq6y68ZqsvCMChhCKNx3UhRKz6SuuVCxtXoWszsO1RNGOzt1EpsGITlwIprbm9WHZRraJtoOIcTABFG1bGtRaZJCTlRnbKsmvVMUWOsMEVlxsvssodhB8GbFp5fREInkxuXzSP82Aey50WsNBLNaQhDD3U/PMgBJg00T7w/gqY88BggNR5t9T1FpBuBkmvMfiK23qBrPg8URF4O9jsu6YY4+AngqQHkUENSuJVJG1vNcYYkJk33OxhqKmwxa/0mah6cBtTxr2TTRKtPI+ZKLSRHQFd6Eb82Q7ZnwsU/5kT0AbKCyJBQOsPKigH7/ocy9zEO0MVFhPd1PbK3VgFq/obgMWa/sp4i1TvL0W6zbALkGJawPzWGLHxYVxJC03p525UWSxYiziZZtXPL4uAS7Osd0bF6Qr7u7bBMA2BNmyKItIgehcNWwZZTkpdvm56QPza16geSDqZ4aTow6imMdvPheafC+DfuGENYRZeOh8ZJ2XiHEj3SEtcEBhEQEALMVvxjTjVb6vC0czM2XzNY+Bqhm2tYgPhkZ5/reEnep/e9a7AhmH/iHEl0tlwtYfxVCIKN6SOibjP 1DvCZ7Wi 7R0lkfWbZd4wImV1IgzMZYb1lPAYDOAU8YHG7cbpBl9gKgZZ8sgtzZXKvU8lmtKNAJSQOgdzugSoTAowk4v3wtfvMGg9/M5ncESiGWXfFkYM4PlqgetJ8w/8Y26W7Bv1S8EBo+jPoW9ostGsajM6ce249YqKmpOSfWi3V4yu8zqL1i3eOD2C5XxvwXeQmOtDeTUYypYNnWCY1LOfrQ3leWmJu8qBD9L0C+anK1zPWvzdCD3zeCD25wFPv26mJzcHYilyF2k8cKbS62a2rcbNvkimerKlKX1XmRoIw9yL/Dq7s5ySlEPdKAf+72eiDVaoGLBjSgCFqOq0pBbOwl4a0guGyTdFdo/0XsQcSvGJ/DzM1cpKHyuShrDVjFANhp1qPTvVdHWXcGIj36YeOiPicvYvXMAfOYXE5GohXKuWA/sYP6UF7sEN+7koO64+hRirqawg6gerK4vqg6QRE1z7DCo4n4QTzolNZGnlDcTJCt7wKDkAanDhULrFtXeb4UamrcFzHVjaMyb5j5vcDBd3BGLGFdbWYT/jrfUuXcs2Z9l1UpzX3Uw7nGG8HWh8BWMO+i81z943ZrG6g5X10Wph8AjpZHPlLLKyKyw13cR37sfoe6b2vOvibpB4sB2G/Ku0rRtctJoQR2sjST8OpDZlfO3qhhL8rmQypZB9Z99sQHqEWZqO6GxhdyuRdLR5jQ740YYdsHYTuVTLPRONxdRO/kfF1eatgO1VNRhI/4Xi8NLno0jRmTbWk6zl/Aw== X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: From: Jules Maselbas Add documentation for `kalray,coolidge-itgen` binding. Co-developed-by: Jules Maselbas Signed-off-by: Jules Maselbas Signed-off-by: Yann Sionneau --- Notes: V1 -> V2: new patch .../kalray,coolidge-itgen.yaml | 48 +++++++++++++++++++ 1 file changed, 48 insertions(+) create mode 100644 Documentation/devicetree/bindings/interrupt-controller/kalray,coolidge-itgen.yaml diff --git a/Documentation/devicetree/bindings/interrupt-controller/kalray,coolidge-itgen.yaml b/Documentation/devicetree/bindings/interrupt-controller/kalray,coolidge-itgen.yaml new file mode 100644 index 000000000000..47b503bff1d9 --- /dev/null +++ b/Documentation/devicetree/bindings/interrupt-controller/kalray,coolidge-itgen.yaml @@ -0,0 +1,48 @@ +# SPDX-License-Identifier: GPL-2.0 +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/interrupt-controller/kalray,coolidge-itgen# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Kalray Coolidge SoC Interrupt Generator (ITGEN) + +description: | + The Interrupt Generator (ITGEN) is an interrupt controller block. + It's purpose is to convert IRQ lines coming from SoC peripherals into writes + on the AXI bus. The ITGEN intended purpose is to write into the APIC mailboxes. + +allOf: + - $ref: /schemas/interrupt-controller.yaml# + +properties: + compatible: + const: kalray,coolidge-itgen + + "#interrupt-cells": + const: 2 + description: | + - 1st cell is for the IRQ number + - 2nd cell is for the trigger type as defined dt-bindings/interrupt-controller/irq.h + + interrupt-controller: true + + msi-parent: true + +required: + - compatible + - reg + - "#interrupt-cells" + - interrupt-controller + - msi-parent + +examples: + - | + itgen: interrupt-controller@27000000 { + compatible = "kalray,coolidge-itgen"; + reg = <0 0x27000000 0 0x1104>; + #interrupt-cells = <2>; + interrupt-controller; + msi-parent = <&apic_mailbox>; + }; + +... -- 2.37.2