Appearance
4.软硬件指南
4.1 ESP32主控器
4.1.1 ESP32主控器简介
这是一款以ESP32为核心,支持图形化编程和Python编程的智能主控器。它采用PC塑料外壳封装,板载PWM舵机接口、电机接口、可编程按钮、蜂鸣器等电子模块,并预留多个传感器接口,可拓展性强,统一4PN防反插接口,适配幻尔全系列传感器,使用方便安全。

4.1.2 ESP32主控器功能分布

4.1.3 ESP32主控器参数说明
| 产品名称 | ESP32控制器 |
|---|---|
| 产品尺寸 | 88.0mm*55.5mm*42.5mm |
| 充电电压 | 5V |
| 充电电流 | 1500mA |
| 充电时间 | 3.5h |
| 电池容量 | 1200mA 3.7V锂电池2节 |
| 最大工作电压 | 8.4V |
| 额定工作电压 | 7.4V |
4.2 WonderCode编程软件
软件安装包下载路径:
4.2.1 编程平台简介
WonderCode是幻尔产品专用的Scratch编程软件工具。软件支持图形化指令块与Python代码的自动转换,可采用拖拽指令块的方式即可进行程序编写,非常适合新手进行编程学习。

4.2.2 平台界面介绍
下图为“WonderCode”软件的功能区域示意图:①菜单栏,②指令区,③脚本区,④代码展示与上传区。

