src/jlibrtp/RtcpPktRR.java
author nikita@nikita-rack
Thu, 09 Apr 2009 20:26:58 +0200
changeset 99 8de21ac527ce
parent 13 e684f11070d5
permissions -rw-r--r--
revert pour refaire un push propre

/**
 * Java RTP Library (jlibrtp)
 * Copyright (C) 2006 Arne Kepp
 * 
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * This library 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
 * Lesser General Public License for more details.
 * 
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 */
package jlibrtp;

/**
 * RTCP packets for Receiver Reports 
 * 
 * @author Arne Kepp
 */
public class RtcpPktRR extends RtcpPkt {
	/** Array of participants to send Receiver Reports to */
	protected Participant[] reportees = null;
	/** SSRC of participants the reports are for */
	protected long[] reporteeSsrc = null;// -1; //32 bits
	/** Fraction (over 256) of packets lost */
	protected int[] lossFraction = null;//-1; //8 bits
	/** Number of lost packets */
	protected int[] lostPktCount = null;//-1; //24 bits
	/** Extended highest sequence received */
	protected long[] extHighSeqRecv = null;//-1; //32 bits
	/** Interarrival jitter*/
	protected long[] interArvJitter = null;//-1; //32 bits
	/** Middle 32 bits of NTP when last SR was received */
	protected long[] timeStampLSR = null;//-1; //32 bits
	/** Delay on last SRC */
	protected long[] delaySR = null;//-1; //32 bits
	
	/**
	 * Constructor for a packet with receiver reports
	 * 
	 * @param reportees the participants on which to generate reports
	 * @param ssrc the SSRC of the sender, from the RTPSession
	 */
	protected RtcpPktRR(Participant[] reportees, long ssrc) {
		super.packetType = 201;
		// Fetch all the right stuff from the database
		super.ssrc = ssrc;
		this.reportees = reportees;
	}


	/**
	 * 
	 * 
	 * If rcount < 0 we assume we have to parse the entire packet,
	 * otherwise we'll just parse the receiver report blocks
	 * (ie. the data came from a Sender Report packet)
	 * 
	 * @param aRawPkt the byte[] with the report(s)
	 * @param start where in the raw packet to start reading
	 * @param rrCount the number of receiver reports, -1 if this does not come from an SR
	 */
	protected RtcpPktRR(byte[] aRawPkt, int start, int rrCount) {
		//System.out.println("RtcpPktRR: " + rrCount + "  start: " + start);
		super.rawPkt = aRawPkt;
		
		if(rrCount < 0 && (!super.parseHeaders(start) || packetType != 201 || super.length < 1)) {
			if(RTPSession.rtpDebugLevel > 2) {
				System.out.println(" <-> RtcpPktRR.parseHeaders() etc. problem: "+(!super.parseHeaders(start))+" "+packetType+" "+super.length);
			}
			super.problem = -201;
		}
		
		int base;
		if(rrCount > 0) {
			base = start + 28;
		} else {
			base = start + 8;
			rrCount = super.itemCount;
			super.ssrc = StaticProcs.bytesToUIntLong(aRawPkt, start + 4);
		}
		
		if(rrCount > 0) {
			reporteeSsrc = new long[rrCount];
			lossFraction = new int[rrCount];
			lostPktCount = new int[rrCount];
			extHighSeqRecv = new long[rrCount];
			interArvJitter = new long[rrCount];
			timeStampLSR = new long[rrCount];
			delaySR = new long[rrCount];

			for(int i=0; i<rrCount; i++ ) {
				int pos = base + i*24;
				reporteeSsrc[i] = StaticProcs.bytesToUIntLong(aRawPkt, pos);
				lossFraction[i] = (int) aRawPkt[pos + 4];
				aRawPkt[pos + 4] = (byte) 0;
				lostPktCount[i] = (int) StaticProcs.bytesToUIntLong(aRawPkt, pos + 4);
				extHighSeqRecv[i] = StaticProcs.bytesToUIntLong(aRawPkt, pos + 8);
				interArvJitter[i] = StaticProcs.bytesToUIntLong(aRawPkt, pos + 12);
				timeStampLSR[i] = StaticProcs.bytesToUIntLong(aRawPkt, pos + 16);
				delaySR[i] = StaticProcs.bytesToUIntLong(aRawPkt, pos + 20);
			}
		}
	}
	
