PH-AC控制器
PH-AC是一个开源的 7 按键 + 2 旋钮 街机控制器，专为音乐游戏设计优化，具备低响应延迟和按键重映射。支持USB有线连接，兼容 Windows、macOS 和 Linux 系统。
版本区分
PHAC 有三个版本，可通过背面窗口的丝印区分：
| 版本 | 编码器 | 特点 |
|---|---|---|
| rev1 | 宏彦定制EC11编码器 | 无版本标记 |
| rev2 | Bourns PEC11L | rev2标记，更换编码器和电路优化 |
| rev3 | Bourns PEC11L | rev3标记，添加RGB按键灯 + 大量 GPIO 引出，用于DIY（改动不保修） |
- 详细参数请参考仓库：ph-design/PH-AC
- 您可以使用 PH-AC Keymapper 在线配置按键映射
- 您也可以在 淘宝店 购买我们的成品。如果您想从零开始复刻设计，请务必仔细阅读以下内容：
安装步骤
1. 所需材料
| 类别 | 项目 | 数量 / 规格 |
|---|---|---|
| 工具 | H2 内六角扳手 | ×1 |
| 工具 | 电烙铁 | ×1 |
| 3D打印件 | 上盖 | ×1 |
| 3D打印件 | 底壳 | ×1 |
| 3D打印件 | 旋钮（或金属旋钮） | ×2 |
| 3D打印件 | 键帽：1u | ×1 |
| 3D打印件 | 键帽：1.5u | ×4 |
| 3D打印件 | 键帽：2.75u | ×2 |
| PCB组件 | 完成焊接的 PH-AC PCB | ×1 |
| 紧固件 | M3×8×5mm 热熔螺母 | ×2 |
| 紧固件 | M3×8mm 内六角螺丝 | ×2 |
| 紧固件 | M4×8mm 内六角圆头螺丝 | ×2 |
| 机械组件 | 机械轴体（Cherry MX 标准） | ×7 |
| 机械组件 | 2u 卫星轴 | ×2 |
| 配件 | 防滑贴 | ×4 |
2. 组装流程
步骤1：热熔螺母安装
- 打开电烙铁，将温度设置为350°C
- 用加热的烙铁头垂直压入热熔螺母中央
- 重复步骤直到所有热熔螺母安装平整
步骤2：PCB安装
- 取出PCB，对准安装孔位装入上盖
- 编码器固定较紧，如有缝隙用手用力压平
- 直至听见"咔"声或无明显缝隙，确保编码器固定到位
步骤3：外壳组装
- 取出底壳与内六角螺丝
- 将上盖与PCB组合体放入底壳
- 拧紧背面螺丝
步骤4：旋钮安装
- 将旋钮配套螺纹销拧入旋钮螺纹孔
- 3D打印旋钮需使用自备M4×8螺丝
- 将露出部分对准编码器凹槽垂直放入
- 直至旋钮触底，锁紧螺纹销
步骤5：轴体与键帽安装
- 先将2u卫星轴卡入上盖对应位置
- 安装7个机械轴体
- 安装键帽：
- 第一行：1个1u键帽
- 第二行：4个1.5u键帽（横向排列）
- 第三行：2个2.75u键帽
- 注意：2.75u键帽固定较紧，需垂直用力按压至安装到位
步骤6：完工收尾
在机身底部任意位置粘贴防滑贴，安装完成。
固件配置
PHAC 支持两个固件方案，请根据需求选择：
| 固件方案 | QMK 固件 | PHAC_Firmware 固件 |
|---|---|---|
| 游戏优化 | ❌ 未优化 | ✅ 专为音游优化 |
| 编码器绑定 | ✅ 支持 | ✅ 支持 |
| 按键绑定 | ✅ 支持 | ✅ 支持 |
| 控制器模式 | ❌ 不支持 | ✅ 支持 |
| 维护状态 | ⚠️ 已停止更新 | ✅ 活跃维护 |
| Rev1 支持 | ✅ 支持 | ✅ 支持 |
| Rev2 支持 | ✅ 支持 | ✅ 支持 |
| Rev3 支持 | ⚠️ 丢失灯光效果 | ✅ 完全支持 |
| 配置工具 | VIA | keymapper.phdesign.cc |
| 其他控制器 | ❌ 不支持 | ✅ RP2040/RP2350 |
编译说明：
目前 PHAC_Firmware 依赖于 VSCode 的 Pico SDK 插件进行编译：
- 拉取固件源码
- 在 VSCode 中导入项目
- 使用 Pico SDK 插件编译
后续计划
我们将逐步解耦合依赖，使用 GitHub Actions 自动编译，并加入 OTA 更新功能。
固件烧录
- 首次烧录：直接插入控制器，将编译好的.uf2固件拖入RPI-RP2存储设备
- 后续升级：按住任意按键插入USB即可进入烧录模式
3D打印指南
推荐设置
- 层高：0.2mm
- 填充密度：15%
- 支撑：无需支撑
- 材料：PLA（推荐）/PETG/ABS
拓竹机型适配
- 外壳：X1系列、P1系列、A1系列
- 键帽：支持所有拓竹机型
- 切片文件：仓库提供Bambu Studio项目文件
其他品牌打印机
将仓库中的.3mf文件导入切片软件，保持0.2mm层高默认工艺即可打印。
使用注意事项
⚠️ 重要提醒
编码器选择
- 上盖仅适配4.5mm矮规格编码器
- 使用标准高度编码器会导致引脚卡住上盖
- 选购配件时请特别注意规格
使用建议
- 避免大力操作旋钮，以免影响编码器稳定性
- 当前PCB版本无外置编码器去抖电路
- 使用劣质或老化编码器可能出现回滚现象
🔧 故障排除
编码器长期使用磨损
编码器在长期使用后会出现磨损，表现为以下症状：
- 旋转出现大小幅度回滚
- 无响应
- 丢步
维护方法：
- 准备 400cs 的二甲基硅油
- 将硅油渗入 PCB 和编码器底部
- 倒置按下编码器的旋钮，重复此步骤直到润滑油渗入编码器内部
- 如问题没有彻底修复，重复以上步骤
注意： 在极端使用情况下编码器内部可能已产生形变，润滑油无法完全修复，请联系我们返修
按键问题
- 确认轴体完全插入轴座，有时候安装会导致针脚弯折，并没有插入完全
- 检查卫星轴安装是否正确，我们只支持标准的mx卫星轴
- 2.75u键帽需用力按压至完全安装，如果你用的是我们提供的3D打印键帽，请确保用力垂直按压，确保完全插入
开源协议
本项目采用 Creative Commons BY-NC-SA 4.0 协议发布：
- 署名（BY）：必须为项目署名并提供协议链接
- 非商业性（NC）：不得用于商业用途
- 相同方式共享（SA）：衍生作品必须以相同协议发布
3D打印补充条款
- 设计文件仅限个人使用，禁止商业用途
- 允许通过3D打印代打服务制造，但需按常规重量计费
- 请保留设计中的所有标识，未经授权不得删除或修改
社区支持
📚 获取帮助
- GitHub Issues: ph-design/PH-AC
- 邮件支持: dev@phdesign.cc
- 购买咨询: 淘宝商城
🙏 特别感谢
- QMK Project - QMK Firmware
- 所有为项目贡献代码和反馈的社区成员
最后更新时间：2025年11月