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

Osmo-sip-connector » History » Revision 86

Revision 85 (laforge, 03/01/2023 03:33 PM) → Revision 86/87 (laforge, 03/01/2023 03:34 PM)

h1. Osmo-sip-connector 

 {{>toc}} 

 h2. Introduction 

 osmo-sip-connector translates between MNCC and SIP protocols.    It allows a [[OsmoMSC:]] protocols and hereby replaces the old LCR based cellular network to be interfaced with external SIP telephony. 

 osmo-sip-connector 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 external SIP-PBX server which supports SIP-Trunks is required.  

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

 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)}}