乐动掌控2.0 文档

本文引用的文件

• index.rst

• 1_index.rst

• 1_2_Technical_parameters.rst

• 1_3_IO.rst

• 1_index.rst

• 1_index.rst

• 1_xiaozhi.rst

• 1_index.rst

• 1_index.rst

• board.json

• main.py

• boot.py

产品概述

乐动掌控2.0（labplus_Ledong_v2）是基于ESP32-S3双核的高性能开源教学硬件，面向K12创客与AIoT教育场景。板载高清LCD彩屏、ES8388音频解码、QMI8658C六轴传感器、MMC5603磁力计、LTR-308光线传感器、双麦克风、RGB灯、实体与触摸按键、摄像头与电机接口，并内置MicroPython解释器，支持WiFi+蓝牙5通信，便于快速实现语音交互、传感采集、显示控制与物联网应用。

• 目标用户：中小学信息技术教师、学生、创客与教育机器人开发者

• 核心价值：开箱即用的AIoT学习平台；丰富的板载外设与扩展能力；完善的示例与API文档

• 适用场景：语音助手、智能小车、环境监测、人机交互、AI视觉入门、物联网原型开发

章节来源

• index.rst:1-39

核心业务流程

围绕“输入—处理—输出”的闭环，典型流程如下：

• 语音交互：麦克风采集→音频编解码→小智AI或云端服务→播放反馈

• 传感与控制：传感器采样→数据处理→屏幕显示/蜂鸣提示/电机驱动

• 联网与IoT：WiFi连接→网络请求/消息上报→状态更新与可视化

graph TB
A["用户/环境"] --> B["输入设备<br/>麦克风/按键/传感器"]
B --> C["MCU处理<br/>ESP32-S3 + MicroPython"]
C --> D["输出设备<br/>LCD/喇叭/RGB/电机"]
C --> E["网络服务<br/>WiFi/蓝牙/云端AI"]
E --> C

[本图为概念流程图，不直接映射具体源码文件]

功能模块清单

• 硬件模块

  • 音频：ES8388解码芯片与功放，支持录音、播放、TTS等

  • 运动感知：QMI8658C六轴（加速度计/陀螺仪），MMC5603磁力计

  • 环境感知：LTR-308数字光线传感器

  • 显示：ST7789 LCD彩屏

  • 交互：实体按键A/B、电容触摸P/Y/T/H/O/N、RGB灯、蜂鸣器

  • 视觉：30万像素摄像头（GC0328）

  • 扩展：多路HY2.0 4PIN拓展接口、I2C、UART、SPI、PWM、ADC

  • 电源：USB 5V或内置1200mAh锂电池供电

• 软件与工具

  • 编程软件：mPython IDE、Labplus 3、Mind+

  • 固件：基于ESP-IDF v5.x + MicroPython v1.24.1

  • 示例代码：基础IO、网络、传感器、音频、BLE、AI等

  • 小智AI：本地化部署的语音对话助手

  • API参考：TFT显示、MOTION、Pin/Button/Touch、wifi、music、audio等

  • C语言开发：ESP-IDF工程模板与板级配置

  • FAQ：常见问题与技术支持渠道

章节来源

• 1_2_Technical_parameters.rst:1-82

• 1_index.rst:1-36

• 1_index.rst:1-12

• 1_index.rst:1-10

• 1_index.rst:1-22

数据与状态

• 关键数据模型

  • 传感器数据：加速度/角速度/磁场强度/光线值/声音采样值

  • 显示数据：字符/图形/颜色/位图

  • 音频数据：PCM/编码流/录音文件

  • 网络数据：HTTP/MQTT/UDP报文

  • 设备状态：WiFi连接、BLE连接、电池电量、电机状态

• 关键状态流转

  • 音频链路：录音初始化→录制→存储/播放→释放

  • 显示链路：清屏→绘制→刷新

  • 传感器链路：初始化→采样→滤波/校准→输出

  • 网络链路：扫描→连接→认证→收发→断开

