backport change from the iaxclient sf repository rev 648, 649, 650, 656.

git-svn-id: http://svn.freeswitch.org/svn/freeswitch/trunk@5158 d0543943-73ff-0310-b7d9-9358b9ac24b2

libs/iax/src/iax-client.h

@@ -226,6 +226,10 @@ extern unsigned int iax_session_get_capability(struct iax_session *s);
 extern char iax_pref_codec_add(struct iax_session *session, unsigned int format);
 extern void iax_pref_codec_del(struct iax_session *session, unsigned int format);
 extern int iax_pref_codec_get(struct iax_session *session, unsigned int *array, int len);
+
+/* Fine tune jitterbuffer */
+extern void iax_set_jb_target_extra( long value );
+
 extern char *iax_get_peer_ip(struct iax_session *session);
 extern char *iax_event_get_apparent_ip(struct iax_event *event);
 extern void iax_set_samplerate(struct iax_session *session, unsigned short samplemask);

libs/iax/src/iax.c

@@ -140,6 +140,9 @@ static int netfd = -1;
 /* Max timeouts */
 static int maxretries = 10;
 
+/* configurable jitterbuffer options */
+static long jb_target_extra = -1; 
+
 static int do_shutdown = 0;
 
 /* external global networking replacements */
@@ -521,6 +524,7 @@ struct iax_session *iax_session_new(void)
 			jbconf.max_jitterbuf = 0;
 			jbconf.resync_threshold = 1000;
 			jbconf.max_contig_interp = 0;
+			jbconf.target_extra = jb_target_extra;
 			jb_setconf(s->jb, &jbconf);
 		}
 #endif
@@ -944,6 +948,12 @@ int iax_shutdown(void)
 	return do_shutdown++;
 }
 
