Commit Graph

581 Commits

Author SHA1 Message Date
Harald Welte 4234cc99e0 port_numbers.adoc: Allocate VTY port number for osmo-isdntap
osmo-isdntap is an ISDN protocol + call tracing utility currently
under development, see
https://gitea.osmocom.org/retronetworking/osmo-isdntap

Change-Id: I3c5d681ba086ed7cf7fdb0408465a433000c799c
2022-10-16 17:14:48 +02:00
Pau Espin 370958df99 osmux: Improve NAT related documentation
Related: SYS#5987
Change-Id: I5ed7aa834bfd0d5ef84ff69ece6d1d5e5b920d4e
2022-10-13 12:38:26 +02:00
Pau Espin 4c9264e0ba Document osmux use in Abis interface
Related: SYS#5987
Change-Id: Ic02d379f35f29f633d0fb14da3597481a0b8b8ba
2022-09-16 12:54:58 +02:00
Pau Espin 1ab6dbc62a osmux: Use local/remote CID terminology
This terminology is much more common and used in other protocols, like
PFCP.

Related: SYS#5987
Change-Id: Ia5eb833c296c504555f273a7fc3af5d746af19c0
2022-09-15 16:19:15 +02:00
Vadim Yanitskiy 35b5e27b02 TRXD: further clarify meaning of Training / Synch. Sequence Code
Both Synch. sequence and Training sequence are basically the same thing,
only the length is different.  I guess this is why 3GPP TS 45.002 names
them differently.  Let's mention them both to avoid confusion.

Change-Id: I092af5ef6b66f8bdbd46cc3ae0c77fd806f2fe27
2022-08-19 17:37:36 +07:00
Pau Espin c948dc4491 port_number.adoc: Add default osmux port
This has been the port used historically in most existing deployments,
and it's the one already documented in the osmux section of user
manuals.

Change-Id: I9593e484a0df7cbfc3fa68f071246e3fb714bd4c
2022-08-12 14:11:55 +02:00
Pau Espin dda6a7e446 Bump version: 1.2.0.12-6984 → 1.3.0
Change-Id: I9487c26c6f1898481c25f227bc462b6867a05b70
2022-06-28 17:27:15 +02:00
Pau Espin 6984a40c6b sigtran: Use caps in section header
Change-Id: Ie7ff0dced649a29817a5a46e37eaaaf7ee22aea6
2022-06-28 15:06:41 +02:00
Pau Espin 6be6ffb9f3 sigtran: Remove old comment about non-implemented stuff
As supports multiple ASP with loadshare and override since a long time
ago.

Change-Id: I703c64a85636c2f9ebbd809e49c0dc8891cb9527
2022-06-28 15:03:04 +02:00
Harald Welte 9ad5777ffc port_numbers: Add missing records for osmo-upf, pfcp-tool, hnodeb
Seems like the instructions for adding new port numbers were not
followed when those entires were added to
https://osmocom.org/projects/cellular-infrastructure/wiki/Port_Numbers

Change-Id: Ie077bc375d45202f6004d0a3d45e5fc772d5641d
2022-05-13 10:20:39 +02:00
Harald Welte 02525c816e glossary: add CBSP, CBC, CBS
Change-Id: Iac405366b2191415ebb1e71154fc3bf31ad37a59
2022-05-13 10:20:39 +02:00
Harald Welte 2106fce829 bibliography: Add reference to TS 48.049 (CBSP)
Change-Id: Id1504cb8f9331f36b6085d238a43fe041703ab23
2022-05-13 10:09:35 +02:00
Harald Welte 9d0ef861a1 Add CBSP port number to default list of ports
Change-Id: Ifff8eb076bef29a64d9d20237fe5c8ee402788dc
2022-05-13 10:06:52 +02:00
Alexander Couzens 1f8a888261 common: gb-ns2: add chapter Gb/NS maintenance
Add chapter to describe common maintenance