对应功能如下表所示:
| 图标 | 功能 |
|---|---|
| 可以新建、保存和打开程序文件 | |
| 用于在线模式,仅作了解,无需掌握 | |
| 决定是否连接设备与软件以及确定连接端口 | |
| 用于查找帮助资料、检查更新以及安装驱动 | |
| 显示程序文件名,当未开始编程或文件未保存时,则显示“scratch作品” | |
| 界面切换按钮,可在“在线模式”和“上传模式”之间进行切换 | |
| 选择界面显示语言,可切换英语、简体中文以及繁体中文 | |
| 在编写程序时可对操作进行撤销或恢复 | |
| 编辑方式切换按钮,“自动转码”将指令块程序转化为Python形式,切换至“Python编程”可直接使用Python来编辑程序 | |
| 将程序以Python代码的形式保存 | |
| 打开已保存的Python文件 | |
| 进行设备交互,将程序下载到主控板 | |
| 用于添加设备的扩展包 | |
| 从上至下分别控制代码编辑界面的放大、缩小以及恢复默认大小 |
4.2.3 基础代码块介绍
| 指令块 | 所在类别 | 功能说明 |
![]() | 程序暂停指定时长后继续执行后续代码,用于动作间隔、延时缓冲。 | |
![]() | 读取设备上电运行的总毫秒时间,用于计时、延时判断逻辑。 | |
![]() | 限定循环内部代码固定运行指定次数,次数完成后退出循环。 | |
![]() | 无限循环运行内部嵌套指令,程序持续重复执行循环内逻辑。 | |
![]() | 基础条件判断,条件成立时执行内部代码,不成立则直接跳过。 | |
![]() | 双分支条件判断,条件成立执行“那么”内代码,不成立执行“否则”内代码。 | |
![]() | 自定义输入延时数值,控制程序暂停对应时长。 | |
![]() | 循环执行内部代码,直至指定条件成立后退出循环。 | |
![]() | 提前终止当前循环结构,直接跳出循环执行后续程序。 | |
![]() | 用于自定义函数内部,返回指定数据至函数调用处。 | |
![]() | 对两个数值进行加法运算,返回结果。 | |
![]() | 对两个数值进行减法运算,返回结果。 | |
![]() | 对两个数值进行乘法运算,返回结果。 | |
![]() | 对两个数值进行除法运算,返回结果。 | |
![]() | 数值大小比较,对比两个数字,返回成立/不成立布尔值。 | |
![]() | 逻辑与运算,多个条件同时成立整体结果才为真。 | |
![]() | 逻辑或运算,任意一个条件成立整体结果即为真。 | |
![]() | 布尔取反运算,将原有真假条件反转。 | |
![]() | 布尔逻辑判断,对输入条件进行真假判定或取反运算。 | |
![]() | 判断数组、元组、字典内是否存在指定元素,返回布尔结果。 | |
![]() | 根据指定键名,提取字典中对应存储的数值或文本内容。 | |
![]() | 将输入数值从原数值区间线性换算映射至目标区间,完成数值范围转换。 | |
![]() | 自定义录入或调用文本内容,生成可参与拼接、判断、显示的字符串数据。 | |
![]() | 将两段文本字符串拼接合并,输出完整的组合文本。 | |
![]() | 将输入的数字数值转换为对应文本字符格式,用于文字显示、字符串拼接场景。 | |
| 创建自定义命名的变量容器,用于存储数字、文本等单份数据。 | ||
![]() | 读取已创建变量内部存储的数据,可参与运算、判断、输出等操作。 | |
![]() | 给指定变量赋值,覆盖原有数据,将变量内容修改为设定值。 | |
![]() | 对数值型变量进行自增运算,在原有数值基础上叠加指定数字。 | |
| 创建自定义名称的空白列表,用于批量存储多组数据。 | ||
![]() | 生成空白列表容器,可存放数字、文本等多类数据,用于后续增删改查操作。 | |
![]() | 清空目标列表内所有存储元素,将列表重置为空列表。 | |
![]() | 在指定列表对应序号元素前方插入自定义内容,完成列表元素新增插入操作。 | |
![]() | 自定义创建函数积木,设置函数名称与传入参数(数字/文本类型),用于封装复用一段程序逻辑。 | |
![]() | 为自定义函数提供数字或文本类型的参数输入值,供函数内部程序调用。 | |
![]() | 调用已定义好的自定义函数积木,执行该函数内部封装的全部程序代码。 | |
![]() | 创建自定义函数积木,用于封装一段可重复调用的程序逻辑。 | |
![]() | 调用已定义好的自定义函数,执行函数内部封装的全部程序。 |
4.2.4 ESP32主控器扩展库介绍
| 指令块 | 所在类别 | 功能说明 |
![]() | 程序主循环容器,上电初始化完成后持续循环执行内部代码。 | |
![]() | 设备上电开机后仅执行一次,用于放置硬件初始化、参数配置等开机逻辑。 | |
![]() | 驱动蜂鸣器播放指定音高、节拍的乐曲,后台模式下运行时不阻塞后续程序执行。 | |
![]() | 调节蜂鸣器发声音量,取值范围 0~100,数值越大音量越高。 | |
![]() | 立即停止蜂鸣器发声,终止当前播放的音调或乐曲。 | |
![]() | 控制指定编号或全部RGB彩灯,设置为选定色彩点亮发光。 | |
![]() | 通过RGB三通道数值自定义灯光色彩,控制对应彩灯输出混合色光。 | |
![]() | 让指定RGB彩灯以选定颜色执行亮度渐变呼吸效果,可自定义明暗变化周期。 | |
![]() | 开启RGB彩灯自动循环渐变多种色彩的流动炫彩灯光效果。 | |
![]() | 熄灭指定编号或全部RGB彩灯,切断灯光输出。 | |
![]() | 通过串口向电脑打印输出自定义文本字符串,用于调试查看信息。 | |
![]() | 通过串口向电脑打印输出指定数字数值,用于数据调试打印。 | |
![]() | 立刻终止指定接口360°舵机的转动动作,使舵机停止运转。 | |
![]() | 控制指定接口的360°舵机,按设定的自定义速度持续转动。 | |
![]() | 控制指定接口270°舵机,在设定时长内平稳转动至目标角度,自动延时等待舵机完成动作。 |
4.3 电子模块教程
4.3.1 360°积木舵机
(1) 简介
这是一款可以兼容各种乐高积木组件的舵机。使用时,我们一般使用 PWM(脉冲宽度调制)来控制。它是连续旋转舵机,通过 PWM 信号可以控制旋转速度和方向,但无法控制具体转动的角度。

(2) 技术参数
| 工作电压 | DC 4.8-6V |
|---|---|
| 额定扭矩 | 1N.m |
| 转动范围 | 0°~360° |
| 产品线长 | 25cm |
| 产品尺寸 | 40mm*16mm |
(3) 接线示意图
将360°积木舵机接入主控器接口 ,注意 线接 , 线接 , 线接 ,如下图所示:

(4) 案例实践
案例一:舵机正反转延时启停 程序逻辑:下载程序后,360°积木舵机将按照50的速度,正转2秒,再反转2秒,最后停止。

程序下载说明:
按照动图依次点击"连接",选择端口后,点击"上传",完成程序下载,测试程序执行效果。