• 数据所有权边界

  • 板载传感器由MOTION/Pin等模块统一封装访问

  • 文件系统用于持久化录音、图片与配置

  • 网络模块负责对外通信，业务逻辑在应用层

章节来源

• 1_3_IO.rst:1-54

• 1_2_Technical_parameters.rst:1-82

关键约束与边界

• 硬件约束

  • 工作电压3.3V，最大工作电流约500mA，最大负载电流约1500mA

  • P4为光线传感器专用，P10为声音传感器专用，不可作为通用引脚使用

  • I2C总线与内部传感器共享，外部I2C设备需注意地址冲突

  • 摄像头占用多路GPIO，需避免与其他功能复用冲突

• 软件约束

  • 内存限制：PSRAM 8MB，Flash 16MB，注意大对象与缓存释放

  • 音频与显示同时运行时对CPU与带宽有较高要求

  • WiFi/蓝牙并发使用时需合理调度资源

• 集成边界

  • 小智AI依赖网络与音频链路，需确保麦克风与扬声器正常

  • BLE/GATT服务需遵循标准UUID与特性定义

  • 第三方扩展模块需匹配I2C/SPI/UART等资源

章节来源

• 1_2_Technical_parameters.rst:44-50

• 1_3_IO.rst:1-54

• board.json:1-25

附录：架构与数据流（图示）

sequenceDiagram
participant U as "用户"
participant MIC as "麦克风"
participant CPU as "ESP32-S3"
participant AI as "小智AI/云端"
participant SPK as "扬声器"
participant LCD as "LCD"
U->>MIC : 说话
MIC-->>CPU : 音频采样
CPU->>AI : 语音识别/意图理解
AI-->>CPU : 回复文本/指令
CPU->>SPK : 语音合成播放
CPU->>LCD : 显示状态/结果
CPU-->>U : 反馈

[本图为概念序列图，不直接映射具体源码文件]

附录：示例与上手

• 快速体验

  • 通过mPython IDE将示例程序上传至乐动掌控2.0，验证按键、屏幕、声音、传感器等基础功能

  • 使用示例中的音频、网络、BLE、摄像头等模块进行进阶实验

• 推荐路径

  • basics：repl/io/lcd/buzz/buttons/touchpad/sound/light/accelerometer/gyroscope/wifi/udp/uart

  • advance：iot/random/timer/radio/i2c/thread/filesystem/ble

  • AI：AudioAI、Agent、ImageAI（摄像头）

章节来源

• 1_index.rst:1-36

• main.py:1-597

• boot.py:1-6

附录：小智AI

• 简介：基于ESP32-S3的本地化语音对话助手，支持唤醒词检测、实时翻译、响应式交互

• 快速上手：提供免编译固件，烧录即可使用；具备多轮对话与情感化语音交流

• 开源信息：xiaozhi-esp32项目，降低AI开发门槛，助力边缘计算原型构建

章节来源

• 1_xiaozhi.rst:1-31

附录：API参考索引

• 显示：TFT_displayer（DispChar/DispChar_font/clear/show）

• 运动：MOTION（Accelerometer/Gyroscope/Magnetic）

• 引脚与交互：MPythonPin、Button、Touch

• 网络：wifi（connectWiFi/disconnectWiFi/enable_APWiFi）

• 音频与音乐：music、audio（录音/播放/音量/TTS）

• 无线：radio（发送/接收/配置）

• 扩展：BLE、摄像头、文件系统、MQTT等

章节来源

• 1_index.rst:1-10

附录：C语言开发

• 构建系统：ESP-IDF v5.x + CMake

• 板级配置：board.json定义特性与部署说明

• 工程入口：main.c与组件组织遵循ESP-IDF规范

• 建议：优先使用MicroPython快速原型，复杂算法或底层驱动采用C/ESP-IDF实现

章节来源

• board.json:1-25

附录：FAQ与技术支持

• 联系方式：论坛、QQ群、服务热线与服务时间

• 常见问题：可在FAQ页面查阅或提交问题获取帮助

章节来源

• 1_index.rst:1-22