Commit Graph

163 Commits

Author SHA1 Message Date
Vadim Yanitskiy 82a2a8d9b4 doc/examples: fix missing config files in release tarballs
All config file examples must be listed in EXTRA_DIST unconditionally.
Adding them conditionally results in incomplete release tarballs,
containing only 'osmo-bts-virtual.cfg' and failing to build.

Change-Id: I167027afde3cee40a3b52adfaec7bde91ba896da
Related: OS#6349
2024-01-28 23:16:42 +07:00
Andreas Eversberg bc4ca18a31 Use uniform log format for default config files
Related: OS#6272
Change-Id: I08b297ea78e7cd60f28f0df79f2096f70c0692c6
2023-12-01 11:50:12 +01:00
Vadim Yanitskiy bb596dddc7 osmo-bts-trx: visualize rx_tch[fh]_fn() functions
Change-Id: I373dbbc3d427858f76d07ff85633e07fe2600770
Related: OS#1572
2023-07-13 03:42:29 +07:00
Oliver Smith 9b88fd8481 doc: rsl: add RSL_IE_IPAC_RTP_CSD_FORMAT
Add documentation for rsl_ipac_rtp_csd_format_d/_ir from
libosmocore.git, include/osmocom/gsm/protocol/gsm_08_58.h and
wireshark.git, epan/dissectors/packet-rsl.c.

Related: OS#4393
Change-Id: Ic8f40076698f2b341cc0096fd96ba2051a41f077
2023-03-14 09:59:15 +00:00
arehbein d28ce3287f doc: Adapt to use of 'telnet_init_default'
Related: OS#5809
Change-Id: I1ae5a7169d864e5dbd052437addd167ffa2c510d
2023-02-25 02:04:18 +01:00
Max 757180beba Add SI10 support
Related: OS#5783
Change-Id: I268ba716ded330a024a8f3c0d1bd2f28622cecab
2023-02-01 11:12:32 +00:00
Max 9b7a48421c Don't manually create pid file
Previously osmo-bts created /var/run/osmo-bts.pid which
isn't used by anything and makes it hard to run as non-root
user. Let's get rid of this pre-systemd relic.

Related: OS#4107
Change-Id: I86bcaedbc8cb1297476ad741eaa45585fea3c380
2022-09-14 08:30:11 +00:00
Pau Espin 2201900f94 Introduce Osmux support
Related: SYS#5987
Requires: libosmo-netif.git Change-Id I632654221826340423e1e97b0f8ed9a2baf6c6c3
Change-Id: Ib80be434c06d07b3611bd18ae25dff8b14a7aad9
2022-09-13 17:32:22 +02:00
Pau Espin 7a2f307246 doc: rsl: Fix description of 'IP Connection Statistics' IE
Related: SYS#5915
Change-Id: Ic524d73a0c47fde528b78f9dfe7b72b7286550e1
2022-04-04 19:27:59 +02:00
Martin Hauke 7bb7889012 osmo-bts-trx-calypso.cfg: Adjust settings to work with current osmo-bts versions
* Remove deprecated configuration options:
  'osmotrx timing-advance-loop' is deprecated, Timing Advance loop is now active by default
  'osmotrx ms-power-loop <-127-127>' is deprecated, MS Power Control is now managed by BSC
* Adjust 'ipa unit-id' (1801 -> 6969) to match the one from the example osmo-bsc.cfg
* Set clock advance values to known working values:
  + 'osmotrx fn-advance' -> 20
  + 'osmotrx rts-advance' -> 5
* Set 'nominal-tx-power' since the calypso-bts tranceiver does not support NOMTXPOWER

Change-Id: I69436b914cf1bec57f9fe7acea4a896e7c46b3a9
2021-11-01 15:29:02 +01:00
Vadim Yanitskiy 72d9981cd0 osmo-bts-trx: refactor 'maxdly' / 'maxdlynb' commands
* Move way too verbose command description to the manuals.
* None of these commands apply immediately, correct the attributes.
** Remove meaningless call to l1if_provision_transceiver_trx().
* Make 'maxdlynb' hidden, so it only appears in the expert mode.
* One GMSK symbol actually corresponds to 550m.

Change-Id: I46839cf56bba2dcdc70303cd393e86d35aa2f3f5
2021-10-13 20:01:08 +00:00
Pau Espin dfedf2cb76 phy_link: Introduce bts_model_phy_link_close() and use it in bts-trx
This step is required while turning off the BTS without killing the
process. Right now only osmo-bts-trx supports this feature, so this
function is only available and used by osmo-bts-trx.
Later on, when the feature is support more generally, we can move call
to this function to common place like bts_shutdown_fsm or alike.

