Work on docs
This commit is contained in:
Andreas Eversberg
parent
7670b22118
commit
f6440991ba
|
|
@ -76,21 +76,29 @@ A second sound card or ISDN card is used to route calls from and to the mobile p
|
|||
Please go to project's hompage at <a href="http://osmocom-analog.eversberg.eu">http://osmocom-analog.eversberg.eu</a> to download source code.
|
||||
</p>
|
||||
|
||||
<center>
|
||||
<p>
|
||||
Thanx to Laf0rge, there is a mailing list: <a href="https://lists.osmocom.org/mailman/listinfo/osmocom-analog">https://lists.osmocom.org/mailman/listinfo/osmocom-analog</a>.
|
||||
</p>
|
||||
|
||||
<p>
|
||||
General information:
|
||||
</p>
|
||||
|
||||
<center><table border="0"><tr><td>
|
||||
<ul>
|
||||
<li><a href="install.html">Software installation</a></li>
|
||||
<li><a href="setup.html">Analog Radio setup</a></li>
|
||||
<li><a href="sdr.html">SDR setup</a></li>
|
||||
<li><a href="install.html">Software installation</a></li>
|
||||
<li><a href="headset.html">Connecting headset</a></li>
|
||||
<li><a href="software.html">Software usage</a></li>
|
||||
</ul>
|
||||
</center>
|
||||
</td></tr></table></center>
|
||||
|
||||
<p>
|
||||
Implemented networks:
|
||||
</p>
|
||||
|
||||
<center>
|
||||
<center><table border="0"><tr><td>
|
||||
<ul>
|
||||
<li><a href="a-netz.html">A-Netz</a> (Germany)</li>
|
||||
<li><a href="b-netz.html">B-Netz</a> (Germany) ATF-1 (Netherlands)</li>
|
||||
|
|
@ -102,20 +110,20 @@ Implemented networks:
|
|||
<li><a href="radiocom2000.html">Radiocom 2000</a> (France)</li>
|
||||
<li><a href="eurosignal.html">Eurosignal</a> (Europe)</li>
|
||||
</ul>
|
||||
</center>
|
||||
</td></tr></table></center>
|
||||
|
||||
<p>
|
||||
Additional features:
|
||||
</p>
|
||||
|
||||
<center>
|
||||
<center><table border="0"><tr><td>
|
||||
<ul>
|
||||
<li><a href="datenklo.html">Das Datenklo</a></li>
|
||||
<li><a href="tv.html">Osmo TV</a></li>
|
||||
<li><a href="sim.html">C-Netz Sim Card</a></li>
|
||||
<li>C-Netz FuVSt (BSC to control a real base station)</li>
|
||||
<li>C-Netz FuVSt (MSC to control a real base station)</li>
|
||||
</ul>
|
||||
</center>
|
||||
</td></tr></table></center>
|
||||
|
||||
<br><br>
|
||||
|
||||
|
|
|
|||
|
|
@ -8,59 +8,333 @@
|
|||
|
||||
<h2><center>Software installation</center></h2>
|
||||
|
||||
<center><img src="install.png"/></center>
|
||||
|
||||
<p>
|
||||
To run this software, you need a Linux PC with development environment (gcc compiler).
|
||||
At least one Alsa sound interfaces is required.
|
||||
Two sound interfaces are required to talk and listen through the base station using a headset with microphone.
|
||||
<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>
|
||||
As you got the source code from GIT repository, run 'autoreconf -if' inside GIT repository's directory first:
|
||||
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 at least 10 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>
|
||||
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 osmocom-analog from <a href="git://git.osmocom.org/osmocom-analog">git://git.osmocom.org/osmocom-analog</a> in your home directory.
|
||||
</p>
|
||||
|
||||
<pre>
|
||||
|
||||
# cd ~
|
||||
# git clone git://git.osmocom.org/osmocom-analog
|
||||
Cloning into 'osmocom-analog'...
|
||||
...
|
||||
|
||||
|
||||
</pre>
|
||||
|
||||
<p>
|
||||
Before you can compile, you need to install <b>"autoconf"</b>, <b>"gcc"</b> and <b>"make"</b>.
|
||||
</p>
|
||||
|
||||
<pre>
|
||||
|
||||
# sudo apt install autoconf
|
||||
# sudo apt install gcc
|
||||
# sudo apt install make
|
||||
|
||||
</pre>
|
||||
|
||||
</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>
|
||||
Then compile:
|
||||
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>
|
||||
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
|
||||
...
|
||||
|
||||
</pre>
|
||||
|
||||
<p class="toppic">
|
||||
<a name="test"></a>
|
||||
Test
|
||||
</p>
|
||||
|
||||
<p>
|
||||
At your option:
|
||||
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>
|
||||
|
||||
# make install
|
||||
# bnetz -k 17
|
||||
...
|
||||
|
||||
</pre>
|
||||
|
||||
<p>
|
||||
Now you are ready for a quick test:
|
||||
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>
|
||||
|
||||
# src/bnetz/bnetz -k 1 -l 2
|
||||
bnetz.c:268 info : Entering IDLE state, sending 'Gruppenfreisignal' 2 on channel 1.
|
||||
Base station ready, please tune transmitter to 153.010 MHz and receiver to 148.410 MHz.
|
||||
To call phone, switch transmitter using pilot tone to 153.370 MHz
|
||||
# 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>
|
||||
Do you hear the whistling sound on your speaker/headset? Now you can continue with the radio setup.
|
||||
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>
|
||||
|
|
|
|||
Binary file not shown.
|
After Width: | Height: | Size: 6.1 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 153 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 113 KiB |
Loading…
Reference in New Issue