Raspberry Pi 400 作为 USB HID 键盘和鼠标项目的常见问题解决方案

Raspberry Pi 400 作为 USB HID 键盘和鼠标项目的常见问题解决方案

项目基础介绍

该项目名为 pi400kb，旨在将 Raspberry Pi 400 转换为 USB HID 键盘和鼠标。通过该项目，用户可以将 Raspberry Pi 400 连接到计算机，使其作为键盘和鼠标使用。项目的主要编程语言是 C 语言，依赖于 libusbgx 库来实现 USB HID 功能。

新手使用注意事项及解决方案

1. 配置文件 /boot/config.txt 未正确修改

问题描述：
在启动项目之前，用户需要在 /boot/config.txt 文件中添加 dtoverlay=dwc2 配置。如果未正确添加此配置，项目将无法正常启动。

解决步骤：

1. 使用 sudo nano /boot/config.txt 命令打开配置文件。
2. 在文件末尾添加一行 dtoverlay=dwc2。
3. 保存文件并退出编辑器（在 nano 中按 Ctrl + O 保存，按 Ctrl + X 退出）。
4. 重启 Raspberry Pi 400：sudo reboot。

2. 未正确加载 libcomposite 模块

问题描述：
项目依赖于 libcomposite 内核模块。如果未加载此模块，项目将无法正常运行。

解决步骤：

1. 使用 sudo modprobe libcomposite 命令手动加载 libcomposite 模块。
2. 如果希望在每次启动时自动加载此模块，可以在 /etc/modules 文件中添加一行 libcomposite。
3. 使用 sudo nano /etc/modules 命令打开文件，添加 libcomposite，保存并退出。

3. 未正确设置 pi400kb 脚本的执行权限

问题描述：
项目的主要执行文件是 pi400kb，如果未正确设置其执行权限，将无法运行。

解决步骤：

1. 使用 chmod +x pi400kb 命令为 pi400kb 脚本添加执行权限。

2. 使用 sudo ./pi400kb 命令运行脚本。

3. 如果希望在系统启动时自动运行此脚本，可以将其复制到 /usr/sbin/ 目录，并创建一个 systemd 服务文件。

   sudo cp pi400kb /usr/sbin/pi400kb
   sudo systemctl edit --force --full pi400kb.service
   

4. 在 pi400kb.service 文件中添加以下内容：

   [Unit]
   Description=Pi 400 Keyboard & Mouse Service
   After=network.target
   
   [Service]
   ExecStart=/usr/sbin/pi400kb
   Restart=always
   
   [Install]
   WantedBy=multi-user.target
   

5. 启动服务并检查状态：

   sudo systemctl start pi400kb.service
   sudo systemctl status pi400kb.service
   

6. 如果服务状态正常，可以启用开机自启动：

   sudo systemctl enable pi400kb.service
   

通过以上步骤，新手用户可以顺利解决在使用 pi400kb 项目时可能遇到的常见问题。