打造RGB背光ErgoDash：硬件改造与软件设置全攻略

打造RGB背光ErgoDash：硬件改造与软件设置全攻略

【免费下载链接】ErgoDashkeyboard项目地址: https://gitcode.com/gh_mirrors/er/ErgoDash

ErgoDash是一款支持RGB背光和Underglow的人体工学键盘，本指南将带你完成从硬件组装到软件配置的全过程，轻松打造专属的RGB背光机械键盘。

一、RGB背光组件准备

1.1 核心材料清单

• LED WS2812B× 24（用于Underglow）
• LED 3mm× 66-70（用于按键背光）
• TRRS cable× 1（RGB功能需4极线缆）
• LEDテープ× 2（可选，用于扩展背光效果）

1.2 工具准备

• 电烙铁与焊锡
• 剥线钳
• 镊子
• 绝缘胶带
• 螺丝刀套装

二、硬件改造步骤

2.1 键盘外壳与PCB准备

ErgoDash提供多个版本的外壳设计，推荐使用Rev1.2版本的外壳文件进行3D打印或CNC加工。外壳设计文件位于项目路径下：

图：ErgoDash Rev1.2外壳设计图，包含键盘上下盖及按键定位板

2.2 Underglow LED安装（WS2812B）

1. 跳线设置：在PCB背面按丝印指示焊接RGB跳线，最新固件无需区分主从设备，直接短接指定焊盘即可。
2. LED定位：将WS2812B芯片按丝印方向安装，确保芯片两侧的切角与丝印标记对齐。
3. 焊接技巧：
   • 用胶带固定LED后焊接一侧引脚
   • 每个焊盘加热时间控制在1秒内，避免烧坏LED
   • 推荐使用细尖烙铁头进行焊接

2.3 按键背光LED安装

1. 电阻准备：焊接1kΩ和470Ω电阻，其中1kΩ电阻位于丝印标注为"BL1k"的区域。
2. LED方向：从键盘顶部安装3mm LED，长脚（阳极）对应圆形焊盘，短脚（阴极）对应方形焊盘。
3. 特殊位置：Pro Micro下方的LED需先安装，其他位置可在按键安装后补充。

三、软件配置指南

3.1 固件编译环境搭建

1. 克隆仓库：

   git clone https://gitcode.com/gh_mirrors/er/ErgoDash

2. 安装QMK工具链： 参考QMK官方文档Getting Started

3.2 RGB功能启用

修改keymap目录下的rules.mk文件，添加以下配置：

BACKLIGHT_ENABLE = yes RGBLIGHT_ENABLE = yes

3.3 分键盘RGB设置

对于分体式键盘，需在config.h中添加：

#define RGBLIGHT_SPLIT #define RGBLED_SPLIT { 12, 12 } // 左右各12个LED

3.4 背光控制

默认固件中：

• Underglow LED默认开启
• 按键背光默认关闭，可通过Lower + Raise + S组合键（BL_TOGG）切换

四、常见问题解决

4.1 LED不亮排查

1. 供电检查：确认Pro Micro的5V引脚与LED供电线路连接正常
2. 数据链检查：WS2812B需按DAT-IN→DAT-OUT顺序串联
3. 固件验证：通过QMK Toolbox查看调试信息，确认RGBLIGHT_ENABLE已正确配置

4.2 背光闪烁问题

• 增加0.1μF电容稳定电源
• 确保LED数据线上没有过长的飞线
• 降低RGB动画帧率（修改RGBLIGHT_ANIMATION_SPEED参数）

五、高级自定义

5.1 动画效果调整

修改keymap.c中的rgb_matrix_animations数组，自定义背光动画顺序和速度。

5.2 亮度曲线优化

通过backlight_set()函数实现亮度的非线性调节，适应不同环境光需求。

5.3 快捷键设置

在keymap.c中添加自定义快捷键，例如：

// 亮度调节快捷键 KC_RGB_VAI, // 增加亮度 KC_RGB_VAD, // 降低亮度 KC_RGB_MOD // 切换动画模式

完成以上步骤后，你的ErgoDash键盘将拥有绚丽的RGB背光效果。通过QMK固件的强大功能，还可以进一步探索更多个性化设置，打造真正独一无二的键盘体验！

【免费下载链接】ErgoDashkeyboard项目地址: https://gitcode.com/gh_mirrors/er/ErgoDash