From nobody Fri Oct 3 07:39:31 2025 Received: from mail-wm1-f47.google.com (mail-wm1-f47.google.com [209.85.128.47]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id E7B8E29C35A; Wed, 3 Sep 2025 16:01:56 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.47 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756915318; cv=none; b=HVItg2QVy/O92uVYs6YT/Rwd0BHqpL6RBvCCCGskT6gw7g0qScaayEVOG/sf5+L1lU7YzUnhzR4aE9U7DIKMCYxgtqjVt/BXQe8egR91FpMSBRVNv712DXFzbSAVHgH9qnRfLx61Fo4UyK4EIgzVzk79+CTXGcF4FWJegor6i9o= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756915318; c=relaxed/simple; bh=Z0Hjancctt0ilndRr3zD7NOgxn+UNXU+BwjkWHrEcpM=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=qAXc/9Ki3lQmuKl4TXJElYwLqB0WKUOPE8dopM5teiFiAVnmbVbDSTCFkTVQRhXAO8orJbxU/oj4q3HZCG0VsQ3BlCzTGhBbg55Gdf7vW5nByw7GQCN2CXdzq9mjotgoVKgQ5/xbY0ZkJRvyQsw9Cs8hEz5l697hUSi62GGHuRs= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=Eqr1k+Zn; arc=none smtp.client-ip=209.85.128.47 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="Eqr1k+Zn" Received: by mail-wm1-f47.google.com with SMTP id 5b1f17b1804b1-45b86157e18so813785e9.0; Wed, 03 Sep 2025 09:01:56 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1756915315; x=1757520115; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=HNeAhhuUFQT3U8NdFXCzWZ3aUxmWc6RHuaI08sj+6zc=; b=Eqr1k+Zn/3vbDC0ZcG8su9q6M0O5ysxxaQm9cB8YiO9z8pMZvH83JPNszK8KFLaKWb 31Ml/6X8foHYPcXPngjNhwz0CbIw5SM4Z7SUfaEQZhiJPHpfY3uVWcXeggU5R5pmSEWz p5ce3kitVNx4UJfN+KOJzqBLWMpMaMqwRsNt7hPraPEthy33M8qEYFjvp8j8Z+12Nmbc gww5x5ZHMl7ZixixaTEci0KZOL9iczc8aX+3AvL7YXMKJqk//Oi5LYnpe8lL7d3+ms49 ntl5AYOCVDa6kJtV0NPQ+ibHpo3k2mZRNAN1aT04LfMqyq8q85SypV3w0ecRFdakxAeJ CJ0Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1756915315; x=1757520115; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=HNeAhhuUFQT3U8NdFXCzWZ3aUxmWc6RHuaI08sj+6zc=; b=jb7vMLy/kItZ4Ux+xYI6BgneZuFthNqNkpyaQqfd9d0YKBdxruX57MfPFeuc0OUidz rbfvW9Xp/jEsfgadpq/ZyVX2P9894lbRNAcbthtri3w7DYR3kWDefSuA20/uR/Np3Mmd ean6O+XKnmai5+D/dZbx7OjTlzQB0N7C2e+HqwwvXOGNWMmIxOQOOIEyjTMQMv/LJr5I H21g4yzBGMfm6BWB4YwmYfzz87Y2GEakERmFfvyev8cVgTgm0VDwtykyjMTsMeoGfhiV Flkli9v4JgXmZ58xhSQGGMNj+PM3UM5eH9lEx4aSVNzLL13uxRFvNy0yftYO63gh9ADu Jxug== X-Forwarded-Encrypted: i=1; AJvYcCUWL0kiCuYqBSKtC5G42CygPQrzTFGrrcJVyKB8i3WagS/qCcjfU57WwVyrVAP8y2+yB7ELK1rhtgRp@vger.kernel.org, AJvYcCWVtybLiOSZ+adTNjhyr6Ce3UHAKged28NEwsanKbKcrfM8M57s/KP7Yb3zYPwgMsnKPcGb+ITizwV7ii78@vger.kernel.org X-Gm-Message-State: AOJu0YxY6Oqo/AxLpI4gYz/sB2Z9BScEgDst8wkQYbO+ah3DMbHHAXkd ciMM4y3lEMk/CXEaj+rWxQ6tTfIL2CkW63ZcNWzoEdqdMgzqCa1L1ArPc+fK3W8= X-Gm-Gg: ASbGncsTcYulHmx6wr7hheePH36CecSxcWttRJuCcz+pMVr7bnCFHqsKM4tKJ3hogxn r7k5M1hRkuJ85GgixV6tKMIjgPcSvWZ7TU7pqNUBsvBwFjsH67YiWom2YZjdw7aEVhgZnKlpJnw QaLaiqL4o2FQzqy2W5axcM+/+BmOn6+W2jQ4sj1VAlWBOt5N2dTTkqN97vXcBrW8HykTmcm8FQK zEjUAvIZZzxDCwuZkirOKZJhYiVHHlUMRGo6rHVZYz+vWDgqHIBDJvjXwEVFjN98NNnMPWnw6P7 esMcAvVottIlWLHhHpEoEe/PB8VyFpWFveVpSfIxvZqFj2Wr4dEuDzkul+Z7hKaZ6632e92H5+/ 02WCpktHBPQYeELvGi9r4h9c4Km/WMbAqF/7i+3BgOwOpvFPowxY= X-Google-Smtp-Source: AGHT+IFlFHmmdAIMOqIU1iQyGrxZkybaYxwUD5vZ1gAoOdHYMLqloZC9BUWXp4jHfGP/T3WGec9m2g== X-Received: by 2002:a05:600c:1c8b:b0:45d:98be:ee95 with SMTP id 5b1f17b1804b1-45d98beefd5mr5063495e9.3.1756915314649; Wed, 03 Sep 2025 09:01:54 -0700 (PDT) Received: from localhost.localdomain ([2a0d:e487:221f:e1b9:d63e:6ec1:3551:61a6]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-45b8f6cd502sm61672745e9.1.2025.09.03.09.01.53 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 03 Sep 2025 09:01:53 -0700 (PDT) From: Jihed Chaibi To: linux-sound@vger.kernel.org, krzk+dt@kernel.org Cc: lgirdwood@gmail.com, broonie@kernel.org, robh@kernel.org, conor+dt@kernel.org, drake@endlessm.com, katsuhiro@katsuster.net, matteomartelli3@gmail.com, zhoubinbin@loongson.cn, KCHSU0@nuvoton.com, patches@opensource.cirrus.com, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, shuah@kernel.org, jihed.chaibi.dev@gmail.com Subject: [PATCH v2 1/3] ASoC: dt-bindings: everest,es8316: Document routing strings Date: Wed, 3 Sep 2025 18:01:17 +0200 Message-Id: <20250903160119.83625-2-jihed.chaibi.dev@gmail.com> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20250903160119.83625-1-jihed.chaibi.dev@gmail.com> References: <20250903160119.83625-1-jihed.chaibi.dev@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Add a list of the es8316 pin names to the binding's description to make it self-contained and improve the user experience for board developers. Signed-off-by: Jihed Chaibi Acked-by: Rob Herring (Arm) Reviewed-by: Binbin Zhou --- Changes in v2: - Rephrased description to refer to device pins instead of the driver. --- .../bindings/sound/everest,es8316.yaml | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/Documentation/devicetree/bindings/sound/everest,es8316.yaml b/= Documentation/devicetree/bindings/sound/everest,es8316.yaml index e4b2eb5fae2..81a0215050e 100644 --- a/Documentation/devicetree/bindings/sound/everest,es8316.yaml +++ b/Documentation/devicetree/bindings/sound/everest,es8316.yaml @@ -12,6 +12,22 @@ maintainers: - Matteo Martelli - Binbin Zhou =20 +description: | + Everest ES8311, ES8316 and ES8323 audio CODECs + + Pins on the device (for linking into audio routes): + + Outputs: + * LOUT: Left Analog Output + * ROUT: Right Analog Output + * MICBIAS: Microphone Bias + + Inputs: + * MIC1P: Microphone 1 Positive Analog Input + * MIC1N: Microphone 1 Negative Analog Input + * MIC2P: Microphone 2 Positive Analog Input + * MIC2N: Microphone 2 Negative Analog Input + allOf: - $ref: dai-common.yaml# =20 --=20 2.39.5 From nobody Fri Oct 3 07:39:31 2025 Received: from mail-wm1-f52.google.com (mail-wm1-f52.google.com [209.85.128.52]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id F208E29BD81; Wed, 3 Sep 2025 16:01:59 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.52 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756915321; cv=none; b=Nh4b/SfAJrHrmPgli/HcVHuVw3rvyn6Wg/C46NvE/Yf5g1UBgKQzGMM56j+FUE6wh6eGb0k0IVADG8npYM13r6UfBPf0tcNouZgPWoKMDuXst9qWa3wwHOaRlqx16b+3RXBXpnz10vU0qfDolgNU+Tf6mTiYjEp3qWekM1XiPbY= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756915321; c=relaxed/simple; bh=xX6yIokNKj0jCV6W1TACUhDSxrhunHIa6lH+YP37gB0=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=Vs8CiOA/XcyjjlAQYTNA/P3yZ6ql3FmgbAFh5F3Wok65HOQllDy+Xj0WmwNkRRwYb7HNjfLMzR6WruS46RWqgH+SQ66TgPBOmNAT6EnOlfiUfLHj1K+SxG2QPRBruvNYur/CEUHSjIgGqcybzIK1BiEIBiXUx2uCtfiivt3v8XI= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=kwQSVgzb; arc=none smtp.client-ip=209.85.128.52 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="kwQSVgzb" Received: by mail-wm1-f52.google.com with SMTP id 5b1f17b1804b1-45b88bff3ebso789555e9.3; Wed, 03 Sep 2025 09:01:59 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1756915318; x=1757520118; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=E5h/p1yqJU4I6O/TgMMkgtfeLqBMvX7vcsjY0UcVa+E=; b=kwQSVgzbnob7WeUxob0WuaTNXUrHfo4a5lfvJajhPBnl+RWyOr861qcHc4DPwOGFCJ Q4byMok0HQkjpVyZk5Zz6Xvc6aZzyW3HybyEViT8XpjK1K96vZkUCmzxLBZd7Oz5sCLq KaCcPleqOZ7Cz+bEo1+WZcdoRDpoIHy47SKwjrVvhSXmB/Z8gtgBkJbeGW3mNPvmP+3R dvCxOIYzjt4lTFyEwiAmRn4SSQNJQwRTDYhl7bywSkKanui8IIZoIm2afbOz93ncqpmo EWfpPwCkyRE9GCNCVcvVpG5I7kurYcIFMIdtPRVpZwTAiEnv/ZhFXbGTb++xzTC8hIQo iVkw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1756915318; x=1757520118; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=E5h/p1yqJU4I6O/TgMMkgtfeLqBMvX7vcsjY0UcVa+E=; b=pETvs2Xx+0Qq3J2pZV9zmObAMbgSFVTzt/z7kDWTCxrYv02DuEGtqm/eiNcbi/shHR FtyVqfTdSixcBqGd3VsXL4YCiaPuDlqNQ05gREzggByY4VWrkQYNPseGOifAyMYst6L3 Qg1/SRmOoEqdCuMH/BxlqUDwPp7dw9ldT6ZUSYs7VBmPYvNrNrORz2DvNxTnKTO4gDUz B2u6p9DmAPNEdtKqkOeM/LkEHjIsVQphbR26kKOeUa27v0X0AA1AWNVis3e7eoVq+ov+ 6nI7W+QGXSkUfKhCHsjzoOs0asV5vdHe1+N/Dm57/QiuGPVE9L5+Whasg/owkkHVRPZO eXXA== X-Forwarded-Encrypted: i=1; AJvYcCVHMO4l9ClOCCAPtP0bJPct+7nsrjwTh2RLQRpExEXzHYMpDoSg1giK8NyuuQcYkZdg2VNsoIWWaFn7@vger.kernel.org, AJvYcCWg7lt0xzDuwowvWIOEBsmMNggal9islnVRjsz1TiwSrvxwrSbC1E/WR0E2AvVOogjn+JmCojmAVziax/6J@vger.kernel.org X-Gm-Message-State: AOJu0YwKf4rdrhAOvdRAQenhhSJ/zDyfSlICiXr9h6ScigZ2MANZwSGS /3YxEqIFXuVf01kir/+C0TMnr2XcuTEV7Jp/3JZR7i9BNf1u4DtrZovcXcX+f9c= X-Gm-Gg: ASbGncuaUsstfwGKGX/8+qSYajYt9Ybj0lZFuaT+Ckcyq/lWQc4zTPKjEeifiqOAiIc OwQs/m9vt83gUQfc2ekNkcRQDB7a1oXgWjYla074BUU2RfimVXEp9CIjYQ5ktlK7Yx8eeoHj3bt vDXAVPfp4KYNkBEC7pISOSEPTTqgeFdEOsxfv2f85L5i3t9SKveAF1r4ePUITQBg19F+w1FY0D9 Qg7Ou/orsNL8Znoj1cHujebfw/66AQE3VnHXxia9Y5tf0z9ovt65RwEuEPJN1wljK9ZAmLxG/UU jKgRWyHr114sjZwWoqPJR2PteGQzrnl+NyJR3AZZ2/Otuhn0it0y99CJmeJxiNTQlbG6Jl3agxE JpaYwnf9Fzggpgr0bf4SDIW8XSXR2zfnRU2tdITMdhVSvVWtft1qc73uMmdHKvg== X-Google-Smtp-Source: AGHT+IFhAv8L03hgVUM9qfC08OneeJdbGRylRS2DVGYIsdxaA4SNhTFR4rINKVHRTPySEA3EvoIiEQ== X-Received: by 2002:a05:600c:3556:b0:45b:8822:d6c1 with SMTP id 5b1f17b1804b1-45b88321bf8mr125837925e9.12.1756915317505; Wed, 03 Sep 2025 09:01:57 -0700 (PDT) Received: from localhost.localdomain ([2a0d:e487:221f:e1b9:d63e:6ec1:3551:61a6]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-45b8f6cd502sm61672745e9.1.2025.09.03.09.01.56 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 03 Sep 2025 09:01:56 -0700 (PDT) From: Jihed Chaibi To: linux-sound@vger.kernel.org, krzk+dt@kernel.org Cc: lgirdwood@gmail.com, broonie@kernel.org, robh@kernel.org, conor+dt@kernel.org, drake@endlessm.com, katsuhiro@katsuster.net, matteomartelli3@gmail.com, zhoubinbin@loongson.cn, KCHSU0@nuvoton.com, patches@opensource.cirrus.com, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, shuah@kernel.org, jihed.chaibi.dev@gmail.com Subject: [PATCH v2 2/3] ASoC: dt-bindings: nuvoton,nau8825: Document routing strings Date: Wed, 3 Sep 2025 18:01:18 +0200 Message-Id: <20250903160119.83625-3-jihed.chaibi.dev@gmail.com> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20250903160119.83625-1-jihed.chaibi.dev@gmail.com> References: <20250903160119.83625-1-jihed.chaibi.dev@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Add a list of the nau8825 pin names to the binding's description to make it self-contained and improve the user experience for board developers. Signed-off-by: Jihed Chaibi Acked-by: Rob Herring (Arm) --- Changes in v2: - Rephrased description to refer to device pins instead of the driver. --- .../devicetree/bindings/sound/nuvoton,nau8825.yaml | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/Documentation/devicetree/bindings/sound/nuvoton,nau8825.yaml b= /Documentation/devicetree/bindings/sound/nuvoton,nau8825.yaml index a54f194a0b4..4ebbcb4e605 100644 --- a/Documentation/devicetree/bindings/sound/nuvoton,nau8825.yaml +++ b/Documentation/devicetree/bindings/sound/nuvoton,nau8825.yaml @@ -9,6 +9,20 @@ title: NAU8825 audio CODEC maintainers: - John Hsu =20 +description: | + NAU8825 audio CODEC + + Pins on the device (for linking into audio routes): + + Outputs: + * HPOL : Headphone Left Output + * HPOR : Headphone Right Output + * MICBIAS : Microphone Bias Output + + Inputs: + * MICP : Analog Microphone Positive Input + * MICN : Analog Microphone Negative Input + allOf: - $ref: dai-common.yaml# =20 --=20 2.39.5 From nobody Fri Oct 3 07:39:31 2025 Received: from mail-wm1-f41.google.com (mail-wm1-f41.google.com [209.85.128.41]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id DB71B2BD587; Wed, 3 Sep 2025 16:02:01 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.41 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756915323; cv=none; b=T1ZA4Ywm9ZX7N/cSpqxYS6Mal7BdUBDL3H1QcsOj7MxuF+cexCabFCUL33pHZBp5oYxRdttvOhmzH0UMNGA3whGM1mYz4VtE7g4+TPjBuTkJ2Qm4KlP+kvfkuNkNE45nR68Czt3bWd3OfIm5eeS7oXXZjfj0PNTk1mCwxxT+VQ4= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756915323; c=relaxed/simple; bh=rc4WozWEWs5zGeQLqcAqbWgiF6WsVN4RwKuXwK/GUZ0=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=FHbc0g+ORhb25GSw818FM738aswnQeSxfemJUtkJnYZLezvGwG6aTFj16bIwxsdBBzZvyPvBwPz9vg4S+31tQqa2GPPQR/+0FZ2tUJN9KQ8FcvVKg0jHtQ4WAw1mL6wbCnEZfxmqHg6dL+puDYK0YXpNIjJlcR+WGxRZ31czcB0= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=XfTtxFlY; arc=none smtp.client-ip=209.85.128.41 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="XfTtxFlY" Received: by mail-wm1-f41.google.com with SMTP id 5b1f17b1804b1-45b7c56a987so643675e9.1; Wed, 03 Sep 2025 09:02:01 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1756915320; x=1757520120; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=nIGKgUk4e2F1KaTf/F3NT2AbgpWxayl94aH/LiAOa8A=; b=XfTtxFlYIOuk3CCYSXobgwyo5lGurW18xhoBmkJMv88gK2LydHyzjc7pGwU8w7e/Fl 3G/Hl/XvlyZ+Yh2wt5vxBaJ3DhgYYHrTBAP+WAEbx4OKakmjjR9rlBYsVIB1Hwe5sl0X FOeycFwIc9gK66fNaoXv3N911+thy60Mqyez0wZBfdww5MCLuJCw4r1k8K/NVRe/v9F2 I/U+WnD9KeXfWEslBjvXJjV8gVcIFhIobMkhToeExhXE446H/hQIC7GMgFRL274suDe5 rffosLQLO8lkjd2WXVv9+MdUi5Jmp3kEiEygwS4bO9dju7U3Zf4RGtOgVLfx9f9LNrKP wIFw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1756915320; x=1757520120; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=nIGKgUk4e2F1KaTf/F3NT2AbgpWxayl94aH/LiAOa8A=; b=Vzti/udLyOR6p71n+ksop/7oDKc164baGT7AR1BnS1WlA8ZODC+VDYrTwoWfqmeBLL z2zvq8RBoq7/NuiQ497y2WdxzJF1KRO4JA33U4ipWRj7HnHBYAt7oyQpsdQsrh4F8MDX TRK27th1nHG9qmfqRnclCXznTwompvROp+ho0sO/0WWbzCztveK3o1j9q//YpHYtLca3 /tJKB3bomhj21xfIJho2YueUvZXH1tDN/TQ/Zwf0P2adSRGqmPnE26YC23DmGHCMz6Hm RqS00n4GmxLNZCjwBQ2hP+vBhb1Z4VMKnSGvOQpkhxh9bAenIzWZ2+j59jN5xnFVgkFq MP4w== X-Forwarded-Encrypted: i=1; AJvYcCVQa2OOHgtgRyjWg2wRO4yHqzPk/soWsr9FZEvQHnk2Uvqm9Bw3JFME7rsIrAva6fwAHRd1wjkHoCDN5MJc@vger.kernel.org, AJvYcCWR8Kn7VoPZ1KOvCL/E3XgLtTaVV7viBtSj8oa8m9j3hox1MBq5raxds15FkknoYt0mXYn93nZpqapf@vger.kernel.org X-Gm-Message-State: AOJu0YxfXBUlkWnYHlkQqlXkl8LGcFppCwtTdhwqZk/0tvZEZH5/SqJ1 d7+jRRxoE9+wfMFGwV3vEz7URds9SKrIkFYdhX6SHzvsoAEzR+a6OzltiVoD+S4= X-Gm-Gg: ASbGncugLCqTqlaKnDpKNG5pMvY1bpYRZmYO3w36thhISgyLvwL+N4RCFY5wPxXFLon Hi26SAjKO7EQpND+cH1aGjTcx/89ADEN6zm48fFfdmW1QIgMJveMVxMdkEKHuUhmXCQBabswcoZ 5VQM8OuhPqjWa5IbJAQuNvMtb4yI9ocr7iK/qtRVo6pIFLq9tQF6+vJPkrITvGaHx/hiFoAEWXN 3b0HUA3Q7dgVLLMBRlJvUxucSVsjU3PWN1lerGeGkYTCfwd938HxjrWvPxR7qGCuv0BaUkDa51F 6OQJ6aEFg+sur0aki4lMbJWOLKuX0yXzfIYmFCrhj13dUCCJAzTdhiffGN2enlAOwfPZkh7oK3L N6Z4PfY2dWoXhOdIPPO4LeZPZKwB94Q/QYix6ybjHGJMaIr/Ff38= X-Google-Smtp-Source: AGHT+IFSjDcvZ+L3P5EpI/RXSWIocigVjWsTX8B7yeXd9VBhQi+ythrgbmSVHPzzQ3do+qPl+HkOYA== X-Received: by 2002:a05:600c:1914:b0:45b:88d6:8dbe with SMTP id 5b1f17b1804b1-45b88d6939amr120541745e9.7.1756915319710; Wed, 03 Sep 2025 09:01:59 -0700 (PDT) Received: from localhost.localdomain ([2a0d:e487:221f:e1b9:d63e:6ec1:3551:61a6]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-45b8f6cd502sm61672745e9.1.2025.09.03.09.01.58 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 03 Sep 2025 09:01:59 -0700 (PDT) From: Jihed Chaibi To: linux-sound@vger.kernel.org, krzk+dt@kernel.org Cc: lgirdwood@gmail.com, broonie@kernel.org, robh@kernel.org, conor+dt@kernel.org, drake@endlessm.com, katsuhiro@katsuster.net, matteomartelli3@gmail.com, zhoubinbin@loongson.cn, KCHSU0@nuvoton.com, patches@opensource.cirrus.com, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, shuah@kernel.org, jihed.chaibi.dev@gmail.com Subject: [PATCH v2 3/3] ASoC: dt-bindings: wlf,wm8960: Document routing strings (pin names) Date: Wed, 3 Sep 2025 18:01:19 +0200 Message-Id: <20250903160119.83625-4-jihed.chaibi.dev@gmail.com> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20250903160119.83625-1-jihed.chaibi.dev@gmail.com> References: <20250903160119.83625-1-jihed.chaibi.dev@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Add a list of the wm8960 pin names to the binding's description to make it self-contained and improve the user experience for board developers. Signed-off-by: Jihed Chaibi Acked-by: Rob Herring (Arm) Reviewed-by: Charles Keepax --- Changes in v2: - No changes, this file is already refering to device pins. --- .../devicetree/bindings/sound/wlf,wm8960.yaml | 22 +++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/Documentation/devicetree/bindings/sound/wlf,wm8960.yaml b/Docu= mentation/devicetree/bindings/sound/wlf,wm8960.yaml index 3c2b9790ffc..c8c786cb6c4 100644 --- a/Documentation/devicetree/bindings/sound/wlf,wm8960.yaml +++ b/Documentation/devicetree/bindings/sound/wlf,wm8960.yaml @@ -9,6 +9,28 @@ title: Wolfson WM8960 audio codec maintainers: - patches@opensource.cirrus.com =20 +description: | + Wolfson WM8960 audio codec + + Pins on the device (for linking into audio routes): + + Outputs: + * HP_L : Left Headphone/Line Output + * HP_R : Right Headphone/Line Output + * SPK_LP : Left Speaker Output (Positive) + * SPK_LN : Left Speaker Output (Negative) + * SPK_RP : Right Speaker Output (Positive) + * SPK_RN : Right Speaker Output (Negative) + * OUT3 : Mono, Left, Right or buffered midrail output for capless= mode + + Inputs: + * LINPUT1 : Left single-ended or negative differential microphone in= put + * RINPUT1 : Right single-ended or negative differential microphone i= nput + * LINPUT2 : Left line input or positive differential microphone input + * RINPUT2 : Right line input or positive differential microphone inp= ut + * LINPUT3 : Left line input, positive differential microphone, or Ja= ck Detect 2 + * RINPUT3 : Right line input, positive differential microphone, or J= ack Detect 3 + properties: compatible: const: wlf,wm8960 --=20 2.39.5