Appearance
4. 软/硬件指南
4.1 microbit 开发板
4.1.1 简介
micro:bit 是英国BBC牵头,由微软、三星、ARM 等共同参与开发,推出的面向青少年编程教育的微型计算机,尺寸只有信用卡的一半大小。但是,它集成了一个蓝牙、一个加速度计、一个指南针、三个按钮、一个5x5 LED点矩阵以及麦克风。
micro:bit拥有许多开源库和有趣的解决方案 我们可以在网站上查看:
Microsoft MakeCode for micro:bit

4.1.2 microbit开发板引脚分布

4.1.3 microbit开发板参数说明
| 处理器 | Nordic nRF52833 |
|---|---|
| ARM | Cortex-M4 32bit+FPU 64MHz |
| 内存/闪存 | 128KB RAM/512KB Flash |
| 无线 | 2.4Ghz Micro:bit Radio/BLE BT 5.0 |
| 电源 | 5V 通过 Micro USB 端口供电,3V 通过边缘连接器供电 或电池组 |
| 工作电流 | 300mA |
| 尺寸 | 52*43.2mm |
4.1.4 microbit开发板功能分布
如下图所示,其主要有加速度传感器、可编程按钮、引脚、LED 点阵、USB、蓝牙、无线电、电子罗盘(指南针)等板载模块构成。

4.1.5 microbit开发板功能案例
案例一:徽标控制
micro:bit主板上徽标的位置。

(1) 学习目标
通过 micro:bit 主板徽标来实现图案切换。
(2) 程序编写

程序链接:点击跳转 你也可以通过以下网页直接下载程序:
(3) 程序下载

(4) 实现效果
当手触碰徽标时,micro:bit 主板则发出设定的声音,同时点阵滚动显示爱心图案。
案例二:智能温度计
micro:bit主板上主芯片的位置。

(1) 学习目标
通过 micro:bit 主芯片来实现温度检测功能。
(2) 程序编写

程序链接:点击跳转 你也可以通过以下网页直接下载程序:
(3) 程序下载

(4) 实现效果
可用手指轻按 micro:bit 主芯片,当温度超过 30 度时,扬声器便发出声音提示。
案例三:计时器
micro:bit主板上按钮的位置。

(1) 学习目标
通过编程让 micro:bit 按钮实现计时器的功能。
(2) 程序编写

程序链接:点击跳转 你也可以通过以下网页直接下载程序:
(3) 程序下载

(4) 实现效果
开机显示数字 0,按 A 增加数字,按 B 开启每秒递减的倒计时,数字归零后播放打哈欠音效并停止倒计时。
案例四:音乐播放器
micro:bit主板上蜂鸣器的位置。

micro:bit主板上按钮的位置。

(1) 学习目标
通过编程让 micro:bit 按钮实现音乐播放的功能。
(2) 程序编写

程序链接:点击跳转 你也可以通过以下网页直接下载程序:
(3) 程序下载

(4) 实现效果
当程序下载完成后,我们按下按钮 A 则会播放《生日歌》歌曲,按下按钮 B 则会播放《dadadum》歌曲。
案例五:噪音检测器
micro:bit主板上蜂鸣器的位置。

micro:bit主板上麦克风的位置。

(1) 学习目标
通过编程实现声音检测并能做出反馈的功能。
(2) 程序编写

程序链接:点击跳转 你也可以通过以下网页直接下载程序:
(3) 程序下载

(4) 实现效果
当程序下载完成后,我们可以对准 micro:bit 主板上的麦克风说话,点阵会根据检测到的声音强度,通过显示不同的高低矩阵来体现声音强度。
案例六:黑夜报警
micro:bit主板上LED点阵的位置。

micro:bit主板上扬声器的位置。

(1) 学习目标
通过编程实现光线检测并能做出反馈的功能。
(2) 程序编写

程序链接:点击跳转 你也可以通过以下网页直接下载程序:
(3) 程序下载

