From 23914b9cf855de8e847d450c70494626da2216e6 Mon Sep 17 00:00:00 2001 From: Vadim Yanitskiy Date: Tue, 13 Mar 2018 01:09:56 +0700 Subject: [PATCH] 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 --- src/target/{fake_trx => trx_toolkit}/.gitignore | 0 src/target/{fake_trx => trx_toolkit}/README | 11 +++-------- src/target/{fake_trx => trx_toolkit}/burst_fwd.py | 2 +- src/target/{fake_trx => trx_toolkit}/burst_gen.py | 1 + src/target/{fake_trx => trx_toolkit}/burst_send.py | 1 + src/target/{fake_trx => trx_toolkit}/clck_gen.py | 2 +- src/target/{fake_trx => trx_toolkit}/copyright.py | 0 src/target/{fake_trx => trx_toolkit}/ctrl_cmd.py | 1 + src/target/{fake_trx => trx_toolkit}/ctrl_if.py | 2 +- src/target/{fake_trx => trx_toolkit}/ctrl_if_bb.py | 2 +- src/target/{fake_trx => trx_toolkit}/ctrl_if_bts.py | 2 +- src/target/{fake_trx => trx_toolkit}/data_dump.py | 0 src/target/{fake_trx => trx_toolkit}/data_if.py | 2 +- src/target/{fake_trx => trx_toolkit}/data_msg.py | 2 +- src/target/{fake_trx => trx_toolkit}/fake_pm.py | 2 +- src/target/{fake_trx => trx_toolkit}/fake_trx.py | 2 +- src/target/{fake_trx => trx_toolkit}/gsm_shared.py | 2 +- .../{fake_trx => trx_toolkit}/rand_burst_gen.py | 2 +- src/target/{fake_trx => trx_toolkit}/trx_sniff.py | 1 + src/target/{fake_trx => trx_toolkit}/udp_link.py | 2 +- 20 files changed, 19 insertions(+), 20 deletions(-) rename src/target/{fake_trx => trx_toolkit}/.gitignore (100%) rename src/target/{fake_trx => trx_toolkit}/README (71%) rename src/target/{fake_trx => trx_toolkit}/burst_fwd.py (99%) rename src/target/{fake_trx => trx_toolkit}/burst_gen.py (99%) rename src/target/{fake_trx => trx_toolkit}/burst_send.py (99%) rename src/target/{fake_trx => trx_toolkit}/clck_gen.py (98%) rename src/target/{fake_trx => trx_toolkit}/copyright.py (100%) rename src/target/{fake_trx => trx_toolkit}/ctrl_cmd.py (99%) rename src/target/{fake_trx => trx_toolkit}/ctrl_if.py (98%) rename src/target/{fake_trx => trx_toolkit}/ctrl_if_bb.py (99%) rename src/target/{fake_trx => trx_toolkit}/ctrl_if_bts.py (98%) rename src/target/{fake_trx => trx_toolkit}/data_dump.py (100%) rename src/target/{fake_trx => trx_toolkit}/data_if.py (96%) rename src/target/{fake_trx => trx_toolkit}/data_msg.py (99%) rename src/target/{fake_trx => trx_toolkit}/fake_pm.py (97%) rename src/target/{fake_trx => trx_toolkit}/fake_trx.py (99%) rename src/target/{fake_trx => trx_toolkit}/gsm_shared.py (96%) rename src/target/{fake_trx => trx_toolkit}/rand_burst_gen.py (98%) rename src/target/{fake_trx => trx_toolkit}/trx_sniff.py (99%) rename src/target/{fake_trx => trx_toolkit}/udp_link.py (97%) diff --git a/src/target/fake_trx/.gitignore b/src/target/trx_toolkit/.gitignore similarity index 100% rename from src/target/fake_trx/.gitignore rename to src/target/trx_toolkit/.gitignore diff --git a/src/target/fake_trx/README b/src/target/trx_toolkit/README similarity index 71% rename from src/target/fake_trx/README rename to src/target/trx_toolkit/README index 7b27414bf..91b6099b5 100644 --- a/src/target/fake_trx/README +++ b/src/target/trx_toolkit/README @@ -1,11 +1,6 @@ -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. +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: diff --git a/src/target/fake_trx/burst_fwd.py b/src/target/trx_toolkit/burst_fwd.py similarity index 99% rename from src/target/fake_trx/burst_fwd.py rename to src/target/trx_toolkit/burst_fwd.py index 9f0f84f1d..144ae5f46 100644 --- a/src/target/fake_trx/burst_fwd.py +++ b/src/target/trx_toolkit/burst_fwd.py @@ -1,7 +1,7 @@ #!/usr/bin/env python2 # -*- coding: utf-8 -*- -# Virtual Um-interface (fake transceiver) +# TRX Toolkit # BTS <-> BB burst forwarding # # (C) 2017 by Vadim Yanitskiy diff --git a/src/target/fake_trx/burst_gen.py b/src/target/trx_toolkit/burst_gen.py similarity index 99% rename from src/target/fake_trx/burst_gen.py rename to src/target/trx_toolkit/burst_gen.py index 6a034cd57..4bc036ea3 100755 --- a/src/target/fake_trx/burst_gen.py +++ b/src/target/trx_toolkit/burst_gen.py @@ -1,6 +1,7 @@ #!/usr/bin/env python2 # -*- coding: utf-8 -*- +# TRX Toolkit # Auxiliary tool to generate and send random bursts via TRX DATA # interface, which may be useful for fuzzing and testing # diff --git a/src/target/fake_trx/burst_send.py b/src/target/trx_toolkit/burst_send.py similarity index 99% rename from src/target/fake_trx/burst_send.py rename to src/target/trx_toolkit/burst_send.py index c588b3dfd..7405c9019 100755 --- a/src/target/fake_trx/burst_send.py +++ b/src/target/trx_toolkit/burst_send.py @@ -1,6 +1,7 @@ #!/usr/bin/env python2 # -*- coding: utf-8 -*- +# TRX Toolkit # Auxiliary tool to send existing bursts via TRX DATA interface # # (C) 2017-2018 by Vadim Yanitskiy diff --git a/src/target/fake_trx/clck_gen.py b/src/target/trx_toolkit/clck_gen.py similarity index 98% rename from src/target/fake_trx/clck_gen.py rename to src/target/trx_toolkit/clck_gen.py index 83c0a64d7..4b86c31a9 100755 --- a/src/target/fake_trx/clck_gen.py +++ b/src/target/trx_toolkit/clck_gen.py @@ -1,7 +1,7 @@ #!/usr/bin/env python2 # -*- coding: utf-8 -*- -# Virtual Um-interface (fake transceiver) +# TRX Toolkit # Simple TDMA frame clock generator # # (C) 2017-2018 by Vadim Yanitskiy diff --git a/src/target/fake_trx/copyright.py b/src/target/trx_toolkit/copyright.py similarity index 100% rename from src/target/fake_trx/copyright.py rename to src/target/trx_toolkit/copyright.py diff --git a/src/target/fake_trx/ctrl_cmd.py b/src/target/trx_toolkit/ctrl_cmd.py similarity index 99% rename from src/target/fake_trx/ctrl_cmd.py rename to src/target/trx_toolkit/ctrl_cmd.py index 3526eaa51..0791f85ce 100755 --- a/src/target/fake_trx/ctrl_cmd.py +++ b/src/target/trx_toolkit/ctrl_cmd.py @@ -1,6 +1,7 @@ #!/usr/bin/env python2 # -*- coding: utf-8 -*- +# TRX Toolkit # Auxiliary tool to send custom commands via TRX CTRL interface, # which may be useful for testing and fuzzing # diff --git a/src/target/fake_trx/ctrl_if.py b/src/target/trx_toolkit/ctrl_if.py similarity index 98% rename from src/target/fake_trx/ctrl_if.py rename to src/target/trx_toolkit/ctrl_if.py index af124f65d..1e569a608 100644 --- a/src/target/fake_trx/ctrl_if.py +++ b/src/target/trx_toolkit/ctrl_if.py @@ -1,7 +1,7 @@ #!/usr/bin/env python2 # -*- coding: utf-8 -*- -# Virtual Um-interface (fake transceiver) +# TRX Toolkit # CTRL interface implementation # # (C) 2016-2017 by Vadim Yanitskiy diff --git a/src/target/fake_trx/ctrl_if_bb.py b/src/target/trx_toolkit/ctrl_if_bb.py similarity index 99% rename from src/target/fake_trx/ctrl_if_bb.py rename to src/target/trx_toolkit/ctrl_if_bb.py index 33263e5ae..a1ccd0d17 100644 --- a/src/target/fake_trx/ctrl_if_bb.py +++ b/src/target/trx_toolkit/ctrl_if_bb.py @@ -1,7 +1,7 @@ #!/usr/bin/env python2 # -*- coding: utf-8 -*- -# Virtual Um-interface (fake transceiver) +# TRX Toolkit # CTRL interface implementation (OsmocomBB specific) # # (C) 2016-2017 by Vadim Yanitskiy diff --git a/src/target/fake_trx/ctrl_if_bts.py b/src/target/trx_toolkit/ctrl_if_bts.py similarity index 98% rename from src/target/fake_trx/ctrl_if_bts.py rename to src/target/trx_toolkit/ctrl_if_bts.py index 449df4585..231641a63 100644 --- a/src/target/fake_trx/ctrl_if_bts.py +++ b/src/target/trx_toolkit/ctrl_if_bts.py @@ -1,7 +1,7 @@ #!/usr/bin/env python2 # -*- coding: utf-8 -*- -# Virtual Um-interface (fake transceiver) +# TRX Toolkit # CTRL interface implementation (OsmoBTS specific) # # (C) 2016-2017 by Vadim Yanitskiy diff --git a/src/target/fake_trx/data_dump.py b/src/target/trx_toolkit/data_dump.py similarity index 100% rename from src/target/fake_trx/data_dump.py rename to src/target/trx_toolkit/data_dump.py diff --git a/src/target/fake_trx/data_if.py b/src/target/trx_toolkit/data_if.py similarity index 96% rename from src/target/fake_trx/data_if.py rename to src/target/trx_toolkit/data_if.py index 8b0cd8e56..f4431a46c 100644 --- a/src/target/fake_trx/data_if.py +++ b/src/target/trx_toolkit/data_if.py @@ -1,7 +1,7 @@ #!/usr/bin/env python2 # -*- coding: utf-8 -*- -# Virtual Um-interface (fake transceiver) +# TRX Toolkit # DATA interface implementation # # (C) 2017-2018 by Vadim Yanitskiy diff --git a/src/target/fake_trx/data_msg.py b/src/target/trx_toolkit/data_msg.py similarity index 99% rename from src/target/fake_trx/data_msg.py rename to src/target/trx_toolkit/data_msg.py index a48eff7cc..ea415ab96 100644 --- a/src/target/fake_trx/data_msg.py +++ b/src/target/trx_toolkit/data_msg.py @@ -1,7 +1,7 @@ #!/usr/bin/env python2 # -*- coding: utf-8 -*- -# Virtual Um-interface (fake transceiver) +# TRX Toolkit # DATA interface message definitions and helpers # # (C) 2018 by Vadim Yanitskiy diff --git a/src/target/fake_trx/fake_pm.py b/src/target/trx_toolkit/fake_pm.py similarity index 97% rename from src/target/fake_trx/fake_pm.py rename to src/target/trx_toolkit/fake_pm.py index 1d7691650..840b4e407 100644 --- a/src/target/fake_trx/fake_pm.py +++ b/src/target/trx_toolkit/fake_pm.py @@ -1,7 +1,7 @@ #!/usr/bin/env python2 # -*- coding: utf-8 -*- -# Virtual Um-interface (fake transceiver) +# TRX Toolkit # Power measurement emulation for BB # # (C) 2017 by Vadim Yanitskiy diff --git a/src/target/fake_trx/fake_trx.py b/src/target/trx_toolkit/fake_trx.py similarity index 99% rename from src/target/fake_trx/fake_trx.py rename to src/target/trx_toolkit/fake_trx.py index 4f0f28283..1fcd3df9b 100755 --- a/src/target/fake_trx/fake_trx.py +++ b/src/target/trx_toolkit/fake_trx.py @@ -1,8 +1,8 @@ #!/usr/bin/env python2 # -*- coding: utf-8 -*- +# TRX Toolkit # Virtual Um-interface (fake transceiver) -# OsmocomBB <-> OsmoBTS bridge # # (C) 2017-2018 by Vadim Yanitskiy # diff --git a/src/target/fake_trx/gsm_shared.py b/src/target/trx_toolkit/gsm_shared.py similarity index 96% rename from src/target/fake_trx/gsm_shared.py rename to src/target/trx_toolkit/gsm_shared.py index cfe94b010..d2f8278b6 100644 --- a/src/target/fake_trx/gsm_shared.py +++ b/src/target/trx_toolkit/gsm_shared.py @@ -1,7 +1,7 @@ #!/usr/bin/env python2 # -*- coding: utf-8 -*- -# Virtual Um-interface (fake transceiver) +# TRX Toolkit # Common GSM constants # # (C) 2018 by Vadim Yanitskiy diff --git a/src/target/fake_trx/rand_burst_gen.py b/src/target/trx_toolkit/rand_burst_gen.py similarity index 98% rename from src/target/fake_trx/rand_burst_gen.py rename to src/target/trx_toolkit/rand_burst_gen.py index 33e7c53a4..46c1e090b 100644 --- a/src/target/fake_trx/rand_burst_gen.py +++ b/src/target/trx_toolkit/rand_burst_gen.py @@ -1,7 +1,7 @@ #!/usr/bin/env python2 # -*- coding: utf-8 -*- -# Virtual Um-interface (fake transceiver) +# TRX Toolkit # Random burst (NB, FB, SB, AB) generator # # (C) 2017 by Vadim Yanitskiy diff --git a/src/target/fake_trx/trx_sniff.py b/src/target/trx_toolkit/trx_sniff.py similarity index 99% rename from src/target/fake_trx/trx_sniff.py rename to src/target/trx_toolkit/trx_sniff.py index fe1ddb093..577e6f97e 100755 --- a/src/target/fake_trx/trx_sniff.py +++ b/src/target/trx_toolkit/trx_sniff.py @@ -1,6 +1,7 @@ #!/usr/bin/env python2 # -*- coding: utf-8 -*- +# TRX Toolkit # Scapy-based TRX interface sniffer # # (C) 2018 by Vadim Yanitskiy diff --git a/src/target/fake_trx/udp_link.py b/src/target/trx_toolkit/udp_link.py similarity index 97% rename from src/target/fake_trx/udp_link.py rename to src/target/trx_toolkit/udp_link.py index 99da95bb5..56d9c37c8 100644 --- a/src/target/fake_trx/udp_link.py +++ b/src/target/trx_toolkit/udp_link.py @@ -1,7 +1,7 @@ #!/usr/bin/env python2 # -*- coding: utf-8 -*- -# Virtual Um-interface (fake transceiver) +# TRX Toolkit # UDP link implementation # # (C) 2017 by Vadim Yanitskiy