From patchwork Wed Nov 16 12:16:28 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: MD Danish Anwar X-Patchwork-Id: 1750 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:6687:0:0:0:0:0 with SMTP id l7csp108571wru; Wed, 16 Nov 2022 04:22:06 -0800 (PST) X-Google-Smtp-Source: AA0mqf6iBCEvqIxJTDJ/tgKPytdSUumhAzScN+Kv/DDdrwsQOstNXSVjicNik7PxzVEuFYCWOZ9M X-Received: by 2002:a17:902:6b07:b0:186:cb27:4e01 with SMTP id o7-20020a1709026b0700b00186cb274e01mr8595711plk.139.1668601326486; Wed, 16 Nov 2022 04:22:06 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1668601326; cv=none; d=google.com; s=arc-20160816; b=sf0Ys52RpvR7AzMQwM+JMaHUPgi96BMGYW/nfq6oBYM94DKWDL1n4BPSFk7Ve4wQBm B9TQktPZOKVAR/JnABv5QPtX0j7MtDXxhbs/YNYESUl5OnE7h7XGOeBi+DoweSZVTuoK j2dGL0xlfnaf12zA4XqXQGPY58orZPOxxkC09DveBxnPoXZMMOOSiOcdyY7+u4z8CMaj VyUaEXuJgv2Pv9Jkbes23XahyE1HHKwig0n31+kfvbW2U7iCNTaPW540UjAw4JFnyVm8 8ED+hHw9uX3L1oaroGtaA6IUlCC4cqJA7oAs/u87OAuoc+lg2c45Irxz8YQ0D4ffzU/1 yQvg== 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 :message-id:date:subject:cc:to:from:dkim-signature; bh=NUKXqWa4E44hBHPJP3cOTEpCwwY3Pgc40/KqYaJlMIc=; b=TB/BlxCT537P/aAz6L3iS5+jYazSZoDSMlwCc9HqCZYqv0NwCny3a+v2SRUQMYrZCr 4wn+tv52fggHlixP5Yq5gJJ/oPCH36ys+YGsNCh5TFNow+tVfDxuxdOPzG5foL29Ain+ bYXox1JoWnEeBp+ASvtXhtt4lB6J5CftH7NqBNxU1Gbiog4FXEVvVg8Af4gNwf0y2/Mi bUFjq+o1f69/peEFF4swxgBW4JcoKylFbOaTW2NjmB0z5624JTIYmwydyxlulqYWEmfx JNpoi1tQ3dih47ge8ObMOosnNZjBE26N9myBinjZUOqHfwq+vsuTUXw47v9YQchR6k6D 5qJw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@ti.com header.s=ti-com-17Q1 header.b=szYLnsCL; 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 c26-20020aa7953a000000b005638dc03ab3si14110532pfp.323.2022.11.16.04.21.53; Wed, 16 Nov 2022 04:22:06 -0800 (PST) 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=szYLnsCL; 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 S230387AbiKPMTk (ORCPT + 99 others); Wed, 16 Nov 2022 07:19:40 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:35208 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233807AbiKPMS6 (ORCPT ); Wed, 16 Nov 2022 07:18:58 -0500 Received: from fllv0016.ext.ti.com (fllv0016.ext.ti.com [198.47.19.142]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 0DB0E193D6; Wed, 16 Nov 2022 04:16:51 -0800 (PST) Received: from lelv0265.itg.ti.com ([10.180.67.224]) by fllv0016.ext.ti.com (8.15.2/8.15.2) with ESMTP id 2AGCGbcu058251; Wed, 16 Nov 2022 06:16:37 -0600 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ti.com; s=ti-com-17Q1; t=1668600997; bh=NUKXqWa4E44hBHPJP3cOTEpCwwY3Pgc40/KqYaJlMIc=; h=From:To:CC:Subject:Date; b=szYLnsCLmpdC8EPJyvX7aqwkOQUYeU8+AKFqwCq9qsS8KolmxRzWGjeq1uB4bMuwC O1fASUeJwTc3w2FDbqx3UK22kgyBdjH2kdI1O0y0r1MYnfikh3AvGTawF7g7t55zFy pJAHiUqQsIzIPKRXtzVuq3a1iu/X0tMgw3kuob+Y= Received: from DFLE112.ent.ti.com (dfle112.ent.ti.com [10.64.6.33]) by lelv0265.itg.ti.com (8.15.2/8.15.2) with ESMTPS id 2AGCGbNL023716 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=FAIL); Wed, 16 Nov 2022 06:16:37 -0600 Received: from DFLE111.ent.ti.com (10.64.6.32) by DFLE112.ent.ti.com (10.64.6.33) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.2507.6; Wed, 16 Nov 2022 06:16:36 -0600 Received: from fllv0039.itg.ti.com (10.64.41.19) 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.6 via Frontend Transport; Wed, 16 Nov 2022 06:16:36 -0600 Received: from fllv0122.itg.ti.com (fllv0122.itg.ti.com [10.247.120.72]) by fllv0039.itg.ti.com (8.15.2/8.15.2) with ESMTP id 2AGCGaik080146; Wed, 16 Nov 2022 06:16:36 -0600 Received: from localhost (a0501179-pc.dhcp.ti.com [10.24.69.114]) by fllv0122.itg.ti.com (8.14.7/8.14.7) with ESMTP id 2AGCGZii013706; Wed, 16 Nov 2022 06:16:36 -0600 From: MD Danish Anwar To: Mathieu Poirier , Krzysztof Kozlowski , Rob Herring CC: Suman Anna , Roger Quadros , "Andrew F . Davis" , , , , , , , , MD Danish Anwar Subject: [PATCH v8 0/6] Introduce PRU remoteproc consumer API Date: Wed, 16 Nov 2022 17:46:28 +0530 Message-ID: <20221116121634.2901265-1-danishanwar@ti.com> X-Mailer: git-send-email 2.25.1 MIME-Version: 1.0 X-EXCLAIMER-MD-CONFIG: e1e8a2fd-e40a-4ac6-ac9b-f7e9cc9ee180 X-Spam-Status: No, score=-4.4 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_MED, SPF_HELO_NONE,SPF_PASS 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: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1749655304461101516?= X-GMAIL-MSGID: =?utf-8?q?1749655304461101516?= The Programmable Real-Time Unit and Industrial Communication Subsystem (PRU-ICSS or simply PRUSS) on various TI SoCs consists of dual 32-bit RISC cores (Programmable Real-Time Units, or PRUs) for program execution. There are 3 foundation components for PRUSS subsystem: the PRUSS platform driver, the PRUSS INTC driver and the PRUSS remoteproc driver. All were already merged and can be found under: 1) drivers/soc/ti/pruss.c Documentation/devicetree/bindings/soc/ti/ti,pruss.yaml 2) drivers/irqchip/irq-pruss-intc.c Documentation/devicetree/bindings/interrupt-controller/ti,pruss-intc.yaml 3) drivers/remoteproc/pru_rproc.c Documentation/devicetree/bindings/remoteproc/ti,pru-rproc.yaml The programmable nature of the PRUs provide flexibility to implement custom peripheral interfaces, fast real-time responses, or specialized data handling. Example of a PRU consumer drivers will be: - Software UART over PRUSS - PRU-ICSS Ethernet EMAC In order to make usage of common PRU resources and allow the consumer drivers to configure the PRU hardware for specific usage the PRU API is introduced. This is the v8 of the patch series [1]. This version of the patchset addresses the comments made on v7 [7] of the series. Two more patch series have been posted ([2] and [3]) that depends on this series, one has been posted to the soc/ti/ tree and another to the networking tree. All the 3 series including this one, has been sent as RFC [4] to get comments and to explain the dependencies. Changes from v7 to v8 : *) Removed get_device(&rproc->dev) from API __pru_rproc_get() in patch 2/5 of this series as asked by Roger. *) Replaced all the SoBs (other than mine) to Co-developed-by tags for all the patches in this series as asked by Mathieu. *) Added a new patch (3/5) in this series for Introduction of pruss_pru_id enum. Previously this enum was part of patch 2/5. As asked by Roger removed this enum (and the APIs that are using the enum) from patch 2/5 and added it in new patch. *) Removed a comment for an already documented field in patch 2/5 of this series. *) Changed 'pru' to 'PRU' in comment of API pru_rproc_set_firmware() as asked by Roger. Changes from v6 [6] to v7 : *) Removed example section from ti,pru-consumer.yaml as the full example included compatible property as well which is not introduced in this series thus creating dt check binding error. Removing the example section fixes the dt binding check error. The example section will be included in "ti,icssg-prueth.yaml" in the next version of series [3] *) Updated the commit message for patch 1/5 of this series to address Krzysztof's comment. Changes from v5 [5] to v6 : *) Added rproc_get_by_phandle() in pru_rproc_get() *) Provided background of Ctable in the commit messege. *) Removed patch "" [8] (6th Patch of the previous version of this series) as it has dependency on series [2], thus creating a cyclic dependency. The patch [6] will be sent along with the next version of series [2]. [1] https://patchwork.kernel.org/project/linux-remoteproc/cover/20220603121520.13730-1-p-mohan@ti.com/ [2] https://lore.kernel.org/all/20220418123004.9332-1-p-mohan@ti.com/ [3] https://lore.kernel.org/all/20220531095108.21757-1-p-mohan@ti.com/ [4] https://patchwork.kernel.org/project/linux-remoteproc/cover/20220406094358.7895-1-p-mohan@ti.com/ [5] https://lore.kernel.org/all/20220607045650.4999-1-p-mohan@ti.com/ [6] https://lore.kernel.org/all/20221012114429.2341215-1-danishanwar@ti.com/ [7] https://lore.kernel.org/all/20221031073801.130541-1-danishanwar@ti.com/ [8] https://lore.kernel.org/all/20220607045650.4999-7-p-mohan@ti.com/ Thanks and Regards, Md Danish Anwar MD Danish Anwar (1): remoteproc: pru: Add enum for PRU Core Indentifiers. Roger Quadros (1): remoteproc: pru: Add pru_rproc_set_ctable() function Suman Anna (2): dt-bindings: remoteproc: Add PRU consumer bindings remoteproc: pru: Make sysfs entries read-only for PRU client driven boots Tero Kristo (2): remoteproc: pru: Add APIs to get and put the PRU cores remoteproc: pru: Configure firmware based on client setup .../bindings/remoteproc/ti,pru-consumer.yaml | 60 +++++ drivers/remoteproc/pru_rproc.c | 235 +++++++++++++++++- include/linux/pruss.h | 78 ++++++ 3 files changed, 368 insertions(+), 5 deletions(-) create mode 100644 Documentation/devicetree/bindings/remoteproc/ti,pru-consumer.yaml create mode 100644 include/linux/pruss.h