Sphero Mini 控制

技能简介

通过低功耗蓝牙（BLE）连接并控制 Sphero Mini 球形机器人，实现移动、变色、绘图等功能。

能做什么

• 控制主 LED 颜色和背光亮度
• 向任意方向滚动，调节速度
• 随机运动模式，适合与猫互动
• 绘制正方形、星形、圆形等图案
• 管理电源状态：唤醒、休眠、查看电量
• 重置和控制朝向

使用说明

1. 安装依赖

pip3 install bleak

2. 查找设备地址

python3 scripts/scan_sphero.py

寻找名为 “SM-XXXX” 的设备，记录其 MAC 地址。

3. 运行示例

import asyncio
from sphero_mini_bleak import SpheroMini

async def demo():
    sphero = SpheroMini("YOUR-MAC-ADDRESS")
    await sphero.connect()
    await sphero.wake()
    await sphero.setLEDColor(255, 0, 0)  # 红色
    await sphero.roll(100, 0)            # 向前滚动
    await asyncio.sleep(3)
    await sphero.roll(0, 0)              # 停止
    await sphero.disconnect()

asyncio.run(demo())

4. 使用现成脚本

# 猫咪玩耍模式
python3 scripts/cat_play.py

# 绘制图形
python3 scripts/draw_square.py
python3 scripts/draw_star.py

# 设置颜色
python3 scripts/set_color.py red

输入与输出

见下方输入与输出表格。

风险提示

• 使用前需摇晃 Sphero 将其从深度睡眠中唤醒
• 确保设备未连接 Sphero Edu 应用，避免冲突
• 与宠物互动时建议在软质表面使用，防止损坏
• 连接失败时可尝试增加超时时间或重新扫描设备

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/joneschi/sphero-mini/SKILL.md
来源类型：GitHub 仓库