注意:
图中程序使用“设置舵机S1以的50速度转动”,是因为需要使用PWM信号控制360°积木舵机转动,而主控器PWM信号输出接口为S1~S6,因此这里使用了S1接口来发出信号给360°积木舵机。
程序源文件存放于「附录文件」目录内的「程序文件」,可前往该处下载压缩包获取。
4.3.2 270°积木舵机
(1) 简介
这是一款可以兼容各种乐高积木组件的舵机。使用时,我们一般使用PWM(脉冲宽度调制)来控制。它是有限旋转舵机,也就是说舵机可以控制旋转角度,但有旋转角度限制,角度范围为0°到270°。

(2) 技术参数
| 工作电压 | DC 4.8-6V |
|---|---|
| 额定扭矩 | 1N.m |
| 转动范围 | 0°~270° |
| 产品线长 | 25cm |
| 产品尺寸 | 40mm*16mm |
(3) 接线示意图
将270°舵机接入主控器接口接口 ,注意 线接 , 线接 , 线接 ,如下图所示:

(4) 案例实践
案例一:270 度舵机多角度延时转动 程序逻辑:下载程序后,270°积木舵机先转到135°,2秒后,再转到0°,2秒后,再转到270°,2秒后停止。

程序下载说明:
按照动图依次点击"连接",选择端口后,点击"上传",完成程序下载,测试程序执行效果。

注意:
使用270°舵机必须先进行初始复位。
程序源文件存放于「附录文件」目录内的「程序文件」,可前往该处下载压缩包获取。
4.3.3 点阵模块
(1) 简介
这是一款 LED 点阵屏显示模块,具有显示亮度高,显示时无闪烁,接线方便等特点,可以显示数字、文本、图案等内容。同时模块板载了乐高兼容孔位,能进行更多创意 DIY 设计。

(2) 技术参数
| 工作电压 | DC 5V |
|---|---|
| 工作电流 | 45mA |
| 点阵像素 | 8×16点阵 |
| 点阵亮度 | 可调节8级亮度 |
| 接口型号 | 5264-4AW |
| 产品尺寸 | 55.5mm*23.5mm*18.1mm |
(3) 接线示意图

- 它支持连接主控器上的 P5、P6、P7、P8 任意接口。
(4) 案例实践
案例一:点阵屏循环图文显示 程序逻辑:下载程序后,控制点阵屏切换显示“Hi”、“123”和“❤”。

程序下载说明:
按照动图依次点击"连接",选择端口后,点击"上传",完成程序下载,测试程序执行效果。

注意:
使用点阵模块,需要在启动时初始化点阵模块的接口。
程序源文件存放于「附录文件」目录内的「程序文件」,可前往该处下载压缩包获取。
4.3.4 风扇模块
(1) 简介
这是一款不需要额外的电机驱动板的风扇模块,它的转速可调。你可以配合温度传感器制作一款智能风扇装置,使其能够根据不同的温度自动调节风扇转速。同时,模块还板载了乐高兼容孔位,可进行更多创意的 DIY 设计。

(2) 技术参数
| 工作电压 | DC 5V |
|---|---|
| 控制方式 | PWM脉冲控制 |
| 接口型号 | 5264-4AW |
| 产品尺寸 | 64.3mm*41.8mm*25.0mm |
(3) 接线示意图

- 它支持连接主控器上的 P5、P6、P7、P8 任意接口。
(4) 案例实践
案例一:风扇定时启停控制 程序逻辑:下载程序后,风扇以60的速度转动,10秒后,停止转动。

程序下载说明:
按照动图依次点击"连接",选择端口后,点击"上传",完成程序下载,测试程序执行效果。

注意:
使用风扇模块,建议接5/8任一接口,避免因主控接口初始高电平使得风扇上电就会转动。
程序源文件存放于「附录文件」目录内的「程序文件」,可前往该处下载压缩包获取。
4.4 WonderLLM模块
4.4.1 模块简介
(1) 模块介绍
WonderLLM是一款AI大模型模块,内置ESP32-S3高性能芯片,集成了200W像素高清摄像头、麦克风、高清显示屏、扬声器以及CI1302语音识别芯片,深度融合了文本、语音、视觉等多种模态模型。
该模块操作简易,常与机器人搭配使用,使机器人如同装上一颗"超级大脑”,能够深层次理解用户指令,赋予其卓越的感知、推理与行动能力,从而打造灵活自然的人机交互体验!

