From patchwork Fri Aug 10 14:52:27 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Georgi Djakov X-Patchwork-Id: 143942 Delivered-To: patch@linaro.org Received: by 2002:a2e:9754:0:0:0:0:0 with SMTP id f20-v6csp49725ljj; Fri, 10 Aug 2018 07:52:49 -0700 (PDT) X-Google-Smtp-Source: AA+uWPyaSBn4fBHEf4uxAltICzUpLnjd1Lc7AwLjSFkRqBR5bRQLved4Iw2ltVDHoJc1JQIyDPit X-Received: by 2002:a17:902:59da:: with SMTP id d26-v6mr6504585plj.42.1533912769569; Fri, 10 Aug 2018 07:52:49 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1533912769; cv=none; d=google.com; s=arc-20160816; b=FMSU5MRZhRU0+idOQZwJcCPGD5f0AJUoofbmpsf9OplWtks/bD751xRBQ3ViRxt/oI w8V1Bt9y6mKImBE33/we6eWifOEKFyFcP5UfP1qdAZCXFpumqHoqrkDqI99V9gViwIqB AyfRDUwoi7W67n8qyFsj9BRWDNI9SSiUT0CErT3V49k6VBvEvZmKd4x/j24LBhLEz6Pb ONQTyITv/FYy5aokNK/hmNbpFIvYC7sAjScDfFrqzs9Y+pCZNRYe5eqPJscxW0KHX3Dm t8Ko36ZvRnDAcImVqFynfUy2FUrr4r4ux5kjR/w/1g4OAPMelGjJbWcFNXXJiXKKvs9T YTWQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:references:in-reply-to:message-id:date :subject:cc:to:from:dkim-signature:arc-authentication-results; bh=Wpwh1J0n/D8S9rbxdqkayW0bLbU11ULq+GMS5dW7EjU=; b=OOxFJIDx+AwNMzM/JtxQAmn5Yq9gOQK2+4AehMX8MB6FEsdcmEQgBeKzSDmQ5vLWG+ 4xuHK0wHaorymJuScgSKNQpzzUU0JEityXC5Y/h1c+Fp9JT2NFcXzP3T9Ob4rW7iTye8 BF3ahRqAuFKYjHkhbSpK1pyKrWqB8srsEF1WjDwNKaC/5rpaWqIHQaXSjNEbiPRKL/v2 aTSF3TRLjL0XpSBYgIXfcVoaRn4lUYGGmi/MTqEKIEWBn8Fi60SojWxwsDknMn/m1aAb iU5ILbe+HE5UiSo2xLGe0aNXNVD6w11UNN89aHQwKNO3hW6umzY3baAWgyxXlCsR3f6q TQ8g== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=alG8SUHl; spf=pass (google.com: best guess record for domain of linux-arm-msm-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-arm-msm-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. [209.132.180.67]) by mx.google.com with ESMTP id j17-v6si11638351pfk.203.2018.08.10.07.52.49; Fri, 10 Aug 2018 07:52:49 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-arm-msm-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=@linaro.org header.s=google header.b=alG8SUHl; spf=pass (google.com: best guess record for domain of linux-arm-msm-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-arm-msm-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 S1728299AbeHJRXB (ORCPT + 13 others); Fri, 10 Aug 2018 13:23:01 -0400 Received: from mail-wr1-f67.google.com ([209.85.221.67]:40507 "EHLO mail-wr1-f67.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728283AbeHJRXB (ORCPT ); Fri, 10 Aug 2018 13:23:01 -0400 Received: by mail-wr1-f67.google.com with SMTP id h15-v6so8551996wrs.7 for ; Fri, 10 Aug 2018 07:52:47 -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=Wpwh1J0n/D8S9rbxdqkayW0bLbU11ULq+GMS5dW7EjU=; b=alG8SUHlrGlrBguXp0OwUd+5ntlokkyoAptgeDfts5gxy1ZiFBgd3oVCKCcSMaChS+ 2kx8KgB6MDTKjmevMOINUJjHvklVYHSDPAE6Ky4jNsMLYET4eYH5Q8tFBRU+CTDLxSsc AeJb295UnxuH4Y0ipoepMDmkzHSCfQ2Nn8NE4= 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=Wpwh1J0n/D8S9rbxdqkayW0bLbU11ULq+GMS5dW7EjU=; b=dYZiLQrrPKd8tbLSIcWYyAHvMQMZkICEphmYX4SwPz11zWBvDiaveXA7Q9GXs/Puoa O+BaSmL9YM1A5dZcDF1YEEKa6BR2/pSvSM5PWDQFX/KiiasSh1r9IQScVuSP2nY5NA/0 YHym5Ol9RXG65Upq2P/FYPpmIqTQl8LpeKtc9EXzQQIDT2CVcal2KnmlcCsIj2vp9JZn kKJmzISqASu3Q33BCEvRo2VfPTnLpq1E85q3kbURbZHQ8QY8l1US+ZO3DG0MAF6cOO53 dtWaBVBoFUoCSH/KcDReXrE2dmyN+huofoN3+NlOR7tOxPhz2MFrIgJsjyxvHgvLPat8 bCMA== X-Gm-Message-State: AOUpUlFJ68myVsLT6SPkVhYu7mC3IMKKc2RfvcFESd2qviV+F/AIceOH 5hLAKDKEl3kpojt5iKjyJYcGAdMqy0U= X-Received: by 2002:adf:bf10:: with SMTP id p16-v6mr4324454wrh.235.1533912766599; Fri, 10 Aug 2018 07:52:46 -0700 (PDT) Received: from localhost.localdomain ([212.45.67.2]) by smtp.googlemail.com with ESMTPSA id 9-v6sm19842700wrb.48.2018.08.10.07.52.44 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Fri, 10 Aug 2018 07:52:45 -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, 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, mark.rutland@arm.com, lorenzo.pieralisi@arm.com, abailon@baylibre.com, arnd@arndb.de, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-arm-msm@vger.kernel.org, georgi.djakov@linaro.org Subject: [PATCH v8 2/8] dt-bindings: Introduce interconnect binding Date: Fri, 10 Aug 2018 17:52:27 +0300 Message-Id: <20180810145233.16466-3-georgi.djakov@linaro.org> X-Mailer: git-send-email 2.18.0 In-Reply-To: <20180810145233.16466-1-georgi.djakov@linaro.org> References: <20180810145233.16466-1-georgi.djakov@linaro.org> Sender: linux-arm-msm-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-arm-msm@vger.kernel.org This binding is intended to represent the relations between the interconnect controllers (providers) and consumer device nodes. It will allow creating links between consumers and interconnect paths (exposed by interconnect providers). Signed-off-by: Georgi Djakov --- .../bindings/interconnect/interconnect.txt | 60 +++++++++++++++++++ 1 file changed, 60 insertions(+) create mode 100644 Documentation/devicetree/bindings/interconnect/interconnect.txt diff --git a/Documentation/devicetree/bindings/interconnect/interconnect.txt b/Documentation/devicetree/bindings/interconnect/interconnect.txt new file mode 100644 index 000000000000..5cb7d3c8d44d --- /dev/null +++ b/Documentation/devicetree/bindings/interconnect/interconnect.txt @@ -0,0 +1,60 @@ +Interconnect Provider Device Tree Bindings +========================================= + +The purpose of this document is to define a common set of generic interconnect +providers/consumers properties. + + += interconnect providers = + +The interconnect provider binding is intended to represent the interconnect +controllers in the system. Each provider registers a set of interconnect +nodes, which expose the interconnect related capabilities of the interconnect +to consumer drivers. These capabilities can be throughput, latency, priority +etc. The consumer drivers set constraints on interconnect path (or endpoints) +depending on the use case. Interconnect providers can also be interconnect +consumers, such as in the case where two network-on-chip fabrics interface +directly + +Required properties: +- compatible : contains the interconnect provider compatible string +- #interconnect-cells : number of cells in a interconnect specifier needed to + encode the interconnect node id + +Example: + + snoc: snoc@580000 { + compatible = "qcom,msm8916-snoc"; + #interconnect-cells = <1>; + reg = <0x580000 0x14000>; + clock-names = "bus_clk", "bus_a_clk"; + clocks = <&rpmcc RPM_SMD_SNOC_CLK>, + <&rpmcc RPM_SMD_SNOC_A_CLK>; + }; + + += interconnect consumers = + +The interconnect consumers are device nodes which dynamically express their +bandwidth requirements along interconnect paths they are connected to. 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"; + };