F´ 飞行软件框架 BufferLogger 组件深度解析二进制数据落盘、文件轮转与校验文件机制【免费下载链接】fprimeF´ - A flight software and embedded systems framework项目地址: https://gitcode.com/GitHub_Trending/fpr/fprimeBufferLogger 是 F´F Prime飞行软件与嵌入式系统框架中的活动组件负责把Fw::Buffer原始载荷如传感器数据与Fw::Com封包化遥测或事件二进制数据持续写入机载文件系统。本文以 Svc/BufferLogger/docs/sdd.md 为骨架结合组件 FPP 接口定义、C 实现与单元测试完整讲解其端口模型、日志状态机、文件命名与轮转策略、四大控制命令、事件/遥测定义及拓扑集成方法帮助读者在实际 F´ 部署中透明插入二进制日志采集链路。1. 组件定位与总体设计BufferLogger 是一个active component活动组件。其设计目标是在不打断既有数据流的前提下把途经的二进制数据原样落盘数据到达异步输入端口后由组件自身线程调度并同步写入当前打开的日志文件。核心特性包括同时接受Fw::Buffer与Fw::Com两类数据源每条日志以可配置宽度的长度字段size field作为前缀便于地面端解析定界达到最大文件尺寸时自动关闭当前文件并开启新文件轮转文件名携带自增计数器关闭每个日志文件时生成配套的校验hash文件供地面端验证传输/落盘完整性bufferSendIn收到的缓冲在记录后原样转发到bufferSendOut使组件可无侵入地插入既有 buffer 流水线。该组件的对外接口通过 FPP 定义在 Svc/BufferLogger/BufferLogger.fpp实现位于 Svc/BufferLogger/BufferLogger.cpp 与 Svc/BufferLogger/BufferLoggerFile.cpp。2. 端口模型FPP 文件 BufferLogger.fpp 声明的业务端口如下表端口类型方向/方式说明bufferSendInFw.BufferSendasync input待记录的 Buffer记录后转发至bufferSendOutbufferSendOutFw.BufferSendoutput转发缓冲例如送回 BufferManager 归还原主comInFw.Comasync input待记录的 Com 缓冲不转发pingIn/pingOutSvc.Pingasync input / output健康检查 ping透传schedInSvc.Schedasync input运行时调度输入当前未使用见下此外还声明了标准特殊端口cmdIn命令接收、cmdRegOut命令注册、cmdResponseOut命令响应、eventOut/eventOutText事件与文本事件、timeCaller时间获取、tlmOut遥测输出。从实现看BufferLogger.cppbufferSendIn_handler当m_state LOGGING_ON时取出fwBuffer.getData()与fwBuffer.getSize()调用m_file.logBuffer()记录随后无条件执行bufferSendOut_out(0, fwBuffer)转发与日志开关无关——这正是需求SVC-BUFFERLOGGER-003的行为comIn_handler记录Fw::ComBuffer的数据区getBuffAddr()/getSize()不转发pingIn_handler原样回显 key 到pingOutschedIn_handler源码中仅留有// TODO空实现SDD 亦注明currently unused拓扑中即使连接也不产生副作用。3. 日志状态机与开关语义日志启停由易失状态BufferLogger_LogState控制其在 Commands.fppi 中定义为枚举enum LogState : U8 { LOGGING_ON 0 LOGGING_OFF 1 }关键语义与 SDD 3.2 节一致构造时默认LOGGING_ON见 BufferLogger.cpp 的初始化列表m_state(LogState::LOGGING_ON)通过BL_SetLogging命令切换状态LOGGING_OFF时bufferSendIn/comIn到达的数据不写盘但bufferSendIn仍照常转发到bufferSendOut切换到LOGGING_OFF会立即关闭当前文件BufferLogger.cpp关闭时照常写出 hash 校验文件。注意SDD 3.5 节列出了BL_Activated/BL_Deactivatedactivity low事件且在 Events.fppi 中已有定义但从当前源码看BL_SetLogging_cmdHandler并未触发这两个事件即该版本实现中这两个事件仅存在于接口层定义。4. 文件管理与轮转机制4.1 文件名规则首次调用BL_OpenFile后打开的第一个文件名为prefixbaseNamesuffix此后每当文件写满而轮转文件名变为prefixbaseNamecountersuffixcounter从 1 开始递增。命名逻辑位于 BufferLoggerFile.cppif (this-m_fileCounter 0) { this-m_name.format(%s%s%s, prefix, baseName, suffix); } else { this-m_name.format(%s%s% PRI_FwSizeType %s, prefix, baseName, m_fileCounter, suffix); }prefix/suffix/maxSize/sizeOfSize均由拓扑初始化时调用initLog()传入见第 7 节m_fileCounter初始为 0每次setBaseName()即收到BL_OpenFile都会重置为 0因此该命令同时充当重开一组全新日志的开关文件名格式化失败时上报BL_LogFileNameError事件Fw.StringFormatStatus类型。4.2 每条记录的磁盘布局每个被记录的 buffer 在文件中的物理格式为| 长度字段sizeOfSize 字节大端写入 | buffer 数据size 字节 |长度字段写入逻辑见 BufferLoggerFile.cpp要点sizeOfSize是initLog传入的 U8 值表示长度字段占用的字节数不得大于sizeof(FwSizeType)init中有FW_ASSERT强制写入时按大端序逐字节落盘若sizeOfSize sizeof(FwSizeType)且待写数据长度超出该字段可表示范围则拒绝写入并上报BL_LogFileWriteErrorOs::File::INVALID_ARGUMENT避免仅写入低字节导致日志损坏。4.3 尺寸上限与自动轮转File::logBuffer()BufferLoggerFile.cpp实现先判定、后写盘的轮转策略const FwSizeType projectedByteCount m_bytesWritten m_sizeOfSize size; if (projectedByteCount m_maxSize) { this-closeAndEmitEvent(); // 关闭当前文件含写 hash 文件 }投影字节数 已写入字节数 长度字段宽度 本次数据长度超过maxFileSize即轮转文件处于 CLOSED 状态时自动open()新文件因此即使尚未BL_OpenFile只要参数就绪写满后也会自动续开每次成功open()后m_bytesWritten清零、m_fileCounter自增。4.4 校验hash文件组件在每个日志文件关闭时为其生成配套校验文件供地面端校验。机制要点BufferLoggerFile.cpp写盘过程中通过Utils::Hash见 Utils/Hash/Hash.hpp增量计算整个文件的 hashm_hash.update()随每次writeBytes调用关闭文件时m_hash.finalize(hashBuffer)得到最终摘要再经Os::ValidatedFile的createHashFile()写出校验文件参考 Os/ValidatedFile.hpp校验文件写出失败时上报BL_LogFileValidationError携带校验文件名与Os::ValidateFile::Status返回值关闭文件会先m_osFile.close()再写 hash 文件最后把模式置回CLOSED组件析构时也会调用close()收尾。4.5 打开/写入失败路径open()前会检查 baseName 是否已设置、sizeOfSize是否合法、maxSize sizeOfSize是否成立BufferLoggerFile.cpp任一不满足即上报BL_NoLogFileOpenInitError并放弃打开——对应需求SVC-BUFFERLOGGER-008与 SDD 3.3 节描述Os::File::open(OPEN_WRITE)失败时上报BL_LogFileOpenError携带错误号与文件名写盘字节数与请求不符时上报BL_LogFileWriteError携带错误号、实际写入字节数与期望字节数。5. 命令接口四条命令全部为 async 命令opcode 与参数定义见 Commands.fppi命令Opcode参数说明BL_OpenFile0x00file: string size 40设置日志文件 base name并将文件计数器重置为 0若当前有文件打开则先关闭BL_CloseFile0x01无关闭当前打开的日志文件若有关闭时写出 hash 文件并上报BL_LogFileClosedBL_SetLogging0x02$state: LogState设置易失日志状态LOGGING_ON/LOGGING_OFF切到 OFF 时关闭当前文件BL_FlushFile0x03无冲刷当前日志文件到磁盘BL_FlushFile值得一提F´ 默认文件 I/O 为无缓冲直写因此 BufferLoggerFile.cpp 中flush()直接return true命令恒成功其存在是为了兼容将来改用带缓冲Os::File实现的场景SDD 中亦明确说明no-op with F Primes unbuffered file I/O。命令处理器统一通过cmdResponse_out(opCode, cmdSeq, Fw::CmdResponse::OK)应答BL_FlushFile失败时返回EXECUTION_ERROR见 BufferLogger.cpp。6. 事件与遥测6.1 事件清单事件定义于 Events.fppi格式串与参数完整对应 SDD 3.5 节事件SeverityID格式携带参数BL_LogFileCloseddiagnostic0x00File {} closed文件名string size 256BL_LogFileOpenErrorwarning high0x01Error {} opening file {}错误号 U32、文件名BL_LogFileValidationErrorwarning high0x02Failed creating validation file {} with status {}校验文件名、Os::ValidateFile::StatusBL_LogFileWriteErrorwarning high0x03Error {} while writing {} of {} bytes to {}错误号、实际写入字节数、期望字节数、文件名BL_Activatedactivity low0x04Buffer logger was activated无BL_Deactivatedactivity low0x05Buffer logger was deactivated无BL_NoLogFileOpenInitErrorwarning high0x06No log file open command无BL_LogFileNameErrorwarning high0x07Error {} formatting log file nameFw.StringFormatStatus6.2 遥测通道Telemetry.fppi 声明唯一遥测通道telemetry BufferLogger_NumLoggedBuffers: U32 id 0SDD 3.6 节将其描述为已记录的 buffer 数量当前版本接口层已定义该通道可用于监控日志吞吐。7. 拓扑集成与使用步骤按 SDD 4 节 Usage 并结合源码完整接入步骤如下实例化组件并启动线程在拓扑 FPP 中声明instance bufferLogger: Svc.BufferLogger base id 0xXXXX连接bufferSendIn/comIn/pingIn等输入与命令、事件、遥测、时间端口并启动其任务线程active 组件由 F´ 框架自动建线程。初始化日志参数在拓扑设置代码中调用initLog(prefix, suffix, maxFileSize, sizeOfSize)签名见 BufferLogger.hpplogFilePrefix文件名前缀如log/或空串logFileSuffix文件名后缀如.binmaxFileSize单个文件最大字节数需满足maxFileSize sizeOfSizesizeOfSize长度字段字节数1–8不得大于sizeof(FwSizeType)过小会限制单条可记录 buffer 的最大长度。 注意initLog内含断言必须在打开文件前调用FW_ASSERT(m_mode CLOSED)且sizeOfSize与maxSize的约束由 BufferLoggerFile.cpp 的断言强制。发送BL_OpenFile命令指定 base namestring 最大 40 字符计数器随之清零此后首次写文件使用prefixbaseNamesuffix命名。灌入数据向bufferSendIn灌入Fw::Buffer如传感器原始载荷向comIn灌入Fw::ComBuffer如封包化遥测/事件组件在线程上下文同步写盘。按需关闭/轮转调用BL_CloseFile主动收尾关闭时自动写 hash 文件或依赖写满自动轮转需要开启全新一组日志时再次发送BL_OpenFile用BL_SetLogging暂停/恢复记录用BL_FlushFile冲刷当前无缓冲 I/O 下为空操作。关键拓扑约束bufferSendIn会把每个 buffer 的所有权转移到bufferSendOut拓扑必须把转发输出路由回 buffer 归属方典型如Svc::BufferManager否则会出现缓冲区泄漏或二次释放这一点在 BufferLogger.cpp 的实现中体现得十分直接。8. 需求规格与测试验证SDD 2 节给出 8 条需求全部以单元测试为验证手段需求内容要点SVC-BUFFERLOGGER-001记录bufferSendIn收到的 bufferSVC-BUFFERLOGGER-002记录comIn收到的 Com bufferSVC-BUFFERLOGGER-003无论日志状态如何都转发bufferSendIn→bufferSendOutSVC-BUFFERLOGGER-004每条日志前缀可配置宽度的长度字段SVC-BUFFERLOGGER-005超过最大文件尺寸时自动开新文件SVC-BUFFERLOGGER-006提供打开/关闭/冲刷/启停四条命令SVC-BUFFERLOGGER-007关闭每个日志文件时写校验文件SVC-BUFFERLOGGER-008文件错误通过事件上报单元测试位于 Svc/BufferLogger/test/ut/按场景分为Logging日志行为、Errors错误路径与Health健康 ping三组。以 Logging.cpp 为例CloseFileTester验证连续发送BL_CloseFile命令时命令响应序列正确、文件与 hash 文件真实落盘checkFileExists/checkHashFileExists且仅当文件确实打开时才产生BL_LogFileClosed事件SendBuffersTester通过精确控制每个文件写入条数MAX_ENTRIES_PER_FILE - 1后补 1 条触发轮转断言轮转前后文件名按prefixbaseNamecountersuffix规律变化并核对每个轮转点的BL_LogFileClosed事件计数与文件名内容直接印证了 4.1/4.3 节的命名与轮转逻辑。9. 变更记录日期说明2026-08-10SDD 初始版本小结BufferLogger 是 F´ 中典型的旁路记录型活动组件通过bufferSendIn的透传设计做到对既有 buffer 流水线零干扰通过sizeOfSize可配长度字段、maxFileSize自动轮转与Utils::Hash增量校验文件为机载二进制数据传感器原始数据、遥测/事件封包提供了一套自描述、可校验、可持续写入的落盘方案。接入时牢记两条铁律拓扑初始化调用initLog必须在开文件之前bufferSendOut必须接回 buffer 归属方。【免费下载链接】fprimeF´ - A flight software and embedded systems framework项目地址: https://gitcode.com/GitHub_Trending/fpr/fprime创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
F´ 飞行软件框架 BufferLogger 组件深度解析：二进制数据落盘、文件轮转与校验文件机制
F´ 飞行软件框架 BufferLogger 组件深度解析二进制数据落盘、文件轮转与校验文件机制【免费下载链接】fprimeF´ - A flight software and embedded systems framework项目地址: https://gitcode.com/GitHub_Trending/fpr/fprimeBufferLogger 是 F´F Prime飞行软件与嵌入式系统框架中的活动组件负责把Fw::Buffer原始载荷如传感器数据与Fw::Com封包化遥测或事件二进制数据持续写入机载文件系统。本文以 Svc/BufferLogger/docs/sdd.md 为骨架结合组件 FPP 接口定义、C 实现与单元测试完整讲解其端口模型、日志状态机、文件命名与轮转策略、四大控制命令、事件/遥测定义及拓扑集成方法帮助读者在实际 F´ 部署中透明插入二进制日志采集链路。1. 组件定位与总体设计BufferLogger 是一个active component活动组件。其设计目标是在不打断既有数据流的前提下把途经的二进制数据原样落盘数据到达异步输入端口后由组件自身线程调度并同步写入当前打开的日志文件。核心特性包括同时接受Fw::Buffer与Fw::Com两类数据源每条日志以可配置宽度的长度字段size field作为前缀便于地面端解析定界达到最大文件尺寸时自动关闭当前文件并开启新文件轮转文件名携带自增计数器关闭每个日志文件时生成配套的校验hash文件供地面端验证传输/落盘完整性bufferSendIn收到的缓冲在记录后原样转发到bufferSendOut使组件可无侵入地插入既有 buffer 流水线。该组件的对外接口通过 FPP 定义在 Svc/BufferLogger/BufferLogger.fpp实现位于 Svc/BufferLogger/BufferLogger.cpp 与 Svc/BufferLogger/BufferLoggerFile.cpp。2. 端口模型FPP 文件 BufferLogger.fpp 声明的业务端口如下表端口类型方向/方式说明bufferSendInFw.BufferSendasync input待记录的 Buffer记录后转发至bufferSendOutbufferSendOutFw.BufferSendoutput转发缓冲例如送回 BufferManager 归还原主comInFw.Comasync input待记录的 Com 缓冲不转发pingIn/pingOutSvc.Pingasync input / output健康检查 ping透传schedInSvc.Schedasync input运行时调度输入当前未使用见下此外还声明了标准特殊端口cmdIn命令接收、cmdRegOut命令注册、cmdResponseOut命令响应、eventOut/eventOutText事件与文本事件、timeCaller时间获取、tlmOut遥测输出。从实现看BufferLogger.cppbufferSendIn_handler当m_state LOGGING_ON时取出fwBuffer.getData()与fwBuffer.getSize()调用m_file.logBuffer()记录随后无条件执行bufferSendOut_out(0, fwBuffer)转发与日志开关无关——这正是需求SVC-BUFFERLOGGER-003的行为comIn_handler记录Fw::ComBuffer的数据区getBuffAddr()/getSize()不转发pingIn_handler原样回显 key 到pingOutschedIn_handler源码中仅留有// TODO空实现SDD 亦注明currently unused拓扑中即使连接也不产生副作用。3. 日志状态机与开关语义日志启停由易失状态BufferLogger_LogState控制其在 Commands.fppi 中定义为枚举enum LogState : U8 { LOGGING_ON 0 LOGGING_OFF 1 }关键语义与 SDD 3.2 节一致构造时默认LOGGING_ON见 BufferLogger.cpp 的初始化列表m_state(LogState::LOGGING_ON)通过BL_SetLogging命令切换状态LOGGING_OFF时bufferSendIn/comIn到达的数据不写盘但bufferSendIn仍照常转发到bufferSendOut切换到LOGGING_OFF会立即关闭当前文件BufferLogger.cpp关闭时照常写出 hash 校验文件。注意SDD 3.5 节列出了BL_Activated/BL_Deactivatedactivity low事件且在 Events.fppi 中已有定义但从当前源码看BL_SetLogging_cmdHandler并未触发这两个事件即该版本实现中这两个事件仅存在于接口层定义。4. 文件管理与轮转机制4.1 文件名规则首次调用BL_OpenFile后打开的第一个文件名为prefixbaseNamesuffix此后每当文件写满而轮转文件名变为prefixbaseNamecountersuffixcounter从 1 开始递增。命名逻辑位于 BufferLoggerFile.cppif (this-m_fileCounter 0) { this-m_name.format(%s%s%s, prefix, baseName, suffix); } else { this-m_name.format(%s%s% PRI_FwSizeType %s, prefix, baseName, m_fileCounter, suffix); }prefix/suffix/maxSize/sizeOfSize均由拓扑初始化时调用initLog()传入见第 7 节m_fileCounter初始为 0每次setBaseName()即收到BL_OpenFile都会重置为 0因此该命令同时充当重开一组全新日志的开关文件名格式化失败时上报BL_LogFileNameError事件Fw.StringFormatStatus类型。4.2 每条记录的磁盘布局每个被记录的 buffer 在文件中的物理格式为| 长度字段sizeOfSize 字节大端写入 | buffer 数据size 字节 |长度字段写入逻辑见 BufferLoggerFile.cpp要点sizeOfSize是initLog传入的 U8 值表示长度字段占用的字节数不得大于sizeof(FwSizeType)init中有FW_ASSERT强制写入时按大端序逐字节落盘若sizeOfSize sizeof(FwSizeType)且待写数据长度超出该字段可表示范围则拒绝写入并上报BL_LogFileWriteErrorOs::File::INVALID_ARGUMENT避免仅写入低字节导致日志损坏。4.3 尺寸上限与自动轮转File::logBuffer()BufferLoggerFile.cpp实现先判定、后写盘的轮转策略const FwSizeType projectedByteCount m_bytesWritten m_sizeOfSize size; if (projectedByteCount m_maxSize) { this-closeAndEmitEvent(); // 关闭当前文件含写 hash 文件 }投影字节数 已写入字节数 长度字段宽度 本次数据长度超过maxFileSize即轮转文件处于 CLOSED 状态时自动open()新文件因此即使尚未BL_OpenFile只要参数就绪写满后也会自动续开每次成功open()后m_bytesWritten清零、m_fileCounter自增。4.4 校验hash文件组件在每个日志文件关闭时为其生成配套校验文件供地面端校验。机制要点BufferLoggerFile.cpp写盘过程中通过Utils::Hash见 Utils/Hash/Hash.hpp增量计算整个文件的 hashm_hash.update()随每次writeBytes调用关闭文件时m_hash.finalize(hashBuffer)得到最终摘要再经Os::ValidatedFile的createHashFile()写出校验文件参考 Os/ValidatedFile.hpp校验文件写出失败时上报BL_LogFileValidationError携带校验文件名与Os::ValidateFile::Status返回值关闭文件会先m_osFile.close()再写 hash 文件最后把模式置回CLOSED组件析构时也会调用close()收尾。4.5 打开/写入失败路径open()前会检查 baseName 是否已设置、sizeOfSize是否合法、maxSize sizeOfSize是否成立BufferLoggerFile.cpp任一不满足即上报BL_NoLogFileOpenInitError并放弃打开——对应需求SVC-BUFFERLOGGER-008与 SDD 3.3 节描述Os::File::open(OPEN_WRITE)失败时上报BL_LogFileOpenError携带错误号与文件名写盘字节数与请求不符时上报BL_LogFileWriteError携带错误号、实际写入字节数与期望字节数。5. 命令接口四条命令全部为 async 命令opcode 与参数定义见 Commands.fppi命令Opcode参数说明BL_OpenFile0x00file: string size 40设置日志文件 base name并将文件计数器重置为 0若当前有文件打开则先关闭BL_CloseFile0x01无关闭当前打开的日志文件若有关闭时写出 hash 文件并上报BL_LogFileClosedBL_SetLogging0x02$state: LogState设置易失日志状态LOGGING_ON/LOGGING_OFF切到 OFF 时关闭当前文件BL_FlushFile0x03无冲刷当前日志文件到磁盘BL_FlushFile值得一提F´ 默认文件 I/O 为无缓冲直写因此 BufferLoggerFile.cpp 中flush()直接return true命令恒成功其存在是为了兼容将来改用带缓冲Os::File实现的场景SDD 中亦明确说明no-op with F Primes unbuffered file I/O。命令处理器统一通过cmdResponse_out(opCode, cmdSeq, Fw::CmdResponse::OK)应答BL_FlushFile失败时返回EXECUTION_ERROR见 BufferLogger.cpp。6. 事件与遥测6.1 事件清单事件定义于 Events.fppi格式串与参数完整对应 SDD 3.5 节事件SeverityID格式携带参数BL_LogFileCloseddiagnostic0x00File {} closed文件名string size 256BL_LogFileOpenErrorwarning high0x01Error {} opening file {}错误号 U32、文件名BL_LogFileValidationErrorwarning high0x02Failed creating validation file {} with status {}校验文件名、Os::ValidateFile::StatusBL_LogFileWriteErrorwarning high0x03Error {} while writing {} of {} bytes to {}错误号、实际写入字节数、期望字节数、文件名BL_Activatedactivity low0x04Buffer logger was activated无BL_Deactivatedactivity low0x05Buffer logger was deactivated无BL_NoLogFileOpenInitErrorwarning high0x06No log file open command无BL_LogFileNameErrorwarning high0x07Error {} formatting log file nameFw.StringFormatStatus6.2 遥测通道Telemetry.fppi 声明唯一遥测通道telemetry BufferLogger_NumLoggedBuffers: U32 id 0SDD 3.6 节将其描述为已记录的 buffer 数量当前版本接口层已定义该通道可用于监控日志吞吐。7. 拓扑集成与使用步骤按 SDD 4 节 Usage 并结合源码完整接入步骤如下实例化组件并启动线程在拓扑 FPP 中声明instance bufferLogger: Svc.BufferLogger base id 0xXXXX连接bufferSendIn/comIn/pingIn等输入与命令、事件、遥测、时间端口并启动其任务线程active 组件由 F´ 框架自动建线程。初始化日志参数在拓扑设置代码中调用initLog(prefix, suffix, maxFileSize, sizeOfSize)签名见 BufferLogger.hpplogFilePrefix文件名前缀如log/或空串logFileSuffix文件名后缀如.binmaxFileSize单个文件最大字节数需满足maxFileSize sizeOfSizesizeOfSize长度字段字节数1–8不得大于sizeof(FwSizeType)过小会限制单条可记录 buffer 的最大长度。 注意initLog内含断言必须在打开文件前调用FW_ASSERT(m_mode CLOSED)且sizeOfSize与maxSize的约束由 BufferLoggerFile.cpp 的断言强制。发送BL_OpenFile命令指定 base namestring 最大 40 字符计数器随之清零此后首次写文件使用prefixbaseNamesuffix命名。灌入数据向bufferSendIn灌入Fw::Buffer如传感器原始载荷向comIn灌入Fw::ComBuffer如封包化遥测/事件组件在线程上下文同步写盘。按需关闭/轮转调用BL_CloseFile主动收尾关闭时自动写 hash 文件或依赖写满自动轮转需要开启全新一组日志时再次发送BL_OpenFile用BL_SetLogging暂停/恢复记录用BL_FlushFile冲刷当前无缓冲 I/O 下为空操作。关键拓扑约束bufferSendIn会把每个 buffer 的所有权转移到bufferSendOut拓扑必须把转发输出路由回 buffer 归属方典型如Svc::BufferManager否则会出现缓冲区泄漏或二次释放这一点在 BufferLogger.cpp 的实现中体现得十分直接。8. 需求规格与测试验证SDD 2 节给出 8 条需求全部以单元测试为验证手段需求内容要点SVC-BUFFERLOGGER-001记录bufferSendIn收到的 bufferSVC-BUFFERLOGGER-002记录comIn收到的 Com bufferSVC-BUFFERLOGGER-003无论日志状态如何都转发bufferSendIn→bufferSendOutSVC-BUFFERLOGGER-004每条日志前缀可配置宽度的长度字段SVC-BUFFERLOGGER-005超过最大文件尺寸时自动开新文件SVC-BUFFERLOGGER-006提供打开/关闭/冲刷/启停四条命令SVC-BUFFERLOGGER-007关闭每个日志文件时写校验文件SVC-BUFFERLOGGER-008文件错误通过事件上报单元测试位于 Svc/BufferLogger/test/ut/按场景分为Logging日志行为、Errors错误路径与Health健康 ping三组。以 Logging.cpp 为例CloseFileTester验证连续发送BL_CloseFile命令时命令响应序列正确、文件与 hash 文件真实落盘checkFileExists/checkHashFileExists且仅当文件确实打开时才产生BL_LogFileClosed事件SendBuffersTester通过精确控制每个文件写入条数MAX_ENTRIES_PER_FILE - 1后补 1 条触发轮转断言轮转前后文件名按prefixbaseNamecountersuffix规律变化并核对每个轮转点的BL_LogFileClosed事件计数与文件名内容直接印证了 4.1/4.3 节的命名与轮转逻辑。9. 变更记录日期说明2026-08-10SDD 初始版本小结BufferLogger 是 F´ 中典型的旁路记录型活动组件通过bufferSendIn的透传设计做到对既有 buffer 流水线零干扰通过sizeOfSize可配长度字段、maxFileSize自动轮转与Utils::Hash增量校验文件为机载二进制数据传感器原始数据、遥测/事件封包提供了一套自描述、可校验、可持续写入的落盘方案。接入时牢记两条铁律拓扑初始化调用initLog必须在开文件之前bufferSendOut必须接回 buffer 归属方。【免费下载链接】fprimeF´ - A flight software and embedded systems framework项目地址: https://gitcode.com/GitHub_Trending/fpr/fprime创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考