summaryrefslogtreecommitdiff
path: root/gsmsp/INSTALL
diff options
context:
space:
mode:
Diffstat (limited to 'gsmsp/INSTALL')
-rw-r--r--gsmsp/INSTALL59
1 files changed, 59 insertions, 0 deletions
diff --git a/gsmsp/INSTALL b/gsmsp/INSTALL
new file mode 100644
index 0000000..be7aca4
--- /dev/null
+++ b/gsmsp/INSTALL
@@ -0,0 +1,59 @@
+
+
+A gnu radio implementation to receive and decode GSM packets.
+
+Install
+=======
+
+./configure
+make
+# The release comes with a example capture file. Test if it works:
+./run.sh
+
+Analyzing GSM data
+==================
+
+The release does not support live captures (yet).
+
+ 1. Search for a base station in your area. See "BTS searching by Robert"
+ or use the Nokia Field Tester (NetMonitor) to find the channel number
+ of you operator and calculate the frequency from it.
+
+ 2. From the gnu-radio installation use usr_rx_cfile.py to capture data:
+ Example of capturing 10seconds of gsm data on 940.8Mhz:
+
+ # samples=`expr 64000000 / 118 '*' 10`
+ # ./usrp_rx_cfile.py -d 118 -f 940.8M -N $samples 940.8Mhz_118.cfile
+
+ 3. Make the file available to gsmsp:
+ # cd ~/gsmsp
+ # ln -sf /wherever/the/cfile/is/940.8Mhz_118.cfile signal.data
+ # ./run.sh
+
+Requirements
+============
+
+ * gnu radio (tested with 3.0.2 and 3.0.3)
+ * python (tested with 2.4.4)
+ * python-numeric (tested with 23.7)
+
+Supported Platforms
+===================
+
+ * gentoo linux
+ * cygwin
+
+Limitations
+===========
+
+ * receiving only
+ * only BTS -> MS traffic.
+ * no channel hopping
+
+Your sincerly,
+
+THE GSM SCANNER PROJECT
+http://wiki.thc.org/gsm
+
+
+
personal git repositories of Harald Welte. Your mileage may vary