You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
QnetGateway/MMDVM.README

84 lines
4.1 KiB

Building a QnetGateway + MMDVMHost System
Copyright (C) 2018 by Thomas A. Early N7TAE
I'll assume you'll be doing this on a Raspberry Pi, but any modern Debian-based
system should work. It just needs a g++ compiler with version greater than 4.9.
These instructions assume you have configured your system with the locale, keyboard
and time zone. When choosing locale, always choose a "UTF-8" version of your
locale. And make sure you do "sudo apt-get update && sudo apt-get upgrade" before
your start. On a Raspberry Pi, you can do all of this with the configureation menu:
"sudo raspi-config".
If you are using a device that uses the GPIO header on the raspberry pi, you need to
disable the serial0 console in the /boot/cmdline.txt file: Remove the reference to
"console=serial0,115200" in this file. You should also disable bluetooth by adding:
"dtoverlay=pi3-disable-bt" (without the quotes) to the end of the /boot/config.txt.
In your home directory...
1) Clone the MMDVMHost repository: git clone git://github.com/g4klx/MMDVMHost.git
2) cd into the MMDVMHost directory and compile: make
If you're system has multiple processors, use: make -jx
where x is the number of processors on you system.
To tell how many processors you have: cat /proc/cpuinfo | grep processor | wc -l
3) Copy the ini file template: cp MMDVM.ini MMDVM.qn
4) Edit the MMDVM.qn file. Set your Callsign and Id. Turn off duplex. Enable an
external display, if you have one. Set the Frequency(s). Set the Latitude and
other location info if you want. Change the log levels. I use DisplayLevel=2
and FileLevel=0. Set the Port on your modem. Disable all services except for
D-Star (at least for now). Very important: Set the [D-Star] Module. For UHF
use B and for VHF use C.
5) Let's test it! Start it: ./MMDVMHost MMDVM.qn
6) Key your radio and see if the MMDVMHost responds with an acknowledgment. Then
you'll know that everything on the MMDVM side is fine.
7) Stop the MMDVMHost with a Control-C and edit the MMDVM.qn file again. Change
the [D-Star] AckReply=0
You won't/don't want this reply from MMDVMhost. You want the acknowledgment
from QnetGateway, it's more informative.
We'll come back to MMDVMHost later, but for now let's work on the QnetGateway.
8) cd back to the home directory and clone the QnetGateway. Type:
git clone git://github.com/n7tae/QnetGateway.git
9) Get into the build directory. Type: cd QnetGateway
10) You need a configuration file called qn.cfg for QnetGateway. Start the
configuration script: ./qnconfig
This script will allow you to change any configuration parameter from its
default value. At a minimum, you need to set your login callsign in the ircddb
section and define at least one module. If you want to use the legacy,
closed-source D-Plus reflectors and repeaters, be sure to enable it in the
D-Plus menu. Be sure to write out your configruation file after you have entered
all your changes, then you can exit the configuration script.
11) Next, your ready to install your software. For that, start the administration
script. Type: ./qnadmin
First you want to create you gwys.txt file. This file contains a list of
reflectors and repeaters you might like to link. Got into the gwys.txt menu
creation sub-menu with "gw" and select one of three different methods to
generate a gwys.txt file. You can add and/or delete records manually in
this sub-menu. Return to the main menu because your now ready to build and
install your system. Install your configured system with "is". This will
compile and install everything that you have configured.
12) You also need to install your MMDVMHost with "im".
You should be up and running now! Congratulations! <Fireworks!>
13) There are many additional things that can be done in the administration menu.
Enter the log menu with "l" and from there you can view logs from each
running process.
14) DTMF is _not_ enabled by default if you want it, type "id" in the main menu.
15) Build and start other MMDVMHost services...

Powered by TurnKey Linux.