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 07829C05027 for ; Fri, 20 Jan 2023 14:10:42 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 04AD46B0080; Fri, 20 Jan 2023 09:10:34 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id E46446B0083; Fri, 20 Jan 2023 09:10:33 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id BD3626B0081; Fri, 20 Jan 2023 09:10:33 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0015.hostedemail.com [216.40.44.15]) by kanga.kvack.org (Postfix) with ESMTP id 900266B0080 for ; Fri, 20 Jan 2023 09:10:33 -0500 (EST) Received: from smtpin29.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay01.hostedemail.com (Postfix) with ESMTP id 706F21C66AC for ; Fri, 20 Jan 2023 14:10:33 +0000 (UTC) X-FDA: 80375362746.29.AA6181B Received: from fx306.security-mail.net (smtpout30.security-mail.net [85.31.212.36]) by imf04.hostedemail.com (Postfix) with ESMTP id 1B1CE40007 for ; Fri, 20 Jan 2023 14:10:30 +0000 (UTC) Authentication-Results: imf04.hostedemail.com; dkim=fail ("body hash did not verify") header.d=kalray.eu header.s=32AE1B44-9502-11E5-BA35-3734643DEF29 header.b=P23x+LKc; spf=pass (imf04.hostedemail.com: domain of ysionneau@kalray.eu designates 85.31.212.36 as permitted sender) smtp.mailfrom=ysionneau@kalray.eu; dmarc=pass (policy=quarantine) header.from=kalray.eu ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1674223831; 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=6br1CNXHAjq0Bu7J3fRgphWKvvgT0BXnkAtwlkt/KLw=; b=qAYdQk89rGB3RydGMNDHxjYXKLh02P9XkQ6zmy7YtI5vqRUSfki+3Rj+Ka+g4MGGyq/IXc 2DN8Dj+CUlzdEmIHSjBRe8BWMEYoXKixh0VUjUa5FspFEa4bV8pkCo9cskfxHLQtKpZY4v H2oNQpcic/r3jTJrBkcfupi6kUWCv3M= ARC-Authentication-Results: i=1; imf04.hostedemail.com; dkim=fail ("body hash did not verify") header.d=kalray.eu header.s=32AE1B44-9502-11E5-BA35-3734643DEF29 header.b=P23x+LKc; spf=pass (imf04.hostedemail.com: domain of ysionneau@kalray.eu designates 85.31.212.36 as permitted sender) smtp.mailfrom=ysionneau@kalray.eu; dmarc=pass (policy=quarantine) header.from=kalray.eu ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1674223831; a=rsa-sha256; cv=none; b=s+t8vqINthtNlne7E4RGLrMj+c4r18wvvt5YDDI9AsMMLyaEbQxTXsE2z4cuaBkp2N0odP /Lc1b8b0vNICELMQ/bWLPeKwdKvYxal4FXjWG2Kb7JQv/AYSGGNOUPfYu4Z1jXxc6c4h9G 36JNgaGoPkM4hckBUYdNIXXl8obWhJY= Received: from localhost (fx306.security-mail.net [127.0.0.1]) by fx306.security-mail.net (Postfix) with ESMTP id 7C54735CF96 for ; Fri, 20 Jan 2023 15:10:29 +0100 (CET) Received: from fx306 (fx306.security-mail.net [127.0.0.1]) by fx306.security-mail.net (Postfix) with ESMTP id ED64E35CF61; Fri, 20 Jan 2023 15:10:28 +0100 (CET) Received: from zimbra2.kalray.eu (unknown [217.181.231.53]) by fx306.security-mail.net (Postfix) with ESMTPS id 1DCB635CEE1; 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 9FC5E27E0440; Fri, 20 Jan 2023 15:10:26 +0100 (CET) Received: from localhost (localhost [127.0.0.1]) by zimbra2.kalray.eu (Postfix) with ESMTP id 86B8727E043D; Fri, 20 Jan 2023 15:10:26 +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 bBGr77tfxy-9; 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 E117627E0439; Fri, 20 Jan 2023 15:10:25 +0100 (CET) X-Virus-Scanned: E-securemail Secumail-id: <5193.63caa0d3.18042.0> DKIM-Filter: OpenDKIM Filter v2.10.3 zimbra2.kalray.eu 86B8727E043D DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=kalray.eu; s=32AE1B44-9502-11E5-BA35-3734643DEF29; t=1674223826; bh=WsdsMgF+9wdt2RCH1Xf3svKE0DGavKlRxJdrjiN4Uh8=; h=From:To:Date:Message-Id:MIME-Version; b=P23x+LKcvEP+IKZLbkuicGs3Pej5mBdo8yQYkaxT3SdD6c0GM19pKDj+ase6ViEKo uPexGp9XpE0T3huFfEVD6e4MSK+6FZ4VooRCJ6oBEHDNAQPNIZeWLmd6d5qSRBL22D of29euZL+icynxeO+ubhAeSadnZtlOlSeb48YA+Q= 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 04/31] Documentation: Add binding for kalray,kv3-1-apic-mailbox Date: Fri, 20 Jan 2023 15:09:35 +0100 Message-ID: <20230120141002.2442-5-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-Rspam-User: X-Rspamd-Server: rspam03 X-Stat-Signature: 35tcc4xu6wcyjd7fof1jqxhbrompwkcy X-Rspamd-Queue-Id: 1B1CE40007 X-HE-Tag: 1674223830-482820 X-HE-Meta: U2FsdGVkX199msaxAoPYwnp7C5YtX0fyj7y+t/XW+tLWEBkZWCNuCX6JCNxR3vm4Pcrysnn9OjKADiGj3a6iXHok2jSEQzAvtffJV3MsJNQK9vWkk7yam/6M0xPWT216YS3f9SFdpsGMVvyQ8TGS57TDG0qJiiqMbAwfSi0DBguLHt88/57KpwM7e89b+V28ITQsR/VtTlYdYNL/5eu9X4L3GeKn2ezi2hwoIOcsNbNXV03HRm0WzzgVfiMWeyAO7GbndBMcRpPQ/phh6mFrdN3pLunh1Y7OPO/pjwlLm69btA8HHgTL/Pp/NyyYUcXyVzH30dhLTuSen1SpqmB/0E2YTnpzf92EJF7xyhupliwR9YqAa5dslN7YjvuaYNfX+yiWPPxs+SPwVt2u1OG2sPxGAev8aAlw8XVmVvvvA71BcPhOiadQwY8HIKIDzHT+vX5DwnuKC3Hq98hihVqY8B5XKXitii9R2dDnFgQ+JbMBTlPSrK1aHHsgzKbYkjAMUPI4cEoNxDmjx67OVbv8d5b3N0GfrI/k/SWwOdgAsAFqQQnVQrQHsOQy9a/tQLmCqx43dGYd3R7mc+SbX4Si+DKVdR7Fuv2XaMapel7YjF/iQsWe566MI+bkGOD6aTOojJacUyRRAi31rHWFYHUFbNbN0iQRdELqLaFi/0xj4I9B0YATXjXpo3KUm3NQKwpn3LzozJqxY3La1hUri+xactEY+JwRYH5lkWZvMuEW2Ga0ESHjr3dBBXlejuJCPFo8eDz/PrpDykr31L/nQLFWA5VFi89D4dh8Tn4R/a3Y1l/AvOu7wz/0G6arUeZfyXuSwmYIOhGWLJE3kAYgjhg028HjVVSmwfXfabFYoIOITnxlgEkcNKFEHkrCqQoDks20G1ha4QtrX6BVLru7buGHjm7pQEKXkth/iklz4xJS3WtJcTPhCYQUXFQlgdhJNj8yki3FS+dKC0ToHr0mH/P /Sze/MKQ HcsxudevT1cIVJhZRjlD15fjZ+nv/fgXAe/yi0zvYbFHpPcWlkTfRAchE5GA1IDTb/1EdY7XrbipLeCYjSjX/OEGxR/oc44HUqgiNO6kWFIAsjSRl+DnMh2EiCOG3iF8+xazl1qSZuPUsEVe+KEJygLyLXusbBhE6AA7ArhuY/+6Slx/uW5gohMY0tfPl7ZQFvkhtQqMTrHPqivTJ+Ob8xAj9hlPCc5hj7Pg21AmJu5TsKTWbOuX8lWx7MJRGH5L/tUG9I8snzCr6SxK+BkH10xrVuTESk4MQF24Yuup/sfAJiPOdstdOOf9d2e6DUiOChav1PpM25uIdW+Y9OkcryS05q/WaM5MKQENYpBAC4Pk1CKlQSKtJRJB0moHAInAmqc0Iuj7ORkWNrzp+VEfakbIo4J/RQu67gknS7NGV+XIq5Qo3Rxx+HlQ7OP8ziGqz1+OM24KEqRr0S1aRxgrMG6jft5ofhautbAngQu/hMkeT5hRNwQW1Q/Fw9wPQLNBnh0Ey3k2rVbeTK5Ep7M4vegYWDeN0n9zdCZi1/t0/A5f3CgKUU0ZYqwvJCfzAmlNheWjTZ/LRHurDAHjyHiRcRr6FNUAFashl11fXT8QUNL0uUxDEaF59QNjfcxHtuFWSbPs+RXcJyQvdGIA= 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,kv3-1-core-intc` binding. Co-developed-by: Jules Maselbas Signed-off-by: Jules Maselbas Signed-off-by: Yann Sionneau --- Notes: V1 -> V2: new patch .../kalray,kv3-1-apic-mailbox.yaml | 75 +++++++++++++++++++ 1 file changed, 75 insertions(+) create mode 100644 Documentation/devicetree/bindings/interrupt-controller/kalray,kv3-1-apic-mailbox.yaml diff --git a/Documentation/devicetree/bindings/interrupt-controller/kalray,kv3-1-apic-mailbox.yaml b/Documentation/devicetree/bindings/interrupt-controller/kalray,kv3-1-apic-mailbox.yaml new file mode 100644 index 000000000000..e1eb1c9fda0d --- /dev/null +++ b/Documentation/devicetree/bindings/interrupt-controller/kalray,kv3-1-apic-mailbox.yaml @@ -0,0 +1,75 @@ +# SPDX-License-Identifier: GPL-2.0 +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/interrupt-controller/kalray,kv3-1-apic-mailbox# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Kalray kv3-1 APIC-Mailbox + +description: | + Each cluster in the Coolidge SoC includes an Advanced Programmable Interrupt + Controller (APIC) which is split in two part: + - a Generic Interrupt Controller (referred as APIC-GIC) + - a Mailbox Controller (referred as APIC-Mailbox) + The APIC-Mailbox contains 128 mailboxes of 8 bytes (size of a word), + this hardware block is basically a 1 KB of smart memory space. + Each mailbox can be independently configured with a trigger condition + and an input mode function. + + Input mode are: + - write + - bitwise OR + - add + + Interrupts are generated on a write when the mailbox content value + match the configured trigger condition. + Available conditions are: + - doorbell: always raise interruption on write + - match: when the mailbox's value equal the configured trigger value + - barrier: same as match but the mailbox's value is cleared on trigger + - threshold: when the mailbox's value is greater than, or equal to, the + configured trigger value + + Since this hardware block generates IRQs based on writes to some memory + locations, it is both an interrupt controller and an MSI controller. + +allOf: + - $ref: /schemas/interrupt-controller.yaml# + +properties: + compatible: + const: kalray,kv3-1-apic-mailbox + "#interrupt-cells": + const: 1 + description: + The IRQ number. + interrupt-controller: true + interrupt-parent: true + interrupts: + maxItems: 128 + description: | + Specifies the interrupt line(s) in the interrupt-parent controller node; + valid values depend on the type of parent interrupt controller + msi-controller: true + +required: + - compatible + - reg + - "#interrupt-cells" + - interrupt-controller + - interrupt-parent + - interrupts + - msi-controller + +examples: + - | + apic_mailbox: interrupt-controller@a00000 { + compatible = "kalray,kv3-1-apic-gic"; + reg = <0 0xa00000 0 0x0f200>; + #interrupt-cells = <1>; + interrupt-controller; + interrupt-parent = <&apic_gic>; + interrups = <0 1 2 3 4 5 6 7 8 9>; + }; + +... -- 2.37.2