BufferLogger.hpp

Go to the documentation of this file.

// ======================================================================
// \title  BufferLogger.hpp
// \author bocchino, dinkel, mereweth
// \brief  Svc Buffer Logger interface
//
// \copyright
// Copyright (C) 2015-2017 California Institute of Technology.
// ALL RIGHTS RESERVED.  United States Government Sponsorship
// acknowledged.
//
// ======================================================================
 
#ifndef Svc_BufferLogger_HPP
#define Svc_BufferLogger_HPP
 
#include "Svc/BufferLogger/BufferLoggerComponentAc.hpp"
#include "Os/File.hpp"
#include "Fw/Types/String.hpp"
#include "Fw/Types/Assert.hpp"
#include "Os/Mutex.hpp"
#include "Utils/Hash/Hash.hpp"
 
namespace Svc {
 
  class BufferLogger :
    public BufferLoggerComponentBase
  {
 
    PRIVATE:
 
      // ----------------------------------------------------------------------
      // Types
      // ----------------------------------------------------------------------
 
      class File {
 
        public:
 
          struct Mode {
            typedef enum {
              CLOSED = 0,
              OPEN = 1
            } t;
          };
 
        public:
 
          File(
              BufferLogger& bufferLogger 
          );
 
          ~File();
 
        public:
 
          void init(
              const char *const prefix, 
              const char *const suffix, 
              const U32 maxSize, 
              const U8 sizeOfSize 
          );
 
          void setBaseName(
              const Fw::StringBase& baseName 
          );
 
          void logBuffer(
              const U8 *const data, 
              const U32 size 
          );
 
          void closeAndEmitEvent();
 
          bool flush();
 
        PRIVATE:
 
          void open();
 
          bool writeBuffer(
              const U8 *const data, 
              const U32 size 
          );
 
          bool writeSize(
              const U32 size 
          );
 
          bool writeBytes(
              const void *const data, 
              const U32 length 
          );
 
          void writeHashFile();
 
          void close();
 
        PRIVATE:
 
          BufferLogger& bufferLogger;
 
          Fw::String prefix;
 
          Fw::String suffix;
 
          Fw::String baseName;
 
          NATIVE_UINT_TYPE fileCounter;
 
          U32 maxSize;
 
          U8 sizeOfSize;
 
          Fw::String name;
 
          // The current mode
          Mode::t mode;
 
          Os::File osFile;
 
          U32 bytesWritten;
 
      }; // class File
 
    public:
 
      // ----------------------------------------------------------------------
      // Construction, initialization, and destruction
      // ----------------------------------------------------------------------
 
      BufferLogger(
          const char *const compName 
      );
 
      void init(
          const NATIVE_INT_TYPE queueDepth, 
          const NATIVE_INT_TYPE instance 
      );
 
      // ----------------------------------------------------------------------
      // Public methods
      // ----------------------------------------------------------------------
 
      void initLog(
          const char *const logFilePrefix, 
          const char *const logFileSuffix, 
          const U32 maxFileSize, 
          const U8 sizeOfSize 
      );
 
    PRIVATE:
 
      // ----------------------------------------------------------------------
      // Handler implementations for user-defined typed input ports
      // ----------------------------------------------------------------------
 
      void bufferSendIn_handler(
          const NATIVE_INT_TYPE portNum, 
          Fw::Buffer& fwBuffer
      );
 
      void comIn_handler(
          const NATIVE_INT_TYPE portNum, 
          Fw::ComBuffer &data, 
          U32 context 
      );
 
      void pingIn_handler(
          const NATIVE_INT_TYPE portNum, 
          U32 key 
      );
 
      void schedIn_handler(
          const NATIVE_INT_TYPE portNum, 
          NATIVE_UINT_TYPE context 
      );
 
    PRIVATE:
 
      // ----------------------------------------------------------------------
      // Command handler implementations
      // ----------------------------------------------------------------------
 
      void BL_OpenFile_cmdHandler(
          const FwOpcodeType opCode, 
          const U32 cmdSeq, 
          const Fw::CmdStringArg& file
      );
 
      void BL_CloseFile_cmdHandler(
          const FwOpcodeType opCode, 
          const U32 cmdSeq 
      );
 
      void BL_SetLogging_cmdHandler(
          const FwOpcodeType opCode, 
          const U32 cmdSeq, 
          BufferLogger_LogState state
      );
 
      void BL_FlushFile_cmdHandler(
          const FwOpcodeType opCode, 
          const U32 cmdSeq 
      );
 
  PRIVATE:
 
      // ----------------------------------------------------------------------
      // Private instance variables
      // ----------------------------------------------------------------------
 
      BufferLogger_LogState m_state;
 
      File m_file;
 
  };
 
}
 
#endif