From patchwork Thu Dec 7 10:28:05 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Neil Armstrong X-Patchwork-Id: 175076 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:bcd1:0:b0:403:3b70:6f57 with SMTP id r17csp4681183vqy; Thu, 7 Dec 2023 02:28:42 -0800 (PST) X-Google-Smtp-Source: AGHT+IHxXyIx64pI1SHPXnjC4dDBiE13zxch9TO57YgwnAKPDDTvGqykoYwqUBSER0L37pZQajT0 X-Received: by 2002:a17:902:ce92:b0:1d0:7ed3:ea7c with SMTP id f18-20020a170902ce9200b001d07ed3ea7cmr2704014plg.29.1701944921906; Thu, 07 Dec 2023 02:28:41 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1701944921; cv=none; d=google.com; s=arc-20160816; b=iNYfM8Bt0A3HTltXmJSwc6kmPwwJANGq9wxycCqNEDCoDtGwWibsCM9kYbK/1IylDh vRVuc0llycJUI1Qp3gXO0r7I4VVH8A/yNuDpPDHEoPue8EvdX7sSPT5dxlusc8SuTI0g my3hGiduZjm465Zzdg+6Etr8P/Ti02sMnt3l+iLI54OnSHmD99zbWNgrldNKvQWPK+U6 29kCdg5x548AB/dnSR2aSST2COmNiR2POBeKjwHMfd5yfhG/Ayd2V9c/1ZYZc3bZQNAg SdSNW9ZrvqNqpGvrMoSxGrDKVzMq2GiLRr2+45/Db5vmd+lgOiM/I8KUwuHpVuOPphhH jQuA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:cc:to:in-reply-to:references:message-id :content-transfer-encoding:mime-version:subject:date:from :dkim-signature; bh=LVtT1o+t0tKDmILk8gvdRnnlvPZrdnTYAkN5DRsTOpI=; fh=QU4mmvlkzYG49rouzi4GXNXoR4UJnsNlmGHdqoe8mzY=; b=n2UZQTJXfu6qnfXAqawPKrq2hBXG44id6cLU1L51xJj52in8vmEpFNM8lDGm8z92PB sgHcgAfIERwmaiZZZL6e0XaDCPF9ChEM4kB4F8lu8uMjN6vjuyjzc0AVBNItDv1GDPT/ bJdKLxNr0qe0GOn8dnVx8pyw4UgtZPG0bhOSTFiadHgJqn1i52sZWGSQojvbdmnb2CmL oKJqbCjf57FPSakSty1kgcjBSxu5lI3VN7jrDwDpO/VI9kavO5yz5ykuHTo1wM915CRt Uk+wnDokEiMXFoeEAtybnpNhEsOKCNqMSKf18YL7+ogrt3C2FxKEHdagfMg1G0cvvGXV NkPg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b="NmsziF/p"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.35 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: from groat.vger.email (groat.vger.email. [23.128.96.35]) by mx.google.com with ESMTPS id z5-20020a170902834500b001d0afa2f5ddsi868153pln.621.2023.12.07.02.28.41 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 07 Dec 2023 02:28:41 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.35 as permitted sender) client-ip=23.128.96.35; Authentication-Results: mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b="NmsziF/p"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.35 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by groat.vger.email (Postfix) with ESMTP id B55CF80A416C; Thu, 7 Dec 2023 02:28:32 -0800 (PST) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.11 at groat.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232011AbjLGK2Q (ORCPT + 99 others); Thu, 7 Dec 2023 05:28:16 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:37556 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231876AbjLGK2L (ORCPT ); Thu, 7 Dec 2023 05:28:11 -0500 Received: from mail-wr1-x42d.google.com (mail-wr1-x42d.google.com [IPv6:2a00:1450:4864:20::42d]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 68FB9D53 for ; Thu, 7 Dec 2023 02:28:16 -0800 (PST) Received: by mail-wr1-x42d.google.com with SMTP id ffacd0b85a97d-33349b3f99aso749618f8f.0 for ; Thu, 07 Dec 2023 02:28:16 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; t=1701944895; x=1702549695; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:from:to:cc:subject:date:message-id :reply-to; bh=LVtT1o+t0tKDmILk8gvdRnnlvPZrdnTYAkN5DRsTOpI=; b=NmsziF/pkb3hohTGkDd8nkEDeCcG+pDZnVgX9LyM300yfWROu6Pf+6NV/ize0lqdNX Gvgd/su7G5Buivb6SqahgxYEYp87Ui+JDBEXpSFVLNN2lFeXQGbMV/phLBjwmUMNMEAx sqHBx17nB9JT6UNggv6D46X0aw9sYjniGov6/BadEjSSHhAF0aUUtFXG0Psx+/SUmL0x L5SyWJdVmYh1OatS+MqWouDtAZumihgYEAelT+Hozu2chjc+Y5DgJnfWrYc67MnS/pET f3J2dznFK5D4yx5OgXICN/mz3B/6bu/zWHJtwbE+hhA44PNNAny5vQOFNV1OeHQF7Ar5 Cm6A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1701944895; x=1702549695; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=LVtT1o+t0tKDmILk8gvdRnnlvPZrdnTYAkN5DRsTOpI=; b=mfKZqq089X6P5ds3uM76+TcnhNfcsQd/pUADpS01wAOo0uXmxEfVvhT+RcyitMRA7x AUa6TShnrmogWsxGi6BiR5QqLxkfOXZIKlsmTy3k0M3k4amGr0fTdnUvqz++O+ITg5Iy ysGimS0+rJseOwWm89+OTCLAJtozqUhnu4rWiBgJ1CQXnYlK7nG9t9gRoQCdYRr+gZGy TcSvr5+CrFqZ5gNXKlqA7122KcL+aB6vsRwKWj5hJaGI3v/XdUJqjsU6j4KO7RdPh0Jr UwleaUblG4g432qx6IpsGKBpmlAPSVzH9CgiBXE2reMoN7syD2nwZQQb6WtCS29a5hLO prGg== X-Gm-Message-State: AOJu0YwNTwTb5y7/x/ctu3ocvY1+6tqsd7NCpLw88ilsXu0UoIiDLfFk VD1chFbzqVQrq+GZLTYWvoYEdA== X-Received: by 2002:a05:600c:2147:b0:405:1c19:b747 with SMTP id v7-20020a05600c214700b004051c19b747mr1393535wml.15.1701944894844; Thu, 07 Dec 2023 02:28:14 -0800 (PST) Received: from arrakeen.starnux.net ([2a01:e0a:982:cbb0:52eb:f6ff:feb3:451a]) by smtp.gmail.com with ESMTPSA id d2-20020adfe2c2000000b003333d2c6420sm1073412wrj.74.2023.12.07.02.28.13 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 07 Dec 2023 02:28:14 -0800 (PST) From: Neil Armstrong Date: Thu, 07 Dec 2023 11:28:05 +0100 Subject: [PATCH v3 2/5] ASoC: dt-bindings: document WCD939x Audio Codec MIME-Version: 1.0 Message-Id: <20231207-topic-sm8650-upstream-wcd939x-codec-v3-2-6df9585ec7c8@linaro.org> References: <20231207-topic-sm8650-upstream-wcd939x-codec-v3-0-6df9585ec7c8@linaro.org> In-Reply-To: <20231207-topic-sm8650-upstream-wcd939x-codec-v3-0-6df9585ec7c8@linaro.org> To: Srinivas Kandagatla , Banajit Goswami , Andy Gross , Bjorn Andersson , Konrad Dybcio , Liam Girdwood , Mark Brown , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Jaroslav Kysela , Takashi Iwai Cc: linux-arm-msm@vger.kernel.org, alsa-devel@alsa-project.org, linux-sound@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, Neil Armstrong , Krzysztof Kozlowski X-Mailer: b4 0.12.3 X-Developer-Signature: v=1; a=openpgp-sha256; l=6511; i=neil.armstrong@linaro.org; h=from:subject:message-id; bh=0LLfLDAQFtlrB7IqgMI8aCNjNHjAX0Bhqf4tIIU1h7I=; b=owEBbQKS/ZANAwAKAXfc29rIyEnRAcsmYgBlcZ45FXg8rU/eEYYOTsPNXmbVdk0qxIN5V6qnMyQA ieSdHhKJAjMEAAEKAB0WIQQ9U8YmyFYF/h30LIt33NvayMhJ0QUCZXGeOQAKCRB33NvayMhJ0aInD/ 9XwnFXvXDjY73jtGGcVzmSCf5pEkjxUYQ75US7BGIZRXEoNl3x/bpl2DkFWsiuKB0glPmTw0q9Zc7p Q98jMZ03ZLAIioMNzYyrCurfnifbnza8UURB06deZPnn5BtY3kA0mr2CuOmsfUcS5RIaT6iWXNoeDz f94m8I8dy9nOwDxj5BZ0s/HBIRvHSVKY2P1EcB/I1qm8ymlAkwvyK0rYbcCoFL/5HZjWPAubbmL5He J90quzAVhWPN78Uor3ASD8Yo0oZxii4zykBgevHKjIj9qE/nwSS6IGszpLC8tT9mTA3KTMsQ1PdmUf lvnghduxNbC4SA5cTdf9YXREVMC+3tYH31ewWSSZCYobb1AYipJR6PtQo0CxFki7AMyEUZ+ldihTVk pSH6dBwguzjO7fVE/Kf96nNmlyeRAtTcsiMTlJhWZ5dgndq4grBzR7Mxg4WHhcE+dTockS9xdkF8Hu zuAZ0vNvYAHROKx659D8eki36jmlxDCt2PMPr5djKz5XS5uhwMCng7HjzA2KMt3cNXc9O40FSFdHWD 0iiN3i9DcB4WuWDMNW5orS6K76o5KgtUVbJ3NDti00n3tZde9I3pFICAtDTKXf2vyRGCAVPO2onLtG yMDE8R1/+YYPRBQ3cWZu5tXYBGyv60q7y/9v3DEmMK3pzjc2n5h6kJLM59YA== X-Developer-Key: i=neil.armstrong@linaro.org; a=openpgp; fpr=89EC3D058446217450F22848169AB7B1A4CFF8AE X-Spam-Status: No, score=-0.9 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI, SPF_HELO_NONE,SPF_PASS,T_SCC_BODY_TEXT_LINE autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on groat.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (groat.vger.email [0.0.0.0]); Thu, 07 Dec 2023 02:28:33 -0800 (PST) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1784618598636080177 X-GMAIL-MSGID: 1784618598636080177 Document the Qualcomm WCD9390/WCD9395 Audio Codec and the Soundwire devices than can be found on Qualcomm SM8650 based platforms. The Qualcomm WCD9390/WCD9395 Audio Codec communicates with the host SoC over 2 Soundwire links to provide: - 4 ADC inputs for up to 5 Analog Microphones - 4 DMIC inputs for up to 8 Digital Microphones - 4 Microphone BIAS - Stereo Headphone output - Mono EAR output - MBHC engine for Headset Detection The WCD9390/WCD9395 IC has separate I2C subsystem for USB-C DP Altmode/Audio Accessory mode Mux which is not documented here but requires port/endpoint graph and properties to handle Altmode/Audio Accessory switch and orientation. Reviewed-by: Krzysztof Kozlowski Signed-off-by: Neil Armstrong --- .../bindings/sound/qcom,wcd939x-sdw.yaml | 69 ++++++++++++++++ .../devicetree/bindings/sound/qcom,wcd939x.yaml | 96 ++++++++++++++++++++++ 2 files changed, 165 insertions(+) diff --git a/Documentation/devicetree/bindings/sound/qcom,wcd939x-sdw.yaml b/Documentation/devicetree/bindings/sound/qcom,wcd939x-sdw.yaml new file mode 100644 index 000000000000..67ed7701b5d6 --- /dev/null +++ b/Documentation/devicetree/bindings/sound/qcom,wcd939x-sdw.yaml @@ -0,0 +1,69 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/sound/qcom,wcd939x-sdw.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Qualcomm SoundWire devices on WCD9390/WCD9395 + +maintainers: + - Srinivas Kandagatla + +description: | + Qualcomm WCD9390/WCD9395 Codec is a standalone Hi-Fi audio codec IC. + It has RX and TX Soundwire devices. This bindings is for the devices. + +properties: + compatible: + const: sdw20217010e00 + + reg: + maxItems: 1 + + qcom,tx-port-mapping: + description: | + Specifies static port mapping between device and host tx ports. + In the order of the device port index. + $ref: /schemas/types.yaml#/definitions/uint32-array + minItems: 4 + maxItems: 4 + + qcom,rx-port-mapping: + description: | + Specifies static port mapping between device and host rx ports. + In the order of device port index. + $ref: /schemas/types.yaml#/definitions/uint32-array + minItems: 6 + maxItems: 6 + +required: + - compatible + - reg + +additionalProperties: false + +examples: + - | + soundwire@3210000 { + #address-cells = <2>; + #size-cells = <0>; + reg = <0x03210000 0x2000>; + wcd938x_rx: codec@0,4 { + compatible = "sdw20217010e00"; + reg = <0 4>; + qcom,rx-port-mapping = <1 2 3 4 5 6>; + }; + }; + + soundwire@3230000 { + #address-cells = <2>; + #size-cells = <0>; + reg = <0x03230000 0x2000>; + wcd938x_tx: codec@0,3 { + compatible = "sdw20217010e00"; + reg = <0 3>; + qcom,tx-port-mapping = <2 3 4 5>; + }; + }; + +... diff --git a/Documentation/devicetree/bindings/sound/qcom,wcd939x.yaml b/Documentation/devicetree/bindings/sound/qcom,wcd939x.yaml new file mode 100644 index 000000000000..6e76f6a8634f --- /dev/null +++ b/Documentation/devicetree/bindings/sound/qcom,wcd939x.yaml @@ -0,0 +1,96 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/sound/qcom,wcd939x.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Qualcomm WCD9380/WCD9385 Audio Codec + +maintainers: + - Srinivas Kandagatla + +description: | + Qualcomm WCD9390/WCD9395 Codec is a standalone Hi-Fi audio codec IC. + It has RX and TX Soundwire devices. + The WCD9390/WCD9395 IC has a functionally separate USB-C Mux subsystem + accessible over an I2C interface. + The Audio Headphone and Microphone data path between the Codec and the USB-C Mux + subsystems are external to the IC, thus requiring DT port-endpoint graph description + to handle USB-C altmode & orientation switching for Audio Accessory Mode. + +allOf: + - $ref: dai-common.yaml# + - $ref: qcom,wcd93xx-common.yaml# + +properties: + compatible: + oneOf: + - const: qcom,wcd9390-codec + - items: + - const: qcom,wcd9395-codec + - const: qcom,wcd9390-codec + + mode-switch: + description: Flag the port as possible handler of altmode switching + type: boolean + + orientation-switch: + description: Flag the port as possible handler of orientation switching + type: boolean + + port: + $ref: /schemas/graph.yaml#/properties/port + description: + A port node to link the WCD939x Codec node to USB MUX subsystems for the + purpose of handling altmode muxing and orientation switching to detect and + enable Audio Accessory Mode. + +required: + - compatible + +unevaluatedProperties: false + +examples: + - | + #include + codec { + compatible = "qcom,wcd9390-codec"; + reset-gpios = <&tlmm 32 IRQ_TYPE_NONE>; + #sound-dai-cells = <1>; + qcom,tx-device = <&wcd939x_tx>; + qcom,rx-device = <&wcd939x_rx>; + qcom,micbias1-microvolt = <1800000>; + qcom,micbias2-microvolt = <1800000>; + qcom,micbias3-microvolt = <1800000>; + qcom,micbias4-microvolt = <1800000>; + qcom,hphl-jack-type-normally-closed; + qcom,ground-jack-type-normally-closed; + qcom,mbhc-buttons-vthreshold-microvolt = <75000 150000 237000 500000 500000 500000 500000 500000>; + qcom,mbhc-headphone-vthreshold-microvolt = <50000>; + }; + + /* ... */ + + soundwire@3210000 { + #address-cells = <2>; + #size-cells = <0>; + reg = <0x03210000 0x2000>; + wcd939x_rx: codec@0,4 { + compatible = "sdw20217010e00"; + reg = <0 4>; + qcom,rx-port-mapping = <1 2 3 4 5 6>; + }; + }; + + soundwire@3230000 { + #address-cells = <2>; + #size-cells = <0>; + reg = <0x03230000 0x2000>; + wcd938x_tx: codec@0,3 { + compatible = "sdw20217010e00"; + reg = <0 3>; + qcom,tx-port-mapping = <2 3 4 5>; + }; + }; + +...