From patchwork Thu Nov 30 17:41:49 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Srinivas Kandagatla X-Patchwork-Id: 120259 Delivered-To: patch@linaro.org Received: by 10.140.22.227 with SMTP id 90csp89761qgn; Thu, 30 Nov 2017 09:46:01 -0800 (PST) X-Google-Smtp-Source: AGs4zMaEnr7X38qohJiKwLPYfWYrf4+eHPIggLSyxJSCluDy2YtmD/qKS2CzjYAP4yMX0vI2Rw5O X-Received: by 10.99.116.17 with SMTP id p17mr3013665pgc.385.1512063960770; Thu, 30 Nov 2017 09:46:00 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1512063960; cv=none; d=google.com; s=arc-20160816; b=rnliJXngMgPRjDMgZKSgDe4nbT81Vm1q+ROPi6/Y6vEpRX8AfjT+Ki+3EPecf3oI79 qK3rwZUAhcK8AQdUM/zua2wlr8BRfcdUS4rYBWfRuyOjDj2OLx0KVataVnUazjppmseq qSOgTurtVGlLgXst2bAX10spe80CPHML4yosycAdibsirHU4df0fN2tKEK1CyyfrVc3a 43Ebs5drG6Ob2EULkeiwbaX2OMJGTO75oj/M/uHnMgWXTJU89s6Zgw0V0/hoaB5C9pYy i7/b87AjFM6E3z4lHsczZz7woAat2iGtiuagqiovUAnnLoWBZ1bWQwYU2zTiD+8WVobE SsZQ== 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=HZYbyrD9ze1PZ+q2JHZiocYridKvauK/rrLWoYJTwSg=; b=LSnVCjX+fOHS2zz7J8YHV48qgj1i9Sgg99awtUVrCSpVlmYJ7tUBfjD4IUcgTtJG6s C5B/1cXs1e6FXQaAJZoxVACpRyOHR+WgogxiYi1C+I308T92ohuVVNobPUDTmv2Arowz qW/lsT0Eci1/bnMPp776+Fp6TKy4IrtULuc/AuJg88arQplfM3THpsYMYO2WTVTxFSvf ldr2Q0hSEahZY32LfXZK1GVQdduJ3lmNxb7F3ehK+c6dPUEWFa49LZc8RF1L1El+v0JN 0DLx4ogF3e8zFZTg/fOAKfQrO10bQ/xcuUAk8yhIe22Rh+QljHDMe5K1OkMB7nvrUPRo oimA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=CZAveNjX; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-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 bf5si3526200plb.578.2017.11.30.09.46.00; Thu, 30 Nov 2017 09:46:00 -0800 (PST) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-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=CZAveNjX; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-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 S1753909AbdK3Rp5 (ORCPT + 28 others); Thu, 30 Nov 2017 12:45:57 -0500 Received: from mail-wm0-f66.google.com ([74.125.82.66]:38161 "EHLO mail-wm0-f66.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753859AbdK3Rpv (ORCPT ); Thu, 30 Nov 2017 12:45:51 -0500 Received: by mail-wm0-f66.google.com with SMTP id 64so13891681wme.3 for ; Thu, 30 Nov 2017 09:45:51 -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=CZAveNjXnOSTavULFyikC8aJVE4/CpXxvDfAG3F/i66WfkylWG6w6Fx97FfkH7wg+m Uy98YhTIj+z+uMsRjNtNTs4eECcfobHDi15LvejbWl1AI2TUAvMjyMskUT4qkoBXQxVt SFcQUiL47yp2yawQzHwjV7TtECgJ6GaJyaSg0= 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=LKwv0HHnq017jFrZA6ZYg2gsD560zYYx99KBEPzj47mbTFsB4myZ4tBstAjmmVJ0NZ GSrlMmXQbt/FG/v0VQFNIdkvp4yWXrj1/pBXtU2nyrAoR36oxADUSana+RNFI50HXHDh i3zJ82bmZEAM/DFMkq+cCmks/DlhaMBmq0WoTowWayKUm0NN8dZs2eXZlKuZgX4V4q8r Gi54SUauEYyUFY9Nyl6QlMtJwFHcK+X8PdDkgbw5Wyj9lVShCMJ/emh+WsuCo1BDaG7l GY8l7EXPEMYE2M6y69c05mAcDXT0WQJQq8EGiK5vJVKiMxbdNDpPmIPU4u+M3jF2CZMa fZVQ== X-Gm-Message-State: AJaThX7Y9KAMmawolrocDynonxAo9IN34d5dLsNhKJHRUX2xblkRhdnZ 2MS29wT3jT93sKK8O5blk8qoQg== X-Received: by 10.28.55.71 with SMTP id e68mr1325425wma.139.1512063950329; Thu, 30 Nov 2017 09:45:50 -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 189sm2412189wmu.3.2017.11.30.09.45.48 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Thu, 30 Nov 2017 09:45:49 -0800 (PST) From: srinivas.kandagatla@linaro.org To: gregkh@linuxfoundation.org, broonie@kernel.org, alsa-devel@alsa-project.org Cc: sdharia@codeaurora.org, bp@suse.de, poeschel@lemonage.de, treding@nvidia.com, andreas.noever@gmail.com, alan@linux.intel.com, mathieu.poirier@linaro.org, daniel@ffwll.ch, jkosina@suse.cz, sharon.dvir1@mail.huji.ac.il, joe@perches.com, davem@davemloft.net, james.hogan@imgtec.com, michael.opdenacker@free-electrons.com, robh+dt@kernel.org, pawel.moll@arm.com, mark.rutland@arm.com, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-arm-msm@vger.kernel.org, vinod.koul@intel.com, arnd@arndb.de, srinivas.kandagatla@linaro.org Subject: [PATCH v8 02/13] dt-bindings: Add SLIMbus bindings Date: Thu, 30 Nov 2017 17:41:49 +0000 Message-Id: <20171130174200.6684-3-srinivas.kandagatla@linaro.org> X-Mailer: git-send-email 2.15.0 In-Reply-To: <20171130174200.6684-1-srinivas.kandagatla@linaro.org> References: <20171130174200.6684-1-srinivas.kandagatla@linaro.org> Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@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 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>; + }; + };