Commit 54789e5a6091454c6c2be431f620d81f596430f3

Authored by Nicola Bui
1 parent bd7d514d
Exists in master

alpha release commit

Showing 1 changed file with 4 additions and 9 deletions   Show diff stats
README.md
... ... @@ -53,10 +53,9 @@ OWL is built on the srsLTE library by Software Radio Systems. Thus, if you are a
53 53 Part 1 - Installation:
54 54 ----------------------
55 55 1. Install dependencies:
56   -```
  56 +```bash
57 57 sudo apt-get install build-essential git cmake libboost-system-dev libboost-test-dev libboost-thread-dev libqwt-dev libqt4-dev libfftw3-dev
58 58 ```
59   -
60 59 2. BladeRF installation (skip this if you use USRP )
61 60 https://github.com/Nuand/bladeRF/wiki/Getting-Started%3A-Linux
62 61 To activate the release PPA, simply:
... ... @@ -65,7 +64,6 @@ sudo add-apt-repository ppa:bladerf/bladerf
65 64 sudo apt-get update
66 65 sudo apt-get install bladerf libbladerf-dev bladerf-firmware-fx3 bladerf-fpga-hostedx40
67 66 ```
68   -
69 67 3. Install srsgui
70 68 This is not mandatory for OWL to work, but is a nice tool and it helps testing srsLTE and OWL:
71 69 ```
... ... @@ -77,13 +75,11 @@ cmake ../
77 75 make
78 76 sudo make install
79 77 ```
80   -
81 78 4. Install gnuradio
82 79 only VOLK is needed, but the VOLK standalone installation usually fails and installing gnuradio in this way is usually fast and error-free. If you have problem with this, just try to have VOLK installed https://github.com/gnuradio/volk):
83 80 ```
84 81 sudo apt-get install gnuradio
85 82 ```
86   -
87 83 5. Clone and install OWL
88 84 ```
89 85 git clone git@git.networks.imdea.org:nicola_bui/imdeaowl.git
... ... @@ -111,7 +107,7 @@ TIP: once you have the frequency of a base station you can run
111 107 ```
112 108 where <freq> is the base station central frequency in hertz, i.e. 1.8 GHz can be given as 1800e6 or 1.8e9. If the synchronization is successfull, pdsch_ue will plot the constellations of the control channel and the shared downlink channel (only broadcast messages). If the signal is clean, you should be able to see a QPSK constellation in both diagrams. In addition, the amplitude and phase channel responses are plotted together with the PSS synchronization. The last one is ok if it looks like a gaussian.
113 109 2. OWL files
114   - - imdea_capture_sync
  110 +- imdea_capture_sync
115 111 This program capture a raw trace of the LTE channel synchronized on the beginning of the first subframe 0 detected. A very useful reference is http://www.sharetechnote.com/html/FrameStructure_DL.html
116 112 Usage:
117 113 ```
... ... @@ -125,7 +121,7 @@ TIP: putting -o /dev/null creates no output, but allows to test the signal synch
125 121 Decoded MIB ... (good)
126 122 MIB not decoded ... (noise on the channel)
127 123 sync loss (bad)
128   - - imdea_cc_decoder
  124 +- imdea_cc_decoder
129 125 This program is the main part of OWL, where the control channel is decoded. It works both online and offline and pre-recorded traces.
130 126 Online usage:
131 127 ```
... ... @@ -198,5 +194,4 @@ sort -u &lt;cc_out_filename&gt; &lt;cc_fixed_filename&gt; -o &lt;cc_total_filename&gt; (to combine
198 194  
199 195 Acknowledgements
200 196 ================
201   -
202   -
  197 +If
... ...