rtcppacket.h

Go to the documentation of this file.

// ##########################################################################
// ####                                                                  ####
// ####                      RTP Audio Server Project                    ####
// ####                    ============================                  ####
// ####                                                                  ####
// #### RTCP Packet                                                      ####
// ####                                                                  ####
// #### Version 1.00  --  February 16, 2001                              ####
// ####                                                                  ####
// #### Copyright (C) 1999  Thomas Dreibholz                             ####
// ####               2000  Universität Bonn, Abt. IV                    ####
// ####               2001  EMail: dreibh@iem.uni-due.de                 ####
// ####                     WWW:   https://www.uni-due.de/~be0001        ####
// ####                                                                  ####
// ##########################################################################


#ifndef RTCPPACKET_H
#define RTCPPACKET_H


#include <endian.h>


#include "system.h"
#include "rtppacket.h"


namespace Coral {


enum RTCP_Type
{
  RTCP_SR   = 200,
  RTCP_RR   = 201,
  RTCP_SDES = 202,
  RTCP_BYE  = 203,
  RTCP_APP  = 204
};


enum RTCP_SDES_Type
{
  RTCP_SDES_END   = 0,
  RTCP_SDES_CNAME = 1,
  RTCP_SDES_NAME  = 2,
  RTCP_SDES_EMAIL = 3,
  RTCP_SDES_PHONE = 4,
  RTCP_SDES_LOC   = 5,
  RTCP_SDES_TOOL  = 6,
  RTCP_SDES_NOTE  = 7,
  RTCP_SDES_PRIV  = 8
};


class RTCPCommonHeader
{   
   // ====== Constructor ====================================================
   public:
   RTCPCommonHeader();


   // ====== Get methods ====================================================
   inline card8 getVersion() const;

   inline card8 getPadding() const;

   inline card8 getCount() const;

   inline card8 getPacketType() const;

   inline card16 getLength() const;


   // ====== Set methods ====================================================
   inline void setVersion(const card8 version);

   inline void setPadding(const card8 padding);

   inline void setCount(const card8 count);

   inline void setPacketType(const card8 packetType);

   inline void setLength(const card16 length);


   // ====== Protected data =================================================
   protected:
#if CPU_BYTEORDER == BIG_ENDIAN
   card8 V:2;                             // Protocol Version
   card8 P:1;                             // Padding Flag
   card8 C:5;                             // Count varies by Packet Type (RC/SC)
#elif CPU_BYTEORDER == LITTLE_ENDIAN
   card8 C:5;                             // Count varies by Packet Type (RC/SC)
   card8 P:1;                             // Padding Flag
   card8 V:2;                             // Protocol Version
#else
#error "Unknown CPU_BYTEORDER setting!"
#endif
   card8 PT:8;                            // RTCP Packet Type   
   card16 Length;                         // Packet length in words minus one
};


class RTCPSenderInfoBlock
{
   // ====== Constructor ====================================================
   public:
   RTCPSenderInfoBlock();


   // ====== Get methods ====================================================
   inline card64 getNTPTimeStamp() const;

   inline card32 getRTPTimeStamp() const;


   inline card32 getPacketsSent() const;

   inline card32 getOctetsSent() const;


   // ====== Set methods ====================================================
   inline void setNTPTimeStamp(const card64 timeStamp);

   inline void setRTPTimeStamp(const card32 timeStamp);

   inline void setPacketsSent(const card32 packets);

   inline void setOctetsSent(const card32 octets);


   // ====== Protected data =================================================
   protected:
   card32 NTP_MostSignificant;     // NTP Timestamp (most  significant word)
   card32 NTP_LeastSignificant;    // NTP Timestamp (least significant word)
   card32 RTPTimeStamp;            // RTP Timestamp
   card32 PacketsSent;             // Packets sent
   card32 OctetsSent;              // Octets sent
};


class RTCPReceptionReportBlock
{
   // ====== Constructor ====================================================
   public:
   RTCPReceptionReportBlock();

   RTCPReceptionReportBlock(const card32 ssrc);


