2018-03-12 18:09:56 +00:00
|
|
|
TRX toolkit is a set of tools intended for hacking and debugging
|
|
|
|
a TRX interface between both transceiver and L1 software, and
|
|
|
|
emulating a virtual Um-interface between OsmocomBB and OsmoBTS.
|
target/fake_trx: initial release of virtual transceiver
This is a set of tools for creating a virtual Um-interface between
OsmocomBB and OsmoBTS. It may be extremely useful for testing and
development of GSM stack, including both sides (MS and BTS). This
software implements OsmoTRX (Osmocom's fork of OpenBTS transceiver)
style clock (CLCK), control (CTRL) and data interfaces. So, OsmoBTS
source code doesn't require any modifications, while for OsmocomBB
you will need to use a new application - trxcon, which can be found
in the 'fixeria/sdr_phy' branch until one is merged to master.
Brief description of available applications:
- fake_trx.py - main application, that allows to connect both
OsmocomBB and OsmoBTS without actual RF hardware. Currently
only a single MS may work with a single BTS.
- clck_gen.py - a peripheral tool aimed to emulate TDMA frame
clock generator. Could be used for testing and clock
synchronization of multiple applications. It should be noted,
that one relays on generic system timer (via Python), so
a random clock jitter takes place.
- ctrl_cmd.py - another peripheral tool, which could be used
for sending CTRL commands directly in manual mode, and also
for application fuzzing.
Change-Id: Ib1fb80682002ac85a72fa6abef459a4c44f4ab97
2017-07-10 12:39:06 +00:00
|
|
|
|
|
|
|
Brief description of available applications:
|
|
|
|
|
|
|
|
- fake_trx.py - main application, that allows to connect both
|
2019-01-14 20:57:57 +00:00
|
|
|
OsmocomBB and OsmoBTS without actual RF hardware. It's also
|
|
|
|
possible to emulate more than two transceivers, so multiple
|
|
|
|
MS and/or BTS instances can be connected.
|
target/fake_trx: initial release of virtual transceiver
This is a set of tools for creating a virtual Um-interface between
OsmocomBB and OsmoBTS. It may be extremely useful for testing and
development of GSM stack, including both sides (MS and BTS). This
software implements OsmoTRX (Osmocom's fork of OpenBTS transceiver)
style clock (CLCK), control (CTRL) and data interfaces. So, OsmoBTS
source code doesn't require any modifications, while for OsmocomBB
you will need to use a new application - trxcon, which can be found
in the 'fixeria/sdr_phy' branch until one is merged to master.
Brief description of available applications:
- fake_trx.py - main application, that allows to connect both
OsmocomBB and OsmoBTS without actual RF hardware. Currently
only a single MS may work with a single BTS.
- clck_gen.py - a peripheral tool aimed to emulate TDMA frame
clock generator. Could be used for testing and clock
synchronization of multiple applications. It should be noted,
that one relays on generic system timer (via Python), so
a random clock jitter takes place.
- ctrl_cmd.py - another peripheral tool, which could be used
for sending CTRL commands directly in manual mode, and also
for application fuzzing.
Change-Id: Ib1fb80682002ac85a72fa6abef459a4c44f4ab97
2017-07-10 12:39:06 +00:00
|
|
|
|
|
|
|
- clck_gen.py - a peripheral tool aimed to emulate TDMA frame
|
|
|
|
clock generator. Could be used for testing and clock
|
|
|
|
synchronization of multiple applications. It should be noted,
|
|
|
|
that one relays on generic system timer (via Python), so
|
|
|
|
a random clock jitter takes place.
|
|
|
|
|
|
|
|
- ctrl_cmd.py - another peripheral tool, which could be used
|
|
|
|
for sending CTRL commands directly in manual mode, and also
|
|
|
|
for application fuzzing.
|
2017-07-28 07:56:09 +00:00
|
|
|
|
|
|
|
- burst_gen.py - a tool for sending GSM bursts either to L1
|
|
|
|
(OsmoBTS or OsmocomBB) or to TRX (OsmoTRX and GR-GSM TRX).
|
2017-11-21 11:25:43 +00:00
|
|
|
Currently it is only possible to generate random bursts of
|
2017-07-28 07:56:09 +00:00
|
|
|
different types: NB, FB, SB, AB.
|
2017-11-21 11:25:43 +00:00
|
|
|
|
2018-02-20 12:21:54 +00:00
|
|
|
- burst_send.py - a tool for sending existing bursts from a
|
|
|
|
capture file either to L1 (OsmoBTS or OsmocomBB) or to
|
|
|
|
TRX (e.g. OsmoTRX or GR-GSM TRX).
|
2018-01-20 19:49:27 +00:00
|
|
|
|
|
|
|
- trx_sniff.py - Scapy-based TRX protocol sniffer. Allows one
|
|
|
|
to observe a single connection between TRX and L1, and vice
|
|
|
|
versa. Also provides some capabilities for filtering bursts
|
|
|
|
by direction, frame and timeslot numbers, and for recording
|
|
|
|
captured messages to a binary file.
|
2019-01-14 20:47:57 +00:00
|
|
|
|
|
|
|
Please note that TRX toolkit is not using libosmocore's CTRL
|
|
|
|
interface, so 'CTRL' in scope of this code base actually means
|
|
|
|
control interface of TRX or control protocol. In order to avoid
|
|
|
|
possible confusion, we use 'TRXC' and 'TRXD' in logging.
|