diff options
author | Vadim Yanitskiy <axilirator@gmail.com> | 2018-03-13 01:09:56 +0700 |
---|---|---|
committer | Vadim Yanitskiy <axilirator@gmail.com> | 2018-03-13 02:10:02 +0700 |
commit | 23914b9cf855de8e847d450c70494626da2216e6 (patch) | |
tree | 29c853b8d9a2ae81e9b4cb21144a4ea7e9913d7f /src/target/trx_toolkit/README | |
parent | c08ddc73838b08f9538a966d6ad8f9f8bc856cf9 (diff) |
Rename 'fake_trx' to 'trx_toolkit'
This toolkit has branched out into several different tools for
TRX interface hacking, and creating a virtual Um-interface
(FakeTRX) is only one of its potential applications.
Change-Id: I56bcbc76b9c273d6b469a2bb68ddc46f3980e835
Diffstat (limited to 'src/target/trx_toolkit/README')
-rw-r--r-- | src/target/trx_toolkit/README | 34 |
1 files changed, 34 insertions, 0 deletions
diff --git a/src/target/trx_toolkit/README b/src/target/trx_toolkit/README new file mode 100644 index 00000000..91b6099b --- /dev/null +++ b/src/target/trx_toolkit/README @@ -0,0 +1,34 @@ +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. + +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 a + capture file either to L1 (OsmoBTS or OsmocomBB) or to + TRX (e.g. OsmoTRX or 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. |