Skip to content

Latest commit

 

History

History
119 lines (88 loc) · 3.33 KB

README.md

File metadata and controls

119 lines (88 loc) · 3.33 KB
Raw

ACPI定制USB端口

描述

  • 本方法通过修改 ACPI 文件实现USB端口的定制。
  • 本方法操作过程需要 drop 某个 ACPI 文件。通常情况下，OpenCore 不建议 这样做，定制 USB 端口一般使用 Hackintool.app 工具。
  • 本方法献给爱好者们。

适用范围

  • XHC 以及它的 _UPC 存在于单独的 ACPI 文件中
  • 此方法不适用于 _UPC 存在于 DSDT 中的设备 (e.g. 华硕)

_UPC 规范

_UPC, Package ()
{
    xxxx,
    yyyy,
    0x00,
    0x00
}

解释

  1. xxxx

    • 0x00 代表这个端口不存在
    • 其他值 (通常为 0x0F) 代表这个端口存在

  2. yyyy

    yyyy 处定义的是端口的类型, 参考下表

    yyyy 端口类型
    0x00 USB Type A
    0x01 USB Mini-AB
    0x02 USB 智能卡
    0x03 USB 3 标准 Type A
    0x04 USB 3 标准 Type B
    0x05 USB 3 Micro-B
    0x06 USB 3 Micro-AB
    0x07 USB 3 Power-B
    0x08 USB Type C (只有 USB 2)
    0x09 USB Type C (带有转向器)
    0x0A USB Type C (不带转向器)
    0xFF 内置

    如果 USB-C 正反两面插入在 Hackintool 都显示为同一个端口就说明这个端口有转向器

    反之，如果正反两面占用了两个端口就说明没有转向器

USB定制过程

  • 清除其他定制方法的补丁、驱动等。

  • drop ACPI文件

    • 确认 XHC 并包括 _UPC 的 ACPI 文件

      如 dell5480 的 SSDT-2-xh_OEMBD.aml

      如 小新 PRO13（i5）的 SSDT-8-CB-01.aml （无独显机器是 SSDT-6-CB-01.aml ）

    • config\ACPI\Delete\ 以 TableLength （十进制）和 TableSignature 方式 drop ACPI 文件。如：

      dell5480： TableLength = 2001， TableSignature = 53534454（SSDT）

      小新PRO13（i5）： TableLength = 12565， TableSignature = 53534454（SSDT）

      TableLength可以从该aml文件的表头处Length中得到。

  • 定制 SSDT 补丁文件

    • 将需要 drop 的原始 ACPI 文件拖到桌面，建议：

      • 另存为 .asl / .dsl 格式
      • 修改文件名。如： SSDT-xh_OEMBD_XHC.dsl, SSDT-CB-01_XHC.dsl
      • 修改文件内的 OEM Table ID 为自己喜欢的名字。
      • 排除错误。

    • SSDT 文件中所有端口的 _UPC 最前端添加以下代码：

      Method (_UPC, 0, NotSerialized)
{
    If (_OSI ("Darwin"))
    {
        Return (Package ()
        {
            xxxx,
            yyyy,
            0x00,
            0x00
        })
    }
    /* 以下是原内容 */
    ...
}

    • 根据 _UPC 规范定制 USB 端口。即，修正 xxxx、yyyy 的值。

      • 如果端口不存在
        • xxxx = 0x00
        • yyyy = 0x00
      • 如果端口存在
        • xxxx = 0xFF
        • yyyy

      参考上文的表格

    • 排错、编译、补丁文件放至 ACPI 、添加补丁列表。

参考示例

  • SSDT-xh_OEMBD_XHC
  • SSDT-CB-01_XHC