(2) 工作原理
模块采用口令模式唤醒,用户需要说出唤醒词来唤醒WonderLLM,激活后才可以进行人机交互。默认识别的语言为中文,中文唤醒关键词为“小幻小幻”,若需切换为英文识别,需要烧录英文识别固件,切换至英文固件后,英文唤醒关键词为“Hello Hiwonder”。
模块识别到唤醒词,蜂鸣器鸣响一声,随后即可开始与用户交互。模块支持中英文任一语种交流,并会根据用户发言,自行识别语种并切换。若1分钟内无识别到语音,则会进入休眠模式,再次使用需要重新唤醒。
(3) 硬件接口说明

| 序号 | 说明 |
| 1 | Type-C接口(上方),用于为ESP32-S3芯片烧录程序固件 |
| 2 | Type-C接口(下方),用于为CI1302芯片烧录语音识别固件 |
| 3 | 4-PIN IIC通信接口,可用于二次开发 |
| 4 | 可触摸电容屏,用于显示画面/调节音量 |
| 5 | 按键(左),用于模块切换表情/聊天模式 |
| 6 | 高清摄像头,可捕获实时图像 |
| 7 | 按键(右),用于模块网络配置、交互控制 |
(4) 注意事项
请使用5V电压供电,否则会损坏模块。
使用场景应安静,嘈杂的环境会影响识别效果。
说词条时,声音要洪亮且语速不宜过快,建议与模块之间保持在5米以内。
4.4.2 联网及配置
(1) 模块联网
NOTE
在三种情况下我们需要进行模块联网,①模块初次使用/重新烧录固件,内存未保存可用WIFI连接信息,②当前环境中,不存在与存储WIFI连接信息匹配的热点,具体参考“2.1.2 模块联网”学习,③用户手动操作进入(长按按键B)。
WonderLLM模块支持用户手动进入配网模式,以适配客户自主选择模块连接热点的需求。
当模块上电后,长按右侧按键,向模块发出重启指令,模块接收到后屏幕熄灭。此时用户需要继续保持长按,模块重启后开始尝试连接热点,屏幕出现白色环形滚动条,此时模块检测到右侧按键被长按,不再匹配外部热点,直接进入配网模式,此时用户可松开按键。
进入配网模式后,已有的热点配置信息并不会丢失,此时用户可进入网络配置页面,也可短按右侧按键,退出配网模式。
退出配网模式后模块会继续根据已保存的热点信息尝试连接,若模块无法连接到外部热点,会重新进入配网模式。
- 模块处于配网模式,用户连接模块热点进入网络配置界面后,可以看到已保存的全部热点连接配置信息列表(若用户之前已经配置过热点连接信息),如下图:

- 用户可点击任意一条已保存的热点连接信息对应的
图标,将其删除,也可点击
图标提升其在模块配网时匹配次序优先级(列表由上到下优先级递减)。
(2) 设备绑定
NOTE
设备绑定拥有两种方式,其中一种是快速绑定,具体参考“2.1.3 设备绑定”学习,另一种是新建智能体绑定。
打开任意浏览器,输入如下网址:
hiwonder.cc也可点击小幻 AI 聊天机器人超链接直接访问,打开后登录自己小幻AI的平台账号,如果没有请参考“2.1.3 设备绑定”注册账号。先点击左侧 “智能体”,切换到智能体界面。

- 点击 “创建智能体”,切换到智能体创建页面。


- 我们可以通过角色码,直接复制别人制作好的智能体。只需要将复制的角色码复制到填空栏中,接着点击“应用角色码”即可。

- 我们可以设置智能体的头像,在智能体名称我们修改为 “小幻”(这里最好与唤醒词的角色名称对应)。并指定该智能体为默认智能体。(设置为默认智能体后,设备默认绑定默认智能体)。

- 在对话模型设置中,语言模型项推荐选择 “deepseek-v4-flash”,对话模型高级设置项可调节更多详细工作参数,此处保持默认设置。

- 在语音识别设置中,语音识别推荐选择 “qwen3-asr-flash-realtime”,语音识别高级设置项可调节更多详细工作参数,此处保持默认设置。

- 在语音合成设置中,我们可以选择阿里云或者火山,音色选择自己喜欢的即可。(可以点击右边的试听选取个人喜欢的音色)。语音合成高级设置项可调节更多详细工作参数,此处保持默认设置。

