Added AudioOutMask and DisconnectHda keys and descriptions, updated some descriptions

@Eugene-grb @bluehomewu @btwise @droofy @sebaprawilnie @socialskyo

Chinese, Simplified Localization (zh-Hans)/Internal/Localizable.strings

@@ -1560,6 +1560,9 @@
 /* UrW-oc-0Oc */
 "TT_AudioOut" = "指定编解码器输出端口的索引,一般从0开始.\n\n找到正确端口的最快方法是将值从0暴力尝试到N-1,N是在日志里显示的输出端口索引数,比如日志里显示有3个输出,可以从0-2挨个试.";
 
+"TT_AudioOutMask" = "Type: plist integer\nFailsafe: -1\nDescription: Bit field indicating which output channels to use for UEFI sound.\n\nAudio mask is 1 « audio output (equivalently 2 ˆ audio output). E.g. for audio output 0 the bitmask is 1, for output 3 it is 8, and for outputs 0 and 3 it is 9.\n\nThe number of available output nodes (N) for each HDA codec is shown in the debug log (marked in bold-italic), audio outputs 0 to N - 1 may be selected:\nOCAU: 1/3 PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x1)/VenMsg(<redacted>,00000000) (4 outputs)\nOCAU: 2/3 PciRoot(0x0)/Pci(0x3,0x0)/VenMsg(<redacted>,00000000) (1 outputs)\nOCAU: 3/3 PciRoot(0x0)/Pci(0x1B,0x0)/VenMsg(<redacted>,02000000) (7 outputs)\n\nWhen AudioDxe is used then additional information about each output channel is logged during driver binding, including the bitmask for each output. The bitmask values for the desired outputs should be added together to obtain the AudioOutMask value:\nHDA: | Port widget @ 0x9 is an output (pin defaults 0x2B4020) (bitmask 1)\nHDA: | Port widget @ 0xA is an output (pin defaults 0x90100112) (bitmask 2)\nHDA: | Port widget @ 0xB is an output (pin defaults 0x90100110) (bitmask 4)\nHDA: | Port widget @ 0x10 is an output (pin defaults 0x4BE030) (bitmask 8)\n\nFurther information on the available output channels may be found from a Linux codec dump using the command:
+cat /proc/asound/card{n}/codec#{m}\n\nUsing AudioOutMask, it is possible to play sound to more than one channel (e.g. main speaker plus bass speaker; headphones plus speakers) as long as all the chosen outputs support the sound file format in use; if any do not then no sound will play and a warning will be logged.\n\nWhen all available output channels on the codec support the available sound file format, then a value of -1 will play sound to all channels simultaneously. If this does not work, it will usually be quickest to try each available output channel one by one, in order to work out which channel(s) to use.";
+
 /* PF5-bc-9Z2 */
 "TT_MinimumVolume" = "最小音量从0到100.\n\n当计算出的音量级别小于MinimumVolume时,屏幕阅读器将使用此音量级别.如果计算出的音量小于MinimumVolume,则不会发出开机提示音.";
 
@@ -1578,6 +1581,8 @@
 /* 4mo-Ut-bYl */
 "TT_ResetTrafficClass" = "将HDA流量等级选择寄存器设置为TC0.\n\n仅当TCSEL寄存器配置为使用TC0流量等级时,AppleHDA kext才能正常运行. 有关此寄存器的更多详细信息,请参阅英特尔I/O控制器9(ICH9)数据表(或任何其他ICH数据表).\n\n注意:此选项独立于AudioSupport. 如果使用AppleALC,则最好改用AppleALC alctsel属性.";
 
+"TT_DisconnectHda" = "Type: plist boolean\nFailsafe: false\nDescription: Disconnect HDA controller before loading drivers.\n\nMay be required on some systems (e.g. Apple hardware, VMware Fusion guest) to allow a UEFI sound driver (such as AudioDxe) to take control of the audio hardware.";
+
 /* Drivers */
 /* 6zo-Jl-Ryl */
 "TT_uefi_driversTable" = "1.Path\n从 OC/Drivers 目录作为 UEFI 驱动程序加载的文件路径.\n2. Enabled\n如果为 false,此驱动程序条目将被忽略.\n3. Arguments\n一些 OC 插件接受可选的附加参数,可以在此处指定为字符串.";

Chinese, Simplified Localization (zh-Hans)/Sections/uefiController.strings

@@ -14,6 +14,9 @@
 /* Class = "NSTextFieldCell"; title = "TimerResolution"; ObjectID = "3Ql-TM-Oiv"; */
 "3Ql-TM-Oiv.title" = "TimerResolution";
 
+/* Class = "NSButtonCell"; title = "DisconnectHda"; ObjectID = "3Sg-0T-21K"; */
+"3Sg-0T-21K.title" = "DisconnectHda";
+
 /* Class = "NSTableColumn"; headerCell.title = "Comment"; ObjectID = "4ew-tO-Ops"; */
 "4ew-tO-Ops.headerCell.title" = "注释\nComment";
 
@@ -179,6 +182,9 @@
 /* Class = "NSButtonCell"; title = "AudioSupport"; ObjectID = "oT1-Q2-rhc"; */
 "oT1-Q2-rhc.title" = "AudioSupport";
 
+/* Class = "NSTextFieldCell"; title = "AudioOutMask"; ObjectID = "r2Q-7P-fO6"; */
+"r2Q-7P-fO6.title" = "AudioOutMask";
+
 /* Class = "NSTabViewItem"; label = "Input"; ObjectID = "tiX-oG-c7h"; */
 "tiX-oG-c7h.label" = "Apple快捷键相关";
 

Chinese, Traditional Localization (zh-Hant)/Internal/Localizable.strings

 /* mountefiController */

Chinese, Traditional Localization (zh-Hant)/Sections/uefiController.strings

@@ -14,6 +14,9 @@
 /* Class = "NSTextFieldCell"; title = "TimerResolution"; ObjectID = "3Ql-TM-Oiv"; */
 "3Ql-TM-Oiv.title" = "TimerResolution";
 
+/* Class = "NSButtonCell"; title = "DisconnectHda"; ObjectID = "3Sg-0T-21K"; */
+"3Sg-0T-21K.title" = "DisconnectHda";
+
 /* Class = "NSTableColumn"; headerCell.title = "Comment"; ObjectID = "4ew-tO-Ops"; */
 "4ew-tO-Ops.headerCell.title" = "注釋";
 
@@ -179,6 +182,9 @@
 /* Class = "NSButtonCell"; title = "AudioSupport"; ObjectID = "oT1-Q2-rhc"; */
 "oT1-Q2-rhc.title" = "AudioSupport";
 
+/* Class = "NSTextFieldCell"; title = "AudioOutMask"; ObjectID = "r2Q-7P-fO6"; */
+"r2Q-7P-fO6.title" = "AudioOutMask";
+
 /* Class = "NSTabViewItem"; label = "Input"; ObjectID = "tiX-oG-c7h"; */
 "tiX-oG-c7h.label" = "Apple快捷鍵相關";
 

English Localization (en)/Internal/Localizable.strings

@@ -1552,7 +1552,7 @@
 
 /* Audio */
 /* YTE-Ba-80O */