Change-Id: I3253112700a31b85db82dc7ccadec8542bac745e
2021-09-23 12:07:29 +00:00
Vadim Yanitskiy 471df615e2 manuals/abis/rsl.adoc: clarify RF Resource Indication conformance
Change-Id: Ia582c55c3c20f1f91993b3113d77ef2f34ca2eda
Related: SYS#5313, OS#1569
2021-07-05 12:07:55 +00:00
Pau Espin a4b9073989 Rename osmo dyn ts enums to contain SDCCH8
They will gain support to be activated as SDCCH/8 soon too.

Related: SYS#5309
Depends: libosmocore.git I56dcfe4d17899630b17f80145c3ced72f1e91e68
Change-Id: Ia617d20fc52f09dbab8f4516c06fa1efac08e898
2021-07-05 08:03:08 +00:00
Vadim Yanitskiy 0e8d68437a osmo-bts-trx: implement BCCH carrier power reduction mode
The BCCH carrier (sometimes called C0) of a BTS shall maintain
discontinuous Downlink transmission at full power in order to
stay 'visible' to the mobile stations.  Because of that, early
versions of 3GPP TS 45.008 prohibited BS power reduction on C0.

However, in the recent 3GPP TS 45.008 there is a feature called
'BCCH carrier power reduction operation'.  This is a special
mode of operation, where the variation of RF level for some
timeslots is relaxed for the purpose of energy saving.

In BCCH carrier power reduction operation, for timeslots on the
C0 carrier, except timeslots carrying BCCH/CCCH, the output power
may be lower than the output power used for timeslots carrying
BCCH/CCCH.  In this case the maximum allowed difference in output
power actually transmitted by the BTS is 6 dB.

The power reduction operation can be controlled by the BSC by
sending BS POWER CONTROL on the A-bis/RSL with the Channel Number
IE set to 0x80 (RSL_CHAN_BCCH).  This makes osmo-bts reduce the
transmission power on inactive timeslots of the BCCH carrier.

This is a non-standard, Osmocom specific extension, so indicate
support of this feature to the BSC in the feature vector.  Also
add a VTY command to allow enabling/disabling the power reduction
locally.  Add some signalling notes to the A-bis/RSL manual.

For more details, see 3GPP TS 45.008, section 7.1.

Change-Id: I3dcee6e910ccc61c5c63c728db9ea04327e2fc98
Depends: I69283b3f35988fc7a1a1dcf1a1ad3b67f08ec716
Related: SYS#4919
2021-07-01 02:01:22 +02:00
Pau Espin b53a84ac75 doc: rsl.adoc: Fix trailing whitespace
Change-Id: Ibc93a87ad51c77fff08ecc54dcc01784756fb39f
2021-06-29 12:13:59 +02:00
Vadim Yanitskiy d4efc3f9c5 Report interference levels in RSL RF RESource INDication
This change implements general interference averaging logic for
the higher layers.  In l1sap_info_time_ind(), where we receive
TDMA time updates from BTS model, call rsl_tx_rf_res() for each
transceiver according to the interval defined by the Intave
parameter received from the BSC.  In rsl_tx_rf_res() perform
the actual averaging for each inactive logical channel, and
then send everything to the BSC over the A-bis/RSL.

The BTS model specific code needs to report the measurements
for each logical channel every 104 TDMA frames (SACCH period)
by calling gsm_lchan_interf_meas_push().

