ArBasePacket.h

/*
ActivMedia Robotics Interface for Applications (ARIA)
Copyright (C) 2004,2005 ActivMedia Robotics, LLC


     This program is free software; you can redistribute it and/or modify
     it under the terms of the GNU General Public License as published by
     the Free Software Foundation; either version 2 of the License, or
     (at your option) any later version.

     This program is distributed in the hope that it will be useful,
     but WITHOUT ANY WARRANTY; without even the implied warranty of
     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     GNU General Public License for more details.

     You should have received a copy of the GNU General Public License
     along with this program; if not, write to the Free Software
     Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

If you wish to redistribute ARIA under different terms, contact 
ActivMedia Robotics for information about a commercial version of ARIA at 
robots@activmedia.com or 
ActivMedia Robotics, 19 Columbia Drive, Amherst, NH 03031; 800-639-9481

*/

#ifndef ARBASEPACKET_H
#define ARBASEPACKET_H


#include <string>
#include "ariaTypedefs.h"


class ArBasePacket
{
public:
    
  ArBasePacket(ArTypes::UByte2 bufferSize = 0,
                        ArTypes::UByte2 headerLength = 0, 
                        char * buf = NULL,
                        ArTypes::UByte2 footerLength = 0);
  
  virtual ~ArBasePacket();

  virtual void empty(void);

  virtual void finalizePacket(void) {}

  virtual void log(void);
  virtual void printHex(void);

  // Utility functions to write different data types to a buffer. They will
  // increment the length.

  virtual void byteToBuf(ArTypes::Byte val);
  virtual void byte2ToBuf(ArTypes::Byte2 val);
  virtual void byte4ToBuf(ArTypes::Byte4 val);

  virtual void uByteToBuf(ArTypes::UByte val);
  virtual void uByte2ToBuf(ArTypes::UByte2 val);
  virtual void uByte4ToBuf(ArTypes::UByte4 val);

  virtual void strToBuf(const char *str);
  virtual void strNToBuf(const char *str, int length);
  virtual void strToBufPadded(const char *str, int length);
  virtual void dataToBuf(const char *data, int length);
  
  // Utility functions to read differet data types from a bufer. Each read
  // will increment the myReadLength.
  virtual ArTypes::Byte bufToByte(void);
  virtual ArTypes::Byte2 bufToByte2(void);
  virtual ArTypes::Byte4 bufToByte4(void);

  virtual ArTypes::UByte bufToUByte(void);
  virtual ArTypes::UByte2 bufToUByte2(void);
  virtual ArTypes::UByte4 bufToUByte4(void);

  virtual void bufToStr(char *buf, int len);
  virtual void bufToData(char * data, int length);

  virtual void resetRead(void);

  // Accessors

  virtual ArTypes::UByte2 getLength(void) { return myLength; }
  virtual ArTypes::UByte2 getDataLength(void) { return myLength - myHeaderLength - myFooterLength; }
  
  virtual ArTypes::UByte2 getReadLength(void) { return myReadLength; }
  virtual ArTypes::UByte2 getDataReadLength(void) { return myReadLength - myHeaderLength; }
  virtual ArTypes::UByte2 getHeaderLength(void)
    { return myHeaderLength; }
  virtual ArTypes::UByte2 getFooterLength(void)
    { return myFooterLength; }

  virtual ArTypes::UByte2 getMaxLength(void) { return myMaxLength; }
  
  virtual const char * getBuf(void);

  virtual void setBuf(char *buf, ArTypes::UByte2 bufferSize);
  virtual void ArBasePacket::setMaxLength(ArTypes::UByte2 bufferSize);
  virtual bool setLength(ArTypes::UByte2 length);
  virtual void setReadLength(ArTypes::UByte2 readLength);
  virtual bool setHeaderLength(ArTypes::UByte2 length);
  virtual void duplicatePacket(ArBasePacket *packet);
protected:
  // internal function to make sure we have enough length left in the packet
  bool isNextGood(int bytes);

  // internal data
  ArTypes::UByte2 myHeaderLength;
  ArTypes::UByte2 myFooterLength;
  ArTypes::UByte2 myMaxLength;

  ArTypes::UByte2 myReadLength;
  bool myOwnMyBuf;

  // Actual packet data
  char *myBuf;
  ArTypes::UByte2 myLength;
};


#endif // ARPACKET_H

---