-"TT_AudioDevice" = "Type: plist string\nFailsafe: Empty\nDescription: Device path of the specified audio controller for audio support.\n\nThis typically contains builtin analog audio controller (HDEF) device path, e.g. PciRoot(0x0)/Pci(0x1b,0x0).\nThe list of recognised audio controllers can be found in the debug log:\nOCAU: 1/3 PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x1)/VenMsg(<redacted>,00000000) (4 outputs)\nOCAU: 2/3 PciRoot(0x0)/Pci(0x3,0x0)/VenMsg(<redacted>,00000000) (1 outputs)\nOCAU: 3/3 PciRoot(0x0)/Pci(0x1B,0x0)/VenMsg(<redacted>,02000000) (7 outputs)\n\nAs an alternative gfxutil -f HDEF command can be used in macOS. Specifying an empty device path will result in the first available audio controller being used.";
+"TT_AudioDevice" = "Type: plist string\nFailsafe: Empty\nDescription: Device path of the specified audio controller for audio support.\n\nThis typically contains builtin analog audio controller (HDEF) device path, e.g. PciRoot(0x0)/Pci(0x1b,0x0).\nThe list of recognised audio controllers can be found in the debug log:\nOCAU: 1/3 PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x1)/VenMsg(<redacted>,00000000) (4 outputs)\nOCAU: 2/3 PciRoot(0x0)/Pci(0x3,0x0)/VenMsg(<redacted>,00000000) (1 outputs)\nOCAU: 3/3 PciRoot(0x0)/Pci(0x1B,0x0)/VenMsg(<redacted>,02000000) (7 outputs)\n\nIf using AudioDxe, the required device path is also output as:\nHDA: Connecting controller PciRoot(0x0)/Pci(0x1B,0x0)\n\nFinally, gfxutil -f HDEF command can be used in macOS to obtain the device path.\n\nSpecifying an empty device path will result in the first available audio controller being used, and can be a convenient option to get UEFI audio working if only one audio controller is present.";
 
 /* AZW-9D-hq6 */
 "TT_AudioCodec" = "Type: plist integer\nFailsafe: 0\nDescription: Codec address on the specified audio controller for audio support. This typically contains the first audio codec address on the builtin analog audio controller (HDEF). Audio codec addresses, e.g. 2, can be found in the debug log: \nOCAU: 1/3 PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x1)/VenMsg(<redacted>,00000000) (4 outputs) \nOCAU: 2/3 PciRoot(0x0)/Pci(0x3,0x0)/VenMsg(<redacted>,00000000) (1 outputs)\nOCAU: 3/3 PciRoot(0x0)/Pci(0x1B,0x0)/VenMsg(<redacted>,02000000) (7 outputs)\n\nAs an alternative this value can be obtained from IOHDACodecDevice class in I/O Registry containing it in IOHDACodecAddress field.";
@@ -1560,6 +1560,9 @@
 /* UrW-oc-0Oc */
 "TT_AudioOut" = "Type: plist integer\nFailsafe: 0\nDescription: Index of the output port of the specified codec starting from 0.\n\nThis typically contains the index of the green out of the builtin analog audio controller (HDEF). The number of output nodes (N) in the debug log (marked in bold):\nOCAU: 1/3 PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x1)/VenMsg(<redacted>,00000000) (4 outputs)\nOCAU: 2/3 PciRoot(0x0)/Pci(0x3,0x0)/VenMsg(<redacted>,00000000) (1 outputs)\nOCAU: 3/3 PciRoot(0x0)/Pci(0x1B,0x0)/VenMsg(<redacted>,02000000) (7 outputs) \n\nThe quickest way to find the right port is to bruteforce the values from 0 to N - 1.";
 
+"TT_AudioOutMask" = "Type: plist integer\nFailsafe: -1\nDescription: Bit field indicating which output channels to use for UEFI sound.\n\nAudio mask is 1 « audio output (equivalently 2 ˆ audio output). E.g. for audio output 0 the bitmask is 1, for output 3 it is 8, and for outputs 0 and 3 it is 9.\n\nThe number of available output nodes (N) for each HDA codec is shown in the debug log (marked in bold-italic), audio outputs 0 to N - 1 may be selected:\nOCAU: 1/3 PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x1)/VenMsg(<redacted>,00000000) (4 outputs)\nOCAU: 2/3 PciRoot(0x0)/Pci(0x3,0x0)/VenMsg(<redacted>,00000000) (1 outputs)\nOCAU: 3/3 PciRoot(0x0)/Pci(0x1B,0x0)/VenMsg(<redacted>,02000000) (7 outputs)\n\nWhen AudioDxe is used then additional information about each output channel is logged during driver binding, including the bitmask for each output. The bitmask values for the desired outputs should be added together to obtain the AudioOutMask value:\nHDA: | Port widget @ 0x9 is an output (pin defaults 0x2B4020) (bitmask 1)\nHDA: | Port widget @ 0xA is an output (pin defaults 0x90100112) (bitmask 2)\nHDA: | Port widget @ 0xB is an output (pin defaults 0x90100110) (bitmask 4)\nHDA: | Port widget @ 0x10 is an output (pin defaults 0x4BE030) (bitmask 8)\n\nFurther information on the available output channels may be found from a Linux codec dump using the command:
+cat /proc/asound/card{n}/codec#{m}\n\nUsing AudioOutMask, it is possible to play sound to more than one channel (e.g. main speaker plus bass speaker; headphones plus speakers) as long as all the chosen outputs support the sound file format in use; if any do not then no sound will play and a warning will be logged.\n\nWhen all available output channels on the codec support the available sound file format, then a value of -1 will play sound to all channels simultaneously. If this does not work, it will usually be quickest to try each available output channel one by one, in order to work out which channel(s) to use.";
+
 /* PF5-bc-9Z2 */
 "TT_MinimumVolume" = "Type: plist integer\nFailsafe: 0\nDescription: Minimal heard volume level from 0 to 100.\n\nThe screen reader will use this volume level when the calculated volume level is lower than MinimumVolume and the boot chime will not play if the calculated volume level is lower than MinimumVolume.";
 
@@ -1573,11 +1576,13 @@
 "TT_playchime" = "Type: plist string\nFailsafe: Auto\nDescription: Play chime sound at startup.\n\nEnabling this setting plays the boot chime using the builtin audio support. The volume level is determined by the MinimumVolume and VolumeAmplifier settings as well as the SystemAudioVolume NVRAM variable. Possible values include:\n• Auto — Enables chime when StartupMute NVRAM variable is not present or set to 00.\n• Enabled — Enables chime unconditionally.\n• Disabled — Disables chime unconditionally.\n\nNote: Enabled can be used in separate from StartupMute NVRAM variable to avoid conflicts when the firmware is able to play the boot chime.";
 
 /* 2zI-kW-5dk */
-"TT_AudioSupport" = "Type: plist boolean\nFailsafe: false\nDescription: Activate audio support by connecting to a backend driver.\n\nEnabling this setting routes audio playback from builtin protocols to a dedicated audio port (AudioOut) of the specified codec (AudioCodec) located on the audio controller (AudioDevice).";
+"TT_AudioSupport" = "Type: plist boolean\nFailsafe: false\nDescription: Activate audio support by connecting to a backend driver.\n\nEnabling this setting routes audio playback from builtin protocols to specified (AudioOutMask) dedicated audio ports of the specified codec (AudioCodec), located on the specified audio controller (AudioDevice).";
 
 /* 4mo-Ut-bYl */
 "TT_ResetTrafficClass" = "Type: plist boolean\nFailsafe: false\nDescription: Set HDA Traffic Class Select Register to TC0.\n\nAppleHDA kext will function correctly only if TCSEL register is configured to use TC0 traffic class. Refer to Intel I/O Controller Hub 9 (ICH9) Family Datasheet (or any other ICH datasheet) for more details about this register.\n\nNote: This option is independent from AudioSupport. If AppleALC is used it is preferred to use AppleALC alctsel property instead.";
 
