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 21E54C27C7C for ; Fri, 20 Jan 2023 14:10:33 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id E9A306B0075; Fri, 20 Jan 2023 09:10:32 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id E0FD16B007B; Fri, 20 Jan 2023 09:10:32 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id C523E6B007B; Fri, 20 Jan 2023 09:10:32 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0011.hostedemail.com [216.40.44.11]) by kanga.kvack.org (Postfix) with ESMTP id B6F0D6B0075 for ; Fri, 20 Jan 2023 09:10:32 -0500 (EST) Received: from smtpin05.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay03.hostedemail.com (Postfix) with ESMTP id 8795DA0E64 for ; Fri, 20 Jan 2023 14:10:32 +0000 (UTC) X-FDA: 80375362704.05.746CF50 Received: from fx304.security-mail.net (smtpout30.security-mail.net [85.31.212.34]) by imf14.hostedemail.com (Postfix) with ESMTP id 3115A100017 for ; Fri, 20 Jan 2023 14:10:29 +0000 (UTC) Authentication-Results: imf14.hostedemail.com; dkim=pass header.d=kalray.eu header.s=sec-sig-email header.b=ALSDt+nA; dkim=fail ("body hash did not verify") header.d=kalray.eu header.s=32AE1B44-9502-11E5-BA35-3734643DEF29 header.b=iF0GuZaV; spf=pass (imf14.hostedemail.com: domain of ysionneau@kalray.eu designates 85.31.212.34 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=1674223830; 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=ui/0AJ58+KwaSKc+hdq5Mlcws2t4akmaJgbe62uBDUQ=; b=pnfeMCVAzXsGHwtFlXH4iO0GvTW8DcrXNrKlN86etpnqcTvdybIfcpbWo/QxiJzpGQFGRq V8W8UFfIQhbzzDk7+Zk8lU2pJS9P1FJK0Zj9sx8R0oAZwcQ7IH9+Dtpk6s5fMP7PepvEgB fMj4Ze2c1v1gwF/zzheqNvKnlI2C62w= ARC-Authentication-Results: i=1; imf14.hostedemail.com; dkim=pass header.d=kalray.eu header.s=sec-sig-email header.b=ALSDt+nA; dkim=fail ("body hash did not verify") header.d=kalray.eu header.s=32AE1B44-9502-11E5-BA35-3734643DEF29 header.b=iF0GuZaV; spf=pass (imf14.hostedemail.com: domain of ysionneau@kalray.eu designates 85.31.212.34 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=1674223830; a=rsa-sha256; cv=none; b=KM0Twu03k0QVtAa+bP3k/09M7EkC23nVWD4lQls3Nv31oXYqq8TUfPRZdkGRdhM+qBIWf1 RGnwWyyo6NCawCKbCnOelsBDnUYIWniRU1PVOrdq7mNEP05FQgtc5ZPDos8CuVPirBkdRh HuJ/V320iCfOLkI5SQRJINSDYFA6MKU= Received: from localhost (localhost [127.0.0.1]) by fx304.security-mail.net (Postfix) with ESMTP id 1A5349D09C for ; Fri, 20 Jan 2023 15:10:28 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kalray.eu; s=sec-sig-email; t=1674223828; bh=ubUoZOi6DD6WM2lGjCRJ2HktaFfxsYj1Yf03CVuT5Tw=; h=From:To:Cc:Subject:Date:In-Reply-To:References; b=ALSDt+nA+I+pgSVvja/X8XEBj+2WNq1sb+GbwqP73mrF3wgs0NWJxNvYo/pVKMCpy bjweLYLkdsqZnZZt70a9Ci9D6WfIUokYwOEdSivRTlJXVdWJ3zpTcnGvTS2rFVJMV3 eSwAhIAVDfMHR6s4uK8Cn1vTDdQo3AaiU/ITFsZk= Received: from fx304 (localhost [127.0.0.1]) by fx304.security-mail.net (Postfix) with ESMTP id 924029D06F; Fri, 20 Jan 2023 15:10:27 +0100 (CET) Received: from zimbra2.kalray.eu (unknown [217.181.231.53]) by fx304.security-mail.net (Postfix) with ESMTPS id AF88C9CEF6; Fri, 20 Jan 2023 15:10:26 +0100 (CET) Received: from zimbra2.kalray.eu (localhost [127.0.0.1]) by zimbra2.kalray.eu (Postfix) with ESMTPS id 56DE827E0430; 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 0A93B27E043E; 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 uJAUeREubpxX; Fri, 20 Jan 2023 15:10:25 +0100 (CET) Received: from junon.lin.mbt.kalray.eu (unknown [192.168.37.161]) by zimbra2.kalray.eu (Postfix) with ESMTPSA id 5C09A27E043D; Fri, 20 Jan 2023 15:10:25 +0100 (CET) X-Virus-Scanned: E-securemail Secumail-id: <6ff3.63caa0d2.ae90a.0> DKIM-Filter: OpenDKIM Filter v2.10.3 zimbra2.kalray.eu 0A93B27E043E DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=kalray.eu; s=32AE1B44-9502-11E5-BA35-3734643DEF29; t=1674223826; bh=vgLPgPsCekn4OMTINrnElLpgqshf2SrzKv2ha68Lwiw=; h=From:To:Date:Message-Id:MIME-Version; b=iF0GuZaVjHO/WEe3sRM2xAOMUnUC96hdxiBF7My2AaXyJFr4L+roJaijnbpF9h9IO 1H6vugremghi1ZUfPqtrK9A1FFTsZjlCKXDiuLReDqoB7Qn5HLPMIOVI90P+sTdxNy YPpX3k1YBEiwgisqbvT/PQSDOvqlYpFQZZFyJZ1o= 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 03/31] Documentation: Add binding for kalray,kv3-1-apic-gic Date: Fri, 20 Jan 2023 15:09:34 +0100 Message-ID: <20230120141002.2442-4-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: q3sdnpaxrab6zour1nbc3ya7oy6h5ctr X-Rspamd-Queue-Id: 3115A100017 X-HE-Tag: 1674223829-125525 X-HE-Meta: U2FsdGVkX19tbdh3xCA1r1w5gRpLxxnCuP2LgIgHFLRBWLXCVttSZq4EuNzfQYzUY3jdbfJq1v0fVXcAj8BSD5gpmVin61eZ2ZHThDuNOVHbYZKwlUjt0JuiSweh3PulVdi7TNXu/1vWJp5NAN26lKwZxu/CwYI8qsAcjuTJD2skdXYX+CbdKshdh2HBkiklP/wF+EkH4ZYfKH9zcPRhEPaLZxxV77stX3o8bhjJpn+E1BNtIupDswSBzzg0n110XFZImIzVQndGDLnedx5dLY8eCcALZnpO7icT+cRjOVYlzCChJhhwWobesF5vDvfSfnxLZYMrpFgkEx5yvjrDC4i0715poQzCXbrUIaNS/4X1S2c/Yh8YrGlO8ywwVPJVXmohL3zbPj/b4pNzlDVjyD2nskVhKHNHYKGSGcByoF6V81pxCuI4xjO1DtcXf8OBsfPw1TbfE/8HjP/pa09meajjDBTFU93mvOrvNIE1w65k1eECdgi+akCzS51HOGu1/Kbb645AQij7WILLFGgK7fZy/xENELyoTa3X6+D2GIj+GYWuu/Au4NXXYMRhndgNC40IG48Y57ZqyRLhc8n5ivfrCCYTKj0jROS+pFl/iGCgc9+oq/SO8qOYZJDMtkkUoyA+HvgR8SKiWTEamBY895fWtDcTAZ+XV37m0YQleKX0KaObECdko2JdsfIDY/40zFKR5JSQU/3RzYzYTGnNqCdjUg6zww9gBmn7zyRLCAxiUdNKkMtnHRPu4BIHcO+UpfiB6fKDdrl2ogOB4nj/bJRx+R6qrh03NKaI1SpjRzp1FadwGZXxjl0w/EKB51lYMNoqsJ0QOlsNYXhRYhahJ2/pAsPRG/J6XVP8lVWWM2KgPstc56dHWlEmkBSlX1m6N65ogAa0P97ju+qGaWBrFCF7MgU4FzbOOVuFj95n7+EjqkfOAHiDzgtsj3mUTtGzLlSINhBvp91Dim5Vbtz comKCfpJ tj79qnvmuUNZ0hRU/xkA9kRjiE7bS4rYbhu+8D2VlN1wPlotkO6Yz3VfRRwK/uUgO8Kd5eKPgLkzD4CD+o0ZmAwyCdMxENThZ7OKCzaV33BO43f6OfXue8227fM3dkengfFYMj3lewmAcQaIeQIu9qp2DjCHCDJFomcKKBhWtY3Wy+MfwFgADrShQ/H+DjZK819de42beXViW8mtM+T/yuGvoxpwIT1X9nFM+QWOR11CkOaH/wJ6W0R0uxHUrhPclNg1Kn7s8J9yqlZiBgSL/JR8v9YqfyR99xWFuGZDw7JuzY31HCmOwXRTVNe/2MhsKRIoDgWiJJ2menpyg7irz6rnxILCY4HnMKcMamOcaocUku4o4BDr4ltoGkeS0BBKSvHzv5jSHDiWFCNQH7N5vkKbVlop/SuUmLrTgTJFC6pXIr7wVo/eM53OyK6vEWEXV8ij74S7B5mJ3LM9YLgf5tF/tyowM4Ex9vdCd1u7Du5+ILPbymtqUmclMfSfsFNFbGTpnN3wxznNmjWqUJy18SxEwy9GurmbKNmIrPLDw0bNpDxgKtU0LXwz5F5M4DNbNfsBsLwrylts00JygBF6oHmX48jxYDzXr4IQJSDn1+XPUzDdFIkKB16jbWTZP4T1l0GF0SLsfAzD2WZoFanvprNYl8uU1/G22b2Lp5+YoCT9BI/z4qxdYay4sCH8BoZrvQSatc1gbULYU1e2Rf3jrKHVcDJ/5+DRC9WJsaOskVWWRnvb/OrSO/tnxew== 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-apic-gic` 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-gic.yaml | 66 +++++++++++++++++++ 1 file changed, 66 insertions(+) create mode 100644 Documentation/devicetree/bindings/interrupt-controller/kalray,kv3-1-apic-gic.yaml diff --git a/Documentation/devicetree/bindings/interrupt-controller/kalray,kv3-1-apic-gic.yaml b/Documentation/devicetree/bindings/interrupt-controller/kalray,kv3-1-apic-gic.yaml new file mode 100644 index 000000000000..7a37f19db2fb --- /dev/null +++ b/Documentation/devicetree/bindings/interrupt-controller/kalray,kv3-1-apic-gic.yaml @@ -0,0 +1,66 @@ +# SPDX-License-Identifier: GPL-2.0 +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/interrupt-controller/kalray,kv3-1-apic-gic# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Kalray kv3-1 APIC-GIC + +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-GIC acts as an intermediary interrupt controller, muxing/routing + incoming interrupts to output interrupts connected to kvx cores interrupts lines. + The 139 possible input interrupt lines are organized as follow: + - 128 from the mailbox controller (one it per mailboxes) + - 1 from the NoC router + - 5 from IOMMUs + - 1 from L2 cache DMA job FIFO + - 1 from cluster watchdog + - 2 for SECC, DECC + - 1 from Data NoC + The 72 possible output interrupt lines: + - 68 : 4 interrupts per cores (17 cores) + - 1 for L2 cache controller + - 3 extra that are for padding + +allOf: + - $ref: /schemas/interrupt-controller.yaml# + +properties: + compatible: + const: kalray,kv3-1-apic-gic + "#interrupt-cells": + const: 1 + description: + The IRQ number. + interrupt-controller: true + interrupt-parent: true + interrupts: + maxItems: 4 + description: | + Specifies the interrupt line(s) in the interrupt-parent controller node; + valid values depend on the type of parent interrupt controller + +required: + - compatible + - reg + - "#interrupt-cells" + - interrupt-controller + - interrupt-parent + - interrupts + +examples: + - | + apic_gic: interrupt-controller@a20000 { + compatible = "kalray,kv3-1-apic-gic"; + reg = <0 0xa20000 0 0x12000>; + #interrupt-cells = <1>; + interrupt-controller; + interrupt-parent = <&intc>; + interrups = <4 5 6 7>; + }; + +... -- 2.37.2