CCSDS File Delivery Protocol - CfdpManager

CFDP/README.md

@@ -0,0 +1,25 @@
+# CFDP Utilities
+
+## Overview
+
+This directory contains CFDP utility classes used by the F' Framework.
+
+## Contents
+
+- **Checksum/**: CCSDS CFDP-compliant 32-bit checksum implementation
+
+## Where is CfdpManager?
+
+The main CFDP protocol implementation is located at:
+
+**`Svc/Ccsds/CfdpManager/`**
+
+If you're looking for the CFDP file transfer component, you'll find it there.
+
+## Why is Checksum here?
+
+The Checksum utility is used by the F' Framework's FilePacket class (`Fw/FilePacket/FilePacket.hpp`), which predates the CfdpManager component and supports legacy file transfer components (FileUplink, FileDownlink). To maintain framework independence, Checksum cannot be moved into CfdpManager.
+
+## Future
+
+A long-term solution would be to relocate Checksum to a framework utilities directory (e.g., `Fw/Utils/`), further clarifying the architectural separation.

Os/File.hpp

@@ -29,29 +29,29 @@ struct FileHandle {};
 class FileInterface {
   public:
     enum Mode {
-        OPEN_NO_MODE,     //!<  File mode not yet selected
-        OPEN_READ,        //!<  Open file for reading
+        OPEN_NO_MODE,     //!< File mode not yet selected
+        OPEN_READ,        //!< Open file for reading
         OPEN_CREATE,      //!< Open file for writing and truncates file if it exists, ie same flags as creat()
-        OPEN_WRITE,       //!<  Open file for writing
-        OPEN_SYNC_WRITE,  //!<  Open file for writing; writes don't return until data is on disk
+        OPEN_WRITE,       //!< Open file for writing
+        OPEN_SYNC_WRITE,  //!< Open file for writing; writes don't return until data is on disk
         OPEN_APPEND,      //!< Open file for appending
         MAX_OPEN_MODE     //!< Maximum value of mode
     };
 
     enum Status {
-        OP_OK,              //!<  Operation was successful
-        DOESNT_EXIST,       //!<  File doesn't exist (for read)
-        NO_SPACE,           //!<  No space left
-        NO_PERMISSION,      //!<  No permission to read/write file
-        BAD_SIZE,           //!<  Invalid size parameter
-        NOT_OPENED,         //!<  file hasn't been opened yet
+        OP_OK,              //!< Operation was successful
+        DOESNT_EXIST,       //!< File doesn't exist (for read)
+        NO_SPACE,           //!< No space left
+        NO_PERMISSION,      //!< No permission to read/write file
+        BAD_SIZE,           //!< Invalid size parameter
+        NOT_OPENED,         //!< file hasn't been opened yet
         FILE_EXISTS,        //!< file already exist (for CREATE with O_EXCL enabled)
         NOT_SUPPORTED,      //!< Kernel or file system does not support operation
         INVALID_MODE,       //!< Mode for file access is invalid for current operation
         INVALID_ARGUMENT,   //!< Invalid argument passed in
         NO_MORE_RESOURCES,  //!< No more available resources
-        OTHER_ERROR,        //!<  A catch-all for other errors. Have to look in implementation-specific code
-        OUTSIDE_SANDBOX,    //!<  Path falls outside the configured sandbox directory
+        OTHER_ERROR,        //!< A catch-all for other errors. Have to look in implementation-specific code
+        OUTSIDE_SANDBOX,    //!< Path falls outside the configured sandbox directory
         MAX_STATUS          //!< Maximum value of status
     };
 

Svc/Ccsds/CMakeLists.txt

@@ -7,4 +7,5 @@ add_fprime_subdirectory("${CMAKE_CURRENT_LIST_DIR}/TmFramer/")
 add_fprime_subdirectory("${CMAKE_CURRENT_LIST_DIR}/AosFramer/")
 add_fprime_subdirectory("${CMAKE_CURRENT_LIST_DIR}/AosDeframer/")
 add_fprime_subdirectory("${CMAKE_CURRENT_LIST_DIR}/ApidManager/")
+add_fprime_subdirectory("${CMAKE_CURRENT_LIST_DIR}/CfdpManager/")
 add_fprime_subdirectory("${CMAKE_CURRENT_LIST_DIR}/TestUtils/")

Svc/Ccsds/CfdpManager/ATTRIBUTION.md

@@ -0,0 +1,58 @@
+# CFDP Manager Attribution
+
+This component implements the CCSDS File Delivery Protocol (CFDP) for F-Prime (F'). It includes both ported code from NASA's Core Flight System (cFS) CFDP application and new F' implementations.
+
+## Source Attribution
+
+Portions of this code are derived from the NASA Core Flight System (cFS) CFDP (CF) Application:
+- **Repository**: https://github.com/nasa/CF
+- **Version**: 3.0.0
+- **License**: Apache License 2.0
+- **Copyright**: Copyright (c) 2019 United States Government as represented by the Administrator of the National Aeronautics and Space Administration
+- **NASA Docket**: GSC-18,447-1
+
+## Files Ported from CF
+
+The following files are ports/adaptations from CF source code and retain the original NASA copyright:
+
+### Core Engine & Transaction Management
+- `Engine.hpp` / `.cpp` - from `cf_cfdp.c` / `cf_cfdp.h`
+- `Transaction.hpp` - from `cf_cfdp_r.h` / `cf_cfdp_s.h` / `cf_cfdp_dispatch.h`
+- `TransactionTx.cpp` - from `cf_cfdp_s.c` / `cf_cfdp_dispatch.c`
+- `TransactionRx.cpp` - from `cf_cfdp_r.c` / `cf_cfdp_dispatch.c`
+
+### Data Structures & Utilities
+- `Types/Types.hpp` - from `cf_cfdp_types.h`
+- `Utils.hpp` / `.cpp` - from `cf_utils.h` / `cf_utils.c`
+- `Channel.hpp` / `.cpp` - from channel functions in `cf_cfdp.c` / `cf_utils.c`
+- `Chunk.hpp` / `.cpp` - from `cf_chunks.h` / `cf_chunks.c`
+- `Clist.hpp` / `.cpp` - from `cf_clist.h` / `cf_clist.c`
+
+Each of these files includes the full NASA copyright notice and Apache 2.0 license text in its header.
+
+## New F-Prime Implementations
+
+The following files are new implementations for F-Prime and do not contain CF-derived code:
+
+### Integration Layer
+- `CfdpManager.hpp` / `.cpp` - F-Prime component wrapper
+- `Timer.hpp` / `.cpp` - F-Prime timer implementation
+
+### PDU Object-Oriented Implementation
+All files in the `Types/` directory are new F' serializable implementations based on the CFDP Blue Book specification (CCSDS 727.0-B-5):
+- `Types/PduBase.hpp` - Base class for all PDU types
+- `Types/PduHeader.hpp` / `.cpp` - PDU header encoding/decoding
+- `Types/MetadataPdu.hpp` / `.cpp` - Metadata PDU
+- `Types/FileDataPdu.hpp` / `.cpp` - File Data PDU
+- `Types/EofPdu.hpp` / `.cpp` - End of File PDU
+- `Types/FinPdu.hpp` / `.cpp` - Finished PDU
+- `Types/AckPdu.hpp` / `.cpp` - Acknowledge PDU
+- `Types/NakPdu.hpp` / `.cpp` - Negative Acknowledge PDU
+
+These files implement CFDP PDU encoding/decoding based on the specification rather than porting CF's C-style codec.
+
+## License
+
+This component as a whole is licensed under the Apache License 2.0. See the top-level [LICENSE.txt](../../../LICENSE.txt) for the full license text.
+
+The CF-derived portions retain their original NASA copyright and Apache 2.0 license as documented in their file headers.

Svc/Ccsds/CfdpManager/CMakeLists.txt

@@ -0,0 +1,48 @@
+####
+# F Prime CMakeLists.txt:
+#
+# SOURCES: list of source files (to be compiled)
+# AUTOCODER_INPUTS: list of files to be passed to the autocoders
+# DEPENDS: list of libraries that this module depends on
+#
+# More information in the F´ CMake API documentation:
+# https://fprime.jpl.nasa.gov/latest/docs/reference/api/cmake/API/
+#
+####
+
+register_fprime_library(
+    AUTOCODER_INPUTS
+        "${CMAKE_CURRENT_LIST_DIR}/CfdpManager.fpp"
+    SOURCES
+        "${CMAKE_CURRENT_LIST_DIR}/CfdpManager.cpp"
+        "${CMAKE_CURRENT_LIST_DIR}/Engine.cpp"
+        "${CMAKE_CURRENT_LIST_DIR}/Chunk.cpp"
+        "${CMAKE_CURRENT_LIST_DIR}/Clist.cpp"
+        "${CMAKE_CURRENT_LIST_DIR}/Utils.cpp"
+        "${CMAKE_CURRENT_LIST_DIR}/Timer.cpp"
+        "${CMAKE_CURRENT_LIST_DIR}/Channel.cpp"
+        "${CMAKE_CURRENT_LIST_DIR}/TransactionTx.cpp"
+        "${CMAKE_CURRENT_LIST_DIR}/TransactionRx.cpp"
+    DEPENDS
+        CFDP_Checksum
+        Svc_Ccsds_CfdpManager_Types
+)
+
+### Subdirectories ###
+add_fprime_subdirectory("${CMAKE_CURRENT_LIST_DIR}/Types/")
+
+### Unit Tests ###
+register_fprime_ut(
+    AUTOCODER_INPUTS
+        "${CMAKE_CURRENT_LIST_DIR}/CfdpManager.fpp"
+    SOURCES
+        "${CMAKE_CURRENT_LIST_DIR}/test/ut/CfdpManagerTestMain.cpp"
+        "${CMAKE_CURRENT_LIST_DIR}/test/ut/CfdpManagerTester.cpp"
+        "${CMAKE_CURRENT_LIST_DIR}/test/ut/CfdpManagerCommandTests.cpp"
+        "${CMAKE_CURRENT_LIST_DIR}/test/ut/CfdpManagerParameterTests.cpp"
+        "${CMAKE_CURRENT_LIST_DIR}/test/ut/CfdpManagerMultiChannelTests.cpp"
+        "${CMAKE_CURRENT_LIST_DIR}/test/ut/CfdpManagerEventTests.cpp"
+        "${CMAKE_CURRENT_LIST_DIR}/test/ut/CfdpManagerHelperTests.cpp"
+        "${CMAKE_CURRENT_LIST_DIR}/test/ut/PduTester.cpp"
+    UT_AUTO_HELPERS
+)