+"TT_DisconnectHda" = "Type: plist boolean\nFailsafe: false\nDescription: Disconnect HDA controller before loading drivers.\n\nMay be required on some systems (e.g. Apple hardware, VMware Fusion guest) to allow a UEFI sound driver (such as AudioDxe) to take control of the audio hardware.";
+
 /* Drivers */
 /* 6zo-Jl-Ryl */
 "TT_uefi_driversTable" = "1. Comment\nType: plist string\nFailsafe: Empty\nDescription: Arbitrary ASCII string used to provide human readable reference for the entry. Whether this value is used is implementation defined.\n2. Path\nType: plist string\nFailsafe: Empty\nDescription: Path of file to be loaded as a UEFI driver from OC/Drivers directory.\n3. Enabled\nType: plist boolean\nFailsafe: false\nDescription: If false this driver entry will be ignored.\n4. Arguments\nType: plist string\nFailsafe: Empty\nDescription: Some OpenCore plugins accept optional additional arguments which may be specified as a string here.";

English Localization (en)/Sections/uefiController.strings

@@ -14,6 +14,9 @@
 /* Class = "NSTextFieldCell"; title = "TimerResolution"; ObjectID = "3Ql-TM-Oiv"; */
 "3Ql-TM-Oiv.title" = "TimerResolution";
 
+/* Class = "NSButtonCell"; title = "DisconnectHda"; ObjectID = "3Sg-0T-21K"; */
+"3Sg-0T-21K.title" = "DisconnectHda";
+
 /* Class = "NSTableColumn"; headerCell.title = "Comment"; ObjectID = "4ew-tO-Ops"; */
 "4ew-tO-Ops.headerCell.title" = "Comment";
 
@@ -179,6 +182,9 @@
 /* Class = "NSButtonCell"; title = "AudioSupport"; ObjectID = "oT1-Q2-rhc"; */
 "oT1-Q2-rhc.title" = "AudioSupport";
 
+/* Class = "NSTextFieldCell"; title = "AudioOutMask"; ObjectID = "r2Q-7P-fO6"; */
+"r2Q-7P-fO6.title" = "AudioOutMask";
+
 /* Class = "NSTabViewItem"; label = "Input"; ObjectID = "tiX-oG-c7h"; */
 "tiX-oG-c7h.label" = "Input";
 

French Localization (fr)/Internal/Localizable.strings

@@ -1552,7 +1552,7 @@
 
 /* Audio */
 /* YTE-Ba-80O */
-"TT_AudioDevice" = "Type: plist string\nFailsafe: Empty\nDescription: Device path of the specified audio controller for audio support.\n\nThis typically contains builtin analog audio controller (HDEF) device path, e.g. PciRoot(0x0)/Pci(0x1b,0x0).\nThe list of recognised audio controllers can be found in the debug log:\nOCAU: 1/3 PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x1)/VenMsg(<redacted>,00000000) (4 outputs)\nOCAU: 2/3 PciRoot(0x0)/Pci(0x3,0x0)/VenMsg(<redacted>,00000000) (1 outputs)\nOCAU: 3/3 PciRoot(0x0)/Pci(0x1B,0x0)/VenMsg(<redacted>,02000000) (7 outputs)\n\nAs an alternative gfxutil -f HDEF command can be used in macOS. Specifying an empty device path will result in the first available audio controller being used.";
+"TT_AudioDevice" = "Type: plist string\nFailsafe: Empty\nDescription: Device path of the specified audio controller for audio support.\n\nThis typically contains builtin analog audio controller (HDEF) device path, e.g. PciRoot(0x0)/Pci(0x1b,0x0).\nThe list of recognised audio controllers can be found in the debug log:\nOCAU: 1/3 PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x1)/VenMsg(<redacted>,00000000) (4 outputs)\nOCAU: 2/3 PciRoot(0x0)/Pci(0x3,0x0)/VenMsg(<redacted>,00000000) (1 outputs)\nOCAU: 3/3 PciRoot(0x0)/Pci(0x1B,0x0)/VenMsg(<redacted>,02000000) (7 outputs)\n\nIf using AudioDxe, the required device path is also output as:\nHDA: Connecting controller PciRoot(0x0)/Pci(0x1B,0x0)\n\nFinally, gfxutil -f HDEF command can be used in macOS to obtain the device path.\n\nSpecifying an empty device path will result in the first available audio controller being used, and can be a convenient option to get UEFI audio working if only one audio controller is present.";
 
 /* AZW-9D-hq6 */
 "TT_AudioCodec" = "Type: plist integer\nFailsafe: 0\nDescription: Codec address on the specified audio controller for audio support. This typically contains the first audio codec address on the builtin analog audio controller (HDEF). Audio codec addresses, e.g. 2, can be found in the debug log: \nOCAU: 1/3 PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x1)/VenMsg(<redacted>,00000000) (4 outputs) \nOCAU: 2/3 PciRoot(0x0)/Pci(0x3,0x0)/VenMsg(<redacted>,00000000) (1 outputs)\nOCAU: 3/3 PciRoot(0x0)/Pci(0x1B,0x0)/VenMsg(<redacted>,02000000) (7 outputs)\n\nAs an alternative this value can be obtained from IOHDACodecDevice class in I/O Registry containing it in IOHDACodecAddress field.";
@@ -1560,6 +1560,9 @@
 /* UrW-oc-0Oc */
 "TT_AudioOut" = "Type: plist integer\nFailsafe: 0\nDescription: Index of the output port of the specified codec starting from 0.\n\nThis typically contains the index of the green out of the builtin analog audio controller (HDEF). The number of output nodes (N) in the debug log (marked in bold):\nOCAU: 1/3 PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x1)/VenMsg(<redacted>,00000000) (4 outputs)\nOCAU: 2/3 PciRoot(0x0)/Pci(0x3,0x0)/VenMsg(<redacted>,00000000) (1 outputs)\nOCAU: 3/3 PciRoot(0x0)/Pci(0x1B,0x0)/VenMsg(<redacted>,02000000) (7 outputs) \n\nThe quickest way to find the right port is to bruteforce the values from 0 to N - 1.";
 
