JX-A7T离在线混合语音模组采用双芯片架构,支持纯离线、在线及混合三种模式。离线模式快速响应基础指令,在线模式接入大模型处理复杂交互。关键配置包括功放使能为低电平、ASR串口输出通过命令词控制动作配置、在线结果通过智能体MCP工具输出。协同策略实现常用指令秒级响应与断网降级。
版本:v1.1 | 更新日期:2026-03-05
阅读时间:约 15 分钟
适用范围:JX-A7T 混合语音模组
素材来源:SmartPi 官方文档
标签:JX-A7T、离在线混合、ASR串口输出、智能体协同、功放使能
嵌入式开发中,许多开发者都遇到过这样的芯片:离线识别速度快,但面对复杂对话时表现不足;纯在线方案功能强大,却受限于离线场景和网络波动。JX-A7T 模组将离线语音识别与在线AI大模型整合于一体,既能本地快速响应基础指令,又能联网调用云端能力,适用于智能音箱、AI玩具、家居中控等多种场景。

长期稳定更新的攒劲资源: >>>点此立即查看<<<
不过,许多开发者初次接触该模组时,往往会提出一些高度相似的问题:
这些问题并不意外,因为JX-A7T的架构和配置确实存在不少细节。以下基于真实案例与官方文档,详细说明离在线混合模式的配置、ASR串口输出、常见问题及进阶用法。
JX-A7T 内部采用双芯片分工协作的方式:
| 芯片 | 型号 | 职责 | Flash | 接口 |
|---|---|---|---|---|
| 语音芯片 | CI1302 | 离线唤醒、命令词识别 | 2MB | UART0/UART1 |
| WiFi芯片 | BL62xx | WiFi连接、在线AI对话 | 2MB | UART通信 |
两芯片通过内部UART串口通信。整个模组提供 4个串口,功能分配明确:
| 串口 | 连接对象 | 用途 | 可用性 |
|---|---|---|---|
| UART0 | 语音芯片(CI1302) | 烧录、调试、外部通信 | 可用 |
| UART1 | 语音芯片(CI1302) | 外部设备通信 | 可用 |
| WiFi串口 | WiFi芯片(BL62xx) | 内部通信、烧录 | 内部使用 |
| 调试串口 | WiFi芯片(BL62xx) | 调试输出 | 调试用 |
注意:UART0 和 UART1 对外开放,可与外部MCU通信,但需注意电平匹配(TTL 3.3V)。
JX-A7T 提供三种模式,选择灵活:
| 模式 | 说明 | 网络依赖 | 响应速度 | 适用场景 |
|---|---|---|---|---|
| 纯离线模式 | 仅使用本地命令词 | 无需网络 | 极快(<500ms) | 基础控制、断网环境 |
| 纯在线模式 | 所有请求发送云端 | 需要网络 | 较慢(2-5s) | 复杂对话、知识问答 |
| 混合模式 | 离线+在线协同 | 部分需要网络 | 灵活 | 综合应用场景(推荐) |
大多数场景下,混合模式是更优选择——既能保证基础指令的秒级响应,又能通过大模型问答提供智能能力。
在 SmartPi 平台(smartpi.cn)上创建 JX-A7T 产品时,需要分别配置语音和WiFi两部分。
创建离线命令词
配置串口输出
功放使能配置 关键点
导入 WiFi 配置
wifi_test.json。配置智能体
JX-A7T 需要烧录两个固件,缺一不可:
| 固件 | 文件名 | 烧录工具 | 说明 |
|---|---|---|---|
| 语音固件 | jx_firm.bin | ASR 语音部分烧录软件 | 离线识别 |
| WiFi 固件 | A7T_WIFI.bin | WiFi 在线部分烧录软件 | 在线AI |
烧录顺序:先烧语音固件,再烧WiFi固件,顺序不可颠倒。
拨码开关位置:
| 开关 | 正常工作模式 | 烧录模式 |
|---|---|---|
| SW1 | 靠近 USB 口 | 远离 USB 口 |
| SW2 | 靠近 USB 口 | 远离 USB 口 |
注意:烧录完成后,务必把拨码开关拨回正常工作位置,否则模组无法正常运行。
许多开发者拿到模组后的第一个需求是:语音识别结果能否通过串口输出,供下游MCU或其他设备进一步处理。答案是肯定的,但前提是配置正确。
针对离线命令词,串口输出的配置方法如下:
进入命令词配置
配置串口输出
输出内容有两种形式:
配置示例
| 命令词 | 串口输出 | 说明 |
|---|---|---|
| "打开灯" | OPEN_LEDn | 发送固定指令 |
| "关闭灯" | CLOSE_LEDn | 发送固定指令 |
| "调到X档" | LEVEL_{0-9}n | 带变量的输出 |
对于在线AI对话场景,识别结果的输出需通过智能体平台实现:
配置 MCP 工具
配置对话流
获取对接文档
JX-A7T 的串口通信遵循标准帧格式:
帧头 | 长度 | 命令 | 数据 | 校验
0xAA 0x55 | LEN | CMD | DATA | CS
常用命令字:
| 命令字 | 说明 | 数据格式 |
|---|---|---|
| 0x01 | 离线命令词触发 | 命令ID |
| 0x02 | 唤醒事件 | 唤醒词ID |
| 0x03 | 在线 ASR 结果 | UTF-8 字符串 |
| 0x04 | TTS 播报状态 | 状态码 |
| 串口 | TX 引脚 | RX 引脚 | 用途 |
|---|---|---|---|
| UART0 | PIN 57 | PIN 58 | 烧录、外部通信 |
| UART1 | PIN 68 | PIN 1 | 外部设备通信 |
注意:UART0 同时承担烧录和调试功能,与外部设备通信时可能冲突,需做好切换逻辑。
问题描述:
按照例程配置并烧录后,喇叭没有声音,只有烧回出厂固件才能开机播报。
原因分析:JX-A7T 的功放使能配置与 CI-03T 不同,许多人习惯使用 CI-03T 的配置。
| 模组 | 默认功放使能配置 | 配置位置 |
|---|---|---|
| CI-03T | 高电平使能 | 平台默认 |
| JX-A7T | 低电平使能 | 需手动配置 |
解决方法:
问题描述:
JX-A7T 串口收到数据持续累加,第一次返回0x29,第二次返回0x30,之后变成0x2930。
原因分析:接收缓冲区未及时清空,或MCU读取方式不正确。
解决方法:关键在于正确判断帧尾并及时重置缓冲区。
// 正确的串口读取示例
void uart_read_handler() {
static uint8_t buffer[128];
static uint16_t index = 0;
while (uart_available()) {
uint8_t byte = uart_read_byte();
buffer[index++] = byte;
// 检查帧尾
if (byte == 0xA5 && index > 2) {
process_frame(buffer, index);
index = 0; // 重置缓冲区
}
}
}
问题描述:
JX-A7T 串口能否直接输出“你好”这样的文本?
答案:默认输出为十六进制格式。如果需要ASCII文本,有两种方法:
检查清单如下:
| 检查项 | 状态 | 说明 |
|---|---|---|
| WiFi 固件烧录 | / | 确认 A7T_WIFI.bin 已烧录 |
| WiFi 配置导入 | / | 确认 wifi_test.json 已导入 |
| 网络连接 | / | 设备连接到 2.4G 网络 |
| 智能体绑定 | / | 智能体已正确绑定 |
| 小程序配网 | / | 完成设备配网 |
| 触发条件 | 处理模式 | 示例 |
|---|---|---|
| 简单控制指令 | 离线模式 | "打开灯"、"播放音乐" |
| 复杂问题 | 在线模式 | "今天天气怎么样"、"讲个故事" |
| 网络断开 | 纯离线模式 | 降级使用本地命令 |
这种协同策略的优势明显:常用指令秒级响应,网络偶尔断开时也不会完全失效。
场景:智能音箱
| 命令类型 | 示例命令 | 处理方式 |
|---|---|---|
| 离线控制 | "打开灯"、"关闭灯" | 本地 GPIO 控制 |
| 在线问答 | "今天天气"、"播放周杰伦的歌" | 云端 AI 处理 |
| 串口输出 | "设置温度25度" | 通过串口发送到空调 |
如需完整的离在线应用对接说明,可在SmartPi平台的项目文档中找到《离在线应用对接说明 V2.1》,其中包含协议定义、数据格式和对接示例代码。
| 功能 | 实现方式 |
|---|---|
| 灯光控制 | 离线命令词 + GPIO |
| 语音查询 | 在线 AI + TTS 播报 |
| 场景联动 | 串口输出 + 网关 |
| 功能 | 实现方式 |
|---|---|
| 基础动作 | 离线命令词(前进、后退) |
| 对话互动 | 在线 AI + 知识库 |
| 语音数据 | 串口输出到 MCU 记录 |
| 功能 | 实现方式 |
|---|---|
| 静止控制 | 离线命令词快速响应 |
| 导航查询 | 在线 AI 处理 |
| 数据输出 | 串口输出到车机系统 |
JX-A7T 作为离在线混合语音模组,配置灵活度较高,但易踩坑点主要集中在几个方面。核心要点总结如下:
关键配置对比(注意JX-A7T与CI-03T的区别):
| 配置项 | JX-A7T | CI-03T |
|---|---|---|
| 功放使能 | 低电平 | 高电平 |
| 串口数量 | 4个(内部+外部) | 2个 |
| 在线能力 | 支持大模型 | 不支持 |
| 固件数量 | 2个(语音+WiFi) | 1个 |
上电前自检清单:
侠游戏发布此文仅为了传递信息,不代表侠游戏网站认同其观点或证实其描述