-
Notifications
You must be signed in to change notification settings - Fork 2
/
README
137 lines (110 loc) · 5.52 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
STILLSUIT
STILLSUIT is a collection of GNURadio flowgraphs that act as wrappers for three common Software Defined Radios. The output
of each flowgraph is a ZMQ datastream and each one also starts an XMLRPC server for remote control.
Each SDR's parameters are exposed as command line arguments and there was a focus on normalizing common SDR parameters.
STILLSUIT was created to work with the ARAKKIS project (https://github.com/muaddib1984/arrakis). ARAKKIS uses any of the
STILLSUIT flowgraphs on a remote host as the data source to a co-located DSP processor flowgraph. The DSP flowgraph connects
over a low data rate IP Connection (SSH) to a data visualization flowgraph on a local machine for remote spectrum monitoring.
The STILLSUIT SDR Portions in the diagram are contained in STILLSUIT.
The three supported SDR's are:
-Ettus Research USRP
-LimeMicro LimeSDR
-RTL-SDR
+-------------------------------+ +----------------+
| REMOTE HOST | |LOCAL HOST |
| +---------+ +------------+ | SSH | |
| |STILLSUIT+--->+SPACE FOLDER+--------->+GUILD NAVIGATOR |
| | (SDR) | ZMQ| (DSP) | | ZMQ | (VISUALIZATION |
| +---------+ +------------+ | | AND CONTROL) |
+-------------------------------+ +-----+----------+
^ ^ |
| +-----------------------+
+---------------------------------------+
XMLRPC
DEPENDENCIES:
GNURadio 3.9+
DESCRIPTION:
DATA STREAM
-STILLSUIT streams complex32 type I/Q data from the flowgraph via ZMQ.
CONTROL
-STILLSUIT exposes all RADIO parameters to be remote controlled via an XMLRPC server.
The default ports for all three STILLSUIT sources is 8000, but can be changed via command line arguments.
USAGE:
-The default parameters for STILLSUIT are set to work with the ARAKKIS project 'out of the box'.
Parameters can be seen using '-h' in the command line.
-USRP STILLSUIT Help Menu:
uhd_stillsuit.py -h
usage: uhd_stillsuit.py [-h] [-x CONTROL_IP] [-X CONTROL_PORT] [-b RF_BW]
[-f RF_FREQ] [-g RF_GAIN] [-s SAMP_RATE] [-I UHD_ADDRESS]
[-A UHD_ARGS] [-o ZMQ_OUT_IP]
radio head for passing I/Q to other flowgraphs
optional arguments:
-h, --help show this help message and exit
-x CONTROL_IP, --control-ip CONTROL_IP
Set XMLRPC SERVER IP [default='127.0.0.1']
-X CONTROL_PORT, --control-port CONTROL_PORT
Set XMLRPC SERVER PORT [default=8000]
-b RF_BW, --rf-bw RF_BW
Set RF BANDWITDH [default='20.0M']
-f RF_FREQ, --rf-freq RF_FREQ
Set RF FREQUENCY [default='750.0M']
-g RF_GAIN, --rf-gain RF_GAIN
Set RF GAIN [default='20.0']
-s SAMP_RATE, --samp-rate SAMP_RATE
Set SAMPLE RATE [default='20.0M']
-I UHD_ADDRESS, --uhd-address UHD_ADDRESS
Set UHD Device Address (example: 'serial=ABCD1234' or
'addr=192.168.1.2') [default='']
-A UHD_ARGS, --uhd-args UHD_ARGS
Set UHD ARGS (example:
'rcv_frame_size=8192,num_rcv_frames=128') [default='']
-o ZMQ_OUT_IP, --zmq-out-ip ZMQ_OUT_IP
Set ZMQ OUT IP ADDR [default='127.0.0.1']
-LimeSDR STILLSUIT Help Menu:
lime_stillsuit.py -h
usage: lime_stillsuit.py [-h] [-x CONTROL_IP] [-X CONTROL_PORT] [-b RF_BW]
[-f RF_FREQ] [-g RF_GAIN] [-s SAMP_RATE] [-o ZMQ_OUT_IP]
radio head for passing I/Q to other flowgraphs
optional arguments:
-h, --help show this help message and exit
-x CONTROL_IP, --control-ip CONTROL_IP
Set XMLRPC SERVER IP [default='127.0.0.1']
-X CONTROL_PORT, --control-port CONTROL_PORT
Set XMLRPC SERVER PORT [default=8000]
-b RF_BW, --rf-bw RF_BW
Set RF BANDWITDH [default='20.0M']
-f RF_FREQ, --rf-freq RF_FREQ
Set RF FREQUENCY [default='750.0M']
-g RF_GAIN, --rf-gain RF_GAIN
Set RF GAIN [default='20.0']
-s SAMP_RATE, --samp-rate SAMP_RATE
Set SAMPLE RATE [default='20.0M']
-o ZMQ_OUT_IP, --zmq-out-ip ZMQ_OUT_IP
Set ZMQ OUT IP ADDR [default='127.0.0.1']
-RTLSDR STILLSUIT Help Menu:
rtl_stillsuit.py -h
usage: rtl_stillsuit.py [-h] [-x CONTROL_IP] [-X CONTROL_PORT] [-d DEVICE_IDX]
[-f RF_FREQ] [-g RF_GAIN] [-s SAMP_RATE] [-o ZMQ_OUT_IP]
radio head for passing I/Q to other flowgraphs
optional arguments:
-h, --help show this help message and exit
-x CONTROL_IP, --control-ip CONTROL_IP
Set XMLRPC SERVER IP [default='127.0.0.1']
-X CONTROL_PORT, --control-port CONTROL_PORT
Set XMLRPC SERVER PORT [default=8000]
-d DEVICE_IDX, --device-idx DEVICE_IDX
Set DEVICE INDEX [default=0]
-f RF_FREQ, --rf-freq RF_FREQ
Set RF FREQUENCY [default='750.0M']
-g RF_GAIN, --rf-gain RF_GAIN
Set RF GAIN [default='20.0']
-s SAMP_RATE, --samp-rate SAMP_RATE
Set SAMPLE RATE [default='2.56M']
-o ZMQ_OUT_IP, --zmq-out-ip ZMQ_OUT_IP
Set ZMQ OUT IP ADDR [default='127.0.0.1']
RUNNING:
**NOTE**
The sampling rate for the STILLSUIT sources for USRP and LimeSDR are set by default to 20Msps.
The sampling rate for the STILLSUIT RTLSDR is set by default to 2Msps.
Future Work:
Include HackRF