# nasa/cfs architecture

> Architecture diagram of the GitHub repository nasa/cfs, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nasa/cfs
- Repository: https://github.com/nasa/cfs

## Overview

cFS is a demo bundle of flight-software framework components and applications. The principal runtime workflow is ground command ingress, application/core processing over the cFE software bus, and telemetry output to a ground system. The README also identifies file transfer, storage, scheduling, health, limit checking, checksum, and other demo capabilities. Core implementation sources were not sampled, so runtime links beyond the documented table configuration are dashed and unverified.

Main entry points: [`cfe`](https://github.com/nasa/cfs/tree/dev/cfe) (Software bus), [`sample_defs/tables/to_lab_sub.c`](https://github.com/nasa/cfs/blob/dev/sample_defs/tables/to_lab_sub.c) (Telemetry subscriptions), [`sample_defs/tables/sch_lab_table.c`](https://github.com/nasa/cfs/blob/dev/sample_defs/tables/sch_lab_table.c) (Schedule table), [`tools/cFS-GroundSystem`](https://github.com/nasa/cfs/tree/dev/tools/cFS-GroundSystem) (Ground system)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_framework["Flight Framework"]
  node_cfe["cFE core"]
  node_osal["OS abstraction"]
  node_psp["Platform support"]
  node_software_bus["Software bus"]
end

subgraph group_apps["Flight Applications"]
  node_ci["Command ingest"]
  node_scheduler["Scheduler"]
  node_telemetry["Telemetry output"]
  node_sample_app["Sample application"]
  node_data_storage["Data storage"]
  node_file_manager["File manager"]
  node_cf["CFDP transfer"]
  node_housekeeping["Housekeeping"]
  node_health_safety["Health and safety"]
  node_limit_checker["Limit checker"]
  node_stored_command["Stored command"]
  node_checksum["Checksum"]
  node_memory_dwell["Memory dwell"]
  node_sbn["Software bus network"]
end

subgraph group_config["Mission Configuration"]
  node_subscription_table["Telemetry subscriptions<br/>[to_lab_sub.c]"]
  node_schedule_table["Schedule table<br/>[sch_lab_table.c]"]
  node_message_ids["Message ID definitions<br/>[sbn_msgids.h]"]
  node_global_ids["Global message bases"]
  node_topic_ids["SBN topic IDs"]
  node_checksum_table["Checksum table<br/>[cs_tablestbl.c]"]
  node_limit_table["Limit definitions<br/>[lc_def_adt-test.c]"]
  node_performance_ids["Performance IDs<br/>[cfe_perfids.h]"]
  node_sample_table["Sample app table<br/>[sample_app_alt1.c]"]
end

subgraph group_ground["Ground and Tools"]
  node_ground_system["Ground system"]
  node_ground_tools["Ground tools"]
  node_table_tools["Table CRC tool"]
  node_elf_tool["ELF table converter"]
end

node_operator(("Ground operator"))

node_operator -.->|"commands and telemetry"| node_ground_system
node_ground_system -.->|"sends commands"| node_ci
node_ci -.->|"publishes commands"| node_software_bus
node_software_bus -.->|"dispatches messages"| node_cfe
node_software_bus -.->|"dispatches messages"| node_scheduler
node_software_bus -.->|"dispatches messages"| node_sample_app
node_software_bus -.->|"dispatches messages"| node_data_storage
node_software_bus -.->|"dispatches messages"| node_file_manager
node_software_bus -.->|"dispatches messages"| node_cf
node_software_bus -.->|"dispatches messages"| node_housekeeping
node_software_bus -.->|"dispatches messages"| node_health_safety
node_software_bus -.->|"dispatches messages"| node_limit_checker
node_software_bus -.->|"dispatches messages"| node_stored_command
node_software_bus -.->|"dispatches messages"| node_checksum
node_software_bus -.->|"dispatches messages"| node_memory_dwell
node_software_bus -.->|"dispatches messages"| node_sbn
node_telemetry -.->|"sends telemetry"| node_ground_system
node_subscription_table -->|"lists subscriptions"| node_telemetry
node_subscription_table -->|"lists core telemetry"| node_cfe
node_subscription_table -->|"lists app telemetry"| node_sample_app
node_subscription_table -->|"lists app telemetry"| node_cf
node_subscription_table -->|"lists app telemetry"| node_file_manager
node_subscription_table -->|"lists app telemetry"| node_health_safety
node_subscription_table -->|"lists app telemetry"| node_limit_checker
node_subscription_table -->|"lists app telemetry"| node_checksum
node_schedule_table -->|"configures schedule"| node_scheduler
node_schedule_table -->|"schedules core messages"| node_cfe
node_schedule_table -->|"schedules housekeeping"| node_telemetry
node_schedule_table -->|"schedules housekeeping"| node_sample_app
node_schedule_table -->|"schedules wakeup"| node_stored_command
node_schedule_table -->|"schedules cycle"| node_checksum
node_message_ids -->|"uses base values"| node_global_ids
node_message_ids -->|"uses topic IDs"| node_topic_ids
node_checksum_table -->|"defines defaults"| node_checksum
node_limit_table -.->|"defines limits"| node_limit_checker
node_performance_ids -.->|"defines performance IDs"| node_cfe
node_sample_table -.->|"defines app table"| node_sample_app
node_cfe -.->|"uses OS services"| node_osal
node_osal -.->|"uses platform support"| node_psp
node_ground_tools -.->|"supports operations"| node_ground_system
node_table_tools -.->|"processes tables"| node_checksum_table
node_elf_tool -.->|"converts tables"| node_checksum_table

click node_ground_system "https://github.com/nasa/cfs/tree/dev/tools/cFS-GroundSystem"
click node_ci "https://github.com/nasa/cfs/tree/dev/apps/ci_lab"
click node_cfe "https://github.com/nasa/cfs/tree/dev/cfe"
click node_osal "https://github.com/nasa/cfs/tree/dev/osal"
click node_psp "https://github.com/nasa/cfs/tree/dev/psp"
click node_software_bus "https://github.com/nasa/cfs/tree/dev/cfe"
click node_scheduler "https://github.com/nasa/cfs/tree/dev/apps/sch_lab"
click node_telemetry "https://github.com/nasa/cfs/tree/dev/apps/to_lab"
click node_sample_app "https://github.com/nasa/cfs/tree/dev/apps/sample_app"
click node_data_storage "https://github.com/nasa/cfs/tree/dev/apps/ds"
click node_file_manager "https://github.com/nasa/cfs/tree/dev/apps/fm"
click node_cf "https://github.com/nasa/cfs/tree/dev/apps/cf"
click node_housekeeping "https://github.com/nasa/cfs/tree/dev/apps/hk"
click node_health_safety "https://github.com/nasa/cfs/tree/dev/apps/hs"
click node_limit_checker "https://github.com/nasa/cfs/tree/dev/apps/lc"
click node_stored_command "https://github.com/nasa/cfs/tree/dev/apps/sc"
click node_checksum "https://github.com/nasa/cfs/tree/dev/apps/cs"
click node_memory_dwell "https://github.com/nasa/cfs/tree/dev/apps/md"
click node_sbn "https://github.com/nasa/cfs/tree/dev/apps/sbn"
click node_subscription_table "https://github.com/nasa/cfs/blob/dev/sample_defs/tables/to_lab_sub.c"
click node_schedule_table "https://github.com/nasa/cfs/blob/dev/sample_defs/tables/sch_lab_table.c"
click node_message_ids "https://github.com/nasa/cfs/blob/dev/sample_defs/cpu1/sbn_msgids.h"
click node_global_ids "https://github.com/nasa/cfs/blob/dev/sample_defs/inc/global_core_api_base_msgid_values.h"
click node_topic_ids "https://github.com/nasa/cfs/blob/dev/sample_defs/inc/global_sbn_topicids.h"
click node_checksum_table "https://github.com/nasa/cfs/blob/dev/sample_defs/tables/cs_tablestbl.c"
click node_limit_table "https://github.com/nasa/cfs/blob/dev/sample_defs/tables/lc_def_adt-test.c"
click node_performance_ids "https://github.com/nasa/cfs/blob/dev/sample_defs/cfe_perfids.h"
click node_sample_table "https://github.com/nasa/cfs/blob/dev/sample_defs/tables/sample_app_alt1.c"
click node_ground_tools "https://github.com/nasa/cfs/tree/dev/tools/commandline-tools"
click node_table_tools "https://github.com/nasa/cfs/tree/dev/tools/tblCRCTool"
click node_elf_tool "https://github.com/nasa/cfs/tree/dev/tools/elf2cfetbl"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cfe,node_osal,node_psp,node_software_bus toneBlue
class node_ci,node_scheduler,node_telemetry,node_sample_app,node_data_storage,node_file_manager,node_cf,node_housekeeping,node_health_safety,node_limit_checker,node_stored_command,node_checksum,node_memory_dwell,node_sbn toneAmber
class node_subscription_table,node_schedule_table,node_message_ids,node_global_ids,node_topic_ids,node_checksum_table,node_limit_table,node_performance_ids,node_sample_table toneMint
class node_ground_system,node_ground_tools,node_table_tools,node_elf_tool toneRose
class node_operator toneIndigo
```

## Components

### Flight Framework

- [cFE core](https://github.com/nasa/cfs/tree/dev/cfe): `cfe`
- [OS abstraction](https://github.com/nasa/cfs/tree/dev/osal): `osal`
- [Platform support](https://github.com/nasa/cfs/tree/dev/psp): `psp`
- [Software bus](https://github.com/nasa/cfs/tree/dev/cfe): `cfe`

### Flight Applications

- [Command ingest](https://github.com/nasa/cfs/tree/dev/apps/ci_lab): `apps/ci_lab`
- [Scheduler](https://github.com/nasa/cfs/tree/dev/apps/sch_lab): `apps/sch_lab`
- [Telemetry output](https://github.com/nasa/cfs/tree/dev/apps/to_lab): `apps/to_lab`
- [Sample application](https://github.com/nasa/cfs/tree/dev/apps/sample_app): `apps/sample_app`
- [Data storage](https://github.com/nasa/cfs/tree/dev/apps/ds): `apps/ds`
- [File manager](https://github.com/nasa/cfs/tree/dev/apps/fm): `apps/fm`
- [CFDP transfer](https://github.com/nasa/cfs/tree/dev/apps/cf): `apps/cf`
- [Housekeeping](https://github.com/nasa/cfs/tree/dev/apps/hk): `apps/hk`
- [Health and safety](https://github.com/nasa/cfs/tree/dev/apps/hs): `apps/hs`
- [Limit checker](https://github.com/nasa/cfs/tree/dev/apps/lc): `apps/lc`
- [Stored command](https://github.com/nasa/cfs/tree/dev/apps/sc): `apps/sc`
- [Checksum](https://github.com/nasa/cfs/tree/dev/apps/cs): `apps/cs`
- [Memory dwell](https://github.com/nasa/cfs/tree/dev/apps/md): `apps/md`
- [Software bus network](https://github.com/nasa/cfs/tree/dev/apps/sbn): `apps/sbn`

### Mission Configuration

- [Telemetry subscriptions](https://github.com/nasa/cfs/blob/dev/sample_defs/tables/to_lab_sub.c): `sample_defs/tables/to_lab_sub.c`
- [Schedule table](https://github.com/nasa/cfs/blob/dev/sample_defs/tables/sch_lab_table.c): `sample_defs/tables/sch_lab_table.c`
- [Message ID definitions](https://github.com/nasa/cfs/blob/dev/sample_defs/cpu1/sbn_msgids.h): `sample_defs/cpu1/sbn_msgids.h`
- [Global message bases](https://github.com/nasa/cfs/blob/dev/sample_defs/inc/global_core_api_base_msgid_values.h): `sample_defs/inc/global_core_api_base_msgid_values.h`
- [SBN topic IDs](https://github.com/nasa/cfs/blob/dev/sample_defs/inc/global_sbn_topicids.h): `sample_defs/inc/global_sbn_topicids.h`
- [Checksum table](https://github.com/nasa/cfs/blob/dev/sample_defs/tables/cs_tablestbl.c): `sample_defs/tables/cs_tablestbl.c`
- [Limit definitions](https://github.com/nasa/cfs/blob/dev/sample_defs/tables/lc_def_adt-test.c): `sample_defs/tables/lc_def_adt-test.c`
- [Performance IDs](https://github.com/nasa/cfs/blob/dev/sample_defs/cfe_perfids.h): `sample_defs/cfe_perfids.h`
- [Sample app table](https://github.com/nasa/cfs/blob/dev/sample_defs/tables/sample_app_alt1.c): `sample_defs/tables/sample_app_alt1.c`

### Ground and Tools

- [Ground system](https://github.com/nasa/cfs/tree/dev/tools/cFS-GroundSystem): `tools/cFS-GroundSystem`
- [Ground tools](https://github.com/nasa/cfs/tree/dev/tools/commandline-tools): `tools/commandline-tools`
- [Table CRC tool](https://github.com/nasa/cfs/tree/dev/tools/tblCRCTool): `tools/tblCRCTool`
- [ELF table converter](https://github.com/nasa/cfs/tree/dev/tools/elf2cfetbl): `tools/elf2cfetbl`

### Other components

- **Ground operator**

## Connections

- Ground operator → Ground system: commands and telemetry (evidence: `README.md`)
- Ground system → Command ingest: sends commands
- Command ingest → Software bus: publishes commands
- Software bus → cFE core: dispatches messages
- Software bus → Scheduler: dispatches messages
- Software bus → Sample application: dispatches messages
- Software bus → Data storage: dispatches messages
- Software bus → File manager: dispatches messages
- Software bus → CFDP transfer: dispatches messages
- Software bus → Housekeeping: dispatches messages
- Software bus → Health and safety: dispatches messages
- Software bus → Limit checker: dispatches messages
- Software bus → Stored command: dispatches messages
- Software bus → Checksum: dispatches messages
- Software bus → Memory dwell: dispatches messages
- Software bus → Software bus network: dispatches messages
- Telemetry output → Ground system: sends telemetry (evidence: `README.md`)
- Telemetry subscriptions → Telemetry output: lists subscriptions (evidence: `sample_defs/tables/to_lab_sub.c`)
- Telemetry subscriptions → cFE core: lists core telemetry (evidence: `sample_defs/tables/to_lab_sub.c`)
- Telemetry subscriptions → Sample application: lists app telemetry (evidence: `sample_defs/tables/to_lab_sub.c`)
- Telemetry subscriptions → CFDP transfer: lists app telemetry (evidence: `sample_defs/tables/to_lab_sub.c`)
- Telemetry subscriptions → File manager: lists app telemetry (evidence: `sample_defs/tables/to_lab_sub.c`)
- Telemetry subscriptions → Health and safety: lists app telemetry (evidence: `sample_defs/tables/to_lab_sub.c`)
- Telemetry subscriptions → Limit checker: lists app telemetry (evidence: `sample_defs/tables/to_lab_sub.c`)
- Telemetry subscriptions → Checksum: lists app telemetry (evidence: `sample_defs/tables/to_lab_sub.c`)
- Schedule table → Scheduler: configures schedule (evidence: `sample_defs/tables/sch_lab_table.c`)
- Schedule table → cFE core: schedules core messages (evidence: `sample_defs/tables/sch_lab_table.c`)
- Schedule table → Telemetry output: schedules housekeeping (evidence: `sample_defs/tables/sch_lab_table.c`)
- Schedule table → Sample application: schedules housekeeping (evidence: `sample_defs/tables/sch_lab_table.c`)
- Schedule table → Stored command: schedules wakeup (evidence: `sample_defs/tables/sch_lab_table.c`)
- Schedule table → Checksum: schedules cycle (evidence: `sample_defs/tables/sch_lab_table.c`)
- Message ID definitions → Global message bases: uses base values (evidence: `sample_defs/cpu1/sbn_msgids.h`)
- Message ID definitions → SBN topic IDs: uses topic IDs (evidence: `sample_defs/cpu1/sbn_msgids.h`)
- Checksum table → Checksum: defines defaults (evidence: `sample_defs/tables/cs_tablestbl.c`)
- Limit definitions → Limit checker: defines limits
- Performance IDs → cFE core: defines performance IDs
- Sample app table → Sample application: defines app table
- cFE core → OS abstraction: uses OS services
- OS abstraction → Platform support: uses platform support
- Ground tools → Ground system: supports operations
- Table CRC tool → Checksum table: processes tables
- ELF table converter → Checksum table: converts tables
