Project

General

Profile

Edit History

OsmoMGW » History » Version 17

dexter, 08/10/2022 09:48 AM

1 1 neels 
h1. OsmoMGW
2 





    3
    3
    laforge
    
OsmoMGW, the Osmocom Media Gateway, is a Media Gateway for handling user plane (voice) traffic in cellular networks.





    4
    1
    neels
    





    5
    12
    laforge
    
OsmoMGW supports the IETF "MGCP":https://tools.ietf.org/html/rfc3435 (Media Gateway Control Protocol) for control from Call Agents, such as those present in [[OsmoBSC:]] and [[OsmoMSC:]].





    6
    3
    laforge
    





    7
    16
    dexter
    
At the moment (August 2022), OsmoMGW implements RTP proxy / RTP bridge type endpoints, to each of which two RTP connections can be established. It also implements RTP / E1 endpoints that allow bridging RTP voice streams to bit synchronous E1 lines. Since each codec uses a specific TRAU format, the codec support is currently limited to GSM-FR and GSM-EFR.





    8
    3
    laforge
    





    9
    
    
    
We are planning to add endpoint types for





    10
    
    
    
* classic E1/T1 timeslots (64kBps alaw/ulaw)





    11
    
    
    
* announcement/playout end-points





    12
    
    
    
* conference endpoints





    13
    
    
    





    14
    
    
    
OsmoMGW is the generalized version of an earlier much more special-purpsoe implementation called osmo-bsc_mgcp.





    15
    
    
    





    16
    
    
    
h2. Situation in a typical Osmocom cellular network





    17
    
    
    





    18
    
    
    
h3. Use by [[OsmoBSC:]]





    19
    
    
    





    20
    
    
    
{{graphviz_link()





    21
    
    
    
digraph G {





    22
    
    
    
    rankdir = LR;





    23
    
    
    
    OsmoBTS -> OsmoBSC [label="Abis/IP"];





    24
    
    
    
    OsmoBSC -> OsmoMSC [label="3GPP AoIP"];





    25
    
    
    
    OsmoBSC -> OsmoMGW [label="MGCP"];





    26
    
    
    
    OsmoBTS -> OsmoMGW [label="RTP",dir=both];





    27
    17
    dexter
    
    OsmoMGW -> core network [label="RTP",dir=both];





    28
    3
    laforge
    
    {rank=same OsmoBSC OsmoMGW}





    29
    
    
    
    OsmoMGW [color=red];





    30
    
    
    
}





    31
    
    
    
}}





    32
    
    
    





    33
    6
    fixeria
    
h3. Use by [[OsmoMSC:]]





    34
    3
    laforge
    





    35
    
    
    
It is Planned to use OsmoMGW also from OsmoMSC like this:





    36
    
    
    





    37
    
    
    
{{graphviz_link()





    38
    
    
    
digraph G {





    39
    
    
    
    rankdir = LR;





    40
    
    
    
    BTS -> BSC [label="Abis"];





    41
    
    
    
    BSC -> OsmoMSC [label="3GPP AoIP"];





    42
    
    
    
    OsmoMSC -> OsmoMGW [label="MGCP"];





    43
    
    
    
    BSC -> OsmoMGW [label="RTP",dir=both];





    44
    
    
    
    OsmoMSC -> OsmoSIP [label="MNCC"];





    45
    
    
    
    OsmoSIP -> PBX [label="SIP Trunk"];





    46
    
    
    
    OsmoMGW -> PBX [label="RTP",dir=both];





    47
    
    
    
    {rank=same OsmoMSC OsmoMGW}





    48
    
    
    
    OsmoSIP [label="osmo-sip-connector"];





    49
    
    
    
    OsmoMGW [color=red];





    50
    
    
    





    51
    
    
    
    hNodeB -> OsmoHNBGW [label="Iuh"];





    52
    5
    laforge
    
    OsmoHNBGW -> OsmoMSC [label="IuCS"];





    53
    3
    laforge
    
    hNodeB -> OsmoMGW [label="RTP",dir=both];





    54
    
    
    
}





    55
    
    
    
}}





    56
    
    
    





    57
    10
    laforge
    
{{include(cellular-infrastructure:MacroBinaryPackages)}}





    58
    
    
    





    59
    2
    neels
    
h2. User Manuals





    60
    1
    neels
    





    61
    13
    daniel
    
* osmo-mgw user manual: http://ftp.osmocom.org/docs/latest/osmomgw-usermanual.pdf





    62
    7
    laforge
    
* osmo-mgw VTY reference: http://ftp.osmocom.org/docs/latest/osmomgw-vty-reference.pdf





    63
    3
    laforge
    





    64
    11
    laforge
    
h2. Source code





    65
    
    
    





    66
    15
    laforge
    
The source code is available from @gitea.osmocom.org@ (module @osmo-mgw@).





    67
    11
    laforge
    





    68
    
    
    
Public read-only access is available via





    69
    
    
    
<pre>





    70
    15
    laforge
    
git clone https://gitea.osmocom.org/cellular-infrastructure/osmo-mgw





    71
    11
    laforge
    
</pre>





    72
    
    
    





    73
    15
    laforge
    
You can browse it via gitea:  https://gitea.osmocom.org/cellular-infrastructure/osmo-mgw





    74
    11
    laforge
    





    75
    
    
    
Contributions are welcome via [[cellular-infrastructure:Gerrit]].





    76
    
    
    





    77
    8
    laforge
    
h2. Test Suite





    78
    
    
    





    79
    
    
    
We have a TTCN-3 test suite as part of our [[cellular-infrastructure:Titan_TTCN3_Testsuites]]





    80
    15
    laforge
    
* source code: https://gitea.osmocom.org/ttcn3/osmo-ttcn3-hacks/src/branch/master/mgw





    81
    8
    laforge
    
* results: https://jenkins.osmocom.org/jenkins/view/TTCN3/job/ttcn3-mgw-test/





    82
    
    
    





    83
    3
    laforge
    
h2. Contact





    84
    
    
    





    85
    9
    laforge
    
* Contact us via the openbsc@ mailing list, see [[cellular-infrastructure:Mailing Lists]].





    86
    
    
    
* Contributions are welcome via [[cellular-infrastructure:Gerrit]].





    87
    15
    laforge
    
* Git repository browser at https://gitea.osmocom.org/cellular-infrastructure/osmo-mgw





    88
    14
    laforge
    





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








        
        

    














  

  
  Add picture from clipboard
  (Maximum size: 48.8 MB)