CWiid Wiimote 接口技术文档

本文档旨在帮助用户了解和使用 CWiid Wiimote 接口项目。以下是项目的主要组成部分和使用指南。

1. 安装指南

CWiid Wiimote 接口项目的安装分为以下步骤：

1. 确保系统已安装以下依赖项：awk、bison、flex、bluez-libs、gtk+-2 开发库、Python 2.4 或更高版本、Python 开发库和 uinput 内核支持。
2. 如果从 SVN 或 Git 安装，运行以下命令：

   aclocal
   autoconf
   

3. 所有用户应运行以下命令进行配置和编译：

   ./configure
   make
   sudo make install
   

4. 若需将全局配置文件安装到更常见的 /etc 目录而非 /usr/etc 或 /usr/local/etc，请在运行 configure 时使用 --sysconfdir=/etc 参数。
5. 在安装新版本之前，建议从当前 CWiid 源代码目录运行 make uninstall && make uninstall_config，以避免收集过时的目录和文件。

2. 项目使用说明

CWiid 包含以下主要组件：

• libcwiid：Wiimote API。
• cwiid 模块：Python 接口到 libcwiid。
• wmgui：Wiimote 的 GTK 图形界面。
• wminput：Wiimote 的事件/摇杆/鼠标驱动程序。
• lswm：列出 Wiimote 设备（类似于 ls{,pci,usb} 等）。
• wmdemo：libwiimote API 的最小演示（不安装）。

以下为组件的基本使用方法：

• 运行 wmgui 可以打开 Wiimote 的图形界面。
• 运行 wminput 可以将 Wiimote 作为输入设备使用。

可以通过命令行参数或环境变量 WIIMOTE_BDADDR 指定 Wiimote 的蓝牙设备地址（bdaddr）。如果未指定，程序将使用 hci_inquiry 找到的第一个 Wiimote。

wmgui [-h] [bdaddr]
wminput [-h] [-c config] [bdaddr]

更多关于 wminput 的配置和执行信息，请查看 wminput/README。

3. 项目API使用文档

CWiid 项目提供了 Wiimote API，可以通过 cwiid 模块在 Python 中使用。以下是一个简单的示例：

import cwiid

# 连接 Wiimote
wm = cwiid.Wiimote()
wm.connect()

# 读取按钮状态
button_state = wm.state['buttons']

# 检查是否按下 A 按钮
if button_state & cwiid.Button.A:
    print("A button pressed")

更多 API 文档和示例，请参考项目的官方文档。

4. 项目安装方式

CWiid Wiimote 接口项目的安装方式已在“安装指南”部分详细说明。以下是一个简要的概述：

1. 安装依赖项。
2. 从源代码运行 configure、make 和 sudo make install 命令。
3. 根据需要调整配置文件的安装位置。

请确保遵循以上步骤，以确保项目正确安装并运行。