FileManagerComponentAc.hpp

Go to the documentation of this file.

// ======================================================================
// \title  FileManagerComponentAc.hpp
// \author Generated by fpp-to-cpp
// \brief  hpp file for FileManager component base class
// ======================================================================

#ifndef Svc_FileManagerComponentAc_HPP
#define Svc_FileManagerComponentAc_HPP

#include <atomic>

#include "Fw/Cmd/CmdPortAc.hpp"
#include "Fw/Cmd/CmdRegPortAc.hpp"
#include "Fw/Cmd/CmdResponsePortAc.hpp"
#include "Fw/Cmd/CmdString.hpp"
#include "Fw/Comp/ActiveComponentBase.hpp"
#include "Fw/Dp/DpContainer.hpp"
#include "Fw/Dp/DpGetPortAc.hpp"
#include "Fw/Dp/DpSendPortAc.hpp"
#include "Fw/FPrimeBasicTypes.hpp"
#include "Fw/Log/LogPortAc.hpp"
#include "Fw/Log/LogString.hpp"
#include "Fw/Log/LogTextPortAc.hpp"
#if !FW_DIRECT_PORT_CALLS
#include "Fw/Port/InputSerializePort.hpp"
#endif
#if !FW_DIRECT_PORT_CALLS
#include "Fw/Port/OutputSerializePort.hpp"
#endif
#include "Fw/Time/TimePortAc.hpp"
#include "Fw/Tlm/TlmPortAc.hpp"
#include "Fw/Tlm/TlmString.hpp"
#include "Fw/Types/InternalInterfaceString.hpp"
#include "Fw/Types/StringFormatStatusEnumAc.hpp"
#include "Svc/FileManager/FileManager_FileChunkHeaderSerializableAc.hpp"
#include "Svc/FileManager/FileManager_GenerateDpModeEnumAc.hpp"
#include "Svc/FileManager/FileManager_GenerateDpStageEnumAc.hpp"
#include "Svc/Ping/PingPortAc.hpp"
#include "Svc/Sched/SchedPortAc.hpp"
#include "default/config/FwSizeStoreTypeAliasAc.hpp"
#include "default/config/FwSizeTypeAliasAc.hpp"

namespace Svc {

