RlinkPacketBuf.hpp

Go to the documentation of this file.

// $Id: RlinkPacketBuf.hpp 1198 2019-07-27 19:08:31Z mueller $
// SPDX-License-Identifier: GPL-3.0-or-later
// Copyright 2011-2019 by Walter F.J. Mueller <W.F.J.Mueller@gsi.de>
// 
// Revision History: 
// Date         Rev Version  Comment
// 2019-07-27  1198   2.0.4  add kNc* definitions
// 2019-06-07  1160   2.0.3  Stats() not longer const
// 2018-12-16  1084   2.0.2  use =delete for noncopyable instead of boost
// 2017-04-07   868   2.0.1  Dump(): add detail arg
// 2014-11-23   606   2.0    re-organize for rlink v4
// 2013-04-21   509   1.0.2  add SndAttn() method
// 2013-01-13   474   1.0.1  add PollAttn() method
// 2011-04-02   375   1.0    Initial version
// 2011-03-05   366   0.1    First draft
// ---------------------------------------------------------------------------
 
 
#ifndef included_Retro_RlinkPacketBuf
#define included_Retro_RlinkPacketBuf 1
 
#include <cstdint>
#include <ostream>
#include <vector>
 
#include "librtools/Rstats.hpp"
 
#include "RlinkCrc16.hpp"
 
namespace Retro {
 
  class RlinkPacketBuf {
    public:
 
                    RlinkPacketBuf();
                   ~RlinkPacketBuf();
    
                    RlinkPacketBuf(const RlinkPacketBuf&) = delete; // noncopy
      RlinkPacketBuf& operator=(const RlinkPacketBuf&) = delete;  // noncopyable
    
      size_t        PktSize() const;
 
      uint32_t      Flags() const;
      bool          TestFlag(uint32_t mask) const;
 
      Rstats&       Stats();
      void          Dump(std::ostream& os, int ind=0, const char* text=0,
                         int detail=0) const;
 
    // flag bits (also defined in cpp)
      static const uint32_t kFlagSopSeen    = 1<<0;  
      static const uint32_t kFlagEopSeen    = 1<<1;  
      static const uint32_t kFlagNakSeen    = 1<<2;  
      static const uint32_t kFlagAttnSeen   = 1<<3;  
      static const uint32_t kFlagErrTout    = 1<<16; 
      static const uint32_t kFlagErrIO      = 1<<17; 
      static const uint32_t kFlagErrFrame   = 1<<18; 
      static const uint32_t kFlagErrClobber = 1<<19; 
 
    // some constants (also defined in cpp)
      static const uint8_t kSymEsc    = 0xCA;   
      static const uint8_t kSymFill   = 0xD5;   
      static const uint8_t kSymXon    = 0x11;   
      static const uint8_t kSymXoff   = 0x13;   
      static const uint8_t kSymEdPref = 0x40;   
      static const uint8_t kEcSop     = 0x00;   
      static const uint8_t kEcEop     = 0x01;   
      static const uint8_t kEcNak     = 0x02;   
      static const uint8_t kEcAttn    = 0x03;   
      static const uint8_t kEcXon     = 0x04;   
      static const uint8_t kEcXoff    = 0x05;   
      static const uint8_t kEcFill    = 0x06;   
      static const uint8_t kEcEsc     = 0x07;   
      static const uint8_t kEcClobber = 0xff;   
      static const uint8_t kNcCcrc    = 0x00;   
      static const uint8_t kNcDcrc    = 0x01;   
      static const uint8_t kNcFrame   = 0x02;   
      static const uint8_t kNcUnused  = 0x03;   
      static const uint8_t kNcCmd     = 0x04;   
      static const uint8_t kNcCnt     = 0x05;   
      static const uint8_t kNcRtOvlf  = 0x06;   
      static const uint8_t kNcRtWblk  = 0x07;   
      static const uint8_t kNcInval   = 0x08;   
 
    protected:
      void          SetFlagBit(uint32_t mask);
      void          ClearFlagBit(uint32_t mask);
 
    protected: 
      std::vector<uint8_t> fPktBuf;         
      RlinkCrc16    fCrc;                   
      uint32_t      fFlags;                 
      Rstats        fStats;                 
  };
  
} // end namespace Retro
 
#include "RlinkPacketBuf.ipp"
 
#endif