diff options
author | Harald Welte <laforge@osmocom.org> | 2022-06-18 12:24:52 +0200 |
---|---|---|
committer | Harald Welte <laforge@osmocom.org> | 2022-06-18 13:34:24 +0200 |
commit | 1b6289adcefe52d42883c5f2bc664bfee473fdcb (patch) | |
tree | 2a0f7d8724734d1b0e782ea6f4e76bc743c39d32 | |
parent | 3b13edf48f4cf0754d8ce1615881f8c4326b0739 (diff) |
Convert + Expand README file
README.md in-line with that of other osmocom CNI projects:
* markdown syntax
* link to manuals, issue tracker, gerrit contributions, etc.
Change-Id: I98e09e8900c359382e2a90b187f0c6f22a1cf81d
-rw-r--r-- | README | 35 | ||||
-rw-r--r-- | README.md | 85 |
2 files changed, 85 insertions, 35 deletions
diff --git a/README b/README deleted file mode 100644 index 0f1b3cf24..000000000 --- a/README +++ /dev/null @@ -1,35 +0,0 @@ -About OsmoMSC -============= - -OsmoMSC is an implementation of the 3GPP MSC (Mobile Switching Centre) -network element. It implements the following core functionality within -the 2G (GSM) and 3G (UMTS) networks: - -* mobility management -* call control (either via built-in MNCC handler or external osmo-sip-connector) -* USSD (exposed via GSUP) -* SMS (either via built-in SMSC or external via GSUP) - -Historically, OsmoMSC 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. - -OsmoMSC was one of the parts split off from the old openbsc.git. Before, -it was the libmsc part of the old OsmoNITB. Since a true A interface and -IuCS for 3G support is available, OsmoMSC exists only as a separate -standalone entity. - -OsmoMSC exposes -- GSUP towards OsmoHLR (or a MAP proxy); -- A over IP towards a BSC (e.g. OsmoBSC); -- IuCS towards an RNC or HNB-GW (e.g. OsmoHNBGW) for 3G voice; -- MNCC (Mobile Network Call Control derived from GSM TS 04.07); -- SMPP 3.4 (Short Message Peer-to-Peer); -- The Osmocom typical telnet VTY and CTRL interfaces. - -Find OsmoMSC issue tracker and wiki online at -https://osmocom.org/projects/osmomsc -https://osmocom.org/projects/osmomsc/wiki diff --git a/README.md b/README.md new file mode 100644 index 000000000..8d7995ed2 --- /dev/null +++ b/README.md @@ -0,0 +1,85 @@ +osmo-msc - Osmocom MSC Implementation +===================================== + +This repository contains a C-language implementation of a GSM Mobile Switching +Centre (MSC) for 2G (GSM) and 3G (UMTS). It is part of the +[Osmocom](https://osmocom.org/) Open Source Mobile Communications +project. + +OsmoMSC exposes + * A over IP towards BSCs (e.g. OsmoBSC): 3GPP AoIP or SCCPlite + * IuCS over IP towards RNCs / HNBGW (e.g. osmo-hnbgw) + * The Osmocom typical telnet VTY and CTRL interfaces. + * The Osmocom typical statsd exporter. + +OsmoMSC implements + * mobility management + * call control (either via built-in MNCC handler or external osmo-sip-connector) + * USSD (exposed via GSUP) + * SMS (either via built-in SMSC or external via GSUP) + +Homepage +-------- + +You can find the OsmoMSC issue tracker and wiki online at +<https://osmocom.org/projects/osmomsc> and <https://osmocom.org/projects/osmomsc/wiki>. + + +GIT Repository +-------------- + +You can clone from the official osmo-msc.git repository using + + git clone https://gitea.osmocom.org/cellular-infrastructure/osmo-msc + +There is a web interface at <https://gitea.osmocom.org/cellular-infrastructure/osmo-msc> + + +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/osmomsc-usermanual.pdf) +as well as the [VTY Reference Manual](https://ftp.osmocom.org/docs/latest/osmomsc-vty-reference.pdf) + + +Mailing List +------------ + +Discussions related to osmo-msc are happening on the +openbsc@lists.osmocom.org mailing list, please see +<https://lists.osmocom.org/mailman/listinfo/openbsc> 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 +<https://osmocom.org/projects/cellular-infrastructure/wiki/Coding_standards> + +We us a gerrit based patch submission/review process for managing +contributions. Please see +<https://osmocom.org/projects/cellular-infrastructure/wiki/Gerrit> for +more details + +The current patch queue for osmo-msc can be seen at +<https://gerrit.osmocom.org/#/q/project:osmo-msc+status:open> + + +History +------- + +OsmoMSC originated from the OsmoNITB project, which started as a minimalistic +all-in-one implementation of the GSM Network. In 2017, OsmoNITB 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. + +OsmoMSC was one of the parts split off from the old openbsc.git. |