	/**
	 * Encode the packet into a byte[], saved in .rawPkt
	 * 
	 * CompRtcpPkt will call this automatically
	 */
	protected void encode() {
		if(RTPSession.rtpDebugLevel > 9) {
			System.out.println("  -> RtcpPktRR.encode()");
		}
		
		byte[] rRs = null;
		//Gather up the actual receiver reports
		if(this.reportees != null) {
			rRs = this.encodeRR();
			super.rawPkt = new byte[rRs.length + 8];
			System.arraycopy(rRs, 0, super.rawPkt, 8, rRs.length);
			super.itemCount = reportees.length;
		} else {
			super.rawPkt = new byte[8];
			super.itemCount = 0;	
		}
		
		//Write the common header
		super.writeHeaders();
		
		//Add our SSRC (as sender)
		byte[] someBytes;
		someBytes = StaticProcs.uIntLongToByteWord(super.ssrc);
		System.arraycopy(someBytes, 0, super.rawPkt, 4, 4);
		
		if(RTPSession.rtpDebugLevel > 9) {
			System.out.println("  <- RtcpPktRR.encode()");
		}
		
	}
	
	/**
	 * Encodes the individual Receiver Report blocks, 
	 * 
	 * so they can be used either in RR packets or appended to SR
	 * 
	 * @return the encoded packets
	 */
	protected byte[] encodeRR() {
		if(RTPSession.rtpDebugLevel > 10) {
			System.out.println("   -> RtcpPktRR.encodeRR()");
		}
		//assuming we will always create complete reports:
		byte[] ret = new byte[24*reportees.length];
		
		//Write SR stuff
		for(int i = 0; i<reportees.length; i++) {
			int offset = 24*i;
			byte[] someBytes = StaticProcs.uIntLongToByteWord(reportees[i].ssrc);
			System.arraycopy(someBytes, 0, ret, offset, 4);
			
			//Cumulative number of packets lost
			someBytes = StaticProcs.uIntLongToByteWord(reportees[i].getLostPktCount());
		
			someBytes[0] = (byte) reportees[i].getFractionLost();
		
			//Write Cumulative number of packets lost and loss fraction to packet:
			System.arraycopy(someBytes, 0, ret, 4 + offset, 4);
		
			// Extended highest sequence received
			someBytes = StaticProcs.uIntLongToByteWord(reportees[i].getExtHighSeqRecv());
			System.arraycopy(someBytes, 0, ret, 8 + offset, 4);
		
			// Interarrival jitter
			if(reportees[i].interArrivalJitter >= 0) {
				someBytes = StaticProcs.uIntLongToByteWord((long)reportees[i].interArrivalJitter);
			} else { 
				someBytes = StaticProcs.uIntLongToByteWord((long) 0); 
			}
			System.arraycopy(someBytes, 0, ret, 12 + offset, 4);
		
			// Timestamp last sender report received
			someBytes = StaticProcs.uIntLongToByteWord(reportees[i].timeStampLSR);
			System.arraycopy(someBytes, 0, ret, 16 + offset, 4);
		
			// Delay since last sender report received, in terms of 1/655536 s = 0.02 ms
			if(reportees[i].timeReceivedLSR > 0) {
				someBytes = StaticProcs.uIntLongToByteWord(reportees[i].delaySinceLastSR());
			} else {
				someBytes = StaticProcs.uIntLongToByteWord(0);
			}
			System.arraycopy(someBytes, 0, ret, 20 + offset, 4);
		}
		if(RTPSession.rtpDebugLevel > 10) {
			System.out.println("   <- RtcpPktRR.encodeRR()");
		}
		return ret;
	}
	
	/**
	 * Debug purposes only
	 */
	public void debugPrint() {
		System.out.println("RtcpPktRR.debugPrint() ");
		if(reportees != null) {
			for(int i= 0; i<reportees.length; i++) {
				Participant part = reportees[i];
				System.out.println("     part.ssrc: " + part.ssrc + "  part.cname: " + part.cname);
			}
		} else {
			for(int i=0;i<reporteeSsrc.length; i++) {
				System.out.println("     reporteeSSRC: " + reporteeSsrc[i] + "  timeStampLSR: " + timeStampLSR[i]);
			}
		}
	}
}