- 记忆设置,选择 “无记忆” 即可。

- MCP工具默认开启,此处保持默认即可。

- 在智能体提示词中我们选择 “通用助手” 模板,接着点击 “创建智能体” 即可。

- 完成智能体创建后,我们回到智能体首页,点击新建的智能体下面 “管理设备”。

- 将模块画面显示6位设备ID输入设备绑定码中的填空栏中,再点击 “添加设备”。


(3) 设备解绑
NOTE
设备解绑拥有两种方式,其中一种是平台解绑,另一种是对话解绑。
- 进入平台后,首先点击智能体,接着点击 “设备总览”。选择需要删除的设备,点击 “删除”。

- 点击 “确定” 删除设备,即可将设备解绑。

说出关键词“确认删除设备”,即可解绑设备。

(4) 设备重启
模块支持上电后手动重启模块,用户可通过:①长按左侧按键(按键A)、 **②长按右侧按键(按键B)**任意一种方式,在非断电情况下重启模块。
当模块检测到用户通过长按按键发来的重启指令,会自行关机重启,此时可见屏幕直接熄灭,此时用户可松开按键,后续模块会自行开机。
若用户通过**长按右侧按键(按键B)**重启,若模块重新开机后尚未松开按键,可能导致模块误判进入配网模式,带来不必要的麻烦,因此推荐通过长按左侧按键实现模块重启功能。
4.4.3 音量控制
NOTE
在WonderLLM发言时改变音量,将会在下一轮发言时生效。
(1) 屏幕触摸控制
模块上电并成功连接到外部热点后,可在两种界面下触摸屏幕调整模块音量:①表情界面、②聊天界面。
具体操作方法为:在屏幕任意位置滑动,竖直向上滑动,模块自动增大音量;竖直向下滑动,模块自动减小音量。音量改变幅度取决于屏幕滑动距离,支持多次滑动屏幕调节音量。
在滑动屏幕改变音量时,屏幕正上方会显示实时音量数值,下图以在表情界面上滑增大音量为例:

(2) 语音交互控制
在与WonderLLM大模型模块交互过程中,可通过下达音量调节命令控制模块调节音量。
具体操作方法为:通过说出唤醒词/短按右侧按键进入聊天界面,此时模块激活,用户可参考如下表述:①将音量调至xx(有效范围0-100,只支持整数,也可以表达为百分比)、②增大音量(模糊表达,模块自行调整音量)。
模块识别后,对话框返回需调用的音量调节函数(用户无需关注),之后对话框显示大模型回应语句并同步播报(回复语句为大模型模块随机生成,仅保证表意恰当)。

4.4.4 聊天模式
(1) 模式概述
在当前模式下,模块会侦听并理解用户发言,进行恰当回复。
模块若干模式的切换关系如下图。可将进入聊天模式的操作总结如下:在其他任意模式下,通过说出唤醒词/短按右侧按键, 即可进入聊天模式。

(2) 操作说明
- 在完成配网后,模块首先进入表情界面,如下图:

用户可以说出指定唤醒词(出厂默认为 “小幻,小幻”),或短按右侧按键B进入聊天模式,此时可以听到蜂鸣器发出 “叮” 提示音,屏幕切换至聊天框界面显示,模块被成功唤醒并开始侦听用户发言。
如果以说出唤醒词方式进入聊天模式,模块识别到唤醒词后默认以用户身份发送“你好”作为对话开场语,大模型会做出恰当回复显示在聊天框界面并同步播报(可被人为打断从而快速跳过,具体操作详见“4.4.8 自由聊天”),之后才开始侦听用户发言。

- 如果以短按右侧按键方式进入聊天模式,模块则会立即开始侦听用户发言。

