小智AI Mixly软件Micropython图形化开发 AiTall_V3人工智能应用开发板
概述
​ AiTall_V3人工智能应用开发板是一款面向人工智能入门学习、项目原型开发及场景化应用落地的高性价比开发板。它以高性能双核ESP32S3为主控制核心，整合了丰富的硬件接口与便捷的编程环境，齐护全套AI编程体系兼顾兼容性与可扩展性，旨在满足学生人工智能编程学习、开发者及创客等各类人群的需求，助力快速实现人工智能项目的开发与落地。

​ 齐护提供了全体系的开发软硬件，其中软件兼容市场上所有小智AI的ESP32-S3 N16R8开发板，用户可以采用任意开源硬件结合齐护软件自行学习，也可以采用体系化更好的AiTall V3或AiTall开发者版本进行学习。

1.1 核心硬件配置
主控模块：搭载 ESP32-S3 N16R8 (16MB Flash, 8MB PSRAM)提供强劲算力，内置wifi、蓝牙。
音频系统：板载麦克风与扬声器（基于 ES8311 芯片），无需外接音频设备即可实现语音采集与播放，可外接3.5耳机/音箱，大幅降低语音交互类 AI 项目的硬件门槛。

ESP32S3-N16R8 核心模组
1.2 编程支持
在线编程：齐护提供 Mixly 3.0 (MicroPython) 在线编程环境。
双模体验：提供图形化编程以降低入门门槛，同时支持代码编辑以满足进阶开发需求，大幅提升开发效率。
直连云端：新增特性——支持直接在 AiTall_V3 上进行在线编程(将AI对话与外部设备的控制在一个主板上实现)。作为实时语音交互客户端，它能直接与云端服务器（支持多平台及自定义接口）的智能体进行语音互动，并通过 MCP 协议 实现可编程的物联网控制。

Mixly3.0在线版
1.3 接口与扩展
显示接口：预留 OLED 与 TFT 双显示屏接口(2.54杜邦标准母座)，兼容市面常用型号（小尺寸 1306-OLED 或大尺寸7789- TFT），无需额外设计接口电路。

IO 引出：所有 IO 口全部引出(2.54杜邦标准排针)，每组都有5V-GND电源方便扩展。

完美兼容：核心优势之一是完全兼容 AiTall_V1 开发者版 的所有扩展 GPIO 及扩展板应用。

AiTall V3开发板

AiTall_V1开发者版
1.4 独立供电系统
分离式设计：音频芯片与控制芯片采用独立供电，有效避免模块间干扰，保障音频播放与系统运行的稳定性。
强劲输出：支持 5V 独立外部电源输入，理论最大电流 5A，稳定输出 3A。充足的供电能力可驱动多个拓展模块及高功耗设备，满足复杂项目需求。
DIY个性化应用: 麦克风可拆外接设计（R15-16拆除后可自焊MEMS麦克风）或自定义外接拾音器（麦克风），多种显示屏任意组合。
1.5 可外接3.5耳机接口
AiTall V3内置喇叭，也可以通过3.5耳机接口将音频信号外接到外置的音箱或耳机。

1.6 兼容市场常用开发板
AiTall V3软硬件全套应用体系兼容市面上常用的小智开发板，可采用各种麦克风及显示屏实现小智AI体系的接入。

总结
AiTall V3 集强劲性能、便捷操作、高兼容性于一体，既解决了初学者硬件搭建与编程入门的难题，也满足了开发者进阶开发与场景落地的需求，广泛应用于智能语音交互、物联网控制、AI 应用项目的视觉展示等领域。

二、AiTall V3开发板参数
2.1 电气参数
参数项 规格说明
DC 输入电源 DC 7-12V
USB 电源 DC 5V
对外输出电源 DC 5V MAX:5A 建议3A
喇叭规格 3W (4Ω / 8Ω)
2.2 引脚定义表
开发板的的各主要元件用到的对应的GPIO，主板丝印带有三角标的为内部元件用，使用时注意复用的影响！

