From patchwork Wed Apr 14 00:27:21 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Nishanth Menon X-Patchwork-Id: 12201623 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-16.8 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER, INCLUDES_PATCH,MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,USER_AGENT_GIT autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id AFC68C433ED for ; Wed, 14 Apr 2021 00:29:39 +0000 (UTC) Received: from desiato.infradead.org (desiato.infradead.org [90.155.92.199]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id EB9A6613A9 for ; Wed, 14 Apr 2021 00:29:38 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org EB9A6613A9 Authentication-Results: mail.kernel.org; dmarc=fail (p=quarantine dis=none) header.from=ti.com Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=desiato.20200630; h=Sender:Content-Transfer-Encoding :Content-Type:Cc:List-Subscribe:List-Help:List-Post:List-Archive: List-Unsubscribe:List-Id:MIME-Version:Message-ID:Date:Subject:To:From: Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender :Resent-To:Resent-Cc:Resent-Message-ID:In-Reply-To:References:List-Owner; bh=iy6GawnQKKJuDuTkkSETNYswO1h+qnYsOwsP5Czy0Ys=; b=MsJj36N4se5Bx0gk0r5WS1AGZX MOXsW0DBlJD4OBqmCbLMkVSR9RW4enrFNhtrU/NWRG0McjERN4oqcXxeQXOVmowGJ9imEpVQpVkIC pwfn6ZcgbdWEVPrVRUWi3CBUwKbtJiHkl8/I30w1ZfSsFjxer85NHoOLuEddX8jZuAWRv+DSO5kFB 7X4b+ioGb/H/NIM/xkRPr4eH/g6W3N4TX1TudSrMa+o54qxwq3zHD2nclM9RBsju6CbgnZU21a6tR K2yVpaJlXaJEpuBRCj9cE2qOGr8ToxkRdEfLN8DL4e2EaZvuIhZDM3AoSkJVktWxAWRSrp6okcik3 WRa/R2Cw==; Received: from localhost ([::1] helo=desiato.infradead.org) by desiato.infradead.org with esmtp (Exim 4.94 #2 (Red Hat Linux)) id 1lWTNV-00AwGH-O3; Wed, 14 Apr 2021 00:27:33 +0000 Received: from bombadil.infradead.org ([2607:7c80:54:e::133]) by desiato.infradead.org with esmtps (Exim 4.94 #2 (Red Hat Linux)) id 1lWTNP-00AwFl-QF for linux-arm-kernel@desiato.infradead.org; Wed, 14 Apr 2021 00:27:28 +0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Type: Content-Transfer-Encoding:MIME-Version:Message-ID:Date:Subject:CC:To:From: Sender:Reply-To:Content-ID:Content-Description:In-Reply-To:References; bh=8B7/458hroNL10JXEQwHmtq+ENc6/m8u+y+7uLgXATY=; b=08fwuYbu2C+ftyBFSoIdO53wIo OhJNgJraKil2AxHvbSS2kCMZK1YwpPNLmR2/4nUHSKL2u+2XppLU+0Ys+TX65mshTSKko4XTKvxHa sQVKZietZ9vRSIChUG7A04e7RINJ6fuYMipvA0EJ0nZZMOKrfJF8BePNINopi2vjZGmFY/YDuWYlz J9zIFPYiVVaIOsa4e4z1nXq2Dop1Cw4PpgiRX7dTnN9hdCyQApNVWp66FS7v0lRoPDDmVfIKvjp8q 5MUfgA1Euh8C4pdxQFU1ki7VmcMT0yvYVQ0fUpSbqQq6urlNS0WJTqMCulB2S6OM5RqnZRI8DD6h6 awWqp8MQ==; Received: from fllv0015.ext.ti.com ([198.47.19.141]) by bombadil.infradead.org with esmtps (Exim 4.94 #2 (Red Hat Linux)) id 1lWTNM-007P6d-Jp for linux-arm-kernel@lists.infradead.org; Wed, 14 Apr 2021 00:27:26 +0000 Received: from lelv0266.itg.ti.com ([10.180.67.225]) by fllv0015.ext.ti.com (8.15.2/8.15.2) with ESMTP id 13E0RNID069350; Tue, 13 Apr 2021 19:27:23 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ti.com; s=ti-com-17Q1; t=1618360043; bh=8B7/458hroNL10JXEQwHmtq+ENc6/m8u+y+7uLgXATY=; h=From:To:CC:Subject:Date; b=XZXgm91u7PcSrIJakEoEDTFighynJUAtjniggNp4gejlBqL+R7kzuUewxG6AxQBOq e3z9zElvBbuktKjUH6Vesj1LO5McPF5bXhtCBd5ZO96Z3LfKXxlSNjBpN5FsS3Ekua S3o28GjFcvLrAHt3O7HWg4O5YSJUzma8Oa3HCHL0= Received: from DLEE109.ent.ti.com (dlee109.ent.ti.com [157.170.170.41]) by lelv0266.itg.ti.com (8.15.2/8.15.2) with ESMTPS id 13E0RMup033154 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=FAIL); Tue, 13 Apr 2021 19:27:23 -0500 Received: from DLEE114.ent.ti.com (157.170.170.25) by DLEE109.ent.ti.com (157.170.170.41) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.2176.2; Tue, 13 Apr 2021 19:27:22 -0500 Received: from lelv0326.itg.ti.com (10.180.67.84) by DLEE114.ent.ti.com (157.170.170.25) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.2176.2 via Frontend Transport; Tue, 13 Apr 2021 19:27:22 -0500 Received: from localhost (ileax41-snat.itg.ti.com [10.172.224.153]) by lelv0326.itg.ti.com (8.15.2/8.15.2) with ESMTP id 13E0RMVD113196; Tue, 13 Apr 2021 19:27:22 -0500 From: Nishanth Menon To: Jassi Brar , Rob Herring Subject: [PATCH] dt-bindings: mailbox: ti,message-manager: Convert to yaml Date: Tue, 13 Apr 2021 19:27:21 -0500 Message-ID: <20210414002721.23638-1-nm@ti.com> X-Mailer: git-send-email 2.31.0 MIME-Version: 1.0 X-EXCLAIMER-MD-CONFIG: e1e8a2fd-e40a-4ac6-ac9b-f7e9cc9ee180 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20210413_172724_761632_A2FED5DD X-CRM114-Status: GOOD ( 18.65 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Nishanth Menon , devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, Santosh Shilimkar , linux-arm-kernel@lists.infradead.org Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org Convert the ti,secure-proxy to yaml for better checks and documentation. Differences being mostly in the examples: - I've dropped the example usage of mailbox client, it is better done in tisci node definition - included header in example for buildable example NOTE: The following checkpatch warning is generated since we do include the header in the example, but this is a false positive warning. WARNING: DT binding docs and includes should be a separate patch. See: Documentation/devicetree/bindings/submitting-patches.rst Signed-off-by: Nishanth Menon --- Depending on how [1] turns out in discussion, we might want to queue [2] appropriately. [1] https://lore.kernel.org/linux-arm-kernel/CAK8P3a1L8rWpR5b66v6Su8-m7-scA0wZQr_g_4KnV4dnrky6ZA@mail.gmail.com/ [2] https://lore.kernel.org/linux-arm-kernel/20210414001926.20002-1-nm@ti.com/ .../bindings/mailbox/ti,message-manager.txt | 50 ------------- .../bindings/mailbox/ti,message-manager.yaml | 75 +++++++++++++++++++ 2 files changed, 75 insertions(+), 50 deletions(-) delete mode 100644 Documentation/devicetree/bindings/mailbox/ti,message-manager.txt create mode 100644 Documentation/devicetree/bindings/mailbox/ti,message-manager.yaml diff --git a/Documentation/devicetree/bindings/mailbox/ti,message-manager.txt b/Documentation/devicetree/bindings/mailbox/ti,message-manager.txt deleted file mode 100644 index ebf0e3710cee..000000000000 --- a/Documentation/devicetree/bindings/mailbox/ti,message-manager.txt +++ /dev/null @@ -1,50 +0,0 @@ -Texas Instruments' Message Manager Driver -======================================== - -The Texas Instruments' Message Manager is a mailbox controller that has -configurable queues selectable at SoC(System on Chip) integration. The Message -manager is broken up into queues in different address regions that are called -"proxies" - each instance is unidirectional and is instantiated at SoC -integration level to indicate receive or transmit path. - -Message Manager Device Node: -=========================== -Required properties: --------------------- -- compatible: Shall be: "ti,k2g-message-manager" -- reg-names queue_proxy_region - Map the queue proxy region. - queue_state_debug_region - Map the queue state debug - region. -- reg: Contains the register map per reg-names. -- #mbox-cells Shall be 2. Contains the queue ID and proxy ID in that - order referring to the transfer path. -- interrupt-names: Contains interrupt names matching the rx transfer path - for a given SoC. Receive interrupts shall be of the - format: "rx_". - For ti,k2g-message-manager, this shall contain: - "rx_005", "rx_057" -- interrupts: Contains the interrupt information corresponding to - interrupt-names property. - -Example(K2G): ------------- - - msgmgr: msgmgr@2a00000 { - compatible = "ti,k2g-message-manager"; - #mbox-cells = <2>; - reg-names = "queue_proxy_region", "queue_state_debug_region"; - reg = <0x02a00000 0x400000>, <0x028c3400 0x400>; - interrupt-names = "rx_005", "rx_057"; - interrupts = , - ; - }; - - pmmc: pmmc { - [...] - mbox-names = "rx", "tx"; - # RX queue ID is 5, proxy ID is 2 - # TX queue ID is 0, proxy ID is 0 - mboxes= <&msgmgr 5 2>, - <&msgmgr 0 0>; - [...] - }; diff --git a/Documentation/devicetree/bindings/mailbox/ti,message-manager.yaml b/Documentation/devicetree/bindings/mailbox/ti,message-manager.yaml new file mode 100644 index 000000000000..4987e803ac37 --- /dev/null +++ b/Documentation/devicetree/bindings/mailbox/ti,message-manager.yaml @@ -0,0 +1,75 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/mailbox/ti,message-manager.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Texas Instruments' Message Manager Driver + +maintainers: + - Nishanth Menon + +description: | + The Texas Instruments' Message Manager is a mailbox controller that has + configurable queues selectable at SoC(System on Chip) integration. The Message + manager is broken up into queues in different address regions that are called + "proxies" - each instance is unidirectional and is instantiated at SoC + integration level to indicate receive or transmit path. + +properties: + $nodename: + pattern: "^mailbox@[0-9a-f]+$" + + compatible: + const: ti,k2g-message-manager + + "#mbox-cells": + const: 2 + description: + Contains the queue ID and proxy ID in that order referring to the + transfer path. + + reg-names: + items: + - const: queue_proxy_region + - const: queue_state_debug_region + + reg: + minItems: 2 + + interrupt-names: + items: + - const: rx_005 + - const: rx_057 + description: + Contains interrupt names matching the Rx transfer path for a given SoC. + Receive interrupts shall be of the format "rx_". + + interrupts: + minItems: 2 + description: + Contains the interrupt information for the Rx interrupt paths for message + manager corresponding to the interrupt-names. + +required: + - compatible + - reg-names + - reg + - interrupt-names + - interrupts + - "#mbox-cells" + +additionalProperties: false + +examples: + - | + #include + msgmgr: mailbox@2a00000 { + compatible = "ti,k2g-message-manager"; + #mbox-cells = <2>; + reg-names = "queue_proxy_region", "queue_state_debug_region"; + reg = <0x02a00000 0x400000>, <0x028c3400 0x400>; + interrupt-names = "rx_005", "rx_057"; + interrupts = , + ; + };