HoRNDIS（Mac OS X 的 USB 联通驱动程序）技术文档

1. 安装指南

从源代码/二进制安装

• 获取安装包（下载 或从源代码构建安装包）
• 运行安装包

从 Homebrew 安装

brew cask install horndis
sudo kextload /Library/Extensions/HoRNDIS.kext

2. 项目使用说明

• 假设安装过程无误，安装完成后，请通过 USB 将手机连接到 Mac。
• 进入手机的设置菜单。
• 在“连接”部分，位于“Wi-Fi”和“蓝牙”下方：
  • 选择“更多...”
  • 选择“网络共享与便携式热点”
• 勾选“USB 网络共享”复选框。它应该会闪烁一次，然后变为实心勾选。

3. 项目API使用文档

本项目的 API 使用文档目前尚未提供。请参考项目主页和 GitHub 项目的 Wiki 获取更多信息。

4. 项目安装方式

构建源代码

• 使用 git clone 克隆仓库。
• 在克隆的目录中运行 xcodebuild，这应该足以构建 kext。
• 如果您希望打包，可以运行 make 以在 build/ 目录中组装包。

调试与开发笔记

本节包含一些开发和调试驱动程序的技巧和提示。

USB 设备信息

• Mac OS 系统菜单 -> 关于本机 -> 系统报告 -> 硬件/USB 显示 OS 认识的所有 USB 设备。不幸的是，它不会提供 USB 描述符。

lsusb -v 打印 USB 配置，例如接口和端点描述符。您可以打印所有设备的信息或将输出限制为特定的设备。要运行此命令，您需要安装 usbutils。

• Homebrew 用户：brew install mikhailai/misc/usbutils 请不要从 Homebrew Core 安装 lsusb 包，它是一个同名但不同的工具。
• Macports 用户：sudo port install usbutils

IO 注册表

ioreg -l -r -c IOUSBHostDevice 此命令列出所有 Mac OS IO 注册表信息，包括所有 USB 设备。与 lsusb 不同，ioreg 告诉您 Mac OS 如何识别 USB 设备和接口，以及如何将这些接口与驱动程序匹配。-r -c IOUSBHostDevice 限制输出到 USB 设备；要获取完整的 OS 注册表，请运行 ioreg -l。

OS 日志

LOG(....) 语句遍布 HoRNDIS 代码，调用 IOLog 函数。在 Mac OS El Capitan（10.11）及更早版本中，日志消息进入 /var/log/system.log。从 Sierra（10.12）开始，这些消息不再写入 system.log，而是可以通过以下方式查看：

• GUI，使用位于 实用工具 文件夹中的 Console 应用程序。您需要在搜索框中输入 process:kernel 以过滤相关消息。
• 命令行，使用 log 命令。例如： log show --predicate process==\"kernel\" --start "2018-12-11 22:54:00" 起始值需要设置在过去几分钟，以免控制台消息过多。以下是一个方便的命令，用于打印过去 3 分钟的消息： log show --predicate process==\"kernel\" --start "$(date -v-3M +'%F %T')"

观察到 Mac OS 日志在 Sierra 中不可靠。在某些情况下，消息可能显示为乱码（看起来像多线程代码错误）。在其他情况下，GUI 或命令行可能会缺少已发出的消息。有时，重新加载驱动程序可能会解决问题。