模块端口名称 GPIO引脚 说明
SD_MOSI 47 SD卡
SD_MISO 9 SD卡
SD_CLK 21 SD卡
SD_CS 10 SD卡
ES8311_MCLK 4 ES8311
ES8311_BCLK 5 ES8311
ES8311_WS 6 ES8311
ES8311_DIN 7 ES8311
ES8311_DOUT 15 ES8311
ES8311_SCL 17 ES8311
ES8311_SDA 16 ES8311
OLED_SCL 17 OLED
OLED_SDA 16 OLED
TFT_SCL/SCLK 21 TFT
TFT_SDA/MOSI 47 TFT
TFT_RES 45 TFT
TFT_DC 40 TFT
TFT_CS 41 TFT
TFT_BLK 42 TFT
BOOT 0 按钮

AiTall V3 PCB 端口
重要提示

ES8311为音频的解码的编码芯片,负责音频的输入(录音)输出。

OLED和TFT与市面上部分屏引脚一致，可直插使用，安装前请检查引脚标识是否对应正确，错误可能导致屏幕烧毁。

在不使用TFT的时候，IO口可作为普通IO使用。

TFT与SD卡共用SPI总线。

ES8311与OLED共用IIC总线。

三、编程库图形块功能说明
软件:在线Mixly 3.0

库位置：选择首页主控芯片 Python ESP32-S3 -> 右上角型号选 AiTall V3 -> 左侧栏找到 AiTall小智AI V3。

⚠️ 学习建议：使用库前请充分了解程序工作原理、控制流程及软硬件要求。保持耐心、细心，切勿急于求成。

AiTall V3 在线编程模块通过 WebSocket 技术实现超低延迟语音交互，并依托 MCP 协议 完成对本地设备的智能化控制，同时可以结合使用各类传感器或执行器！
3.0 AI对话唤醒与自定义命令词
语音唤醒设备功能及自定义命令词（识别词）。

启用语音唤醒：可选择自己喜欢的唤醒词，或选择【无】代表不使用内置的唤醒词。

回复：选择【是】当唤醒后会有一个提示音，【否】为无提示。

命令词列表：可以通过点击模块上的【齿轮】图标添加多个命令词，具体支持多少个不确定，用户自行测试，数量不宜过多，否则可能超出运行内存限制！

命令词（中文）：命令词（中文）即识别关键词，请勿过长，不可包含符号或英文，系统会自动转为拼音识别。

回调：自定义一个回调函数，当识别到对应的命令词时为真，否则无输出。如下图中的【command_callback】

⚠️ 注：编程时可以用或不用这个模块，如果不用代表不采用语音唤醒的功能！该模块必须放在【AI 对话】模块上方，否则无法生效。

小技巧：可以通过命令词实现自定义唤醒词，具体请查看教程实例。

3.1 AI对话编程块
用于配置并启动 AI 对话服务。

授权码：第四章 授权码

服务端：填入接入平台的 OTA 地址（下拉菜单中支持多平台，也支持自定义）。

模式

注：因ESP32的资源有限，V3在线编程固件不支持直接麦克风的语音唤醒（出厂齐护V1.0固件可以），启动对话或唤醒方式采用外部IO或内部发送对话的方式实现！

唤醒对话：按下按钮后进入连续对话状态。
按住对话：按住说话，松开即发送语音（有的S3IO不支持，使用时发现用不了就换一个IO口）。
注：两种模式可分别绑定不同的按钮引脚同时存在，在块齿轮中增加即可。
麦克风配置

内置 ES8311：AiTall V3 主板内置默认选项。

拾音器：外接齐护拾音器模块。

齐护拾音器（外接）

注：拾音器的电源正负极一定要接对！否则会烧坏传感器！（齐护4P线：红-5V 绿-GND 黑-CLK 白-DTA)

I2S：适用于 AiTall V1 或其他 I2S 麦克风。

扬声器配置

内置 ES8311：AiTall V3 默认选项（支持音量调节，通常建议小于80使用）。
I2S：适用于 AiTall V1 或其他 I2S 解码扬声器（不支持音量调节）。
显示屏支持：TFT -7789(240x320、齐护TFT、240x240), OLED-1306 (128x32, 128x64建议用64屏可以显示全内容), 【齐护OLED模块】或无屏模式。

配置编程块：

⚠️ 线程警告：执行此块时，当前线程将被占用（阻塞），无法运行其他程序。若需同时运行其他逻辑（如传感器读取、灯光控制），必须新建线程来执行其他任务，且其他程序应尽量轻量化以减少资源占用。

将鼠标放到编程块上2秒后会自动显示IO配置及注意事项说明等，用户自有的主板可以参考接线！

