小达Call-微信电话_Rev0.2

English

文档导航

  • 快速开始：从编译、烧录、上电、绑定到首次 AI 演示。

  • 功能演示指南：SET、AI、WX、DEV、LIVE 的演示和验收。

  • 本文：硬件差异、功能能力、限制、构建说明和开发责任边界。

  • 工程内操作说明：examples/NT26FxDx_OpenKit_TiRTC/tirtc/docs/当前设备操作.md。

[!NOTE] 适用范围 本文面向利尔达 NT26FxDx OpenKit 硬件上的 TiRTC 语音终端应用开发。 文档对应工程目录为 examples/NT26FxDx_OpenKit_TiRTC，目标模组为 NT26F6D0，底包为 F6D_A。

1. 项目简介

NT26FxDx_OpenKit_TiRTC 是基于利尔达 Cat.1 bis OpenCPU SDK 开发的 TiRTC 语音终端示例。项目在 NT26FxDx OpenKit 的蜂窝联网、ES8311 音频和 三按键硬件基础上，增加 128×64 SSD1306 OLED 用户界面，以及设备绑定、AI 语音对讲、微信小程序语音呼叫、设备间语音呼叫和平台 LIVE 对讲功能。

本项目不是独立的底层 SDK。利尔达 OpenCPU SDK 负责模组运行环境、RTOS、 蜂窝网络、HTTP/MQTT、音频、I2C、GPIO 和构建打包；TiRTC SDK 和平台业务 由探鸽提供，项目中的 tirtc 目录负责将两者集成到目标开发板。

2. 与 NT26FxDx OpenKit 的关系

2.1 通用硬件

本项目适用的主板型号为：

PCB 型号

PCB 版本

模组

底包

L-CT4IT00-YP00W-01

V04

NT26F6D0

F6D_A

以下内容与普通 NT26FxDx OpenKit 共用：

  • Type-C 供电、USB 通信和下载；

  • Nano-SIM 卡座、4G 天线和蜂窝网络；

  • PWRKEY、RESET、BOOT 按键；

  • ES8311 编解码器、板载麦克风、扬声器接口；

  • 电池、充电管理、RGB 指示灯及其他板载接口。

主板器件、供电、USB、SIM、射频、音频接口和烧录注意事项，请参考 OpenKit 应用指导。

2.2 TiRTC 项目的硬件差异

本项目的主要显示设备是 128×64 SSD1306 OLED，不使用 LCD/TP 作为本应用 的主界面。摄像头接口虽然属于开发板硬件资源，但当前 TiRTC 应用没有接入 摄像头采集，也不提供视频通话功能。

OLED 使用 I2C1：

信号

模组引脚

复用功能

SDA

57

3

SCL

66

2

地址

0x3C 或 0x3D

自动探测

由于 OLED 使用 I2C1 的 pin66，TiRTC 变体在 tirtc/board/iodriver.ini 中关闭 SPI0 默认引脚，改用以下 SPI0 引脚：

SPI0 信号

模组引脚

SCLK

86

SSN

83

MOSI

85

MISO

84

修改板卡或更换屏幕时，必须同时核对 iodriver.ini、 tirtc/src/ui/ssd1306_display.c 和音频驱动中的总线及引脚配置。

3. 功能总览

3.1 用户操作入口

按键

硬件输入

应用语义

KEY0

GPIO20 / modem pin 5

NEXT，下一项

KEY1

GPIO22 / modem pin 19

CONFIRM，确认或接听

KEY2

WAKEUP_PAD0

BACK，返回、拒接或挂断

当前固件使用单击操作，并带独立按键防抖；没有定义长按和双击业务。

3.2 功能能力矩阵

设备完成 4G 联网和网页绑定后进入首页。首页包括：

功能

设备入口

使用对象

前置条件

当前能力和限制

AI

AI

设备与 AI 智能体

网页绑定设备、绑定 AI 智能体

半双工语音；播放回复时暂停采集

WX

WX

设备与微信小程序

网页绑定、微信 VoIP 授权和上报

