基于Arduino Leonardo自制可编程鼠标：从HID原理到创客实践

1. 项目概述：从创客视角看自制输入设备

几年前，当我第一次把一块Arduino Leonardo插上电脑，看到它被识别为一个键盘时，一个想法就冒了出来：既然它能模拟键盘，那能不能模拟鼠标呢？这个念头直接催生了今天要聊的这个项目——用Arduino Leonardo自制一个完全可编程、可定制的鼠标。这不仅仅是一个简单的复制品，而是一个打开硬件交互新世界大门的钥匙。对于创客、硬件爱好者，甚至是想要深入理解人机交互底层逻辑的开发者来说，自己动手做一个鼠标，其意义远超得到一个能点击的物理设备。

市面上成熟的鼠标产品成千上万，从几十块的办公鼠到上千元的电竞鼠，功能各异。那我们为什么还要“重复造轮子”？核心原因在于“控制权”和“可塑性”。当你使用一个商业鼠标时，你被限制在厂商设定的固件逻辑里。DPI切换、宏编程、灯光效果，这些功能看似丰富，但边界是固定的。而一个自制的、基于Arduino的鼠标，其每一个移动像素、每一次点击事件、每一个滚轮脉冲，都可以通过你编写的代码来精确控制。你可以实现商业鼠标做不到的“怪异”功能：比如根据屏幕内容自动改变移动速度的“智能鼠标”，或者将鼠标移动轨迹转化为绘图指令的“画笔鼠标”，甚至是结合传感器实现手势控制的“空中鼠标”。

这个项目的核心硬件Arduino Leonardo（以及它的同胞兄弟Micro）之所以特殊，在于其主控芯片ATmega32U4内置了USB通信功能。这意味着它不需要额外的USB转串口芯片，就能被电脑识别为原生的USB人机接口设备（HID），例如键盘或鼠标。这是它与经典的Uno、Nano等型号最本质的区别。利用Arduino IDE中内置的Mouse和Keyboard库，我们可以用极其简单的几行代码，就命令Leonardo去移动光标、点击按键，或者敲击键盘。这为硬件原型开发和人机交互实验提供了前所未有的便利。

那么，这个项目适合谁？如果你是刚接触Arduino的初学者，想做一个有趣又有成就感的项目来巩固知识，自制鼠标是一个绝佳的选择，它涵盖了数字输入（按钮）、模拟输入（摇杆或电位器）、USB HID通信等多个核心概念。如果你是资深玩家或开发者，想要为某个特殊应用（如辅助设备、工业控制面板、互动艺术装置）定制输入设备，这个项目提供了最基础也是最核心的框架。你可以在此基础上，集成陀螺仪、触摸传感器、屏幕等模块，创造出独一无二的交互工具。

2. 核心硬件选型与电路设计思路

工欲善其事，必先利其器。自制鼠标的第一步，就是理清我们需要哪些硬件，以及它们如何连接。整个系统的核心是主控板，但围绕它的输入部件选择和电路设计，直接决定了最终产品的形态、手感与功能上限。

2.1 主控板：为什么必须是 Leonardo 或 Micro？

正如开头提到的，ATmega32U4芯片的USB HID能力是本项目的基石。市面上常见的Arduino板型中，具备此能力的主要是：

• Arduino Leonardo： 标准版型，接口丰富，有独立的Micro USB接口用于编程和通信。
• Arduino Micro： 体积更小，形状类似一个USB设备，可以直接插在电脑上（需扩展板引出引脚），非常适合制作紧凑型设备。
• 一些第三方兼容板： 如Adafruit ItsyBitsy 32u4、SparkFun Pro Micro等，它们同样基于ATmega32U4，体积更小巧，成本可能更低，但需要留意引脚定义和电压差异。

注意：绝对不要使用Arduino Uno、Nano（旧版）等基于ATmega328P的板子尝试本项目。它们需要通过额外的软件（如HoodLoader2）刷写特殊引导程序才能模拟USB HID，过程复杂且不稳定，对于本项目而言是徒增烦恼。

