黑苹果 Catalina 15 声卡定制

说明

​ 使用黑苹果一段时间, 声卡驱动问题较多(如: 机箱前置扬声器无效), 本文总结网上一些定制方法, 简化操作。由于d对中间某些原理不是完全了解, 本方法定制的驱动在我的机器使用了几个月没有异常, 其他机器仅供参考,。水平有限，欢迎指出错误。

a). 定制流程步骤

b). 环境信息

• 系统 macOS Catalina 15.x
• AppleALC v1.4.3
• xcode(AppStore下载即可)
• python3.5或以上(安装XCode后默认会下载, 或去官网下载安装包)
• Clover Configurator
• PlistEdit Pro

一： Clover提取声卡codec

参见: https://blog.daliansky.net/Use-AppleALC-sound-card-to-drive-the-correct-posture-of-AppleHDA.html

a). 通过Linux提取

b). Clover引导界面按F8提取

c). 重命名文件名为codec.txt

二： 推导ConfigData & 节点路径

high-definition-audio-specification.pdf中178页有详细规范描述，可以参考

​ 按黑果小兵和简书上教程, 有些信息好像不必要(如: EAPD节点最后添加一个XXX70C02 & 修正configdata)

如果无效, 请手动修正configdata

verbit.sh分析Clover提取的codec一直报错& codecgraph一直没有安装成功，因此琢磨了自己的脚本, 不一定完全正确，但是有用就够了

https://blog.daliansky.net/Use-AppleALC-sound-card-to-drive-the-correct-posture-of-AppleHDA.html#more

https://www.jianshu.com/p/29a74f0664f1

a). 执行python3 verbit.py codec.txt 生成configdata

​ 脚本生成结果为markdown格式, 粘贴进在线markdown网站, 如:https://www.mdeditor.com/

​ 空格隔开每组数据, 因此本例中configdata为:

01471c10 01471d40 01471e01 01471f01 01871c20 01871d90 01871ea1 01871f01 01971c30 01971d90 01971ea1 01971f02 01a71c2f 01a71d30 01a71e81 01a71f01 01b71c50 01b71d40 01b71e21 01b71f02

b). 推导节点路径

​ 本脚本参考简书 https://www.jianshu.com/p/29a74f0664f1 手动推导原理 而写，简化操作

执行python3 FindNodePath.py codec.txt输入节点如: 0x14

在已选节点不重复的前提下，优先选择数字小(不知道是不是必须满足, 尽量找不一样的和短的)

节点	路径	十进制路径
0x14	0x14 → 0x0c → 0x02	20→12 → 2
0x18	0x09 → 0x22 → 0x18	9→ 34 → 24
0x19	0x08 → 0x23 → 0x19	8→ 35 → 25
0x1a	0x09 → 0x22 → 0x1a	9→ 34→ 26
0x1b	0x1b → 0x0d → 0x03	27→ 13→ 3

三： 修改AppleALC源码

我们只需要修改2个文件PinConfigs.kext/Contents/Info.plist(放configdata)和AppleALC-master/Resources/ALC892/PlatformsXX.xml(放节点路径信息), 但是额外两个文件信息来推导PlatformsXX.xml

a). 在AppleALC-master/Resources/PinConfigs.kext/Contents/Info.plist中修改congfigdata并找到要修改节点路径的文件

1. 根据codecID（codec.txt开头Vendor Id对应数据转换为10进制）搜索, 定位到第一个找到的位置

   记住该LayoutID的值 ，用来查找后面的文件

2. 定位到AppleALC-master/Resources/ALC892（你的声卡型号)/Info.plist

• 根据之前的LayoutID，在Files->Layouts下面找到ID值和之前LayoutID值一样的节点，记下Layout.xml的路径
• 根据之前的LayoutID，在Files->Platforms下面找到ID值和之前LayoutID值一样的节点，记下Platform.xml的路径

3. 根据上一步找到的layout1.xml记录下PathMapID

4. 根据步骤2中找到的Platform.xml和步骤3中的PathMapID定位到了我们要修改的节点路径地方了

b). 节点路径修改

• 大致位置顺序

• 输入和输出类详细

​ 输入类型的如麦克风第一个节点含有AMP，可以在原有配置上复制过来一个再修改数字就是了

​ 输出类型的如HeadPhone除第一个节点外其他都含有AMP，可以在原有配置上复制过来一个再修改数字就是了

c). 编译AppleALC， 并将结果放入EFI中Clover对应的目录

