Appearance
3.18 智能泡泡机
3.18.1 造型介绍
这是一台 “语音控制吹泡泡” 的智能泡泡机，语音指令控制舵机运转，自动吹出漫天泡泡，一句口令就能制造浪漫泡泡氛围。。
3.18.2 学习目标
掌握 WonderLLM 大模型语音控制功能，实现泡泡机的启停与工作模式控制。
学会 ESP32 驱动 270° 积木舵机与风扇模块，完成语音控制吹泡泡的趣味互动项目。
3.18.3 积木搭建
3.18.4 模式切换
本造型需要用在线大模型，如果已经进入在线大模型模式即可跳过此步骤直接进入设备接线步骤，否则请参考"4.4.10 固件更新"的内容重新烧录对应固件。
3.18.5 设备接线
将风扇模块接线插入 ESP32 主控器 接口；
将 WonderLLM 模块接线插入 ESP32 主控器 接口；
将 270° 积木舵机接线插入 ESP32 主控器 接口，舵机 接线插入 S1 的 引脚处。
如图所示：
！注意事项：
第一次进行与270°积木舵机相关的课程时，我们需要先将270°舵机上的齿轮及齿轮携带的积木部分一起拆下，把以下270°舵机的复位程序上传至ESP32；接着将拆下的积木装回，然后将我们本节课的程序上传至ESP32，等待270°积木舵机转至初始位置（ 135° ）。（若之前已经使用过舵机复位程序，可跳过此步骤）
3.18.5 程序编写
(1) 程序原理图
(2) 添加扩展库
- 在 “扩展” 中选择 “传感器” 添加 “WonderLLM” ；
- 在 “扩展” 中选择 “输出模块” 添加 “风扇模块(黑色)” 。
(3) 核心代码块解析
| 指令块 | 所在类别 | 功能说明 |
 |  | 向WonderLLM大模型发送自定义文本信息。 |
 | 配置MCP工具调用参数，自定义工具名称、描述、执行指令与返回参数，设置调用阻塞与数据返回规则。 | |
 | 开启或关闭MCP开关，控制WonderLLM是否启用自定义工具调用能力。 | |
 | 读取MCP工具执行完成后返回的结果数据。 | |
 | 控制对话消息输出模式，可发送动作结束标识、开启或关闭对话内容打印输出。 | |
 |  | 控制指定编号风扇接口，设置 0~100 区间内的转速数值，调节风扇风力大小。 |
 |  | 控制指定接口270°舵机，在设定时长内平稳转动至目标角度，自动延时等待舵机完成动作。 |
(4) MCP参数配置
工具名称：self.robot.setAction
1.工具描述： You are a machine that makes foam. It blows out bubbles through the fan module. The parameters are as follows: switch: 0 or 1. Return 1 when opening and 0 when closing.
简述：你是一台产生泡沫的机器。它通过风扇模块吹出气泡。参数如下：开关：0 或 1。打开时返回 1，关闭时返回 0。
2.指令名称：setAction
3.返回参数：[["action","int","0","0","1"]]
4.是否阻塞直到调用完成：是
5.是否返回数据：否
6.功能：这段 MCP 配置是给 WonderLLM 模块定义泡泡机控制工具：让 WonderLLM 能下发 0-1 开关指令控制泡泡机启停吹泡泡动作，调用时程序会阻塞等待吹泡泡动作完整执行完毕，且无需向 WonderLLM 回传运行数据。
(5) 完整程序展示
上电初始化 WonderLLM 模块的硬件接口为 1，并启用 MCP 工具，配置 setAction 吹泡开关参数，然后设置 270° 积木舵机的初始位置；
程序循环等待语音下发 0/1 控制参数，持续接收模型反馈指令；
参数为 1 转动舵机同步启动风扇产出泡泡，参数 0 全部关停；
吹泡动作阻塞完成，设备复位后重新循环监听语音。
- 程序源文件存放于「附录文件」目录内的「课程资料」，可前往该处下载压缩包获取。
3.18.7 程序下载
3.18.8 扩展提升
项目一：吹泡同步炫彩流水灯
语音下达启动吹泡指令，270°积木舵机往复配合风扇持续出泡，RGB 彩灯同步循环切换流水炫彩效果；语音停止指令，风扇、舵机、彩灯同步关停，练习多输出设备同步联动编程。
项目二：间歇自动吹泡循环
语音开启自动模式，泡泡机工作 8 秒、暂停 5 秒往复循环，循环期间彩灯持续渐变，任意停止语音可随时打断整套循环，掌握定时循环动作与实时语音中断逻辑。
3.18.9 技术支持与产品讨论
如果您在产品使用过程中遇到困难，欢迎您通过如下方式向我们反馈：
如果您在产品体验后有更好的创意，欢迎您进入幻尔社区将您的创意分享：
