DS17
1. 产品速览
- 17 键小配列
- 有线单模（C2C 支持）
- QMK + VIA 在线驱动
- 1K 回报率 / 全键可改 / 无电池
购买链接
[QQ交流群]
677654482
2. 开关与指示 （仅多模产品含“模式切换”项）
- 接线位置：Type-C
- 指示灯：NumberLock 灯（白色，NumberLock 打开时常亮）
- 复位孔：PCB 丝印位置 / 长按操作（具体以 PCB 丝印为准）
- 模式切换：不适用（单模有线）
3. 快捷键
| 快捷键 | 键值 | 说明 | 备注 |
|---|---|---|---|
| 长按 NumberLock | LT(1, KC_NUM) | 短按：切换 NumberLock 开关；长按：进入 FN 层使用组合键 | NumberLock 打开时指示灯常亮白色 |
FN + 7 | RGB_TOG | 开启 / 关闭 RGB 轴灯 | 按住 NumberLock 再按 7 |
FN + 0 | RGB_MOD | 切换 RGB 灯效模式 | 按住 NumberLock 再按 0 |
FN + 8 | RGB_SAI | 增加饱和度 | 按住 NumberLock 再按 8 |
FN + 2 | RGB_SAD | 减少饱和度 | 按住 NumberLock 再按 2 |
FN + 4 | RGB_HUD | 增加色相（色度） | 按住 NumberLock 再按 4 |
FN + 6 | RGB_HUI | 减少色相（色度） | 按住 NumberLock 再按 6 |
FN + - | RGB_VAI | 增加亮度 | 按住 NumberLock 再按 - |
FN + + | RGB_VAD | 减少亮度 | 按住 NumberLock 再按 + |
FN + * + - | NK_TOGG | 全键无冲 / 6 键无冲切换 | 按住 NumberLock，再依次按 * 和 - |
| 独立功能 | QK_CLEAR_EEPROM | 在第 7 层的 ENTER 键设为：恢复出厂设置 |
4. 灯效
- 默认灯效：RGB 轴灯默认开启（具体动态效果需配合 §3 快捷键或下方工具调整）
- 自定义入口：
- 在线私有驱动（推荐，无需 JSON）：micahyy.github.io（海外） / via.micah.vip（国内）
- 官方 VIA：JSON 下载（a17a18_ds17r3_via.json） + VIA 使用教程
- 注：JSON 版本与 PCB 版本可能不一致，但仍可识别
5. 固件升级 （仅可刷写产品）
准备工具： QMK Toolbox
R3 版本： 不含 bootloader，使用 QMK Toolbox 刷入
R4 版本： 取消二极管，使用 direct pin 接地触发，性能与 R3 一致
- 同 R3 链接（同一 .bin）
失败回滚： 重新刷入同一版本固件
DIY 制造文件
外壳打印
- 自备 5×M2×8 自攻螺丝 + 3×钢板卫星轴
- MakerWorld
6. 注意事项
- 数据线：套餐及 PCB 不含 Type-C 数据线，需自备
- 小键盘区域：键值默认设为小键盘区域，NumberLock 必须打开才能输入数字
- 方向键冲突：NumberLock 关闭时，小键盘 8/4/2/6 变为 上/左/下/右 方向键
- NumberLock 状态：读取电脑当前状态，可用其他键盘切换
- DIY 焊接：0402 元件需贴片焊接能力，否则建议贴片代工
7. 故障排查
| 症状 | 可能原因 | 处理 |
|---|---|---|
| 键盘突然不能用了（按数字键无反应） | NumberLock 关闭，按键被映射为方向键 | 打开电脑 NumberLock：长按本键盘 NumberLock 键，或用其他键盘切换 |
8. 规格表
| 规格 | 套餐二（Pack 2）平底 | 套餐五（Pack 5）8° 斜面 | 备注 |
|---|---|---|---|
| 套件尺寸 | 106×82.2×18.7mm | 110×87.2×33mm | |
| 套件重量 | 72g | 96g | |
| 成品尺寸 | 106×82.2×35mm | 110×87.2×42mm | |
| 成品重量 | 124g | 153g | |
| 前高 | 18.7mm | 17.5mm | |
| 后高 | 18.7mm | 33mm | |
| 角度 | 0° | 8° | |
| 连接模式 | 有线单模 | 有线单模 | |
| 接口 | Type-C | Type-C | |
| C2C | 支持 | 支持 | |
| 外壳材质 | 3D 打印 PETG | 3D 打印 PETG | |
| PCB 尺寸 | 7.6×10cm | 7.6×10cm | |
| PCB 厚度 | 1.6mm | 1.6mm | |
| 轴体支持 | 机械轴/三脚/五脚 | 机械轴/三脚/五脚 | |
| 固件平台 | QMK | QMK | |
| 改键驱动 | VIA（在线驱动网页版） | VIA（在线驱动网页版） | |
| 源代码开源 | 是 | 是 | |
| 外壳图纸开源 | 是 | 是 | |
| PCB 图纸开源 | 是 | 是 | gitee-菜籽猫 / github-micahyy |
| 全键自定义 | 支持 | 支持 | |
| 全键无冲 | 支持 | 支持 | |
| 扫描率 | 1K Hz | 1K Hz | |
| 回报率 | 1K Hz | 1K Hz | |
| 延迟 | 1ms | 1ms | |
| 配件 | Type-C数据线 1米、防滑脚贴 4个 | Type-C数据线 1米、防滑脚贴 4个 | 套件及PCB不含数据线 |
附录
组装视频
平底外壳组装视频
图片展示
评论 / 提问 （填个昵称就能留言，无需注册；邮箱选填，填了能收到回复通知）