From patchwork Tue Jun 11 10:40:39 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Srinivas Kandagatla X-Patchwork-Id: 166380 Delivered-To: patch@linaro.org Received: by 2002:a92:4782:0:0:0:0:0 with SMTP id e2csp2182037ilk; Tue, 11 Jun 2019 03:41:03 -0700 (PDT) X-Google-Smtp-Source: APXvYqy39bARpXayGs8mSHwuhH6MKb9bwooAsgKdOVdZZs5OKKHUJ6swScACFvCkmLrhC/R60Wjx X-Received: by 2002:aa7:8102:: with SMTP id b2mr53339665pfi.105.1560249663034; Tue, 11 Jun 2019 03:41:03 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1560249663; cv=none; d=google.com; s=arc-20160816; b=V3amoKkAdujhua3JuPCkvv1rE2zH4PrZh/lDRRYUZeW5Ltu8S4rz8sdqkD2r7d7OK7 oKT/WbmHb14QixP2Lz0OlUEt6r4SQFJOzEKKWQv4v38VAGBChMResZdy6c4K7uXkSS3O Hjt6j/heYOM6hn7P3F7vmyBPn4tmAxnYIWZQzyhyN847F+oOpQepMDaHLidx81bdynx9 Bsiuts6lkjZ1iVMT8Aa//IudupqTy4lX3D3Cjr8g5RFGS8LrL2msCEHK178whYGUuZc+ HSJ+TcoQ+DhqibKPpDMHZvhpw5sToB6hQAmGav9pmE9WH3xYarE8XX9DYpuUYj72rO0i 9NpQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=4Gpz9OAv6XE5jXE+cWS3impQo2MFLCRNnAJiI/H46i8=; b=Hb49tg/VYGCKCzqla6aU5LoOVeyAwHBThnpTtY5goODsVdR8794zN8ofZJ9DonkSNX xIDkHkn9H2e5VYBhjhaPHnsTwGdz/4lsDhvPUewPnJ2QTY7QV0ijyYyDQKjP8n/JOvJV NA1reu609p8JttjyKmJUnFzTPnuy1MyhsfCw1CyJspzU3WG1twzWKpvfemLDJKFpf9kt CO7S2lijyUypryNmqKM1H60xiW2lEXzj/lBKinE9uDdSXrLm/e1yOX4a2XxHl5saSVGV vp4UXVsj+9F6akNg2MStBVsUWsW1XT2wnSJaOQZdTldm7LgdtbMmN0pqfu0aq4yzJiPO 8OBw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=yz9mV4N+; 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=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 a64si7216038pge.116.2019.06.11.03.41.02; Tue, 11 Jun 2019 03:41:03 -0700 (PDT) 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=pass header.i=@linaro.org header.s=google header.b=yz9mV4N+; 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=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S2387538AbfFKKlB (ORCPT + 8 others); Tue, 11 Jun 2019 06:41:01 -0400 Received: from mail-wr1-f67.google.com ([209.85.221.67]:34953 "EHLO mail-wr1-f67.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727947AbfFKKlB (ORCPT ); Tue, 11 Jun 2019 06:41:01 -0400 Received: by mail-wr1-f67.google.com with SMTP id m3so12462184wrv.2 for ; Tue, 11 Jun 2019 03:41:00 -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 :mime-version:content-transfer-encoding; bh=4Gpz9OAv6XE5jXE+cWS3impQo2MFLCRNnAJiI/H46i8=; b=yz9mV4N+vItMSb0ZebnnzAvl58O0ImcBvJpG+VgMse/+oVEetTdiTMgqrMARsDg4Ca /Pflabz2rgCT3/eYvf/xJWmONndZxu8tpveX6p7Lz8wpb4m53mr2+vyltKqHt/l5Dkr3 qDPFzKHCkgMXSXmb2L+53zNmiTYUhnJi/qI3IPPH/TmGuN2hUQZvBFW63jmx9tKBTo8P ySQkITia6tY0svstKyHYwb1Vvd+a1uVeDm2C1Naxm5VdQ1acAJe7lXFxQ/M70CiSq/u5 G5yL3SXtZ3dTXs6TQ1zFJ+axj3T4s8IkMUSoYO5wiO07q183uZ2Ma+cT/OFkUV1TEDHs jfWQ== 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:mime-version:content-transfer-encoding; bh=4Gpz9OAv6XE5jXE+cWS3impQo2MFLCRNnAJiI/H46i8=; b=a540gijp0Yks2N15qsr5qN5GAdcwz+BtWHW8UVnQdf4jc0cy8YNWOLrcVGMfr0dYsN VgCwa5Uethbbn3fyqPPw3Zm71Cwke5ubVfFsdBQJK2fL0P6h/hkQHiBS8E6zvL47+q67 kdeJwpeg4LiqkK0TBGyMZgV0DQi4tz99MEzBrX+G2aLgKXcaEjgXHlKhAxwMtKslTz9C 7jP0lr1iRDNzb1VqRa/AD8H9FWU76nVlERO9JgWfWoV3ar0nFNMNHbpv7lw65dbxrS07 seRcL/qRcdIeUW2vmkfrDqF5TRlLpf+TGG2RdZrhyQWvlc9sB8d+h/mml1StIpIzcE/q OsXg== X-Gm-Message-State: APjAAAXV3tvTxG8yuSPo6Iel5695i7E1HxTaQq6gnGvMLxlaS+TH09BJ pWIaZbKNGnqaHimw7xnSyB8IuQ== X-Received: by 2002:a5d:4f81:: with SMTP id d1mr25750987wru.156.1560249659592; Tue, 11 Jun 2019 03:40:59 -0700 (PDT) Received: from srini-hackbox.lan (cpc89974-aztw32-2-0-cust43.18-1.cable.virginm.net. [86.30.250.44]) by smtp.gmail.com with ESMTPSA id c65sm2359614wma.44.2019.06.11.03.40.58 (version=TLS1_3 cipher=AEAD-AES256-GCM-SHA384 bits=256/256); Tue, 11 Jun 2019 03:40:59 -0700 (PDT) From: Srinivas Kandagatla To: broonie@kernel.org, vkoul@kernel.org Cc: robh+dt@kernel.org, devicetree@vger.kernel.org, mark.rutland@arm.com, pierre-louis.bossart@linux.intel.com, alsa-devel@alsa-project.org, linux-kernel@vger.kernel.org, bgoswami@quicinc.com, Srinivas Kandagatla Subject: [RFC PATCH 1/5] dt-bindings: soundwire: add slave bindings Date: Tue, 11 Jun 2019 11:40:39 +0100 Message-Id: <20190611104043.22181-2-srinivas.kandagatla@linaro.org> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190611104043.22181-1-srinivas.kandagatla@linaro.org> References: <20190611104043.22181-1-srinivas.kandagatla@linaro.org> MIME-Version: 1.0 Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org This patch adds bindings for Soundwire Slave devices which includes how SoundWire enumeration address is represented in SoundWire slave device tree nodes. Signed-off-by: Srinivas Kandagatla --- .../devicetree/bindings/soundwire/bus.txt | 48 +++++++++++++++++++ 1 file changed, 48 insertions(+) create mode 100644 Documentation/devicetree/bindings/soundwire/bus.txt -- 2.21.0 diff --git a/Documentation/devicetree/bindings/soundwire/bus.txt b/Documentation/devicetree/bindings/soundwire/bus.txt new file mode 100644 index 000000000000..19a672b0d528 --- /dev/null +++ b/Documentation/devicetree/bindings/soundwire/bus.txt @@ -0,0 +1,48 @@ +SoundWire bus bindings. + +SoundWire is a 2-pin multi-drop interface with data and clock line. +It facilitates development of low cost, efficient, high performance systems. + +SoundWire controller bindings are very much specific to vendor. + +Child nodes(SLAVE devices): +Every SoundWire controller node can contain zero or more child nodes +representing slave devices on the bus. Every SoundWire slave device is +uniquely determined by the enumeration address containing 5 fields: +SoundWire Version, Instance ID, Manufacturer ID, Part ID and Class ID +for a device. Addition to below required properties, child nodes can +have device specific bindings. + +Required property for SoundWire child node if it is present: +- compatible: "sdwVER,MFD,PID,CID". The textual representation of + SoundWire Enumeration address comprising SoundWire + Version, Manufacturer ID, Part ID and Class ID, + shall be in lower-case hexadecimal with leading + zeroes suppressed. + Version number '0x10' represents SoundWire 1.0 + Version number '0x11' represents SoundWire 1.1 + ex: "sdw10,0217,2010,0" + +- sdw-instance-id: Should be ('Instance ID') from SoundWire + Enumeration Address. Instance ID is for the cases + where multiple Devices of the same type or Class + are attached to the bus. + +SoundWire example for Qualcomm's SoundWire controller: + +soundwire@c2d0000 { + compatible = "qcom,soundwire-v1.5.0" + reg = <0x0c2d0000 0x2000>; + + spkr_left:wsa8810-left{ + compatible = "sdw10,0217,2010,0"; + sdw-instance-id = <1>; + ... + }; + + spkr_right:wsa8810-right{ + compatible = "sdw10,0217,2010,0"; + sdw-instance-id = <2>; + ... + }; +};