path: root/doc
AgeCommit message (Collapse)AuthorFilesLines
2021-11-01osmo-bts-trx-calypso.cfg: Adjust settings to work with current osmo-bts versionsMartin Hauke1-4/+5
* 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-10-13osmo-bts-trx: refactor 'maxdly' / 'maxdlynb' commandsVadim Yanitskiy1-1/+26
* 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-09-23phy_link: Introduce bts_model_phy_link_close() and use it in bts-trxPau Espin Pedrol1-0/+1
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-07-05manuals/abis/rsl.adoc: clarify RF Resource Indication conformanceVadim Yanitskiy1-5/+5
Change-Id: Ia582c55c3c20f1f91993b3113d77ef2f34ca2eda Related: SYS#5313, OS#1569
2021-07-05Rename osmo dyn ts enums to contain SDCCH8Pau Espin Pedrol1-2/+2
They will gain support to be activated as SDCCH/8 soon too. Related: SYS#5309 Depends: libosmocore.git I56dcfe4d17899630b17f80145c3ced72f1e91e68 Change-Id: Ia617d20fc52f09dbab8f4516c06fa1efac08e898
2021-07-01osmo-bts-trx: implement BCCH carrier power reduction modeVadim Yanitskiy1-0/+20
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-06-29doc: rsl.adoc: Fix trailing whitespacePau Espin Pedrol1-18/+17
Change-Id: Ibc93a87ad51c77fff08ecc54dcc01784756fb39f
2021-06-18Report interference levels in RSL RF RESource INDicationVadim Yanitskiy1-2/+2
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-04manuals/abis/rsl.adoc: add VAMOS specific Channel Number valuesVadim Yanitskiy1-0/+5
Change-Id: Ib3ad7652dfcbd104d25b031ac89f5491da2673a6 Related: SYS#4895, OS#4941
2021-06-04manuals/abis/rsl.adoc: add missing CBCH Channel Number valuesVadim Yanitskiy1-0/+2
Change-Id: Iab64c35a384978ba2eb1878f619de2c3827cd8c5 Related: SYS#4895, OS#4941
2021-06-04manuals/abis/rsl.adoc: rework Channel Number descriptionVadim Yanitskiy1-6/+11
Change-Id: I3013c6b2c38db33d7d80e174b3d4910f8b01963d Related: SYS#4895, OS#4941
2021-06-04manuals/abis/rsl.adoc: s/TS 08.58/TS 48.058/Vadim Yanitskiy1-76/+76
Change-Id: Iae8e184f98f089c95dce4c51f512971521c4b059 Related: SYS#4895, OS#4941
2021-04-30manuals: Update copyright yearsHarald Welte3-3/+3
Change-Id: I353013ddfc8c5506599e723e713d93f3f041f15d
2021-04-30manual: Remove manual revision history; we don't use it anywawyHarald Welte4-79/+0
Change-Id: I25c4d8b694756c6eed81c9b552a389ca5bd04ea7
2021-04-30manual: Include QoS chapter and add osmo-bts specific exampleHarald Welte2-0/+52
Change-Id: I8fcd524c550b43a851b3094effc215e5203d28be Requires: osmo-gsm-manuals.git Id344c29eda2a9b3e36376302b425e9db1f6c0f28 Requires: libosmo-abis.git I8991dd6eb406a5b9a70498974fc1ad339452f871
2021-04-22Abis manual: add RSL_IE_OSMO_TRAINING_SEQUENCENeels Hofmeyr1-0/+74
Change-Id: Ie583bd5969fdb45f772af198033e58d7c4077306
2021-04-22Abis manual: add VAMOS to BTS featuresNeels Hofmeyr1-2/+2
Change-Id: I108e3300e96087f4be47bd9ea237a9d28982839f
2021-04-22Abis manual: add Get Attributes, add BTS featuresNeels Hofmeyr1-5/+107
Change-Id: I99631272334537ab49ba8c530240aaeb67dde9d7
2021-04-21Abis manual: s/TS 12.21/TS 52.021Neels Hofmeyr1-52/+53
Change-Id: I662a3419a6ec741fe162ccc7c7221df20b2780b1
2021-04-21osmobts-abis.adoc: add missing bibliographyNeels Hofmeyr1-0/+2
Change-Id: I6a86416466eba14090026a3e6ec82a0e8548209a
2021-04-18manuals: document new 'gsmtap-remote-host' commandVadim Yanitskiy1-7/+17
Change-Id: I7f75fbac77a612493ce187cfac3c4ae203c81b23
2021-04-18manuals: remove deprecated command line parametersVadim Yanitskiy1-11/+1
Change-Id: Ie49abeb9647e3c8abdc9e110ab1a71c116f5def6
2021-04-16manuals: document GSMTAP 'enable-all' / 'disable-all'Vadim Yanitskiy1-0/+14
Change-Id: Iadbcf9d3184ab17c11c51e191aa3e80665839c22
2021-04-16manuals: fix wrong VTY node for 'gsmtap-sapi' commandVadim Yanitskiy1-3/+2
Change-Id: Ifcf1cf9cdbad40862d48415e004865a91a61d1b1
2021-03-09doc/examples: enable stderr logging for osmo-bts-virtual.cfgVadim Yanitskiy1-1/+1
Shippig configuration examples with disabled logging is... not ok. Change-Id: Iecb62b3537afe8906f6f816bfa7cc79b12a1ca26
2021-03-09doc/examples: remove obsolete power control parametersVadim Yanitskiy1-1/+0
We should not have deprecated parameters in configuration examples. Change-Id: I77cbe68023aa15ccf9829ef14c8cc7bccc84b58d
2020-11-27rsl.adoc: update documentation for RSL_IE_OSMO_REP_ACCH_CAPPhilipp Maier1-4/+20
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-10rsl.adoc: add info about RSL_IE_OSMO_REP_ACCH_CAPPhilipp Maier1-0/+10
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-05doc/manuals: move osmobts-vty-reference.xml to vty/Vadim Yanitskiy3-2/+1
This way we have everything VTY specific in a single directory. Change-Id: Iaba5c42b39fa764cd38c903486617c3d9f9cdebb Related: SYS#4937, OS#3036
2020-11-05doc/manuals: also generate VTY reference for osmo-bts-virtualVadim Yanitskiy1-1/+2
Change-Id: I12ac8cc13ce0caea2b63f94c407c01b4f00845e5 Related: SYS#4937, OS#3036
2020-11-05doc/manuals: generate XML VTY reference at build-timeVadim Yanitskiy4-2022/+71
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-08-17osmo-bts-trx: Use much lower clock advance values towards PCU and TRXDaniel Willmann1-3/+2
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-10common: Support setting rt prio through new libosmovty sched VTY cmdsPau Espin Pedrol1-0/+2
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-07-28doc: configuration.adoc: Document ramping down featurePau Espin Pedrol1-0/+6
Change-Id: I3c7df0d914587bdde2aef9919f75d507a0e5884b
2020-06-16doc: Fix typos in bts-models.adocPau Espin Pedrol1-3/+3
Change-Id: I05c9eb9b0edda528363a16d27dbf683994d9ab62
2020-06-05doc/examples: remove virtual/openbsc-virtual.cfgVadim Yanitskiy2-153/+1
This is not the right place to ship configuration examples for other projects, and definitely not for abandoned ones. Change-Id: Ib165b16f948126df8023bb42ad5d6d4b2fc11e6a
2020-06-01doc: Update vty reference xml filePau Espin Pedrol1-4/+280
Change-Id: I26c6522e6b5b87030dde61afacd637ff38b12303
2020-05-31doc/manuals: fix typo in interfaces.adoc: s/Omsocom/Osmocom/gVadim Yanitskiy1-1/+1
Change-Id: I28d914f89a6de82a8e226a9772984cb0c9d8869a
2020-03-23osmo-bts-trx: do not set rx-gain to 1 by defaultPhilipp Maier2-2/+0
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-02-25cosmetic: Fix some typos with codespellPau Espin Pedrol1-2/+2
Change-Id: I1bbb4871f764816dcbba86d833194be601fa9228
2019-11-19osmo-bts-virtual.cfg: ms-power-control dsp -> osmoOliver Smith1-1/+1
Fix error while starting osmo-bts-virtual with the example config: "This BTS model has no DSP/HW MS Power Control support" Fixes: c693067b7e99a643da673cb3e2a36162cbd0f59c ("Introduce BTS feature BTS_FEAT_MS_PWR_CTRL_DSP") Change-Id: I4f9a06e85d58294719a24197eb1c42a69fbd03d6
2019-10-17Fix common misspellings and typosMartin Hauke7-87/+87
Change-Id: I403b9029f57fec3fdec2c1e2cbeac0f6eab53f24
2019-09-19doc: bts-models.adoc: Fix typos in rts-advance sectionPau Espin Pedrol1-2/+2
Change-Id: I37ba104ec0538f8eb9345ff880660aefbdaa44ca
2019-09-07doc: Update Abis manual RSL section with ETWS related infomrationHarald Welte1-0/+48
Change-Id: I969153a204c167783ba394c9a911ff4484ded759
2019-07-24manuals: Update vty documentationDaniel Willmann1-1633/+1742
This documentation only includes commands for osmo-bts-virtual Change-Id: Icc0c96d173f31f2eb5fcb6385525a17f94ead852 Related: OS#1700
2019-07-21Clarify and refactor link quality (C/I) handlingVadim Yanitskiy1-4/+4
The radio link quality is defined by C/I (Carrier-to-Interference ratio), which is computed from the training sequence of each received burst, by comparing the "ideal" training sequence with the actual (received) one. Link quality measurements are used by L1SAP to filter out "ghost" Access Bursts, and by the link quality adaptation algorithms. One can define minimum link quality values using the VTY interface. On the VTY interface we expect integer C/I values in centiBels (cB, 10e-2 B), while the internal structures are using float values in deciBels (dB, 10e-1 B). Some PHYs (sysmo, octphy, oc2g, and litecell15) expose C/I measurements in deciBels, while on the L1SAP interface we finally send then in centiBels. Let's avoid this confusion and stick to a single format, that will be used by the internal logic of OsmoBTS - integer values (int16_t) in centiBels. This will give us the range of: -32768 .. 32767 centiBels, or -3276.8 .. 3276.7 deciBels, which is certainly sufficient. Change-Id: If624d6fdc0270e6813af8700d95f1345903c8a01
2019-07-18manuals: Add counter documentationDaniel Willmann3-0/+72
Change-Id: I994ad6aae7f409e0f15ff1d388127e16243b378a Related: OS#1700
2019-06-19manuals: Add script to regenerate counter/vty documentationDaniel Willmann2-0/+18
This will generate the VTY/counter documentation for osmo-bts-virtual so it will be missing documentation for device-specific commands/counters. Change-Id: Idebb099b69924d6212db119f7a2f2861d4150d7e Related: OS#1700
2019-06-03trx: Update documentation for fn-advance and rts-advanceHarald Welte1-2/+45
Change-Id: I83eff296bfb7acff9d8560b5346bd9791fe6e7d9 Related: OS#4036
2019-05-31debian: create -doc subpackage with pdf manualsOliver Smith1-0/+1
I have verified, that the resulting debian packages build in my own OBS namespace (see the -doc packages): https://download.opensuse.org/repositories/home:/osmith42/Debian_9.0/all/ https://build.opensuse.org/project/show/home:osmith42 Depends: Ib7251cca9116151e473798879375cd5eb48ff3ad (osmo-ci) Related: OS#3899 Change-Id: I6d7a182d0a668693a5014aca0edc50ada9ac0d0f