path: root/README.md
diff options
authorHarald Welte <laforge@gnumonks.org>2017-03-17 17:24:29 +0100
committerHarald Welte <laforge@gnumonks.org>2017-03-17 17:24:55 +0100
commitdb84235a0bca73a4c5f68bd821fa4e2b1a1d7d68 (patch)
tree60a9f38ccfa368b45ffa2788796787539b1cf2f4 /README.md
parent20827374e9dd3c5b1ce603adda3b20a8dfc7df5d (diff)
Update README file with general project info and use Markdown
Also, it seems the readme was so far not included in any tarballs (make dist). Let's change that. Change-Id: I1967fbbdeadb967c0c0dce2c112ac692c539da1d
Diffstat (limited to 'README.md')
1 files changed, 84 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ed5ab17
--- /dev/null
+++ b/README.md
@@ -0,0 +1,84 @@
+osmo-pcu - Osmocom Packet Control Unit
+This repository contains a C/C++-language implementation of a GPRS
+Packet Control Unit, as specified by ETSI/3GPP. It is part of the
+[Osmocom](https://osmocom.org/) Open Source Mobile Communications
+The Packet Control Unit is terminating the Layer 2 (RLC/MAC) of the GPRS
+radio interface and adapting it to the Gb Interface (BSSGP+NS Protocol)
+towards the SGSN.
+The PCU interfaces with the physical layer of the radio interface.
+OsmoPCU is typically used co-located with the BTS, specifically
+For legacy BTSs that run proprietary sotware without an interface to
+OsmoPCU, you may also co-locate it with the BSC, specifically
+The official homepage of the project is
+GIT Repository
+You can clone from the official osmo-pcu.git repository using
+ git clone git://git.osmocom.org/osmo-pcu.git
+There is a cgit interface at http://git.osmocom.org/osmo-pcu/
+We provide a
+[user manual](http://ftp.osmocom.org/docs/latest/osmopcu-usermanual.pdf)
+as well as a
+[vty reference manual](http://ftp.osmocom.org/docs/latest/osmopcu-vty-reference.pdf)
+Please note that a lot of the PCU configuration actually happens inside
+the BSC, which passes this configuration via A-bis OML to the BTS, which
+then in turn passes it via the PCU socket into OsmoPCU.
+Mailing List
+Discussions related to osmo-pcu are happening on the
+osmocom-net-gprs@lists.osmocom.org mailing list, please see
+https://lists.osmocom.org/mailman/listinfo/osmocom-net-gprs for
+subscription options and the list archive.
+Please observe the [Osmocom Mailing List
+when posting.
+Our coding standards are described at
+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-pcu can be seen at
+Current limitations
+ * No PFC support
+ * No fixed allocation support
+ * No extended dynamic allocation support
+ * No unacknowledged mode operation
+ * Only single slot assignment on uplink direction
+ * No half-duplex class support (only semi-duplex)
+ * No TA loop
+ * No power loop