(4) 实现效果
当程序下载完成后,我们可以将 micro:bit 主板移至黑暗处,点阵屏则显示一个月亮的图案,同时扬声器发出一声提示。
案例七:指南针
micro:bit主板上磁力计的位置。

(1) 学习目标
通过编程实现探测方向并打印箭头的功能。
(2) 程序编写

程序链接:点击下载 你也可以通过以下网页直接下载程序:
(3) 程序下载

(4) 实现效果
在校准完成后,再次手持主板进行不同方向移动,点阵则会显示对应的方向箭头。
4.2 microbit 扩展板
4.2.1 简介
这是一款以micro:bit为核心,支持图形化编程和Python编程的智能主控器。它采用PC塑料外壳封装,板载PWM舵机接口、电机接口、可编程按钮、蜂鸣器等电子模块,并预留多个传感器接口,可拓展性强,统一4PN防反插接口,适配幻尔全系列传感器,使用方便安全。

4.2.2 参数说明
| 产品名称 | microbit扩展板 |
|---|---|
| 产品尺寸 | 88.0mm*55.5mm*35.5mm |
| 充电电压 | 5V |
| 充电电流 | 1500mAh |
| 充电时间 | 1.5h |
| 电池容量 | 2400mAh |
| 最大工作电压 | 8.4V |
| 额定工作电压 | 7.4V |
4.2.3 功能分布

4.2.4 功能案例 : 声控彩灯
声音模块在 micro:bit 主板上的位置。

彩灯在 micro:bit 扩展板上的位置。

(1) 学习目标
通过编程实现智能声控彩灯的效果。
(2) 程序编写

程序链接:点击跳转 你也可以通过以下网页直接下载程序:
(3) 程序下载

(4) 实现效果
开机初始化 DaDabit 并显示网格图标,持续检测环境音量,音量大于等于 50 时两个彩灯随机切换 0-9 对应的色彩,每 100 毫秒刷新一次。
4.3 MakeCode编程环境
4.3.1 编程平台简介
Micro:bit是一款不需要安装IDE的产品,我们只需要在网页中打开Microsoft MakeCode for micro:bit网站就可以编程了。

- IDE设置和工具栏介绍
如果需要创建项目,可点击“新建项目”,然后输入项目的名称。

进入主界面后,我们可以将界面分为以下部分,如下图所示:

| 区域 | 功能 |
|---|---|
| 仿真区 | 用于模拟编程指令块 |
| 标签选择区 | 可使用自带或添加扩展包内的积木指令块 |
| 程序编辑区 | 积木指令块编辑区,可用于插入、复制、粘贴、删除、修改等 |
4.3.2 micoribit官方库介绍
| 指令块 | 所在类别 | 功能说明 |
| 在 micro:bit 的 LED 点阵屏上显示指定数字。 | ||
![]() | 在 micro:bit 5×5 点阵屏点亮自定义排布的 LED 灯珠图案。 | |
| 在 micro:bit 的 LED 点阵屏上显示预设图标。 | ||
| 在 micro:bit 的 LED 点阵屏上滚动显示文本内容。 | ||
| 清除 micro:bit LED 点阵屏上的所有显示内容。 | ||
| 使包含的程序块持续重复运行。 | ||
| 程序的启动入口,设备通电或重启时执行一次。 | ||
| 让程序暂停指定的毫秒数。 | ||
| 检测按键按下状态,作为动作触发条件。 | ||
| 获取按键是否被按下的状态,返回布尔结果。 | ||
| 检测当前环境的声音强度是否达到 “大声” 级别。 | ||
| 检测 micro:bit 正面的徽标触摸按键是否被按下。 | ||
| 获取当前环境的声音响度数值。 | ||
| 读取 micro:bit 主板自带的温度传感器数据,单位为摄氏度。 | ||
![]() | 播放指定音高和时长的音符。 | |
| 停止当前设备正在播放的所有声音。 | ||
| 播放预设音效(如 “咯咯笑”)。 | ||
| 按指定次数重复执行内部的程序块。 | ||
| 当指定条件为假时,执行内部的程序块。 | ||
![]() | 条件判断指令块,根据条件是否成立执行对应分支。 | |
![]() | 条件判断指令块,根据条件是否成立,分别执行不同分支的程序逻辑。 | |
| 对两个数值进行等于比较,判断两者是否相等,返回布尔结果。 | ||
| 对两个布尔条件进行逻辑与运算,只有两个条件同时为真,整体结果才为真。 | ||
| 对两个布尔条件进行逻辑或运算,只要其中一个条件为真,整体结果即为真。 | ||
| 对输入的条件进行逻辑非运算,反转其布尔值。 | ||
| 给指定变量赋予初始数值。 | ||
| 按指定幅度修改指定变量的数值。 | ||
| 对两个数值进行运算法则,返回计算结果,支持加、减、乘、除。 | ||
| 在设定的上下限整数区间内,随机生成并返回一个数值 | ||
-> | 新建自定义函数,封装可重复调用的一段程序逻辑。 | |
![]() | -> | 自定义数组元素并赋值给指定数组变量 list。 |
| 创建无元素的空白数组,用于后续数据存储。 | ||
-> | 判断目标文本内是否包含指定字符,返回布尔结果。 | |
| 将数字、布尔等数据格式转换为标准文本格式。 |
4.3.3 DaDabitv2库介绍
导入库文件
- 点击打开 “扩展” ;

