From patchwork Mon Dec 11 23:42:56 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Srinivas Kandagatla X-Patchwork-Id: 121487 Delivered-To: patch@linaro.org Received: by 10.140.22.227 with SMTP id 90csp3433767qgn; Mon, 11 Dec 2017 15:49:36 -0800 (PST) X-Google-Smtp-Source: ACJfBosGuix3PChFt41hZtTKJTfm86gynIq7oJkz6U7B58qTxl2eA5zPaagAG/eeO8E4aFRpmnQ5 X-Received: by 10.98.86.193 with SMTP id h62mr261368pfj.109.1513036176399; Mon, 11 Dec 2017 15:49:36 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1513036176; cv=none; d=google.com; s=arc-20160816; b=uoXJLjX1ZwxighrDtYbyh6wOkn80GKAzVrZZCEIfnNf4S2Q8nDKDWcpuwHnAoolzsv A9u1vcAsEp03LS9xDVwfReuTf1/752kdi4iwnlB+9Fh0naerKtZs3NlnCj82rTc80hNQ NdOk4x2nSHspfvp2KJGAvcZ16kZnJ64vKJqBsPnEx5iLJcGhklpIa6PkuouERboQ4225 0mpK61IljhNNDdeYY5o6osqsATYgHzauAHQ/il2eEmce5K/PgboXpDN0PvzvBJM25ifR J9efTB7Z7Z3RSLxQWXPDW2+bD+WCEvVgJ/pBmRfe4iB3mCHeDeDcRJQp81AQ5AZ6LDFp tbAw== 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=Q7U/0kN2tQpLQe4j1F+WYJFLszDcPK+NGpoKobxhhy0=; b=zy0S7VDkwQu7sA9Y0ef66wmRUMO/mnRA3nPFQZFYzT2G6b4Ry6QdRLGVHH3nnKfCkt CmXoDpCDmKlh1hsepqLGiw1/8JrQ+dDR3+c9kvUNQSzmjzZwj4nuY++v45DO+YOyGqtS 9TnDn5Eu1jVZoUpoa+sNVZ9sqUbcqq1aIZ/V/sElHhP5ll7Pf8mEkxwC8HrkyVGQynj/ G/jr+tcmQnyORvfm8vGQT3+w1Txp9gwFwzZ4vkK1WUPYiNqcRDgLbUdAo7l3/y8LIO8M msgdbF2QhstIlEO9SnwYxre20GWjGXDsT11FTTRBt9CwO5FcH73g1klLcux1PyMC7jYv zYDA== ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@linaro.org header.s=google header.b=WKwSeHfr; spf=pass (google.com: best guess record for domain of devicetree-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=devicetree-owner@vger.kernel.org; dmarc=fail (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 q9si10605053pgf.732.2017.12.11.15.49.36; Mon, 11 Dec 2017 15:49:36 -0800 (PST) Received-SPF: pass (google.com: best guess record for domain of devicetree-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; dkim=neutral (body hash did not verify) header.i=@linaro.org header.s=google header.b=WKwSeHfr; spf=pass (google.com: best guess record for domain of devicetree-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=devicetree-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752377AbdLKXtf (ORCPT + 6 others); Mon, 11 Dec 2017 18:49:35 -0500 Received: from mail-wm0-f67.google.com ([74.125.82.67]:42220 "EHLO mail-wm0-f67.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752190AbdLKXpR (ORCPT ); Mon, 11 Dec 2017 18:45:17 -0500 Received: by mail-wm0-f67.google.com with SMTP id b199so13839587wme.1 for ; Mon, 11 Dec 2017 15:45:17 -0800 (PST) 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=HZYbyrD9ze1PZ+q2JHZiocYridKvauK/rrLWoYJTwSg=; b=WKwSeHfr0UUQBc0xrJ4dV0LMxj4NABKA1ctryLxyfjELgjHPRT0ryyINFD3sybrpxR ehuB8a/VDhSZrNVHbe6HzaqSww77MEn6HmrwgS8hk5Jg2JP1aCfC5mPydF3MtN3AIQBc dMj+xsUozc8h7uxOKly5I5LRZmpQHL/+0w7jQ= 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=HZYbyrD9ze1PZ+q2JHZiocYridKvauK/rrLWoYJTwSg=; b=exbCMlbsJZ9J9KA3537eCZxOCmU4Rgb2XJ/NmWBJQ2GM2PUAB/UMdjOAqf69gKLR0q mlU4yZyK8ZVqtm6E1/E8FfSPD28OG2BtZwaE5RY/dC05RgialhKI97s8ghH1taC6bFrO o1FmsTFmXoROyHOmtFI7B1m3lvXV4AiL/7Y669mDywOrF3F9No51N1PfF/1V4Tg5OcKH cHC5oF8KMK/vIQOK3cHPZa2roIAfUl78qBaLY9BxvE8+Bz2bYzSWuqLAnZZIEDfRdaml XjogImApH02K/D7RvGj1Cy1hghsq40kEEkszfGXosej/pSpdf6rhT7+L598QzWzYE/7W tktQ== X-Gm-Message-State: AKGB3mKHHdPW6Ow6ilU8Uw1NxIDhLX707fQmDO3VhJd/M9LCrLc+eaGX TJ7iMv7uaHRaLkPi+RckR4qZtg== X-Received: by 10.28.231.19 with SMTP id e19mr24940wmh.1.1513035916635; Mon, 11 Dec 2017 15:45:16 -0800 (PST) Received: from localhost.localdomain (cpc90716-aztw32-2-0-cust92.18-1.cable.virginm.net. [86.26.100.93]) by smtp.gmail.com with ESMTPSA id k69sm10673615wmg.8.2017.12.11.15.45.15 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Mon, 11 Dec 2017 15:45:16 -0800 (PST) From: srinivas.kandagatla@linaro.org To: Mark Brown , Greg Kroah-Hartman , alsa-devel@alsa-project.org Cc: sdharia@codeaurora.org, Rob Herring , Mark Rutland , Jonathan Corbet , pombredanne@nexb.com, j.neuschaefer@gmx.net, linux-arm-msm@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org, Srinivas Kandagatla Subject: [PATCH v10 02/13] dt-bindings: Add SLIMbus bindings Date: Mon, 11 Dec 2017 23:42:56 +0000 Message-Id: <20171211234307.14465-3-srinivas.kandagatla@linaro.org> X-Mailer: git-send-email 2.15.0 In-Reply-To: <20171211234307.14465-1-srinivas.kandagatla@linaro.org> References: <20171211234307.14465-1-srinivas.kandagatla@linaro.org> Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org From: Sagar Dharia SLIMbus (Serial Low Power Interchip Media Bus) is a specification developed by MIPI (Mobile Industry Processor Interface) alliance. SLIMbus is a 2-wire implementation, which is used to communicate with peripheral components like audio-codec. This patch adds device tree bindings for the slimbus. Signed-off-by: Sagar Dharia Signed-off-by: Srinivas Kandagatla Reviewed-by: Rob Herring --- Documentation/devicetree/bindings/slimbus/bus.txt | 50 +++++++++++++++++++++++ 1 file changed, 50 insertions(+) create mode 100644 Documentation/devicetree/bindings/slimbus/bus.txt -- 2.15.0 -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html diff --git a/Documentation/devicetree/bindings/slimbus/bus.txt b/Documentation/devicetree/bindings/slimbus/bus.txt new file mode 100644 index 000000000000..52fa6426388c --- /dev/null +++ b/Documentation/devicetree/bindings/slimbus/bus.txt @@ -0,0 +1,50 @@ +SLIM(Serial Low Power Interchip Media Bus) bus + +SLIMbus is a 2-wire bus, and is used to communicate with peripheral +components like audio-codec. + +Required property for SLIMbus controller node: +- compatible - name of SLIMbus controller + +Child nodes: +Every SLIMbus controller node can contain zero or more child nodes +representing slave devices on the bus. Every SLIMbus slave device is +uniquely determined by the enumeration address containing 4 fields: +Manufacturer ID, Product code, Device index, and Instance value for +the device. +If child node is not present and it is instantiated after device +discovery (slave device reporting itself present). + +In some cases it may be necessary to describe non-probeable device +details such as non-standard ways of powering up a device. In +such cases, child nodes for those devices will be present as +slaves of the SLIMbus controller, as detailed below. + +Required property for SLIMbus child node if it is present: +- reg - Should be ('Device index', 'Instance ID') from SLIMbus + Enumeration Address. + Device Index Uniquely identifies multiple Devices within + a single Component. + Instance ID Is for the cases where multiple Devices of the + same type or Class are attached to the bus. + +- compatible -"slimMID,PID". The textual representation of Manufacturer ID, + Product Code, shall be in lower case hexadecimal with leading + zeroes suppressed + +SLIMbus example for Qualcomm's slimbus manager component: + + slim@28080000 { + compatible = "qcom,apq8064-slim", "qcom,slim"; + reg = <0x28080000 0x2000>, + interrupts = <0 33 0>; + clocks = <&lcc SLIMBUS_SRC>, <&lcc AUDIO_SLIMBUS_CLK>; + clock-names = "iface", "core"; + #address-cells = <2>; + #size-cell = <0>; + + codec: wcd9310@1,0{ + compatible = "slim217,60"; + reg = <1 0>; + }; + };