Commit Graph

2054 Commits

Author SHA1 Message Date
Harald Welte d7f1457bed rtp-amr.adoc: TCH/AFS Uplink
Add new chapter by Nutaq for Speech Frame Following a SID_FIRST frame

Change-Id: Ib7cfb07525ea311d9dac051a6e139b0ae0549504
2018-11-27 17:54:20 +01:00
Harald Welte 529c1f04cb Documentation on AMR RTP in case of DTX
Change-Id: I394f405b441c1eb000759151bd8350d5b3a84a0b
2018-11-27 17:54:20 +01:00
Neels Hofmeyr 8be01aac1e fix build: abis: re-add dependencies
Below commit accidentally removed osmobts-abis.pdf from the Makefile entirely.
The pdf was re-added, but the dependencies are still missing, so that
osmobts-abis.pdf is not rebuilt when abis/* is newer. Fix that.

Culprit: 05f5adbe837f2cbfb9301cdb8c9b454ca0bfc825
"OsmoBTS: add vty reference documentation"

Half-fix: 707827196f0734eefa74ce0c35c2ab2fe754cc4c
"OsmoBTS: generate osmobts-abis.pdf again"

Change-Id: Id2ee8177cfb8eb58409d164bdd994ef5e86ad82b
2018-11-27 17:54:20 +01:00
Neels Hofmeyr c1ac0d8b6a OsmoBTS/abis/rsl: split dyn TS ladder diagrams to fit on page
Split both of the lengthy mscgen generated ladder diagrams in two so that the
diagrams are split over two pages and don't bleed into the page footer.

Change-Id: If90250123a85cd275f07c69ee64c6e10a7269f06
2018-11-27 17:54:20 +01:00
Alexander Couzens 2c160a5dc4 OsmoBTS: generate osmobts-abis.pdf again
broken by 05f5adbe837f2cbfb9301cdb8c9b454ca0bfc825

Change-Id: I7ca18e3d7fa3a5a6eac0590b919b4c664f73671c
2018-11-27 17:54:20 +01:00
Neels Hofmeyr a4683812ed fix 'make clean': shell glob, ignore failure
Unfortunately a glob like osmo-x__*.{svg,png} doesn't work, so have the
suffixes in separate globs.

Add dashes to indicate that failure should be ignored.

Change-Id: I6bc4d9ea72b43a573acbc860c23397f748de2c7b
2018-11-27 17:54:20 +01:00
Neels Hofmeyr 8580b9717f OsmoBTS/abis/rsl: combine separate dyn ts sections
There were two separate sections saying basically the same. Move the
entire 'Dynamic Channel Combinations' section further above and combine
with the 'IPA Style PDCH Management' section to avoid repetition.

Change-Id: Ic370ba34de5cb14f0194ff8c8661e45d7ca98e2b
2018-11-27 17:54:20 +01:00
Neels Hofmeyr 236e9d575e add 'make check' target
Generate *.check files from asciidoc output and grep for WARNINGs.
Add *.check files to gitignore and to 'make clean'.

Change-Id: Ibccc83a3415930a528f2e8e4e4dda3b81c6d0b64
2018-11-27 17:54:20 +01:00
Neels Hofmeyr 3537fa6224 make clean: also remove generated image files
Change-Id: I80798e79b4ccee64f26f58f9754de02b2958e33e
2018-11-27 17:54:20 +01:00
Neels Hofmeyr 8b633e885b OsmoBTS/abis/rsl: add missing info for Osmocom Dyn Channels
The section 'Osmocom Style Dynamic Channels' ended in mid-sentence without
naming any of the hard facts. Complete that.

Add section links.

Change-Id: Ib92895fe1bb89fb1b14dc8fcbd88b98bbb6edeee
2018-11-27 17:54:20 +01:00
Neels Hofmeyr e332b4ca4e OsmoBTS/abis/rsl: cosmetic: 'IPA style'
Consistently name the PDCH act methid 'IPA style', name ip.access only once
in the 'IPA Style Dynamic Channels' section.

Consistently write 'IPA style' without hyphen (not 'IPA-style').

Capitalize section headers ('IPA Style').

Change-Id: I91112c2d8af9424ebe7e1972fd4ef9c77d24a7b4
2018-11-27 17:54:20 +01:00
Neels Hofmeyr de954a1aa0 OsmoBTS/chapters/configuration.adoc: fix index numbering
Change-Id: Ibe507fe36e0130377dec361d56fd75596ca64e75
2018-11-27 17:54:20 +01:00
Neels Hofmeyr e834518123 osmobts-usermanual.adoc: fix link to abis.adoc chapter
The chapter is in ../common/chapters, not in ./chapters

Change-Id: I698d83e96cb77900b99a0bd383587b1b68182efb
2018-11-27 17:54:20 +01:00
Neels Hofmeyr 9c74ccc4c8 OsmoBTS/chapters/dynamic-timeslots.adoc: Remove obsolete links
Those file never existed and the ladder diagrams are instead at
OsmoBTS/abis/dyn_ts*msc.

Change-Id: Icbae85b959e80afe7f272a11f33064a3e594da53
2018-11-27 17:54:20 +01:00
Neels Hofmeyr 2729bcfb93 OsmoBTS/abis/rsl.adoc: fix missing section header
In effect, this fixes the dangling references from the table of RSL messages
with additions/limitations to the Chan Act message description.

Change-Id: Ic6f83f016ce9ec90af7eb0af1b1f71a10263915d
2018-11-27 17:54:20 +01:00
Alexander Couzens ad4866b35f OsmoBTS: add vty reference documentation
Including the required changes of the Makefile which is now simliar
as the other projects Makefile's.
Based on: OsmoBTS 0.3.0.283-f869

Change-Id: Id7362ce1c584b1926330b93770d68453e091c71c
2018-11-27 17:54:20 +01:00
Neels Hofmeyr 00d13cf84c OsmoBTS/abis/dyn_ts_osmocom_style.msc: adjust PDCH Act ack
The act ack for switchover to PDCH is now issued immediately, after
commit 'dyn TS: if PCU is not connected, allow operation as TCH'.
Adjust the chart accordingly.
2018-11-27 17:54:20 +01:00
Neels Hofmeyr 00ad09612e OsmoBTS/abis/rsl: fix subtitle for ladder diagram of osmo dyn switchover 2018-11-27 17:54:20 +01:00
Daniel Willmann e10b4d3713 Add section about configuring power-ramping 2018-11-27 17:54:20 +01:00
Harald Welte 51c04e0fd7 osmobts-abis: Add Revision log regarding dynamic cannels 2018-11-27 17:54:20 +01:00
Harald Welte 7a3ec76a2f spelling: message discriminator, not descriminator 2018-11-27 17:54:20 +01:00
Neels Hofmeyr c03c9c81fb Document dynamic channels on Abis, both IPA and Osmocom style
Based in ladder diagram and WIP wording for IPA style from Neels
Hofmeyr, completed by me.
2018-11-27 17:54:20 +01:00
Neels Hofmeyr 47d5ba4012 OsmoBTS: hardware support: remove dup, tweak wording
Don't mention the common part twice.
Use plural for hw specific parts.
No commata before 'and'.
2018-11-27 17:54:20 +01:00
Neels Hofmeyr a998d1040a OsmoBTS: wording tweak 2018-11-27 17:54:20 +01:00
Neels Hofmeyr 8f1eae6642 OsmoBTS: typos
'3GPP specified': when talking about written information, one usually uses
the present tense '3GPP specifies'.
2018-11-27 17:54:20 +01:00
Neels Hofmeyr b14f6569fd abis/oml.doc: remove duplicate sentence part 2018-11-27 17:54:20 +01:00
Max e61a2eb734 Add OsmoBTS control interface description 2018-11-27 17:54:20 +01:00
Jonathan Brielmaier 1454a2c752 fix various typos across all manuals 2018-11-27 17:54:20 +01:00
Neels Hofmeyr bfb1257dce OsmoBTS: explain IEs marked 'ignored' *and* 'Received' 2018-11-27 17:54:20 +01:00
Neels Hofmeyr e0064a8d2a OsmoBTS: s/content of this attribute/this attribute/ 2018-11-27 17:54:20 +01:00
Neels Hofmeyr d7c4778aca OsmoBTS: fix typos, streamline language style 2018-11-27 17:54:20 +01:00
Neels Hofmeyr f450f40c12 OsmoBTS: typo x2 ('Objects Classes' -> 'Object Classes') 2018-11-27 17:54:20 +01:00
Holger Hans Peter Freyther 0078ba7af2 OsmoBTS: Fix the author name and mail address 2018-11-27 17:54:20 +01:00
Harald Welte 391c057769 Add link to Asciidoc source code of manual 2018-11-27 17:54:20 +01:00
Harald Welte 524fdd3ac8 initial checkin of manuals to public repo
The manuals existed in different form for several years in an internal
sysmocom repository.  However, since they had just recently been
converted from docboox-xml to asciidoc and all files have been
re-shuffled for enabling the public release, there's not much point in
keeping the history with git-filter-branch.
2018-11-27 17:54:20 +01:00
Neels Hofmeyr a6a18b66ee Importing history from osmo-gsm-manuals
Change-Id: I99bf0fcac4059d3eb8274ff5ee79b490efbdda59
2018-11-27 17:53:51 +01:00
Pau Espin e3cb8715f5 bts_model: Allow TS connect to be processed asynchronously
This commit doesn't change internal logic of any model, only the API to
be able to return result of connect TS asyncrhonously since some models
(like osmo-bts-trx) require some time to process the result. This way
PDCH ACT/DEACT (N)ACK can be sent once the result of this long process
is known. For instance, nowadays in osmo-bts-trx we PDCH (DE)ACT ACK
before getting the result from SETSLOT on the TRX iface.

With this new API, bts_model_ts_connect doesn't return any value
synchronously. Instead, it is expected to always end up calling
cb_ts_connected with the return code from the TS activation process. 0
is considered a successs, while any other value is considered an error.

Change-Id: Ie073a4397dd2f1a691968d12b15b8b42f1e1b0cf
2018-11-26 14:08:14 +01:00
Pau Espin 47c8f37c9f cosmetic: fix whitespace
Change-Id: Iaa4552844db33fe69da5ed7028dbfa0100c33900
2018-11-26 14:08:14 +01:00
Pau Espin 3c12325d28 bts-trx: early return on POWERON success
Later on it's expected to add more rsp parsing, so let's return here and
not depend on generic return further down.

Change-Id: I8ddee46374ab329c47dc68e720e236f13d393f66
2018-11-23 17:44:13 +01:00
Pau Espin 133a3d96dc rsl: Avoid sending ipa PDCH DEACT NACK followed by ACK
It was spotted during osmo-gsm-tester test
dynts:trx-sysmocell5000+mod-bts0-dynts67-ipa+cfg-codec-fr-any that
osmo-bts-trx was answering to PDCH DEACT from BSC first with a NACK
followed immediatelly after by an ACK. That happens after the test does
a GPRS pdp ctx act successfuly and then deactivates the ctx and the 2 MS
try to place a call between them (and thus channels need to be moved to
TCH/F).

Most probably the if condition where the lines for this commit are
modified need to be fine-grained. Patch before this one should help to
understand the steates/situation in this scenario, and then a follow-up
patch can be created to improve the logic.

Change-Id: I91c65da6b6b7094f32187d3b083153a87c3219fd
2018-11-23 16:58:18 +01:00
Pau Espin 52fdef79cc rsl: Log lchan state during dynts PDCH->TCH
Change-Id: Iee5ac0550afda71fce67b0340749c111b364bb4f
2018-11-23 16:47:39 +01:00
Max ecfb83d3cc Drop unused function
Change-Id: Ib1ecc6dcb243da27976ca0e90a83aefa18a65b76
2018-11-22 10:54:37 +00:00
Max faf501e432 Fix type mismatch
llist_count() return unsigned value, let's use it for counter as well.

Change-Id: I81097a64ef694bec046afcc23cf995dc539a706b
2018-11-22 09:02:41 +00:00
Vadim Yanitskiy 70eb683622 Fix deprecated gsm_arfcn2band(), use gsm_arfcn2band_rc()
Change-Id: I45aae70f4bc3f4f85d267dafb757debdef1bb7d7
2018-11-22 15:30:46 +07:00
Vadim Yanitskiy 07af4e1751 common/vty.c: fix deprecated osmo_str2lower() usage
Change-Id: I4f78bc13908c2d9dfbe24195ae6e35fae8575c59
2018-11-22 14:15:17 +07:00
Pau Espin 6dacc35c75 bts: Fix TRX0 param initialization
TRX0 is allocated in a different place than other TRX.

Commit that introduced the bug added an initialization step
(bts_trx_init) applied in VTY cmd "trx <0-254>", where TRX are allocated
since same commit, but doesn't initialize TRX0 for reasons explained in
first paragraph.

As a result, some parameters were not applied to TRX0, like
power ramping increment step, which prevented MS from finding the network in
osmo-gsm-tester tests.

Fixes: eebb6a4216 ("bts: Allocate TRX for BTS dynamically, deprecate -t")
Change-Id: I5afd66548634ff53e2af24dc7055d408ca8ca4e3
2018-11-21 19:59:21 +01:00
Pau Espin 36a61df7a6 bts-trx: Allow re-try without exit if POWERON fails in osmo-trx
If POWERON fails, announce to BSC that the TRX is not available, and
announce it as available as soon as POWERON success is received.

Related: OS#3692
Change-Id: Iaa8f497381038fd7f9f779a8211ebc6453837c65
2018-11-20 10:41:43 +01:00
Pau Espin 825797cfcb common: Implement OML for trx_set_available(1)
Related: OS#3692
Change-Id: I1ba32c162a8a98ed0fdd4190227de66270679e5a
2018-11-20 10:40:09 +01:00
Pau Espin 9d17840f83 bts-trx: setup timer once at creation time
The setup is only needed once, so no need to set it every time we want
to schedule it.
Furthermore, it will ease new code introduced in follow-up patches,
which will schedule this timer under some circumstances without need to
send a message at the same time (because re-try of a cmd after a delay
is wanted).

This commit adds an alloc function and an init function to keep
different parts of the code decoupled and avoid exposing more
implementation details between them (like exposing the trx_if timer).

Change-Id: I3b6461d0130d25284e673c5efce0b3832c48bbb5
2018-11-20 10:37:58 +01:00
Stefan Sperling fc2ff394e0 add missing check of osmo_wqueue_enqueue() return value
The return value of osmo_wqueue_enqueue() isn't checked.
This can result in a memory leak if the message cannot
be enqueued. Log an error an free the message upon failure,
as done elsewhere.

Change-Id: I5671ca364f31d98f2b28d028e7bf1797386de2ec
Related: CID#57662
2018-11-19 12:21:05 +01:00