Commit Graph

141 Commits

Author SHA1 Message Date
Neels Hofmeyr 6a13b246e0 bibliography, glossary: add MSC pooling related bits
Add 3GPP TS 23.236, "NRI" and "MSC pool".

Depends: Ia60afc8a91189c9de0d8e8065781ed463bf18d7e (osmo-bsc)
Change-Id: I0640db26dc85ab7723c7160e405fc73f412fd706
2020-06-18 11:23:09 +00:00
Pau Espin b076dc585c trx_if.adoc: Document cmd NOMTXPOWER
TRXC message is implemented in:
osmo-bts.git I682211f3d664c21f923ca4a530e0464ca383b6d9
osmo-trx.git I1d7efe56e008d8d60e23f9a85aa40809f7f84d9c

Change-Id: Idb5bb56fc039c7393922243c761f3395a094a55b
2020-06-02 14:29:59 +02:00
Pau Espin d78c670ee9 trx_if: Clarify {SET;ADJ}POWER TRXC commands
Change-Id: I4f1986a1ace3fc9cbef10fc0508407a3d608670b
2020-06-02 14:26:15 +02:00
Vadim Yanitskiy b01306c59a GSUP: fix E-Routing-Error: both session state / ID IEs are optional
If a message that has triggered the E-Routing-Error contains no
session related IEs, they will also be absent in the error message.

Change-Id: Iaf9d8e77c8734672cfd8a265b8cfdb3bc929a31b
2020-04-19 19:45:17 +07:00
Vadim Yanitskiy 49ab1cb2fc port_numbers: fix: GSMTAP has noting to do with port 2427/udp
Change-Id: Ic37ee2e2da290521ac226a9720d48fbbe0883f3d
2020-04-17 02:05:47 +07:00
Vadim Yanitskiy 0d72300779 logging: fix section 6.5.3: logging level s/all/force-all/ fatal
The special 'all' keyword has been deprecated a long time ago
due to its ambiguity, and replaced by 'force-all'.

Change-Id: I759d96716e964d499c0724d481b2f3e5062fb052
2020-04-17 01:05:44 +07:00
Neels Hofmeyr fef7b5173d add common/chapters/cs7-config
This will be used by the manuals of osmo-bsc, osmo-hnbgw, osmo-msc, osmo-sgsn.

Related: OS#2767
Change-Id: Ia2508d4c7b0fef9cdc57e7e122799a480e340bf7
2020-03-19 19:00:27 +01:00
Harald Welte f29a9f2329 port_numbers: Add missing mDNS port for D-GSM / osmo-hlr
Somehow despite all the warnings everywhere about keeping wiki + code
in sync, this didn't get updated :(

