From patchwork Fri Dec 11 14:29:29 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Grzegorz Jaszczyk X-Patchwork-Id: 341970 Delivered-To: patch@linaro.org Received: by 2002:a02:85a7:0:0:0:0:0 with SMTP id d36csp591611jai; Fri, 11 Dec 2020 06:33:28 -0800 (PST) X-Google-Smtp-Source: ABdhPJyDKyF6IFnQ96uDtz5h/8LQ1ojiMpNyYtIfsESd1r8w+EIcrb0FOF0vVTnkhgdAT9zdFHtM X-Received: by 2002:a17:906:7f11:: with SMTP id d17mr11217708ejr.534.1607697208584; Fri, 11 Dec 2020 06:33:28 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1607697208; cv=none; d=google.com; s=arc-20160816; b=W40uq4GW+EgtIWCjf+F9KzVh+KAJ1Jn+Cozlc8C+7uI3KEGBr2W/xGtpdkPdmm+gph S6uUIQWSBw56qlK5wi5CjYTs0VqllJWWYhPTzlZcm2so4oCFtwrBhNnVA6bpZPMM8wUj kF2J3dhz+SxJfQYSY1ImnWYP0ShfQZYBMJO14O1WGCMx30wll8w7AE7J3AvuZIiCyimH Ai/lDopxey3+DMl4kiQuCcJjz50DA8Lhk1zQs8AtI/cWFQy0cOxDHnQoHWU5pf164x3v 7s19a/WTN7/wkQbFYsS7EP06zR4L5b88hpqi8IJPdmdeF0eeGrCq+p3GA3qW/dfAXH/9 aRwA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=0Bzi7zWZFpWpBLLqpvQtDsZO5++kcCplDxHRmHja9cI=; b=QjTu2wqvSKWR0Rvz0vyWHGeKhXW5es2J65bODyj4oA1O5iKsay31xXq7L7ZEQc0yU8 FNIOXauVIm9EXDl/7nK+8T2Xt3FQP8GasLcyYm+hlrp8CiTiimCYzl/gu/JTdSdpXXgC trKgcMwxHbtRfWHLfc0cLB9L7Ie28504+BzIyijrKogZo3mhlFF1IQ/7gtMM4ZkEw7MB udCd61Jv/OkdVYHfLRd7p3VfyrxeCPiZGYJvbS9oyvq8n4cmTdYqJ6VGyw+34n1lHAiF DzFr7dY70MAWS/RvmLBmLTQPB7idiDxLW015YyATYrpBAJwK1fDk5nSPiP5On3XKnmFb scvA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=wNs3tztS; spf=pass (google.com: domain of linux-omap-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-omap-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id l89si5784444ede.577.2020.12.11.06.33.28; Fri, 11 Dec 2020 06:33:28 -0800 (PST) Received-SPF: pass (google.com: domain of linux-omap-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=wNs3tztS; spf=pass (google.com: domain of linux-omap-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-omap-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S2406242AbgLKOcP (ORCPT + 3 others); Fri, 11 Dec 2020 09:32:15 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:44992 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S2406231AbgLKOcE (ORCPT ); Fri, 11 Dec 2020 09:32:04 -0500 Received: from mail-lj1-x242.google.com (mail-lj1-x242.google.com [IPv6:2a00:1450:4864:20::242]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id DE55EC06179C for ; Fri, 11 Dec 2020 06:30:44 -0800 (PST) Received: by mail-lj1-x242.google.com with SMTP id f11so11095791ljm.8 for ; Fri, 11 Dec 2020 06:30:44 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=0Bzi7zWZFpWpBLLqpvQtDsZO5++kcCplDxHRmHja9cI=; b=wNs3tztSbGhGSRdYNRMXcDgK6uUS0awig2xMeSst6auDjET0p9T9rOVFLI5qvluxc7 ymXTxQ73aXPPtjzZ7UY3F6u3qOwFCq37sQyfbo1pq4b8/jW3S8/1ALQLgH1PHI2XAvL4 Zqvel5eommqICdE6Huv/wZOYMQn9bfItnwovECGzxmyge4BRt5sIU4ZAJihXSBN6uVq+ 5jNWG3kt1MI4+RhmnpZIAup2di0tVdSpWC64hrgamWjVfCr6Fv6mlsHnlBAV3rt1Lqkn F6XibwLkOHliAAGLD2v8wCWzRgT9BeF8CGtuoI1badhxWovRvT0WzqM87aWYvirxuJVo RDng== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=0Bzi7zWZFpWpBLLqpvQtDsZO5++kcCplDxHRmHja9cI=; b=ncKhGhzcHckr0EQu24qxEjtrluo5Vv6Xl4tdSE0eINoT4XvHNCPDY3MmJlzpnuS+Qm rTeXIJH0QPJqIQaldx9dlo5CTZMKNaUMq9pHTMILBC+nDsgtRaxwMfDajGelHZ19z/eZ EBTgT1mYHEVq1ZlqQYkZb4rHZ+68BGEVJgVS06sVN87bEzPUWOcN1/OpgHtmtzQLRD5N vL2TsOpwdZ5r82KTcmxpJsJcYEpPvknimxtE3AapmKcn+UkIs6+WJEUHQhFWOEx+HouQ iRK1buTNNIHbBk9oEA/QwooGCA6dVkE2WmP6JsORP2S1PxpwgJ6jGUFXr02fC87lAqyB Wd7w== X-Gm-Message-State: AOAM530O/xpOY337UmlzxTHnrltPHicTHr/YnFHJZTN+ZxCbsUxy2aN9 n2jAIAAOICSTWoNncFpVc+hL8Q== X-Received: by 2002:a2e:a407:: with SMTP id p7mr2894336ljn.78.1607697043341; Fri, 11 Dec 2020 06:30:43 -0800 (PST) Received: from gilgamesh.semihalf.com (193-106-246-138.noc.fibertech.net.pl. [193.106.246.138]) by smtp.gmail.com with ESMTPSA id x26sm906491lfq.112.2020.12.11.06.30.42 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Fri, 11 Dec 2020 06:30:42 -0800 (PST) From: Grzegorz Jaszczyk To: ohad@wizery.com, bjorn.andersson@linaro.org, mathieu.poirier@linaro.org, robh+dt@kernel.org, s-anna@ti.com, ssantosh@kernel.org Cc: grzegorz.jaszczyk@linaro.org, linux-remoteproc@vger.kernel.org, lee.jones@linaro.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-omap@vger.kernel.org, linux-arm-kernel@lists.infradead.org, praneeth@ti.com, rogerq@ti.com Subject: [PATCH 1/5] dt-bindings: remoteproc: Add PRU consumer bindings Date: Fri, 11 Dec 2020 15:29:29 +0100 Message-Id: <20201211142933.25784-2-grzegorz.jaszczyk@linaro.org> X-Mailer: git-send-email 2.29.0 In-Reply-To: <20201211142933.25784-1-grzegorz.jaszczyk@linaro.org> References: <20201211142933.25784-1-grzegorz.jaszczyk@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-omap@vger.kernel.org From: Suman Anna Add a YAML binding document for PRU consumers. The binding includes all the common properties that can be used by different PRU consumer or application nodes and supported by the PRU remoteproc driver. These are used to configure the PRU hardware for specific user applications. The application nodes themselves should define their own bindings. Co-developed-by: Tero Kristo Signed-off-by: Tero Kristo Signed-off-by: Suman Anna Co-developed-by: Grzegorz Jaszczyk Signed-off-by: Grzegorz Jaszczyk --- .../bindings/remoteproc/ti,pru-consumer.yaml | 64 +++++++++++++++++++ 1 file changed, 64 insertions(+) create mode 100644 Documentation/devicetree/bindings/remoteproc/ti,pru-consumer.yaml -- 2.29.0 diff --git a/Documentation/devicetree/bindings/remoteproc/ti,pru-consumer.yaml b/Documentation/devicetree/bindings/remoteproc/ti,pru-consumer.yaml new file mode 100644 index 000000000000..2c5c5e2b6159 --- /dev/null +++ b/Documentation/devicetree/bindings/remoteproc/ti,pru-consumer.yaml @@ -0,0 +1,64 @@ +# SPDX-License-Identifier: (GPL-2.0-only or BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/remoteproc/ti,pru-consumer.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Common TI PRU Consumer Binding + +maintainers: + - Suman Anna + +description: | + A PRU application/consumer/user node typically uses one or more PRU device + nodes to implement a PRU application/functionality. Each application/client + node would need a reference to at least a PRU node, and optionally define + some properties needed for hardware/firmware configuration. The below + properties are a list of common properties supported by the PRU remoteproc + infrastructure. + + The application nodes shall define their own bindings like regular platform + devices, so below are in addition to each node's bindings. + +properties: + prus: + $ref: /schemas/types.yaml#/definitions/phandle-array + description: phandles to the PRU, RTU or Tx_PRU nodes used + + firmware-name: + $ref: /schemas/types.yaml#/definitions/string-array + description: | + firmwares for the PRU cores, the default firmware for the core from + the PRU node will be used if not provided. The firmware names should + correspond to the PRU cores listed in the 'prus' property + + ti,pruss-gp-mux-sel: + $ref: /schemas/types.yaml#/definitions/uint32-array + enum: [0, 1, 2, 3, 4] + description: | + array of values for the GP_MUX_SEL under PRUSS_GPCFG register for a PRU. + This selects the internal muxing scheme for the PRU instance. Values + should correspond to the PRU cores listed in the 'prus' property. The + GP_MUX_SEL setting is a per-slice setting (one setting for PRU0, RTU0, + and Tx_PRU0 on K3 SoCs). Use the same value for all cores within the + same slice in the associative array. If the array size is smaller than + the size of 'prus' property, the default out-of-reset value (0) for the + PRU core is used. + +required: + - prus + +dependencies: + firmware-name: [ prus ] + ti,pruss-gp-mux-sel: [ prus ] + +additionalProperties: true + +examples: + - | + /* PRU application node example */ + pru-app { + prus = <&pru0>, <&pru1>; + firmware-name = "pruss-app-fw0", "pruss-app-fw1"; + ti,pruss-gp-mux-sel = <2>, <1>; + };