选择建议：对于初次尝试，Arduino Leonardo是最稳妥的选择。它的引脚布局标准，有丝印标注，不易接错线，且标准的USB接口方便反复插拔调试。如果你追求最终产品的集成度，希望做出来的鼠标内部更整洁，那么Arduino Micro或Pro Micro是更优选择，但需要一定的焊接和排线规划能力。

2.2 输入部件：超越传统鼠标的交互可能

一个基础鼠标需要左键、右键、滚轮（中键）和移动检测。我们可以用以下部件实现：

1. 按键（左/右/中键）：

   • 最简方案：轻触开关。这是最常见的选择，成本极低，手感明确。选择引脚间距为2.54mm的直插或贴片型号即可。
   • 进阶方案：微动开关。如果你追求类似游戏鼠标的“咔哒”手感，可以选用欧姆龙等品牌的微动开关。需要注意的是，微动开关通常有三个引脚（公共端、常开、常闭），我们只需要使用公共端和常开端。
   • 连接方式：按键的一端连接到Arduino的某个数字引脚（如D2, D3, D4），另一端连接到GND。在代码中，将该引脚设置为INPUT_PULLUP模式，利用内部上拉电阻。当按键按下，引脚从高电平被拉低到GND，触发动作。

2. 移动检测（替代光学传感器）： 这是自制鼠标最具挑战也最有创意的一环。我们无法轻易复制商业鼠标的光学引擎，但可以用其他模拟器件来“模拟”移动。

   • 方案A：模拟摇杆：一个双轴摇杆（Joystick）可以输出X、Y两个方向的模拟电压。这是实现光标移动最直观的方式。摇杆模块通常输出VCC、GND、VRx（X轴）、VRy（Y轴）、SW（按键，可作中键）五根线。将VRx和VRy分别连接到Leonardo的模拟输入引脚（如A0, A1）。
   • 方案B：电位器：使用两个独立的旋转电位器，一个控制X轴，一个控制Y轴。这更像是一个早期的轨迹球或绘图板的感觉。将电位器的两端分别接VCC和GND，中间滑动端接模拟输入引脚。
   • 方案C：方向键：使用四个独立的按键（上、下、左、右）来控制光标移动。这种方式精度低，但电路和代码最简单，适合某些特定场景。
   • 方案D：陀螺仪/加速度计模块：如MPU-6050。这可以用来制作“空中鼠标”，通过挥动手势来控制光标。这属于高级应用，需要处理传感器数据融合（如互补滤波）来获得稳定的姿态角，再将角度变化映射为光标移动。

3. 滚轮检测：

   • 旋转编码器：这是模拟机械滚轮的最佳选择。它每旋转一格会产生一个脉冲序列。通过判断两个输出引脚（通常标为CLK和DT）的脉冲相位差，可以识别正转和反转。将CLK和DT连接到两个数字引脚，并启用中断或频繁读取来检测状态变化。
   • 替代方案：也可以用两个按键（上翻、下翻）来模拟滚轮，但失去了连续滚动的流畅感。

4. 其他扩展部件：

   • LED指示灯：可以连接一个LED到数字引脚，用来指示电源状态、DPI模式或自定义功能。
   • 蜂鸣器：提供点击音效或模式切换提示。
   • OLED小屏幕：显示当前DPI、电量（如果供电）、自定义宏名称等信息。
   • 锂电池与充电模块：如果你想做成无线的，需要增加供电部分。但请注意，Leonardo本身不支持蓝牙，无线化需要额外添加HC-05/HC-06蓝牙模块并修改代码逻辑，复杂度会大幅提升，建议在有线版本稳定后再尝试。

2.3 电路设计与连接图

一个基于模拟摇杆和旋转编码器的经典方案电路连接如下表所示：

