From patchwork Tue Aug 1 14:11:15 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Hari Nagalla X-Patchwork-Id: 129332 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:918b:0:b0:3e4:2afc:c1 with SMTP id s11csp2725065vqg; Tue, 1 Aug 2023 07:58:54 -0700 (PDT) X-Google-Smtp-Source: APBJJlGMCoiMOaJgNdK0gHGv7oGlnK3zh+nFsPvfHdF3dEIDFEfsCT3XDM096ASSMUeJ8dReoipW X-Received: by 2002:a05:6a00:3a13:b0:686:7621:5494 with SMTP id fj19-20020a056a003a1300b0068676215494mr12990697pfb.27.1690901934165; Tue, 01 Aug 2023 07:58:54 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1690901934; cv=none; d=google.com; s=arc-20160816; b=lPmfutL65nEbWBon8NOZ34ymHKPPdb6iM+HGLuI77ioV9rNsiMF7wrjfkzUaL4j7Xl 1r0uRaKTB6lzQDYsDjMHBvOXjs5CmvqEI5aP8NmU6UH3j9grgXT36Fj+Ua2Qck+v3qhD 0yA4SuSij3Sf/ANTej3zAlDUWZ25ul6bR0cClVp8jGOJ/oHeSFr1vWZHmLxgjdgWcc8P sH7SRwXFsN4SDanIrXc3BWgcqMUFNs032COY2euyGCY6fMNbLrdPWv8M/tA/YohcMFHp 2o9BymRUBu0Ks30aBP5cTy4c2Em9OIGP4RM/11drR7PAQtubO2pOSzZRG/bDocavsS/2 W6Sw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:mime-version:references:in-reply-to:message-id :date:subject:cc:to:from:dkim-signature; bh=eeXPg8htp+3KKMFFwv6KL3oKUxQ7MI1xylYfg7kuFqs=; fh=dKGwvIlc2/9/DbHJf0BOk6otEw9zJJ/d0UxNR1bxVT4=; b=K1j6T1CC/XFiZRv5LQPYjQJ3+WbyGjN6uB6/lZmz4Zb74Pb38uXN55SSPCAJXO8nhm CYhwy9hmyjfGwRAG6FsMvpYJnfvb/IvWGgGD5gGq9FTrPY7FE3QBoHBWJ9glCIXA/2xJ vuaz3HX4Mb3ZVKOj7gKBAIunwSoQXSG6eEUw0WDZSE19+EIajjsrDSW3J+d1cRLKa2wB dRwO6+GylFICW2UU/FeMIM29cahL6h7a5yr/gu7oDLBXN2DlICVwo1rBHBLwko1Y2H/K Z0lClyCYGedTXQ5v7PuHHb6zb6UIkuyLyrya+zOOD0fvoDpeutLmLApKMGxWdciTh7uW nH3g== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@ti.com header.s=ti-com-17Q1 header.b=vQc1DVJ0; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=QUARANTINE sp=NONE dis=NONE) header.from=ti.com Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id u41-20020a056a0009a900b0068658947b24si9276986pfg.8.2023.08.01.07.58.39; Tue, 01 Aug 2023 07:58:54 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@ti.com header.s=ti-com-17Q1 header.b=vQc1DVJ0; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=QUARANTINE sp=NONE dis=NONE) header.from=ti.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S233833AbjHAOLx (ORCPT + 99 others); Tue, 1 Aug 2023 10:11:53 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:36264 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S232919AbjHAOLn (ORCPT ); Tue, 1 Aug 2023 10:11:43 -0400 Received: from fllv0016.ext.ti.com (fllv0016.ext.ti.com [198.47.19.142]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id A44B02720; Tue, 1 Aug 2023 07:11:33 -0700 (PDT) Received: from lelv0266.itg.ti.com ([10.180.67.225]) by fllv0016.ext.ti.com (8.15.2/8.15.2) with ESMTP id 371EBNZd060397; Tue, 1 Aug 2023 09:11:23 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ti.com; s=ti-com-17Q1; t=1690899083; bh=eeXPg8htp+3KKMFFwv6KL3oKUxQ7MI1xylYfg7kuFqs=; h=From:To:CC:Subject:Date:In-Reply-To:References; b=vQc1DVJ0brPJtqvbdHLsFDF/Gyy7ch4TPQEtqpzWHaNMAFMpEeEmRgxArsDIX5g25 Df4TbMhsxNUl8YTLNHVjx7pNdRab0HxMPMyLn0mpzn5KGCys9VT9MCCXKJZrMcxBja DyHF9dsCf6UMTU8HWZ3uOpWyJafN8E7z8LLIrbCk= Received: from DFLE111.ent.ti.com (dfle111.ent.ti.com [10.64.6.32]) by lelv0266.itg.ti.com (8.15.2/8.15.2) with ESMTPS id 371EBNCr025385 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=FAIL); Tue, 1 Aug 2023 09:11:23 -0500 Received: from DFLE109.ent.ti.com (10.64.6.30) by DFLE111.ent.ti.com (10.64.6.32) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.2507.23; Tue, 1 Aug 2023 09:11:22 -0500 Received: from lelv0326.itg.ti.com (10.180.67.84) by DFLE109.ent.ti.com (10.64.6.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; Tue, 1 Aug 2023 09:11:22 -0500 Received: from localhost (ileaxei01-snat2.itg.ti.com [10.180.69.6]) by lelv0326.itg.ti.com (8.15.2/8.15.2) with ESMTP id 371EBMVm016527; Tue, 1 Aug 2023 09:11:22 -0500 From: Hari Nagalla To: , , , CC: , Subject: [PATCH v4 1/3] dt-bindings: remoteproc: k3-m4f: Add K3 AM64x SoCs Date: Tue, 1 Aug 2023 09:11:15 -0500 Message-ID: <20230801141117.2559-2-hnagalla@ti.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20230801141117.2559-1-hnagalla@ti.com> References: <20230801141117.2559-1-hnagalla@ti.com> MIME-Version: 1.0 X-EXCLAIMER-MD-CONFIG: e1e8a2fd-e40a-4ac6-ac9b-f7e9cc9ee180 X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF, RCVD_IN_DNSWL_BLOCKED,RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_PASS, T_SCC_BODY_TEXT_LINE,URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1773039186843494907 X-GMAIL-MSGID: 1773039186843494907 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 .../bindings/remoteproc/ti,k3-m4f-rproc.yaml | 123 ++++++++++++++++++ 1 file changed, 123 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..4ff0a52d3997 --- /dev/null +++ b/Documentation/devicetree/bindings/remoteproc/ti,k3-m4f-rproc.yaml @@ -0,0 +1,123 @@ +# 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: + $ref: /schemas/types.yaml#/definitions/string + description: Name of firmware to load for the M4F core + + mboxes: + description: | + 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 + +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>; + + 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>; + }; + };