Change-Id: Id80fdbef087de625149755165c025c0a9563dc85
Related: SYS#5313, OS#1569
2021-06-18 18:56:57 +02:00
Vadim Yanitskiy f6716bf846 manuals/abis/rsl.adoc: add VAMOS specific Channel Number values
Change-Id: Ib3ad7652dfcbd104d25b031ac89f5491da2673a6
Related: SYS#4895, OS#4941
2021-06-04 20:05:20 +00:00
Vadim Yanitskiy 510fb2e2b8 manuals/abis/rsl.adoc: add missing CBCH Channel Number values
Change-Id: Iab64c35a384978ba2eb1878f619de2c3827cd8c5
Related: SYS#4895, OS#4941
2021-06-04 20:05:20 +00:00
Vadim Yanitskiy 8cb5a25874 manuals/abis/rsl.adoc: rework Channel Number description
Change-Id: I3013c6b2c38db33d7d80e174b3d4910f8b01963d
Related: SYS#4895, OS#4941
2021-06-04 20:05:20 +00:00
Vadim Yanitskiy c5844779e8 manuals/abis/rsl.adoc: s/TS 08.58/TS 48.058/
Change-Id: Iae8e184f98f089c95dce4c51f512971521c4b059
Related: SYS#4895, OS#4941
2021-06-04 20:05:20 +00:00
Harald Welte 1896c8f03e manuals: Update copyright years
Change-Id: I353013ddfc8c5506599e723e713d93f3f041f15d
2021-04-30 08:24:00 +02:00
Harald Welte 75f56805e0 manual: Remove manual revision history; we don't use it anywawy
Change-Id: I25c4d8b694756c6eed81c9b552a389ca5bd04ea7
2021-04-30 08:24:00 +02:00
Harald Welte 134062e335 manual: Include QoS chapter and add osmo-bts specific example
Change-Id: I8fcd524c550b43a851b3094effc215e5203d28be
Requires: osmo-gsm-manuals.git Id344c29eda2a9b3e36376302b425e9db1f6c0f28
Requires: libosmo-abis.git I8991dd6eb406a5b9a70498974fc1ad339452f871
2021-04-30 08:24:00 +02:00
Neels Hofmeyr 823cd52964 Abis manual: add RSL_IE_OSMO_TRAINING_SEQUENCE
Change-Id: Ie583bd5969fdb45f772af198033e58d7c4077306
2021-04-22 20:45:02 +02:00
Neels Hofmeyr 7177e666bb Abis manual: add VAMOS to BTS features
Change-Id: I108e3300e96087f4be47bd9ea237a9d28982839f
2021-04-22 20:45:02 +02:00
Neels Hofmeyr 6072be9be4 Abis manual: add Get Attributes, add BTS features
Change-Id: I99631272334537ab49ba8c530240aaeb67dde9d7
2021-04-22 20:44:51 +02:00
Neels Hofmeyr 93b04aa4c3 Abis manual: s/TS 12.21/TS 52.021
Change-Id: I662a3419a6ec741fe162ccc7c7221df20b2780b1
2021-04-21 16:15:01 +02:00
Neels Hofmeyr b03ff89876 osmobts-abis.adoc: add missing bibliography
Change-Id: I6a86416466eba14090026a3e6ec82a0e8548209a
2021-04-21 16:15:01 +02:00
Vadim Yanitskiy 9cf65a7af5 manuals: document new 'gsmtap-remote-host' command
Change-Id: I7f75fbac77a612493ce187cfac3c4ae203c81b23
2021-04-18 06:53:33 +00:00
Vadim Yanitskiy 078682d7b5 manuals: remove deprecated command line parameters
Change-Id: Ie49abeb9647e3c8abdc9e110ab1a71c116f5def6
2021-04-18 06:53:33 +00:00
Vadim Yanitskiy cabfbf470f manuals: document GSMTAP 'enable-all' / 'disable-all'
Change-Id: Iadbcf9d3184ab17c11c51e191aa3e80665839c22
2021-04-16 14:53:57 +00:00
Vadim Yanitskiy 1334316844 manuals: fix wrong VTY node for 'gsmtap-sapi' command
Change-Id: Ifcf1cf9cdbad40862d48415e004865a91a61d1b1
2021-04-16 14:42:55 +00:00
Vadim Yanitskiy ffce0e45a5 doc/examples: enable stderr logging for osmo-bts-virtual.cfg
Shippig configuration examples with disabled logging is... not ok.

Change-Id: Iecb62b3537afe8906f6f816bfa7cc79b12a1ca26
2021-03-09 11:14:23 +01:00
Vadim Yanitskiy 9fa152a981 doc/examples: remove obsolete power control parameters
We should not have deprecated parameters in configuration examples.

Change-Id: I77cbe68023aa15ccf9829ef14c8cc7bccc84b58d
2021-03-09 11:06:08 +01:00
Philipp Maier ff96c5d16c rsl.adoc: update documentation for RSL_IE_OSMO_REP_ACCH_CAP
The recently added IE (RSL_IE_OSMO_REP_ACCH_CAP) has been extended
with more options, update the documentation as well.

Change-Id: I3d95da588e863185bb62e92898c285d52bce9af4
Related: SYS#5114, OS#4796, OS#4794, OS#4795
2020-11-27 16:02:45 +01:00
Philipp Maier 70d78f21f2 rsl.adoc: add info about RSL_IE_OSMO_REP_ACCH_CAP
The RSL documentation should reflect some explanatory info about the
recently added RSL_IE_OSMO_REP_ACCH_CAP IE.

Depends: libosmocore I61ea6bf54ea90bd69b73ea0f0f3dc19a4214207b
Change-Id: I1d70846c2c184f7a189074c51137bc1f38fb3859
Related: OS#4796 SYS#5114
2020-11-10 21:25:40 +01:00
Vadim Yanitskiy 5e92f628ab doc/manuals: move osmobts-vty-reference.xml to vty/
This way we have everything VTY specific in a single directory.