需要下载LiluDEBUG版本的 放入AppleALC目录

四： 在Colver中注入步骤三->a).->1.中得到的LayoutID

HDMI接口休眠再唤醒声卡驱动可能会导致系统死机, 可以用该补丁

636F6D2E 6170706C 65005F5F 6B65726E 656C5F5F 00替换为6E6F742E 6170706C 65005F5F 6B65726E 656C5F5F 00

五： 最终效果

节点路径不同分组和位置, 会影响最终的结果, 请按需求自己尝试放位置和组

六: 脚本源代码

FindNodePath.py

#!/usr/bin/python3
"""@Python:   Version 3.5@File:     FindNodePath.py@Author:   Leo@Date:     2019/11/8@license: BSD, see LICENSE for more details.@Desc:  根据codec.txt找到给定节点所有可能的正反向路径
"""import sys
import reclass Node(object):"""name: 节点字符串, 如: 0x14desc: 节点类型描述parent_list: 父节点对象列表，如: [<Node 1>, <Node 2>, ...]child_name_list: 子节点字符串列表, 如: ['0x13', '0x14', ...]child_obj_list: 子节点对象列表，如: [<Node 1>, <Node 2>, ...]"""def __init__(self, name, desc):self.name = nameself.desc = descself.parent_list = []self.child_name_list = []self.child_obj_list = []def add_parent(self, node):self.parent_list.append(node)def get_parent_paths(self):if len(self.parent_list) == 0:print('\033[33m节点: %s 未检索到父节点, 因此无反向路径\033[0m' % self.name)returnpaths = []def find_path(node, path):if node.name in path:   # 回路, 抛弃该路径returnpath.append(node.name)if len(node.parent_list) == 0:path.reverse()paths.append(path)returnfor parent in node.parent_list:_path_list_copy = list(path)find_path(parent, _path_list_copy)find_path(self, [])paths.sort(key=lambda x: len(x))    # 排序，最短的放前面打印print('\033[32m节点: %s 找到以下反向路径(输入类: 如mic, line in), 共 %d 条路径, 仅显示路径长度小等于4的路径' %(self.name, len(paths)))for _ in paths:if len(_) <= 4:print(' → '.join(_))print('\033[0m')def get_child_paths(self):if len(self.child_obj_list) == 0:print('\033[33m节点: %s 未检索到子节点, 因此无正向路径\033[0m' % self.name)returnpaths = []def find_path(node, path):if node.name in path:   # 回路, 抛弃该路径returnpath.append(node.name)if len(node.child_obj_list) == 0:paths.append(path)returnfor child in node.child_obj_list:_path_list_copy = list(path)find_path(child, _path_list_copy)find_path(self, [])paths.sort(key=lambda x: len(x))    # 排序，最短的放前面打印print('\033[32m节点: %s 找到以下正向路径(输出类, 如: Line Out, HeadPhone), 共 %d 条路径, 仅显示路径长度小等于4的路径' %(self.name, len(paths)))for _ in paths:if len(_) <= 4:     # 仅显示路径长度小等于4的路径print(' → '.join(_))print('\033[0m')def __repr__(self):return '<Node %s>' % self.namenodes = {}def init_nodes():"""读取codec.txt每行文本, 初始化节点对象, 并建立父子关系列表1. 找到有一个节点初始化一个节点对象放入 nodes 里, 如: {'0x14': <Node 0x14>}在每个节点段里面找到该节点连接的子节点信息, 并填充当前节点的子节点信息2. 所有节点都读取完毕, 遍历每一个节点, 根据该节点的子节点列表, 为每一个子节点列表中添加一个父节点(该节点自身):return: None"""try:f = open(sys.argv[1])except (IndexError, IOError):print('请提供正确的文件路径名!')f = None    # Bypass pycharm warning "Local variable 'f' might be referenced before assignment"exit(1)line = f.readline()current_node = Nonewhile line != '':match = re.match(r'Node (\w+) (\[.+\])', line, re.IGNORECASE)if match:current_node = Node(match.group(1).lower(), match.group(2))nodes[match.group(1)] = current_nodeprint('Debug: 找到节点 %s %s' % (current_node.name, current_node.desc))line = f.readline()continuematch = re.match(r'\s+Connection: \d+', line, re.IGNORECASE)if match:line = f.readline()if 'In-driver Connection' in line:  # HDMI codecline = f.readline()current_node.child_name_list = re.findall(r'\w+', line)print('\t\t节点 %s 下连接到以下节点 %s' % (current_node.name, ' '.join(current_node.child_name_list)))line = f.readline()continueline = f.readline()# 初始化各节点的子节点for node in nodes.values():for child_name in node.child_name_list:child_name = child_name.lower()child_node = nodes[child_name]node.child_obj_list.append(child_node)# 为子节点添加父节点child_node.add_parent(node)init_nodes()
_name = input('\n\033[33m请输入节点名称, 如0x10\033[0m\n:').lower()
try:_node = nodes[_name]_node.get_parent_paths()_node.get_child_paths()
except KeyError:print('找不到节点: %s , 节点名称输入是否有误?' % _name)exit(1)

