智能视觉小车面向教育科研、机器人创新和嵌入式智能应用验证场景,搭载Quectel Pi H1智能主控板、ROS2软件栈与多传感器硬件,可通过手机App、Docker/ROS环境以及WonderPi 套件实现快速上手。
| 类别 | 支持内容 |
| 硬件平台 | Quectel Pi H1主板 + 扩展板、云台摄像头、超声波、巡线传感器、TT马达、18650 电池盒;语音方案另含 Sipeed MicArray 麦克风阵列、5 寸 HDMI AMOLED 显示屏 |
| 系统/软件 |
Debian 13、ROS 2 Humble;视觉方案使用 WonderPi App,语音方案使用移远 App(移联万物),均支持 Android/iOS
|
| 接口能力 |
I2C9、UART12、GPIO、PWM 舵机接口、四路巡线传感器接口;语音方案另含音频输入输出接口与 HDMI 显示接口
|
| 控制方式 |
视觉方案:手机 App 直连/局域网、ADB/SSH、Docker 容器;
语音方案:语音唤醒与自然语言指令、手机 App(蓝牙配网 + 局域网控制)、ADB/SSH
|
| 主要玩法 |
视觉方案:遥控、目标追踪、取色巡线、二维码识别、智能避障;
语音方案:情感表情、语音对话与闹钟、语音行动控制、人体跟随、视觉识别
|
以下图片提供器材、电子元器件、螺丝与工具的实物参考,便于到货后快速核对与入料管理。






• 用 4 颗M2*5 圆头自攻螺丝,将发光超声波传感器装至超声波支架上。

• 用 2 颗M2*4圆头机械螺丝,将PWM舵机装在底座支架上;用 2 颗黑色M3*6圆头机械螺丝,将组装好的超声波支架装在底座支架上(组装前先把 4 pin线装上)。

• 用 8 颗M3*25机械螺丝和 8 颗M3螺母,将四个TT马达固定在底盘上。

• 用 2 颗M4*8圆头机械螺丝和 2 根M4*28双通铜柱,固定在底盘上。再用 2 颗M4*8圆头机械螺丝将四路巡线传感器固定在底盘上。安装好四路巡线传感器之后,将 4 pin线一端插入传感器接口。

• 用 4 颗黑色M3*6圆头机械螺丝把组装好的底座支架安装在底盘上。

• 用 3 颗M2.5*5单通尼龙柱和 3 颗M2.5*10双通尼龙柱把主板固定好。并将扩展板的排母,对准主板的排针(一一对齐)插入主板中。然后用 2 颗M2.5*6圆头机械螺丝将扩展板和主板固定住。

• 用 4 颗M2.5*6圆头机械螺丝把组装好的主板固定在底盘上,并将四路巡线传感器和发光超声波传感器接到扩展板对应接口上。

• 用 4 颗M3*4平头机械螺丝把电池盒固定在底盘下。

• 联轴器安装在TT马达的轮轴上,并用 4 颗盘头半机牙自攻/M2.3*25螺丝把麦轮与TT马达的轮轴固定住。

• 用 2 颗M2*4圆头自攻螺丝把塑料轴固定在云台U型支架上,接着用 1 颗M2*4圆头自攻螺丝把组装好的云台U型支架安装在小车上。

• 用 2 颗M2*12圆头机械螺丝和 2 颗M2螺母把PWM舵机固定云台摄像头支架上。

• 用 4 颗M2*4圆头机械螺丝和 4 根M2*8滚花铜柱固定在云台摄像头支架上。然后用 2 颗M2*4圆头机械螺丝将摄像头固定在云台摄像头支架上。


• 用 1 颗M2*6圆头自攻螺丝把组装好的云台摄像头支架固定在小车上。

• 将 4 个TT马达接口和 2 个云台舵机的接口(橙色接S(信号线)、红色接+、棕色接-)与扩展板进行连接。

• 安装好后,车体如下。

使用前需要下载相关环境,下载链接如下:
部署环境
下载好部署环境后,将部署环境通过adb push到设备中,再进行解压。
解压后得到以下的目录结构:
• 在Quectel Pi H1智能主控板上,修改qpi-config.ini配置文件。请先执行以下命令打开文件:vi /etc/qpi-config/qpi-config.ini,然后将其内容修改为:
• 输入qpi-config 40pin set,之后重启Quectel Pi H1智能主控板生效。
在以上重启之后,需要插上网线或者连接Wi-Fi,确保处于可联网环境,然后执行部署脚本deploy_container.sh。
部署脚本执行后,如果部署成功,会弹出以下提示:
由于运输途中电池不能充满,所以在初次开机前,建议先给电池充满电,以下是具体充电方法:

安卓:扫描以下二维码进行安装。

iOS:可前往App Store 搜索“WonderPi”并进行下载安装。



注意:
• LED2为电源指示灯,通电时点亮,设备运行过程中是常亮的状态,若灯光变暗则表示电源没电了,需要充电;
• LED1为通信指示灯,设备出厂默认的网络连接模式为直连模式,设备开机成功后,LED1每隔1秒闪烁一次;若将其设置为局域网模式,LED1则会常亮;
• 设备运行过程中,若LED1与LED2灯光变暗,并保持常亮的状态,则表示电源没电了,需要充电。
1. 设备开机成功后,会进入AP直连模式,并生成一个以“HW”开头的热点。在手机上打开手机APP“WonderPi”,依次点击“初级套件”、“TurboPi”。

2. 点击界面右下角的“+”按钮,选择“直连模式”。

3. 点击“去连接设备热点”按键,前往设置界面,连接以“HW”开头的热点,连接时需输入密码“hiwonder”。


4. 连接成功后返回手机APP,稍等片刻,当搜索到下图所示图标时,即为连接成功。(若设备列表下方未显示,可点击右上方的刷新,刷新设备)

注意:若出现“网络不可用,是否继续连接”的提示弹窗,单击“保持连接”按键即可。
5. 点击上图的TurboPi图标即可进入玩法模式选择界面,如下所示:

介绍:该玩法可以实时控制小车运动及超声波的RGB灯;界面分为四个部分,各部分的描述以及功能图标如下所示:

① 状态栏:可以控制玩法的退出、回传画面的截图以及状态栏的隐藏;
② 控制栏:可以控制小车运动(主要介绍控制栏功能);
③ 回传画面:显示摄像头的回传画面,并显示设备的电压值;
④ 超声波RGB灯的调节功能:可以控制超声波模块的RGB灯开启、关闭以及亮起不同颜色的灯。
操作步骤如下描述:
| 界面分布 | 图标 | 对应功能 |
|---|---|---|
![]() |
拖动中间的按钮,可控制TurboPi车体朝各个方向运动。 | |
| 控制栏 | ![]() |
点击或长按此图标,可控制TurboPi车体原地逆时针转动。 |
| 控制栏 | ![]() |
点击或长按此图标,可控制TurboPi车体原地顺时针转动。 |
如需返回到玩法选择界面,点击左上方的返回箭头即可。
介绍:点击“目标追踪”,进入玩法界面。该玩法开启后可以实现小车随着目标颜色的移动而移动的功能。

操作步骤如下:
1. 在以上画面中,点击①处按钮会从“取色”变为“确定取色”,在右边摄像头捕捉的画面中,挪动红色小圆点选中目标颜色,再点击“确定取色”确认颜色;
2. 点击②处“云台追踪”按钮,可启动追踪玩法,此时设备的摄像头将跟随选定的颜色目标运动,车体不动;
3. 若要实现车身跟随的玩法,需要同时选中②处“云台追踪”和③处“车身跟随”这两个按钮,此时设备的车体和云台会跟随选定的颜色目标运动。
注意:
介绍:点击“取色巡线”,进入玩法界面。启动该玩法后,可以让小车沿着黑线或红线前进。

操作步骤如下:
1. 在以上画面中,点击①处按钮会从“取色”变为“确定取色”,在右边摄像头捕捉的画面中,挪动红色小圆点选中目标颜色,再点击“确定取色”确认颜色;
2. 点击②处“开始”按钮,将沿着目标颜色的线条前进。
注意:
介绍:点击“二维码”识别,进入玩法界面。该玩法启动后可以让小车的摄像头识别不同的二维码,执行对应的动作。

