DFRDisplayKm 项目安装和配置指南

1. 项目基础介绍和主要的编程语言

项目介绍

DFRDisplayKm 是一个开源项目，旨在为 Windows 系统提供对 Apple Touch Bar（DFR）的支持。该项目通过实现自定义显示功能，使得 Apple Touch Bar 在 Windows 10 上能够正常工作。Touch Bar 是一个 USB 复合设备，具有两种配置，该项目主要针对第二种配置进行开发，以实现高级显示和输入功能。

主要编程语言

该项目主要使用以下编程语言：

• C
• C#
• C++

2. 项目使用的关键技术和框架

关键技术

• USB 复合设备驱动：该项目通过配置 USB 复合设备驱动栈，选择 Touch Bar 的第二种配置，以实现高级显示功能。
• HID 设备支持：Touch Bar 还包含一个 HID 兼容的触摸板（实际上是一个触摸屏），该项目也对其进行了支持。

框架

• Windows 10 Driver Kit (WDK)：用于开发和测试 Windows 驱动程序。
• Visual Studio 2019：用于编译和构建驱动程序。

3. 项目安装和配置的准备工作和详细的安装步骤

准备工作

1. 安装 Visual Studio 2019：确保已安装 Visual Studio 2019，并包含 C/C++ 工作负载。
2. 安装 Windows 10 Driver Kit (WDK)：版本需为 1903 或更高。
3. 关闭 Secure Boot：按照 Apple 知识库的说明关闭 Secure Boot。

详细安装步骤

步骤 1：克隆项目仓库

首先，从 GitHub 克隆 DFRDisplayKm 项目到本地：

git clone https://github.com/imbushuo/DFRDisplayKm.git

步骤 2：安装 DFRUsbCcgp.inf

1. 打开设备管理器。
2. 找到“Apple Touch Bar”设备。
3. 右键点击该设备，选择“更新驱动程序”。
4. 选择“浏览我的计算机以查找驱动程序软件”。
5. 选择“让我从计算机上的设备驱动程序列表中选取”。
6. 点击“从磁盘安装”，然后选择 DFRUsbCcgp.inf 文件。
7. 按照提示完成安装。

步骤 3：安装 DFRDisplayKm.inf

1. 在设备管理器中，找到“iBridge Display”设备。
2. 右键点击该设备，选择“更新驱动程序”。
3. 选择“浏览我的计算机以查找驱动程序软件”。
4. 选择“让我从计算机上的设备驱动程序列表中选取”。
5. 点击“从磁盘安装”，然后选择 DFRDisplayKm.inf 文件。
6. 按照提示完成安装。

步骤 4：编译和构建驱动程序

1. 打开 Visual Studio 2019。
2. 打开 DFRDisplayKm 项目文件（DFRDisplayKm.sln）。
3. 选择“生成”菜单，然后选择“生成解决方案”。
4. 确保编译过程无误，生成驱动程序文件。

步骤 5：测试和验证

1. 重启计算机，确保驱动程序正常加载。
2. 使用 DFRDisplayUm.Utility.Console 示例应用程序测试 Touch Bar 的功能。

注意事项

• 该项目目前仅确认支持基于 Apple T2 的 MacBook Pro，T1 支持已添加但尚未测试。
• 如果驱动程序在 T2 冷启动时无法加载，请重启计算机一次。

通过以上步骤，您应该能够成功安装和配置 DFRDisplayKm 项目，使得 Apple Touch Bar 在 Windows 10 上正常工作。