verbit.py

#!/bin/python3
"""HackintoshTools verbit.py~~~~~@Description:整理提取到的codec.txt节点信息, 生成configdata参考: https://github.com/daliansky/Dell-Inspiron-7560-Hackintosh/blob/master/hda-tools/verbit.sh@CreateTime: 2019/12/16 8:15 下午@Author: leo@License: MIT
"""import os
import sys
import re
import tracebackBASE_DIR = os.path.dirname(__file__)
CODEC_TXT = ' '.join(sys.argv[1:])try:with open(CODEC_TXT, 'r') as f:content = f.read()NAME = re.findall(r'^Codec: (.+)$', content, re.MULTILINE)[0]ADDRESS = re.findall(r'Address: (\d+)$', content, re.MULTILINE)[0]
except IOError:print('ERROR: 打开codec文件失败, 路径: %s' % CODEC_TXT)exit(1)
except IndexError:print('ERROR: codec文件格式是否不正确?')exit(1)class Node(object):__slots__ = ['Jack', 'Color', 'Description', 'Node', 'PinDefault', 'Verbs']def __getattr__(self, item):if item == 'Verbs':return '%s%s71c%s %s%s71d%s %s%s71e%s %s%s71f%s' % (ADDRESS, self.Node, self.PinDefault[-2:],ADDRESS, self.Node, self.PinDefault[-4:-2],ADDRESS, self.Node, self.PinDefault[-6:-4],ADDRESS, self.Node, self.PinDefault[-8:-6])def init_nodes(text: str) -> [Node]:"""分析codec.txt, 提取有效节点信息(含有Jack, Color, ... 等信息的节点)a). 先将文本分割为以Node 0x...隔开的段, 并剔除不包含"Pin Default"的段Node 0x02 [Audio Output] wcaps 0x41d: Stereo Amp-Out...------------------------------------------------------Node  0x03 [Audio Output] wcaps 0x41d: Stereo Amp-Out...------------------------------------------------------b). 依次解析每个文本段, 并初始化Node对象, 放入一个列表中, 所有解析完毕, 返回该数组:param text: str , codec.txt 文本内容:return [Node<1>, Node<2>, ...]"""# 先添加一个特殊前缀'----------', 再切割, 以防止切割后Node 0x丢失text = re.sub(r'^Node 0x', '----------Node 0x', text, flags=re.MULTILINE)node_texts = re.split(r'----------', text)node_texts = [_ for _ in node_texts if 'Pin Default ' in _]node_list = []for node_text in node_texts:node = Node()try:node.Node = re.findall(r'^Node 0x(\w+) ', node_text, re.MULTILINE)[0]node.Jack = re.findall(r'Conn = (.+),', node_text)[0]node.Color = re.findall(r'Color = (\w+)', node_text)[0]node.PinDefault, node.Description = re.findall(r'Pin Default (\w+): (.+)$', node_text, re.MULTILINE)[0]if '[N/A]' in node.Description:print('WARN: 忽略无效节点信息: Node 0x%s\n%s' % (node.Node, node.Description))continueprint('INFO: 找到节点信息: Node 0x%s\n%s' % (node.Node, node.Description))node_list.append(node)except IndexError:print('ERROR: 搜索节点信息出错, 错误信息如下:\n%s\n 文本内容如下:\n%s' % (traceback.format_exc(), node_text))return node_listnodes = init_nodes(content)
markdwon = '|%s|\n|%s\n' % ('|'.join(Node.__slots__), ':---:|' * len(Node.__slots__))
for _node in nodes:markdwon += '|%s|%s|%s|0x%s|%s|%s|\n' % (_node.Jack, _node.Color, _node.Description,_node.Node, _node.PinDefault, _node.Verbs)
print('\n\n\n%s' % markdwon)