+void iax_set_jb_target_extra( long value )
+{
+	/* store in jb_target_extra, a static global */
+	jb_target_extra = value ;
+}
+
 int iax_init(char *ip, int preferredportno)
 {
 	int portno = preferredportno;

libs/iax/src/jitterbuf.h

@@ -35,45 +35,48 @@ extern "C" {
 	/* ms between growing and shrinking; may not be honored if jitterbuffer runs out of space */
 #define JB_ADJUST_DELAY 40
 
+enum jb_return_code {
+	/* return codes */
+	JB_OK,            /* 0 */
+	JB_EMPTY,         /* 1 */
+	JB_NOFRAME,       /* 2 */
+	JB_INTERP,        /* 3 */
+	JB_DROP,          /* 4 */
+	JB_SCHED          /* 5 */
+};
 
-/* return codes */
+enum jb_frame_type {
-#define JB_OK		0
-#define JB_EMPTY	1
-#define JB_NOFRAME	2
-#define JB_INTERP	3
-#define JB_DROP		4
-#define JB_SCHED	5
-
 /* frame types */
-#define JB_TYPE_CONTROL	0
+	JB_TYPE_CONTROL,  /* 0            */
-#define JB_TYPE_VOICE	1
+	JB_TYPE_VOICE,    /* 1            */
-#define JB_TYPE_VIDEO	2  /* reserved */
+	JB_TYPE_VIDEO,    /* 2 - reserved */
-#define JB_TYPE_SILENCE	3
+	JB_TYPE_SILENCE   /* 3            */
-
+};
 
 typedef struct jb_conf {
 	/* settings */
-	long max_jitterbuf;	/* defines a hard clamp to use in setting the jitter buffer delay */
+	long max_jitterbuf;     /* defines a hard clamp to use in setting the jitter buffer delay */
- 	long resync_threshold;  /* the jb will resync when delay increases to (2 * jitter) + this param */
+	long resync_threshold;  /* the jb will resync when delay increases to (2 * jitter) + this param */
 	long max_contig_interp; /* the max interp frames to return in a row */
+	long target_extra;      /* amount of additional jitterbuffer adjustment, overrides JB_TARGET_EXTRA */
 } jb_conf;
 
 typedef struct jb_info {
 	jb_conf conf;
 
 	/* statistics */
-	long frames_in;  	/* number of frames input to the jitterbuffer.*/
+	long frames_in;		/* number of frames input to the jitterbuffer.*/
-	long frames_out;  	/* number of frames output from the jitterbuffer.*/
+	long frames_out;	/* number of frames output from the jitterbuffer.*/
-	long frames_late; 	/* number of frames which were too late, and dropped.*/
+	long frames_late;	/* number of frames which were too late, and dropped.*/
-	long frames_lost; 	/* number of missing frames.*/
+	long frames_lost;	/* number of missing frames.*/
-	long frames_dropped; 	/* number of frames dropped (shrinkage) */
+	long frames_dropped;	/* number of frames dropped (shrinkage) */
-	long frames_ooo; 	/* number of frames received out-of-order */
+	long frames_ooo;	/* number of frames received out-of-order */
-	long frames_cur; 	/* number of frames presently in jb, awaiting delivery.*/
+	long frames_cur;	/* number of frames presently in jb, awaiting delivery.*/
 	time_in_ms_t jitter; 		/* jitter measured within current history interval*/
 	time_in_ms_t min;		/* minimum lateness within current history interval */
 	time_in_ms_t current; 		/* the present jitterbuffer adjustment */
 	time_in_ms_t target; 		/* the target jitterbuffer adjustment */
-	long losspct; 		/* recent lost frame percentage (* 1000) */
+	long losspct;		/* recent lost frame percentage (* 1000) */
 	time_in_ms_t next_voice_ts;	/* the ts of the next frame to be read from the jb - in receiver's time */
 	long last_voice_ms;	/* the duration of the last voice frame */
 	time_in_ms_t silence_begin_ts;	/* the time of the last CNG frame, when in silence */
@@ -81,14 +84,14 @@ typedef struct jb_info {
 	time_in_ms_t last_delay;        /* the last now added to history */
 	long cnt_delay_discont;	/* the count of discontinuous delays */
 	time_in_ms_t resync_offset;     /* the amount to offset ts to support resyncs */
-	long cnt_contig_interp; /* the number of contiguous interp frames returned */
+	long cnt_contig_interp;	/* the number of contiguous interp frames returned */
 } jb_info;
 
 typedef struct jb_frame {
-	void *data;		/* the frame data */
+	void *data;               /* the frame data */
 	time_in_ms_t ts;	/* the relative delivery time expected */
-	long ms;	/* the time covered by this frame, in sec/8000 */
+	long ms;                  /* the time covered by this frame, in sec/8000 */
-	int  type;	/* the type of frame */
+	enum jb_frame_type type;  /* the type of frame */
 	struct jb_frame *next, *prev;
 } jb_frame;
 
@@ -102,22 +105,21 @@ typedef struct jitterbuf {
 	time_in_ms_t hist_minbuf[JB_HISTORY_MAXBUF_SZ];	/* a sorted buffer of the min delays (lowest first) */
 	int  hist_maxbuf_valid;			/* are the "maxbuf"/minbuf valid? */
 
-
+	jb_frame *frames;		/* queued frames */
-	jb_frame *frames; 		/* queued frames */
+	jb_frame *free;			/* free frames (avoid malloc?) */
-	jb_frame *free; 		/* free frames (avoid malloc?) */
 } jitterbuf;
 
 
 /* new jitterbuf */
-extern jitterbuf *		jb_new(void);
+jitterbuf *		jb_new(void);
 
 /* destroy jitterbuf */
-extern void			jb_destroy(jitterbuf *jb);
+void			jb_destroy(jitterbuf *jb);
 
 /* reset jitterbuf */
 /* NOTE:  The jitterbuffer should be empty before you call this, otherwise
  * you will leak queued frames, and some internal structures */
-extern void			jb_reset(jitterbuf *jb);
+void			jb_reset(jitterbuf *jb);
 
 /* queue a frame data=frame data, timings (in ms): ms=length of frame (for voice), ts=ts (sender's time)
  * now=now (in receiver's time) return value is one of
@@ -125,7 +127,7 @@ extern void			jb_reset(jitterbuf *jb);
  * JB_DROP: Drop this frame immediately
  * JB_SCHED: Frame added. Call jb_next() to get a new time for the next frame
  */
-extern int 			jb_put(jitterbuf *jb, void *data, int type, long ms, time_in_ms_t ts, time_in_ms_t now);
+enum jb_return_code jb_put(jitterbuf *jb, void *data, const enum jb_frame_type type, long ms, time_in_ms_t ts, time_in_ms_t now);
 
 /* get a frame for time now (receiver's time)  return value is one of
  * JB_OK:  You've got frame!
@@ -134,23 +136,23 @@ extern int 			jb_put(jitterbuf *jb, void *data, int type, long ms, time_in_ms_t
  * JB_INTERP: Please interpolate an interpl-length frame for this time (either we need to grow, or there was a lost frame)
  * JB_EMPTY: The jb is empty.
  */
-extern int			jb_get(jitterbuf *jb, jb_frame *frame, time_in_ms_t now, long interpl);
+enum jb_return_code jb_get(jitterbuf *jb, jb_frame *frame, time_in_ms_t now, long interpl);
 
 /* unconditionally get frames from jitterbuf until empty */
-extern int jb_getall(jitterbuf *jb, jb_frame *frameout);
+enum jb_return_code jb_getall(jitterbuf *jb, jb_frame *frameout);
 
 /* when is the next frame due out, in receiver's time (0=EMPTY)
  * This value may change as frames are added (esp non-audio frames) */
-extern time_in_ms_t		jb_next(jitterbuf *jb);
+time_in_ms_t			jb_next(jitterbuf *jb);
 
 /* get jitterbuf info: only "statistics" may be valid */
-extern int			jb_getinfo(jitterbuf *jb, jb_info *stats);
+enum jb_return_code jb_getinfo(jitterbuf *jb, jb_info *stats);
 
 /* set jitterbuf conf */
-extern int			jb_setconf(jitterbuf *jb, jb_conf *conf);
+enum jb_return_code jb_setconf(jitterbuf *jb, jb_conf *conf);
 
-typedef 		void (*jb_output_function_t)(const char *fmt, ...);
+typedef			void (*jb_output_function_t)(const char *fmt, ...);
-extern void 			jb_setoutput(jb_output_function_t err, jb_output_function_t warn, jb_output_function_t dbg);
+extern void jb_setoutput(jb_output_function_t err, jb_output_function_t warn, jb_output_function_t dbg);
 
 #ifdef __cplusplus
 }