3.2 定义MCP函数
通过 MCP 协议注册设备功能，使上层 AI 模型能“理解”并“调用”ESP32 硬件功能。

作用：向云端服务（如小智云平台）声明设备具备的功能、所需参数及返回格式。
原理：相当于硬件与 AI 服务之间的“功能调用说明书”。

参数详解：

名称 (ID)

：功能的唯一标识（如 living_room_light，一定要用英文）。

要求：全局唯一、语义清晰（避免 func_001）、格式规范（建议：位置_功能_类型）。
功能描述

：用自然语言简述功能用途（如“控制客厅主灯的开关”），供 AI 匹配用户指令。

要求：简洁明确、覆盖核心场景、语言统一（全中或全英）。
MCP 函数参数

：定义控制该功能所需的输入参数。

参数名：有意义的名词（如 state, speed, color）。
类型：字符串、数值、布尔值、对象（键值对）、数组（列表）。
描述：参数的具体含义及取值范围设定。
默认值：当 AI 未返回该参数时的默认值（可选）。
返回：执行结果反馈给 AI 服务的信息（如 “success”, “failed” 或当前状态值），用于确认执行状态。

3.3 文字对话
将文本内容作为对话发送给语音助手。

唤醒对话：发送后助手保持连续对话状态。
按住对话：回答完毕后自动进入待机状态。
⚠️ 注：发送的内容要尽可能的短，用小智平台时不超10个中文字符或20个英文字符，其它平台不受限制！

3.4 显示文本
发送自定义的内容在显示屏上，通常在进入【待机中…】时显示自己的内容时用（提示语、传感器信息等）。

3.5 读取状态
读取AI语音助手的当前工作状态：初始化，聆听中，待机中，语音合成中（回复说话中）

3.6 获取对话内容
接收并处理语音交互返回的文本消息（变量 messages）对话内容。

触发条件：当有新的消息产生时执行。

位置要求：此代码块必须放置在 AI 对话块 之后才能生效

四、授权码
如何获得授权码：

AiTall V3：授权码 激光蚀刻在开发板正面，请直接查看实物。

AiTall V1：与原出厂固件激活码相同（可找客服人员提供）。

其他市场通用开发板或面包板：请扫码关注【齐护教育机器人】微信公众号在【系统器材】—【AI系统】中找到【160001101齐护许可验证授权码】产品获得。输入设备MAC地址时一定要使用全大写字母的方式！（参考【初次始用快速说明】得到正确的设备码）

注：如要批量使用商务合作可联系相关客服人员采用批量授权使用。

五、出厂固件与初始化
5.1 固件版本说明
出厂默认固件：AiTall V3 出厂预装 V1 版本固件，完全兼容所有 V1 版本的教程与实例，请采用齐护TFT屏配合使用。若使用出厂固件，请参考 【V1 版本】的相关教程文档。
在线编程固件：本指南后续教程主要介绍 AiTall V3 新增的在线版本AI应用编程（基于 Mixly 3.0）。
Mixly3.0在线版地址: https://mixly.qdprobot.com/

5.2 固件初始化步骤
如果要把AiTall V3当开发板用，那么使用前要先【初始化固件】一次，第二次开始只要直接【上传】程序即可！

方案 A：齐护AiTall V3使用在线编程
访问 Mixly 3.0 在线版。
开启首页上或进入软件后点左上角【Mixly】字样回到首页选择主板类型：Python ESP32-S3。
右上角下拉菜单中选择具体主板型号：AiTall V3。
点击右侧 【初始化固件 】按钮进行烧录，烧录完成后按一下RST或断电一次后再上传运行程序（左上角）【上传】。
如果上传不了请采用如下方法解除运行程序：按住主板上的BOOT键—再按一下RST键—全松开，再按住BOOT键同时点软件上的【初始化固件 】—放手，正常上传。
方案 B：AiTall V3恢复出厂固件（V1 功能）
若需使用 出厂固件V1 版本功能或不使用在线编程：

访问 Mixly 3.0 在线版。

开启首页上或进入软件后点左上角【Mixly】字样回到首页选择主板类型：Python ESP32-S3。

右上角下拉菜单中选择具体主板型号：AITallV3_1.0小智。

点击右侧【 初始化固件 】按钮进行烧录。

如果上传不了请参考【方案A 5.】相同的方法操作。

