Commit Graph

116 Commits

Author SHA1 Message Date
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
Omar Ramadan 9c75c387c0 Add OC-2G BTS sources
Change-Id: I327384fe5ac944dc3996a3f00932d6f1a10d5a35
2018-10-27 11:35:58 +00:00
Harald Welte 73dd4ff027 ensure all config file examples are well-formed
We used to permit multiple spaces to enter a new node in the config,
but modern osmo* code writes config files well-formed where every node
equals exactly one indent level.

Change-Id: I3da56b34e87503c46e6bf3c7505b83ec5e6aaa20
2018-09-25 20:11:42 +02:00
Pau Espin 755088a79c doc/examples/Makefile: Install bts-mgr cfg files used by systemd services
Change-Id: Iaf362da2a9ebd6829391637252812c2be93e9c60
2018-09-14 15:12:28 +02:00
Pau Espin 8a6f6c5a16 Install sample cfg file to /etc/osmocom
Change cfg file names so they don't overlap when installing different
osmo-bts versions, and make systemd services look for correct new name.

Remove unneeded duplicated EXTRA_DIST files from root dir Makefile.am

Change-Id: I75fdd06cc52ce50628efb1f9b007d2e3926db27d
2018-09-12 19:10:28 +02:00
Pau Espin 46491d15cd build: Install example cfg files
Files from doc/examples/foo/bar.cfg are install to
/usr/share/doc/osmo-bts/examples/osmo-bts-foo/bar.cfg.

Change-Id: I7525d5a3e1a3c83a54f919cce9096303dd506f35
2018-07-02 16:36:14 +02:00
Pau Espin cf55fbede9 doc: Move calypsoBTS example into trx subdir
CalypsoBTS is a regular osmo-bts-trx with specific config options, so
let's move the cfg file to correct place. This also makes it easier to
install and package example files later on.

Change-Id: Ie2b968c478f1cf4d3e4cb36e4fb743e413cc93f0
2018-07-02 15:06:44 +02:00
Neels Hofmeyr 113e30cb06 use osmo_init_logging2() with proper talloc ctx
Completely drop bts_log_init(), call osmo_init_logging2() directly instead: all
callers of bts_log_init() passed NULL as category string, so all it ever did
was call osmo_init_logging(). The bts_log_info is already declared in the .h.

Here and there also define a proper talloc root context instead of using NULL.

Change-Id: Ic049f77bef74123b95350bcae182a468e0086b9c
2018-04-04 17:54:37 +02:00
Vadim Yanitskiy 536ebeed08 doc/examples: add CalypsoBTS configuration example
Despite the CalypsoBTS transceiver is similar to OsmoTRX, there
are some changes required to make it work with OsmoBTS. Let's
add a new configuration example for that.

Change-Id: Ia4b1797de576ab987b05046aa9a9828858023ed3
2017-11-27 22:59:20 +00:00
Pau Espin a73177b190 lc15: Fix cfg indentation
I was unable to start osmo-bts-lc15 with this config file until this
change was made, it said this command didn't exist.

Change-Id: Iae80e2ed504b5e26d748d57be7558ce470555f97
2017-11-01 12:06:35 +00:00
Neels Hofmeyr 0c9bc5422a osmo-bts-trx: vty: various fixes of 'write file' and doc
On 'write file':
- Write 'osmotrx' before 'maxdly' and 'maxdlynb' (broken since "Introduce new
  phy_link and phy_instance abstraction"
  d784e50747)
- Fix indenting of 'write file' output, command 'osmotrx timing-advance-loop',
  had a stray space in case there is not a 'no' preceding it.

Add some missing instances of OSMOTRX_STR doc strings.

examples/osmo-bts.cfg:
- Drop 'settsc', the command no longer exists.
- Fix indenting of 'osmotrx rx-gain' command.

osmo-bts does not feature VTY tests, so it is pointless to add example files to
test these fixes. We should probably add VTY tests separately.  However, I have
briefly tested manually (and hence found all of these issues).

