%DIF DEL PreviousConfiguration.tex Wed Dec 8 21:04:04 2021
%DIF ADD ../Configuration.tex Fri Dec 10 14:56:58 2021
%DIF DEL PreviousConfiguration.tex Sun Dec 12 09:04:19 2021
%DIF ADD ../Configuration.tex Sun Dec 19 11:00:50 2021
\usepackage{lmodern}
\usepackage{amssymb,amsmath}
...
...
@@ -2763,18 +2763,18 @@ blocking.
\tightlist
\item\DIFadd{For Microsoft Hyper-V it }\DIFaddend provides the correct TSC and FSB values
to the kernel, as well as disables CPU topology validation \DIFdelbegin\DIFdel{.
}%DIFDELCMD <
%DIFDELCMD < %%%
\emph{\DIFdel{Note}}%DIFAUXCMD
\DIFdel{: These patches currently target Microsoft Hyper-V and may need to be extended for other purposes.}\DIFdelend\DIFaddbegin\DIFadd{(10.8+).
}\DIFdelend\DIFaddbegin\DIFadd{(10.8+).
}\item\DIFadd{For Intel CPUs it adds support for asymmetrical SMP systems
(e.g. Intel Alder Lake) by patching core count to thread count along
with the supplemental required changes (10.14+).
}\end{itemize}
\DIFaddend
\item
\DIFdelbegin\emph{\DIFdel{Note}}%DIFAUXCMD
\DIFdel{: These patches currently target Microsoft Hyper-V and may need to be extended for other purposes.}%DIFDELCMD <
%DIFDELCMD < %%%
\DIFdelend\item
\texttt{SetApfsTrimTimeout}\\
\textbf{Type}: \texttt{plist\ integer}\\
\textbf{Failsafe}: \texttt{-1}\\
...
...
@@ -6549,8 +6549,13 @@ with the boot menu.
\textbf{Description}: Configure audio backend support described
in the \hyperref[uefiaudioprops]{Audio Properties} section below.
Audio support provides a way for upstream protocols to interact with the
selected hardware and audio resources. All audio resources should reside
\DIFdelbegin\DIFdel{Audio support }\DIFdelend\DIFaddbegin\DIFadd{Unless documented otherwise (e.g. }\texttt{\DIFadd{ResetTrafficClass}}\DIFadd{) settings in this section
are for UEFI audio support only (e.g. OpenCore generated boot chime and audio assist) and are
unrelated to any configuration needed for OS audio support (e.g. }\texttt{\DIFadd{AppleALC}}\DIFadd{).
}
\DIFadd{UEFI audio support }\DIFaddend provides a way for upstream protocols to interact with the
selected \DIFdelbegin\DIFdel{hardware and audio }\DIFdelend\DIFaddbegin\DIFadd{audio hardware and }\DIFaddend resources. All audio resources should reside
in \texttt{\textbackslash EFI\textbackslash OC\textbackslash Resources\textbackslash Audio}
directory. Currently the supported audio file formats are MP3 and WAVE PCM. While it is
driver-dependent which audio stream format is supported, most common audio cards
As an alternative, \texttt{gfxutil -f HDEF} command can be used in macOS. Specifying an empty device
path will result in the first available audio controller being used.
\DIFdelbegin\DIFdel{As an alternative, }\DIFdelend\DIFaddbegin\DIFadd{If using using }\texttt{\DIFadd{AudioDxe}}\DIFadd{, the required device path is also output as:
\DIFadd{Finally, }\DIFaddend\texttt{gfxutil -f HDEF} command can be used in macOS \DIFdelbegin\DIFdel{. }\DIFdelend\DIFaddbegin\DIFadd{to obtain the device path.
}
\DIFaddend Specifying an empty device path will result in the first available audio controller being used\DIFaddbegin\DIFadd{, and can
be a convenient option to get UEFI audio working if only one audio controller is present}\DIFaddend .
\textbf{Description}: Index of the output port of the specified codec starting from 0.
\textbf{Description}: \DIFdelbegin\DIFdel{Index of the output port of the specified codec starting from 0.
}\DIFdelend\DIFaddbegin\DIFadd{Bit field indicating which output channels to use for UEFI sound.
}\DIFaddend
This typically contains the index of the green out of the builtin analog audio controller (\texttt{HDEF}).
The number of output nodes (\texttt{N}) in the debug log (marked in bold-italic):
This \DIFdelbegin\DIFdel{typically contains the index of the }\DIFdelend\DIFaddbegin\DIFadd{should typically contain a single bit corresponding to the }\DIFaddend green out of the builtin analog audio
controller (\texttt{HDEF}).
The number of \DIFaddbegin\DIFadd{available }\DIFaddend output nodes (\texttt{N})\DIFaddbegin\DIFadd{for each HDA codec is shown }\DIFaddend in the debug log (marked in bold-italic):
The quickest way to find the right port is to bruteforce the values from \texttt{0} to \texttt{N -1}.
The \DIFdelbegin\DIFdel{quickest way to find the right port is }\DIFdelend\DIFaddbegin\DIFadd{first available output node is bit 0(value }\texttt{\DIFadd{1}}\DIFadd{), the second node is bit 1(value }\texttt{\DIFadd{2}}\DIFadd{), etc.
}
\item
\DIFadd{When the debug version of }\texttt{\DIFadd{AudioDxe}}\DIFadd{is used, then additional information on each output channel of each codec
is logged during driver binding. Further information on the available output channels may also be found from a Linux
\DIFadd{Using }\texttt{\DIFadd{AudioOutMask}}\DIFadd{, it is possible to play sound to more than one channel (e.g. main speaker plus bass speaker;
headphones plus speakers). For example, if the main speaker is ouput 0 and the bass speaker
is output 2, then to play to both set }\texttt{\DIFadd{AudioOutMask}}\DIFaddend to \DIFdelbegin\DIFdel{bruteforce the values from }\DIFdelend\DIFaddbegin\texttt{\DIFadd{1 << 0+1 << 2}}\DIFadd{i.e. }\texttt{\DIFadd{5}}\DIFadd{. This
feature is supported when all chosen outputs support the sound file format in use; if any do not then no sound
will play and an error will be logged.
}
\emph{\DIFadd{Note 1}}\DIFadd{: If all available output channels on the codec support the available sound file format, then a value
of }\DIFaddend\texttt{\DIFdelbegin\DIFdel{0}%DIFDELCMD < \MBLOCKRIGHTBRACE %%%
\DIFdel{to }\texttt{\DIFdel{N -1}}%DIFAUXCMD
\DIFdelend\DIFaddbegin\DIFadd{-1}}\DIFadd{may be used to play to all channels simultaneously}\DIFaddend .
\DIFaddbegin\emph{\DIFadd{Note 2}}\DIFadd{: Bits in }\texttt{\DIFadd{AudioOutMask}}\DIFadd{do not represent internal codec node ids as found in detailed codec
dumps, but rather the available output nodes as shown e.g. in the }\texttt{\DIFadd{OCAU}}\DIFadd{log lines above.
}
\DIFaddend\item
\texttt{AudioSupport}\\
\textbf{Type}: \texttt{plist\ boolean}\\
\textbf{Failsafe}: \texttt{false}\\
\textbf{Description}: Activate audio support by connecting to a backend driver.
Enabling this setting routes audio playback from builtin protocols to a dedicated
audio port (\texttt{AudioOut}) of the specified codec (\texttt{AudioCodec}) located
on the audio controller (\texttt{AudioDevice}).
Enabling this setting routes audio playback from builtin protocols to \DIFdelbegin\DIFdel{a dedicated
audio port (}\DIFdelend\DIFaddbegin\DIFadd{specified
(}\DIFaddend\texttt{\DIFdelbegin\DIFdel{AudioOut}\DIFdelend\DIFaddbegin\DIFadd{AudioOutMask}\DIFaddend})\DIFaddbegin\DIFadd{dedicated audio ports }\DIFaddend of the specified codec (\texttt{AudioCodec})\DIFaddbegin\DIFadd{,
}\DIFaddend located on the \DIFaddbegin\DIFadd{specified }\DIFaddend audio controller (\texttt{AudioDevice})\DIFaddbegin\DIFadd{.