- 进入聊天模式,开始人机交互后,用户可以选择让模块不显示聊天框界面,而是持续保持表情界面,具体操作方式详见4.4.5 表情模式的操作说明。
4.4.5 表情模式
NOTE
如果在表情界面超过20秒没说出唤醒词,模块将进入天气时钟模式。用户可单击屏幕任一位置回到表情模式。
此处切换两个模式,是切换模块进入聊天模式,屏幕的显示内容(界面)。
在短按左键切换模式期间,模块一直工作在”表情模式“。短按左键切换至”聊天模式“并不会也不能唤醒模块,从而进入真正的聊天模式。
具体来说,若短按左键将聊天模式下的显示界面切换为”聊天模式“,当用户通过说出唤醒词/短按右侧按键激活模块后并开始交互时,此时模块会显示聊天模式的聊天框界面并显示大模型回复内容;
若短按左键将聊天模式下的显示界面切换为切换为”表情模式“,当用户通过说出唤醒词/短按右侧按键激活模块后并开始交互时,模块将始终保持在表情界面,并可根据回复内容做出恰当表情拟态。
(1) 模式概述
在当前模式下,模块会拟态人类表情神态。
模块若干模式的切换关系如下图。可将进入表情模式的操作总结如下:①在天气时钟模式下单击屏幕进入表情模式、②在摄像头模式下双击屏幕进入表情模式、③在聊天模式下(在模块未发言时)短按右侧按键进入表情模式。

(2) 操作说明
- 在表情模式下,用户短按左侧按键,可切换 “聊天模式” 与 “表情模式”。此时可见屏幕上方显示当前模式字样。


- 用户通过短按左侧按键切换至 “表情模式”(进入聊天模式的屏显内容为表情界面),并通过说出唤醒词/短按右侧按键方式激活模块进入 “聊天模式” 开始人机交互后,模块可根据用户发言,进行表情拟态,主要为以下两类调用方式:①(描述具体事件,模块在回复时自动做出恰当表情拟态) ②给我做个xx的表情吗。
4.4.6 天气时钟模式
NOTE
在天气时钟模式,用户可单击屏幕任一位置回到表情模式,也通过说出唤醒词/短按右侧按键进入聊天模式。
(1) 模式概述
在当前模式下,模块会根据设定城市,获取实时气象、时间信息并显示。
模块若干模式的切换关系如下图。可将进入天气时钟模式的操作总结如下:①在表情模式下单击屏幕/20s无操作进入表情模式 ,摄像头模式和聊天模式不支持直接切换至天气时钟模式。

(2) 操作说明
- 在表情模式下无操作20s/单击屏幕任一位置,可切换至天气时钟模式。

进入天气时钟模式后,如无其他操作,模块将始终保持该模式。
该模式下,模块屏幕会显示如下内容:①所在地的实时气象信息和未来2天天气预报信息、②当前北京时间及日期、③所在地城市(出厂默认设定广东深圳市)。
模块支持修改所在地城市,用户可通过说出唤醒词/短按右侧按键进入聊天界面激活模块,参考如下表述,向WonderLLM模块下达指令:①修改城市(后续的对话还需指定切换城市) 、②切换所在地城市到xx市。模块回复后,天气时钟模式的所在地会同步切换。

4.4.7 摄像头模式
(1) 模式概述
在当前模式下,模块会调用摄像头持续捕获实时图像并显示。
模块若干模式的切换关系如下图。可将进入摄像头模式的操作总结如下:①在表情模式下双击屏幕进入摄像头模式 ,天气时钟模式和聊天模式不支持直接切换至摄像头模式。

(2) 操作说明
- 在表情模式下双击屏幕任一位置,可切换至摄像头模式。

