diff --git a/Makefile.am b/Makefile.am index e52427170..045e74d45 100644 --- a/Makefile.am +++ b/Makefile.am @@ -24,7 +24,7 @@ pkgconfig_DATA = \ BUILT_SOURCES = $(top_srcdir)/.version EXTRA_DIST = \ .version \ - README \ + README.md \ contrib/osmo-mgw.spec.in \ debian \ git-version-gen \ diff --git a/README b/README deleted file mode 100644 index 29883b8fd..000000000 --- a/README +++ /dev/null @@ -1,24 +0,0 @@ -About OsmoMGW -============= - -OsmoMGW originated from the OpenBSC project, which started as a minimalistic -all-in-one implementation of the GSM Network. In 2017, OpenBSC had reached -maturity and diversity (including M3UA SIGTRAN and 3G support in the form of -IuCS and IuPS interfaces) that naturally lead to a separation of the all-in-one -approach to fully independent separate programs as in typical GSM networks. - -OsmoMGW was one of the parts split off from the old openbsc.git. It originated -as a solution to merely navigate RTP streams through a NAT, but has since -matured to a Media Gateway implementation that is capable of streaming RTP for -2G (AoIP) and 3G (IuCS) GSM networks as well as (still not implemented at time -of writing) transcoding between TRAU, various RTP payloads and IuUP. - -The OsmoMGW program exposes an MGCP interface towards clients like OsmoMSC and -OsmoBSC, and receives and sends RTP streams as configured via MGCP. - -The libosmo-mgcp-client library exposes utilities used by e.g. OsmoMSC (found -in osmo-msc.git) to instruct OsmoMGW via its MGCP service. - -Find OsmoMGW issue tracker and wiki online at -https://osmocom.org/projects/osmo-mgw -https://osmocom.org/projects/osmo-mgw/wiki diff --git a/README.md b/README.md new file mode 100644 index 000000000..e87331fe5 --- /dev/null +++ b/README.md @@ -0,0 +1,102 @@ +osmo-mgw - Osmocom MGW (Media GateWay) Implementation +===================================================== + +This repository contains a C-language implementation of a MGW (Media +GateWay) for use [not only] within the 2G (GSM) and/or 3G (UMTS) +Cellular Network built using Osmocom CNI (Cellular Network +Infrastructure) software. + +The OsmoMGW program provides a MGCP interface towards a MGPC call agent +(client) like OsmoMSC and OsmoBSC, and receives and sends RTP streams as +configured via the MGCP control plane. + +This Media Gateway implementation is capable of + +* streaming RTP for 2G (3GPP AoIP and Abis-over-IP) +* streaming RTP for 3G (IuCS including the IuFP protocol) +* TDM (E1/T1) based Abis interface with TRAU frames on 16k sub-slots +* basic support for LCLS (Local Call, Local Switch) related features +* various built-in translation capabilities + * between Abis TRAU frames and RTP formats + * between 2G AMR/RTP and 3G AMR/IuFP/RTP + * between bandwidth-efficient and octet-aligned AMR + * between different standards for encapsulating GSM HR codec frames in RTP + +osmo-mgw is typically co-located with + + * osmo-bsc (GSM BSC) + * osmo-msc (GSM/UMTS MSC) + * osmo-hnbgw (UMTS HNBGW); osmo-mgw implements RTP relay between Iuh + and IuCS interfaces + +The libosmo-mgcp-client library exposes utilities used by e.g. OsmoMSC +(found in osmo-msc.git) to instruct OsmoMGW via its MGCP service. + +Homepage +-------- + +You can find the OsmoMGW issue tracker and wiki online at + and . + + +GIT Repository +-------------- + +You can clone from the official osmo-mgw.git repository using + + git clone https://gitea.osmocom.org/cellular-infrastructure/osmo-mgw + +There is a web interface at + + +Documentation +------------- + +User Manuals and VTY reference manuals are [optionally] built in PDF form +as part of the build process. + +Pre-rendered PDF version of the current "master" can be found at +[User Manual](https://ftp.osmocom.org/docs/latest/osmomgw-usermanual.pdf) +as well as the [VTY Reference Manual](https://ftp.osmocom.org/docs/latest/osmomgw-vty-reference.pdf) + + +Mailing List +------------ + +Discussions related to osmo-mgw are happening on the +openbsc@lists.osmocom.org mailing list, please see + for subscription +options and the list archive. + +Please observe the [Osmocom Mailing List +Rules](https://osmocom.org/projects/cellular-infrastructure/wiki/Mailing_List_Rules) +when posting. + + +Contributing +------------ + +Our coding standards are described at + + +We use a gerrit based patch submission/review process for managing +contributions. Please see + for +more details + +The current patch queue for osmo-mgw can be seen at + + + +History +------- + +OsmoMGW originated from the OpenBSC project, which started as a minimalistic +all-in-one implementation of the GSM Network. In 2017, OpenBSC had reached +maturity and diversity (including M3UA SIGTRAN and 3G support in the form of +IuCS and IuPS interfaces) that naturally lead to a separation of the all-in-one +approach to fully independent separate programs as in typical GSM networks. + +OsmoMGW was one of the parts split off from the old openbsc.git. It originated +as a solution to merely navigate RTP streams through a NAT, but has since +matured. diff --git a/contrib/osmo-mgw.spec.in b/contrib/osmo-mgw.spec.in index fa08acda1..a7963a306 100644 --- a/contrib/osmo-mgw.spec.in +++ b/contrib/osmo-mgw.spec.in @@ -99,7 +99,7 @@ make %{?_smp_mflags} check || (find . -name testsuite.log -exec cat {} +) %files %license COPYING -%doc AUTHORS README +%doc AUTHORS README.md %dir %{_docdir}/%{name}/examples %dir %{_docdir}/%{name}/examples/osmo-mgw %{_docdir}/%{name}/examples/osmo-mgw/osmo-mgw.cfg