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
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
|
<html>
<head>
<link href="style.css" rel="stylesheet" type="text/css" />
<title>osmocom-analog</title>
</head>
<body>
<center><table><tr><td>
<h2><center>Software installation</center></h2>
<center><img src="install.png"/></center>
<p>
<ul>
<li><a href="#introduction">Introduction</a>
<li><a href="#ins_vm">Installing in a Virtual Machine</a>
<li><a href="#ins_ubuntu">Installing Ubuntu</a>
<li><a href="#ins_libs">Installing Libraries</a>
<li><a href="#ins_osmocom">Installing osmocom-analog</a>
<li><a href="#test">Test</a>
</ul>
</p>
<p class="toppic">
<a name="intro"></a>
Introduction
</p>
<p>
This document is a step-by-step tutorial on how to install osmocom-analog on Ubuntu.
It should work similar on Debian, Raspberry PI and similar distributions.
</p>
<p>
All osmocom-analog networks can run on sound card connected to radio transmitters and receivers.
This is quite heavy to handle and finding a usable transmitter and receiver - and this for each network and channel.
I highly suggest to use SDR.
In this tutorial I use LimeSDR (or LimeSDR Mini) to make things as easy as possible.
</p>
<p class="toppic">
<a name="ins_vm"></a>
Installing in a Virtual Machine
</p>
<center><img src="install_vm.png"/></center>
<p>
I do not recommend to use a virtual machine, especially for running C-Netz, which does not work, if there is a slight buffer underrun or overrun.
It might work with other networks.
You may try it out.
Skip this, if you want to install osmocom-analog on a real machine.
</p>
<p>
Download VirtualBox from <h href="https://www.virtualbox.org/">https://www.virtualbox.org</a>.
Follow the installation guide there for your OS.
Be sure to install the extension package, so that you can use USB2.0 / USB3.0 which you need to pass through LimeSDR or LimeSDR Mini.
</p>
<p>
Create a virtual machine with the following settings:
</p>
<p>
<ul>
<li>Create a virtual machine with Ubuntu (64-bit)
<li>Choose memory size of at least 2 GB
<li>Create a virtual hard drive with 25 GB
<li>Emulate sound with output and input
<li>Select USB 3.0 (xHCI) Controller
</ul>
<p>
Your machine should now be able to boot and ask for an installation medium.
Choose the Ubuntu installation ISO as optical drive image.
</p>
<p class="toppic">
<a name="ins_ubuntu"></a>
Installing Ubuntu
</p>
<center><img src="install_ubuntu.png"/></center>
<p>
Download Ubuntu from <a href="https://ubuntu.com/">https://ubuntu.com</a>.
You may choose to install the desktop or server version.
In this tutorial I will install the desktop version, because it is much easier.
Burn this ISO image onto a CD or create a bootable USB stick.
</p>
<p>
Start your machine and Ubuntu should load from installation image.
The installer will automatically start.
In this tutorial I select <b>"Install Ubuntu"</b> and do a <b>"Minimal installation"</b>.
In case you install it on a virtual machine, select <b>"Erase disk and install Ubuntu"</b>.
Please refer to the Ubuntu installation guide for more details.
</p>
<p class="toppic">
<a name="ins_libs"></a>
Installing Libraries
</p>
<p>
osmocom-analog has very little dependencies on libraries.
No all are required, but you need to install libraries, depending on what you want to do.
</p>
<p>
Hint: Press "L-CTRL + L-ALT + T" to open a terminal.
</p>
<p>
If you want to connect analog radio equipment or just a headset to talk through the base station with the mobile use, you need Alsa Sound support.
If you don't have Alsa support, the mobile user will only hear a test music when calling.
Also if you want to bridge calls or use Osmo-CC interface, you do not need sound support.
</p>
<pre>
# sudo apt install libasound2-dev
</pre>
<p>
If you want to use SDR support, you need to install SoapySDR library and tools.
It is also possible to use UHD devices, but this is beyond the scope of this document.
To make things easy, I use LimeSDR or LimeSDR Mini.
Ubuntu also installs all drivers for SoapySDR, including "lime".
</p>
<pre>
# sudo apt install libsoapysdr-dev
# sudo apt install soapysdr-tools
</pre>
<p>
If you want to emulate the software clone of "Datenklo", an analog modem, you need (beside sound support) Fuse, for emulating a serial device in user space.
</p>
<pre>
# sudo apt install libfuse3-dev
</pre>
<p>
If you want to generate a TV signal, you can read PPM images. If you want other images to be read, you need Imagemagick 7, which is (currently) not available for Ubuntu.
Please refer to <a href="https://linuxconfig.org/how-to-install-imagemagick-7-on-ubuntu-18-04-linux">https://linuxconfig.org/how-to-install-imagemagick-7-on-ubuntu-18-04-linux</a> on how to install it manually.
</p>
<p class="toppic">
<a name="ins_osmocom"></a>
Installing osmocom-analog
</p>
<p>
You need two libraries, the first is "libosmocore". It is included with Ubuntu/Debian:
</p>
<pre>
# sudo apt install libosmocore-dev
</pre>
<p>
The next library is "libosmo-cc". It is not included with Ubuntu/Debian, so you need to install it from GIT.
Use GIT to clone latest source repository. First you need to install GIT.
</p>
<pre>
# sudo apt install git
</pre>
<p>
Then you can clone libosmo-cc from <a href="https://gitea.osmocom.org/cc/libosmo-cc">https://gitea.osmocom.org/cc/libosmo-cc</a> in your home directory.
</p>
<pre>
# cd ~
# git clone https://gitea.osmocom.org/cc/libosmo-cc
Cloning into 'libosmo-cc'...
...
</pre>
<p>
Before you can compile, you need to install <b>"autoconf"</b>, <b>"gcc"</b> and <b>"make"</b>, and <b>"libtool"</b>.
</p>
<pre>
# sudo apt install autoconf gcc make libtool
</pre>
<p>
Change to the repository directory and run <b>"autoreconf -if"</b> once. This is only needed the first time compiling. It will generate the configure script.
</p>
<pre>
# cd libosmo-cc
# autoreconf -if
...
#
</pre>
<p>
Run configure script. It will generate the make files depending on your supported libraries.
</p>
<pre>
# ./configure
</pre>
<p>
Run <b>"make"</b> and <b>"make install"</b> to build and install osmocom-analog. Don't forget to run <b>"ldconfig"</b>, so you library database does know it.
</p>
<pre>
# make clean # always do this after you pulled from GIT server
# make
...
# sudo make install
...
# sudo ldconfig
# cd ..
</pre>
<p>
Use GIT to clone latest source repository. First you need to install GIT.
</p>
<p>
Then you can clone osmocom-analog from <a href="https://gitea.osmocom.org/cellular-infrastructure/osmocom-analog">https://gitea.osmocom.org/cellular-infrastructure/osmocom-analog</a> in your home directory.
</p>
<pre>
# cd ~
# git clone https://gitea.osmocom.org/cellular-infrastructure/osmocom-analog
Cloning into 'osmocom-analog'...
...
</pre>
<p>
Change to the repository directory and run <b>"autoconf -if"</b> once. This is only needed the first time compiling. It will generate the configure script.
</p>
<pre>
# cd osmocom-analog
# autoreconf -if
configure.ac:15: installing './compile'
configure.ac:25: installing './config.guess'
configure.ac:25: installing './config.sub'
configure.ac:6: installing './install-sh'
configure.ac:6: installing './missing'
extra/Makefile.am: installing './depcomp'
#
</pre>
<p>
Run configure script. It will generate the make files depending on your supported libraries.
</p>
<pre>
# ./configure
...
checking for ALSA... yes
checking for UHD... no
checking for SOAPY... yes
checking for IMAGEMAGICK... yes
checking for FUSE... yes
configure: Compiling with Alsa support
configure: UHD SDR not supported. Consider adjusting the PKG_CONFIG_PATH
environment variable if you installed software in a non-standard prefix.
configure: Compiling with SoapySDR support
configure: Compiling with ImageMagick
configure: Compiling with FUSE
..
#
</pre>
<p style="background-color: yellow;">
If you get something like "sytax error near unexpected token `ALSA,`", check, if pkg-config is installed. If you just installed it, run "autoreconf -if" again and then "./configure".
</p>
<p>
Run <b>"make"</b> and <b>"make install"</b> to build and install osmocom-analog.
</p>
<pre>
# make clean # always do this after you pulled from GIT server
# make
...
# sudo make install
...
# cd ..
</pre>
<p class="toppic">
<a name="test"></a>
Test
</p>
<p>
To test Audio, use Ubuntu's settings to see if you get audio working at all, before you search for problems at osmocom-analog.
If you can hear sound, you can run B-Netz which should give a clean FSK audio signal.
</p>
<pre>
# bnetz -k 17
...
</pre>
<p>
You shoud get audio.
If not, check out the volume setting.
Try ohter software that uses Alsa sound output.
</p>
<p>
To test SDR, check you USB device.
In case of a virtual machine you need to pass through the LimeSDR device.
In this example, LimeSDR is connected to Device 2 of Bus 2.
</p>
<pre>
# lsusb
Bus 002 Device 002: ID 1d50:6108 OpenMoko, Inc. Myriad-RF LimeSDR
Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
Bus 001 Device 002: ID 80ee:0021 VirtualBox USB Tablet
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
</pre>
<p>
Now check if the SoapySDR driver finds a device with driver <b>"lime"</b>.
</p>
<pre>
# SoapySDRUtil --find
######################################################
## Soapy SDR -- the SDR abstraction library ##
######################################################
...
Found device 3
addr = 1d50:6108
driver = lime
label = LimeSDR-USB [USB 3.0] 9062000C42D1A
media = USB 3.0
module = FX3
name = LimeSDR-USB
serial = 0009062000C42D1A
#
</pre>
<p>
If this is the case you can try to run a base station.
I suggest to use a B-Netz base station, because it transmits a nice FSK sound at 153.330 MHz.
Use a radio to listen to that frequency.
</p>
<pre>
# bnetz --limesdr -k 17 # for LimeSDR
# bnetz --limesdr-mini -k 17 # for LimeSDR Mini
</pre>
<p>
Do you hear the whistling sound on your radio? Now you can continue with the radio setup.
</p>
<hr><center>[<a href="index.html">Back to main page</a>]</center><hr>
</td></tr></table></center>
</body>
</html>
|