在摄像头模式下,模块会调用摄像头持续捕获实时图像并显示。如无其他操作,模块将始终保持该模式。
在摄像头模式下,单击屏幕任一位置可触发场景理解功能(详见“4.4.9 场景理解”)。
4.4.8 自由聊天
(1) 常规操作说明
在模块上电并配网完成后,用户需要通过说出唤醒词/短按右侧按键唤醒模块,进入聊天模式。
用户可自由发言,模块通过联动云端大模型进行理解并做出文字和语音回复。模块具有记忆功能,支持多轮连续对话。
每一轮用户与模块交互对话结束后(包括唤醒WonderLLM后),模块会持续侦听,若连续1分钟内未识别到用户发言,模块自动结束侦听工作,大模型会回复恰当告别语显示在聊天框界面并同步播报。若用户希望继续交互,需重新以“说出指定唤醒词/短按右侧按键”方式唤醒模块。
在人机交互对话过程中,用户也可主动结束结束对话,可参考如下表述,向WonderLLM模块下达指令:①再见、②好的,就到这里吧,模块收到后回复恰当告别语,结束侦听工作。
WonderLLM模块支持语音打断功能,在模块语音发言时(包括:①模块语音回复用户发言、 ②模块语音向用户问好、 ③模块语音向用户告别),短按右侧按键,模块立即结束本轮语音发言,转而立刻开始侦听用户下一轮发言。
WonderLLM模块支持中英双语种识别/发言,用户可参考如下示例表达,直接切换模块工作语言:①你可以和我说中文吗?、 ②我们可以用英文交流吗?。
(2) 特殊功能调用
模块内置一些特殊功能,可在人机对话交互过程中由用户发言调用。用户可参考如下表述,向WonderLLM模块下达指令,查询当前支持的全部特殊功能:①你能做什么、②介绍一下你的功能,下表已列出当前模块支持的特殊功能:
| 序号 | 功能 | 序号 | 功能 |
|---|---|---|---|
| 1 | 查天气 | 4 | 讲笑话 |
| 2 | 播报新闻 | 5 | 查黄历 |
| 3 | 穿搭建议 | 6 | 放音乐 |
具体怎么调用对应特殊功能,具体请参考“2.1.4 自由聊天”内容学习。
4.4.9 场景理解
NOTE
模块在场景理解功能中,不支持长时间观测,只能在用户下达指令开启该功能后,捕获一张实时图像并对其进行分析。在摄像头模式下,再次双击即可返回表情界面。在用户在摄像头模式单击触发前,模块仅通过摄像头捕获实时画面并显示在屏幕上,不会调用大模型对其进行分析。
(1) 语音交互控制
- 模块上电后,进入表情界面,此时通过说出唤醒词/短按右侧按键进入聊天界面激活模块。
用户可参考如下表述,向WonderLLM模块下达指令:①描述一下你前方看到的东西、②请拍一张照片。
- 模块理解用户指令后,模块摄像头启动捕获一张实时图像并短时间显示在屏幕上供用户确认,对话框返回需调用的图像捕获函数(用户无需关注),之后对话框显示大模型对图像的分析语句并同步播报(回复语句为大模型模块随机生成,仅保证表意恰当)。

(2) 屏幕触摸触发
- 在表情模式下,双击屏幕任一位置,模块进入摄像头模式,此时屏幕实时显示当前摄像头捕获到的前方画面。

- 在摄像头模式下,再单击屏幕任一位置,模块摄像头截取一张实时图像并短时间显示在屏幕上供用户确认,之后恢复至摄像头模式,模块自动播报对图像的分析语句(回复语句为大模型模块随机生成,仅保证表意恰当)。
4.4.10 固件更新
(1) ESP32-S3固件烧录
- 将WonderLLM模块上方Type-C接口通过USB线接入电脑。

- 打开 “附录\WonderLLM烧录工具\ESP32-S3固件烧录工具\flash_download_tool_3.9.7” 文件夹里面的 “flash_download_tool_3.9.7.exe” 文件。

- 选择Chip Type为 "ESP32-S3",其他保持默认,然后点击 "OK"。

- 工具打开后,点击 “...” 选择需要烧录的程序bin文件:打开 附录\WonderLLM固件文件\在线 文件夹里的 WonderLLM在线大模型_V1.9.0.bin 文件。

- 左侧需打勾,其余配置按照下图所示进行配置即可,COM端口号选择模块所占的端口号。

- 先点击 “ERASE” 擦除之前下载的固件(一定要进行),等待状态栏显示 “FINISH完成”。


- 再点击 "START" 下载刚刚选择的固件,等待进度条加载完成,即完成固件下载。


(2) CI1302固件烧录
- 将 WonderLLM 模块下方Type-C接口通过USB线接入电脑。

- 打开 “附录\WonderLLM烧录工具\CI1302固件烧录工具” 文件夹里面的 “PACK_UPDATE_TOOL.exe” 文件。

- 选择 “CI1302” 芯片,然后点击 “固件升级”。

- 点击 “选择固件” 选择需要烧录的程序bin文件:打开 “附录\WonderLLM固件文件\在线” 文件夹里的 “CI1302在线大模型_20260522.bin” 文件。

- 找到相应的串口,并单击选择。

- 接着 “同时按下(长按)” WonderLLM模块左右两个按键(AB),即可进入到烧录中,等待烧录成功。

4.5 WonderLLM离线版
4.5.1 固件更新
(1) ESP32-S3固件烧录
- 将WonderLLM模块上方Type-C接口通过USB线接入电脑。

- 打开 “附录\WonderLLM烧录工具\ESP32-S3固件烧录工具\flash_download_tool_3.9.7” 文件夹里面的 “flash_download_tool_3.9.7.exe” 文件。

