modfox/nib

# Nib **Nib** 是一款专为 **Cintiq Pro 24 Touch (model DTH2420)** 数位屏开发的独立、开源 macOS 驱动。它是从零开始构建的——通过净室逆向 工程——因为 Wacom 的驱动经常在新的 macOS 版本上出现故障。开发此驱动的具体原因是 Wacom 驱动 **在 macOS 27 开发者测试版上无法运行**，导致数位板无法使用。在 runtime 期间不依赖 OpenTabletDriver 或任何 厂商软件。 **目前可用的功能：** 触控笔（支持应用内校准的定位、可调节的压力曲线、 倾斜、可重新映射的侧键）、多点触控（双指滚动、轻点点击、三指 滑动、掌部抑制）、菜单栏应用和完整的偏好设置窗口，作为 持久化的用户级 LaunchAgent 运行。 ## 截图

应用内校准覆盖层——用触控笔点击两个十字准星： ## 目录结构 - `driver/` — Swift package（`nib` 可执行文件 + `NibCore` 库）。请参阅 `driver/README.md`（用法）和 `driver/INSTALL.md`（持久化安装 + 代码签名）。 - `spec/DTH2420-protocol.md` — 逆向工程得出的设备协议（USB ID、触控笔 报告 0x10、触摸报告 0x81、触控笔模式切换、触摸启用）——这是净室逆向工程的成果。 - `recon/` — 逆向工程发现和反编译笔记。 - `captures/` — 实时 HID 捕获（报告描述符）和 `hidinfo` 转储工具。 - `ROADMAP.md` — 计划工作和拓展想法。 ## 工作原理 1. `IOHIDManager` 打开触控笔（`056a:0351`）和触摸（`056a:0355`）HID 接口。 2. 连接时，它会发送启用/模式切换报告，将数位板置入其 原生高分辨率模式（在逆向工程期间恢复得出）。 3. 报告由纯 Swift 解析器解码（已通过真实捕获的报告进行单元测试）。 4. 输入通过 CoreGraphics 数位板事件（触控笔）和滚动/按键事件（触摸）注入—— 这是一条完全在用户态运行的路径，无需 kernel extension。 ## 安装 请参阅 `driver/INSTALL.md`。简而言之：构建（`swift build -c release`），将二进制文件封装在 `Nib.app` 中，对其进行签名，授予 Input Monitoring + Accessibility 权限，并加载 LaunchAgent。 ## 免责声明 / 商标 这是一个**独立的、非官方的**项目。它**不附属于、也未获得** Wacom Co., Ltd.** 的授权、赞助或认可。“Wacom”、“Cintiq”以及设备型号 编号是其各自所有者的商标，此处使用它们**仅用于标识** 本软件兼容的硬件**（指示性合理使用）。所有产品名称、 徽标和品牌均为其各自所有者的财产。 开发 Nib 是为了**互操作性**——让所有者已拥有的硬件能够在 macOS 上运行。它是通过对设备自身的协议和 行为进行净室文档记录而开发的；它不包含或重新分发任何厂商软件或资产。 ## 许可证 请参阅 `LICENSE`。

标签：HID, macOS驱动, Swift, Wacom, 云资产清单, 开源, 数位板, 逆向工程