- 在 “扩展” 中搜索
https://github.com/HiwonderK12/DaDabitV2点击添加 “dadabitV2” ;

扩展库介绍
| 指令块 | 所在类别 | 功能说明 |
| 初始化 DaDabit 开发板相关硬件资源。 | ||
| 初始化指定接口的红外避障传感器,为后续检测做准备。 | ||
| 初始化指定接口的光敏传感器,为后续数据读取做准备。 | ||
| 初始化指定接口的数码管,为后续显示做准备。 | ||
| 初始化指定接口的 RGB 灯模块,为后续控制做准备。 | ||
| 初始化指定接口的4路巡线传感器,为后续检测做准备。 | ||
| 初始化指定接口的超声波传感器,为后续测距做准备。 | ||
| 初始化风扇硬件接口,为后续控制做准备。 | ||
| 初始化 WonderLLM 接口,建立模块通信连接。 | ||
![]() | 控制指定编号的乐高舵机,在设定时间内转到目标角度。 | |
![]() | 控制指定编号的乐高电机,按设定的方向和速度运行。 | |
![]() | 设置风扇转速,数值区间为 -100 至 100。 | |
| 在数码管上显示指定的数字内容。 | ||
| 读取光敏传感器采集的光线亮度数据,数值范围为0~100。 | ||
| 获取红外避障传感器的检测状态。 | ||
| 获取4路巡线传感器的检测状态。 | ||
| 获取指定巡线传感器的检测状态,返回布尔结果。 | ||
| 读取超声波传感器采集的距离数据,单位为厘米。 | ||
| 设置发光超声波传感器的彩灯为指定颜色。 | ||
![]() | 配置 AI 模块可调用的自定义功能工具参数 | |
| 向 AI 模块同步 MCP 工具配置信息 | ||
| 告知 AI 模块单次工具调用流程结束 | ||
| 读取 AI 模块调用工具后传回的运行数据 | ||
| 根据指定键,读取字典内存储的数字类型数据 | ||
| 将运算得到的数据回传至 AI 模块进行处理 | ||
| 把数组内全部数据拼接转换为文本字符串 | ||
| 切换 WonderLLM 的工作模式,支持语音交互、颜色识别、人脸识别三种模式 | ||
| 读取语音交互模块中识别到的指令结果编号 | ||
| 播放 WonderEcho 模块中预设的语音播报内容 | ||
| 播放指定类型、编号的 WonderEcho 语音 | ||
| 检测是否识别到人脸,返回布尔结果 | ||
| 获取人脸识别结果的指定参数(如中心 X 坐标) | ||
| 读取颜色识别模块中识别到的、面积最大的目标颜色 ID | ||
| 设置开发板自带的RGB彩灯为指定颜色。 | ||
![]() | 设置开发板自带的RGB彩灯为指定数值对应的颜色。 | |
| 应用并显示已设置的板载RGB彩灯效果。 | ||
| 关闭开发板自带的所有 RGB 彩灯。 |
4.4 电子模块教程
4.4.1 360°积木舵机
1. 简介
这是一款可以兼容各种乐高积木组件的舵机。使用时,我们一般使用 PWM(脉冲宽度调制)来控制。它是连续旋转舵机,通过 PWM 信号可以控制旋转速度和方向,但无法控制具体转动的角度。

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

