SpaceFox 项目下载及安装教程

1. 项目介绍

SpaceFox 是一个 6 自由度（6DOF）的 DIY 人机接口设备（HID）项目。它旨在为 CAD 设计师提供一个开源的、可自行组装的 3D 鼠标，类似于 SpaceNavigator。该项目基于 Stewart 平台设计，使用电位器作为传感器，旨在让任何拥有 3D 打印机的人都能轻松构建。

2. 项目下载位置

要下载 SpaceFox 项目，请访问项目的 GitHub 仓库。你可以通过以下步骤下载项目：

1. 打开终端或命令提示符。
2. 使用 git clone 命令下载项目：

git clone https://github.com/pepijndevos/spacefox.git

3. 项目安装环境配置

在安装 SpaceFox 项目之前，你需要确保你的开发环境已经配置好。以下是所需的软件和硬件环境：

硬件环境

• 3D 打印机（用于打印项目部件）
• Arduino Pro Micro（用于控制）
• 电位器（6 个）
• 球头接头（12 个）
• 扭簧（6 个）
• 螺杆（6 个）
• 樱桃 MX 兼容开关（9 个）
• 键帽（9 个）
• 2mm 和 3mm 螺母和螺栓

软件环境

• Arduino IDE（用于编写和上传代码）
• FreeCAD（用于查看和修改 CAD 文件）
• spacenavd（用于 Linux 系统上的空间导航设备驱动）

环境配置示例

以下是配置环境的步骤示例：

1. 安装 Arduino IDE：

   • 下载并安装 Arduino IDE 从 Arduino 官方网站。
   • 安装完成后，打开 Arduino IDE。

2. 安装 FreeCAD：

   • 下载并安装 FreeCAD 从 FreeCAD 官方网站。
   • 安装完成后，打开 FreeCAD 并加载项目中的 CAD 文件。

3. 安装 spacenavd（仅适用于 Linux 系统）：

   • 打开终端并输入以下命令安装 spacenavd：

   sudo apt-get install spacenavd
   

   • 安装完成后，编辑 /etc/spnavrc 文件，添加以下内容：

   device-id = 1b4f:9206
   

4. 项目安装方式

安装 SpaceFox 项目的步骤如下：

1. 3D 打印部件：

   • 使用 3D 打印机打印项目中的所有部件。部件包括 arm-Body、arm2-Body、top-Body 和 base。

2. 组装硬件：

   • 将扭簧安装在电位器上，并将电位器固定在 PCB 上。
   • 将球头接头安装在推杆上，并将推杆固定在臂上。
   • 将旋钮固定在球头接头上。
   • 将底板切割成 4 层，并将樱桃 MX 开关安装在顶板上。
   • 将 PCB 固定在底板上。

3. 上传 Arduino 代码：

   • 打开 Arduino IDE，加载项目中的 Arduino 代码。
   • 将 Arduino Pro Micro 连接到计算机，并上传代码。

5. 项目处理脚本

SpaceFox 项目的处理脚本主要用于控制 3D 鼠标的操作。以下是脚本的简要说明：

1. Arduino 代码：

   • 项目中的 Arduino 代码负责读取电位器的数据，并将其转换为 3D 空间中的运动数据。
   • 代码还包括处理按钮输入的功能。

2. spacenavd 配置：

   • 在 Linux 系统上，spacenavd 驱动程序负责将 Arduino 发送的数据转换为系统可识别的 3D 鼠标输入。
   • 配置文件 /etc/spnavrc 中的 device-id 用于识别 SpaceFox 设备。

通过以上步骤，你可以成功下载、安装并配置 SpaceFox 项目，开始使用你的 DIY 3D 鼠标。