双向语音；最多缓存 8 个联系人

DEV

DEV

两台 TiRTC 设备

两台设备在线、绑定且有设备联系人

双向语音；当前无摄像头和视频

SET

SET

本机

无

调整音量和麦克风增益；重启后恢复默认

LIVE

网页发起

网页与设备

设备在首页、其他业务空闲、账号有权限

双向语音；无专用设备页面；无视频

3.3 共用运行时和功能互斥

AI、WX、DEV、LIVE 共用 TiRTC 连接和音频资源，同一时间只能有一个业务占用。 设备处于拨号、通话、来电处理或资源释放状态时，其他业务可能被拒绝或延迟。 各功能的完整演示步骤、正常现象和拍摄要求请参考 TiRTC 功能演示指南。

4. 代码和责任边界

开发时应按以下边界理解代码。不能把整个 examples/NT26FxDx_OpenKit_TiRTC/tirtc 目录都视为利尔达代码。

4.1 利尔达内容

以下属于利尔达平台或利尔达硬件基础：

  • NT26F6D0 模组、L-CT4IT00-YP00W-01_V04 开发板及其硬件资源；

  • 利尔达 OpenCPU SDK、RTOS、网络、HTTP/MQTT、音频、显示和 GPIO API；

  • components/basePkg/F6D_A 底包；

  • OpenKit 原有硬件示例及其板级驱动；

  • 本项目对 OpenCPU 的板级适配、构建接入和硬件维护。

4.2 探鸽内容

以下属于探鸽 TiRTC 产品或服务侧内容：

  • tirtc/sdk/include/tirtc 和 tirtc/sdk/lib/libTiRTC.a；

  • TiRTC runtime、绑定协议、服务发现和平台业务接口；

  • “探鸽小钛”微信小程序及其服务端能力；

  • AI、WX、DEV、LIVE 等业务流程的参考实现。

TiRTC 头文件和静态库是独立的供应 SDK，不因应用工程使用 Apache-2.0 或 MIT 文件头而自动转为开源授权。使用、升级和再分发应遵循 探鸽 SDK 的实际授权条件。

4.3 集成代码和第三方组件

tirtc 目录中的部分代码是利尔达板级适配，部分代码来自探鸽公开参考实现， 另有本项目的集成代码。具体文件来源和许可证以工程内 tirtc/SOURCE_PROVENANCE.md、tirtc/THIRD_PARTY_NOTICES.md 及各文件头为准。

构建还会使用 cJSON、Opus 和 mbedTLS 等第三方组件。修改或发布时不得仅依据 本项目文件头判断第三方组件的许可范围。

5. 开发环境准备

5.1 硬件

  • NT26FxDx OpenKit，主板 L-CT4IT00-YP00W-01_V04；

  • NT26F6D0 模组；

  • 可上网的 Nano-SIM 卡和 4G 天线；

  • 128×64 SSD1306 OLED；

  • 板载或外接麦克风；

  • 4 Ω 扬声器；

  • 支持 USB 2.0 数据通信的 Type-C 数据线。

5.2 软件

  • 利尔达 OpenCPU SDK 源码；

  • 与 NT26F6D0 匹配的 F6D_A 底包；

  • GCC 编译环境，或利尔达 Tools；

  • 利尔达 USB 驱动；

  • 烧录工具和串口日志工具。

USB 驱动、烧录工具、日志工具和下载模式操作，请参考 NT26FxDx OpenKit 快速上手指南。

6. 构建工程

6.1 工程选择

SDK 根目录 Makefile 中的默认配置应为：

PROJECT  ?= NT26FxDx_OpenKit_TiRTC
MODEM    ?= NT26F6D0
MODEMPKG ?= F6D_A

也可以不修改文件，直接在 SDK 根目录执行命令行构建：

make PROJECT=NT26FxDx_OpenKit_TiRTC MODEM=NT26F6D0 MODEMPKG=F6D_A all

如果已经在根 Makefile 中设置上述默认值，按用户的常规流程执行：

make all

6.2 TiRTC 应用配置