激活：参考【AiTall V1.0激活方法】，激活码就是印在主板上的【授权码】。

注意：固件上传完成后，必须按下开发板上的 RESET 键 或 断电重启，新固件才会生效。

方案 C：第三方主板或通用面包板
编程软件支持任意ESP32S3-N16R8为主控的开发板编程用，如果要用齐护小智AI编程，只要跟AiTall V3配置一样都可以直接如上使用，只是一定要得到自己主板对应的授权码（一个主板一个码，不能通用），关于怎么得到授权码请查看【五、授权码】。

关于Mixly软件中下拉选项中的固件说明：

1、【ESP32S3 Generic】：用于【ESP32S3开发板】用此软件图形化编程时用的固件（包括AiTall主板），无小智AI功能，纯自行编程开发用！

2、【AiTall V3】：用于【ESP32S3/AiTallV3开发板】用此软件图形化编程且可以小智AI融合编程（包括AiTall V1主板），自行编程开发应用！

3、【AiTall V3-1.0小智】：用于齐护【AiTall V3主板】恢复出厂的AiTall V1.0固件（不可以用此软件编程，只是用此软件方便上传固件）唤醒词：你好小智，有串口通信、有MQTT、有MCP功能、有本地IOT（IO端子）的设备控制功能，要用激活码（印在板子上的授权码）。

4、【AiTall V1.0】:用于齐护【AiTall V1.0主板】恢复出厂的AiTall V1.0固件（不可以用此软件编程，只是用此软件方便上传固件）唤醒词：你好小智，有串口通信、有MQTT、有MCP功能、有本地IOT（IO端子）的设备控制功能，要用激活码。

5、【AiTall V2.0横屏/AiTall V2.0竖屏】：用于齐护【AiTall V1.0主板】升级到小智2.0系统（不可以用此软件编程，只是用此软件方便上传固件）唤醒词：你好小智，无串口通信、无MQTT、有MCP功能、无本地IOT（IO端子）的设备控制功能，可在小智后台自定义唤醒词及UI表情等，主要用于对话场景，不要用激活码。

6、【AiTall V2_Pro】:用于恢复齐护【AiTall Pro主板】出厂固件小智2.0系统（不可以用此软件编程，只是用此软件方便上传固件）唤醒词：你好小智，无串口通信、有MQTT、有MCP功能、无本地IOT（IO端子）的设备控制功能、有摄像头功能，可在小智后台自定义唤醒词及UI表情等，主要用于对话及编程场景，要用激活码。

六、编程示例
初次使用快速说明
1.打开在线齐护Mixly软件: https://mixly.qdprobot.com， 选择： Python ESP32-S3 ， 与教程【5.2方案 A】方法一样。

2.右上角选择编程主板：AiTall V3

3.连接设备USB后，软件左上角【添加设备】—选择主板USB----【连接】----软件的右上角会显示 【serialX】字样,如果没有显示请检查（一定要用有数据功能的USB线）

4.软件右上角【初始化固件】直到显示完成！（约要1分种，这个动作只是在第一次编程时才要操作，后面都不用，直接执行到下一步就好）

5.从【网络】中找到wifi块并输入你的帐号信息，在【AiTall小智AI V3】中找到对应块，如果你的主板是AiTall V3，在主板表面找到授权码输入，选择对应的配置，如果是其它主板还没有授权码，随意选一个TFT或无屏配置后（如果没有接OLED就不要选OLED,否则初始化会报错），直接先上传程序，软件左上角【上传】！

6.如果你的主板不是齐护AiTall V3或授权码输入错误上传后，点软件左上角的【串口】，设备连网后会显示’授权码错误’，检查重新输入正确的授权码再次上传，非齐护主板的将打印出的【MAC地址】原样复制（注意区分大小写），然后按照第四章 授权码 的方法得到正确的授权码。

7.AI平台的应用及注册：本编程系统可以支持多个平台，如果你的设备没有在对应的平台注册，那么上传后也会打印提示消息，方法同上，上传程序后打开串口查看。如图是小智AI平台及灵矽AI平台的提示消息，按提示到对应到对应的平台注册帐号并输入显示的设备码即可正常使用了。具体的各平台的个性化AI对话内容可以参考【AiTall V1.0】的教程学习更多。