Change-Id: I5571001a127c933397a4bc26e85410288d50fc2f
2022-03-01 18:15:51 +01:00
Alexander Couzens 5cba08b88d common: gb-ns2: fix typo in configures
Change-Id: Ia3d41d5fae8af7a35e86feba6ecb37c0692206b1
2022-02-22 19:03:13 +01:00
Alexander Couzens b1318e3c63 common: gb-ns2: correct ip.access static configuration
Change-Id: I652f7cda1e79e452af7740c1cae192a9f2b1acab
2022-02-22 18:20:02 +01:00
Alexander Couzens 0d173b3b99 common: gb-ns2: update ip-sns configuration example
Change-Id: I0b20634d683ad8f93c1c8af35eacbb953c1db46b
2022-02-22 18:19:55 +01:00
Alexander Couzens 389cc79742 common: gb-ns2: remove empty VTY chapter
Change-Id: Iee28046fbb0a5a034c2a33c495a3ca6f8ef953c4
2022-02-22 18:19:51 +01:00
Philipp Maier cccc44ded3 counters-overview: add documentation about socket statistics
How and when socket statistics are generated is not immediately obvious.
Lets add some documentation about it.

Change-Id: Icb06b3934e9ea5f3526263dc8915bc3529a64324
Related: OS#5701
2022-01-07 12:45:40 +01:00
Pau Espin 738c0840e0 Bump version: 1.1.0.18-cec5 → 1.2.0
Change-Id: Id9167fa8aa474bb6feb349a2dcecb015b2a1d3b4
2021-11-16 13:18:04 +01:00
Vadim Yanitskiy cec5b5d74d mncc: do not mention deprecated -m / --mncc-sock options
Change-Id: Icb18fb9e95c5a7f32a85a1b269185298c07354ee
2021-11-12 20:22:22 +03:00
Pau Espin b92c3ae264 cs7-config.adoc: Improve doc on default SS7 SCTP addresses
Related: OS#5186
Change-Id: Ic8d9c00ae50907f1adad8f70b773e7b1362c4f50
2021-10-05 17:25:28 +02:00
Oliver Smith 581ef10981 d/patches/build-for-debian8.patch: remove
Remove this workaround, as we are not building for debian 8 anymore.

Related: OS#5223
Depends: osmo-ci Ibe7ba124557969df62798ba49c4489e9606c2341
Change-Id: I8285b8c483fe2d136b83946414587fc993d5f489
2021-09-01 16:50:17 +02:00
Oliver Smith 1f1d93cf38 port_numbers: add osmo-pcap-client, -server
Related: OS#5203
Related: libosmocore I098f211370bba61995ce424ab64029bdd4c49e2d
Change-Id: Iebbb07bfa1ecb6597de9925f79eb8e0aff26ae4f
2021-08-05 19:17:27 +02:00
Vadim Yanitskiy 13f502bb6f TRXDv2: add primary/shadow classification for VAMOS PDUs
Introduce a new flag (1-bit field) indicating whether a VAMOS PDU
is for a _primary_ ('0'B) or for a _shadow_ ('1'B) timeslot.  This
field shall be present only in the Uplink VAMOS PDUs, which unlike
the Downlink (AQPSK) PDUs are sent separately.  This will simplify
routing of such PDUs in osmo-bts.

Change-Id: Ie00a12824938c6a65480bde1af364dcc9febb8f7
Related: SYS#4895, OS#4941, OS#4006
2021-06-02 04:36:42 +02:00
Harald Welte 5533b2ee48 glossary: fix various typos I introduced.
Change-Id: Iaf045bd20afb86384e00663df234197eed4d31c4
2021-04-28 17:38:15 +02:00
Harald Welte 2ee1a2f34d Add new common chapter about QoS, IP DSCP and IEEE 802.1q PCP
Related: SYS#5427
Change-Id: Id344c29eda2a9b3e36376302b425e9db1f6c0f28
2021-04-28 12:11:53 +02:00
Harald Welte e87733176f bibliography: Re-introduce RFC768 (UDP)
It's unclear why it was removed in I5fe6263ac666e41cbe34407f09e9023aafa57d2c
when common/chapters/glossary.adoc of this very same repository uses it.