TiRTC 应用构建配置位于：

examples/NT26FxDx_OpenKit_TiRTC/config

默认开启：

  • 按键和 SSD1306 OLED；

  • LTE、PDP 和网络时间；

  • 设备绑定和正式 MQTT；

  • TiRTC runtime；

  • AI、WX、DEV、LIVE 语音功能；

  • cJSON、mbedTLS 和 Opus。

默认关闭 WebSocket 组件和 TiRTC smoke runtime。调整配置后应重新执行完整 构建，确认编译日志中的功能依赖检查没有报错。

6.3 构建输出

构建输出位于：

gccout/NT26FxDx_OpenKit_TiRTC/

最终生成的 .binpkg 文件以实际构建日志和输出目录为准。烧录时必须使用与 NT26F6D0 和 F6D_A 匹配的完整固件包，不要将其他项目的 binpkg 直接烧录 到本项目硬件。

7. 烧录和启动验证

烧录步骤与普通 NT26FxDx OpenKit 相同：

  1. 使用 USB 数据线连接电脑和开发板；

  2. 按住 BOOT，再按 RESET 或重新插拔 USB，使模组进入下载模式；

  3. 使用利尔达烧录工具选择 TiRTC 项目的 .binpkg；

  4. 选择 NT26F6D0 和 F6D_A 对应配置；

  5. 完成烧录后等待设备自动重启。

首次启动建议按以下顺序验证：

  1. OLED 先完成点亮测试并显示 UI READY；

  2. 页面从 NET INIT、WAIT LTE、WAIT 4G 进入绑定流程；

  3. 全新设备显示六位绑定码；

  4. 网页绑定成功后进入 AI/WX/DEV/SET 首页；

  5. 先验证 SET 中音量和麦克风增益，再验证语音业务；

  6. 使用串口日志确认网络、绑定、TiRTC runtime 和音频初始化没有错误。

8. 常见问题

OLED 黑屏

  • 检查 OLED 是否接在点阵屏接口，供电和 I2C 线序是否正确；

  • 确认 OLED 地址为 0x3C 或 0x3D；

  • 确认 I2C1 使用 pin57/pin66；

  • 确认 iodriver.ini 的 SPI0 没有重新占用 pin66；

  • 对照日志中的 [OLED] probe 和 SSD1306 reinit 信息定位。

一直停留在等待网络

  • 检查 SIM 卡、天线和运营商覆盖；

  • 确认设备使用 NT26F6D0 与 F6D_A；

  • 先观察是否能获得 LTE 注册和 IPv4 地址；

  • 记录 OLED 状态和串口日志后再判断是网络问题还是平台绑定问题。

显示绑定码但网页绑定失败

  • 确认输入的是当前 OLED 显示的六位码；

  • 确认登录的是探鸽体验平台账号；

  • 绑定码超时后重新申请，再输入新码；

  • 检查设备是否已被其他账号绑定。

AI、WX 或 DEV 无法通话

  • 确认设备已经网页绑定且首页显示 4G:OK；

  • AI 需要绑定 AI 智能体；

  • WX 需要完成“探鸽小钛”授权和上报；

  • DEV 需要存在另一台已绑定设备；

  • 检查麦克风、扬声器、ES8311/I2S 初始化和 TiRTC runtime 日志；

  • 同一时间只能由一个业务占用共享 TiRTC 连接和音频资源。

9. 相关资源

  • OpenKit 应用指导

  • OpenKit 快速上手指南

  • TiRTC 当前设备操作与 UI 状态说明： examples/NT26FxDx_OpenKit_TiRTC/tirtc/docs/当前设备操作.md

  • TiRTC 代码与流程详解： examples/NT26FxDx_OpenKit_TiRTC/tirtc/docs/代码与流程详解.md

  • 源码来源记录： examples/NT26FxDx_OpenKit_TiRTC/tirtc/SOURCE_PROVENANCE.md

  • 第三方组件与发布边界： examples/NT26FxDx_OpenKit_TiRTC/tirtc/THIRD_PARTY_NOTICES.md