From patchwork Mon Jul 9 15:51:03 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Georgi Djakov X-Patchwork-Id: 10515059 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id AFE826032A for ; Mon, 9 Jul 2018 15:52:53 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 993B528D54 for ; Mon, 9 Jul 2018 15:52:53 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 8C8E428D43; Mon, 9 Jul 2018 15:52:53 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-8.0 required=2.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, MAILING_LIST_MULTI, RCVD_IN_DNSWL_HI autolearn=ham version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 3603428D43 for ; Mon, 9 Jul 2018 15:52:53 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S933004AbeGIPwu (ORCPT ); Mon, 9 Jul 2018 11:52:50 -0400 Received: from mail-wm0-f66.google.com ([74.125.82.66]:55169 "EHLO mail-wm0-f66.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S933845AbeGIPvV (ORCPT ); Mon, 9 Jul 2018 11:51:21 -0400 Received: by mail-wm0-f66.google.com with SMTP id i139-v6so21556738wmf.4 for ; Mon, 09 Jul 2018 08:51:20 -0700 (PDT) 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; bh=IqhM5Ox8GZtLGas2YyRL1o8i1y7I7Q6nRSIg2WoLuIA=; b=ev/znSSYUOCgY99iFogLuTh8Rbq7ljCV1Xl3qfyfll/JVS/DbKytOCPpRkYmFo9Lhv PzT1Fwi5bUhYjBEgP5IsDGj0tKUfe5RTb7RzGZlU3MFrgSjvQkoHVYR65Q/5xXSiTstS W9EIZTsd47YQJbPm5OaMiH3e3qDMLWT3Ubvz0= 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; bh=IqhM5Ox8GZtLGas2YyRL1o8i1y7I7Q6nRSIg2WoLuIA=; b=YXLG7PgzjWQo8mhi+p8pKtFf9GxzMgby2r9Q1WrEXC1M46fWIeshcgTLI63oAu24It c8eiQGfs8bSin3ICfpBVpej8V+4yLP9ukKPyRRITgbeFqEnE8lZNty8yKaja/Ogk2LsO DhSthAT8Aj0Xohqxjc6GLqomca1IrpxFjI4367Lr0K7zbjzVF1HIoDTFHZhEv8iadFDG NMKRe/zD1MxC51KB2GMOKcZ9/kE6VcCRKTKfjQTCm1ELRcGw9lH/TjsakSzpeyQ9S2ap 5XbJX7b7M+6UY3Kpv7pCjrb6B3MywzKvw1QI7H4xoVKvifB4Rq2pZX3jLYBi/PG5Kf38 lksg== X-Gm-Message-State: APt69E3WPVMKehcR8/VfzlnTVxqQ49xJujdWwf081zTHa7uwvd19/bkQ dJSAub5xqp4f4nS1nhr5/kORWyrynSY= X-Google-Smtp-Source: AAOMgpdgV9JppOVDgWtm+KcJn5i7BG5YPOWi8vVGyWNHHiR2/u+snjdXpTVWAviSzaqkfdHzgP/7ng== X-Received: by 2002:a1c:a8f:: with SMTP id 137-v6mr11419231wmk.119.1531151479838; Mon, 09 Jul 2018 08:51:19 -0700 (PDT) Received: from localhost.localdomain ([212.45.67.2]) by smtp.googlemail.com with ESMTPSA id o21-v6sm16229202wmg.28.2018.07.09.08.51.18 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Mon, 09 Jul 2018 08:51:19 -0700 (PDT) From: Georgi Djakov To: linux-pm@vger.kernel.org, gregkh@linuxfoundation.org Cc: rjw@rjwysocki.net, robh+dt@kernel.org, mturquette@baylibre.com, khilman@baylibre.com, abailon@baylibre.com, vincent.guittot@linaro.org, skannan@codeaurora.org, bjorn.andersson@linaro.org, amit.kucheria@linaro.org, seansw@qti.qualcomm.com, daidavid1@codeaurora.org, evgreen@chromium.org, mka@chromium.org, mark.rutland@arm.com, lorenzo.pieralisi@arm.com, linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-arm-msm@vger.kernel.org, georgi.djakov@linaro.org Subject: [PATCH v6 7/8] dt-bindings: Introduce interconnect consumers bindings Date: Mon, 9 Jul 2018 18:51:03 +0300 Message-Id: <20180709155104.25528-8-georgi.djakov@linaro.org> X-Mailer: git-send-email 2.18.0 In-Reply-To: <20180709155104.25528-1-georgi.djakov@linaro.org> References: <20180709155104.25528-1-georgi.djakov@linaro.org> Sender: linux-pm-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-pm@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP Add documentation for the interconnect consumer bindings, that will allow to link a device node (consumer) to its interconnect controller hardware. Tha aim is to enable drivers to request a framework API to configure an interconnect path by providing their struct device pointer and a name. Signed-off-by: Georgi Djakov --- .../bindings/interconnect/interconnect.txt | 27 +++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/Documentation/devicetree/bindings/interconnect/interconnect.txt b/Documentation/devicetree/bindings/interconnect/interconnect.txt index 6e2b2971b094..0ad65dccbe8b 100644 --- a/Documentation/devicetree/bindings/interconnect/interconnect.txt +++ b/Documentation/devicetree/bindings/interconnect/interconnect.txt @@ -31,3 +31,30 @@ Example: clocks = <&rpmcc RPM_SMD_SNOC_CLK>, <&rpmcc RPM_SMD_SNOC_A_CLK>; }; + + += interconnect consumers = + +The interconnect consumers are device nodes which consume the interconnect +path(s) provided by the interconnect provider. There can be multiple +interconnect providers on a SoC and the consumer may consume multiple paths +from different providers depending on use case and the components it has to +interact with. + +Required properties: +interconnects : Pairs of phandles and interconnect provider specifier to denote + the edge source and destination ports of the interconnect path. + +Optional properties: +interconnect-names : List of interconnect path name strings sorted in the same + order as the interconnects property. Consumers drivers will use + interconnect-names to match interconnect paths with interconnect + specifiers. + +Example: + + sdhci@7864000 { + ... + interconnects = <&pnoc MASTER_SDCC_1 &bimc SLAVE_EBI_CH0>; + interconnect-names = "ddr"; + };