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. 项目安装和配置的准备工作和详细的安装步骤
准备工作
- 安装 Visual Studio 2019:确保已安装 Visual Studio 2019,并包含 C/C++ 工作负载。
- 安装 Windows 10 Driver Kit (WDK):版本需为 1903 或更高。
- 关闭 Secure Boot:按照 Apple 知识库的说明关闭 Secure Boot。
详细安装步骤
步骤 1:克隆项目仓库
首先,从 GitHub 克隆 DFRDisplayKm 项目到本地:
git clone https://github.com/imbushuo/DFRDisplayKm.git
步骤 2:安装 DFRUsbCcgp.inf
- 打开设备管理器。
- 找到“Apple Touch Bar”设备。
- 右键点击该设备,选择“更新驱动程序”。
- 选择“浏览我的计算机以查找驱动程序软件”。
- 选择“让我从计算机上的设备驱动程序列表中选取”。
- 点击“从磁盘安装”,然后选择 DFRUsbCcgp.inf 文件。
- 按照提示完成安装。
步骤 3:安装 DFRDisplayKm.inf
- 在设备管理器中,找到“iBridge Display”设备。
- 右键点击该设备,选择“更新驱动程序”。
- 选择“浏览我的计算机以查找驱动程序软件”。
- 选择“让我从计算机上的设备驱动程序列表中选取”。
- 点击“从磁盘安装”,然后选择 DFRDisplayKm.inf 文件。
- 按照提示完成安装。
步骤 4:编译和构建驱动程序
- 打开 Visual Studio 2019。
- 打开 DFRDisplayKm 项目文件(DFRDisplayKm.sln)。
- 选择“生成”菜单,然后选择“生成解决方案”。
- 确保编译过程无误,生成驱动程序文件。
步骤 5:测试和验证
- 重启计算机,确保驱动程序正常加载。
- 使用 DFRDisplayUm.Utility.Console 示例应用程序测试 Touch Bar 的功能。
注意事项
- 该项目目前仅确认支持基于 Apple T2 的 MacBook Pro,T1 支持已添加但尚未测试。
- 如果驱动程序在 T2 冷启动时无法加载,请重启计算机一次。
通过以上步骤,您应该能够成功安装和配置 DFRDisplayKm 项目,使得 Apple Touch Bar 在 Windows 10 上正常工作。