  class FileManagerComponentBase :
    public Fw::ActiveComponentBase
  {

      // ----------------------------------------------------------------------
      // Friend classes
      // ----------------------------------------------------------------------

      friend class FileManagerTesterBase;
      friend class FileManagerTester;

    protected:

      // ----------------------------------------------------------------------
      // Constants
      // ----------------------------------------------------------------------

      enum {
        NUM_CMDIN_INPUT_PORTS = 1,
      };

      enum {
        NUM_PINGIN_INPUT_PORTS = 1,
        NUM_SCHEDIN_INPUT_PORTS = 1,
      };

      enum {
        NUM_LOGTEXT_OUTPUT_PORTS = 1,
        NUM_CMDREGOUT_OUTPUT_PORTS = 1,
        NUM_CMDRESPONSEOUT_OUTPUT_PORTS = 1,
        NUM_EVENTOUT_OUTPUT_PORTS = 1,
        NUM_PRODUCTGETOUT_OUTPUT_PORTS = 1,
        NUM_PRODUCTSENDOUT_OUTPUT_PORTS = 1,
        NUM_TIMECALLER_OUTPUT_PORTS = 1,
        NUM_TLMOUT_OUTPUT_PORTS = 1,
      };

      enum {
        NUM_PINGOUT_OUTPUT_PORTS = 1,
      };

      enum {
        OPCODE_CREATEDIRECTORY = 0x0, 
        OPCODE_MOVEFILE = 0x1, 
        OPCODE_REMOVEDIRECTORY = 0x2, 
        OPCODE_REMOVEFILE = 0x3, 
        OPCODE_APPENDFILE = 0x5, 
        OPCODE_FILESIZE = 0x6, 
        OPCODE_LISTDIRECTORY = 0x7, 
        OPCODE_CALCULATECRC = 0x8, 
        OPCODE_GENERATEDP = 0x9, 
      };

      enum {
        EVENTID_DIRECTORYCREATEERROR = 0x0, 
        EVENTID_DIRECTORYREMOVEERROR = 0x1, 
        EVENTID_FILEMOVEERROR = 0x2, 
        EVENTID_FILEREMOVEERROR = 0x3, 
        EVENTID_APPENDFILEFAILED = 0x5, 
        EVENTID_APPENDFILESUCCEEDED = 0x6, 
        EVENTID_CREATEDIRECTORYSUCCEEDED = 0x8, 
        EVENTID_REMOVEDIRECTORYSUCCEEDED = 0x9, 
        EVENTID_MOVEFILESUCCEEDED = 0xa, 
        EVENTID_REMOVEFILESUCCEEDED = 0xb, 
        EVENTID_APPENDFILESTARTED = 0xc, 
        EVENTID_CREATEDIRECTORYSTARTED = 0xe, 
        EVENTID_REMOVEDIRECTORYSTARTED = 0xf, 
        EVENTID_MOVEFILESTARTED = 0x10, 
        EVENTID_REMOVEFILESTARTED = 0x11, 
        EVENTID_FILESIZESUCCEEDED = 0x12, 
        EVENTID_FILESIZEERROR = 0x13, 
        EVENTID_FILESIZESTARTED = 0x14, 
        EVENTID_LISTDIRECTORYSTARTED = 0x15, 
        EVENTID_LISTDIRECTORYSUCCEEDED = 0x16, 
        EVENTID_LISTDIRECTORYERROR = 0x17, 
        EVENTID_DIRECTORYLISTING = 0x18, 
        EVENTID_DIRECTORYLISTINGSUBDIR = 0x19, 
        EVENTID_CALCULATECRCSTARTED = 0x1a, 
        EVENTID_CALCULATECRCFAILED = 0x1b, 
        EVENTID_CALCULATECRCSUCCEEDED = 0x1c, 
        EVENTID_FILENAMEFORMATERROR = 0x1d, 
        EVENTID_GENERATEDPSTARTED = 0x1e, 
        EVENTID_GENERATEDPCOMPLETE = 0x1f, 
        EVENTID_GENERATEDPFAILED = 0x20, 
        EVENTID_GENERATEDPBUFFERFAILED = 0x21, 
        EVENTID_GENERATEDPINVALIDRANGE = 0x22, 
        EVENTID_PATHOUTSIDESANDBOX = 0x23, 
      };

      enum {
        CHANNELID_COMMANDSEXECUTED = 0x0, 
        CHANNELID_ERRORS = 0x1, 
      };

      static constexpr FwSizeType SIZE_OF_FileChunkDataRecord_RECORD(FwSizeType arraySize) {
        return sizeof(FwDpIdType) + sizeof(FwSizeStoreType) + arraySize * sizeof(U8);
      }
      static constexpr FwSizeType SIZE_OF_FileChunkHeaderRecord_RECORD =
        sizeof(FwDpIdType) + Svc::FileManager_FileChunkHeader::SERIALIZED_SIZE;

    protected:

      // ----------------------------------------------------------------------
      // Types for data products
      // ----------------------------------------------------------------------

      struct ContainerId {
        enum T : FwDpIdType {
          FileDpContainer = 0,
        };
      };

      struct ContainerPriority {
        enum T : FwDpPriorityType {
          FileDpContainer = 10,
        };
      };

      struct RecordId {
        enum T : FwDpIdType {
          FileChunkHeaderRecord = 0,
          FileChunkDataRecord = 1,
        };
      };

      class DpContainer :
        public Fw::DpContainer
      {

        public:

          DpContainer(
              FwDpIdType id, 
              const Fw::Buffer& buffer, 
              FwDpIdType baseId 
          );

          DpContainer();

        public:

          Fw::SerializeStatus serializeRecord_FileChunkDataRecord(
              const U8* array, 
              FwSizeType size 
          );

          Fw::SerializeStatus serializeRecord_FileChunkHeaderRecord(
              const Svc::FileManager_FileChunkHeader& elt 
          );

          FwDpIdType getBaseId() const { return this->m_baseId; }

          void setBaseId(FwDpIdType baseId) { this->m_baseId = baseId; }

        private:

          FwDpIdType m_baseId;

      };

    public:

      // ----------------------------------------------------------------------
      // Component initialization
      // ----------------------------------------------------------------------

      void init(
          FwSizeType queueDepth, 
          FwEnumStoreType instance = 0 
      );

#if !FW_DIRECT_PORT_CALLS

    public:

      // ----------------------------------------------------------------------
      // Getters for special input ports
      // ----------------------------------------------------------------------

      Fw::InputCmdPort* get_cmdIn_InputPort(
          FwIndexType portNum 
      );

#endif

#if !FW_DIRECT_PORT_CALLS

    public:

      // ----------------------------------------------------------------------
      // Getters for typed input ports
      // ----------------------------------------------------------------------

      Svc::InputPingPort* get_pingIn_InputPort(
          FwIndexType portNum 
      );

      Svc::InputSchedPort* get_schedIn_InputPort(
          FwIndexType portNum 
      );

#endif

#if !FW_DIRECT_PORT_CALLS

    public:

      // ----------------------------------------------------------------------
      // Connect input ports to special output ports
      // ----------------------------------------------------------------------

#if FW_ENABLE_TEXT_LOGGING == 1

      void set_LogText_OutputPort(
          FwIndexType portNum, 
          Fw::InputLogTextPort* port 
      );

#endif

      void set_cmdRegOut_OutputPort(
          FwIndexType portNum, 
          Fw::InputCmdRegPort* port 
      );

      void set_cmdResponseOut_OutputPort(
          FwIndexType portNum, 
          Fw::InputCmdResponsePort* port 
      );

      void set_eventOut_OutputPort(
          FwIndexType portNum, 
          Fw::InputLogPort* port 
      );

      void set_productGetOut_OutputPort(
          FwIndexType portNum, 
          Fw::InputDpGetPort* port 
      );

      void set_productSendOut_OutputPort(
          FwIndexType portNum, 
          Fw::InputDpSendPort* port 
      );

      void set_timeCaller_OutputPort(
          FwIndexType portNum, 
          Fw::InputTimePort* port 
      );

      void set_tlmOut_OutputPort(
          FwIndexType portNum, 
          Fw::InputTlmPort* port 
      );

#endif

#if !FW_DIRECT_PORT_CALLS

    public:

      // ----------------------------------------------------------------------
      // Connect typed input ports to typed output ports
      // ----------------------------------------------------------------------

      void set_pingOut_OutputPort(
          FwIndexType portNum, 
          Svc::InputPingPort* port 
      );

#endif

#if !FW_DIRECT_PORT_CALLS && FW_PORT_SERIALIZATION

    public:

      // ----------------------------------------------------------------------
      // Connect serial input ports to special output ports
      // ----------------------------------------------------------------------

#if FW_ENABLE_TEXT_LOGGING == 1

      void set_LogText_OutputPort(
          FwIndexType portNum, 
          Fw::InputSerializePort* port 
      );

#endif

      void set_cmdRegOut_OutputPort(
          FwIndexType portNum, 
          Fw::InputSerializePort* port 
      );

      void set_cmdResponseOut_OutputPort(
          FwIndexType portNum, 
          Fw::InputSerializePort* port 
      );

      void set_eventOut_OutputPort(
          FwIndexType portNum, 
          Fw::InputSerializePort* port 
      );

      void set_productSendOut_OutputPort(
          FwIndexType portNum, 
          Fw::InputSerializePort* port 
      );

      void set_timeCaller_OutputPort(
          FwIndexType portNum, 
          Fw::InputSerializePort* port 
      );

      void set_tlmOut_OutputPort(
          FwIndexType portNum, 
          Fw::InputSerializePort* port 
      );

#endif

#if !FW_DIRECT_PORT_CALLS && FW_PORT_SERIALIZATION

    public:

      // ----------------------------------------------------------------------
      // Connect serial input ports to typed output ports
      // ----------------------------------------------------------------------

      void set_pingOut_OutputPort(
          FwIndexType portNum, 
          Fw::InputSerializePort* port 
      );

#endif

    public:

      // ----------------------------------------------------------------------
      // Command registration
      // ----------------------------------------------------------------------

      void regCommands();

    protected:

      // ----------------------------------------------------------------------
      // Component construction and destruction
      // ----------------------------------------------------------------------

      FileManagerComponentBase(
          const char* compName = "" 
      );

      virtual ~FileManagerComponentBase();

    protected:

      // ----------------------------------------------------------------------
      // Getters for numbers of special input ports
      // ----------------------------------------------------------------------

      static constexpr FwIndexType getNum_cmdIn_InputPorts() {
        return NUM_CMDIN_INPUT_PORTS;
      }

    protected:

      // ----------------------------------------------------------------------
      // Getters for numbers of typed input ports
      // ----------------------------------------------------------------------

      static constexpr FwIndexType getNum_pingIn_InputPorts() {
        return NUM_PINGIN_INPUT_PORTS;
      }

      static constexpr FwIndexType getNum_schedIn_InputPorts() {
        return NUM_SCHEDIN_INPUT_PORTS;
      }

    protected:

      // ----------------------------------------------------------------------
      // Getters for numbers of special output ports
      // ----------------------------------------------------------------------

#if FW_ENABLE_TEXT_LOGGING == 1

      static constexpr FwIndexType getNum_LogText_OutputPorts() {
        return NUM_LOGTEXT_OUTPUT_PORTS;
      }

#endif

      static constexpr FwIndexType getNum_cmdRegOut_OutputPorts() {
        return NUM_CMDREGOUT_OUTPUT_PORTS;
      }

      static constexpr FwIndexType getNum_cmdResponseOut_OutputPorts() {
        return NUM_CMDRESPONSEOUT_OUTPUT_PORTS;
      }

      static constexpr FwIndexType getNum_eventOut_OutputPorts() {
        return NUM_EVENTOUT_OUTPUT_PORTS;
      }

      static constexpr FwIndexType getNum_productGetOut_OutputPorts() {
        return NUM_PRODUCTGETOUT_OUTPUT_PORTS;
      }

      static constexpr FwIndexType getNum_productSendOut_OutputPorts() {
        return NUM_PRODUCTSENDOUT_OUTPUT_PORTS;
      }

      static constexpr FwIndexType getNum_timeCaller_OutputPorts() {
        return NUM_TIMECALLER_OUTPUT_PORTS;
      }

      static constexpr FwIndexType getNum_tlmOut_OutputPorts() {
        return NUM_TLMOUT_OUTPUT_PORTS;
      }

    protected:

      // ----------------------------------------------------------------------
      // Getters for numbers of typed output ports
      // ----------------------------------------------------------------------

      static constexpr FwIndexType getNum_pingOut_OutputPorts() {
        return NUM_PINGOUT_OUTPUT_PORTS;
      }

    protected:

      // ----------------------------------------------------------------------
      // Connection status queries for special output ports
      // ----------------------------------------------------------------------

#if FW_ENABLE_TEXT_LOGGING == 1

      bool isConnected_LogText_OutputPort(
          FwIndexType portNum 
      ) const;

#endif

      bool isConnected_cmdRegOut_OutputPort(
          FwIndexType portNum 
      ) const;

      bool isConnected_cmdResponseOut_OutputPort(
          FwIndexType portNum 
      ) const;

      bool isConnected_eventOut_OutputPort(
          FwIndexType portNum 
      ) const;

      bool isConnected_productGetOut_OutputPort(
          FwIndexType portNum 
      ) const;

      bool isConnected_productSendOut_OutputPort(
          FwIndexType portNum 
      ) const;

      bool isConnected_timeCaller_OutputPort(
          FwIndexType portNum 
      ) const;

      bool isConnected_tlmOut_OutputPort(
          FwIndexType portNum 
      ) const;

    protected:

      // ----------------------------------------------------------------------
      // Connection status queries for typed output ports
      // ----------------------------------------------------------------------

      bool isConnected_pingOut_OutputPort(
          FwIndexType portNum 
      ) const;

#if FW_DIRECT_PORT_CALLS
    public:
#else
    protected:
#endif

      // ----------------------------------------------------------------------
      // Port handler base-class functions for special input ports
      //
      // Call these functions directly to bypass the corresponding ports
      // ----------------------------------------------------------------------

      void cmdIn_handlerBase(
          FwIndexType portNum, 
          FwOpcodeType opCode, 
          U32 cmdSeq, 
          Fw::CmdArgBuffer& args 
      );

    protected:

      // ----------------------------------------------------------------------
      // Handlers to implement for typed input ports
      // ----------------------------------------------------------------------

      virtual void pingIn_handler(
          FwIndexType portNum, 
          U32 key 
      ) = 0;

      virtual void schedIn_handler(
          FwIndexType portNum, 
          U32 context 
      ) = 0;

#if FW_DIRECT_PORT_CALLS
    public:
#else
    protected:
#endif

      // ----------------------------------------------------------------------
      // Port handler base-class functions for typed input ports
      //
      // Call these functions directly to bypass the corresponding ports
      // ----------------------------------------------------------------------

      void pingIn_handlerBase(
          FwIndexType portNum, 
          U32 key 
      );

      void schedIn_handlerBase(
          FwIndexType portNum, 
          U32 context 
      );

    protected:

      // ----------------------------------------------------------------------
      // Pre-message hooks for typed async input ports
      //
      // Each of these functions is invoked just before processing a message
      // on the corresponding port. By default, they do nothing. You can
      // override them to provide specific pre-message behavior.
      // ----------------------------------------------------------------------

      virtual void pingIn_preMsgHook(
          FwIndexType portNum, 
          U32 key 
      );

    protected:

      // ----------------------------------------------------------------------
      // Invocation functions for typed output ports
      // ----------------------------------------------------------------------

      void pingOut_out(
          FwIndexType portNum, 
          U32 key 
      ) const;

    protected:

      // ----------------------------------------------------------------------
      // Internal interface handlers
      // ----------------------------------------------------------------------

      virtual void run_internalInterfaceHandler() = 0;

    protected:

      // ----------------------------------------------------------------------
      // Internal interface base-class functions
      // ----------------------------------------------------------------------

      void run_internalInterfaceInvoke();

    protected:

      // ----------------------------------------------------------------------
      // Command response
      // ----------------------------------------------------------------------

      void cmdResponse_out(
          FwOpcodeType opCode, 
          U32 cmdSeq, 
          Fw::CmdResponse response 
      );

    protected:

      // ----------------------------------------------------------------------
      // Command handlers to implement
      // ----------------------------------------------------------------------

      virtual void CreateDirectory_cmdHandler(
          FwOpcodeType opCode, 
          U32 cmdSeq, 
          const Fw::CmdStringArg& dirName 
      ) = 0;

      virtual void MoveFile_cmdHandler(
          FwOpcodeType opCode, 
          U32 cmdSeq, 
          const Fw::CmdStringArg& sourceFileName, 
          const Fw::CmdStringArg& destFileName 
      ) = 0;

      virtual void RemoveDirectory_cmdHandler(
          FwOpcodeType opCode, 
          U32 cmdSeq, 
          const Fw::CmdStringArg& dirName 
      ) = 0;

      virtual void RemoveFile_cmdHandler(
          FwOpcodeType opCode, 
          U32 cmdSeq, 
          const Fw::CmdStringArg& fileName, 
          bool ignoreErrors 
      ) = 0;

      virtual void AppendFile_cmdHandler(
          FwOpcodeType opCode, 
          U32 cmdSeq, 
          const Fw::CmdStringArg& source, 
          const Fw::CmdStringArg& target 
      ) = 0;

      virtual void FileSize_cmdHandler(
          FwOpcodeType opCode, 
          U32 cmdSeq, 
          const Fw::CmdStringArg& fileName 
      ) = 0;

      virtual void ListDirectory_cmdHandler(
          FwOpcodeType opCode, 
          U32 cmdSeq, 
          const Fw::CmdStringArg& dirName 
      ) = 0;

      virtual void CalculateCrc_cmdHandler(
          FwOpcodeType opCode, 
          U32 cmdSeq, 
          const Fw::CmdStringArg& filename 
      ) = 0;

      virtual void GenerateDp_cmdHandler(
          FwOpcodeType opCode, 
          U32 cmdSeq, 
          const Fw::CmdStringArg& fileName, 
          U32 chunkSize, 
          U64 beginOffset, 
          U64 endOffset, 
          U32 priority, 
          const Svc::FileManager_GenerateDpMode& mode 
      ) = 0;

    protected:

      // ----------------------------------------------------------------------
      // Command handler base-class functions
      //
      // Call these functions directly to bypass the command input port
      // ----------------------------------------------------------------------

      void CreateDirectory_cmdHandlerBase(
          FwOpcodeType opCode, 
          U32 cmdSeq, 
          Fw::CmdArgBuffer& args 
      );

      void MoveFile_cmdHandlerBase(
          FwOpcodeType opCode, 
          U32 cmdSeq, 
          Fw::CmdArgBuffer& args 
      );

      void RemoveDirectory_cmdHandlerBase(
          FwOpcodeType opCode, 
          U32 cmdSeq, 
          Fw::CmdArgBuffer& args 
      );

      void RemoveFile_cmdHandlerBase(
          FwOpcodeType opCode, 
          U32 cmdSeq, 
          Fw::CmdArgBuffer& args 
      );

      void AppendFile_cmdHandlerBase(
          FwOpcodeType opCode, 
          U32 cmdSeq, 
          Fw::CmdArgBuffer& args 
      );

      void FileSize_cmdHandlerBase(
          FwOpcodeType opCode, 
          U32 cmdSeq, 
          Fw::CmdArgBuffer& args 
      );

      void ListDirectory_cmdHandlerBase(
          FwOpcodeType opCode, 
          U32 cmdSeq, 
          Fw::CmdArgBuffer& args 
      );

      void CalculateCrc_cmdHandlerBase(
          FwOpcodeType opCode, 
          U32 cmdSeq, 
          Fw::CmdArgBuffer& args 
      );

      void GenerateDp_cmdHandlerBase(
          FwOpcodeType opCode, 
          U32 cmdSeq, 
          Fw::CmdArgBuffer& args 
      );

    protected:

      // ----------------------------------------------------------------------
      // Pre-message hooks for async commands
      //
      // Each of these functions is invoked just before processing the
      // corresponding command. By default they do nothing. You can
      // override them to provide specific pre-command behavior.
      // ----------------------------------------------------------------------

      virtual void CreateDirectory_preMsgHook(
          FwOpcodeType opCode, 
          U32 cmdSeq 
      );

      virtual void MoveFile_preMsgHook(
          FwOpcodeType opCode, 
          U32 cmdSeq 
      );

      virtual void RemoveDirectory_preMsgHook(
          FwOpcodeType opCode, 
          U32 cmdSeq 
      );

      virtual void RemoveFile_preMsgHook(
          FwOpcodeType opCode, 
          U32 cmdSeq 
      );

      virtual void AppendFile_preMsgHook(
          FwOpcodeType opCode, 
          U32 cmdSeq 
      );

      virtual void FileSize_preMsgHook(
          FwOpcodeType opCode, 
          U32 cmdSeq 
      );

      virtual void ListDirectory_preMsgHook(
          FwOpcodeType opCode, 
          U32 cmdSeq 
      );

      virtual void CalculateCrc_preMsgHook(
          FwOpcodeType opCode, 
          U32 cmdSeq 
      );

      virtual void GenerateDp_preMsgHook(
          FwOpcodeType opCode, 
          U32 cmdSeq 
      );

    protected:

      // ----------------------------------------------------------------------
      // Event logging functions
      // ----------------------------------------------------------------------

      void log_WARNING_HI_DirectoryCreateError(
          const Fw::StringBase& dirName, 
          U32 status 
      ) const;

      void log_WARNING_HI_DirectoryRemoveError(
          const Fw::StringBase& dirName, 
          U32 status 
      ) const;

      void log_WARNING_HI_FileMoveError(
          const Fw::StringBase& sourceFileName, 
          const Fw::StringBase& destFileName, 
          U32 status 
      ) const;

      void log_WARNING_HI_FileRemoveError(
          const Fw::StringBase& fileName, 
          U32 status 
      ) const;

      void log_WARNING_HI_AppendFileFailed(
          const Fw::StringBase& source, 
          const Fw::StringBase& target, 
          U32 status 
      ) const;

      void log_ACTIVITY_HI_AppendFileSucceeded(
          const Fw::StringBase& source, 
          const Fw::StringBase& target 
      ) const;

      void log_ACTIVITY_HI_CreateDirectorySucceeded(
          const Fw::StringBase& dirName 
      ) const;

      void log_ACTIVITY_HI_RemoveDirectorySucceeded(
          const Fw::StringBase& dirName 
      ) const;

      void log_ACTIVITY_HI_MoveFileSucceeded(
          const Fw::StringBase& sourceFileName, 
          const Fw::StringBase& destFileName 
      ) const;

      void log_ACTIVITY_HI_RemoveFileSucceeded(
          const Fw::StringBase& fileName 
      ) const;

      void log_ACTIVITY_HI_AppendFileStarted(
          const Fw::StringBase& source, 
          const Fw::StringBase& target 
      ) const;

      void log_ACTIVITY_HI_CreateDirectoryStarted(
          const Fw::StringBase& dirName 
      ) const;

      void log_ACTIVITY_HI_RemoveDirectoryStarted(
          const Fw::StringBase& dirName 
      ) const;

      void log_ACTIVITY_HI_MoveFileStarted(
          const Fw::StringBase& sourceFileName, 
          const Fw::StringBase& destFileName 
      ) const;

      void log_ACTIVITY_HI_RemoveFileStarted(
          const Fw::StringBase& fileName 
      ) const;

      void log_ACTIVITY_HI_FileSizeSucceeded(
          const Fw::StringBase& fileName, 
          FwSizeType size 
      ) const;

      void log_WARNING_HI_FileSizeError(
          const Fw::StringBase& fileName, 
          U32 status 
      ) const;

      void log_ACTIVITY_HI_FileSizeStarted(
          const Fw::StringBase& fileName 
      ) const;

      void log_ACTIVITY_HI_ListDirectoryStarted(
          const Fw::StringBase& dirName 
      ) const;

      void log_ACTIVITY_HI_ListDirectorySucceeded(
          const Fw::StringBase& dirName, 
          U32 fileCount 
      ) const;

      void log_WARNING_HI_ListDirectoryError(
          const Fw::StringBase& dirName, 
          U32 status 
      ) const;

      void log_ACTIVITY_HI_DirectoryListing(
          const Fw::StringBase& dirName, 
          const Fw::StringBase& fileName, 
          FwSizeType fileSize 
      ) const;

      void log_ACTIVITY_HI_DirectoryListingSubdir(
          const Fw::StringBase& dirName, 
          const Fw::StringBase& subdirName 
      ) const;

      void log_ACTIVITY_HI_CalculateCrcStarted(
          const Fw::StringBase& fileName 
      ) const;

      void log_WARNING_HI_CalculateCrcFailed(
          const Fw::StringBase& fileName, 
          U32 status 
      ) const;

      void log_ACTIVITY_HI_CalculateCrcSucceeded(
          const Fw::StringBase& fileName, 
          U32 crc 
      ) const;

      void log_WARNING_HI_FileNameFormatError(
          const Fw::StringBase& fileName, 
          const Fw::StringFormatStatus& status 
      ) const;

      void log_ACTIVITY_HI_GenerateDpStarted(
          const Fw::StringBase& fileName, 
          U64 bytesToWrite 
      ) const;

      void log_ACTIVITY_HI_GenerateDpComplete(
          const Fw::StringBase& fileName, 
          U32 chunks 
      ) const;

      void log_WARNING_HI_GenerateDpFailed(
          const Fw::StringBase& fileName, 
          const Svc::FileManager_GenerateDpStage& stage, 
          U32 status 
      ) const;

      void log_WARNING_HI_GenerateDpBufferFailed(
          const Fw::StringBase& fileName 
      ) const;

      void log_WARNING_HI_GenerateDpInvalidRange(
          const Fw::StringBase& fileName, 
          U64 beginOffset, 
          U64 endOffset, 
          U64 fileSize 
      ) const;

      void log_WARNING_HI_PathOutsideSandbox(
          const Fw::StringBase& path, 
          const Fw::StringBase& sandboxDir 
      ) const;

    protected:

      // ----------------------------------------------------------------------
      // Telemetry serialized write
      // ----------------------------------------------------------------------

      void tlmWrite(
          FwChanIdType id, 
          Fw::TlmBuffer& _tlmBuff, 
          Fw::Time _tlmTime = Fw::Time() 
      ) const;

    protected:

      // ----------------------------------------------------------------------
      // Telemetry write functions
      // ----------------------------------------------------------------------

      void tlmWrite_CommandsExecuted(
          U32 arg, 
          Fw::Time _tlmTime = Fw::Time() 
      ) const;

      void tlmWrite_Errors(
          U32 arg, 
          Fw::Time _tlmTime = Fw::Time() 
      ) const;

    protected:

      // ----------------------------------------------------------------------
      // Functions for managing data products
      // ----------------------------------------------------------------------

      Fw::Success::T dpGet_FileDpContainer(
          FwSizeType dataSize, 
          DpContainer& container 
      ) {
        return this->dpGet(
          ContainerId::FileDpContainer,
          dataSize,
          ContainerPriority::FileDpContainer,
          container
        );
      }

      void dpSend(
          DpContainer& container, 
          Fw::Time timeTag = Fw::ZERO_TIME 
      );

    protected:

      // ----------------------------------------------------------------------
      // Time
      // ----------------------------------------------------------------------

      Fw::Time getTime() const;

    private:

      // ----------------------------------------------------------------------
      // Message dispatch functions
      // ----------------------------------------------------------------------

      virtual MsgDispatchStatus doDispatch();

    private:

      // ----------------------------------------------------------------------
      // Calls for messages received on special input ports
      // ----------------------------------------------------------------------

      static void m_p_cmdIn_in(
          Fw::PassiveComponentBase* callComp, 
          FwIndexType portNum, 
          FwOpcodeType opCode, 
          U32 cmdSeq, 
          Fw::CmdArgBuffer& args 
      );

    private:

      // ----------------------------------------------------------------------
      // Calls for messages received on typed input ports
      // ----------------------------------------------------------------------

      static void m_p_pingIn_in(
          Fw::PassiveComponentBase* callComp, 
          FwIndexType portNum, 
          U32 key 
      );

      static void m_p_schedIn_in(
          Fw::PassiveComponentBase* callComp, 
          FwIndexType portNum, 
          U32 context 
      );

    private:

      // ----------------------------------------------------------------------
      // Invocation functions for special output ports
      // ----------------------------------------------------------------------

#if FW_ENABLE_TEXT_LOGGING

      void LogText_out(
          FwIndexType portNum, 
          FwEventIdType id, 
          Fw::Time& timeTag, 
          const Fw::LogSeverity& severity, 
          Fw::TextLogString& text 
      ) const;

#endif

      void cmdRegOut_out(
          FwIndexType portNum, 
          FwOpcodeType opCode 
      ) const;

      void cmdResponseOut_out(
          FwIndexType portNum, 
          FwOpcodeType opCode, 
          U32 cmdSeq, 
          const Fw::CmdResponse& response 
      ) const;

      void eventOut_out(
          FwIndexType portNum, 
          FwEventIdType id, 
          Fw::Time& timeTag, 
          const Fw::LogSeverity& severity, 
          Fw::LogBuffer& args 
      ) const;

      Fw::Success productGetOut_out(
          FwIndexType portNum, 
          FwDpIdType id, 
          FwSizeType dataSize, 
          Fw::Buffer& buffer 
      ) const;

      void productSendOut_out(
          FwIndexType portNum, 
          FwDpIdType id, 
          const Fw::Buffer& buffer 
      ) const;

      void timeCaller_out(
          FwIndexType portNum, 
          Fw::Time& time 
      ) const;

      void tlmOut_out(
          FwIndexType portNum, 
          FwChanIdType id, 
          Fw::Time& timeTag, 
          Fw::TlmBuffer& val 
      ) const;

    private:

      // ----------------------------------------------------------------------
      // Private data product handling functions
      // ----------------------------------------------------------------------

      Fw::Success::T dpGet(
          ContainerId::T containerId, 
          FwSizeType dataSize, 
          FwDpPriorityType priority, 
          DpContainer& container 
      );

#if !FW_DIRECT_PORT_CALLS

    private:

      // ----------------------------------------------------------------------
      // Special input ports
      // ----------------------------------------------------------------------

      Fw::InputCmdPort m_cmdIn_InputPort[NUM_CMDIN_INPUT_PORTS];

#endif

#if !FW_DIRECT_PORT_CALLS

    private:

      // ----------------------------------------------------------------------
      // Typed input ports
      // ----------------------------------------------------------------------

      Svc::InputPingPort m_pingIn_InputPort[NUM_PINGIN_INPUT_PORTS];

      Svc::InputSchedPort m_schedIn_InputPort[NUM_SCHEDIN_INPUT_PORTS];

#endif

#if !FW_DIRECT_PORT_CALLS

    private:

      // ----------------------------------------------------------------------
      // Special output ports
      // ----------------------------------------------------------------------

#if FW_ENABLE_TEXT_LOGGING == 1

      Fw::OutputLogTextPort m_LogText_OutputPort[NUM_LOGTEXT_OUTPUT_PORTS];

#endif

      Fw::OutputCmdRegPort m_cmdRegOut_OutputPort[NUM_CMDREGOUT_OUTPUT_PORTS];

      Fw::OutputCmdResponsePort m_cmdResponseOut_OutputPort[NUM_CMDRESPONSEOUT_OUTPUT_PORTS];

      Fw::OutputLogPort m_eventOut_OutputPort[NUM_EVENTOUT_OUTPUT_PORTS];

      Fw::OutputDpGetPort m_productGetOut_OutputPort[NUM_PRODUCTGETOUT_OUTPUT_PORTS];

      Fw::OutputDpSendPort m_productSendOut_OutputPort[NUM_PRODUCTSENDOUT_OUTPUT_PORTS];

      Fw::OutputTimePort m_timeCaller_OutputPort[NUM_TIMECALLER_OUTPUT_PORTS];

      Fw::OutputTlmPort m_tlmOut_OutputPort[NUM_TLMOUT_OUTPUT_PORTS];

#endif

#if !FW_DIRECT_PORT_CALLS

    private:

      // ----------------------------------------------------------------------
      // Typed output ports
      // ----------------------------------------------------------------------

      Svc::OutputPingPort m_pingOut_OutputPort[NUM_PINGOUT_OUTPUT_PORTS];

#endif

  };

}

#endif