Sphero Mini控制

技能简介

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

业务背景

为教育机构和创客团队提供直观的机器人编程入口。通过蓝牙直连 Sphero Mini，教师可快速搭建互动课堂，无需复杂配置即可演示运动控制、色彩反馈等基础物联网概念，降低硬件编程门槛。

落地案例：某青少年编程工作坊使用此工具开展趣味教学：讲师输入机器人 MAC 地址完成配对，设置速度 120、角度 90 让球体向前滚动，同时调用变色指令配合课程进度；课间切换随机运动模式，让学生观察球形机器人与宠物猫的互动反应，直观理解传感器触发逻辑。

能做什么

• 控制主 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 仓库