Change-Id: I018eaef40345bfa26e12eb7d09e83a52596c1000
2017-10-18 14:02:30 +00:00
Pau Espin 824764fa6b lc15bts-mgr.cfg: Set default vswr to a value inside valid range
Valid range is currently set to 1000-200000.

Change-Id: Ibf60ab290acf0423c7617591a86403d63266e5d3
2017-07-25 17:17:24 +00:00
Max 2d2fca4342 lc15: port lc15bts-mgr changes
That's mostly changes related to lc15bts-mgr from
https://gitlab.com/nrw_noa/osmo-bts branch nrw/litecell15 based on
eb5b7f80510b603579f7af6d7d5ead296c2fa260 commit.

I wanted to incorporate vty and hardcoded paths changes so we can use it
from this point without major backward-incompatible changes as a base
for future ports.

Change-Id: Iabbaedc84aaaa594150a4e5445c16dd1f6f89858
Related: SYS#3679
2017-07-19 11:47:47 +02:00
Max b2bbc81921 lc15: make default config usable
* add trx-calibration path
* change GSM band to 900

Change-Id: I50bc4a4314a8b48e4000de445f4f05795e1a2d8b
Related: SYS#3722
2017-07-18 17:30:07 +00:00
Max e0e2b9e303 Cleanup example config files
* remove deprecated everything log level
* remove copy-pasted sysmobts-mgr.cfg from root directory

Change-Id: I8f392991097267665e9094189d24e7cf94a5d5d2
Related: OS#71
2017-07-14 14:30:01 +02:00
Sebastian Stumpf 81335edae3 VIRT-PHY: Added example configurations for openbsc and osmobts.
Change-Id: I368d4a378e20028603b09825eee766abb9195774
2017-07-13 21:35:33 +02:00
Max aa5edff477 lc15bts-mgr: use extended config file example
Change-Id: I0ef9d00a031b7d7e59150a28a6972c620ff19e92
Related: SYS#3686
2017-06-19 08:34:23 +00:00
Max 78a5073dfb Place *-mgr config examples according to BTS model
* copy sysmobts-mgr.cfg to sysmo/ directory
* add lc15bts-mgr.cfg

The configuration is BTS-specific so it should be located inside
appropriate subdirs.

Note: the old copy of sysmobts-mgr.cfg can be removed once the image
build recipes are adjusted.

Change-Id: Ic81197464809ba508b2572e86dd978a994f4b116
Related: SYS#3686
2017-06-14 13:15:42 +00:00
Pau Espin 8a8d73a691 trx: Allow BTS and TRX to be on different IPs
Depends on libosmocore I3c655a4af64fb80497a5aaa811cce8005dba9cd9

Change-Id: I0bd34b7b02c1a9b0c6f6f89f327b486e5620c8d5
2017-06-06 19:23:18 +00:00
Neels Hofmeyr 8a2f026cf0 doc: move dyn_pdch.msc to osmo-gsm-manuals.git
Also remove related cruft: .gitignore, msc-README and adjust an in-code
comment that referenced dyn_pdch.msc.

Change-Id: Ie41a453bb5070c1f18793f646dc053a978f43fba
2016-07-25 16:35:53 +02:00
Max ae2a8b75f9 TRX: add configuration example
Related: OS#1648
Change-Id: Icc7d15eceee8ee667fd6a29e758a38668c4946ef
2016-06-17 15:32:28 +00:00
Neels Hofmeyr ea40bd60e7 doc: add ladder diagram on dynamic PDCH, add msc-README
Adjust .gitignore for dyn_pdch.svg and .png.

