diff options
author | Harald Welte <laforge@osmocom.org> | 2022-06-18 11:34:46 +0200 |
---|---|---|
committer | Harald Welte <laforge@osmocom.org> | 2022-06-18 13:34:46 +0200 |
commit | 67851f356276b3ce546a51ff69c6ac440bea4e82 (patch) | |
tree | f50de804e4f6307583b5fc8ea0b581bd568ff773 | |
parent | ac63d39a5a53d00f55fc40ec40ffa6ca2f4e0752 (diff) |
convert README to README.md; expand on all fronts
This brings our README in line with the various other osmo-*
projects such as osmo-bts:
* use markdown formatting
* links to mailing list, documentation, git repo, ...
* reference the method of contribution + code review
Change-Id: I201bf47550a8fea500925205e0de1060d58d6136
-rw-r--r-- | README | 26 | ||||
-rw-r--r-- | README.md | 95 | ||||
-rw-r--r-- | contrib/osmo-bsc.spec.in | 2 |
3 files changed, 96 insertions, 27 deletions
diff --git a/README b/README deleted file mode 100644 index e84849b10..000000000 --- a/README +++ /dev/null @@ -1,26 +0,0 @@ -About OsmoBSC -============= - -OsmoBSC 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. - -OsmoBSC was one of the parts split off from the old openbsc.git. Before, it -worked as a standalone osmo-bsc binary as well as a combination of libbsc and -libmsc, i.e. the old OsmoNITB. Since the standalone OsmoMSC with a true A -interface (and IuCS for 3G support) is available, OsmoBSC exists only as a -separate standalone entity. - -OsmoBSC exposes -- A over IP towards an MSC (e.g. OsmoMSC); -- Abis interfaces towards various kinds of BTS; -- The Osmocom typical telnet VTY and CTRL interfaces. - -Find OsmoBSC issue tracker and wiki online at -https://osmocom.org/projects/osmobsc -https://osmocom.org/projects/osmobsc/wiki - -OsmoBSC-NAT is a specialized solution to navigating RTP streams through a NAT. -(Todo: describe in more detail) diff --git a/README.md b/README.md new file mode 100644 index 000000000..5eed2f2e1 --- /dev/null +++ b/README.md @@ -0,0 +1,95 @@ +osmo-bsc - Osmocom BSC Implementation +===================================== + +This repository contains a C-language implementation of a GSM Base Station +Controller (BSC). IT is part of the +[Osmocom](https://osmocom.org/) Open Source Mobile Communications +project. + +OsmoBSC exposes + * A over IP towards an MSC (e.g. OsmoMSC): 3GPP AoIP or SCCPlite + * Abis interfaces towards various kinds of BTS (osmo-bts, sysmobts, nanoBTS, Siemens, Nokia, Ericsson) + * The Osmocom typical telnet VTY and CTRL interfaces. + * The Osmocom typical statsd exporter. + * Cell Broadcast Service Protocol (CBSP) towards a CBC (Cell Broadcast Centre, such as osmo-cbc). + * Lb interface towards a SMLC (Serving Mobile Location Centre, such as osmo-smlc). + + +Homepage +-------- + +You can find the OsmoBSC issue tracker and wiki online at +<https://osmocom.org/projects/osmobsc> and <https://osmocom.org/projects/osmobsc/wiki>. + + +GIT Repository +-------------- + +You can clone from the official osmo-bsc.git repository using + + git clone https://gitea.osmocom.org/cellular-infrastructure/osmo-bsc + +There is a web interface at <https://gitea.osmocom.org/cellular-infrastructure/osmo-bsc> + + +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/osmobsc-usermanual.pdf) +as well as the [VTY Reference Manual](https://ftp.osmocom.org/docs/latest/osmobsc-vty-reference.pdf) + +There also is an +[Abis reference Manual](https://ftp.osmocom.org/docs/latest/osmobts-abis.pdf) +describing the OsmoBTS specific A-bis dialect, as well as a [CBSP Reference +Maunal](https://downloads.osmocom.org/docs/latest/osmobsc-cbsp.pdf) +describing the level of CBSP conformance. + + +Mailing List +------------ + +Discussions related to osmo-bsc 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-bsc can be seen at +<https://gerrit.osmocom.org/#/q/project:osmo-bsc+status:open> + + +History +------- + +OsmoBSC 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. + +OsmoBSC was one of the parts split off from the old openbsc.git. Before, it +worked as a standalone osmo-bsc binary as well as a combination of libbsc and +libmsc, i.e. the old OsmoNITB. Since the standalone OsmoMSC with a true A +interface (and IuCS for 3G support) is available, OsmoBSC exists only as a +separate standalone entity. + +OsmoBSC-NAT is a specialized solution to navigating RTP streams through a NAT. +(Todo: describe in more detail) diff --git a/contrib/osmo-bsc.spec.in b/contrib/osmo-bsc.spec.in index 00f9d8a1a..e46b61a58 100644 --- a/contrib/osmo-bsc.spec.in +++ b/contrib/osmo-bsc.spec.in @@ -116,7 +116,7 @@ make %{?_smp_mflags} check || (find . -name testsuite.log -exec cat {} +) %files %license COPYING -%doc AUTHORS README +%doc AUTHORS README.md %{_bindir}/osmo-bsc %dir %{_docdir}/%{name}/examples %dir %{_docdir}/%{name}/examples/osmo-bsc |