[[overview]]
== Overview

This manual should help you getting started with OsmoSIPConnector. It will
cover aspects of configuring and running OsmoSIPConnector.

[[intro_overview]]
=== About OsmoSIPConnector

OsmoSIPConnector translates between Mobile Network Call Control (MNCC)
used in the GSM newtwork and Voice over IP SIP call control messages so that
speech calls can traverse through the mobile network to SIP and vice versa. It
has the following interfaces:

- MNCC UNIX domain socket towards `osmo-msc`
- SIP towards the PBX
- The Osmocom typical telnet VTY interface.

Find the OsmoSIPConnector issue tracker and wiki online at

- https://osmocom.org/projects/osmo-sip-connector
- https://osmocom.org/projects/osmo-sip-connector/wiki


[[fig-gsm]]
.Typical GSM network architecture used with OsmoSIPConnector
[graphviz]
----
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; }
}
----