① 界面左侧是二维码开关及选择区域;
② 界面右侧是二维码画面。
操作步骤如下:
点击“开始识别”按钮,并选择不同的二维码,将二维码放在设备的摄像头前方进行识别,设备将在识别到不同的二维码之后执行不同的动作。
| 按钮图标 | 功能说明 |
|---|---|
![]() |
小车执行前进动作的二维码 |
![]() |
小车执行后退动作的二维码 |
![]() |
小车执行左移动作的二维码 |
![]() |
小车执行右移动作的二维码 |
![]() |
显示选中的二维码信息 |
注意:
点击“智能避障”,进入玩法界面。该玩法启动后可让小车通过超声波识别前方是否有障碍物并避开。

① 界面左侧避障玩法开关及障碍物阈值设置区域;
② 界面中间是摄像头回传画面区域;
③ 界面右侧是RGB彩灯和电机速度设置区域。
操作步骤如下:
点击“开始避障”按钮,设备将一直前进,检测到障碍物会左转直到没有障碍物,然后继续前进。
| 按钮图标 | 功能说明 |
|---|---|
![]() |
开启/关闭玩法。 |
![]() |
调节障碍物阈值,单位为cm。 |
![]() |
超声波RGB彩灯开启/关闭。 |
![]() |
超声波RGB灯光颜色调节。 |
![]() |
电机速度调节,数值越大,电机速度越快。 |
注意:请勿长时间近距离地检测物体。
与智能视觉小车方案的区别:智能视觉小车使用第三方 App(WonderPi)进行遥控、取色等玩法(详见《智能视觉小车》);本方案使用移远 App(移联万物)完成配网绑定,之后以语音交互为主,也可通过 App 进行小车控制与状态管理。

|
配件名称
|
数量
|
规格参数
|
|---|---|---|
|
Quectel Pi H1智能主控板
|
1块
|
|
|
智能视觉小车套件
|
1套
|
|
|
Sipeed MicArray 麦克风阵列
|
1个
|
|
|
5寸 HDMI AMOLED 显示屏
|
1个
|
ai_tools/。 git clone https://github.com/Quectel-Pi/Expr_Sense_Bot.gitadb devices 能识别到设备;ADB_SERIAL=<序列号>);ai_car_output/(仓库自带,或按文末“从源码编译部署包”自行生成)。ai_tools/ 目录提供 Windows 与 Linux 两套等价的一键部署脚本,自动完成推送、环境修复、ROS2 编译、蓝牙开启与系统服务部署。cd Expr_Sense_Bot/ai_tools chmod +x push_output.sh ./push_output.shcd Expr_Sense_Bot\ai_tools push_output.batai_car_output/ 各目录到设备 /mnt/car_test/;colcon build);hci0;start_car 开机自启服务;首次部署时 40pin 配置需写入 boot 分区,脚本会在结尾自动重启设备(约 1~2 分钟),重启后 40pin、蓝牙、Wi-Fi 与 start_car 服务自动生效,无需人工干预。
adb shell "systemctl is-enabled start_car.service" # 期望输出 enabled adb shell "systemctl status start_car.service" # 查看服务运行状态 adb shell "hciconfig -a" # 期望出现 hci0 adb shell "test -e /dev/i2c-9 && echo 40pin-ok" # H1 40pin i2c9 已使能start_car 服务已配置为开机自启,设备重启后会自动拉起整车功能。需要手动启动时执行:adb shell"bash/mnt/car_test/quecpi_smartcar/service_config/run/start_car.sh"environment-setup-armv8-2a-qcom-linux)的主机上编译,生成完整的 ai_car_output/ 部署包:cd Expr_Sense_Bot source ../environment-setup-armv8-2a-qcom-linux ./build.sh build_sdk # 编译并生成 ai_car_output/ 完整部署树./build.sh build_all,产物为 build/ai_car_demo。仅需部署运行、不修改源码时,可直接使用已有的 ai_car_output/ 部署包,跳过本步。


机器人_5588),点击设备右侧的蓝色 "+" 号,在弹出的界面中选择 2.4GHz Wi-Fi 网络 并输入正确的密码,点击 "下一步":


使用建议:在光线充足的室内环境使用,保持摄像头前方视野清晰、无障碍物遮挡,语音交互时避免环境嘈杂。
下方功能配图均截取自实物操作视频,截图仅作预览;各章节下方附有完整操作视频文件,可在飞书内直接播放或下载查看。运动过程、语音回复及表情变化请以视频为准。