Change-Id: I37e4ea4e6ac8291a36761ecc1849f06847a69557
2020-03-08 10:44:52 +01:00
Harald Welte d8b01c4460 port_numbers: Add osmo-mgw CTRL port
Change-Id: I41de762bbceeaf219d00bdc4e4f2c46c3b11c436
Related: OS#4441
2020-03-08 10:44:04 +01:00
Daniel Willmann 2dc172cff6 bts.adoc: Add information about RACH tuning parameters
Related: OS#2722
Change-Id: I9a6b84cb988be2143672b954e7c6827f691f4a01
2020-01-09 10:55:49 +01:00
Daniel Willmann c2fb037017 bts: Document access control classes and acc ramping
Change-Id: Ia6fbd2da0d03dd372f3d1a34fbed8ac6fc7ed08c
Related: OS#2722
2020-01-06 16:37:50 +01:00
Vadim Yanitskiy 258bbad921 chapters/gsup.adoc: fix message definitions containing gsup-ie-pdpinfo
Change-Id: I7713635e15c1d0680fd8d8c11703683710d9c457
2020-01-03 12:51:35 +01:00
Vadim Yanitskiy d8dd8a7355 chapters/gsup.adoc: further documentation for SM-RP-DA/OA IE coding
Change-Id: I315ae412c83de80f09284c8c1f28faf360ac4662
Related: OS#4324
2020-01-03 12:51:35 +01:00
Harald Welte 293b0faaed Add GPRS
Change-Id: Ib3218c035445875a079f3ef3aa72bbf6d8c668b6
2019-12-26 08:38:14 +01:00
Neels Hofmeyr 117844bc8a D-GSM biblio entries
Change-Id: Ief8dd1998e2445aea41fe9f0c8a98d6cd515c8a5
2019-12-09 13:37:02 +01:00
Harald Welte f1499959dd gsup: Fix description of Purge MS procedure
Change-Id: I5386e438a12edbc6c2ffa3e63400dd2756bb1be6
Closes: OS#1921
2019-12-01 10:18:07 +01:00
Pau Espin b34ffdd069 trx_if.adoc: Fix typo and formatting of bullet list
Change-Id: I45c3ea655139d4777100af02d6b0d9cbf25b02e5
2019-11-22 16:29:58 +01:00
Harald Welte 6084c89831 some more missing items from glossary.
Change-Id: I5b1b06342517042b77a42a57d506c8826b556267
2019-11-20 11:06:27 +01:00
Harald Welte 135fd1159d missing glossary items; mostly MSC/3G related
Change-Id: I61a03badbd63b211821f01ec16f64c28ac495952
2019-11-20 11:03:11 +01:00
Harald Welte 9a47d43e2d typo / stylistic fixes by Tom Tessier
Change-Id: Id3009c0c34dd84ab86ce9d34e7a94e0d1003c1ff
2019-11-20 11:02:52 +01:00
Martin Hauke 6239015e03 Fix some typos
Change-Id: Idd9f9640101816ab979b11cc13ffa12d2245108d
2019-11-11 22:08:00 +01:00
Pau Espin 7758a7fedb sigtran-osmocom.adoc: Fix typos
Change-Id: I31314dd36bac202103483bc93350736bfbc76be1
2019-10-09 18:40:24 +02:00
Pau Espin 35ca68b762 common: trx_if.adoc: Add documentation about TRXDv1 and SETFORMAT
Change-Id: I320539fc9ffb7dd0f09ec18892299bd603cd7a85
2019-07-31 13:13:38 +02:00
Pau Espin c7fb3f28f4 common: trx_if.adoc: Improve documentation
Several fixes and improvements to the documentation.
This documentation still doesn't contain infrmation about TRXDv1, it
will be added in a follow-up commit.

Change-Id: I36e6206b90435964842f9f1ebd982cdaf9777018
2019-07-31 13:13:34 +02:00
Daniel Willmann abadcd5f8a counters-overview: Add a section about the stats reporter
Fixes: OS#3768
Change-Id: Ia338409e6cb1b1478429e3a99158b9d8255dbb2c
2019-07-25 17:26:25 +02:00
Pau Espin 061cca4d73 common: Introduce Osmux documentation
Change-Id: I182d94c63f7d74ef882b77be59a95b1b7d8a4e5e
2019-07-22 10:14:36 +02:00
Oliver Smith 92cf519c8d GSUP: document inter-MSC handover additions
Message formats of the new messages look mostly the same (IMSI,
Message Class, Source Name, Destination Name, AN-APDU). That is, because
AN-APDU is storing results, error reasons etc. This can be seen clearly
in osmo-msc.git:
* src/libmsc/msc_a_remote.c:msc_a_remote_fsm_communicating()
* src/libmsc/msc_i_remote.c:msc_i_remote_fsm_ready()

The message squence charts in the E Procedures section are directly
based on Neels' interMSC_HO_GSUP_msgs.txt [1].

It seems that using AN-APDU made some other new IEs redundant: RR Cause,
BSSAP Cause, Session Management Cause had been added to GSUP for the MSC
handover, and are documented now, but they are currently not used in
osmo-msc.git. The new message OSMO_GSUP_MSGT_E_ABORT is not used either,
so I left a stub for it in the message format section.