+"TT_AudioOutMask" = "Type: plist integer\nFailsafe: -1\nDescription: Bit field indicating which output channels to use for UEFI sound.\n\nAudio mask is 1 « audio output (equivalently 2 ˆ audio output). E.g. for audio output 0 the bitmask is 1, for output 3 it is 8, and for outputs 0 and 3 it is 9.\n\nThe number of available output nodes (N) for each HDA codec is shown in the debug log (marked in bold-italic), audio outputs 0 to N - 1 may be selected:\nOCAU: 1/3 PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x1)/VenMsg(<redacted>,00000000) (4 outputs)\nOCAU: 2/3 PciRoot(0x0)/Pci(0x3,0x0)/VenMsg(<redacted>,00000000) (1 outputs)\nOCAU: 3/3 PciRoot(0x0)/Pci(0x1B,0x0)/VenMsg(<redacted>,02000000) (7 outputs)\n\nWhen AudioDxe is used then additional information about each output channel is logged during driver binding, including the bitmask for each output. The bitmask values for the desired outputs should be added together to obtain the AudioOutMask value:\nHDA: | Port widget @ 0x9 is an output (pin defaults 0x2B4020) (bitmask 1)\nHDA: | Port widget @ 0xA is an output (pin defaults 0x90100112) (bitmask 2)\nHDA: | Port widget @ 0xB is an output (pin defaults 0x90100110) (bitmask 4)\nHDA: | Port widget @ 0x10 is an output (pin defaults 0x4BE030) (bitmask 8)\n\nFurther information on the available output channels may be found from a Linux codec dump using the command:
+cat /proc/asound/card{n}/codec#{m}\n\nUsing AudioOutMask, it is possible to play sound to more than one channel (e.g. main speaker plus bass speaker; headphones plus speakers) as long as all the chosen outputs support the sound file format in use; if any do not then no sound will play and a warning will be logged.\n\nWhen all available output channels on the codec support the available sound file format, then a value of -1 will play sound to all channels simultaneously. If this does not work, it will usually be quickest to try each available output channel one by one, in order to work out which channel(s) to use.";
+
 /* PF5-bc-9Z2 */
 "TT_MinimumVolume" = "Type: plist integer\nFailsafe: 0\nDescription: Minimal heard volume level from 0 to 100.\n\nThe screen reader will use this volume level when the calculated volume level is lower than MinimumVolume and the boot chime will not play if the calculated volume level is lower than MinimumVolume.";
 
@@ -1573,11 +1576,13 @@
 "TT_playchime" = "Type: plist string\nFailsafe: Auto\nDescription: Play chime sound at startup.\n\nEnabling this setting plays the boot chime using the builtin audio support. The volume level is determined by the MinimumVolume and VolumeAmplifier settings as well as the SystemAudioVolume NVRAM variable. Possible values include:\n• Auto — Enables chime when StartupMute NVRAM variable is not present or set to 00.\n• Enabled — Enables chime unconditionally.\n• Disabled — Disables chime unconditionally.\n\nNote: Enabled can be used in separate from StartupMute NVRAM variable to avoid conflicts when the firmware is able to play the boot chime.";
 
 /* 2zI-kW-5dk */
-"TT_AudioSupport" = "Type: plist boolean\nFailsafe: false\nDescription: Activate audio support by connecting to a backend driver.\n\nEnabling this setting routes audio playback from builtin protocols to a dedicated audio port (AudioOut) of the specified codec (AudioCodec) located on the audio controller (AudioDevice).";
+"TT_AudioSupport" = "Type: plist boolean\nFailsafe: false\nDescription: Activate audio support by connecting to a backend driver.\n\nEnabling this setting routes audio playback from builtin protocols to specified (AudioOutMask) dedicated audio ports of the specified codec (AudioCodec), located on the specified audio controller (AudioDevice).";
 
 /* 4mo-Ut-bYl */
 "TT_ResetTrafficClass" = "Type: plist boolean\nFailsafe: false\nDescription: Set HDA Traffic Class Select Register to TC0.\n\nAppleHDA kext will function correctly only if TCSEL register is configured to use TC0 traffic class. Refer to Intel I/O Controller Hub 9 (ICH9) Family Datasheet (or any other ICH datasheet) for more details about this register.\n\nNote: This option is independent from AudioSupport. If AppleALC is used it is preferred to use AppleALC alctsel property instead.";
 
+"TT_DisconnectHda" = "Type: plist boolean\nFailsafe: false\nDescription: Disconnect HDA controller before loading drivers.\n\nMay be required on some systems (e.g. Apple hardware, VMware Fusion guest) to allow a UEFI sound driver (such as AudioDxe) to take control of the audio hardware.";
+
 /* Drivers */
 /* 6zo-Jl-Ryl */
 "TT_uefi_driversTable" = "1. Path\nType: plist string\nFailsafe: Empty\nDescription: Path of file to be loaded as a UEFI driver from OC/Drivers directory.\n2. Enabled\nType: plist boolean\nFailsafe: false\nDescription: If false this driver entry will be ignored.\n3. Arguments\nType: plist string\nFailsafe: Empty\nDescription: Some OpenCore plugins accept optional additional arguments which may be specified as a string here.";

French Localization (fr)/Sections/uefiController.strings

@@ -14,6 +14,9 @@
 /* Class = "NSTextFieldCell"; title = "TimerResolution"; ObjectID = "3Ql-TM-Oiv"; */
 "3Ql-TM-Oiv.title" = "TimerResolution";
 
+/* Class = "NSButtonCell"; title = "DisconnectHda"; ObjectID = "3Sg-0T-21K"; */
+"3Sg-0T-21K.title" = "DisconnectHda";
+
 /* Class = "NSTableColumn"; headerCell.title = "Comment"; ObjectID = "4ew-tO-Ops"; */
 "4ew-tO-Ops.headerCell.title" = "Commentaire";
 
@@ -179,6 +182,9 @@
 /* Class = "NSButtonCell"; title = "AudioSupport"; ObjectID = "oT1-Q2-rhc"; */
 "oT1-Q2-rhc.title" = "AudioSupport";
 
+/* Class = "NSTextFieldCell"; title = "AudioOutMask"; ObjectID = "r2Q-7P-fO6"; */
+"r2Q-7P-fO6.title" = "AudioOutMask";
+
 /* Class = "NSTabViewItem"; label = "Input"; ObjectID = "tiX-oG-c7h"; */
 "tiX-oG-c7h.label" = "Entrée";
 

Korean Localization (ko)/Internal/Localizable.strings

@@ -1552,7 +1552,7 @@
 
 /* Audio */
 /* YTE-Ba-80O */
-"TT_AudioDevice" = "Type: plist string\nFailsafe: Empty\nDescription: Device path of the specified audio controller for audio support.\n\nThis typically contains builtin analog audio controller (HDEF) device path, e.g. PciRoot(0x0)/Pci(0x1b,0x0).\nThe list of recognised audio controllers can be found in the debug log:\nOCAU: 1/3 PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x1)/VenMsg(<redacted>,00000000) (4 outputs)\nOCAU: 2/3 PciRoot(0x0)/Pci(0x3,0x0)/VenMsg(<redacted>,00000000) (1 outputs)\nOCAU: 3/3 PciRoot(0x0)/Pci(0x1B,0x0)/VenMsg(<redacted>,02000000) (7 outputs)\n\nAs an alternative gfxutil -f HDEF command can be used in macOS. Specifying an empty device path will result in the first available audio controller being used.";
+"TT_AudioDevice" = "Type: plist string\nFailsafe: Empty\nDescription: Device path of the specified audio controller for audio support.\n\nThis typically contains builtin analog audio controller (HDEF) device path, e.g. PciRoot(0x0)/Pci(0x1b,0x0).\nThe list of recognised audio controllers can be found in the debug log:\nOCAU: 1/3 PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x1)/VenMsg(<redacted>,00000000) (4 outputs)\nOCAU: 2/3 PciRoot(0x0)/Pci(0x3,0x0)/VenMsg(<redacted>,00000000) (1 outputs)\nOCAU: 3/3 PciRoot(0x0)/Pci(0x1B,0x0)/VenMsg(<redacted>,02000000) (7 outputs)\n\nIf using AudioDxe, the required device path is also output as:\nHDA: Connecting controller PciRoot(0x0)/Pci(0x1B,0x0)\n\nFinally, gfxutil -f HDEF command can be used in macOS to obtain the device path.\n\nSpecifying an empty device path will result in the first available audio controller being used, and can be a convenient option to get UEFI audio working if only one audio controller is present.";
 
 /* AZW-9D-hq6 */
 "TT_AudioCodec" = "Type: plist integer\nFailsafe: 0\nDescription: Codec address on the specified audio controller for audio support. This typically contains the first audio codec address on the builtin analog audio controller (HDEF). Audio codec addresses, e.g. 2, can be found in the debug log: \nOCAU: 1/3 PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x1)/VenMsg(<redacted>,00000000) (4 outputs) \nOCAU: 2/3 PciRoot(0x0)/Pci(0x3,0x0)/VenMsg(<redacted>,00000000) (1 outputs)\nOCAU: 3/3 PciRoot(0x0)/Pci(0x1B,0x0)/VenMsg(<redacted>,02000000) (7 outputs)\n\nAs an alternative this value can be obtained from IOHDACodecDevice class in I/O Registry containing it in IOHDACodecAddress field.";