4. 案例实践
案例一:按键控制360°舵机转动
程序逻辑:按下A键让1号乐高360°舵机以50速度顺时针转动,按下B键让其以50速度逆时针转动,同时按下A+B键则停止该舵机转动。

程序链接:点击跳转 你也可以通过以下网页直接下载程序:
程序下载说明:

4.4.2 270°积木舵机
1. 简介
这是一款可以兼容各种乐高积木组件的舵机。使用时,我们一般使用PWM(脉冲宽度调制)来控制。它是有限旋转舵机,也就是说舵机可以控制旋转角度,但有旋转角度限制,角度范围为0°到270°。

2. 技术参数
| 工作电压 | DC 4.8-6V |
|---|---|
| 额定扭矩 | 1N.m |
| 转动范围 | 0°~270° |
| 产品线长 | 25cm |
| 产品尺寸 | 40mm*16mm |
3. 接线示意图
将270°积木舵机接入 micro:bit 扩展板 接口,注意 线接 , 线接 , 线接 。

4. 案例实践
案例一:270°舵机往复摆动
程序逻辑:将1号270°舵机初始角度设为0度,持续循环让舵机在0度到180度之间来回缓慢摆动。

程序链接:点击跳转 你也可以通过以下网页直接下载程序:
程序下载说明:

4.4.3 风扇模块
1. 简介
这是一款不需要额外的电机驱动板的风扇模块,它的转速可调。你可以配合温度传感器 制作一款智能风扇装置,使其能够根据不同的温度自动调节风扇转速。 同时,模块还板载了乐高兼容孔位,可进行更多创意的 DIY 设计。

2. 技术参数
| 工作电压 | DC 5V |
|---|---|
| 控制方式 | PWM脉冲控制 |
| 接口型号 | 5264-4AW |
| 产品尺寸 | 64.0mm*41.8mm*25.0mm |
3. 接线示意图
- 它支持连接 micro:bit 扩展板上的1/2接口。

4. 案例实践
案例一:按键控制风扇启停
程序逻辑:按下 A 键风扇以速度 80 运转,按下 B 键风扇停止运转。

程序链接:点击跳转 你也可以通过以下网页直接下载程序:
程序下载说明:

4.5.WonderLLM模块
4.5.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.5.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.5.3 音量控制
NOTE
在WonderLLM发言时改变音量,将会在下一轮发言时生效。
(1) 屏幕触摸控制
模块上电并成功连接到外部热点后,可在两种界面下触摸屏幕调整模块音量:①表情界面、②聊天界面。
具体操作方法为:在屏幕任意位置滑动,竖直向上滑动,模块自动增大音量;竖直向下滑动,模块自动减小音量。音量改变幅度取决于屏幕滑动距离,支持多次滑动屏幕调节音量。
在滑动屏幕改变音量时,屏幕正上方会显示实时音量数值,下图以在表情界面上滑增大音量为例:

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

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

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

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

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

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

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


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

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

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

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

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

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

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

- 在摄像头模式下,再单击屏幕任一位置,模块摄像头截取一张实时图像并短时间显示在屏幕上供用户确认,之后恢复至摄像头模式,模块自动播报对图像的分析语句(回复语句为大模型模块随机生成,仅保证表意恰当)。
4.5.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.6 WonderLLM离线版
4.6.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.6.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.6.3 人脸识别模式
在任意模式下,通过短按右侧按键(按键B), 即可进入人脸识别模式。

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

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










