From patchwork Fri Feb 2 17:55:34 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Hari Nagalla X-Patchwork-Id: 195967 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7301:9bc1:b0:106:209c:c626 with SMTP id op1csp596424dyc; Fri, 2 Feb 2024 09:57:14 -0800 (PST) X-Google-Smtp-Source: AGHT+IEqLNi+9S6BwvZ+USDg5Viwd2sf2KiMaB9/BdX2w2coqfS5CoM6D+dtT2yMWL/Jq6eG4Wqy X-Received: by 2002:a67:ee1a:0:b0:46c:f43f:19e1 with SMTP id f26-20020a67ee1a000000b0046cf43f19e1mr4251032vsp.4.1706896634004; Fri, 02 Feb 2024 09:57:14 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1706896633; cv=pass; d=google.com; s=arc-20160816; b=y8GE9AGJ9K4wihLJ63vHyYlQLiolZXwgZOmG3bpGXiwcd+jkoqzIImZOmZ3zqBinl2 byzfH62AnR6TVnLQ4A5xIHG+Qjjk8ennmsbRFsGJTVDZw7mgFfp0gcNLZfR+EEEa1hO2 JQd7ulU9cg4ACzu9afLUAQI5uk2reCNKawN/JVvVQ4ciGaXlpq+B+QvwtEa1YMEtiNBk MKRj/d3J6nZOqKoRl6q/jTmNWYgaeUjpsxD/q3//UcO+fbSk+mBZX70vH0Iu79v9s3h4 7S1L0o0XqWa/d8snr5yFhrxM0UKl0Q/PRb1isEWESICZAGaKTKxsHKXgnfhCGK6An8O5 Xokg== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=mime-version:list-unsubscribe:list-subscribe:list-id:precedence :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=NzOXcUMbp0Zu5Ja9c3oA6AtFcDCoM3wQ8BYmDpapLp8=; fh=q1Nombid0H/mfSp8yFbTSEwcLTraUCK91ofIPmfxXug=; b=OyY9cgh4NSpZDmuj4ln7ux9frHlIXt4zo8JEbVGXpgRvTaotpoDbE4Yfczi/PHW/IZ kXFI1AlGlHLi7dGlJQnzzLmYb7MF4vW5PrbZQtTOZO2QSbIeV8YT1dQMw+6Z9wzyS3nw 3yqG3MQJdsCITHAI6bVSJoCpbsZNjLx4YSRli+uvaD/bF1d5cdSCQF9RofdVyqxKgyTV p0qANX+KYB6ZTuych2ltPMtCPnQx+fUp8zmza+4be+Mw5HUPB5HnZuyb/EQCUKm0x1PH zTt7qYsgEl7811lNEMvgQW9iNxOymwMGwKv2DZsCRQDlFZKleA3oR/xCpmSiZC29/lar fM7A==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@ti.com header.s=ti-com-17Q1 header.b=IGbgpaYc; arc=pass (i=1 spf=pass spfdomain=ti.com dkim=pass dkdomain=ti.com dmarc=pass fromdomain=ti.com); spf=pass (google.com: domain of linux-kernel+bounces-50274-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45d1:ec00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-50274-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=QUARANTINE sp=NONE dis=NONE) header.from=ti.com X-Forwarded-Encrypted: i=1; AJvYcCVjHWKVQYB+hwAMswDHBYJ5Gx1HSQ7eZBae6ITvACsORdNjs0efVm+Ht7+1Wf+4mCsnGkGB/1ifqG6qo8w5AhwLXsBetQ== Received: from ny.mirrors.kernel.org (ny.mirrors.kernel.org. [2604:1380:45d1:ec00::1]) by mx.google.com with ESMTPS id de42-20020a05620a372a00b0078408df8d13si2838357qkb.694.2024.02.02.09.57.13 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 02 Feb 2024 09:57:13 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-50274-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45d1:ec00::1 as permitted sender) client-ip=2604:1380:45d1:ec00::1; Authentication-Results: mx.google.com; dkim=pass header.i=@ti.com header.s=ti-com-17Q1 header.b=IGbgpaYc; arc=pass (i=1 spf=pass spfdomain=ti.com dkim=pass dkdomain=ti.com dmarc=pass fromdomain=ti.com); spf=pass (google.com: domain of linux-kernel+bounces-50274-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45d1:ec00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-50274-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=QUARANTINE sp=NONE dis=NONE) header.from=ti.com Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ny.mirrors.kernel.org (Postfix) with ESMTPS id B49731C22422 for ; Fri, 2 Feb 2024 17:57:13 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 00B0415099B; Fri, 2 Feb 2024 17:56:07 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=ti.com header.i=@ti.com header.b="IGbgpaYc" Received: from fllv0016.ext.ti.com (fllv0016.ext.ti.com [198.47.19.142]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id DE8C5145B19; Fri, 2 Feb 2024 17:56:00 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.47.19.142 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1706896563; cv=none; b=ByXyjp912ZAmEVKOxbUEmW8Ny1Lls4tVKYQKH0zyIARvS8aXt9KjaFLuVS9VFhjdh5N8DKuvc/LNcWRiIS7ALf0HHbitWiXmNFmTar3tkEyhoMyusz3oQ4KmqOuABrwB0gJbls2+oSYRXniRQasEuCtCAF+KQvzTuepuScQyOp8= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1706896563; c=relaxed/simple; bh=RdI8iokrsD3Pm7caxWCLaUB7/je5wbX7pIF1itVVWDE=; h=From:To:CC:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version:Content-Type; b=nDK9PJhMTaHeHfwwV/Fj9HW6w/++gGYeHCYhCJOXf7xThbcJJFd13tftsnuwlk4uUyiwuZJRkwCsDtbqI80v+nUJWjNL6a6o48bpTD0MrkYKgzR/6O3UcB/VLSB/3Qyvymx1gYomK7JT7RiZeawjXjqxD9Vjcpu7C7Ilzspfq0I= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=ti.com; spf=pass smtp.mailfrom=ti.com; dkim=pass (1024-bit key) header.d=ti.com header.i=@ti.com header.b=IGbgpaYc; arc=none smtp.client-ip=198.47.19.142 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=ti.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=ti.com Received: from fllv0035.itg.ti.com ([10.64.41.0]) by fllv0016.ext.ti.com (8.15.2/8.15.2) with ESMTP id 412HtipK030384; Fri, 2 Feb 2024 11:55:44 -0600 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ti.com; s=ti-com-17Q1; t=1706896544; bh=NzOXcUMbp0Zu5Ja9c3oA6AtFcDCoM3wQ8BYmDpapLp8=; h=From:To:CC:Subject:Date:In-Reply-To:References; b=IGbgpaYcZp+I2WbS/GShIl+jE3JNqnFHHwk8M4TM8f3KX8YSCNUFgNbTQQ544sEGl CIEgwIj9sM98nTnKm4vLlV9bB8FMqfaxyVplTGxSY54Duis9t3fABIqtdQ8ewamsrx XAnZ7jpqz9Dhp5O+9NPQesgLocvnYkgFULONBC+w= Received: from DLEE105.ent.ti.com (dlee105.ent.ti.com [157.170.170.35]) by fllv0035.itg.ti.com (8.15.2/8.15.2) with ESMTPS id 412Hti0M125809 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=FAIL); Fri, 2 Feb 2024 11:55:44 -0600 Received: from DLEE100.ent.ti.com (157.170.170.30) by DLEE105.ent.ti.com (157.170.170.35) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.2507.23; Fri, 2 Feb 2024 11:55:44 -0600 Received: from lelvsmtp5.itg.ti.com (10.180.75.250) by DLEE100.ent.ti.com (157.170.170.30) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.2507.23 via Frontend Transport; Fri, 2 Feb 2024 11:55:44 -0600 Received: from localhost ([10.249.48.175]) by lelvsmtp5.itg.ti.com (8.15.2/8.15.2) with ESMTP id 412Htite114607; Fri, 2 Feb 2024 11:55:44 -0600 From: Hari Nagalla To: , , , , , , , , , CC: , , , Subject: [PATCH v7 1/5] dt-bindings: remoteproc: k3-m4f: Add K3 AM64x SoCs Date: Fri, 2 Feb 2024 11:55:34 -0600 Message-ID: <20240202175538.1705-2-hnagalla@ti.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20240202175538.1705-1-hnagalla@ti.com> References: <20240202175538.1705-1-hnagalla@ti.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-EXCLAIMER-MD-CONFIG: e1e8a2fd-e40a-4ac6-ac9b-f7e9cc9ee180 X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1789810845175339013 X-GMAIL-MSGID: 1789810845175339013 K3 AM64x SoC has a Cortex M4F subsystem in the MCU voltage domain. The remote processor's life cycle management and IPC mechanisms are similar across the R5F and M4F cores from remote processor driver point of view. However, there are subtle differences in image loading and starting the M4F subsystems. The YAML binding document provides the various node properties to be configured by the consumers of the M4F subsystem. Signed-off-by: Martyn Welch Signed-off-by: Hari Nagalla --- Changes since v1: - Spelling corrections - Corrected to pass DT checks Changes since v2: - Missed spelling correction to commit message Changes since v3: - Removed unnecessary descriptions and used generic memory region names - Made mboxes and memory-region optional - Removed unrelated items from examples Changes since v4: - Rebased to the latest kernel-next tree - Added optional sram memory region for m4f device node Changes since v5: - None Changes since v6: - Removed blank line, fixed type for firm-ware property and binding check errors. link to v6: https://lore.kernel.org/all/20230913111644.29889-2-hnagalla@ti.com/ .../bindings/remoteproc/ti,k3-m4f-rproc.yaml | 138 ++++++++++++++++++ 1 file changed, 138 insertions(+) create mode 100644 Documentation/devicetree/bindings/remoteproc/ti,k3-m4f-rproc.yaml diff --git a/Documentation/devicetree/bindings/remoteproc/ti,k3-m4f-rproc.yaml b/Documentation/devicetree/bindings/remoteproc/ti,k3-m4f-rproc.yaml new file mode 100644 index 000000000000..645dbce3773b --- /dev/null +++ b/Documentation/devicetree/bindings/remoteproc/ti,k3-m4f-rproc.yaml @@ -0,0 +1,138 @@ +# SPDX-License-Identifier: (GPL-2.0-only or BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/remoteproc/ti,k3-m4f-rproc.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: TI K3 M4F processor subsystems + +maintainers: + - Hari Nagalla + - Mathieu Poirier + +description: | + Some K3 family SoCs have Arm Cortex M4F cores. AM64x is a SoC in K3 + family with a M4F core. Typically safety oriented applications may use + the M4F core in isolation without an IPC. Where as some industrial and + home automation applications, may use the M4F core as a remote processor + with IPC communications. + +$ref: /schemas/arm/keystone/ti,k3-sci-common.yaml# + +properties: + compatible: + enum: + - ti,am64-m4fss + + power-domains: + maxItems: 1 + + "#address-cells": + const: 2 + + "#size-cells": + const: 2 + + reg: + items: + - description: IRAM internal memory region + - description: DRAM internal memory region + + reg-names: + items: + - const: iram + - const: dram + + resets: + maxItems: 1 + + firmware-name: + maxItems: 1 + description: Name of firmware to load for the M4F core + + mboxes: + description: | + OMAP Mailbox specifier denoting the sub-mailbox, to be used for + communication with the remote processor. This property should match + with the sub-mailbox node used in the firmware image. + maxItems: 1 + + memory-region: + description: | + phandle to the reserved memory nodes to be associated with the + remoteproc device. The reserved memory nodes should be carveout nodes, + and should be defined with a "no-map" property as per the bindings in + Documentation/devicetree/bindings/reserved-memory/reserved-memory.yaml + Optional memory regions available for firmware specific purposes. + maxItems: 8 + items: + - description: regions used for DMA allocations like vrings, vring buffers + and memory dedicated to firmware's specific purposes. + additionalItems: true + + sram: + $ref: /schemas/types.yaml#/definitions/phandle-array + maxItems: 4 + items: + maxItems: 1 + description: | + phandles to reserved on-chip SRAM regions. The regions should be + defined as child nodes of the respective SRAM node, and + should be defined as per the generic bindings in, + Documentation/devicetree/bindings/sram/sram.yaml + +required: + - compatible + - reg + - reg-names + - ti,sci + - ti,sci-dev-id + - ti,sci-proc-ids + - resets + - firmware-name + +unevaluatedProperties: false + +examples: + - | + reserved-memory { + #address-cells = <2>; + #size-cells = <2>; + + mcu_m4fss_dma_memory_region: m4f-dma-memory@9cb00000 { + compatible = "shared-dma-pool"; + reg = <0x00 0x9cb00000 0x00 0x100000>; + no-map; + }; + + mcu_m4fss_memory_region: m4f-memory@9cc00000 { + compatible = "shared-dma-pool"; + reg = <0x00 0x9cc00000 0x00 0xe00000>; + no-map; + }; + }; + + soc { + #address-cells = <2>; + #size-cells = <2>; + + mailbox0_cluster0: mailbox-0 { + #mbox-cells = <1>; + }; + + remoteproc@5000000 { + compatible = "ti,am64-m4fss"; + reg = <0x00 0x5000000 0x00 0x30000>, + <0x00 0x5040000 0x00 0x10000>; + reg-names = "iram", "dram"; + ti,sci = <&dmsc>; + ti,sci-dev-id = <9>; + ti,sci-proc-ids = <0x18 0xff>; + resets = <&k3_reset 9 1>; + firmware-name = "am62-mcu-m4f0_0-fw"; + mboxes = <&mailbox0_cluster0>, <&mbox_m4_0>; + memory-region = <&mcu_m4fss_dma_memory_region>, + <&mcu_m4fss_memory_region>; + sram = <&oc_sram>; + }; + };