@@ -1560,6 +1560,9 @@
 /* UrW-oc-0Oc */
 "TT_AudioOut" = "Type: plist integer\nFailsafe: 0\nDescription: Index of the output port of the specified codec starting from 0.\n\nThis typically contains the index of the green out of the builtin analog audio controller (HDEF). The number of output nodes (N) in the debug log (marked in bold):\nOCAU: 1/3 PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x1)/VenMsg(<redacted>,00000000) (4 outputs)\nOCAU: 2/3 PciRoot(0x0)/Pci(0x3,0x0)/VenMsg(<redacted>,00000000) (1 outputs)\nOCAU: 3/3 PciRoot(0x0)/Pci(0x1B,0x0)/VenMsg(<redacted>,02000000) (7 outputs) \n\nThe quickest way to find the right port is to bruteforce the values from 0 to N - 1.";
 
+"TT_AudioOutMask" = "Type: plist integer\nFailsafe: -1\nDescription: Bit field indicating which output channels to use for UEFI sound.\n\nAudio mask is 1 « audio output (equivalently 2 ˆ audio output). E.g. for audio output 0 the bitmask is 1, for output 3 it is 8, and for outputs 0 and 3 it is 9.\n\nThe number of available output nodes (N) for each HDA codec is shown in the debug log (marked in bold-italic), audio outputs 0 to N - 1 may be selected:\nOCAU: 1/3 PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x1)/VenMsg(<redacted>,00000000) (4 outputs)\nOCAU: 2/3 PciRoot(0x0)/Pci(0x3,0x0)/VenMsg(<redacted>,00000000) (1 outputs)\nOCAU: 3/3 PciRoot(0x0)/Pci(0x1B,0x0)/VenMsg(<redacted>,02000000) (7 outputs)\n\nWhen AudioDxe is used then additional information about each output channel is logged during driver binding, including the bitmask for each output. The bitmask values for the desired outputs should be added together to obtain the AudioOutMask value:\nHDA: | Port widget @ 0x9 is an output (pin defaults 0x2B4020) (bitmask 1)\nHDA: | Port widget @ 0xA is an output (pin defaults 0x90100112) (bitmask 2)\nHDA: | Port widget @ 0xB is an output (pin defaults 0x90100110) (bitmask 4)\nHDA: | Port widget @ 0x10 is an output (pin defaults 0x4BE030) (bitmask 8)\n\nFurther information on the available output channels may be found from a Linux codec dump using the command:
+cat /proc/asound/card{n}/codec#{m}\n\nUsing AudioOutMask, it is possible to play sound to more than one channel (e.g. main speaker plus bass speaker; headphones plus speakers) as long as all the chosen outputs support the sound file format in use; if any do not then no sound will play and a warning will be logged.\n\nWhen all available output channels on the codec support the available sound file format, then a value of -1 will play sound to all channels simultaneously. If this does not work, it will usually be quickest to try each available output channel one by one, in order to work out which channel(s) to use.";
+
 /* PF5-bc-9Z2 */
 "TT_MinimumVolume" = "Type: plist integer\nFailsafe: 0\nDescription: Minimal heard volume level from 0 to 100.\n\nThe screen reader will use this volume level when the calculated volume level is lower than MinimumVolume and the boot chime will not play if the calculated volume level is lower than MinimumVolume.";
 
@@ -1573,11 +1576,13 @@
 "TT_playchime" = "Type: plist string\nFailsafe: Auto\nDescription: Play chime sound at startup.\n\nEnabling this setting plays the boot chime using the builtin audio support. The volume level is determined by the MinimumVolume and VolumeAmplifier settings as well as the SystemAudioVolume NVRAM variable. Possible values include:\n• Auto — Enables chime when StartupMute NVRAM variable is not present or set to 00.\n• Enabled — Enables chime unconditionally.\n• Disabled — Disables chime unconditionally.\n\nNote: Enabled can be used in separate from StartupMute NVRAM variable to avoid conflicts when the firmware is able to play the boot chime.";
 
 /* 2zI-kW-5dk */
-"TT_AudioSupport" = "Type: plist boolean\nFailsafe: false\nDescription: Activate audio support by connecting to a backend driver.\n\nEnabling this setting routes audio playback from builtin protocols to a dedicated audio port (AudioOut) of the specified codec (AudioCodec) located on the audio controller (AudioDevice).";
+"TT_AudioSupport" = "Type: plist boolean\nFailsafe: false\nDescription: Activate audio support by connecting to a backend driver.\n\nEnabling this setting routes audio playback from builtin protocols to specified (AudioOutMask) dedicated audio ports of the specified codec (AudioCodec), located on the specified audio controller (AudioDevice).";
 
 /* 4mo-Ut-bYl */
 "TT_ResetTrafficClass" = "Type: plist boolean\nFailsafe: false\nDescription: Set HDA Traffic Class Select Register to TC0.\n\nAppleHDA kext will function correctly only if TCSEL register is configured to use TC0 traffic class. Refer to Intel I/O Controller Hub 9 (ICH9) Family Datasheet (or any other ICH datasheet) for more details about this register.\n\nNote: This option is independent from AudioSupport. If AppleALC is used it is preferred to use AppleALC alctsel property instead.";
 
+"TT_DisconnectHda" = "Type: plist boolean\nFailsafe: false\nDescription: Disconnect HDA controller before loading drivers.\n\nMay be required on some systems (e.g. Apple hardware, VMware Fusion guest) to allow a UEFI sound driver (such as AudioDxe) to take control of the audio hardware.";
+
 /* Drivers */
 /* 6zo-Jl-Ryl */
 "TT_uefi_driversTable" = "1. Path\nType: plist string\nFailsafe: Empty\nDescription: Path of file to be loaded as a UEFI driver from OC/Drivers directory.\n2. Enabled\nType: plist boolean\nFailsafe: false\nDescription: If false this driver entry will be ignored.\n3. Arguments\nType: plist string\nFailsafe: Empty\nDescription: Some OpenCore plugins accept optional additional arguments which may be specified as a string here.";