I mentioned in the Source Name IE section, that source and destination
names are sent as nul-terminated strings. This is for legacy reasons,
Neels wrote a nice summary in the commit message of [2].

[1] https://osmocom.org/attachments/3720/interMSC_HO_GSUP_msgs.txt
[2] Change-Id: I9ca8c9eef104519ed1ea46e2fef46dcdc0d554eb (osmo-msc)

Related: OS#3774, OS#3619
Change-Id: I6b9f23d08cfe53c8b77f51c6afb900c2badc9e2c
2019-05-21 10:30:38 +00:00
Harald Welte 5c1ac995db port_numbers: Add VTY + CTRL port of upcoming OsmoCBC
Change-Id: I57d88f2bddedb7a97c3fc7bacfe978ed4557c4bf
2019-05-08 15:49:50 +02:00
Daniel Willmann 37a7ce7f1d Change VTY samples from OsmoNITB to OsmoMSC
Change-Id: I9fb3c43ea56087900eee4427f1ae50a7c9e84698
Related: OS#2299
2019-04-15 16:47:18 +02:00
Daniel Willmann 95be64fc37 Add a chapter to explain our different counters
Change-Id: I01b8529136450cb50e48b0fb5c17cb2daa5e24c3
2019-04-15 14:06:32 +00:00
Daniel Willmann ece90c1377 bts: Change VTY sample output from OpenBSC to OsmoBSC
Change-Id: Id473b625f47b3cf7ee10ced866d49eb678161719
2019-04-04 11:31:05 +02:00
Harald Welte 4c946ee293 fix typo: SIGTAN->SIGTRAN
Change-Id: I4b9ed7d61a23cf327889b3e513af74e8c86b161c
2019-03-13 07:59:41 +01:00
Oliver Smith 40c5c2827a chapters/gsup.adoc: move IMEI IEs to right place
Move the "IMEI" and "IMEI Check Result" IEs from the "Session
(transaction) management" chapter (which describes session IEs) to the
"Information Elements" chapter. Add a comment to prevent this mistake in
the future.

Related: OS#2541
Change-Id: I6fd66419350e018a763b8fac3daf567b339a2637
2019-02-22 13:20:11 +01:00
Harald Welte ac42b58909 chapters/gsup.adoc: add message sequence charts for SMS over GSUP
Change-Id: I9a0536f285f98f24fec4d7318f1923782ed2e18c
Related Change-Id: Ie0150756c33c1352bc4eb49421824542c711175c
Related Change-Id: I549b6c8840a1e86caac09e77fb8bc5042d939e62
2019-02-19 18:08:18 +00:00
Oliver Smith 68bbdc5f02 GSUP: message category indicated by last two bits
Make this part of the specification, so we can simplify libosmocore
code by knowing that error message is (request message | 0x000001).

Related: I46d9f2327791978710e2f90b4d28a3761d723d8f (libosmocore)
Change-Id: Iec1b4ce4b7d8eb157406f006e1c4241e8fba2cd6
2019-02-01 16:05:12 +01:00
Oliver Smith 2bca846fab common: extend glossary.adoc
Add EIR, IMEISV, LU, SS, TS, USSD, and VLR, clarify the difference
between IMEI and IMEISV.

Change-Id: I054a8599a78eb5e62ab7af914875e1c8a992af71
2019-01-21 15:08:39 +01:00
Oliver Smith 0f41399d36 chapters/gsup.adoc: document CHECK-IMEI
Related Change-Id: (core) I085819df0ea7f3bfeb0cabebb5fd1942a23c6155
Related: OS#3733
Change-Id: I51dd09cda3c595f1d252546285ced9f06c748617
2018-12-21 16:11:50 +01:00
Oliver Smith c7afad3f4e chapters/gsup.adoc: explain msg format columns
Explain the M, O, C and V, TLV letters in the presence and format
columns.

