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 bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 46179CAC582 for ; Tue, 9 Sep 2025 17:15:21 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender:List-Subscribe:List-Help :List-Post:List-Archive:List-Unsubscribe:List-Id:In-Reply-To:Content-Type: MIME-Version:References:Message-ID:Subject:Cc:To:From:Date:Reply-To: Content-Transfer-Encoding:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=WM/xyMP780EYcesLju86HLyGxNPxvao2MMtcGFNp7BE=; b=E4UkoX8rTzN/snoxrGRK20ca4L esrpMbJWN1nYqxcYj5uIbRxGNPVwr6o2KDQ1Wxw7zwzK5Qm0Ee+cTcQMU7rhJkadBmNxi9EC7MUXU UFVKyn2oJLTMYN9u5NYCchuZaWO/3AzeLctbLTghUkTpOdqPKXoENdy6FSTSD1SoAtAiS6Z4AWZwO nwpbh6b+vgWOVjacG7EKiIEFIAn+EkpQCdHX3paoKKfn8AvgvC3P0PozEJ0HeEv10YVcy45Y8htTw 6kjrKkshS5QbyAkUPYXSNdSBHw+hMw7Lw8KpRCsnFEJ60pf/IF+g0Xglo3uv0jKuG3x3QazBshtkP nzm/fRaw==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.98.2 #2 (Red Hat Linux)) id 1uw1vw-00000008no1-1ADd; Tue, 09 Sep 2025 17:15:08 +0000 Received: from foss.arm.com ([217.140.110.172]) by bombadil.infradead.org with esmtp (Exim 4.98.2 #2 (Red Hat Linux)) id 1uvw7H-00000006Zod-1vvw for linux-arm-kernel@lists.infradead.org; Tue, 09 Sep 2025 11:02:28 +0000 Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id 906F712FC; Tue, 9 Sep 2025 04:02:18 -0700 (PDT) Received: from e133380.arm.com (e133380.arm.com [10.1.197.68]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id 548A13F63F; Tue, 9 Sep 2025 04:02:21 -0700 (PDT) Date: Tue, 9 Sep 2025 12:02:18 +0100 From: Dave Martin To: James Morse Cc: linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-acpi@vger.kernel.org, devicetree@vger.kernel.org, D Scott Phillips OS , carl@os.amperecomputing.com, lcherian@marvell.com, bobo.shaobowang@huawei.com, tan.shaopeng@fujitsu.com, baolin.wang@linux.alibaba.com, Jamie Iles , Xin Hao , peternewman@google.com, dfustini@baylibre.com, amitsinght@marvell.com, David Hildenbrand , Rex Nie , Koba Ko , Shanker Donthineni , fenghuay@nvidia.com, baisheng.gao@unisoc.com, Jonathan Cameron , Rob Herring , Rohit Mathew , Rafael Wysocki , Len Brown , Lorenzo Pieralisi , Hanjun Guo , Sudeep Holla , Krzysztof Kozlowski , Conor Dooley , Catalin Marinas , Will Deacon , Greg Kroah-Hartman , Danilo Krummrich Subject: Re: [PATCH 09/33] dt-bindings: arm: Add MPAM MSC binding Message-ID: References: <20250822153048.2287-1-james.morse@arm.com> <20250822153048.2287-10-james.morse@arm.com> <96827d9f-cea8-4ca3-b709-1ae09e3d901c@arm.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <96827d9f-cea8-4ca3-b709-1ae09e3d901c@arm.com> X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20250909_040227_583462_345D341F X-CRM114-Status: GOOD ( 66.64 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org Hi, On Fri, Sep 05, 2025 at 10:11:03AM +0100, James Morse wrote: > Hi Dave, > > On 27/08/2025 17:22, Dave Martin wrote: > > On Fri, Aug 22, 2025 at 03:29:50PM +0000, James Morse wrote: > >> From: Rob Herring > >> > >> The binding is designed around the assumption that an MSC will be a > >> sub-block of something else such as a memory controller, cache controller, > >> or IOMMU. However, it's certainly possible a design does not have that > >> association or has a mixture of both, so the binding illustrates how we can > >> support that with RIS child nodes. > >> > >> A key part of MPAM is we need to know about all of the MSCs in the system > >> before it can be enabled. This drives the need for the genericish > >> 'arm,mpam-msc' compatible. Though we can't assume an MSC is accessible > >> until a h/w specific driver potentially enables the h/w. > > > I'll leave detailed review to other people for now, since I'm not so up > > to speed on all things DT. > > Me neither! > > > >> diff --git a/Documentation/devicetree/bindings/arm/arm,mpam-msc.yaml b/Documentation/devicetree/bindings/arm/arm,mpam-msc.yaml > > > > [...] > > > >> @@ -0,0 +1,200 @@ > > > > [...] > > > >> +title: Arm Memory System Resource Partitioning and Monitoring (MPAM) > >> + > >> +description: | > >> + The Arm MPAM specification can be found here: > >> + > >> + https://developer.arm.com/documentation/ddi0598/latest > >> + > >> +maintainers: > >> + - Rob Herring > >> + > >> +properties: > >> + compatible: > >> + items: > >> + - const: arm,mpam-msc # Further details are discoverable > >> + - const: arm,mpam-memory-controller-msc > > > > There seems to be no clear statement about how these differ. > > It's a more-specific compatible, I think these are usually things like: > | compatible = "acme,mega-cache-9000", "arm,mpam-msc" > > Where the driver can key errata-workaround on the vendor specific bit when needed. > > In this case - I think they're examples, but Rob said they were supposed to be in some > other list of compatible. (not sure what/where that is) I guess I'll defer to the DT folks about how this ought to be presented. The DT bindings are a weird hybrid of informal and formal that I'm not really used to. > >> + reg: > >> + maxItems: 1 > >> + description: A memory region containing registers as defined in the MPAM > >> + specification. > > > There seems to be no handling of PCC-based MSCs here. Should there be? > > That is newer than this document. On DT platforms PCC is spelled SCMI, and is > discoverable. Andre P prototyped this, (patches in the extras branch) but no-one > has come out of the woodwork to say they actually need it yet. > > ACPI PCC is a definite maybe. > > > If this can be added later in a backwards-compatible way, I guess > > that's not a problem (and this is what compatible strings are for, if > > all else fails.) > > > > An explicit statement that PCC is not supported here might be helpful, > > though. > > I'm pretty sure its discoverable on DT/SCMI platforms. OK. If this may not be needed, is discoverable and/or can be bolted on in a compatible way later, I guess we wouldn't need to panic about it just now. (At least we can do that much more easily than promulgating an update to the ACPI tables.) > >> + interrupts: > >> + minItems: 1 > >> + items: > >> + - description: error (optional) > >> + - description: overflow (optional, only for monitoring) > >> + > >> + interrupt-names: > >> + oneOf: > >> + - items: > >> + - enum: [ error, overflow ] > >> + - items: > >> + - const: error > >> + - const: overflow > > > > Yeugh. Is this really the only way to say "one or both of foo"? > > > > (I don't know the answer to this -- though I can believe that it's > > true. Perhaps just not describing this property is another option. > > Many bindings seem not to bother.) > > > >> + > >> + arm,not-ready-us: > >> + description: The maximum time in microseconds for monitoring data to be > >> + accurate after a settings change. For more information, see the > >> + Not-Ready (NRDY) bit description in the MPAM specification. > >> + > >> + numa-node-id: true # see NUMA binding > >> + > >> + '#address-cells': > >> + const: 1 > >> + > >> + '#size-cells': > >> + const: 0 > >> + > >> +patternProperties: > >> + '^ris@[0-9a-f]$': > > > > It this supposed to be '^ris@[0-9a-f]+$' ? > > Looks like yes. Fixed. OK > > Currently MPAMF_IDR.RIS_MAX is only 4 bits in size and so cannot be > > greater than 0xf. But it is not inconceivable that a future revision > > of the architecture might enable more -- and the are 4 RES0 bits > > looming over the RIS_MAX field, just waiting to be used... > > > > (In any case, it feels wrong to try to enforce numeric bounds with a > > regex, even in the cases where it happens to work straightforwardly.) > > > >> + type: object > >> + additionalProperties: false > >> + description: > >> + RIS nodes for each RIS in an MSC. These nodes are required for each RIS > > > > The architectural term is "resource instance", not "RIS". > > > > But "RIS nodes" is fine for describing the DT nodes, since we can call > > them what we like, and "ris" is widely used inside the MPAM driver. > > > > People writing DTs should not need to be familiar with the driver's > > internal naming conventions, though. > > What about the architecture's name for fields? > This number goes in MPAMCFG_PART_SEL.RIS. That's the identifier for the resource instance (= "Resource Instance Selector", see e.g., ARM IHI 0099A.a Section 9.4.14 "MPAMCFG_PART_SEL, MPAM Partition Configuration Selection Register"). The way I read this, the contents of MPAMCFG_PART_SEL.RIS is just a numeric identifier identifier, rather than the thing being identified. (I guess I am bikeshedding, here. The chance for actual confusion remains low. I just find this use of "RIS" a bit dissonant.) > > (There are other instances, but I won't comment on them all > > individually.) > > > >> + implementing known MPAM controls > >> + > >> + properties: > >> + compatible: > >> + enum: > >> + # Bulk storage for cache > > > > Nit: What is "bulk storage"? > > Probably to distinguish it from other storage a cache may have, such as tag-ram. > > > The MPAM spec just refers to "cache" or "cache memory". > > I figure these are comments, I'll remove them... > > > >> + - arm,mpam-cache > >> + # Memory bandwidth > >> + - arm,mpam-memory I think that the meaning of "mpam-cache" is pretty obvious without benefiting from a comment, but "mpam-memory" is not an obvious name for memory _bandwidth_. That probably still wants clarification. > >> + > >> + reg: > >> + minimum: 0 > >> + maximum: 0xf > >> + > >> + cpus: > >> + description: > >> + Phandle(s) to the CPU node(s) this RIS belongs to. By default, the parent > >> + device's affinity is used. > >> + > >> + arm,mpam-device: > >> + $ref: /schemas/types.yaml#/definitions/phandle > >> + description: > >> + By default, the MPAM enabled device associated with a RIS is the MSC's > > > > Associated how? > > By the phandle this is a description for. > > > > Is this the device where the physical resources managed by the MSC are located? > > Yes, OK, that's not "associated by the phandle". It's a physical hardware property. [...] > >> +examples: > >> + - | > >> + L3: cache-controller@30000000 { > >> + compatible = "arm,dsu-l3-cache", "cache"; > >> + cache-level = <3>; > >> + cache-unified; > >> + > >> + ranges = <0x0 0x30000000 0x800000>; > >> + #address-cells = <1>; > >> + #size-cells = <1>; > >> + > >> + msc@10000 { > >> + compatible = "arm,mpam-msc"; > >> + > >> + /* CPU affinity implied by parent cache node's */ > > > > "node's" -> "nodes". > > > > (or it this supposed to be in the singular -- i.e., the immediately > > parent cache node only?) > > The MSC's parent cache node can be used to find the affinity. > I'll make it singular and drop the 's OK > > Anyway, it looks like this is commenting on the "reg" property, which > > doesn't seem right. > > > > Is this commnent supposed instead to explain the omission of the "cpus" > > property? If so, that should be made clearer. > > > I'll move it to the end of the list of properties so it doesn't look like it belongs to > the one below it. Ack, that works. Cheers ---Dave