Changes between Version 4 and Version 5 of QoS

Timestamp:

Oct 29, 2009 12:34:28 AM (15 years ago)

Author:

bennylp

Comment:

--

QoS

@@ -45 +45 @@
 ||                           || Win2k/older || XP, Vista, WM2003, WM5 || WM6 || Symbian S60 || Linux || MacOS X || iPhone^1)^ ||
 || High level API            ||     Yes     ||      No                || Yes ||       Yes   ||  Yes  ||  Yes    ||  Yes   ||
-|| API backend               ||  sock_qos_bsd.c^2)^  ||      sock_qos_dummy.c       || sock_qos_wm.c || sock_qos_symbian.cpp || sock_qos_bsd.c || qos_bsd.c || qos_bsd.c ||
+|| API backend               || qos_bsd.c^2)^||      qos_dummy.c      || qos_wm.c || qos_symbian.cpp || qos_bsd.c || qos_bsd.c || qos_bsd.c ||
 || DSCP is supported         ||     Yes     ||      No                || Yes ||       Yes   ||  Yes  ||  Yes    ||  Yes   ||
 || DSCP is user settable     ||     Yes     ||      No                || No  ||       Yes   ||  Yes  ||  Yes    ||  Yes   ||
@@ -54 +54 @@
 
 Notes:
- 1) iPhone availability is assumed based on MacOS X{{BR]]
+ 1) iPhone availability is assumed based on MacOS X[[BR]]
  2) On win32, sock_qos_dummy.c is used by default. Set {{{PJ_QOS_IMPLEMENTATION}}} to {{{PJ_QOS_BSD}}} to enable the use of sock_qos_bsd.c.
 
@@ -197 +197 @@
 == Limitations ==
 
-Win32 may not be implemented due to the API mess above.
+Win32 currently is not be implemented.
+
+[[BR]]
+
+== Using QoS in PJSIP Applications ==
+
+=== PJSUA-LIB ===
+
+On PJSUA-LIB, QoS parameters have been added to {{{pjsua_transport_config}}}. Please see [http://www.pjsip.org/pjsip/docs/html/structpjsua__transport__config.htm pjsua_transport_config reference] for more info.
+
+==== Examples ====
+
+To set QoS of RTP/RTCP traffic to '''Voice''' type (this will activate the appropriate DSCP, WMM, and SO_PRIORITY settings, if the OS supports it):
+
+ {{{
+  pjsua_transport_config rtp_tcfg;
+
+  pjsua_transport_config_default(&rtp_tcfg);
+  // Set listening start port etc according to app settings
+  ...
+  // Set traffic type to Voice
+  rtp_tcfg.qos_type = PJ_QOS_TYPE_VOICE;
+
+  // Create RTP transports with this config
+  pjsua_media_transports_create(&rtp_tcfg);
+ }}}
+
+To tag SIP transport traffic with a specific DSCP value (in this case, DSCP CS3 or value 24). Note that not all platforms allow this, see the table above:
+ {{{
+  pjsua_transport_config sip_tcfg;
+
+  pjsua_transport_config_default(&sip_tcfg);
+  // Set listening port etc according to app settings
+  ...
+  // Set QoS to DSCP CS3 (DSCP value 24)
+  sip_tcfg.qos_params.flags = PJ_QOS_PARAM_HAS_DSCP;
+  sip_tcfg.qos_params.dscp_val = 24;
+
+  // Create SIP transport with this config
+  pjsua_transport_create(..., &sip_tcfg, ...);
+ }}}
+
+
 
 [[BR]]