Creating a DVAP or DVRPTR hotspot based on a Raspberry Pi or a BeagleBone Black that
can connect to both DStar reflectors as well as XREF reflectors based on Scott Lawson
KI4LKF software is easy.

Start with a Raspberry Pi with the latest Raspbian image (see http://raspberrypi.org)
or a BeagleBone Black with the latest Debian image (see http://www.armhf.com). Scott's
software will EASILY fit on the on-board memory of the BBB, but you will still
need a uSD card to install the armhf.com Debian image to the on-board memory.

You will need several packages to build Scott's gateway. The RasPi will probably have
all or moste of these but it still doesn't hurt to be sure:

sudo su
apt-get update
apt-get upgrade
apt-get install make g++ unzip git

and maybe a few more. Here is one of my favorites: apt-get install avahi-daemon
Then you can "ssh <user>@<hostname>.local" instead of "ssh <user>$<ip address>.

After you install are the required packages, the gateway installation can begin.
Go to your login home directory and (without root privileges type:

git clone git://github.com/ac2ie/g2_ircddb.git

This will create a g2_ircddb directory with everything you need to build a dvap gateway.

The first order of business is to build the necessary wxBase-2.8.12 library. There is a
script in the g2_ircddb directory to do all of this for you. Just cd to g2_ircddb and
type:

./build_wxBase

Come back to this directory and type "make" to build all the executables, g2_ircddb,
g2_link and dvap_rptr. If you need DTMFS then also execute "make g2link_test".

Next, edit all the *.cfg files, g2_ircddb.cfg, g2_link.cfg and either dvap_rptr.cfg
or dvrptr.cfg. These files contain detailed comments about all of the values you need
to set. Just read through the configuration files and edit accordingly. Additional
information about the configuration as well as other important and useful features are
also in the CONFIGURING file.

The gwys.txt file is the internet address and port numbers for any gateway you would
like g2_link to be able to connect to. The one delivered with this package is special:
It has only X-reflectors and DStar reflectors and the X-reflectors are configured
with the 20001 port. This will allow you to connect to both DStar repeaters and XREF
reflectors without opening any ports on your router. If you want to set up a repeater
or access point, you will need to port-forward several ports to your RasPi or BBB.
Of course you will also need to lock down the local address of the device with 
either a static IP or by reserving an address from your router. There are MANY OTHER
gateways to which you can connect. Executing get_gwys_list.sh will download a HUGE list
of reflectors and gateways with port address that may need port-forwarding to your
sytem. Just rememer if you update gwys.txt, you will have to reboot your system before
the changes will be available.

If you plan on using DTMFS, you can also edit proc_g2_ircddb_dtmfs.sh to add new dtmfs
commands.

Then install your system, g2_ircddb, g2_link and either dvap_rptr or dvrptr. Start by
typing "sudo make installg2". This will install g2_ircddb and g2_link and all the
files they require. Then either dvap_rptr or dvrptr by typing "sudo make installdvap"
or "sudo make installdvrptr", respectively. Finally, if you want/need DTMFS, type
"sudo make installdtmfs".

This will install the service scripts and symbolic links in /etc/init.d and everything
else in /usr/local. The executables will be in /usr/local/bin and the *.cfg files and
other data will be in /usr/local/etc. If you find that you need to modify a
configuration file, do it in /usr/local/etc. If you edit the files in the build
directory, you will either have to copy these modified configuration files you you will
 have to reinstall the application.

At this point, you can either reboot to start the three or four services, or start them
manually with the "service" command. (See the man page for service.)

You can clean up the build directory of intermediate *.o files with "make clean" or, you
can remove the intermediate *.o files and binary executables with "make realclean".

If you want to uninstall everything return to the build directory and type
"sudo make uninstallg2" and either "sudo make unistalldvap" or "sudo make
uninstalldvrptr" and possibly "sudo make uninstalldtmfs". This will shutdown the and
remove the service scripts and links and remove most everything from /usr/local.

Tom Early, ac2ie@arrl.net