WhateverGreen项目：AMD显卡在macOS中的常见问题与解决方案指南

一、项目简介与适用场景

WhateverGreen是针对macOS系统的内核扩展(kext)，专门用于优化AMD/ATI显卡在macOS系统中的兼容性和性能表现。该项目主要解决以下问题：

• 自动修正显卡初始化参数
• 优化多显示器支持
• 修复睡眠/唤醒问题
• 提供高级显卡配置选项

适用显卡范围：AMD 5000系列及更新的显卡（包括Radeon RX系列），建议在macOS 10.11及以上版本使用。

二、调试与日志获取

当遇到显卡问题时，获取详细日志是诊断的第一步：

1. 使用DEBUG版本的WhateverGreen和Lilu
2. 在启动参数中添加-wegdbg -liludbg
3. 系统启动后，在终端执行以下命令获取日志：

# macOS 10.12及以上版本
log show --predicate 'process == "kernel" AND (eventMessage CONTAINS "WhateverGreen" OR eventMessage CONTAINS "Lilu")' --style syslog --source

# macOS 10.11及更早版本
cat /var/log/system.log | egrep '(WhateverGreen|Lilu)'

如果显卡问题导致无法显示，可通过SSH连接获取日志，并检查kextstat输出。

三、硬件要求与UEFI支持

WhateverGreen对硬件环境有特定要求：

1. UEFI要求：必须使用纯UEFI环境，禁用CSM（兼容性支持模块）
2. 显卡固件：建议刷写支持UEFI的显卡BIOS
   • 未刷新的显卡可能导致多显示器问题
   • 单显示器配置也可能出现兼容性问题
3. 多显卡配置：使用2块及以上显卡时，多显示器配置可能存在问题

四、关键配置指南

4.1 帧缓冲区配置

重要原则：绝对不要使用命名帧缓冲区（如Baladi、Futomaki等），这会禁用自动配置功能，导致显卡工作异常。

4.2 连接器(Connector)配置

大多数情况下，系统能自动检测连接器配置。但在以下情况需要手动配置：

1. 自动修正：对于R9 290/290X等显卡，可使用-raddvi启动参数
2. 手动配置：
   • 通过SSDT为显卡控制器添加connectors属性
   • 可指定24字节或16字节格式的连接器数据
   • 如需更改连接器数量，需同时设置connector-count属性

4.3 显示器优先级设置

对于7000系列显卡，可通过connector-priority属性设置显示器优先级：

1. 在详细日志中查看sense id
2. 按优先级顺序列出sense id
3. 此设置特别有助于解决多显示器配置下的黑屏问题

4.4 基本属性注入

显卡初始化所需的最小属性集：

• 在显卡控制器中添加HDAU设备
• 添加hda-gfx属性（数值对应音频编解码器数量）
• 可选装饰性属性：
  • AAPL,slot-name：在系统信息中显示插槽名称
  • @X,AAPL,boot-display：改善启动LOGO显示
  • model：指定显卡型号名称

五、移动版显卡特殊配置

移动版AMD显卡（非可切换显卡架构）需要额外配置：

1. 基本要求：
   • 注入64KB的显卡BIOS（ATY,bin_image属性）
2. 内置显示器：
   • 注入EDID（AAPL00,override-no-connect）
   • 设置6位色彩通道（@0,display-link-component-bits和@0,display-pixel-component-bits）
3. 高分辨率支持：
   • 对于1600x900以上分辨率，设置@0,display-dual-link为1

六、高级调优配置

6.1 显卡参数调整

可通过以下前缀自定义显卡参数：

• CFG,：调整aty_config参数
• PP,：调整aty_properties参数
• CAIL,：调整cail_properties参数

例如，要修改CFG_FB_LIMIT参数，需设置CFG,CFG_FB_LIMIT属性。

6.2 电源管理配置

radpg启动参数用于特定显卡的电源管理：

• 替代Verde.kext的功能（必须移除Verde.kext）
• 参数值为位掩码，控制不同电源门控功能
• 从1.0.3版本开始，可通过CAIL,CAIL_Disable...属性单独配置

6.3 工作负载策略

通过PP,PP_WorkLoadPolicyMask配置性能优化策略：

• 0x01：默认工作负载
• 0x02：全屏3D工作负载
• 0x04：节能工作负载
• 0x08：视频工作负载
• 0x10：VR工作负载
• 0x20：计算工作负载
• 0x40：自定义工作负载

七、常见问题解决方案

7.1 显示器唤醒问题

• 多次按键唤醒：尝试添加darkwake=0启动参数
• DP显示器不唤醒：尝试禁用AGDC（设置CFG,CFG_USE_AGDC为00）

7.2 色彩深度问题

• 30位色问题：添加-rad24强制使用24位色彩输出

7.3 HDMI音频问题

• 基本修复：通常由AppleALC自动处理
• 多显卡配置：需要手动设置hda-gfx和layout-id
• 禁用自动修复：使用-radnoaudio或设置no-audio-autofix属性

7.4 SMU固件加载

对于X5000及更新显卡，强制加载SMU固件的方法：

• 设置ATY,EFIVersion属性（任意值）
• 或设置Force_Load_FalconSMUFW为01

八、性能与兼容性说明

1. 显卡名称：系统可能显示通用名称（如"AMD Radeon HD 6xxx"），这是正常现象
2. OpenCL/OpenGL引擎：显示"Prototype"是正常现象，不影响性能
3. 硬件解码：建议使用核显进行视频解码
4. 启动时间：正常初始化应不超过30秒，长时间启动可能表示初始化问题

九、版本信息解读

WhateverGreen的EFI驱动版本格式示例：WEAD-102-2017-08-03

• 第一个字母：W表示WhateverGreen
• 第二个字母：E表示自动帧缓冲区
• 第三个字母：A表示DEBUG版本（R表示RELEASE）
• 数字部分：1.0.2表示版本号
• 日期：编译日期（2017年8月3日）

通过本文介绍的各种配置方法和问题解决方案，用户应能解决大多数AMD显卡在macOS中的兼容性问题，并获得最佳的性能表现。