以下示例展示采用本图形化编程系统的不同场景下的应用方法，请根据实际硬件连接调整引脚和模块设置。

注：如果您使用出厂固件【AiTall V3-1.0小智】，请采用齐护TFT屏配合使用，参考 【V1 版本】的相关教程文档。
6.01 开发者版AiTall V1
使用AiTall V1开发板全内置功能测试服务器端使用灵矽平台的AI对话，MCP协议定义RGB彩灯，使用语音控制客厅的灯开或关。

服务端：灵矽

主板：AiTall V1

模式：按下BOOT开始连续对话

麦克风：内置I2S麦克风

扬声器：内置I2S扬声器

显示屏：内置TFT显示屏（240*320）

程序:

MCP参数设置：

设置为开关灯动作，类型值为数值，那么智能体会以1或0来返回灯的状态，同时程序中返回action，表示将原状态返回给智能体，表示开关灯执行成功，让智能体知道当前变量的执行情况。

6.02 开发者版AiTall V1_拾音器
在有些场景下我们要把麦克风外接在适当的区域，这样可以更灵敏的接收对话信息，这时我们可以选择用齐护拾音器的配置试，服务器端使用小智平台的AI对话，MCP协议定义LED灯，使用语音控制房间的灯开或关。

服务端：小智

主板：AiTall V1

模式：按下BOOT开始连续对话

麦克风：齐护拾音器（外接）

扬声器：内置I2S扬声器

显示屏：内置TFT显示屏（240*320）

程序:

MCP参数设置：

设置为开关灯动作，类型值为字符串，那么智能体会以1或0来返回灯的状态，同时程序中返回"success"，智能体会理解为执行成功。

6.03 AiTall V3_240X320TFT
服务器端使用小智平台的AI对话。

服务端：小智

主板：AiTall V3

模式：按下BOOT开始连续对话

麦克风：内置ES8311

扬声器：内置ES8311

显示屏：齐护2.4寸TFT

注：TFT的MISO端子不用接，其它按丝印对接。使用时背景为黑色，字为白色。

程序:

6.04 V3_240X240TFT
服务器端使用小智平台的AI对话。

服务端：小智

主板：AiTall V3

模式：按下BOOT开始连续对话

麦克风：内置ES8311

扬声器：内置ES8311

显示屏：1.54寸TFT液晶显示屏，一定要采用与图片相同端子布局的屏才可以用！

程序:

6.05 V3_32OLED
服务器端使用小智平台的AI对话。

服务端：小智

主板：AiTall V3

模式：按下BOOT开始连续对话

麦克风：内置ES8311

扬声器：内置ES8311

显示屏：128X32OLED

注：显示两行对话内容，有时当对话内容太长时将无法显示。

程序:

6.06 V3-拾音器
外接麦克风时用，服务器端使用小智平台的AI对话。

服务端：小智

主板：AiTall V3

模式：按下BOOT开始连续对话

麦克风：齐护拾音器（外接）

注：拾音器的电源正负极一定要接对！否则会烧坏传感器！（齐护4P线：红-5V 绿-GND 黑-CLK 白-DTA)

扬声器：内置ES8311

显示屏：128X32OLED

程序:

6.07 V3-发文字对话
按钮按下,发送短文字对话查询当天的天气，注意发送的文字不能太长，间隔一定的时间，否则可能导致程序卡死或无法执行。用小智平台时不超10个中文字符或20个英文字符，其它平台不受影响！

服务端：小智

主板：AiTall V3

模式：按下BOOT开始连续对话

麦克风：内置ES8311

扬声器：内置ES8311

显示屏：128X32OLED

按钮：上拉输入，按下为低电平。

程序:

AI对话因为是阻塞线程，所以要使用其他程序需要增加新的线程，一定要记得给按钮做防抖。

6.08 V3-读取对话
读取AI对话内容，根据对话内容执行对应操作。

服务端：小智

主板：AiTall V3

模式：按下BOOT开始连续对话

麦克风：内置ES8311

扬声器：内置ES8311

显示屏：128X32OLED

程序:

接收消息块必须位于AI对话块后面

6.09 V3-语音唤醒
使用外接离线语音识别模块接收语音指令，识别到唤醒和退出后发送文字给AI平台，达到语音唤醒和退出功能。或其它离线控制 功能，同时因齐护语音识别模块可以自定义唤醒词及识别词，这样就可以实现AI唤醒词的个性自定义。

