From nobody Sun Oct 5 03:35:17 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 9A4E721FF2E; Sat, 9 Aug 2025 15:20:00 +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=1754752802; cv=none; b=iZ7mVlx4GIvU5nBjTsNe5mGrySGDO71Sdjp4Zg4hR5aef29B+fUcwSele74eRNI+iD7mD91FvC7Gdhan3CKn29t77KVsxJ4Kl5XfzkVxIEczAFoQzNxoh52tmYLy1W/eZrVzRAcPD7yj9BFgkeveZxLBUyaKkgkreyG0c8AeF48= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1754752802; c=relaxed/simple; bh=7o5pU4p99I6XEBPujE/xuqW5AFXdaGPuJPmbaPxwm/U=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=gC51vLnH5MG8DbMDoS4gKaNOoTn3wsTZe3kYpT2L2X3D/nQameRtHaIIPVTKmIj/Am/njyQO4pYQGfuJGH2/xp7jZjFJB03Gny1Z3pboSIK6bsT6tcx3FlSgMqCDe5kjqtXfIbi6CaHtyHRULUVYIhp+6Fb1WbJFlbOOMWd36OM= 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=FUN1V1F9; 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="FUN1V1F9" Received: by mail-wm1-f47.google.com with SMTP id 5b1f17b1804b1-458baf449cbso29529725e9.0; Sat, 09 Aug 2025 08:20:00 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1754752798; x=1755357598; 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=aOg4R1KuhdWp/38jFFNcKECI315gEQ8uWnT+lp4Ht0c=; b=FUN1V1F9tuTgwHqAEEhffKcoOUqBEHkR1M2f5OJ+/HQraOiVunM/QiDe1nOX0nnSiZ bT0ikfS40A5M2k4K32LjF9pe/22JnxnKoMvDLowcNbT4PpOgY0L7/GzHe24xsIHXUucf HJQ3pKx+zxOMUTkrW7wjVFBhW/vTU8sVY26lahNGjEjNQudEFqqBIbTgczksjw7sM/PE xvIbyYRKTwDKewy/D80YjqYmkvvK86xlHg+c8ztSQJQRvgl0E1PkfAKjVhg1cakv9aEO TqlsSEnXdGP49k5i66AQItarvSlTyakaHsuAIUYDghsPJ4Uw+y65ekov6/kkzP7te1nX xXSg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1754752798; x=1755357598; 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=aOg4R1KuhdWp/38jFFNcKECI315gEQ8uWnT+lp4Ht0c=; b=SQIsYNM7O0RiNNC5d8YrTSU5xzXt1P8diXw90CR+1UnIEd8ZlXhHuRaH0m3PwM5W9s GXYsp13vYBeU9/81rKpR+D3RaUeCoXSFNyJrriEkVumnPhfA7wNvmkfLo4iMe9l+KDUi scO5FrRzDQbCY+IOPKD5B3RVbeQVIwE51ZsVhyot9HbtVOGxr8XWDuQxugfH81otbe6v tCaC1k1g2VloNDrIcFWHzu5ZyL0oURoMnjdRlRvkNJbUXkVdf4ZpWbEaCWqd7iYxCyCq ipJlRgNlD+SM0fSR9uUrHOP7bKeuo3hUUFLfcwprpkUEE20uWlnuYToaVT8SISdZi+TG slJg== X-Forwarded-Encrypted: i=1; AJvYcCVXB3SkzMMrSVOU7Xnz5GvIXehxIMMRPnU2Fjpp+62RkUZcZ5GRXLe8/R8f8hjwji7cWY+P+bkfRGv9ToFB@vger.kernel.org, AJvYcCWFEBe09Kol3sh0LyKa0ROG14bmjVDrGsM4qGhO+z9B66gpS6pvlqu9T1+V8y1eY1PTZkC1dAq2fFKb@vger.kernel.org X-Gm-Message-State: AOJu0Yy7WbMFfFzD+P4pcrNyTBm12747GaqKJdLlRV9CcUOsh1FGN6wn pmwUhr+QNJ1PKKDVXsI4ws6auXwuSlmOcrYy+OThsHW2TPeMfvP5+3rDJ7mivuR+hQ== X-Gm-Gg: ASbGnctAuNQgo1qjFtK6PYNs3ePcMXwn5OBfOnnZX9Z6+IeoQj8AuKNKfwC4HY5Gxeb Xjh/Ob2MMmEiE+th9tomVdvZMG0vJslhTnXQCUHzZBQIHVKID/0txx6Jczhwwv4TYMIGyR5bGaI rtLs9SjqWpxz6e0OJSNOWJyEssOMD2wUFJG0hFvGbGcvMNNCnHAlC9iDVtK+P0swqyUTEj92+7l UHeCzow1x1tL7DwITpX4whUu4fT8ZMcEY+0txRI6flfCQn0esTW3Gh28d41H3gLwskQneQAuRD7 wt1LaYWraBiUJYEPp38hY8UslKsQnMDHZkzmPoLTlES3h2UkpQK0215+7h/QXQ7yrHY7MgfoITl 37lQ+XJGnrqPzJVqBOPiZOjsTiiJS7SF5Bx5GnyhjLlkbLqQ= X-Google-Smtp-Source: AGHT+IES1jq2fM3tWveTYs/QIRtGgCWAkhN+VqAfVsu2aXmV4iWoNr2OTsJp+aEKViqy9CHWvPgJyg== X-Received: by 2002:a05:600c:1c0e:b0:43c:ec0a:ddfd with SMTP id 5b1f17b1804b1-459f4f3cf52mr55505305e9.6.1754752798364; Sat, 09 Aug 2025 08:19:58 -0700 (PDT) Received: from localhost.localdomain ([2a0d:e487:156f:b6b0:b8c7:9296:47d7:b0cc]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-459e583ff76sm178748185e9.5.2025.08.09.08.19.57 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 09 Aug 2025 08:19:57 -0700 (PDT) From: Jihed Chaibi To: linux-sound@vger.kernel.org Cc: lgirdwood@gmail.com, broonie@kernel.org, robh@kernel.org, krzk+dt@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 1/3] ASoC: dt-bindings: everest,es8316: Document routing strings Date: Sat, 9 Aug 2025 17:18:51 +0200 Message-Id: <20250809151853.47562-2-jihed.chaibi.dev@gmail.com> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20250809151853.47562-1-jihed.chaibi.dev@gmail.com> References: <20250809151853.47562-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" The es8316 driver defines several DAPM widget names that are used for audio routing in the device tree. However, these strings are not documented in the binding file. This forces developers to read the C source to discover the valid names, which can be inefficient and error-prone. Add a list of the input and output widget names to the binding's description to make it self-contained and improve the user experience for board bring-up. Signed-off-by: Jihed Chaibi --- .../devicetree/bindings/sound/everest,es8316.yaml | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/Documentation/devicetree/bindings/sound/everest,es8316.yaml b/= Documentation/devicetree/bindings/sound/everest,es8316.yaml index e4b2eb5fa..cd073dd0c 100644 --- a/Documentation/devicetree/bindings/sound/everest,es8316.yaml +++ b/Documentation/devicetree/bindings/sound/everest,es8316.yaml @@ -12,6 +12,20 @@ maintainers: - Matteo Martelli - Binbin Zhou =20 +description: | + Everest ES8311, ES8316 and ES8323 audio CODECs + + Valid routing names defined in the driver for this codec include: + + Outputs: + * HPOL: Left Headphone Output + * HPOR: Right Headphone Output + + Inputs: + * DMIC: Digital Microphone Input + * MIC1: Analog Microphone Input 1 + * MIC2: Analog Microphone Input 2 + allOf: - $ref: dai-common.yaml# =20 --=20 2.39.5 From nobody Sun Oct 5 03:35:17 2025 Received: from mail-wm1-f46.google.com (mail-wm1-f46.google.com [209.85.128.46]) (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 271862BE7BC; Sat, 9 Aug 2025 15:20:02 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.46 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1754752804; cv=none; b=qjR1PurWJ1h7Tze5W3PASGGexZCUvbee+8M5rkzkjTkDBwicCEr/qPFUl9ASnJciMOhUh7SxR+WzRsQrCcWK1q9d3ZT6lJamknrZWuYDqnSgCwUPY7nYp5A8g3tvGbSY/Xi6JGO72qnoIP3pm6gWXe/9i7AoibBTZiLeygMYbrY= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1754752804; c=relaxed/simple; bh=E1WeUDSwyIl9iI7BwPhOBt9jFVluY6T5CNY+ZnovgEA=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=DDwaxtRFmtkbEF81pRZ9gZ75lEwxi1LOadJBFbi9VnwGKimuA7AAl/gSiPxSjID6BJEDutTXM0KVjq3N3IaRNydoNZYSOG2baVpRbQW//GS9qffN31GgUnyuRmrrme8XujwFQ4y3jUrWBL97R+EhoFEkHptOYi7l4NgI0meHKGw= 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=e40j5O2M; arc=none smtp.client-ip=209.85.128.46 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="e40j5O2M" Received: by mail-wm1-f46.google.com with SMTP id 5b1f17b1804b1-459ebb6bbdfso19614695e9.0; Sat, 09 Aug 2025 08:20:02 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1754752801; x=1755357601; 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=GKft3vN/bPiCSDmYFyRvZdVd+7m3lzvyNOgqIIC9a7s=; b=e40j5O2M0Z8XnrhVaJ7KClRUD7SR5CCaxui0YpW3xhdJ4HYfgt8bWX9/7WglLByZ+a DwaI2nCyGOx+DunHkyWk00Sbvz5pbqq2EHyw6AzXPjk3zlyV/2Fa7ZV4DMo5XBJGjHQq PpKdhNzoO76RhWnQzAenYtt71IhH2K451y0tQMnlgHdt4SCnfV6RC5vOg+iUrhxNdGxv yOpOcaSyRqAX2xBpc3+foZwkxwaFGlLM/Cskk49Doq/m+d+54U9MMlOoEaul3BfXQ0fa 3KD3MJnwRJ0zz/1tv7/9fcRtTy0Ee6YSQbBmsbJisZSWhtT5PT/uodaKQmavw2Fhr4dh vHwQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1754752801; x=1755357601; 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=GKft3vN/bPiCSDmYFyRvZdVd+7m3lzvyNOgqIIC9a7s=; b=mJ301ijTZSm4Qo0ReDk2f8XWvxfYICi9MoANNwBkcJbN2XitrOELCO2JXf6B8/lXed X8dnPUGgVEpdFsId0UFwceEv61AvXqOrU3zVxGXE0baUnn0vTYytIATPJuM5IgVpe4PW tLsAq9r4811RwsN4nfk12j4kJUkt6QkuWuYQNcTugRc1heknQ7I9od11+lMXARWZB8Jr KOjJrdgssc+9vtLZMn2kK71CupcUnrXppVjr5GHLnLAVcVYf66cgSfvtMf207M6fHyPB /7FZzAkFS/TZwJv0OFDQgbJev+4u67irbqrGwpxuGCQHbT+AQ5qh1UjSDd+HhAtym4sm JGNA== X-Forwarded-Encrypted: i=1; AJvYcCVR+P+fGTqDdOPcsDzo2m/UHX9Z9Lhm1F+v/bCUNkp/ryr/g3qgfBe9mmr11Cb2OpqGsi3JX4o9E60v@vger.kernel.org, AJvYcCX1eb4LQG2QCpPJ9C9aUBYuy28ioQUYsC0+P2pLphmasfV/Z3V7y1WRpL6THT2ZslT+konfd889NDHPJgbV@vger.kernel.org X-Gm-Message-State: AOJu0YxV2jOTW8TgD3RIYLVBwVTPbj/wghg6dbr9M2FI6wOkJ637gUki qps2CAbEGSgnmRzcUnEJ55ZqEujHmpWyVsoYJHxs3iQEPwJj9NdjthMOy3ZNV2o= X-Gm-Gg: ASbGnctCIkZXKE2k6K0JSKnicSVgXZYPtkiPzy2tNjC3Z+SPDKy9WGgnhihNe8Y1/Hb lKblW55sx4Fym01HLiZApGDawH6sEzyu4Ffbh5L/En30XtGbphd7GT/zcGN6crHNvwPonZJcQUQ BmxFaMGChXIJki8qME49yjmu1/hI7QRz9U60/tvX6/ZL1FcYt7aKHHlbsMYe8jZPag9nCfFCI/x hZfm1BEuAV/JVPlCv/8IrxFP0p7LcYJZO+FnDQzvUzvJV+oRKalWzWgjmjADVB/B1jPpRQBoHwJ hW056eLGwpHxqF1hikXI26bDweWf1zbtSNCEVNcLgXaaNnwBK++BknM5/x6E5IGbSEqq2uFDOsA sAj52XDWRWz8inmFY/dpejjjL/andcAudeuej8LPpLIqSxrk= X-Google-Smtp-Source: AGHT+IH1rGpI0BB4/akEwTukJA+QWyZ5KPP8BOoF9oC41Ha9wM14LjCiYpVbdqnRpjMdC04qZfRP/Q== X-Received: by 2002:a05:600c:444d:b0:43c:fe5e:f040 with SMTP id 5b1f17b1804b1-459f4faf68cmr54366885e9.23.1754752801040; Sat, 09 Aug 2025 08:20:01 -0700 (PDT) Received: from localhost.localdomain ([2a0d:e487:156f:b6b0:b8c7:9296:47d7:b0cc]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-459e583ff76sm178748185e9.5.2025.08.09.08.19.59 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 09 Aug 2025 08:20:00 -0700 (PDT) From: Jihed Chaibi To: linux-sound@vger.kernel.org Cc: lgirdwood@gmail.com, broonie@kernel.org, robh@kernel.org, krzk+dt@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 2/3] ASoC: dt-bindings: nau8825: Document routing strings Date: Sat, 9 Aug 2025 17:18:52 +0200 Message-Id: <20250809151853.47562-3-jihed.chaibi.dev@gmail.com> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20250809151853.47562-1-jihed.chaibi.dev@gmail.com> References: <20250809151853.47562-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" The nau8825 driver defines several DAPM widget names that are used for audio routing in the Device Tree. However, these strings are not documented in the binding file. This forces developers to read the C source to discover the valid names, which can be inefficient and error-prone. Add a list of the input and output widget names to the binding's description to make it self-contained and improve the user experience for board bring-up. Signed-off-by: Jihed Chaibi --- .../devicetree/bindings/sound/nuvoton,nau8825.yaml | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/Documentation/devicetree/bindings/sound/nuvoton,nau8825.yaml b= /Documentation/devicetree/bindings/sound/nuvoton,nau8825.yaml index a54f194a0..cb1c82aa3 100644 --- a/Documentation/devicetree/bindings/sound/nuvoton,nau8825.yaml +++ b/Documentation/devicetree/bindings/sound/nuvoton,nau8825.yaml @@ -9,6 +9,18 @@ title: NAU8825 audio CODEC maintainers: - John Hsu =20 +description: | + NAU8825 audio CODEC + + Valid routing names defined in the driver for this codec include: + + Outputs: + * HPOL : Left Headphone Output + * HPOR : Right Headphone Output + + Inputs: + * MIC : Microphone Input + allOf: - $ref: dai-common.yaml# =20 --=20 2.39.5 From nobody Sun Oct 5 03:35:17 2025 Received: from mail-wr1-f48.google.com (mail-wr1-f48.google.com [209.85.221.48]) (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 C9C562BE632; Sat, 9 Aug 2025 15:20:05 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.48 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1754752807; cv=none; b=XkyiweKFQ8V9cRCumm4qzAivdAk4eWeALfyBbZc1bedv8FNziLtkAS0vzpYhMvkARVSxbe/lvXv3p/lLjyafpmZKTOnVwBM283DdhkbFHzD5hBTfH3a4YNtbmy0x3i44N4ri4WWLjQSiRIn5MlA98wXgyu274gbuDBEaRU6dM8M= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1754752807; c=relaxed/simple; bh=zE69J7iVRkRPHezfEuW053Wj+05v1LG9BKUsSUHztHw=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=MbXXOOaNR+ZTaOMllF7oNz6eu2eiZrDueAj27O+3HGzdHZGUIb0N9rznwCYC0tv6iUjzG/495XNKRxDQ0FggKvI7dky0BJZPkYz2PSWm1/zxof73nSJ2g/pClHQD/YL2VrL52AdwnSrNDbPBLjpaVH89G/c9mf47hgvTu7BAFeU= 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=GBFpHYKK; arc=none smtp.client-ip=209.85.221.48 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="GBFpHYKK" Received: by mail-wr1-f48.google.com with SMTP id ffacd0b85a97d-3b77b8750acso1846963f8f.0; Sat, 09 Aug 2025 08:20:05 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1754752804; x=1755357604; 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=F2z37DtB7ki2BMrEIWUmQdKynw5LgE3LSUPH4IGC79o=; b=GBFpHYKKs8ps1K/NWJRWha8K02JtQJWk7MZCcSvwKYAmrIgRI8x+nJkXbRwFLd95o+ Q+4fXbGgQOq69qTsp3pD1UsicpsA8mzQlNTL+xSZ9A2SrnkF3ZLKt8TXBMQLgvcV6mz7 aB7DnuF6yhti9Ul22H8/zxPZghL3t+V9XWzijb8B6g+5OdxpItuqS1UYJpiODDsRn+d3 qj1/6SEO7f3E77CX4Itl673ROyapgNzwEybeSLlS4wVRm+MPgPyEKGS+aQc9q6yjRHPh j/Gt9U+FFfRuiU9Ef7dABueYNfDEgnaipKJDA7fF93I638UeSzLcslIxA5gzbIZQWcEU G6Zw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1754752804; x=1755357604; 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=F2z37DtB7ki2BMrEIWUmQdKynw5LgE3LSUPH4IGC79o=; b=w1LGhM23tk/2B1c1UYXfSYzZPi4n5BgYlDtofTui0pqRdkwzkunLNkQl2y8I7GXgml 2o64OXk1NTR1SxEXHf2xjuaUMk7sXRk4CjW4eHxaJo3iS/NUJJJW84rzOEsvRtKMcpmV JyG7JkAc5H9Llna7g7zvn2bV5wAhoQ/bgMKUObbSpMesRofLkGF6kI2+T1Dilst095SR XX6EQ85hp0brTZYiwi2/cPl5e6YhToBtZZHwzkfeV4zFELUKeJvrGe8ebGIylvxQY3ei ebRYpmvetEWk6rhbsdX1sgubAt2FssIPVsdgszHNoDdavLbmkpBS9gDkZYdUUp1S3NoQ GQbA== X-Forwarded-Encrypted: i=1; AJvYcCUzkOFgdadkO4YWvR8Z3fke0kVGtDMyyss82OnsVxJ9gK1EkZ1X8G8awaUZLv8rqF/7dHKQLytQ5Cf3@vger.kernel.org, AJvYcCWi8OILLytE1WJ5MXBjZq2vds0/+qR/RrQyhWrQ/si7ZBV21GcOSBVdi7XmuOvmcs5bsXyiMdMnp4aZvit/@vger.kernel.org X-Gm-Message-State: AOJu0YyfMOIwDnvLch3I3LeYv2Bs82bzx5vldzo7+m9Z1stxYgHf/fGP MpKh7rBY3zhcRu++L72BBgeJH1ArNKhob+MjOw8QGAeLiq8YCiebLRKZ9xF/yvA= X-Gm-Gg: ASbGncsMMVrOtgCKaTixoncTCT9Of+hOlbQzu/X4r5/90Hd3z8DT/FvbOSW+/rYAQ6Q AJpDQ1gUC2rik4n8RNBJsAyeholQ1AHRo3706z8MHv/rJEwAcpxq+HgUDle4QomO/Tcg8BwnWvp II4mFD2ZdyocPMsBICNElvJmv4S1h7pZOpUfV8U8uPoFXhgy++tBRjSHFTnmLh55hOhgjUjVTsH Ar3C77GQuBdseTekbOa0xQREmhVZlnYlWSqWtqvR4tOd0f2GSeBQoGUqnBzTLpGtX60WYP6pEjm VDPlYWZo82Ele8zgGiSBpmO59a4hcfdqAxwzaHrQtAYbt67PnCkDqKDEM4vyrpOSIGylqxy4a98 d1/9syoSw4hpVw0EGr9D4q7+ivNRiU2Cl9E4ffP38X+ju8L8= X-Google-Smtp-Source: AGHT+IGusN9XKZd7es3KXwBzzyBcPCvZh2zlkHXnNJLYlOsbnMoW0ha4fXEs9ddU9RF0t5ans+UMFg== X-Received: by 2002:a05:6000:2507:b0:3b7:931d:37a0 with SMTP id ffacd0b85a97d-3b8f97c46d9mr8230422f8f.9.1754752803443; Sat, 09 Aug 2025 08:20:03 -0700 (PDT) Received: from localhost.localdomain ([2a0d:e487:156f:b6b0:b8c7:9296:47d7:b0cc]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-459e583ff76sm178748185e9.5.2025.08.09.08.20.02 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 09 Aug 2025 08:20:03 -0700 (PDT) From: Jihed Chaibi To: linux-sound@vger.kernel.org Cc: lgirdwood@gmail.com, broonie@kernel.org, robh@kernel.org, krzk+dt@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 3/3] ASoC: dt-bindings: wlf,wm8960: Document routing strings (pin names) Date: Sat, 9 Aug 2025 17:18:53 +0200 Message-Id: <20250809151853.47562-4-jihed.chaibi.dev@gmail.com> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20250809151853.47562-1-jihed.chaibi.dev@gmail.com> References: <20250809151853.47562-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" The wm8960 driver defines several DAPM widget names that are used for audio routing in the Device Tree. However, these strings are not documented in the binding file. This forces developers to read the C source to discover the valid names, which can be inefficient and error-prone. Add a list of the input and output widget names to the binding's description to make it self-contained and improve the user experience for board bring-up. Signed-off-by: Jihed Chaibi --- .../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 3c2b9790f..c8c786cb6 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