Change-Id: Ib8d2f22450a84ed802b34845ad19a7af8d6b7968
2021-04-28 11:48:36 +02:00
Neels Hofmeyr 619c2cbfd8 bib: add reference to 3GPP TS 45.002, for Training Sequence definitions
Change-Id: I2d72bff8496d7b3a0ad59ce28d6be0fd3f842839
2021-04-22 18:48:55 +00:00
Harald Welte 811f3e8526 build: Switch from rita -> ftp.osmocom.org
We should use service-aliases and not the primary host name, as
that makes migration between machines hard.

Change-Id: Ie139a8cbf2aaa746c0edf6c90a567eb43bc51f45
2021-04-22 11:24:50 +02:00
Vadim Yanitskiy b9ed9473cc TRXD: add documentation for TRXDv2 protocol
Change-Id: I03b2beeb535848b31fd629ba3cd330b43072c08b
Related: SYS#4895, OS#4941, OS#4006
2021-04-15 22:22:36 +02:00
Vadim Yanitskiy 9936a9cbd9 TRXD: generalize description of the 'RFU' ('PAD') field
This field will also appear in TRXDv2 packet diagrams, in several
places.  Let's rename it to 'RFU', because it's actually something
that may want to use in the future, rather than just padding.

Change-Id: I9ac9d387325627d18811fae1d0d7930b69f08129
Related: SYS#4895, OS#4941, OS#4006
2021-04-14 14:59:52 +02:00
Vadim Yanitskiy c799a84974 TRXD: rework description of the NOPE / IDLE frame indication
* Add 'referred to as NOPE.ind', this is how we usueally call it;
 * Change 'IDLE / NOPE' to 'NOPE / IDLE', because:
 ** there can be 'IDLE TDMA frame', but not 'NOPE frame';
 * Avoid using 'high' and 'low' terms for bit values.
 * Introduce and use macros for '0'B and '1'B.

Change-Id: I72e0c785efb8a89b664486740ef312e77b81c01a
Related: SYS#4895, OS#4941, OS#4006
2021-04-14 01:31:33 +02:00
Vadim Yanitskiy 84338b5f76 TRXD: clarify modulation specific length of Soft-/Hard-bits
Change-Id: Icd807810060372c8f27d81f8a825ea9a5f384c1c
Related: SYS#4895, OS#4941, OS#4006
2021-04-13 22:56:10 +00:00
Alexander Couzens ed4f7f2783 common/chapters: extend gb/ns2 chapters
Merge gb-variants.adoc into gb-ns2.adoc
Add a general overview of the internal structure which is also used
by the vty.
Move the configuration into a seperate adoc to allow the PCU manual to skip
the part which doesn't apply for it.
Copy the timer configuration into gb.adoc to allow document newer
timers. All users of the NS2 code will use the timer sub-chapter.

Related: OS#5077
Change-Id: I902b850528cbc04bd469590babd84cccf64300e8
2021-04-12 08:25:19 +00:00
Vadim Yanitskiy 0a5a50b67b fix missing and/or non-existent linked references
Change-Id: I5fe6263ac666e41cbe34407f09e9023aafa57d2c
2021-04-10 05:31:07 +02:00
Vadim Yanitskiy a137f4a47c fix tests/Makefile.am: exclude file 'mgcp_extension_osmux.adoc'
This file is included by 'osmux.adoc', so we end up including it
twice in 'test-usermanual.adoc'.  This makes xsltproc complain:

  /build/tests/test-usermanual.xml:643: element section:
    validity error : ID mgcp-extension-osmux already defined

and sometimes causes sporadic build failures.  Exclude it.