注：当结合使用语音识别模块时，如果不想听到语音识别模块的回复音，可以开启语音识别模块的静音模式，这样在对话时就不会有两种语音产生冲突。具体可以参考【齐护语音识别模块V2.2】的使用教程。

服务端：小智

主板：AiTall V3

模式：按下BOOT开始连续对话

麦克风：内置ES8311

扬声器：内置ES8311

显示屏：128X32OLED

语音识别模块：齐护语音识别模块

程序:

6.10 V3-AI状态64OLED
在有的项目编程时我们要在AI的某种状态时才执行一些程序 ，这时我们的程序就要随时知道AI当前是什么状态，该示例展示了AI状态块的作用。

注：由于ESP32的资源有限，连续的打印或执行死循环会影响主程序的运行，只在变化时执行一次。一定不要直接读取状态去执行某个动作，这样会占用全部资源从而导致AI无资源可用而中断运行！

服务端：小智

主板：AiTall V3

模式：按下BOOT开始连续对话

麦克风：内置ES8311

扬声器：内置ES8311

显示屏：128X64OLED或【齐护OLED模块】

程序:

AITall运行语音对话程序时资源占用比较大，其他程序应该尽量的轻量化，以免影响主程序的运行。

6.11 V3-RGB灯
MCP协议定义RGB彩灯，使用语音控制客厅的灯开或关。

服务端：小智

主板：AiTall V3

模式：按下BOOT开始连续对话

麦克风：内置ES8311

扬声器：内置ES8311

显示屏：齐护2.4寸TFT

RGB模块:齐护RGB模块

程序:

MCP参数设置：

设置为开关灯动作，类型值为数值，那么智能体会以1或0来返回灯的状态，同时程序中返回action，表示将原状态返回给智能体，表示开关灯执行成功。

6.12 V3-RGB变色
MCP协议控制RGB彩灯，MCP函数参数中增加R，G，B颜色参数，可语音指令控制RGB的颜色变化。

服务端：小智

主板：AiTall V3

模式：按下BOOT开始连续对话

麦克风：内置ES8311

扬声器：内置ES8311

显示屏：128X32OLED

RGB模块:齐护RGB模块

程序：

MCP参数设置：

三个参数都为数值型，在描述中描述属性作用和数值范围。

6.13 V3-灯号变色
与6.12程序类似，MCP协议控制RGB彩灯，MCP函数参数中增加R，G，B颜色参数和灯号参数，可语音指令控制RGB每个灯的颜色变化。

服务端：小智

主板：AiTall V3

模式：按下BOOT开始连续对话

麦克风：内置ES8311

扬声器：内置ES8311

显示屏：128X32OLED

RGB模块:齐护RGB模块

程序：

MCP参数设置：

四个参数都为数值型，在描述中描述属性作用和数值范围。

6.14 V3-IO控制
定义MCP平台多路插座，说“打开插座1号”，说出对应插座编号对IO进行开关操作。

服务端：小智

主板：AiTall V3

模式：按下BOOT开始连续对话

麦克风：内置ES8311

扬声器：内置ES8311

显示屏：128X32OLED

MCP参数设置：

插座参数分为编号和状态两个。

6.15 V3-舵机
MCP协议控制舵机角度。

注：当开发板接大舵机时一定要外接电源（电池）并打开电源开关，如果只有USB供电很可能因供电不足引发主板不能正常工作！

服务端：小智

主板：AiTall V3

模式：按下BOOT开始连续对话

麦克风：内置ES8311

扬声器：内置ES8311

显示屏：128X32OLED

舵机模块:齐护舵机模块

程序：

MCP参数设置：

舵机属性描述，数值型，描述中说明取值范围。

6.16 V3-读传感器
使用MCP定义一个温湿度传感器设备，通过语音询问“房间温度”，“房间湿度”。

服务端：小智

主板：AiTall V3

模式：按下BOOT开始连续对话

麦克风：内置ES8311

扬声器：内置ES8311

显示屏：128X32OLED