Korean Localization (ko)/Sections/uefiController.strings

@@ -14,6 +14,9 @@
 /* Class = "NSTextFieldCell"; title = "TimerResolution"; ObjectID = "3Ql-TM-Oiv"; */
 "3Ql-TM-Oiv.title" = "TimerResolution";
 
+/* Class = "NSButtonCell"; title = "DisconnectHda"; ObjectID = "3Sg-0T-21K"; */
+"3Sg-0T-21K.title" = "DisconnectHda";
+
 /* Class = "NSTableColumn"; headerCell.title = "Comment"; ObjectID = "4ew-tO-Ops"; */
 "4ew-tO-Ops.headerCell.title" = "코멘트";
 
@@ -179,6 +182,9 @@
 /* Class = "NSButtonCell"; title = "AudioSupport"; ObjectID = "oT1-Q2-rhc"; */
 "oT1-Q2-rhc.title" = "AudioSupport";
 
+/* Class = "NSTextFieldCell"; title = "AudioOutMask"; ObjectID = "r2Q-7P-fO6"; */
+"r2Q-7P-fO6.title" = "AudioOutMask";
+
 /* Class = "NSTabViewItem"; label = "Input"; ObjectID = "tiX-oG-c7h"; */
 "tiX-oG-c7h.label" = "Input";
 

Polish Localization (pl)/Internal/Localizable.strings

@@ -1552,7 +1552,7 @@
 
 /* Audio */
 /* YTE-Ba-80O */
-"TT_AudioDevice" = "Type: plist string\nFailsafe: Empty\nDescription: Device path of the specified audio controller for audio support.\n\nThis typically contains builtin analog audio controller (HDEF) device path, e.g. PciRoot(0x0)/Pci(0x1b,0x0).\nThe list of recognised audio controllers can be found in the debug log:\nOCAU: 1/3 PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x1)/VenMsg(<redacted>,00000000) (4 outputs)\nOCAU: 2/3 PciRoot(0x0)/Pci(0x3,0x0)/VenMsg(<redacted>,00000000) (1 outputs)\nOCAU: 3/3 PciRoot(0x0)/Pci(0x1B,0x0)/VenMsg(<redacted>,02000000) (7 outputs)\n\nAs an alternative gfxutil -f HDEF command can be used in macOS. Specifying an empty device path will result in the first available audio controller being used.";
+"TT_AudioDevice" = "Type: plist string\nFailsafe: Empty\nDescription: Device path of the specified audio controller for audio support.\n\nThis typically contains builtin analog audio controller (HDEF) device path, e.g. PciRoot(0x0)/Pci(0x1b,0x0).\nThe list of recognised audio controllers can be found in the debug log:\nOCAU: 1/3 PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x1)/VenMsg(<redacted>,00000000) (4 outputs)\nOCAU: 2/3 PciRoot(0x0)/Pci(0x3,0x0)/VenMsg(<redacted>,00000000) (1 outputs)\nOCAU: 3/3 PciRoot(0x0)/Pci(0x1B,0x0)/VenMsg(<redacted>,02000000) (7 outputs)\n\nIf using AudioDxe, the required device path is also output as:\nHDA: Connecting controller PciRoot(0x0)/Pci(0x1B,0x0)\n\nFinally, gfxutil -f HDEF command can be used in macOS to obtain the device path.\n\nSpecifying an empty device path will result in the first available audio controller being used, and can be a convenient option to get UEFI audio working if only one audio controller is present.";
 
 /* AZW-9D-hq6 */
 "TT_AudioCodec" = "Type: plist integer\nFailsafe: 0\nDescription: Codec address on the specified audio controller for audio support. This typically contains the first audio codec address on the builtin analog audio controller (HDEF). Audio codec addresses, e.g. 2, can be found in the debug log: \nOCAU: 1/3 PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x1)/VenMsg(<redacted>,00000000) (4 outputs) \nOCAU: 2/3 PciRoot(0x0)/Pci(0x3,0x0)/VenMsg(<redacted>,00000000) (1 outputs)\nOCAU: 3/3 PciRoot(0x0)/Pci(0x1B,0x0)/VenMsg(<redacted>,02000000) (7 outputs)\n\nAs an alternative this value can be obtained from IOHDACodecDevice class in I/O Registry containing it in IOHDACodecAddress field.";
@@ -1560,6 +1560,9 @@
 /* UrW-oc-0Oc */
 "TT_AudioOut" = "Type: plist integer\nFailsafe: 0\nDescription: Index of the output port of the specified codec starting from 0.\n\nThis typically contains the index of the green out of the builtin analog audio controller (HDEF). The number of output nodes (N) in the debug log (marked in bold):\nOCAU: 1/3 PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x1)/VenMsg(<redacted>,00000000) (4 outputs)\nOCAU: 2/3 PciRoot(0x0)/Pci(0x3,0x0)/VenMsg(<redacted>,00000000) (1 outputs)\nOCAU: 3/3 PciRoot(0x0)/Pci(0x1B,0x0)/VenMsg(<redacted>,02000000) (7 outputs) \n\nThe quickest way to find the right port is to bruteforce the values from 0 to N - 1.";
 
+"TT_AudioOutMask" = "Type: plist integer\nFailsafe: -1\nDescription: Bit field indicating which output channels to use for UEFI sound.\n\nAudio mask is 1 « audio output (equivalently 2 ˆ audio output). E.g. for audio output 0 the bitmask is 1, for output 3 it is 8, and for outputs 0 and 3 it is 9.\n\nThe number of available output nodes (N) for each HDA codec is shown in the debug log (marked in bold-italic), audio outputs 0 to N - 1 may be selected:\nOCAU: 1/3 PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x1)/VenMsg(<redacted>,00000000) (4 outputs)\nOCAU: 2/3 PciRoot(0x0)/Pci(0x3,0x0)/VenMsg(<redacted>,00000000) (1 outputs)\nOCAU: 3/3 PciRoot(0x0)/Pci(0x1B,0x0)/VenMsg(<redacted>,02000000) (7 outputs)\n\nWhen AudioDxe is used then additional information about each output channel is logged during driver binding, including the bitmask for each output. The bitmask values for the desired outputs should be added together to obtain the AudioOutMask value:\nHDA: | Port widget @ 0x9 is an output (pin defaults 0x2B4020) (bitmask 1)\nHDA: | Port widget @ 0xA is an output (pin defaults 0x90100112) (bitmask 2)\nHDA: | Port widget @ 0xB is an output (pin defaults 0x90100110) (bitmask 4)\nHDA: | Port widget @ 0x10 is an output (pin defaults 0x4BE030) (bitmask 8)\n\nFurther information on the available output channels may be found from a Linux codec dump using the command:
+cat /proc/asound/card{n}/codec#{m}\n\nUsing AudioOutMask, it is possible to play sound to more than one channel (e.g. main speaker plus bass speaker; headphones plus speakers) as long as all the chosen outputs support the sound file format in use; if any do not then no sound will play and a warning will be logged.\n\nWhen all available output channels on the codec support the available sound file format, then a value of -1 will play sound to all channels simultaneously. If this does not work, it will usually be quickest to try each available output channel one by one, in order to work out which channel(s) to use.";
+
 /* PF5-bc-9Z2 */
 "TT_MinimumVolume" = "Type: plist integer\nFailsafe: 0\nDescription: Minimal heard volume level from 0 to 100.\n\nThe screen reader will use this volume level when the calculated volume level is lower than MinimumVolume and the boot chime will not play if the calculated volume level is lower than MinimumVolume.";
 
