本文是安诺尼 AARONIA SPECTRAN V6 实时频谱分析仪配套 RTSA Suite 的专属文件格式 ——RTSA File Format 的技术解析系列第一篇，核心讲解该格式的设计定位、核心特性与整体文件架构，是理解 RTSA 文件解析、读写及 二次开发 的基础。本系列将逐章拆解 RTSA File Format 技术规范，为从事 AARONIA SPECTRAN V6 相关开发的工程师提供专业、完整的技术参考。

1. 设计定位与核心特性（Features and Purpose）

RTSA File Format 专用于存储由 RTSA Suite 生成的文件，采用二进制块式（binary, chunk-based） 架构设计，与 PNG 文件格式的结构逻辑相近。该格式针对频谱测量数据的存储特性开发，其核心差异化特性均围绕测量数据的存储、传输、解析等实际应用需求设计，具体如下：
Binary, compact and optionally compressed storage of measurement data  采用二进制格式存储测量数据，存储形式紧凑且支持可选压缩
Meta data storage (location, time, format etc.)  支持元 数据存储 ，可记录测量位置、时间、数据格式等相关信息
Multi streams  支持多流存储，适配复杂测量场景的多维度数据记录需求
Interleaving of streams  支持流的交错存储，满足多源测量数据的融合存储需求
Sequential stream read and write  支持流的顺序读写，适配测量数据的线性处理逻辑
Random access of complete files  支持对完整文件的随机访问，可快速定位目标测量数据
Preview storage of power spectra and power histogram  内置功率谱和功率直方图的预览存储，可快速查看数据概况

Extension of existing streams  支持对现有流的扩展，适配测量数据维度的动态扩充需求

2. 文件整体结构（File Structure）

2.1 核心架构：基于 Chunk 的组合形式

整个 RTSA 文件由独立且支持递归的块（individual and optionally recursive chunks） 组成，Chunk 是 RTSA File Format 的基础结构单元，每个 Chunk 均由固定的块头（chunk header） 和可变的实际数据（actual data） 两部分构成。
Chunk 的实际数据部分类型由 Chunk 类型决定，可分为两种形式：一是由多个子 Chunk 组成的递归结构，二是直接存储的二进制测量原始数据。该设计让 RTSA 文件具备良好的结构可扩展性和兼容性，适用于多类型、多维度频谱测量数据的存储场景。

2.2 通用文件布局（Generic File Layout）

RTSA File Format 遵循标准化、固定的整体布局规则，文件段具备明确的起始和结束标识，Chunk 内部关联遵循反向引用（backward reference） 原则，同时支持文件的流式传输和随机访问，具体规则如下：

1）文件段起始与结束标识

RTSA 文件以DSFH（File Head，文件头） 块起始，以DSFT（File Tail，文件尾） 块结束。若对现有文件进行扩展，文件内会生成多组 DSFH/DSFT 块对，每组块对对应 RTSA 文件的一个独立数据段。

2） Chunk 访问规则

可通过 Chunk 头中的块大小字段对文件内的 Chunk 进行正向顺序读取，也可通过其他 Chunk 中存储的偏移量实现随机访问。所有偏移量均为 64 位无符号整数，以文件起始位置为基准且采用反向引用方式，无正向引用 设计确保 RTSA 文件无需预加载完整文件即可实现流畅的流式解析。

3）基础 Chunk 序列

单段 RTSA 文件的标准基础结构如下，其中 SAMP 块的数量由测量数据量决定，部分功能型 Chunk 的顺序可根据实际测量场景调整：

DSFH (File Head) → STRM (Stream Head) → ANTA (Antenna) → SSTR (Sub Stream) → SAMP (Samples) → SAMP (Samples) → STRT (Stream Tail) → DSFT (File Tail)

2.3 带 ID 对象的组织规则

RTSA 文件中所有带有 64 位唯一 ID 的对象（如 Stream ID、Sub Stream ID、Antenna IDs）均遵循两大核心组织规则，是保证文件解析和随机访问正确性的基础：
先定义后使用（Define before Use）
所有带 ID 的对象必须在被使用前定义在文件中，即对应 ID 对象的 Chunk 必须先被解析，后续引用该 ID 的 Chunk 才能被正确解析。
基于反向链接链的检索（Backward Linked Chains for Retrieval）
所有带 ID 的对象均属于反向链接链的一部分，链接链通过 Chunk 中存储的偏移量字段构建，为文件的随机访问提供快速索引，可通过 ID 和对应偏移量快速定位目标数据。

3. 核心设计逻辑与实际应用价值

3.1 核心设计逻辑

RTSA File Format 的核心设计基于标准化和可扩展性双重原则，并结合 AARONIA SPECTRAN V6 频谱仪的测量数据实际特性打造：
标准化：统一 Chunk 头结构、通用数据类型存储规则和文件整体布局，确保不同版本 RTSA Suite、不同型号 AARONIA SPECTRAN V6 频谱仪生成的 RTSA 文件具备兼容性。
可扩展性：采用基于 Chunk 的递归结构和反向引用规则，支持新增 Chunk 类型和扩展现有流，适配实际频谱测量中测量场景、数据类型的动态变化。

3.2 实际应用价值

作为 AARONIA SPECTRAN V6 频谱仪测量数据存储的专属文件格式，RTSA File Format 是设备的核心数据载体，其设计特性决定了其在实际使用和二次开发中的重要应用价值：
二进制 + 可选压缩的存储方式，实现了大容量频谱测量数据的紧凑存储，降低存储占用和传输带宽开销；
顺序读写与随机访问并存的特性，满足全文件批量分析、局部目标数据提取等不同的数据处理需求；
内置功率谱和功率直方图的预览存储，无需解析完整文件即可快速展示测量数据全貌，提升数据预处理和预览效率；
完整的元数据存储 + 标准化的 Chunk 结构，为 RTSA 文件的二次开发提供清晰、专业的技术依据，且兼容主流 编程语言 和开发环境；
流扩展和多流交错存储的支持，适配 AARONIA SPECTRAN V6 的多天线测量、多维度数据同步采集等复杂测量场景。

下期预告

下一篇将聚焦 RTSA File Format 的Chunk Structure（块结构） 和General Data Types（通用数据类型） ，包括 Chunk 头结构（DSPStreamFileChunk）的统一定义、字节序、时间、偏移量、字符串等基础数据类型的存储规则，这两部分是解析 RTSA 文件所有 Chunk 的基础技术规则，也是保证 RTSA 文件读写、数据解析正确性的关键。