littlebot
Published on 2025-04-12 / 0 Visits
0

【源码】基于 XIAO ESPC3 微控制器的无线 Cyberpuck 鼠标

项目简介

本项目是对传统 Cyberpuck 设备的升级,将其改造为无线鼠标。受 Element14 视频启发,借助 XIAO ESPC3 微控制器、GY - 271 指南针传感器等部件,打造出 2DOF 无线鼠标。该鼠标通过感应地球磁场确定运动,利用俯仰和滚动控制鼠标指针移动,适用于游戏、演示等场景。

项目的主要特性和功能

  1. 无线设计:摆脱线缆束缚,用蓝牙与设备连接,有电池供电及充电功能,支持 USB 充电。
  2. 2DOF 鼠标控制:俯仰控制鼠标指针上下移动,滚动控制左右移动,仅按下特定按钮时生效,避免误操作。
  3. 多按钮功能:设有三个按钮,分别对应鼠标的移动控制、左键和右键功能。
  4. 低功耗模式:2 分钟无操作后,ESP32C3 进入深度睡眠状态,按下任意按钮可唤醒。
  5. 指数映射移动:通过指数类型的映射,使鼠标指针在不同倾斜幅度下实现大小不同的移动步长,兼顾快速移动和精细操作。

安装使用步骤

硬件组装

  1. 准备部件:XIAO ESPC3 微控制器、GY - 271 指南针传感器、3 个 6x6x5mm 触觉开关、连接电线、带 BMS 保护电路的锂电池、3D 打印的侧件和按钮。
  2. 按接线图连线,确保电线长度合适以便装入外壳。
  3. 将电池放入底壳右侧位置,合上上盖,利用 USB 孔对齐,通过外壳上的凸起固定开关。

软件配置

从项目仓库下载代码,代码依赖 QMC5883LCompass 库和 BLEMouse 库。

设备使用

  1. 打开要连接设备的蓝牙设置,扫描新设备,选择“Cyberpuck mouse”进行连接。
  2. 手持设备,中间按钮朝前,USB 接口朝下,按下连接到 GPIO2 的按钮(底部按钮),通过移动手臂、倾斜设备控制鼠标指针移动。

下载地址

点击下载 【提取码: 4003】【解压密码: www.makuang.net】