From cc550bc48de562f2931227f7a054587d377fe4d5 Mon Sep 17 00:00:00 2001
From: Xi Ruoyao <xry111@xry111.site>
Date: Wed, 28 Jun 2023 00:15:29 +0800
Subject: [PATCH] firmware: Add Sound Open Firmware

---
 multimedia/libdriv/alsa-utils.xml |  2 +-
 postlfs/config/firmware.xml       | 39 +++++++++++++++++++++++++++++++
 2 files changed, 40 insertions(+), 1 deletion(-)

diff --git a/multimedia/libdriv/alsa-utils.xml b/multimedia/libdriv/alsa-utils.xml
index 2354df06b0..dbb11a7591 100644
--- a/multimedia/libdriv/alsa-utils.xml
+++ b/multimedia/libdriv/alsa-utils.xml
@@ -141,7 +141,7 @@ make</userinput></screen>
 
   </sect2>
 
-  <sect2 role="configuration">
+  <sect2 role="configuration" id="alsa-utils-config-sect">
     <title>Configuring ALSA Utilities</title>
 
     <sect3 id="alsa-utils-config">
diff --git a/postlfs/config/firmware.xml b/postlfs/config/firmware.xml
index 58b6a7504d..3b445e8660 100644
--- a/postlfs/config/firmware.xml
+++ b/postlfs/config/firmware.xml
@@ -692,6 +692,45 @@ cp -d nv* vuc-* /lib/firmware/nouveau/</userinput></screen>
     </para>
   </sect2>
 
+  <sect2 id="sound-open-firmware">
+    <title>Sound Open Firmware</title>
+
+    <para>
+      Some systems (especially budget laptops) utilizes a DSP shipped with
+      the CPU for connection with the audio codec.  The Sound Open Firmware
+      must be loaded onto the DSP to make it functional.  These firmware
+      files can be downloaded from
+      <ulink url='https://github.com/thesofproject/sof-bin/releases'/>.
+      Extract the tarball and changing into the extracted directory,
+      then as the &root; user install the firmware:
+    </para>
+
+    <screen role="nodump"><userinput>install -vdm755 /usr/lib/firmware/intel      &amp;&amp;
+cp -av -T --no-preserve=ownership sof-*      \
+   /usr/lib/firmware/intel/sof               &amp;&amp;
+cp -av -T --no-preserve=ownership sof-tplg-* \
+   /usr/lib/firmware/intel/sof-tplg</userinput></screen>
+
+    <para>
+      <xref linkend="alsa-lib"/> needs Use Case Manager configuration files
+      for the systems using Sound Open Firmware as well.  The ALSA UCM
+      configuration files can be downloaded from
+      <ulink url='https://github.com/alsa-project/alsa-ucm-conf/tags'/>.
+      Extract the tarball and changing into the extracted directory,
+      then as the &root; user install the configuration files:
+    </para>
+
+    <screen role="nodump"><userinput>install -vdm755 /usr/share/alsa &amp;&amp;
+cp -av -T --no-preserve=ownership ucm2 /usr/share/alsa/ucm2</userinput></screen>
+
+    <para>
+      Once the firmware is loaded (you may need a reboot so the kernel will
+      load them) and the UCM configuration files are installed, following
+      <xref linkend="alsa-utils-config-sect"/> to set up your sound card for
+      ALSA properly.
+    </para>
+  </sect2>
+
   <sect2 id="other-firmware">
     <title>Firmware for Other Devices</title>