Change-Id: Iaba5c42b39fa764cd38c903486617c3d9f9cdebb
Related: SYS#4937, OS#3036
2020-11-05 03:39:50 +07:00
Vadim Yanitskiy ace1ca46a7 doc/manuals: also generate VTY reference for osmo-bts-virtual
Change-Id: I12ac8cc13ce0caea2b63f94c407c01b4f00845e5
Related: SYS#4937, OS#3036
2020-11-05 03:39:50 +07:00
Vadim Yanitskiy a75b402f55 doc/manuals: generate XML VTY reference at build-time
Unfortunately, we cannot re-use the existing Makefile rules from:

  $(OSMO_GSM_MANUALS_DIR)/build/Makefile.vty-reference.inc

because they do not allow to generate the list of $(DOCBOOKS) from
a template, and require the project to store everything in separate
folders with specific names.  Also, those rules expect that the
target PDFs contain only a single word in their names (for example,
'osmoapp-vty-reference', not 'osmo-app-vty-reference'), while in a
project with multiple similarly named targets this would reduce
readability (imagine 'osmotrxuhd-vty-reference').

Change-Id: Idba84164b90e3d183a20b5eb69cbfe15745e447c
Depends: I6aac73d998c5937894233631e654a160d5623198
Related: SYS#4937, SYS#4910, OS#3036
2020-11-05 03:39:50 +07:00
Daniel Willmann 624b5cdc22 osmo-bts-trx: Use much lower clock advance values towards PCU and TRX
osmotrx fn-advance (which is the clock_advance variable here) and
osmotrx rts-advance together make up the minimum delay the BTS can react
to a channel request, etc.

The default of 20 are around 92ms which is clearly too much. With
modern hardware and using SCHED_RR a lower value should not be an issue.

See OS#4487 for some related measurements on more CPU-limited devices like a
LimeNet-micro3.

Fixes: OS#4487
Fixes: SYS#4885
Related: SYS#4881
Change-Id: I7da3d0948f38e12342fb714b29f8edc5e9d0933d
2020-08-17 19:11:19 +02:00
Pau Espin c131ce45ba common: Support setting rt prio through new libosmovty sched VTY cmds
We gain other features from libosmovty for free, like configuring
cpu-affinity of the only thread in the process.

Depends: libosmocore.git Change-Id If76a4bd2cc7b3c7adf5d84790a944d78be70e10a
Depends: osmo-gsm-masnuals.git Change-Id Icd75769ef630c3fa985fc5e2154d5521689cdd3c

Related: SYS#4986
Change-Id: Ice46e406b84fa11afcc7ba31e521e7677df73cf3
2020-08-10 20:10:50 +00:00
Pau Espin 3d5cf0b341 doc: configuration.adoc: Document ramping down feature
Change-Id: I3c7df0d914587bdde2aef9919f75d507a0e5884b
2020-07-28 11:12:52 +02:00
Pau Espin 6f71a959b9 doc: Fix typos in bts-models.adoc
Change-Id: I05c9eb9b0edda528363a16d27dbf683994d9ab62
2020-06-16 12:42:30 +02:00
Vadim Yanitskiy aa5e46dc9a doc/examples: remove virtual/openbsc-virtual.cfg
This is not the right place to ship configuration examples for
other projects, and definitely not for abandoned ones.

Change-Id: Ib165b16f948126df8023bb42ad5d6d4b2fc11e6a
2020-06-05 20:56:24 +00:00
Pau Espin 01342bce4a doc: Update vty reference xml file
Change-Id: I26c6522e6b5b87030dde61afacd637ff38b12303
2020-06-01 20:15:54 +00:00
Vadim Yanitskiy f938e91bd0 doc/manuals: fix typo in interfaces.adoc: s/Omsocom/Osmocom/g
Change-Id: I28d914f89a6de82a8e226a9772984cb0c9d8869a
2020-05-31 03:48:47 +07:00
Philipp Maier dbb5addf7d osmo-bts-trx: do not set rx-gain to 1 by default
The sample configs supplied within the doc/trx directory set the
rx-gain parameter to 1. A low value like this may cause a noticeable
degration of rx performance (For an USRP B200 an rx-gain of 38dbm is
recommended). Lets remove this seting from the sample configuration to
allow the default settings in osmo-trx to be applied.

Change-Id: I76be1739b638b3c1b0de5ac667eed53397631caa
Related: OS#4467
2020-03-23 17:18:51 +00:00
Pau Espin 6ea3b28321 cosmetic: Fix some typos with codespell
Change-Id: I1bbb4871f764816dcbba86d833194be601fa9228
2020-02-25 18:51:15 +01:00
Oliver Smith ae5e1d7110 osmo-bts-virtual.cfg: ms-power-control dsp -> osmo
Fix error while starting osmo-bts-virtual with the example config:
"This BTS model has no DSP/HW MS Power Control support"

Fixes: c693067b7e ("Introduce BTS feature BTS_FEAT_MS_PWR_CTRL_DSP")
Change-Id: I4f9a06e85d58294719a24197eb1c42a69fbd03d6
2019-11-19 18:28:32 +00:00