火山引擎 RTC（OTA A/B 分区）解决方案DEMO开发指南

1 项目概述

本项目在 `volc_rtc <../volc_rtc/README_CN.md>`_ 工程的基础上，增加了 OTA A/B 双分区升级 能力。基础的实时音视频通信、音频处理、AI Agent 集成、房间管理等功能与 volc_rtc 完全一致，本文档 仅重点描述 OTA A/B 分区相关的差异，其余功能请直接参考 volc_rtc 工程文档：

功能特性与 API 参考：火山引擎 RTC 解决方案DEMO开发指南（volc_rtc）
在线文档：火山 DEMO 工程在线文档

> 简单来说：``volc_rtc_ab`` = ``volc_rtc`` 的全部功能 + OTA A/B 分区升级。

2 OTA A/B 升级简介

2.1 什么是 OTA A/B

OTA A/B（双分区）升级的基本思路：Flash 中保留两份固件分区，设备从当前分区运行，OTA 时把新固件写入 另一份（备用）分区，随后切换启动分区完成升级。相比单固件分区方案，升级过程中始终保留一份固件，代价是占用更多 Flash 空间。

> 说明：启动分区切换、校验、回退等具体行为由 Bootloader 与 SMP SDK 的 OTA 机制决定，请以 SMP OTA 文档为准；本工程与 volc_rtc 的差异仅体现在下述分区表与打包配置上。

2.2 分区布局差异

volc_rtc_ab 与 volc_rtc 的核心区别在于分区表 partitions/bk7258/auto_partitions.csv。下表数值与读写属性均取自两个工程的该文件：

分区 | volc_rtc（单分区） | volc_rtc_ab（A/B 双分区） | 说明 |
— | — | — | — |
primary_bootloader | 68k | 68k | Bootloader |
primary_cp_app | 1428k（Write=FALSE） | 1360k（Write=TRUE） | CP 核固件分区；A/B 工程中属性由只读改为可写 |
primary_ap_app | 2992k（Write=FALSE） | 2652k（Write=TRUE） | AP 核固件分区；A/B 工程中属性由只读改为可写 |
ota | 3128K | 无 | 单分区方案的 OTA 分区 |
s_app | 无 | 4012k | A/B 工程新增分区；分区表注释标注为 “B partition”（备用固件分区） |
ota_fina_executive | 无 | 4K | A/B 工程新增分区；用途以 SMP OTA 文档为准 |
usr_config | 60K | 56K | 用户配置分区 |

要点（均可在分区表中核对）：s_app 为 A/B 工程新增分区，其注释明确标注为 “B partition”；primary_cp_app / primary_ap_app 的写属性由 FALSE 改为 TRUE。

2.3 A/B 位置无关升级（position independent）

工程新增 partitions/bk7258/ab_position_independent.csv：

pos_independent,TRUE

pos_independent 为 TRUE 时启用 A/B 位置无关（position-independent）升级 功能；不需要该功能时可设为 ``False``（见文件内注释）。该功能的具体实现与限制请以 SMP OTA 文档为准。

2.4 OTA 升级包（RBL）打包配置

工程新增 partitions/bk7258/ota_rbl.config，用于生成 A/B 升级包 app_packab.rbl：

{
    "key":"0123456789ABCDEF0123456789ABCDEH",
    "iv":"0123456789ABCDEF",
    "gzip":"0",
    "aes":"0",
    "outf":"app_packab.rbl"
}

各字段含义（以 SMP 的 rbl 打包工具文档为准）：

key / iv：升级包加解密使用的密钥与初始向量；
aes：升级包是否 AES 加密（0 / 1）；
gzip：升级包是否压缩（0 / 1）；
outf：输出升级包文件名（此处为 app_packab.rbl）。

> ⚠️ 建议正式量产前将示例中的 key / iv 替换为项目自有的安全密钥。

3 快速开始

3.1 编译和烧录

编译流程参考 AI 解决方案。将命令中的工程路径替换为 projects/volc_rtc_ab 即可。

编译命令示例：

cd ~/armino/bk_solution_ai/projects/volc_rtc_ab
export SDK_DIR=~/armino/bk_avdk_smp
make clean
make bk7258

完整固件（用于首次整包烧录，路径命名与 volc_rtc 一致）：projects/volc_rtc_ab/build/bk7258/volc_rtc_ab/package/all-app.bin

A/B OTA 升级包：文件名由 ota_rbl.config 的 outf 指定，即 app_packab.rbl。

烧录流程参考 SMP 烧录流程。

3.2 升级流程说明

首次通过烧录工具整包烧录 all-app.bin；
后续版本通过 OTA 通道下发 A/B 升级包 app_packab.rbl 完成升级。

> OTA 的下发、写入、校验与分区切换等具体流程和接口，请参考 SMP OTA 文档。

4 API 参考

本工程的 RTC / Agent / 音视频收发等 API 与 volc_rtc 完全一致，请参考：

volc_rtc API 参考