NASA FPrime项目中的子拓扑开发指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00110/article/details/148415988

NASA FPrime项目中的子拓扑开发指南

fprime F麓 - A flight software and embedded systems framework 项目地址: https://gitcode.com/gh_mirrors/fpr/fprime

前言

在NASA FPrime框架中，子拓扑(Subtopology)是一种用于组织和管理复杂系统架构的重要技术。本文将深入讲解如何开发子拓扑，帮助开发者更好地构建模块化、可重用的航天软件系统。

什么是子拓扑？

子拓扑是FPrime框架中用于封装特定功能模块的拓扑结构。它允许开发者将相关的组件和连接关系打包成一个独立的单元，然后可以被主部署拓扑导入和使用。这种技术特别适合以下场景：

开发可共享的组件库
构建模块化系统架构
实现功能单元的解耦和重用

子拓扑开发方式

FPrime提供了两种开发子拓扑的方法：

手动编写子拓扑（本文重点介绍）
- 优点：实现简单，适合小型功能模块
- 缺点：灵活性有限，重用性较差
使用子拓扑自动编码工具
- 优点：功能强大，支持高级特性
- 缺点：学习曲线较陡

手动编写子拓扑

子拓扑文件结构

一个标准的子拓扑应包含以下文件：

MySubtopology/
├─ CMakeLists.txt        # 构建配置文件
├─ intentionally-empty.cpp # 空文件（解决命名空间问题）
├─ MySubtopology.cmake   # CMake模块文件
├─ MySubtopology.fpp     # 统一拓扑定义文件
└─ MySubtopologyTopologyDefs.hpp # 拓扑状态定义

核心文件详解

1. 统一拓扑定义文件(.fpp)

这是子拓扑的核心文件，包含了组件实例定义和连接关系。以下是一个随机数生成器(RNG)子拓扑的示例：

module MySubtopology {
    // 组件实例定义
    instance rng: MyLibrary.RNG base id 0xFF2FF \
        queue size Defaults.QUEUE_SIZE \
        stack size Defaults.STACK_SIZE \
        priority 100

    instance rateGroup: Svc.ActiveRateGroup base id 0xFF4FF \
        queue size Defaults.QUEUE_SIZE \
        stack size DEFAULTS.STACK_SIZE \
        priority 150

    // 拓扑结构定义
    topology MySubtopology {
        instance rng
        instance rateGroup

        // 连接关系定义
        connections MyWiring {
            rateGroup.RateGroupMemberOut[0] -> rng.run
        }
    }
}

2. 拓扑状态定义文件(.hpp)

这个文件定义了子拓扑的配置状态，允许主拓扑动态配置子拓扑：

struct TopologyState {
    U32 initialSeed;  // RNG初始种子
    // 其他可配置参数...
};

3. CMake构建文件

CMakeLists.txt文件确保子拓扑能正确编译：

set(SOURCE_FILES
    "${CMAKE_CURRENT_LIST_DIR}/RNGTopology.fpp"
    "${CMAKE_CURRENT_LIST_DIR}/intentionally-empty.cpp"
)

register_fprime_module()

set_target_properties(
    ${FPRIME_CURRENT_MODULE}
    PROPERTIES
    SOURCES "${CMAKE_CURRENT_LIST_DIR}/intentionally-empty.cpp"
)

intentionally-empty.cpp文件用于解决命名空间冲突问题。

集成子拓扑到主部署

将子拓扑集成到主部署需要以下步骤：

修改project.cmake：添加子拓扑目录

add_fprime_subdirectory("${CMAKE_CURRENT_LIST_DIR}/MySubtopology/")

修改主拓扑CMakeLists.txt：包含子拓扑CMake文件

include("${CMAKE_CURRENT_LIST_DIR}/../../MySubtopology/MySubtopology.cmake")

修改主拓扑定义文件：集成子拓扑状态
```
namespace PingEntries = GlobalDefs::PingEntries;
```

修改主拓扑.fpp文件：导入子拓扑并建立连接

import MySubtopology.MySubtopology
connections RateGroups {
    rateGroupDriver.CycleOut[3] -> MySubtopology.rateGroup.CycleIn
}

修改主拓扑.cpp文件：调用子拓扑生命周期函数

void configureTopology() {
    MySubtopology::TopologyState myState;
    myState.initialSeed = 12345;
    MySubtopology::configureTopology(myState);
}