40 lines
1.8 KiB
Plaintext
40 lines
1.8 KiB
Plaintext
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/trx' 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.
|
|
|
|
- burst_gen.py - a tool for sending GSM bursts either to L1
|
|
(OsmoBTS or OsmocomBB) or to TRX (OsmoTRX and GR-GSM TRX).
|
|
Currently it is only possible to generate random bursts of
|
|
different types: NB, FB, SB, AB.
|
|
|
|
- burst_send.py - a tool for sending existing bursts from file
|
|
or standard input either to L1 (OsmoBTS or OsmocomBB) or to
|
|
TRX (OsmoTRX and GR-GSM TRX).
|
|
|
|
- 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.
|