- 选择Chip Type为 "ESP32-S3",其他保持默认,然后点击 "OK"。

- 工具打开后,点击 “...” 选择需要烧录的程序bin文件:打开 附录\WonderLLM固件文件\离线 文件夹里的 WonderLLM离线视觉_20260522.bin 文件。

- 左侧需打勾,其余配置按照下图所示进行配置即可,COM端口号选择模块所占的端口号。

- 先点击 “ERASE” 擦除之前下载的固件(一定要进行),等待状态栏显示“FINISH完成”。


- 再点击 "START" 下载刚刚选择的固件,等待进度条加载完成,即完成固件下载。


(2) CI1302固件烧录
- 将 WonderLLM模块下方Type-C接口通过USB线接入电脑。

- 打开 “附录\WonderLLM烧录工具\CI1302固件烧录工具” 文件夹里面的 “PACK_UPDATE_TOOL.exe” 文件。

- 选择 “CI1302” 芯片,然后点击 “固件升级”。

- 点击 “选择固件” 选择需要烧录的程序bin文件:打开 “附录\WonderLLM固件文件\离线” 文件夹里的 “CI1302离线视觉_20260522.bin” 文件。

- 找到相应的串口,并单击选择。

- 接着 “同时按下(长按)” WonderLLM模块左右两个按键(AB),即可进入到烧录中,等待烧录成功。

4.5.2 语音交互模式
- 将两个固件都更新为离线版的固件后,模块先进入 “待命” 状态。

- 在任意模式下,通过长按右侧按键(按键B), 即可进入语音交互模式。

- 用户通过说出唤醒词 (小幻小幻) 方式激活模块进入 “语音交互模式”,模块会用户发 “我在”。

- 进入语音交互模式,模块可根据用户指定的指令,进行定向消息回复,以下是我们常用的语音词条,更多详细词条内容请见附录。
| 语音编号 | 命令词 | 播报语句 |
| / | 小幻小幻 | 我在 |
| / | 增大音量 | 增大音量 |
| / | 减小音量 | 减小音量 |
| / | 最大音量 | 最大音量 |
| / | 中等音量 | 中等音量 |
| / | 最小音量 | 最小音量 |
| 26 | 你好 | 你好 |
| 27 | 介绍自己 | 我是幻尔机器人,能说会跳 |
| 15 | 欢迎你 | 你好,欢迎光临 |
| 1 | 前进 | 正在前进 |
| 2 | 后退 | 正在后退 |
| 3 | 左转 | 正在左转 |
| 4 | 右转 | 正在右转 |
| 9 | 停下/停止 | 收到 |
| 13 | 加速 | 已加速 |
| 14 | 减速 | 已减速 |
| 186 | 向左移动 | 正在左移 |
| 187 | 向右移动 | 正在右移 |
| 18 | 开灯 | 灯已开 |
| 19 | 关灯 | 灯已关 |
| 39 | 亮红灯 | 好的 |
| 40 | 亮绿灯 | 好的 |
| 41 | 亮蓝灯 | 好的 |
| 20 | 打开门 | 门已开 |
| 21 | 关闭门 | 门已关 |
| 24 | 伸出晾衣架 | 已伸出 |
| 25 | 收回晾衣架 | 已收回 |
| 36 | 开风扇 | 好的 |
| 37 | 关风扇 | 好的 |
| 38 | 转动舵机 | 好的 |
| 181 | 显示开心表情 | 好的 |
| 182 | 显示难过表情 | 好的 |
| 183 | 显示无奈表情 | 好的 |
| 184 | 显示期待表情 | 好的 |
- 每一轮用户与模块交互对话结束后(包括唤醒WonderLLM后),模块会持续侦听,若连续1分钟内未识别到用户发言,模块自动结束侦听工作,模块会自动切换为睡眠界面。若用户希望继续交互,需重新以“说出指定唤醒词”方式唤醒模块。

4.5.3 人脸识别模式
在任意模式下,通过短按右侧按键(按键B), 即可进入人脸识别模式。

4.5.4 颜色识别模式
在任意模式下,通过短按左侧按键(按键A), 即可进入颜色识别模式。

颜色ID对应颜色如下:
| 颜色ID | 颜色 |
| 1 | 红色 |
| 2 | 橙色 |
| 3 | 绿色 |
| 4 | 蓝色 |
| 5 | 黑色 |



















