Change-Id: Idf8614d4d0f462174426fd3afdb34bedfb859951
2018-12-21 16:02:20 +01:00
Vadim Yanitskiy d1596fe75a chapters/gsup.adoc: document READY-FOR-SM message
Change-Id: I549b6c8840a1e86caac09e77fb8bc5042d939e62
Related Change-Id: (core) Ic37f3b2114b8095cfce22977e67133b9103942e3
Related Change-Id: (TTCN) If2256607527ecfcb10285583332fb8b0515d7c78
Related: OS#3587
2018-12-18 00:52:05 +07:00
Vadim Yanitskiy f26967aad5 chapters/gsup.adoc: document MO-/MT-forwardSM messages
Change-Id: Ie0150756c33c1352bc4eb49421824542c711175c
Related Change-Id: (core) Ibe325c64ae2d6c626b232533bb4cbc65fc2b5d71
Related Change-Id: (TTCN) Ibf49474a81235096c032ea21f217170f523bd94e
Related: OS#3587
2018-12-18 00:51:47 +07:00
Vadim Yanitskiy 01814068be chapters/gsup.adoc: fix direction for SS messages
Most likely, this was a copy-paste error. SGSN is not involved
in Supplemeptary Services handling, they are pure CS data.

Moreover, HLR is not the only entity that can initiate both
Process Supplementary Service Error and Response messages,
there is also EUSE (External USSD handling Entity).

Change-Id: I46ad7311747f2b392244c49d3df1e152e6f1bfe3
2018-12-03 07:40:14 +07:00
Max b9bf09ec19 ctrl: clarify use of id = 0
Change-Id: Ic00de5023e7a1ec6426a0178778d35b13c337271
2018-11-26 10:50:42 +01:00
Oliver Smith dc7c08ea08 *.adoc: include from ./common, not ../common
Change hardcoded ../common paths, which will break when moving the
project specific manuals in other repositories, to ./common so they
use the dynamically created symlink that always points to the right
path.

(moving manuals to project repositories 8/19)

Related: OS#3385
Change-Id: Id984f5e85481f7877567ee6d21f7ca455d773ef1
2018-11-21 14:29:11 +01:00
Daniel Willmann 6e5b7d3cdc Logging: Describe all log options, including set-all and force-all
Change-Id: Ica03c3ea08289314819448a22ae7ed38a7bd4f83
2018-11-18 20:06:00 +00:00
Daniel Willmann 987aa54d56 common/chapters/bts: Remove duplicate spaces in text
Change-Id: I38f3e94342461f494ef547bcdccd2594c30e679d
2018-11-18 20:06:00 +00:00
Daniel Willmann b7b5ce0a28 Change OpenBSC mentions to OsmoBSC where applicable
Change-Id: I4cc6874302b6089a54d44b09f08660a25e46d4dc
2018-11-18 20:06:00 +00:00
Daniel Willmann 4d3e83f785 VTY: Remove osmo-nitb VTY port number example
We reference the port list appendix where all the ports used by various
Osmocom projects are listed and it's unlikely that pointing out the
osmo-nitb port would significantly help the reader, so just remove the
reference.

Change-Id: I354d50314ba248835191fa3da122032201618a0e
2018-11-18 20:05:02 +00:00
Daniel Willmann 34837943d7 OsmoBTS: Print VTY command in fixed-width font
Surrounding with '@' didn't seem to yield the intended result, the
charactars appeared in the compiled document.

Change-Id: I66e7949fa4a6c2164bf9572a2beaf8ace169fa1c
2018-11-18 20:04:53 +00:00
Daniel Willmann a400b9598f Abis: Change abisip-find/ipaccess-config path to osmo-bsc repo
Change-Id: I4b92a611abd6e92ad69f77f8ec81a6501224afe5
2018-11-18 20:04:53 +00:00
Harald Welte aea2086fd4 add SGs / CSFB related dot + msc files
Those graphs + message sequence charts are not yet used by any
of our manuals, but they should become used by the OsmoMSC user
manual once SGs interface support is added.

Related: OS#2583
Change-Id: Idfd3a66c18131b5458d183b8e66f62eaaab65991
2018-10-05 23:42:49 +02:00