@@ -1573,11 +1576,13 @@
 "TT_playchime" = "Type: plist string\nFailsafe: Auto\nDescription: Play chime sound at startup.\n\nEnabling this setting plays the boot chime using the builtin audio support. The volume level is determined by the MinimumVolume and VolumeAmplifier settings as well as the SystemAudioVolume NVRAM variable. Possible values include:\n• Auto — Enables chime when StartupMute NVRAM variable is not present or set to 00.\n• Enabled — Enables chime unconditionally.\n• Disabled — Disables chime unconditionally.\n\nNote: Enabled can be used in separate from StartupMute NVRAM variable to avoid conflicts when the firmware is able to play the boot chime.";
 
 /* 2zI-kW-5dk */
-"TT_AudioSupport" = "Type: plist boolean\nFailsafe: false\nDescription: Activate audio support by connecting to a backend driver.\n\nEnabling this setting routes audio playback from builtin protocols to a dedicated audio port (AudioOut) of the specified codec (AudioCodec) located on the audio controller (AudioDevice).";
+"TT_AudioSupport" = "Type: plist boolean\nFailsafe: false\nDescription: Activate audio support by connecting to a backend driver.\n\nEnabling this setting routes audio playback from builtin protocols to specified (AudioOutMask) dedicated audio ports of the specified codec (AudioCodec), located on the specified audio controller (AudioDevice).";
 
 /* 4mo-Ut-bYl */
 "TT_ResetTrafficClass" = "Type: plist boolean\nFailsafe: false\nDescription: Set HDA Traffic Class Select Register to TC0.\n\nAppleHDA kext will function correctly only if TCSEL register is configured to use TC0 traffic class. Refer to Intel I/O Controller Hub 9 (ICH9) Family Datasheet (or any other ICH datasheet) for more details about this register.\n\nNote: This option is independent from AudioSupport. If AppleALC is used it is preferred to use AppleALC alctsel property instead.";
 
+"TT_DisconnectHda" = "Type: plist boolean\nFailsafe: false\nDescription: Disconnect HDA controller before loading drivers.\n\nMay be required on some systems (e.g. Apple hardware, VMware Fusion guest) to allow a UEFI sound driver (such as AudioDxe) to take control of the audio hardware.";
+
 /* Drivers */
 /* 6zo-Jl-Ryl */
 "TT_uefi_driversTable" = "1. Path\nType: plist string\nFailsafe: Empty\nDescription: Path of file to be loaded as a UEFI driver from OC/Drivers directory.\n2. Enabled\nType: plist boolean\nFailsafe: false\nDescription: If false this driver entry will be ignored.\n3. Arguments\nType: plist string\nFailsafe: Empty\nDescription: Some OpenCore plugins accept optional additional arguments which may be specified as a string here.";

Polish Localization (pl)/Sections/uefiController.strings

@@ -14,6 +14,9 @@
 /* Class = "NSTextFieldCell"; title = "TimerResolution"; ObjectID = "3Ql-TM-Oiv"; */
 "3Ql-TM-Oiv.title" = "TimerResolution";
 
+/* Class = "NSButtonCell"; title = "DisconnectHda"; ObjectID = "3Sg-0T-21K"; */
+"3Sg-0T-21K.title" = "DisconnectHda";
+
 /* Class = "NSTableColumn"; headerCell.title = "Comment"; ObjectID = "4ew-tO-Ops"; */
 "4ew-tO-Ops.headerCell.title" = "Comment";
 
@@ -179,6 +182,9 @@
 /* Class = "NSButtonCell"; title = "AudioSupport"; ObjectID = "oT1-Q2-rhc"; */
 "oT1-Q2-rhc.title" = "AudioSupport";
 
+/* Class = "NSTextFieldCell"; title = "AudioOutMask"; ObjectID = "r2Q-7P-fO6"; */
+"r2Q-7P-fO6.title" = "AudioOutMask";
+
 /* Class = "NSTabViewItem"; label = "Input"; ObjectID = "tiX-oG-c7h"; */
 "tiX-oG-c7h.label" = "Input";
 

Russian Localization (ru)/Internal/Localizable.strings

@@ -1552,7 +1552,7 @@
 
 /* Audio */
 /* YTE-Ba-80O */
-"TT_AudioDevice" = "Type: plist string\nFailsafe: Empty\nDescription: Device path of the specified audio controller for audio support.\n\nThis typically contains builtin analog audio controller (HDEF) device path, e.g. PciRoot(0x0)/Pci(0x1b,0x0).\nThe list of recognised audio controllers can be found in the debug log:\nOCAU: 1/3 PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x1)/VenMsg(<redacted>,00000000) (4 outputs)\nOCAU: 2/3 PciRoot(0x0)/Pci(0x3,0x0)/VenMsg(<redacted>,00000000) (1 outputs)\nOCAU: 3/3 PciRoot(0x0)/Pci(0x1B,0x0)/VenMsg(<redacted>,02000000) (7 outputs)\n\nAs an alternative gfxutil -f HDEF command can be used in macOS. Specifying an empty device path will result in the first available audio controller being used.";
+"TT_AudioDevice" = "Type: plist string\nFailsafe: Empty\nDescription: Device path of the specified audio controller for audio support.\n\nThis typically contains builtin analog audio controller (HDEF) device path, e.g. PciRoot(0x0)/Pci(0x1b,0x0).\nThe list of recognised audio controllers can be found in the debug log:\nOCAU: 1/3 PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x1)/VenMsg(<redacted>,00000000) (4 outputs)\nOCAU: 2/3 PciRoot(0x0)/Pci(0x3,0x0)/VenMsg(<redacted>,00000000) (1 outputs)\nOCAU: 3/3 PciRoot(0x0)/Pci(0x1B,0x0)/VenMsg(<redacted>,02000000) (7 outputs)\n\nIf using AudioDxe, the required device path is also output as:\nHDA: Connecting controller PciRoot(0x0)/Pci(0x1B,0x0)\n\nFinally, gfxutil -f HDEF command can be used in macOS to obtain the device path.\n\nSpecifying an empty device path will result in the first available audio controller being used, and can be a convenient option to get UEFI audio working if only one audio controller is present.";
 
 /* AZW-9D-hq6 */
 "TT_AudioCodec" = "Type: plist integer\nFailsafe: 0\nDescription: Codec address on the specified audio controller for audio support. This typically contains the first audio codec address on the builtin analog audio controller (HDEF). Audio codec addresses, e.g. 2, can be found in the debug log: \nOCAU: 1/3 PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x1)/VenMsg(<redacted>,00000000) (4 outputs) \nOCAU: 2/3 PciRoot(0x0)/Pci(0x3,0x0)/VenMsg(<redacted>,00000000) (1 outputs)\nOCAU: 3/3 PciRoot(0x0)/Pci(0x1B,0x0)/VenMsg(<redacted>,02000000) (7 outputs)\n\nAs an alternative this value can be obtained from IOHDACodecDevice class in I/O Registry containing it in IOHDACodecAddress field.";
