README.md 2.72 KB
Newer Older
bastla's avatar
bastla committed
1
# MobiTUB-3 Beacon Receiver
weisenbergertub90's avatar
weisenbergertub90 committed
2

bastla's avatar
bastla committed
3
4
5
6
7
8
Sample implementation of a MobiTUB v3 software defined radio (SDR) tool for
Amateur Radio operators published by the **Chair of Space Technology,
Technische Universität Berlin**. This example receiver module uses three GNU
Radio OOT blocks to demodulate and decode the telemetry beacon (see [telemetry
format]) currently sent by the four picosatellites [BEESAT-5...8]) from TU
Berlin.
weisenbergertub90's avatar
weisenbergertub90 committed
9

bastla's avatar
bastla committed
10
11
12
13
For further information, questions or suggestions do not hesitate to contact
the BEESAT-5...8 team (see below). We would be very pleased if all users send
us their received data (audio files, log files and raw data). The principal
point of contact for decoding and data aggregation is Steffen Weisenberger.
weisenbergertub90's avatar
weisenbergertub90 committed
14

bastla's avatar
bastla committed
15
### Missions
weisenbergertub90's avatar
weisenbergertub90 committed
16

bastla's avatar
bastla committed
17
Current satellites using this protocol:
weisenbergertub90's avatar
weisenbergertub90 committed
18

bastla's avatar
bastla committed
19
- [BEESAT-5...8]
weisenbergertub90's avatar
weisenbergertub90 committed
20

bastla's avatar
bastla committed
21
### Setup
weisenbergertub90's avatar
weisenbergertub90 committed
22

weisenbergertub90's avatar
weisenbergertub90 committed
23
**Required modules and libraries:**
bastla's avatar
bastla committed
24
- GNU Radio 3.8
weisenbergertub90's avatar
weisenbergertub90 committed
25
26
27
28
- Boost
- SWIG
- Python

weisenbergertub90's avatar
weisenbergertub90 committed
29
**Install instructions:**
weisenbergertub90's avatar
weisenbergertub90 committed
30
- Clone or download the project.
bastla's avatar
bastla committed
31
32
- Create a 'build' directory within 'gr-mobitub3'.
- Inside the build folder run following commands in a terminal:
weisenbergertub90's avatar
weisenbergertub90 committed
33
34
35
36
37
  - `cmake ..`
  - `make`
  - `sudo make install`
  - `sudo ldconfig`

weisenbergertub90's avatar
weisenbergertub90 committed
38
**Update instructions:**
bastla's avatar
bastla committed
39
- Download recent repository version using:
weisenbergertub90's avatar
weisenbergertub90 committed
40
  - `git pull`
bastla's avatar
bastla committed
41
- Inside the build folder run following commands in a terminal:
weisenbergertub90's avatar
weisenbergertub90 committed
42
43
44
45
  - `make`
  - `sudo make install`
  - `sudo ldconfig`

bastla's avatar
bastla committed
46
### Usage
weisenbergertub90's avatar
weisenbergertub90 committed
47

weisenbergertub90's avatar
weisenbergertub90 committed
48
**Operation instructions:**
bastla's avatar
bastla committed
49
50
51
52
53
- Open the GNU Radio flowgraph using the Companion GUI or a terminal with the
  commands:
   1. `cd gr-mobitub3/examples`
   2. `gnuradio-companion Beacon_Receiver.grc`
- Execute flowgraph (play button)
weisenbergertub90's avatar
weisenbergertub90 committed
54

weisenbergertub90's avatar
weisenbergertub90 committed
55
**Note:**
bastla's avatar
bastla committed
56
57
Radio control (doppler shift) and antenna control w.r.t. the operator location
must be provided by the operator (e.g. Gpredict or SatNOGS).
weisenbergertub90's avatar
weisenbergertub90 committed
58

bastla's avatar
bastla committed
59
Four different inputs are available, only one input at a time must be enabled:
weisenbergertub90's avatar
weisenbergertub90 committed
60
- 'Wav File Source' to play an audio file.
weisenbergertub90's avatar
weisenbergertub90 committed
61
- 'File Source' to play a raw data file.
weisenbergertub90's avatar
weisenbergertub90 committed
62
63
64
- 'Audio Source' to use a radio.
- 'UHD: USRP Source' to use SDR hardware.

bastla's avatar
bastla committed
65
66
67
68
69
70
71
72
73
74
It could be necessary to adjust the input to your device. If available we
suggest to use the 'UHD: USRP Source'. The `QT GUI` and 'Waterfall Sink' could
be disabled if another input source is enabled.

Output messages are printed to the terminal. The received messages are also
stored in a log file on your computer, see the directory
`TU_BERLIN_SDR_meta_files`. Audio files and raw data will be stored after being
enabled in the flowgraph ('Wav File Sink' and 'File Sink') in GNU Radio. 

### Contacts
weisenbergertub90's avatar
weisenbergertub90 committed
75

bastla's avatar
bastla committed
76
77
- GNU Radio 3.7 Implementation: Steffen Weisenberger <weisenberger@tu-berlin.de>
- GNU Radio 3.8 Port: Sebastian Lange <lange@tu-berlin.de>
weisenbergertub90's avatar
weisenbergertub90 committed
78

bastla's avatar
bastla committed
79
80
[BEESAT-5...8]: https://www.space.tu-berlin.de/menue/research/current_projects/beesat_5_6_7_8/
[telemetry format]: gr-mobitub3/docs/BEESAT-5...8_Telemetry_Format_2021-02-08.ods