Cellular Network Infrastructure » Core Network (CN) » osmo-sip-connector

Osmo-sip-connector » History » Revision 85

Revision 84 (laforge, 03/04/2020 08:23 PM) → Revision 85/87 (laforge, 03/01/2023 03:33 PM)

h1. Osmo-sip-connector 

 {{>toc}} 

 h2. Introduction 

 osmo-sip-connector translates between MNCC and SIP protocols and hereby replaces the old LCR based approach. Osmo-sip-connector handles only the signaling, but does not handle RTP.     The RTP user plane is passed transparently from the MSC-colocated osmo-mgw to the SIP side.    This also means that no transcoding is performed.    The RTP streams contain whatever cellular specific codec you have configured your network to use for this call (FR, EFR, HR, AMR). 

 An by itself, an external SIP-PBX server which supports can accept SIP-Trunks is still required.  

 The following graphs illustrate image illustrates how the network components are laid out: 

 h2. osmo-sip-connector with [[OsmoNITB:]] 

 {{graphviz_link() 
 digraph G{ 
   "osmo-sip-connector" [color="red"]; 
   rankdir = LR; 
   MS -> BTS [label = "Um"]; 
   BTS -> "osmo-nitb" [label = "Abis"]; 
   "osmo-nitb" -> "osmo-sip-connector" [label = "MNCC"]; 
   "osmo-sip-connector" -> "PBX" [label = "SIP"]; 
   "BTS" -> "PBX" [label = "RTP"]; 
 } 
 }} 

 h2. osmo-sip-connector with [[OsmoBSC:]] and [[OsmoMSC:]] 

 {{graphviz_link() 
 digraph G{ 
   rankdir = LR; 
   "osmo-sip-connector" [color="red"]; 
   OsmoMGWB [label="OsmoMGW\n(BSC)"]; 
   OsmoMGWM [label="OsmoMGW\n(MSC)"]; 
   MS -> BTS [label = "Um"]; 
   BTS -> OsmoBSC [label = "Abis"]; 
   OsmoBSC -> OsmoMSC [label = "AoIP" ]; 
   OsmoMSC -> "osmo-sip-connector" [label = "MNCC"]; 
   "osmo-sip-connector" -> "PBX" [label = "SIP"]; 
   BTS -> OsmoMGWB [label = "RTP"]; 
   OsmoMGWB -> OsmoMGWM [label = "RTP"]; 
   OsmoMGWM -> "PBX" [label = "RTP"]; 
   OsmoBSC -> OsmoMGWB [label = "MGCP" ]; 
   OsmoMSC -> OsmoMGWM [label = "MGCP" ]; 
   { rank = same; OsmoBSC; OsmoMGWB; } 
   { rank = same; OsmoMSC; OsmoMGWM; } 
 } 
 }} 

 h2. osmo-sip-connector with [[OsmoNITB:]] (unsupported old configuration) 

 {{graphviz_link() 
 digraph G{ 
   "osmo-sip-connector" [color="red"]; 
   rankdir = LR; 
   MS -> BTS [label = "Um"]; 
   BTS -> "osmo-nitb" [label = "Abis"]; 
   "osmo-nitb" -> "osmo-sip-connector" [label = "MNCC"]; 
   "osmo-sip-connector" -> "PBX" [label = "SIP"]; 
   "BTS" -> "PBX" [label = "RTP"]; 
 } 
 }} 

 {{include(cellular-infrastructure:MacroBinaryPackages)}} 

 h2. Manuals 

 * "osmosipconnector-usermanual.pdf":http://ftp.osmocom.org/docs/latest/osmosipconnector-usermanual.pdf 
 * "osmosipconnector-vty-reference.pdf":http://ftp.osmocom.org/docs/latest/osmosipconnector-vty-reference.pdf 

 h2. Howto (configure/run it) 

 See [[Howto]] 

 h2. Source code 

 The source code is available from @git.osmocom.org@ (module @osmo-sip-connector@). 

 Public read-only access is available via 
 <pre> 
 git clone git://git.osmocom.org/osmo-sip-connector.git 
 </pre> 

 You can browse it via cgit:    https://git.osmocom.org/osmo-sip-connector 

 Contributions are welcome via [[Cellular-Infrastructure:Gerrit]]. 

 h2. Test Suite 

 We have a TTCN-3 test suite as part of our [[cellular-infrastructure:Titan_TTCN3_Testsuites]] 
 * source code: http://git.osmocom.org/osmo-ttcn3-hacks/tree/sip 
 * results: https://jenkins.osmocom.org/jenkins/view/TTCN3/job/ttcn3-sip-test/ 

 {{include(cellular-infrastructure:MacroCommercialSupport)}}