HandiPi 开源项目安装与配置指南

HandiPi 开源项目安装与配置指南

1. 项目基础介绍

HandiPi 是一个基于 Raspberry Pi 4 的便携式计算机，它包含一个自定义的 36 键键盘和一个触摸屏显示。这个项目是一个完全功能的 Linux 计算机，可以独立使用，也可以连接外部显示器和 USB 设备以提供更大的屏幕和输入空间。HandiPi 使用 QMK（Quantum Mechanical Keyboard）键盘固件，这使得键盘完全可配置。

主要编程语言：

• C/C++（用于键盘固件开发）
• Python（用于可能的自动化脚本）
• Bash（用于系统配置）

2. 项目使用的关键技术和框架

• Raspberry Pi 4：作为主控制器和计算核心。
• Atmega328：用于控制键盘的微控制器。
• QMK：开源的键盘固件，用于键盘配置和编程。
• Raspberry Pi OS：基于 Debian 的操作系统，用于 Raspberry Pi。
• i3：轻量级的平铺式窗口管理器，特别适用于资源受限的机器。

3. 项目安装和配置的准备工作

准备工作

• 一台 Raspberry Pi 4
• microSD 卡（至少 16GB）
• 电脑（用于下载操作系统和烧录到 microSD 卡）
• USB 键盘和鼠标（初始设置时使用）
• 网络连接（用于下载必要的软件包和更新）
• HandiPi 硬件组件（自定义键盘、触摸屏、PiSugar 电源控制器等）

安装步骤

1. 下载 Raspberry Pi OS

   访问 Raspberry Pi 官方网站下载 Raspberry Pi Imager 工具和 Raspberry Pi OS。

2. 烧录操作系统到 microSD 卡

   使用 Raspberry Pi Imager 将下载的 Raspberry Pi OS 烧录到 microSD 卡。

3. 设置 Raspberry Pi

   将 microSD 卡插入 Raspberry Pi 4，连接 USB 键盘、鼠标和显示器，启动 Raspberry Pi 并完成初始设置。

4. 更新系统和安装必要软件

   打开终端，执行以下命令来更新系统和安装必要的软件包：

   sudo apt update
   sudo apt upgrade
   sudo apt install git
   

5. 安装 QMK 固件

   克隆 QMK 固件仓库到 Raspberry Pi：

   git clone https://github.com/qmk/qmk_firmware.git
   cd qmk_firmware
   git submodule update --init --recursive
   

   根据你的键盘布局和键位图进行配置，然后编译固件。

6. 配置 i3 窗口管理器

   安装 i3 窗口管理器：

   sudo apt install i3
   

   根据个人喜好配置 i3 配置文件（通常位于 ~/.i3/config）。

7. 连接键盘和触摸屏

   确保所有硬件组件正确连接。键盘应该通过 USB 接口连接到 Raspberry Pi，触摸屏应连接到 Raspberry Pi 的 DSI 接口。

8. 测试系统

   一切安装完成后，重启 Raspberry Pi 并测试键盘、触摸屏和系统功能是否正常工作。

完成以上步骤后，你的 HandiPi 应该已经可以正常使用了。享受你的便携式 Linux 计算机吧！