Osmo-sip-connector » History » Version 87
laforge, 11/07/2023 03:52 PM
deprecate git://
| 1 | 1 | msuraev | h1. Osmo-sip-connector |
|---|---|---|---|
| 2 | |||
| 3 | 63 | dexter | {{>toc}} |
| 4 | |||
| 5 | 18 | dexter | h2. Introduction |
| 6 | |||
| 7 | 86 | laforge | osmo-sip-connector translates between MNCC and SIP protocols. It allows a [[OsmoMSC:]] based cellular network to be interfaced with external SIP telephony. |
| 8 | |||
| 9 | 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). |
||
| 10 | 1 | msuraev | |
| 11 | 85 | laforge | An external SIP-PBX server which supports SIP-Trunks is required. |
| 12 | 64 | dexter | |
| 13 | 85 | laforge | The following graphs illustrate how the network components are laid out: |
| 14 | 64 | dexter | |
| 15 | 74 | laforge | h2. osmo-sip-connector with [[OsmoBSC:]] and [[OsmoMSC:]] |
| 16 | |||
| 17 | {{graphviz_link() |
||
| 18 | digraph G{ |
||
| 19 | rankdir = LR; |
||
| 20 | 1 | msuraev | "osmo-sip-connector" [color="red"]; |
| 21 | 77 | laforge | OsmoMGWB [label="OsmoMGW\n(BSC)"]; |
| 22 | 1 | msuraev | OsmoMGWM [label="OsmoMGW\n(MSC)"]; |
| 23 | MS -> BTS [label = "Um"]; |
||
| 24 | BTS -> OsmoBSC [label = "Abis"]; |
||
| 25 | OsmoBSC -> OsmoMSC [label = "AoIP" ]; |
||
| 26 | OsmoMSC -> "osmo-sip-connector" [label = "MNCC"]; |
||
| 27 | "osmo-sip-connector" -> "PBX" [label = "SIP"]; |
||
| 28 | BTS -> OsmoMGWB [label = "RTP"]; |
||
| 29 | OsmoMGWB -> OsmoMGWM [label = "RTP"]; |
||
| 30 | OsmoMGWM -> "PBX" [label = "RTP"]; |
||
| 31 | OsmoBSC -> OsmoMGWB [label = "MGCP" ]; |
||
| 32 | OsmoMSC -> OsmoMGWM [label = "MGCP" ]; |
||
| 33 | { rank = same; OsmoBSC; OsmoMGWB; } |
||
| 34 | { rank = same; OsmoMSC; OsmoMGWM; } |
||
| 35 | 85 | laforge | } |
| 36 | }} |
||
| 37 | |||
| 38 | h2. osmo-sip-connector with [[OsmoNITB:]] (unsupported old configuration) |
||
| 39 | |||
| 40 | {{graphviz_link() |
||
| 41 | digraph G{ |
||
| 42 | "osmo-sip-connector" [color="red"]; |
||
| 43 | rankdir = LR; |
||
| 44 | MS -> BTS [label = "Um"]; |
||
| 45 | BTS -> "osmo-nitb" [label = "Abis"]; |
||
| 46 | "osmo-nitb" -> "osmo-sip-connector" [label = "MNCC"]; |
||
| 47 | "osmo-sip-connector" -> "PBX" [label = "SIP"]; |
||
| 48 | "BTS" -> "PBX" [label = "RTP"]; |
||
| 49 | 74 | laforge | } |
| 50 | }} |
||
| 51 | 64 | dexter | |
| 52 | 75 | laforge | {{include(cellular-infrastructure:MacroBinaryPackages)}} |
| 53 | |||
| 54 | h2. Manuals |
||
| 55 | |||
| 56 | 83 | osmith | * "osmosipconnector-usermanual.pdf":http://ftp.osmocom.org/docs/latest/osmosipconnector-usermanual.pdf |
| 57 | * "osmosipconnector-vty-reference.pdf":http://ftp.osmocom.org/docs/latest/osmosipconnector-vty-reference.pdf |
||
| 58 | 75 | laforge | |
| 59 | 80 | laforge | h2. Howto (configure/run it) |
| 60 | |||
| 61 | See [[Howto]] |
||
| 62 | |||
| 63 | 78 | laforge | h2. Source code |
| 64 | |||
| 65 | The source code is available from @git.osmocom.org@ (module @osmo-sip-connector@). |
||
| 66 | |||
| 67 | Public read-only access is available via |
||
| 68 | <pre> |
||
| 69 | 87 | laforge | git clone https://gitea.osmocom.org/cellular-infrastructure/osmo-sip-connector |
| 70 | 78 | laforge | </pre> |
| 71 | |||
| 72 | You can browse it via cgit: https://git.osmocom.org/osmo-sip-connector |
||
| 73 | |||
| 74 | 82 | laforge | Contributions are welcome via [[Cellular-Infrastructure:Gerrit]]. |
| 75 | 1 | msuraev | |
| 76 | 80 | laforge | h2. Test Suite |
| 77 | 1 | msuraev | |
| 78 | 80 | laforge | We have a TTCN-3 test suite as part of our [[cellular-infrastructure:Titan_TTCN3_Testsuites]] |
| 79 | * source code: http://git.osmocom.org/osmo-ttcn3-hacks/tree/sip |
||
| 80 | * results: https://jenkins.osmocom.org/jenkins/view/TTCN3/job/ttcn3-sip-test/ |
||
| 81 | 84 | laforge | |
| 82 | {{include(cellular-infrastructure:MacroCommercialSupport)}} |