Change-Id: I00efafc822f46126b59d20e86bb07ec991768c28
Related: OS#5112
2021-04-10 04:55:24 +02:00
Harald Welte a7e4cc79a3 add README.md to describe what this repo is about
Change-Id: Ic8d0ff5b81f701debad59b2ba701ff115c6574c3
2021-03-21 22:58:56 +01:00
Pau Espin 940eee143b Bump version: 1.0.0.17-b83a-dirty → 1.1.0
Change-Id: I19eb9c7df3f374a6ccd23638f389e1682549a12d
2021-02-23 12:59:20 +01:00
Vadim Yanitskiy b83aa8aa4d logging: add documentation for 'systemd-journal' target
Change-Id: I04c9f81b10ac56c020f537c3ad52026733b5c620
2021-02-13 08:18:52 +00:00
Vadim Yanitskiy b98c5d6c34 TRXD: more information on PDU versioning and some highlights
Change-Id: Idac4a1c73cc92bf030ea80474c71688bfb706421
Related: SYS#4895, OS#4941, OS#4006
2021-02-12 00:08:22 +01:00
Vadim Yanitskiy ebf6a72346 TRXD: clarify description of NOPE / IDLE indications
Change-Id: Idaa1c597cbfd198a0f1802ac01b210d42369ee95
Related: SYS#4895, OS#4941, OS#4006
2021-02-12 00:07:48 +01:00
Vadim Yanitskiy 5b44519fd3 TRXD: rework description of the 'Training Sequence Code' field
The way how the indicated Training Sequence Code is supposed to be
used by the BTS is behind the scope of this protocol specification.

Change-Id: Ibcb0b6bfff0aa80ed2de563b5e749b7811e7a5c2
Related: SYS#4895, OS#4941, OS#4006
2021-02-12 00:07:48 +01:00
Vadim Yanitskiy ede6098381 TRXD: reserve a combination for Access Bursts on PACCH
Change-Id: I84c68ab899aea2bbc013f98cb41082ab076308a5
Related: SYS#4895, OS#4941, OS#4006
2021-02-12 00:07:48 +01:00
Vadim Yanitskiy f14fb4b949 TRXD: use different coding for AQPSK in the 'MTC' field
AQPSK is used exclusively on Downlink in VAMOS mode.  An AQPSK burst
is basically a combination of two Normal Bursts.  Each of these two
bursts has the same length as defined for GMSK, while both must be
using Training Sequences from different sets.

Four different sets are defined in 3GPP 45.002, section 5.2.3.1.
Therefore we need *two* bits to encode all possible values.  Let's
rearrange the existing combinations and use '11XX'B for AQPSK.  The
old combination '011X'B becomes reserved and can be re-purposed.

This change is considered to be safe, given that no implementations
are known to support AQPSK at the moment of making this change.

Change-Id: Ie9b419e4a70fa0eb2888c326ac50d2d40a67a29c
Related: SYS#4895, OS#4941, OS#4006
2021-02-12 00:07:48 +01:00
Vadim Yanitskiy f09107c5b0 TRXD: clarify the meaning of field 'PWR' in Downlink messages
Change-Id: Idb2a987f9692f0bdc84b40223d5cec2ba3247b9d
Related: SYS#4895, OS#4941, OS#4006
2021-02-12 00:07:48 +01:00
Vadim Yanitskiy 8015ea832b TRXD: cosmetic: clarify soft-/hard-bits on packet diagrams
Change-Id: Ieeb21e07865ab7bf2ac50f908ca50410141e012f
Related: SYS#4895, OS#4941, OS#4006
2021-02-12 00:07:48 +01:00
Vadim Yanitskiy 5d842d41b8 TRXD: fix optional padding length: bits vs bytes
Change-Id: I30327e56558729cccbf627a7fcba04a9f6ac09f1
Related: SYS#4895, OS#4941, OS#4006
2021-02-12 00:07:48 +01:00
Vadim Yanitskiy 9454038f7e TRXC: introduce VAMOS enabled channel combinations
Change-Id: Ic7d4d90df752ded8c778c7b16b22d4d346bf1c9c
Related: SYS#4895, OS#4941, OS#4006
2021-02-12 00:07:48 +01:00
Vadim Yanitskiy 0ab9490f9c TRXC: add proposal for multiple Training Sequences
Change-Id: I621e46edac5d748472fd645f81876116904e260c
Related: SYS#4895, OS#4941, OS#4006
2021-02-11 22:31:27 +01:00