From patchwork Mon Nov 26 07:52:45 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Roger Quadros X-Patchwork-Id: 151983 Delivered-To: patch@linaro.org Received: by 2002:a2e:299d:0:0:0:0:0 with SMTP id p29-v6csp5329122ljp; Sun, 25 Nov 2018 23:53:50 -0800 (PST) X-Google-Smtp-Source: AFSGD/WK19ZLETIPPwMv2Nz59wPSlfId5onisnh5xOTN8wn7hYJQMf2GXeiSt4t9ad1sNNjdmcOd X-Received: by 2002:a63:1258:: with SMTP id 24mr23507491pgs.114.1543218830185; Sun, 25 Nov 2018 23:53:50 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1543218830; cv=none; d=google.com; s=arc-20160816; b=Yg45U8JUbEDlIit+rabVDeu0aYgOKgxyv2+7WtXedFxKzGUTPeDbwE45E5yhwV0Wtc mIoFlrEXrWce2Is3zkvEtaGYHHN9h/IGe3oqMs0LvW7GFmVweANcLFpaxB0OOuPBjdeb cjCxRXoxwUFBDVJjhHD22MVbbdTe8NzcrnB6C4h+C8dlZDv+xo6jTx5mu57VGSGAy0Dg annGXVkue5ufLAfkUW68NWI26y9DCdhplxq2MadBh6/CUAj3JhshuGVeNcamkI9apkym 33o1i4FhxKJUw/ZOvqVXzbeldIcBq92eOhxjkVVoAo+aUsnhirVBgg3qtltZR+65vNqB 0pUw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:dkim-signature; bh=Wq3rx3PYsI4iFiwTWmGf7b0qeZ/uiC62qdIe0NzgMmM=; b=hTBLBSBHrYTWh6htOA9dGT/xWif9Qh3sl8WlZ2Gg3roqauJKiGE0WvhJ8/TbYZsqMN KmtIvGCb4NT79mVsv4ZxyM08seRpxLW5hmLsp6vr4cO52ZIqqtMKBrTutK6QiQvS4hkn KA7eATTc/XN6bkNRxZ80c1/z4Ls/WCk/PgZL8jKcMvaCLweOGreugYgNJi6AOZk6mq4S v+zqXPDDTeLll7vYz+JgC+SSkMJUGzx578Nbn8cTPUlYE6uSpSg+jzFESpuUly8CM707 Wt9az3TtD41bt3EWfYXduKinRQP3LLhj3YV6V3nmfPfkkVS4yfT4nGTIGVhzaDEZIJcu MlLQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@ti.com header.s=ti-com-17Q1 header.b="tHXQ6/ih"; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=QUARANTINE sp=NONE dis=NONE) header.from=ti.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id x2-v6si61958178plv.413.2018.11.25.23.53.49; Sun, 25 Nov 2018 23:53:50 -0800 (PST) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; dkim=pass header.i=@ti.com header.s=ti-com-17Q1 header.b="tHXQ6/ih"; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 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 S1726734AbeKZSrD (ORCPT + 32 others); Mon, 26 Nov 2018 13:47:03 -0500 Received: from fllv0015.ext.ti.com ([198.47.19.141]:41014 "EHLO fllv0015.ext.ti.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726552AbeKZSrD (ORCPT ); Mon, 26 Nov 2018 13:47:03 -0500 Received: from fllv0035.itg.ti.com ([10.64.41.0]) by fllv0015.ext.ti.com (8.15.2/8.15.2) with ESMTP id wAQ7rh9k043570; Mon, 26 Nov 2018 01:53:43 -0600 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ti.com; s=ti-com-17Q1; t=1543218823; bh=Wq3rx3PYsI4iFiwTWmGf7b0qeZ/uiC62qdIe0NzgMmM=; h=From:To:CC:Subject:Date:In-Reply-To:References; b=tHXQ6/ih2Qi5WQozISuk6viTXN2cIbNfweHBXVdBdDonfKUK2ARQUw6Hz+mF1NHkU 27VZ/uB20NNl10pckTSAAhynn8kkKWaLa2g3xCindPIWs8NGL7ZSu7cc/C8q6mfhc3 F9yp08qCTq88lou35+jNWkKunDo/wbJ99CMqlYFU= Received: from DFLE109.ent.ti.com (dfle109.ent.ti.com [10.64.6.30]) by fllv0035.itg.ti.com (8.15.2/8.15.2) with ESMTPS id wAQ7rhOU059915 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=FAIL); Mon, 26 Nov 2018 01:53:43 -0600 Received: from DFLE103.ent.ti.com (10.64.6.24) 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.1591.10; Mon, 26 Nov 2018 01:53:43 -0600 Received: from dlep32.itg.ti.com (157.170.170.100) by DFLE103.ent.ti.com (10.64.6.24) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.1.1591.10 via Frontend Transport; Mon, 26 Nov 2018 01:53:43 -0600 Received: from dlelxv97.itg.ti.com (dlelxv97.itg.ti.com [172.17.2.193]) by dlep32.itg.ti.com (8.14.3/8.13.8) with ESMTP id wAQ7rh2U007296; Mon, 26 Nov 2018 01:53:43 -0600 Received: from localhost.localdomain (vboxa0400828d.dhcp.ti.com [172.22.237.3]) by dlelxv97.itg.ti.com (8.14.3/8.13.8) with ESMTP id wAQ7qn1Q024490; Mon, 26 Nov 2018 01:53:39 -0600 From: Roger Quadros To: , CC: , , , , , , , , , , , , , , , Subject: [PATCH 12/16] dt-bindings: remoteproc: ti-pruss: Document application node bindings Date: Mon, 26 Nov 2018 09:52:45 +0200 Message-ID: <1543218769-5507-13-git-send-email-rogerq@ti.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1543218769-5507-1-git-send-email-rogerq@ti.com> References: <1543218769-5507-1-git-send-email-rogerq@ti.com> MIME-Version: 1.0 X-EXCLAIMER-MD-CONFIG: e1e8a2fd-e40a-4ac6-ac9b-f7e9cc9ee180 Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org From: Tero Kristo Add documentation for the Texas Instruments PRU application nodes. These are used to configure specific user applications for PRU instances. Signed-off-by: Tero Kristo [s-anna@ti.com: some binding updates] Signed-off-by: Suman Anna Signed-off-by: Roger Quadros --- .../devicetree/bindings/soc/ti/ti,pruss.txt | 43 ++++++++++++++++++++++ 1 file changed, 43 insertions(+) -- Texas Instruments Finland Oy, Porkkalankatu 22, 00180 Helsinki. Y-tunnus/Business ID: 0615521-4. Kotipaikka/Domicile: Helsinki diff --git a/Documentation/devicetree/bindings/soc/ti/ti,pruss.txt b/Documentation/devicetree/bindings/soc/ti/ti,pruss.txt index 3e5f32f..94c91ee 100644 --- a/Documentation/devicetree/bindings/soc/ti/ti,pruss.txt +++ b/Documentation/devicetree/bindings/soc/ti/ti,pruss.txt @@ -210,6 +210,38 @@ used in TI Davinci SoCs. Please refer to the corresponding binding document, Documentation/devicetree/bindings/net/davinci-mdio.txt for details. +Application/User Nodes +======================= +A PRU application/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 pass some configuration +parameters. + +Required Properties: +-------------------- +- prus : phandles to the PRU nodes used + +Optional Properties: +-------------------- +- firmware-name : 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 : 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. If not provided, the + default out-of-reset value (0) for the PRU core is + used. Values should correspond to the PRU cores listed + in the 'prus' property +- ti,pru-interrupt-map : PRU interrupt mappings, containing an array of entries + with each entry consisting of 4 cell-values. First one + is an index towards the "prus" property to identify the + PRU core for the interrupt map, second is the PRU + System Event id, third is the PRU interrupt channel id + and fourth is the PRU host interrupt id. If provided, + this map will supercede any other configuration + provided through firmware + Example: ======== 1. /* AM33xx PRU-ICSS */ @@ -397,3 +429,14 @@ Example: ... }; }; + +3: /* PRU application node example */ + app_node: app_node { + prus = <&pru1_0>, <&pru1_1>; + firmware-name = "pruss-app-fw", "pruss-app-fw-2"; + ti,pruss-gp-mux-sel = <2>, <1>; + /* setup interrupts for prus: + prus[0] => pru1_0: ev=16, chnl=2, host-irq=7, + prus[1] => pru1_1: ev=19, chnl=1, host-irq=3 */ + ti,pru-interrupt-map = <0 16 2 7 >, <1 19 1 3>; + }