Change-Id: I532f896b1b528c4d1764bb5042a7f42c3c60f617
2016-06-17 02:46:12 +00:00
Max ae5a737c18 octphy: add example configuration with 2 trx 2016-03-18 15:43:56 +01:00
Harald Welte 40e8365854 Update configuration examples
Add SysmoBTS-specific example.
Remove outdated generic example which is no longer working.
2016-03-14 18:36:11 +01:00
Harald Welte 234309878e LC15: Add example configuration file for Litecell 1.5 2016-02-15 14:26:58 +01:00
Harald Welte d784e50747 Introduce new phy_link and phy_instance abstraction
This way we can model a flexible mapping between any number of PHYs,
each having multiple instances, and then map BTSs with TRXx on top of
those PHYs.
2016-02-15 14:18:59 +01:00
Harald Welte b92100ad36 Add support for Octasic OCTSDR-2G GSM PHY
This adds support for a new PHY to OsmoBTS, the Octasic OCTSDR-2G
PHY. This is a proprietary GSM PHY running on a familty of Octasic DSPs.
2016-01-16 17:23:10 +01:00
Harald Welte 3dd6ebe0b8 add information on unit (milli-dB) to control interface doc 2014-08-25 08:42:08 +02:00
Harald Welte c0a3030277 add a small document describing the use of the control interface 2014-08-24 17:19:59 +02:00
Holger Hans Peter Freyther 013df51ca8 sysmobts: Add VTY support to the sysmobts-mgr
Add VTY support to the manager. This way we can interactively
inspect the state of the system and trigger events.
2014-08-21 15:49:06 +02:00
Holger Hans Peter Freyther 0e2b624418 sysmobts: Revert all sysmobts-mgr related changes
Harald is right and that the code is generally not ready
for inclusion. I fell victim of trying to finish it while
the code is not ready at all. It is better to re-introduce
the patches in a smaller and more tested way.

The right way would have been a branch were ready things
are split-off the main/wip commit until everything is ready.

Revert "sysmobts: Have a common prefix for the enum"
This reverts commit 44980347f3.

Revert "utils: Used the enum manuf_type_id in the parameter of add_manufacturer_id_label"
This reverts commit 7d36e5ed46.

Revert "utils: Classify the OML message using the return type"
This reverts commit afee0b7929.

Revert "sysmobts: Do not access out of bound string"
This reverts commit f5f41e8051.

Revert "sysmobts: Separate IPA and OML check into two methods"
This reverts commit 13a224063d.

Revert "screenrc: osmobts-mgr now needs a config file"
This reverts commit 0a1699ff8a.

Revert "make sure osmobts-mgr.cfg file is included in tarballs"
This reverts commit 14c60b425f.

Revert "sysmobts-mgr: Add VTY support for configuring it"
This reverts commit c5fedd24c9.

Revert "sysmobts: Add beginnings of an OML router and create Failure Messages in the sysmobts-manager"
This reverts commit c6ab90b270.
2014-05-25 13:48:33 +02:00
Álvaro Neira Ayuso c5fedd24c9 sysmobts-mgr: Add VTY support for configuring it
This patch allows to configure the warning temperature threshold,
the severe temperature threshold of the board and the PA and the
actions like the relative value power that we want to reduce the
transmit power to and the part that we want to switch off or not.

Signed-off-by: Alvaro Neira Ayuso <anayuso@sysmocom.de>
2014-05-18 09:42:08 +02:00
Holger Hans Peter Freyther d9da7813a6 doc: Remove the rtp bind-ip from the example
This option is not needed anymore, let's remove it.
2013-03-02 18:12:22 +01:00
Holger Hans Peter Freyther ef2cb5ab7f misc: Disable the color in the default setting
When forwarding the log messages to logger or systemd the ansi
escape sequence can confuse the app collecting the data.
2012-09-20 15:27:35 +02:00
Harald Welte 818cb2d314 update config file to parse correctly 2012-02-10 13:32:58 +01:00
Holger Hans Peter Freyther b10d74d821 config: Rename llapdm -> llapd in the example configuration 2011-11-07 13:48:02 +01:00
Harald Welte e3e3a19e6c add minimal example config file 2011-09-04 22:49:20 +02:00