@@ -1560,6 +1560,9 @@
 /* UrW-oc-0Oc */
 "TT_AudioOut" = "Type: plist integer\nFailsafe: 0\nDescription: Index of the output port of the specified codec starting from 0.\n\nThis typically contains the index of the green out of the builtin analog audio controller (HDEF). The number of output nodes (N) in the debug log (marked in bold):\nOCAU: 1/3 PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x1)/VenMsg(<redacted>,00000000) (4 outputs)\nOCAU: 2/3 PciRoot(0x0)/Pci(0x3,0x0)/VenMsg(<redacted>,00000000) (1 outputs)\nOCAU: 3/3 PciRoot(0x0)/Pci(0x1B,0x0)/VenMsg(<redacted>,02000000) (7 outputs) \n\nThe quickest way to find the right port is to bruteforce the values from 0 to N - 1.";
 
+"TT_AudioOutMask" = "Type: plist integer\nFailsafe: -1\nDescription: Bit field indicating which output channels to use for UEFI sound.\n\nAudio mask is 1 « audio output (equivalently 2 ˆ audio output). E.g. for audio output 0 the bitmask is 1, for output 3 it is 8, and for outputs 0 and 3 it is 9.\n\nThe number of available output nodes (N) for each HDA codec is shown in the debug log (marked in bold-italic), audio outputs 0 to N - 1 may be selected:\nOCAU: 1/3 PciRoot(0x0)/Pci(0x1,0x0)/Pci(0x0,0x1)/VenMsg(<redacted>,00000000) (4 outputs)\nOCAU: 2/3 PciRoot(0x0)/Pci(0x3,0x0)/VenMsg(<redacted>,00000000) (1 outputs)\nOCAU: 3/3 PciRoot(0x0)/Pci(0x1B,0x0)/VenMsg(<redacted>,02000000) (7 outputs)\n\nWhen AudioDxe is used then additional information about each output channel is logged during driver binding, including the bitmask for each output. The bitmask values for the desired outputs should be added together to obtain the AudioOutMask value:\nHDA: | Port widget @ 0x9 is an output (pin defaults 0x2B4020) (bitmask 1)\nHDA: | Port widget @ 0xA is an output (pin defaults 0x90100112) (bitmask 2)\nHDA: | Port widget @ 0xB is an output (pin defaults 0x90100110) (bitmask 4)\nHDA: | Port widget @ 0x10 is an output (pin defaults 0x4BE030) (bitmask 8)\n\nFurther information on the available output channels may be found from a Linux codec dump using the command:
+cat /proc/asound/card{n}/codec#{m}\n\nUsing AudioOutMask, it is possible to play sound to more than one channel (e.g. main speaker plus bass speaker; headphones plus speakers) as long as all the chosen outputs support the sound file format in use; if any do not then no sound will play and a warning will be logged.\n\nWhen all available output channels on the codec support the available sound file format, then a value of -1 will play sound to all channels simultaneously. If this does not work, it will usually be quickest to try each available output channel one by one, in order to work out which channel(s) to use.";
+
 /* PF5-bc-9Z2 */
 "TT_MinimumVolume" = "Type: plist integer\nFailsafe: 0\nDescription: Minimal heard volume level from 0 to 100.\n\nThe screen reader will use this volume level when the calculated volume level is lower than MinimumVolume and the boot chime will not play if the calculated volume level is lower than MinimumVolume.";
 
@@ -1573,11 +1576,13 @@
 "TT_playchime" = "Type: plist string\nFailsafe: Auto\nDescription: Play chime sound at startup.\n\nEnabling this setting plays the boot chime using the builtin audio support. The volume level is determined by the MinimumVolume and VolumeAmplifier settings as well as the SystemAudioVolume NVRAM variable. Possible values include:\n• Auto — Enables chime when StartupMute NVRAM variable is not present or set to 00.\n• Enabled — Enables chime unconditionally.\n• Disabled — Disables chime unconditionally.\n\nNote: Enabled can be used in separate from StartupMute NVRAM variable to avoid conflicts when the firmware is able to play the boot chime.";
 
 /* 2zI-kW-5dk */
-"TT_AudioSupport" = "Type: plist boolean\nFailsafe: false\nDescription: Activate audio support by connecting to a backend driver.\n\nEnabling this setting routes audio playback from builtin protocols to a dedicated audio port (AudioOut) of the specified codec (AudioCodec) located on the audio controller (AudioDevice).";
+"TT_AudioSupport" = "Type: plist boolean\nFailsafe: false\nDescription: Activate audio support by connecting to a backend driver.\n\nEnabling this setting routes audio playback from builtin protocols to specified (AudioOutMask) dedicated audio ports of the specified codec (AudioCodec), located on the specified audio controller (AudioDevice).";
 
 /* 4mo-Ut-bYl */
 "TT_ResetTrafficClass" = "Type: plist boolean\nFailsafe: false\nDescription: Set HDA Traffic Class Select Register to TC0.\n\nAppleHDA kext will function correctly only if TCSEL register is configured to use TC0 traffic class. Refer to Intel I/O Controller Hub 9 (ICH9) Family Datasheet (or any other ICH datasheet) for more details about this register.\n\nNote: This option is independent from AudioSupport. If AppleALC is used it is preferred to use AppleALC alctsel property instead.";
 
+"TT_DisconnectHda" = "Type: plist boolean\nFailsafe: false\nDescription: Disconnect HDA controller before loading drivers.\n\nMay be required on some systems (e.g. Apple hardware, VMware Fusion guest) to allow a UEFI sound driver (such as AudioDxe) to take control of the audio hardware.";
+
 /* Drivers */
 /* 6zo-Jl-Ryl */
 "TT_uefi_driversTable" = "1. Path\nType: plist string\nFailsafe: Empty\nDescription: Path of file to be loaded as a UEFI driver from OC/Drivers directory.\n2. Enabled\nType: plist boolean\nFailsafe: false\nDescription: If false this driver entry will be ignored.\n3. Arguments\nType: plist string\nFailsafe: Empty\nDescription: Some OpenCore plugins accept optional additional arguments which may be specified as a string here.";

Russian Localization (ru)/Sections/uefiController.strings

@@ -14,6 +14,9 @@
 /* Class = "NSTextFieldCell"; title = "TimerResolution"; ObjectID = "3Ql-TM-Oiv"; */
 "3Ql-TM-Oiv.title" = "TimerResolution";
 
+/* Class = "NSButtonCell"; title = "DisconnectHda"; ObjectID = "3Sg-0T-21K"; */
+"3Sg-0T-21K.title" = "DisconnectHda";
+
 /* Class = "NSTableColumn"; headerCell.title = "Comment"; ObjectID = "4ew-tO-Ops"; */
 "4ew-tO-Ops.headerCell.title" = "Comment";
 
@@ -179,6 +182,9 @@
 /* Class = "NSButtonCell"; title = "AudioSupport"; ObjectID = "oT1-Q2-rhc"; */
 "oT1-Q2-rhc.title" = "AudioSupport";
 
+/* Class = "NSTextFieldCell"; title = "AudioOutMask"; ObjectID = "r2Q-7P-fO6"; */
+"r2Q-7P-fO6.title" = "AudioOutMask";
+
 /* Class = "NSTabViewItem"; label = "Input"; ObjectID = "tiX-oG-c7h"; */
 "tiX-oG-c7h.label" = "Input";