传感器:[AITall扩展板](https://wiki.qdprobot.com/?file=wiki-libs/zh-hans/001-齐护硬件/0001-主板/0013-AiTall C03/002-2、AiTall拓展板)

扩展板与开发板使用IDC排线连接，请注意连接方向。扩展板要连接电源或将端子边上（USB侧）的空贴片电阻位两个脚短接焊在一起（采用AiTall V3的供电），否则程序会因读写错误而中止。

程序:

MCP参数设置：

温湿度传感器有两种值(温度和湿度)，因此要其返回是询问温度还是湿度，通过判断询问条件返回对应值给语音平台端。

6.17 V3-多设备
MCP协议控制多个设备示例，分别为客厅的灯和外面的灯，两个灯属性相同。同理可以同时定义多的MCP控制设备或传感器等。

服务端：小智

主板：AiTall V3

模式：按下BOOT开始连续对话

麦克风：内置ES8311

扬声器：内置ES8311

显示屏：128X32OLED

程序：

6.18 V3-MixIO互动
在MixIO端实现与AI互动聊天

服务端：小智

主板：AiTall V3

模式：按下BOOT开始连续对话

麦克风：内置ES8311

扬声器：内置ES8311

显示屏：128X32OLED

关于Mixio可以点这里了解更多。

在Mixio新建[文本显示屏]和[文本输入]组件，主题分别为“text”和“keyboard”。用于输入和显示对话，保存后运行。

可共享项目后，使用手机或电脑访问网页，实现远程AI对话。

程序：

多个平台连接有可能出现MixIO掉线的情况，在执行中加入了掉线重启程序。

6.19 V3-DB数据
使用MixIO实现的设备之间的数据共享

另一块 ESP32 开发板（主机 A）作为远程端传感器，定时采集数据上传到MixIO DB数据库（例如鱼缸监视系统，采集水温，含氧量）。

AiTall新建MCP设备为鱼缸监视系统，通过语音查询鱼缸状态。“我的鱼缸温度是多少？”，“鱼缸含氧量是多少？”

服务端：小智

主板：AiTall V3

模式：按下BOOT开始连续对话

麦克风：内置ES8311

扬声器：内置ES8311

显示屏：128X32OLED

程序：

MCP参数设置：

检测仪有两种值(温度和含氧量)，因此要其返回是询问温度还是含氧量，通过判断询问条件返回对应值给语音平台端。

Mixio TinyDB数据管理（每个帐号都有）

6.20 配网连接与双对话模式
采用配网的方式给AiTall V3设置wifi连接帐号，并采用两个按钮来设置对话模式，一个是连续对话，一个是按住对话（松开即发送）（要注意有的IO不支持这种工作模式，如果发现不能工作请更换IO，这是ESP32S3的GPIO特性问题）。

主板：AiTall V3

按钮：齐护机器人双按钮模块

模式：按下IO-11开始连续对话,按住IO-8说话，放手发放

麦克风：内置ES8311

扬声器：内置ES8311

显示屏：128X64OLED

配网说明：

原先是直接输入了wifi名及密码，这里是要另外用手机或电脑配网，这样做是为了方便设备在不同的场景下（换了wifi帐号）用时不用再次更新程序（换wifi名），只要在重新配网即可！相同环境下只要配网一次即可，会自动记忆最后一次的wifi。

程序：

6.21 V3_AI读写TF数据
在与AI交互时我们时常会让他帮我们存储或读取一些数据，AiTall V3主板内置有TF卡设计，我们可以通过它来帮我们存储数据内容，并通过AI的交互进行读写。

主板：AiTall V3

模式：按一下IO-0 BOOT键开始连续对话,按住IO-8说话，放手发放

麦克风：内置ES8311

扬声器：内置ES8311

显示屏：128X64OLED或【齐护OLED模块】

编程注意问题说明：

因SD卡用的是SPI的方式，如果显示屏也用TFT内置的配置，会有内部程序结构的冲突，故当需要通过TF卡进行数据交互时，请采用OLED屏。或自行手动修改代码（调整SPI初始化位置）。

程序：

6.22 V3_显示自定义内容
在与AI交互时，当完成与AI的交互后我们时常会让他显示本地的一些传感器数据或自定义的文字内容，这时我们可以采用【显示文本块】来实现这个功能。

当程序进入待机状态时显示自定义的内容！

主板：AiTall V3

模式：按一下IO-0 BOOT键开始连续对话

麦克风：内置ES8311

扬声器：内置ES8311

显示屏：128X64OLED或【齐护OLED模块】

编程注意问题说明：

因为待机时系统会有一个自己的显示，为了不冲突，所以编程时要适当的延时一会后再显示自定义的内容，否则可能显示不成功。

程序：

6.23 V3_播报自定义内容
在与AI交互时，我们时常会让AI读取本地传感器的信息或结合其它信息来设计播报提醒，这时我们可以通过发送文字给AI并让其复读相关内容来实现！

主板：AiTall V3

模式：按一下IO-0 BOOT键开始连续对话

麦克风：内置ES8311

扬声器：内置ES8311

显示屏：128X64OLED或【齐护OLED模块】

编程注意问题说明：

此功能不可以用【小智】AI平台，请采用其它平台应用！

程序：

6.24 V3_对话设置定时器
在对话时让AI帮设置一个定时器，当时间到时触发条件进行自动执行或语音提醒。

主板：AiTall V3

模式：按一下IO-0 BOOT键开始连续对话

麦克风：内置ES8311

扬声器：内置ES8311

显示屏：128X64OLED或【齐护OLED模块】

编程注意问题说明：

用【小智】AI平台发送文字时不要过多文字，当要复读的内容很多时请采用其它平台应用！

程序：

6.25 V3_对话设置闹钟
在对话时让AI帮设置一个闹钟，并在待机时显示当前时间及闹钟时间，闹钟运行一次后自动清除（如要保持设计时可以更改程序实现）当时间到时触发条件进行自动执行或语音提醒。

主板：AiTall V3

模式：按一下IO-0 BOOT键开始连续对话

麦克风：内置ES8311

扬声器：内置ES8311

显示屏：128X64OLED或【齐护OLED模块】

编程注意问题说明：

用【小智】AI平台发送文字时不要过多文字，当要复读的内容很多时请采用其它平台应用！

程序：

6.26 V3_AI发送微信通知
在对话时让AI帮发通知给微信，或当传感器或条件达到时发送一个通知（内容可以为传感器数据或对话内容）给微信，实现远程通知的功能。

主板：AiTall V3

模式：按一下IO-0 BOOT键开始连续对话

麦克风：内置ES8311

扬声器：内置ES8311

显示屏：128X64OLED或【齐护OLED模块】

编程注意问题说明：

发送的内容不要太长，否则会发送失败，发送消息间隔10秒，一天最多发100条消息，更多关于【齐护微信通知】的用法教程请查看对应wiki.

程序：
6.27 音量的调整节
在产品运行过程中，有时我们初始化中的音量可能不太适合场景应用，这时我们可以通过MCP音量调整节搞改变实时音量的大小。

6.28 采用4G网络
设备除了采用正常的2.4Gwifi外，也可以采用4G模块的方式来让设备连接网络工作。

注：4G连网编程块在软件【网络】列表中找到，因工程测试的模块是如下型号，不确定是否兼容其它型号，建议用户采用相同的模块应用！

6.29 唤醒词与命令词
采用内置的唤醒词唤醒AI对话，并可同时定义一些命令词（识别词），这样在没有AI对话的情况下可以直接在不唤醒的时候直接用命令词来控制设备。

注：唤醒词块一定要放在AI对话编程块的上面，否则无法执行！

6.30 自定义语音唤醒
在一些场合我们希望个性化采用自己的唤醒词，在这里我们可能通合命令词与发送文字的编程块结合使用，实现自定义唤醒词。

更多应用例程，请查看软件左下角【例程】-【06齐护AiTall V3】，不断更新。。。。。。

七、蓝牙无线上传程序
AiTall V3可以通过齐护的蓝牙上传器模块上传程序（必须是Micropython的编程环境下，不支持Arduino的编程环境），具体的蓝牙连接方式请参考:【蓝牙上传器】

注：蓝牙模块只能上传程序，固件上传只能用USB线；经测试上传器在windows系统电脑下工作很稳定，但在苹果电脑MAC上有些系统不支持，具体用户可以自行测试或找解决方法。

电脑连接成功蓝牙模块后，电脑上会多出一个COM口，其它的上传使用与用USB完全一样，按如下方法接线，一定要注意TX-RX与主控要交叉接，电源要用3.3V的！

七、示例程序源代码下载
如上示例程序源文件在【齐护Mixly在线编程】软件，左下角【例程】—【python ESP32-S3】—【06_齐护AiTall-V3】找到并打开应用，可以在软件里另存为本地文件。