语音行动控制实拍
|
指令
|
小车动作
|
|---|---|
|
"小车前进"
|
四个麦克纳姆轮同步向前转动,车身沿直线向前行驶
|
|
"小车后退"
|
四个麦克纳姆轮同步向后转动,车身沿直线向后行驶
|
|
"小车左转"
|
左右两侧车轮差速反向旋转,小车原地逆时针旋转
|
|
"小车右转"
|
左右两侧车轮差速反向旋转,小车原地顺时针旋转
|
|
"小车停止"
|
电机立即停止转动,小车在当前位置迅速停稳
|
提示:小车配备四个麦克纳姆轮,具备全向移动能力,可实现横向平移及斜向行驶(需对应指令支持)。

观看完整视频:小车表情(约 53 秒)
|
触发方式(示例话语)
|
小远的回复
|
屏幕表情
|
|---|---|---|
|
"今天我很开心"
|
"哇,那真是太好了。什么事让小主人这么开心呀?"
|
开心的笑脸,眼睛向上弯成弧线
|
|
"我中了一个很大的彩票"
|
"哇,小主人运气这么好的吗?那有没有想过要怎么花这笔钱呀?"
|
惊讶的表情,眼睛睁得很大
|
|
"给我做一个委屈的表情"
|
"哎呀小主人,小远同学真的不会做表情啦。要不,你给小远同学变一个?"
|
委屈的表情,眼睛向下弯
|
|
"今天我赔了1000块钱"
|
"哎呀,那小主人今天心情肯定不太好。不过没关系啦……"
|
流泪哭泣的表情,眼睛向下弯,有蓝色泪珠
|
小远同学可以理解自然语言,不仅限于上述表达方式。尝试用自己的语言描述心情或提出问题,小远会做出相应的反应和回复。

观看完整视频:小车对话和闹钟(约 2 分 29 秒)
|
功能
|
说的话
|
小远的回应
|
|---|---|---|
|
语音唤醒
|
"小远同学"
|
发出提示音,蓝色 LED 闪烁,进入监听状态
|
|
天气查询
|
"今天天气怎么样"
|
播报当前天气和气温
|
|
位置查询
|
"我现在在哪里"
|
报出当前详细地址
|
|
音乐播放
|
"给我放首歌"(可指定风格,如"开心的歌")
|
播放对应音乐
|
|
讲故事
|
"给我讲个故事"
|
以拟人口吻讲述童话故事
|
|
结束对话
|
"你退下吧"
|
回复"再见"并退出交互
|

观看完整视频:小车避障(约 36 秒)

观看完整视频:小车人体跟随(约 40 秒)

观看完整视频:小车看图实物(约 1 分 35 秒)
|
玩法
|
怎么做
|
小远会做什么
|
|---|---|---|
|
语音唤醒
|
说"小远同学",确保摄像头前方有清晰的视野
|
摄像头云台转动,表示进入监听状态
|
|
场景识别
|
说"你现在看到了什么"
|
识别窗外等环境场景(建筑、树木、光线等)并描述
|
|
物体识别
|
将物体放在摄像头前,问"你看到了什么"
|
获得物体的颜色和形状描述
|
|
包装识别
|
向摄像头展示物品(如纸巾包装)
|
描述包装的颜色和主要图案
|
|
视觉对话
|
唤醒后进行多轮对话
|
根据摄像头实时画面进行识别和回答
|
|
问题现象
|
可能原因
|
解决建议
|
|---|---|---|
|
搜索不到小车设备
|
1. 手机蓝牙未开启; 2. 小车未处于待配网模式
|
1. 检查并打开手机蓝牙; 2. 重启小车,长按 K1 按键 5 秒使设备进入配网模式(指示灯闪烁)
|
|
配网超时 / 连接失败
|
1. 误连了 5GHz Wi-Fi; 2. Wi-Fi 密码输入错误
|
1. 切换至 2.4GHz Wi-Fi 频段; 2. 仔细检查密码大小写
|
|
设备添加后离线
|
小车与路由器距离过远
|
建议配网时将小车靠近无线路由器
|
提示:手机热点走移动网络,不受现场网络限制。现场遇到小车怎么都连不上云的情况,首选切换到手机热点,实测即时恢复。
|
故障现象
|
排查建议
|
|---|---|
|
避障失效
|
检查传感器是否被遮挡或污染;尝试重启小车并清洁传感器
|
|
运动不稳定
|
检查地面是否平坦;确认麦克纳姆轮是否正常转动
|