当前位置：首页 > news >正文

Griffin PowerMate 驱动程序：让旧设备重焕生机，操作简单功能多！

news 2026/5/13 18:07:47

导航菜单

切换导航
[ ](/)
[ 登录 ](/login?return_to=https%3A%2F%2Fgithub.com%2Fjameslockman%2FGriffin-PowerMate-Driver)
外观设置

平台

- **AI 代码创作**
- [GitHub Copilot：借助 AI 编写更优质代码](https://github.com/features/copilot)
- [GitHub Spark：构建并部署智能应用](https://github.com/features/spark)
- [GitHub Models：管理并比较提示词](https://github.com/features/models)
- [MCP Registry（新）：集成外部工具](https://github.com/mcp)
- **开发者工作流**
- [Actions：自动化任何工作流](https://github.com/features/actions)
- [Codespaces：即时开发环境](https://github.com/features/codespaces)
- [Issues：规划并跟踪工作](https://github.com/features/issues)
- [Code Review：管理代码变更](https://github.com/features/code-review)
- **应用安全**
- [GitHub Advanced Security：发现并修复漏洞](https://github.com/security/advanced-security)
- [代码安全：在构建过程中保障代码安全](https://github.com/security/advanced-security/code-security)
- [密钥保护：防患于未然，阻止信息泄露](https://github.com/security/advanced-security/secret-protection)
- **探索**
- [为何选择 GitHub](https://github.com/why-github)
- [文档](https://docs.github.com)
- [博客](https://github.blog)
- [更新日志](https://github.blog/changelog)
- [市场](https://github.com/marketplace)
[查看所有功能](https://github.com/features)

解决方案

- **按公司规模划分**
- [企业](https://github.com/enterprise)
- [中小企业团队](https://github.com/team)
- [初创企业](https://github.com/enterprise/startups)
- [非营利组织](https://github.com/solutions/industry/nonprofits)
- **按用例划分**
- [应用现代化](https://github.com/solutions/use-case/app-modernization)
- [DevSecOps](https://github.com/solutions/use-case/devsecops)
- [DevOps](https://github.com/solutions/use-case/devops)
- [CI/CD](https://github.com/solutions/use-case/ci-cd)
- [查看所有用例](https://github.com/solutions/use-case)
- **按行业划分**
- [医疗保健](https://github.com/solutions/industry/healthcare)
- [金融服务](https://github.com/solutions/industry/financial-services)
- [制造业](https://github.com/solutions/industry/manufacturing)
- [政府部门](https://github.com/solutions/industry/government)
- [查看所有行业](https://github.com/solutions/industry)
[查看所有解决方案](https://github.com/solutions)

资源

- **按主题探索**
- [AI](https://github.com/resources/articles?topic=ai)
- [软件开发](https://github.com/resources/articles?topic=software-development)
- [DevOps](https://github.com/resources/articles?topic=devops)
- [安全](https://github.com/resources/articles?topic=security)
- [查看所有主题](https://github.com/resources/articles)
- **按类型探索**
- [客户案例](https://github.com/customer-stories)
- [活动与网络研讨会](https://github.com/resources/events)
- [电子书与报告](https://github.com/resources/whitepapers)
- [商业洞察](https://github.com/solutions/executive-insights)
- [GitHub Skills](https://skills.github.com)
- **支持与服务**
- [文档](https://docs.github.com)
- [客户支持](https://support.github.com)
- [社区论坛](https://github.com/orgs/community/discussions)
- [信任中心](https://github.com/trust-center)
- [合作伙伴](https://github.com/partners)
[查看所有资源](https://github.com/resources)

开源

- **社区**
- [GitHub Sponsors：资助开源开发者](https://github.com/sponsors)
- **项目**
- [Security Lab](https://securitylab.github.com)
- [Maintainer Community](https://maintainers.github.com)
- [Accelerator](https://github.com/accelerator)
- [GitHub Stars](https://stars.github.com)
- [Archive Program](https://archiveprogram.github.com)
- **仓库**
- [主题](https://github.com/topics)
- [热门趋势](https://github.com/trending)
- [合集](https://github.com/collections)

企业

- **企业解决方案**
- [企业平台：由 AI 驱动的开发者平台](https://github.com/enterprise)
- **可用附加组件**
- [GitHub Advanced Security：企业级安全功能](https://github.com/security/advanced-security)
- [Copilot for Business：企业级 AI 功能](https://github.com/features/copilot/copilot-business)
- [高级支持：企业级 24/7 支持](https://github.com/premium-support)
[定价](https://github.com/pricing)

搜索或跳转...

搜索代码、仓库、用户、问题、拉取请求...
搜索
清除
[搜索语法提示](https://docs.github.com/search-github/github-code-search/understanding-github-code-search-syntax)

提供反馈

我们会阅读每一条反馈，并认真对待您的意见。
包含我的电子邮件地址，以便我们与您联系
取消提交反馈

保存的搜索

使用保存的搜索可以更快地筛选结果
| 名称 | 查询 |
| --- | --- |
要查看所有可用的限定符，请参阅我们的[文档](https://docs.github.com/search-github/github-code-search/understanding-github-code-search-syntax)。
取消创建保存的搜索
[ 登录 ](/login?return_to=https%3A%2F%2Fgithub.com%2Fjameslockman%2FGriffin-PowerMate-Driver)
[ 注册 ](/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E&source=header-repo&source_repo=jameslockman%2FGriffin-PowerMate-Driver)
外观设置

重置焦点

您在另一个标签页或窗口中登录了。[重新加载]()以刷新您的会话。
您在另一个标签页或窗口中注销了。[重新加载]()以刷新您的会话。
您在另一个标签页或窗口中切换了账户。[重新加载]()以刷新您的会话。关闭提醒
{{ message }}
[ jameslockman ](/jameslockman) / **[Griffin-PowerMate-Driver](/jameslockman/Griffin-PowerMate-Driver) ** 公开
- [ 通知 ](/login?return_to=%2Fjameslockman%2FGriffin-PowerMate-Driver) 您必须登录才能更改通知设置
- [ 派生 1 ](/login?return_to=%2Fjameslockman%2FGriffin-PowerMate-Driver)
- [ 加星 17 ](/login?return_to=%2Fjameslockman%2FGriffin-PowerMate-Driver)
- [ 代码 ](/jameslockman/Griffin-PowerMate-Driver)
- [ 问题 0 ](/jameslockman/Griffin-PowerMate-Driver/issues)
- [ 拉取请求 0 ](/jameslockman/Griffin-PowerMate-Driver/pulls)
- [ 操作 ](/jameslockman/Griffin-PowerMate-Driver/actions)
- [ 项目 ](/jameslockman/Griffin-PowerMate-Driver/projects)
- [ 安全与质量 0 ](/jameslockman/Griffin-PowerMate-Driver/security)
- [ 洞察 ](/jameslockman/Griffin-PowerMate-Driver/pulse)

其他导航选项

- [ 代码 ](/jameslockman/Griffin-PowerMate-Driver)
- [ 问题 ](/jameslockman/Griffin-PowerMate-Driver/issues)
- [ 拉取请求 ](/jameslockman/Griffin-PowerMate-Driver/pulls)
- [ 操作 ](/jameslockman/Griffin-PowerMate-Driver/actions)
- [ 项目 ](/jameslockman/Griffin-PowerMate-Driver/projects)
- [ 安全与质量 ](/jameslockman/Griffin-PowerMate-Driver/security)
- [ 洞察 ](/jameslockman/Griffin-PowerMate-Driver/pulse)
[](/jameslockman/Griffin-PowerMate-Driver)

jameslockman/Griffin-PowerMate-Driver

主分支
[分支](/jameslockman/Griffin-PowerMate-Driver/branches)[标签](/jameslockman/Griffin-PowerMate-Driver/tags)
[](/jameslockman/Griffin-PowerMate-Driver/branches)[](/jameslockman/Griffin-PowerMate-Driver/tags)
转到文件
代码
打开更多操作菜单

文件夹和文件

| 名称 | 名称 | 最后提交消息 | 最后提交日期 |
| --- | --- | --- | --- |

仓库文件导航

- **README**

适用于现代 macOS 的 Griffin PowerMate 驱动程序

曾经精巧的Griffin PowerMate设备，在这个小型驱动程序的助力下，得以重新发挥作用。PowerMate其实很简单，就是一个能旋转或按压的旋钮，其底座还有个蓝色LED灯，亮度会随操作变化。
该设备刚推出时，是为视频和音频制作服务的，给桌面增添了一个可滚动的旋钮。虽说如今有很多功能更强大的现代控制器，但这个早期设备有着独特魅力。
安装驱动程序很容易，打开DMG文件，把 **PowerMate Agent** 拖到“应用程序”文件夹，再启动 **PowerMate Agent** 就行。当然，得先找出PowerMate设备，不然它可没反应。之后，你会在顶部菜单看到新选项，能控制PowerMate的行为。[点击查看截图](https://private-user-images.githubusercontent.com/2659225/590104295-31c29dd7-36f1-418b-98ec-e4cdc850e932.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3Nzg1NDYxMDcsIm5iZiI6MTc3ODU0NTgwNywicGF0aCI6Ii8yNjU5MjI1LzU5MDEwNDI5NS0zMWMyOWRkNy0zNmYxLTQxOGItOThlYy1lNGNkYzg1MGU5MzIucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI2MDUxMiUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNjA1MTJUMDAzMDA3WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9MjdhNDBjNDg4NGQ4ZTUwYmQ0MDk2ZGY1ZDgwYzhhZWZmYzIwZDYyNmZkMjk5NGUyZWE4MGI3ZGFhYzFiMWY4YiZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmcmVzcG9uc2UtY29udGVudC10eXBlPWltYWdlJTJGcG5nIn0.hVot9_J9_GhgXrmTMbBOyf6v27i0FWqV73_JNsNLiio)
PowerMate能当滚动控制设备用。要是活动窗口或控件支持滚动，转动旋钮就能滚动窗口或增减所选值。要是不喜欢默认滚动方向，还能反转。
它也能当作鼠标按钮。短按相当于鼠标左键点击，长按相当于鼠标右键点击，也能把长按设置为双击。
是不是挺简单？

技术细节

这是个小型的macOS驱动程序，它通过USB HID打开 **Griffin PowerMate**（厂商 ID `0x077d`，产品 ID `0x0410`），读取其6字节的报告，还能暴露 **按钮** 和 **旋转** 事件，这样就能把这些事件映射到各种操作，像滚动、点击、媒体键等。
该设备会在总线上报告信息，但在macOS系统中默认没反应。这个库会“占用”该设备，并把事件传递给应用程序。

报告格式（来自设备）

- **第0字节**：按钮状态 — `0` 表示释放，`1` 表示按下。
- **第1字节**：旋转增量 — 有符号值；正数表示顺时针旋转，负数表示逆时针旋转（通常每个报告的取值范围为 ±1 到 ±7）。设备不会直接报告旋转速度，驱动程序会根据报告之间的时间间隔来计算 **旋转速率**（每秒的增量）。

构建并运行

```bash
cd /path/to/USB
swift build
swift run PowerMateDemo
```
插入PowerMate设备后，转动旋钮或按下按钮，演示程序会打印出相应的事件。按Ctrl+C停止程序。

系统级驱动程序（PowerMate Agent）

**PowerMateAgent** 能将旋钮和按钮操作转换为键盘/滚动事件，供 **任何应用程序**（如浏览器、编辑器等）接收：
- **旋转** → 垂直滚动，或者当菜单（或子菜单）处于焦点状态时，相当于按下 **上/下箭头键**。
- **点击（短按）** → **鼠标左键**（在光标位置），或者当菜单处于焦点状态时，相当于按下 **回车键**（选择高亮显示的项目）。
- **长按** → **鼠标右键**（在光标位置）。
菜单和子菜单的检测使用了 **辅助功能** API：当焦点所在的UI元素是菜单（包括子菜单）时，旋转操作会发送箭头键，点击操作会发送回车键。你需要在“系统设置”→“隐私与安全”中授予 **辅助功能** 权限，这样子菜单才能正常滚动，不会出现卡顿。如果未启用辅助功能，长按操作仍会进入一种备用的“菜单模式”（发送箭头键，直到点击或5秒超时）。
LED灯会在你转动旋钮时闪烁，闲置时变暗，按下按钮时则全亮。
```bash
swift run PowerMateAgent
```
首次运行时，macOS会提示你授予 **输入监控** 权限。你需要在“系统设置”→“隐私与安全”→“输入监控”中授予该权限，并添加（或启用）终端或已构建的可执行文件，然后再次运行该代理程序。
若要在后台运行：可以使用 `swift run PowerMateAgent &` 命令，或者运行已构建的二进制文件 `./.build/debug/PowerMateAgent`。如果你希望该程序在登录时自动启动，可以将其添加到“登录项”中。
若要创建一个 **签名并经过公证的应用程序**（或安装程序），以便他人在使用时不会收到安全警告，请参阅 **[DISTRIBUTION.md](/jameslockman/Griffin-PowerMate-Driver/blob/main/DISTRIBUTION.md)**。你需要拥有一个Apple Developer账户，用户在首次使用该设备时仍需授予输入监控（或辅助功能）权限。

在你的应用程序中使用

##### 1. 添加包
在你的应用程序的 `Package.swift` 文件中（或者在Xcode中，选择“文件”→“添加包依赖项”）：
```swift
dependencies: [
.package(path: "/path/to/USB"), // 或者使用你的克隆 URL
],
targets: [
.target(name: "YourApp", dependencies: ["PowerMateDriver"]),
]
```
##### 2. 启动驱动程序并映射事件
```swift
import PowerMateDriver

let driver = PowerMateDriver()

// 可选：使用闭包进行简单的映射
driver.onRotate = { delta, rate in
// delta > 0 表示顺时针旋转，delta < 0 表示逆时针旋转
// rate 表示每秒的增量（首次报告时为 nil）；可用于基于速度的映射
// 例如，滚动操作：CGEventCreateScrollWheelEvent(..., delta * lineHeight)
}
driver.onButtonDown = { /* 例如，模拟点击或切换操作 */ }
driver.onButtonUp = { }

// 或者使用委托处理所有事件
driver.delegate = self // 实现 PowerMateDriverDelegate

driver.start()
// 保持运行循环（例如，应用程序的主线程）
```
##### 3. 事件类型
- **`PowerMateEvent.buttonDown`** / **`buttonUp`** — 旋钮按下/释放。
- **`PowerMateEvent.buttonClick`** — 短按并释放（按下时间小于 `longPressThreshold`）。
- **`PowerMateEvent.buttonLongPress`** — 按下并保持至少 `longPressThreshold` 时间，然后释放。
- **`PowerMateEvent.rotate(delta: Int, rate: Double?)`** — `delta` 是有符号的步数（例如 +1、-2）；`rate` 是计算得出的旋转速度，单位为每秒的增量（首次报告时为 nil）。
你可以设置 **`longPressThreshold`**（默认值为 0.4 秒）来调整长按的判定标准。使用 **`onClick`** 和 **`onLongPress`**（或委托）来分别处理不同的事件。
使用 `driver.isConnected` 可以检查设备当前是否已连接。

LED（底座的蓝色灯光）

底座的蓝色LED灯可用于反馈信息。只有在设备已连接（`isConnected == true`）时才能控制该灯。
- **`setLEDBrightness(_ value: UInt8)`** — 设置静态亮度，取值范围为 0 - 255（0 表示关闭）。
- **`setLEDPulseAsleep(_ on: Bool)`** / **`setLEDPulseAwake(_ on: Bool)`** — 开启或关闭设备“休眠”或“唤醒”时的内置闪烁效果。
- **`setLEDPulseMode(table:op:arg:)`** — 自定义闪烁模式：`table` 取值范围为 0 - 2，`op` 取值为 0 表示较慢，1 表示正常，2 表示较快，`arg` 取值范围为 1 - 255（适用于 `op` 为 0 或 2 的情况）。
LED命令使用USB厂商控制请求（与Linux驱动程序使用相同的协议）。如果命令成功发送，这些命令将返回 `true`。如果USB设备正忙（例如，另一个进程已打开该设备），LED调用可能会失败。

映射到系统操作

- **滚动**：在 `onRotate` 事件中，创建一个滚动轮 `CGEvent`（例如 `CGEventCreateScrollWheelEvent`）并发送，或者将增量值应用到你自己的滚动逻辑中。
- **点击**：在 `onButtonDown` / `onButtonUp` 事件中，创建并发送一个鼠标点击 `CGEvent`，或者调用你自己的点击处理程序。
- **媒体/其他**：将 `onRotate` 和 `onButtonDown` 事件映射到你需要的操作（例如，音量控制、按键等效操作）。
发送事件可能需要在“系统设置”→“隐私与安全”中为你的应用程序授予 **输入监控**（或 **辅助功能**）权限。

如果设备无响应

1. **拔下并重新插入** PowerMate设备，然后再次运行你的应用程序。
2. **关闭** 可能正在使用PowerMate的其他软件（例如，旧版的PowerMate应用程序）。
3. 该驱动程序使用 `kIOHIDOptionsTypeSeizeDevice` 来独占设备访问权限，因此同一时间只能有一个进程使用该设备。

要求

- macOS 13 及以上版本
- Swift 5.9 及以上版本

参考资料

- [Linux PowerMate 驱动程序](https://gitlab.eclipse.org/eclipse/oniro-core/linux/-/blob/master/drivers/input/misc/powermate.c)（报告格式：第 0 字节为按钮状态，第 1 字节为旋转状态）
- [在 Linux 上复活 Griffin PowerMate](https://www.gilesorr.com/blog/powermate-on-linux.html)
- Apple IOKit HID：`IOHIDManager`、`IOHIDDeviceOpen`、`IOHIDDeviceRegisterInputReportCallback`

关于

未提供描述、网站或主题信息。

资源

Readme

哎呀！

加载时出现错误。[请重新加载此页面]()
[ 活动](/jameslockman/Griffin-PowerMate-Driver/activity)

加星

[ **17** 颗星](/jameslockman/Griffin-PowerMate-Driver/stargazers)

关注者

[ **1** 位关注者](/jameslockman/Griffin-PowerMate-Driver/watchers)

派生

[ **1** 次派生](/jameslockman/Griffin-PowerMate-Driver/forks)
[ 举报仓库 ](/contact/report-content?content_url=https%3A%2F%2Fgithub.com%2Fjameslockman%2FGriffin-PowerMate-Driver&report=jameslockman+%28user%29)

[发布 1](/jameslockman/Griffin-PowerMate-Driver/releases)

[ 适用于现代 macOS 的 Griffin PowerMate 驱动程序最新版本 2026 年 5 月 10 日 ](/jameslockman/Griffin-PowerMate-Driver/releases/tag/1.0.0)

[包 0](/users/jameslockman/packages?repo_name=Griffin-PowerMate-Driver)

哎呀！
加载时出现错误。[请重新加载此页面]()

[贡献者](/jameslockman/Griffin-PowerMate-Driver/graphs/contributors)

* * *
哎呀！
加载时出现错误。[请重新加载此页面]()

语言

- [ Swift 66.2% ](/jameslockman/Griffin-PowerMate-Driver/search?l=swift)
- [ Shell 21.4% ](/jameslockman/Griffin-PowerMate-Driver/search?l=shell)
- [ C 12.4% ](/jameslockman/Griffin-PowerMate-Driver/search?l=c)

页脚

[ ](https://github.com) © 2026 GitHub, Inc.
页脚导航
- [条款](https://docs.github.com/site-policy/github-terms/github-terms-of-service)
- [隐私](https://docs.github.com/site-policy/privacy-policies/github-privacy-statement)
- [安全](https://github.com/security)
- [状态](https://www.githubstatus.com/)
- [社区](https://github.community/)
- [文档](https://docs.github.com/)
- [联系我们](https://support.github.com?tags=dotcom-footer)
- 管理 Cookie
- 不共享我的个人信息
此时你无法执行该操作。

查看全文

http://www.jsqmd.com/news/810258/