部件	引脚/线	连接到 Leonardo 引脚	说明
摇杆模块	VCC	5V	供电
GND	GND	接地
VRx (X轴)	A0	模拟输入，读取X方向
VRy (Y轴)	A1	模拟输入，读取Y方向
SW (按键)	D5	数字输入，内部上拉，可作中键
轻触开关 (左键)	引脚1	D2	数字输入，内部上拉
引脚2	GND
轻触开关 (右键)	引脚1	D3	数字输入，内部上拉
引脚2	GND
旋转编码器	CLK	D6	数字输入，用于检测旋转
DT	D7	数字输入，用于判断方向
+ (VCC)	5V	供电
GND	GND	接地
LED (可选)	长脚 (阳极)	D13 (或通过电阻)	数字输出，板载LED引脚
短脚 (阴极)	GND

实操心得：在面包板上搭建原型时，务必使用足够多的跳线，并尽量保持布线整洁。电源（5V和GND）的稳定是模拟读数准确的关键。如果发现摇杆读数跳动剧烈，可以在Arduino的5V输出和GND之间并联一个10uF-100uF的电解电容，以平滑电源纹波。另外，为每个数字输入引脚（按键、编码器）启用内部上拉电阻（INPUT_PULLUP）是必须的，这能省去外部电阻，简化电路。

3. 核心代码解析与功能实现

硬件搭建完毕，接下来就是赋予它灵魂的代码部分。我们将使用Arduino IDE进行开发。请确保你的IDE中已安装好Arduino AVR Boards支持，并且选择了正确的板型（工具 -> 开发板 -> Arduino Leonardo）和端口。

3.1 基础框架与库引入

Arduino Leonardo的核心能力来自于其内置的Mouse和Keyboard库。这两个库允许我们直接向连接的电脑发送标准的HID指令。

#include <Mouse.h> #include <Keyboard.h> // 虽然本项目主要用鼠标，但引入Keyboard库为未来扩展留有余地 // 引脚定义 - 必须与你的实际接线一致！ const int pinButtonLeft = 2; const int pinButtonRight = 3; const int pinButtonMiddle = 5; // 假设用摇杆按键作为中键 const int pinJoystickX = A0; const int pinJoystickY = A1; const int pinEncoderCLK = 6; const int pinEncoderDT = 7; const int pinLed = 13; // 板载LED // 状态变量 int lastLeftState = HIGH; int lastRightState = HIGH; int lastMiddleState = HIGH; int lastEncoderCLKState = HIGH; int cursorSpeed = 5; // 光标移动速度系数，可调 int scrollSpeed = 1; // 滚轮速度系数 void setup() { // 初始化串口，用于调试输出（可选） Serial.begin(9600); // 等待串口连接，仅在需要调试时打开。正式使用时注释掉，否则会卡住程序。 // while (!Serial) { ; } // 配置引脚模式 pinMode(pinButtonLeft, INPUT_PULLUP); pinMode(pinButtonRight, INPUT_PULLUP); pinMode(pinButtonMiddle, INPUT_PULLUP); pinMode(pinEncoderCLK, INPUT_PULLUP); pinMode(pinEncoderDT, INPUT_PULLUP); pinMode(pinLed, OUTPUT); // 初始化鼠标库 Mouse.begin(); // Keyboard.begin(); // 暂时不需要键盘功能 Serial.println("自制鼠标初始化完成！"); } void loop() { // 这里是所有功能循环执行的地方 // 我们将把功能拆分成独立的函数来调用 readButtons(); readJoystick(); readEncoder(); // 可以添加一个短暂的延时来稳定循环，但会影响响应速度 // delay(1); }

在setup()函数中，我们完成了三件关键事：1) 将所有输入引脚设置为INPUT_PULLUP模式，利用内部上拉电阻保证引脚在未按下时为高电平；2) 调用Mouse.begin()启动鼠标模拟功能；3) （可选）初始化串口用于调试。loop()函数则像一个不停运转的调度中心，依次调用各个输入读取函数。

3.2 按键检测与鼠标点击实现