   void init(const card32 ssrc);


   // ====== Get methods ====================================================
   inline card32 getSSRC() const;

   inline double getFractionLost() const;

   inline card32 getPacketsLost() const;

   inline card32 getLastSeqNum() const;

   inline card32 getJitter() const;

   inline card32 getLSR() const;

   inline card32 getDLSR() const;


   // ====== Set methods ====================================================
   inline void setSSRC(card32 ssrc);

   inline void setFractionLost(const double fraction);

   inline void setPacketsLost(const card32 packetsLost);

   inline void setLastSeqNum(const card32 lastSeq);

   inline void setJitter(const card32 jitter);

   inline void setLSR(const card32 lsr);

   inline void setDLSR(const card32 dlsr);


   // ====== Protected data =================================================
   protected:
   card32 SSRC;                           // Data Source being reported
   card32 Fraction:8;                     // Fraction lost since last SR/RR
   card32 Lost:24;                        // Cumulative no. of Packets lost (signed!)
   card32 LastSeq;                        // Extended last sequence no. received
   card32 Jitter;                         // Interarrival Jitter
   card32 LSR;                            // Last SR Packet from this source
   card32 DLSR;                           // Delay since last SR Packet
};


class RTCPReport : public RTCPCommonHeader
{
   // ====== Constructor ====================================================
   public:
   RTCPReport();


   // ====== Get methods ====================================================
   inline card32 getSSRC() const;


   // ====== Set methods ====================================================
   inline void setSSRC(const card32 ssrc);


   // ====== Protected data =================================================
   protected:
   card32 SSRC;                  // Sender or Receiver generating this report
};


class RTCPSenderReport : public RTCPReport, public RTCPSenderInfoBlock
{
   // ====== Constructor ====================================================
   public:
   RTCPSenderReport();

   RTCPSenderReport(const card32 syncSource, const card8 count = 0);


   void init(const card32 syncSource, const card8 count = 0);


   RTCPReceptionReportBlock rr[0];      // Variable length RR list
};


class RTCPReceiverReport : public RTCPReport
{
   // ====== Constructor ====================================================
   public:
   RTCPReceiverReport();

   RTCPReceiverReport(const card32 syncSource, const card8 count = 0);


   void init(const card32 syncSource, const card8 count = 0);
   

   RTCPReceptionReportBlock rr[0];      // Variable length RR list
};


class RTCPSourceDescriptionItem
{
   public:
   card8 Type;

   card8 Length;

   char Data[0];
};


class RTCPSourceDescriptionChunk
{
   public:
   card32 SRC;

   RTCPSourceDescriptionItem Item[1];
};


class RTCPSourceDescription : public RTCPCommonHeader
{
   // ====== Constructor ====================================================
   public:
   RTCPSourceDescription();

   RTCPSourceDescription(const card8 count);


   void init(const card8 count);


   RTCPSourceDescriptionChunk Chunk[1];
};


class RTCPBye : public RTCPCommonHeader
{
   // ====== Constructor ====================================================
   public:
   RTCPBye();

   RTCPBye(const card8 count);


   void init(const card8 count);


   // ====== Get methods ====================================================
   inline card32 getSource(const cardinal index) const;


   // ====== Set methods ====================================================
   inline void setSource(const cardinal index, const card32 source);


   // ====== Private data ===================================================
   private:   
   card32 Source[0];
};


class RTCPApp : public RTCPCommonHeader
{
   // ====== Constructor ====================================================
   public:
   RTCPApp();

   RTCPApp(const card8 subtype);


   /*
     * Initialize.
     * @param subtype RTCP APP subtype.
     */
   void init(const card8 subtype);


   // ====== Get methods ====================================================
   inline card32 getSource() const;

   inline char* getName();

   inline char* getData();


   // ====== Set methods ====================================================
   inline void setSource(const card32 source);


   // ====== Private data ===================================================
   private:
   card32 Source;
   char   Name[4];
   char   Data[0];
};


}


#include "rtcppacket.icc"


#endif