-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathCOMPILE.linux
123 lines (86 loc) · 4.66 KB
/
COMPILE.linux
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
Here the instructions for compile the deskHPSDR app under Linux.
You need to have basic knowledge, how you work with the shell.
1. First words and prerequisites
1.1 Linux distribution
This guidance is made for Debian-based distributions like Debian, Ubuntu or PiOS.
For other distributions you need to adopt this guidance by yourself. Basically deskHPSDR
should be run with any distribution, if all needed libraries are installed.
We do all at user level, if we need admin privileges we do it with sudo.
That means, we have and use a "rootless" system.
For first start with Linux we need as prerequisite the git tool.
Start a shell and do the following:
heiko@AfuPi5:~ $ sudo apt-get update
heiko@AfuPi5:~ $ sudo apt-get upgrade
heiko@AfuPi5:~ $ sudo apt-get --yes install build-essential
heiko@AfuPi5:~ $ sudo apt-get --yes install git
2. Get the source code from github.com:
heiko@AfuPi5:~ $ cd
heiko@AfuPi5:~ $ mkdir -p src
heiko@AfuPi5:~ $ cd src
heiko@AfuPi5:~/src $ git clone https://github.com/dl1bz/deskhpsdr.git
heiko@AfuPi5:~/src $ cd deskhpsdr
heiko@AfuPi5:~/src/deskhpsdr $
3. Prepare the Linux environment for compiling with the included shell script:
heiko@AfuPi5:~/src/deskhpsdr $ ./LINUX/prep_linux.sh
Per default only the base Soapy-API will be installed. If you want or need to use
Soapy API support in deskHPSDR, edit the make.config.deskhpsdr and set SOAPYSDR=ON.
The installation for Soapy modules does not become part of this guidance, that's your very
own task. I personally don't need the Soapy API-support, because I use a Hermes-Lite 2.
4. Compile the deskHPSDR
4.1 First edit make.config.deskhpsdr, but NOT the Makefile
Edit the make.config.deskhpsdr (not the Makefile !!!) and set the options you want.
Never change DESKTOP=ON to OFF, and check this settings too:
ATU=OFF
COPYMODE=OFF
DEVEL=OFF
The other options you can set how you want or need.
4.2 Compiling
We can now compile deskHPSDR:
heiko@AfuPi5:~/src/deskhpsdr $ make
4.3. Copy some needed fonts to your system
For best desktop experience I collect some free availible fonts, published under the GPLv3 licence,
so we can use them. So please install the fonts, deskHPSDR need them:
heiko@AfuPi5:~/src/deskhpsdr $ sudo mkdir -p /usr/share/fonts/opentype/GNU
heiko@AfuPi5:~/src/deskhpsdr $ sudo cp ./X11fonts/*.otf /usr/share/fonts/opentype/GNU
5. A little help from me to install deskHPSDR in X11 environment easier
After step 4, hopeful successful, you can do this:
heiko@AfuPi5:~/src/deskhpsdr $ make x11install
This will copy the deskhpsdr binary to /usr/local/bin and prepare your X11 environment for easy start deskHPSDR.
In your X11 menu you should find in one of the sub-menus deskhpsdr as menu entry. Where exact depends strongly
from your used X11 desktop environment and can be different from system to system.
Thats all, we're ready.
6. Update deskHPSDR
From time to time you need to update deskHPSDR. That means, we update the source code from github.com and recompile deskHPSDR.
If you want update the source code of deskhpsdr, start a shell and do this:
heiko@AfuPi5:~ $ cd
heiko@AfuPi5:~ $ cd src
heiko@AfuPi5:~/src $ cd deskhpsdr
heiko@AfuPi5:~/src/deskhpsdr $ git pull
heiko@AfuPi5:~/src/deskhpsdr $ make clean
heiko@AfuPi5:~/src/deskhpsdr $ make
heiko@AfuPi5:~/src/deskhpsdr $ make x11install
Have fun with the updated version !
-------------------------------------------------------------------------------
7. Troubleshooting:
-------------------------------------------------------------------------------
It could happen that "git pull" fails. The reason mostly is, you changed local files and
git pull don't know now, which site is up-to-date - local or remote. You can delete the complete deskhpsdr directory
and start again:
heiko@AfuPi5:~ $ cd
heiko@AfuPi5:~ $ cd src
heiko@AfuPi5:~/src $ rm -fr deskhpsdr
heiko@AfuPi5:~/src $ git clone https://github.com/dl1bz/deskhpsdr.git
heiko@AfuPi5:~/src $ cd deskhpsdr
heiko@AfuPi5:~/src/deskhpsdr $
The second problem are changes in make.config.deskhpsdr, but we need to do this. Please don't make any
changes in the Makefile, only in make.config.deskhpsdr. We do this now:
heiko@AfuPi5:~/src/deskhpsdr $ git update-index --assume-unchanged make.config.deskhpsdr
It tells git, that we want to ignore all (local) changes in make.config.deskhpsdr. After this, "git pull" should
work again correct.
8. Remarks
I check this instructions with my Pi5 and PiOS 64bit. All is working great.
I use Pulseaudio for audio support (not ALSA) and GPIO support is activated too.
And I use the classical X11 environment, not the newer Wayfire/Labwc (not stable enough yet and
too much issues up to now). You can change the X11 environment in PiOS with raspi-config.
Thats all, folks :)
73 Heiko, DL1BZ