metrics.h

Go to the documentation of this file.

/*
 * metrics.h
 *
 * E-Model implementation
 *
 * Open Phone Abstraction Library (OPAL)
 *
 * Copyright (c) 2010 Universidade Federal do Amazonas
 *
 * The contents of this file are subject to the Mozilla Public License
 * Version 1.0 (the "License"); you may not use this file except in
 * compliance with the License. You may obtain a copy of the License at
 * http://www.mozilla.org/MPL/
 *
 * Software distributed under the License is distributed on an "AS IS"
 * basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
 * the License for the specific language governing rights and limitations
 * under the License.
 *
 * Contributor(s): ______________________________________.
 *
 * $Revision: 25550 $
 * $Author: rjongbloed $
 * $Date: 2011-04-12 01:56:22 -0500 (Tue, 12 Apr 2011) $
 */

#ifndef OPAL_RTP_METRICS_H
#define OPAL_RTP_METRICS_H

#ifdef P_USE_PRAGMA
#pragma interface
#endif

#include <rtp/rtp.h>

#if OPAL_RTCP_XR

#include <list>

class RTP_Session;
class RTP_DataFrame;

// RTCP-XR - VoIP Metrics Report Block

class RTCP_XR_Metrics
{  
  public:
     RTCP_XR_Metrics();
    ~RTCP_XR_Metrics();
    
    enum PacketEvent {
      PACKET_RECEIVED,
      PACKET_DISCARDED,
      PACKET_LOST
    };  
        
    enum PeriodType {
      GAP,     /* a period of low packet losses and/or discards */
      BURST,   /* a period of a high proportion of packet losses and/or discards */     
    };
    
    /* A period of time, which can be a burst or a gap */
    typedef struct TimePeriod {
      PeriodType      type;
      PTimeInterval   duration; 
    } TimePeriod;
    
    typedef struct IdPeriod {
      PTimeInterval duration;
      float         Id;
    } IdPeriod;
    
    typedef struct IePeriod {
      PeriodType    type;
      PTimeInterval duration;
      float         Ieff;
    } IePeriod;
    
    enum QualityType {
      LQ,  /* Listening Quality, not include the effects of delay */
      CQ   /* Conversational Quality, include the effects of delay */
    };
       
    std::list<TimePeriod> timePeriods;
    std::list<IePeriod> iePeriods;
    std::list<IdPeriod> idPeriods;
    
    void SetPayloadInfo(
      RTP_DataFrame frame   
    );
    
    void SetJitterDelay(
      DWORD delay   
    );
    
    void OnPacketReceived();
    
    void OnPacketDiscarded();
    
    void OnPacketLost();
     
    void OnPacketLost(
      DWORD dropped   
    );
    
    void OnRxSenderReport(
      PUInt32b lsr,   
      PUInt32b dlsr   
    );
    
    BYTE GetLossRate();
    
    BYTE GetDiscardRate();
    
    BYTE GetBurstDensity();
    
    BYTE GetGapDensity();
    
    PUInt16b GetBurstDuration();
    
    PUInt16b GetGapDuration();
    
    PUInt16b GetRoundTripDelay ();
    
    PUInt16b GetEndSystemDelay();
    
    BYTE RFactor();
    
    BYTE MOS_LQ();
    
    BYTE MOS_CQ();
    
  private:
    void markov(
      PacketEvent event   
    );
    
    void ResetCounters();
    
    BYTE RFactor(
      QualityType qt   
    );
    
    BYTE EndOfCallRFactor();
    
    float MOS(
      QualityType qt   
    );
    
    float EndOfCallMOS();
    
    float IdFactor();
    
    float GetPonderateId();
    
    float Ieff(
      PeriodType type   
    );
    
    float GetEndOfCallIe();
    
    float GetPonderateIe();
    
    TimePeriod createTimePeriod(
      PeriodType type,        
      PTime beginTimestamp,   
      PTime endTimestamp      
    );
    
    IdPeriod createIdPeriod(
      PTime beginTimestamp,   
      PTime endTimestamp      
    );
    
    IePeriod createIePeriod(
      TimePeriod timePeriod   
    );
    
    DWORD gmin;                    /* gap threshold */
    DWORD lost;                    /* number of lost packets within the current burst */
    DWORD packetsReceived;         /* packets received since the beggining of the reception */
    DWORD packetsSinceLastLoss;    /* packets received since the last loss or discard event */
    DWORD packetsLost;             /* packets lost since the beggining of the reception */
    DWORD packetsDiscarded;        /* packets discarded since the beggining of the receptions */
    DWORD srPacketsReceived;       /* count of SR packets received */
    
    DWORD packetsReceivedInGap;    /* packets received within gap periods */
    DWORD packetsLostInGap;        /* packets lost within gap periods */
        
    DWORD packetsReceivedInBurst;  /* packets received within burst periods */
    DWORD packetsLostInBurst;      /* packets lost within burst periods */
     
    DWORD c5;
    DWORD c11;
    DWORD c13;
    DWORD c14;
    DWORD c22;
    DWORD c23;
    DWORD c31;
    DWORD c32;
    DWORD c33;
    
    /* variables to calculate round trip delay */
    PTime         lsrTime;
    PTimeInterval dlsrTime;
    PTime         arrivalTime;
    
    /* data associated with the payload */
    float    Ie;              /* equipment impairment factor for the codec utilized */ 
    float    Bpl;             /* robustness factor for the codec utilized */
    unsigned payloadBitrate;
    PINDEX   payloadSize;
    float    lookAheadTime;   /* codec lookahead time */
    
    bool isPayloadTypeOK;
    
    DWORD jitterDelay;  /* jitter buffer delay, in milliseconds */
    float lastId;       /* last Id calculated */
    float lastIe;       /* last Ie calculated */
    
    PeriodType currentPeriodType;           /* indicates if we are within a gap or burst */
    PTime periodBeginTimestamp;             /* timestamp of the beginning of the gap or burst period */
    PTime lastLossTimestamp;                /* timestamp of the last loss */
    PTime lastLossInBurstTimestamp;         /* timestamp of the last loss within a burst period */
    PTime lastJitterBufferChangeTimestamp;  /* timestamp of the last change in jitter buffer size */
    
};


#endif // OPAL_RTCP_XR

#endif // OPAL_METRICS_H