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: I201bf47550a8fea500925205e0de1060d58d6136changes/46/28346/2
parent
ac63d39a5a
commit
67851f3562
26
README
26
README
|
@ -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)
|
|
@ -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)
|
|
@ -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
|
||||
|
|
Loading…
Reference in New Issue