检测按键并触发点击是相对简单的部分，关键在于处理“消抖”。机械开关在闭合和断开的瞬间会产生快速的电压抖动，如果不处理，一次物理按压可能会被误判为多次点击。

void readButtons() { int currentLeftState = digitalRead(pinButtonLeft); int currentRightState = digitalRead(pinButtonRight); int currentMiddleState = digitalRead(pinButtonMiddle); // 左键处理 if (currentLeftState != lastLeftState) { // 状态改变，先等待一小段时间消抖 delay(5); // 再次读取确认状态 currentLeftState = digitalRead(pinButtonLeft); if (currentLeftState == LOW) { // 按键被按下（因为上拉，按下为LOW） Mouse.press(MOUSE_LEFT); digitalWrite(pinLed, HIGH); // LED亮起作为反馈 Serial.println("左键按下"); } else { Mouse.release(MOUSE_LEFT); digitalWrite(pinLed, LOW); Serial.println("左键释放"); } lastLeftState = currentLeftState; // 更新状态 } // 右键处理（逻辑同左键） if (currentRightState != lastRightState) { delay(5); currentRightState = digitalRead(pinButtonRight); if (currentRightState == LOW) { Mouse.press(MOUSE_RIGHT); Serial.println("右键按下"); } else { Mouse.release(MOUSE_RIGHT); } lastRightState = currentRightState; } // 中键处理（逻辑同左键，但使用MOUSE_MIDDLE） if (currentMiddleState != lastMiddleState) { delay(5); currentMiddleState = digitalRead(pinButtonMiddle); if (currentMiddleState == LOW) { Mouse.press(MOUSE_MIDDLE); Serial.println("中键按下"); } else { Mouse.release(MOUSE_MIDDLE); } lastMiddleState = currentMiddleState; } }

这段代码实现了基础的消抖和点击动作。Mouse.press()和Mouse.release()函数分别模拟按下和释放动作。组合起来就是一次完整的点击。如果你想实现“按住拖动”，只需要在按下时不立即释放，直到移动到位后再释放即可。

3.3 摇杆读取与光标移动映射

将摇杆的模拟值转换为光标的移动是项目的核心算法。摇杆在中心位置时，模拟读数大约在512左右（假设10位ADC，0-1023范围）。当我们向某个方向推动时，读数会向0或1023变化。

void readJoystick() { // 读取原始模拟值 int xValue = analogRead(pinJoystickX); int yValue = analogRead(pinJoystickY); // 计算与中心点的偏差。注意：摇杆的Y轴方向可能与屏幕Y轴相反，可能需要调整符号。 int xDelta = map(xValue, 0, 1023, -cursorSpeed, cursorSpeed); int yDelta = map(yValue, 0, 1023, cursorSpeed, -cursorSpeed); // 这里Y轴做了反转 // 设置一个死区阈值，避免摇杆轻微偏移导致光标抖动 int deadZone = 20; // 对应原始模拟值的阈值范围，例如中心值512±20 if (abs(xValue - 512) > deadZone || abs(yValue - 512) > deadZone) { // 只有在偏离中心足够远时才移动鼠标 Mouse.move(xDelta, yDelta, 0); // 第三个参数是滚轮，这里为0 // 可以打印调试信息 // Serial.print("Move X:"); // Serial.print(xDelta); // Serial.print(" Y:"); // Serial.println(yDelta); } }

这里有几个关键点：

1. map()函数：它将原始模拟值（0-1023）线性映射到我们设定的移动速度范围（-cursorSpeed 到 +cursorSpeed）。cursorSpeed变量控制光标移动的灵敏度。
2. 死区处理：由于摇杆的物理特性及ADC的微小噪声，即使在未推动时，读数也可能在中心值附近轻微波动。如果不处理，光标会自己“飘移”。我们设置一个deadZone，只有当读数偏离中心超过这个阈值时，才执行Mouse.move()。
3. Y轴反转：在屏幕上，Y轴坐标向下是增加的。而大多数摇杆模块，向前推（远离人）Y值减小，向后拉Y值增加。为了符合直觉（向前推光标向上），我们在map函数中交换了Y轴的映射起点和终点，实现了反转。

实操心得：cursorSpeed的值需要根据你的摇杆行程和个人喜好反复调试。值太小，光标移动慢；值太大，光标难以精确控制。一个技巧是引入“非线性映射”或“加速度”：当摇杆推动幅度越大时，移动速度增长越快。这可以通过更复杂的映射函数（如平方关系）来实现，能显著提升操控体验。

3.4 旋转编码器与滚轮功能实现

旋转编码器的工作原理是，在旋转时，其CLK和DT两个引脚会输出相位差90度的方波。通过检测CLK沿的变化以及此时DT的电平，就能判断旋转方向。

void readEncoder() { int currentCLKState = digitalRead(pinEncoderCLK); // 检测CLK引脚的下落沿（从HIGH到LOW） if (currentCLKState != lastEncoderCLKState && currentCLKState == LOW) { // 在CLK下降沿时，读取DT引脚的状态 if (digitalRead(pinEncoderDT) == LOW) { // DT为LOW，表示逆时针旋转 Mouse.move(0, 0, scrollSpeed); // 向上滚动（屏幕内容向上走） Serial.println("滚轮上滚"); } else { // DT为HIGH，表示顺时针旋转 Mouse.move(0, 0, -scrollSpeed); // 向下滚动 Serial.println("滚轮下滚"); } } lastEncoderCLKState = currentCLKState; // 更新状态 }

这段代码实现了最基本的滚轮检测。Mouse.move()的第三个参数专门用于滚轮，正数表示向上滚动，负数表示向下滚动。scrollSpeed控制一次触发滚动的行数。

注意事项：这种查询式（非中断）的检测方法在loop循环很快时工作良好。但如果你的loop中加入了大量delay或执行很慢的任务，可能会漏掉编码器的快速旋转。对于要求高精度和响应速度的场景，应该将CLK和DT引脚连接到支持外部中断的引脚（Leonardo的D0, D1, D2, D3等），并使用attachInterrupt()函数来触发中断服务程序进行处理，这样就不会错过任何一次旋转事件。

4. 功能进阶与个性化定制

基础功能实现后，你的自制鼠标已经可以像普通鼠标一样工作了。但作为创客项目，真正的乐趣在于超越普通，实现个性化定制。这里分享几个我实践过的进阶思路。

4.1 实现可切换DPI（灵敏度）

商业鼠标的DPI切换本质上是改变光标移动速度与物理移动距离的比值。在我们的代码里，就是动态调整cursorSpeed这个变量。

我们可以增加一个按钮（或利用已有的中键长按）作为DPI切换键。在代码中设置几个预设的灵敏度档位，循环切换。

const int pinDPIButton = 4; // 假设新增一个DPI切换按钮在D4 int dpiLevel = 0; // 当前DPI档位 int dpiPresets[] = {3, 5, 10, 20}; // 预设的cursorSpeed值 int dpiPresetCount = 4; void setup() { // ... 其他初始化 ... pinMode(pinDPIButton, INPUT_PULLUP); } void loop() { // ... 其他函数调用 ... checkDPIButton(); // 注意：readJoystick函数内部应使用一个全局变量，如currentCursorSpeed，而不是固定的cursorSpeed } void checkDPIButton() { static unsigned long lastPressTime = 0; const long debounceTime = 50; // 消抖时间 int buttonState = digitalRead(pinDPIButton); if (buttonState == LOW && millis() - lastPressTime > debounceTime) { lastPressTime = millis(); dpiLevel = (dpiLevel + 1) % dpiPresetCount; // 循环切换档位 currentCursorSpeed = dpiPresets[dpiLevel]; // 更新当前速度 // 可以提供视觉或听觉反馈，例如让LED闪烁相应次数 blinkLED(dpiLevel + 1); Serial.print("DPI切换到档位: "); Serial.println(dpiLevel); } }

同时，需要将readJoystick()函数中使用的cursorSpeed替换为一个全局变量currentCursorSpeed，它会在按下DPI按钮时被更新。

4.2 编程宏按键与组合功能

利用Arduino的可编程性，我们可以让一个按键实现复杂操作。例如，让侧键（可以额外添加）按下时，执行“Ctrl+C”（复制）或一连串的鼠标移动和点击操作。

这需要用到Keyboard库。请注意，滥用键盘模拟功能可能会造成干扰，务必谨慎测试。

#include <Keyboard.h> const int pinMacroButton = 8; // 宏按键 int lastMacroState = HIGH; void setup() { // ... 其他初始化 ... pinMode(pinMacroButton, INPUT_PULLUP); Keyboard.begin(); // 必须初始化键盘库 } void readMacroButton() { int currentMacroState = digitalRead(pinMacroButton); if (currentMacroState != lastMacroState) { delay(5); currentMacroState = digitalRead(pinMacroButton); if (currentMacroState == LOW) { // 示例1：发送复制快捷键 (Ctrl+C) Keyboard.press(KEY_LEFT_CTRL); Keyboard.press('c'); delay(100); // 短暂保持 Keyboard.releaseAll(); // 释放所有按键 Serial.println("宏执行: Ctrl+C"); // 示例2：执行一系列鼠标操作（例如自动点击某个位置） // 注意：这需要知道绝对坐标，而Mouse库通常只支持相对移动。 // 实现绝对移动需要更复杂的方案，可能依赖屏幕分辨率或第三方库。 } lastMacroState = currentMacroState; } }

重要警告：在编写和测试涉及Keyboard库的代码时，一定要非常小心。错误的代码可能导致键盘“暴走”，连续发送字符。一个安全做法是：在代码开头设置一个“安全启动”机制，例如只有某个特定按键（如复位键旁边的引脚）被按下时，才执行Keyboard.begin()和相关的宏代码。或者，先通过串口打印调试信息，确认逻辑无误后再启用实际的键盘模拟。

4.3 添加视觉反馈（OLED显示）

添加一块I2C接口的OLED屏幕（如0.96寸SSD1306），可以实时显示当前DPI、电池电量（如果无线）、自定义模式等信息，极大提升产品的完成度和可玩性。

这需要安装Adafruit_GFX和Adafruit_SSD1306库。接线通常是：屏幕的SCL接Leonardo的SCL（D3），SDA接SDA（D2）。

#include <Wire.h> #include <Adafruit_GFX.h> #include <Adafruit_SSD1306.h> #define SCREEN_WIDTH 128 #define SCREEN_HEIGHT 64 Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, -1); void setup() { // ... 其他初始化 ... if(!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) { // I2C地址通常是0x3C或0x3D Serial.println(F("SSD1306分配失败")); for(;;); // 卡住 } display.display(); delay(2000); display.clearDisplay(); display.setTextSize(1); display.setTextColor(SSD1306_WHITE); } void updateDisplay() { display.clearDisplay(); display.setCursor(0,0); display.println(F("DIY Mouse v1.0")); display.print(F("DPI: ")); display.println(dpiPresets[dpiLevel]); display.print(F("Batt: ")); // 假设有电量检测功能 display.println("---%"); display.display(); }

然后在loop()中或状态改变时调用updateDisplay()函数即可刷新屏幕。

5. 外壳设计与制作建议

一个裸露着电路和跳线的“鼠标”显然不够实用。为它设计一个外壳，不仅能保护电路，更能提供舒适的手感，让项目从原型蜕变为产品。

5.1 设计考量因素

1. 人体工学：根据你是习惯左手还是右手，设计外壳的倾斜度和拇指、小指的支撑区域。可以参考市面上成熟鼠标的造型。
2. 内部布局：在三维设计软件（如Fusion 360, SolidWorks，或免费的Tinkercad）中建模时，首先要精确测量所有元件（Arduino板、摇杆、按键、编码器、电池）的尺寸和位置，留出足够的安装空间和走线通道。
3. 按键手感：外壳上按键的按压点必须对准微动开关的触头。按键的力臂长短、支点位置会影响手感，可以设计成杠杆结构来获得更省力或更清脆的按压感。
4. 通风与散热：如果使用了线性稳压模块或电池，需要考虑散热孔。
5. 线材出口：如果有线鼠标，需要为USB线留出出口和应力缓解结构。

5.2 制作材料与工艺选择

• 3D打印：这是创客最常用的方式。PLA材料足够坚固，打印精度也能满足要求。设计时注意：
  • 壁厚：一般设置1.2mm-2mm，太薄易碎，太厚浪费材料和时间。
  • 支撑：对于有悬空部分（如按键下方的空腔）的模型，需要生成支撑材料。设计时尽量优化结构，减少支撑。
  • 公差：活动部件（如按键与外壳的孔）之间需要留出间隙，通常0.2mm-0.5mm的公差比较合适，需要根据你的打印机精度测试调整。
  • 分体设计：将外壳设计为上盖和下盖，用螺丝柱和自攻螺丝固定。方便内部组装和后期维修。
• 手工制作（木材、亚克力）：如果你有激光切割机或木工技能，可以用亚克力板或木板切割出各层结构，然后堆叠粘合。这种方式质感独特，但设计复杂度高，不易做出曲面。
• 改造现有外壳：找一个旧的、坏掉的鼠标，掏空内部，将自己的电路板、元件固定进去。这是最快捷的方式，能获得成熟的人体工学设计。

5.3 组装调试与最终优化

组装时，建议遵循以下顺序：

1. 固定核心板：使用尼龙柱或热熔胶将Arduino板固定在下壳内。
2. 安装输入器件：将摇杆、编码器、微动开关等用螺丝或胶水固定在设计好的位置上。
3. 内部走线：使用硅胶线或排线连接各部件，尽量使线缆整齐，并用扎带或胶布固定，避免干扰活动部件。
4. 连接与测试：在封闭外壳前，先连接所有线缆，上传代码，进行完整的功能测试，确保按键、移动、滚轮全部正常。
5. 封闭外壳：盖上上盖，拧紧螺丝。如果发现某个按键卡顿或手感不对，可能需要调整上盖的安装精度或微动开关的位置。

组装完成后，你还可以进行最终优化：

• 配重：如果觉得鼠标太轻，可以在外壳内部空余处粘贴一些配重块（如铅片、螺母）来调整重心和重量。
• 脚贴：在鼠标底部贴上特氟龙脚贴，能极大提升在鼠标垫上滑动的顺滑度。
• 表面处理：对3D打印的外壳进行打磨、喷漆，可以提升外观质感。

6. 常见问题排查与调试心得

在制作过程中，你几乎一定会遇到各种问题。下面是我踩过的一些坑和对应的解决方案，希望能帮你节省时间。

6.1 电脑无法识别或识别错误

• 现象：插入USB后，电脑没有任何反应，或提示“无法识别的USB设备”。
  • 检查1：板型选择：确保Arduino IDE中选择的板型是“Arduino Leonardo”，而不是Uno或其它。
  • 检查2：USB线：有些USB线只能充电，不能传输数据。换一根确认好的数据线。
  • 检查3：驱动程序：在Windows设备管理器中查看是否有带感叹号的未知设备。尝试重新安装Arduino Leonardo的驱动（通常IDE安装时会自带）。
  • 检查4：代码问题：如果代码中有语法错误或逻辑死循环导致程序卡在setup()里，也可能导致枚举失败。尝试上传一个最简单的Blink例程，看板子是否正常。
• 现象：电脑识别为“键盘”或其他设备，而不是鼠标。
  • 原因：Mouse.begin()可能没有成功执行，或者代码逻辑跳过了它。检查代码中是否调用了Keyboard.begin()而没有调用Mouse.begin()？确保Mouse.begin()在setup()中只被调用一次。

6.2 光标抖动或移动不跟手

• 原因1：摇杆读数噪声。
  • 解决：如之前所述，增加“死区”阈值。如果抖动依然严重，可以在代码中对模拟读数进行软件滤波，例如取最近几次读数的平均值。

  // 简单的移动平均滤波示例 const int numReadings = 10; int readingsX[numReadings]; int readIndex = 0; int totalX = 0; int averageX = 0; // 在loop()中或专门的函数中 totalX = totalX - readingsX[readIndex]; // 减去最早的读数 readingsX[readIndex] = analogRead(pinJoystickX); // 读取新值 totalX = totalX + readingsX[readIndex]; // 加上新值 readIndex = (readIndex + 1) % numReadings; // 循环索引 averageX = totalX / numReadings; // 计算平均值 // 使用averageX代替原始的analogRead值进行后续计算

• 原因2：loop()循环速度不稳定。
  • 解决：避免在loop中使用长的delay()。如果必须延时，考虑使用millis()进行非阻塞式定时。确保readJoystick()等函数被高频调用。
• 原因3：电源干扰。
  • 解决：确保为Arduino和摇杆模块供电的电源稳定。使用电脑USB口供电一般没问题。如果使用移动电源或电池，在电源引脚附近并联一个电容（如100uF电解电容并联一个0.1uF瓷片电容）。

6.3 按键响应迟钝或连击

• 原因：消抖不充分或消抖时间过长。
  • 解决：调整消抖延时时间（代码中的delay(5)）。5-20ms是常用范围。可以尝试不同的值。更可靠的方法是使用状态机或记录按下时间（millis()）来进行非阻塞式消抖判断。
• 现象：按下一次，触发了多次Mouse.press。
  • 检查代码逻辑：确保在状态变化检测中，lastLeftState等变量在正确的时间被更新。常见的错误是在if判断内部条件分支中忘记更新状态变量。

6.4 滚轮编码器计数不准或反向

• 现象：滚动一下，网页跳了好几页，或者方向反了。
  • 解决方向：调整scrollSpeed变量，降低单次触发的滚动行数。
  • 解决反向：交换Mouse.move(0, 0, scrollSpeed)和Mouse.move(0, 0, -scrollSpeed)的逻辑，或者交换编码器CLK和DT的接线。
  • 解决漏计数：如果快速滚动时反应迟钝，说明查询式检测可能漏信号。改用中断方式检测编码器。将CLK引脚连接到Leonardo的中断引脚（如D0/INT0, D1/INT1, D2/INT2, D3/INT3），并使用attachInterrupt()函数。

6.5 功能冲突与系统级问题

• 现象：鼠标能用，但键盘某些键失灵，或系统行为异常。
  • 根源：同时使用Mouse和Keyboard库，且代码逻辑不严谨，可能导致HID报告描述符冲突或持续发送按键信号。
  • 排查：首先注释掉所有Keyboard相关的代码，看鼠标功能是否正常。然后逐步加入键盘功能，并确保每个Keyboard.press()都有对应的Keyboard.release()或最终调用了Keyboard.releaseAll()。
  • 终极方案：如果问题复杂，可以考虑放弃Arduino内置的库，直接使用LUFA库或V-USB库（对于非32U4芯片）来编写更底层的HID描述符，完全自定义一个复合设备（同时是鼠标和键盘）。但这属于高级话题，需要较多USB协议知识。

这个项目从一块简单的开发板开始，最终可以演变成一个高度定制化的专业工具。它带给你的不仅仅是一个可用的鼠标，更是对USB HID协议、嵌入式编程、传感器应用和产品设计全流程的深刻理解。每当你在日常使用中移动这个自己创造的光标，那种成就感是购买任何现成产品都无法比拟的。最重要的是，这个框架是开放的，你可以随时为它添加新的传感器、新的交互逻辑，让它不断进化，真正成为你数字世界的一个独特延伸。