DStar 101, or How do I do that in DStar?

Compiling and installing ircDDBGateway and DStarrepeater on Linux

I have successfully compiled on most Debian based flavours of Linux, including on a Raspberry Pi.
Raspberry Pi users please note, each module takes around 2hrs to compile.

Please note many of these screen shots are from older versions of the software however the compile is exactly the same.

Thankfully there are people in this world who are far smarter than me.

You need to perform this install with an account that is capable of running as Super User. If you installed the OS then you are probably "good to go", if you didn't it may be worth checking first.

As of January 2014, the whole PC Repeater Controller has changed somewhat, in that some DStar components, such as DVAPnode and DVRPTRRepeater, are now integrated into dstarrepeater. However this in no way chages the manner in which the software is compiled on a Linux computer. The instructions below will still work.

The compile and install process for both of these applications is very similar. These instructions are for Ubuntu, however a little common sense and you can work through this in other Debian based based versions that use different GUIs.

First thing that you need to do is register on Yahoo Groups, and join the Pcrepeatercontroller  and the ircDDBGateway groups, tell the moderator why you want to join, and add your callsign to the request if you have one. Once registered and accepted go to the Files section of the group webpage, look for a folder release open that and download the latest zip file for each application.

Use archive manager to unzip the files, I suggest you accept the default folder name, and unzip to your home folder.

Extract Files

Extract Files

Extract Files

Click on "Extract"

Before you proceed any further, you will need to install several libraries, sounds a lot harder than it is. In your Linux desktop do:-

Launch "Synaptic Package Manager", how you launch this will depend upon the version of Linux.

If you don't have "Synaptic Package Manager" you can install it using this How to.

You will be prompted for a password.

Now use the search facility to locate, and mark for installation the following packages (some of these may already be installed, dont panic).

wx2.8-headers
wx-common
libwxgtk2.8-0
libwxgtk2.8-dev
libwxbase2.8-0
libwxbase2.8-dev
portaudio19-dev
libportaudio2
build-essential
libusb-dev
g++
libusb-1.0-0
libusb-1.0.0.dev

Now you need to click on the Apply button for the files to be downloaded and installed. This may take a few minutes, so go get coffee, tea, etc.

As an alternative to the above, if you are comfortable with using the terminal:

Open a Terminal window ctl+alt+t

In the  terminal window type (or cut and paste from here)

sudo apt-get install wx2.8-headers wx-common libwxgtk2.8-0 libwxgtk2.8-dev libwxbase2.8-0 libwxbase2.8-dev portaudio19-dev libportaudio2 build-essential libusb-dev g++ libusb-1.0-0 libusb-1.0.0.dev

Now you are ready to compile the program and install. This requires some terminal work, dont worry its simple enough, if youre new to Linux just remember it is case sensitive to the syntax of anything you type in at the terminal.

Open a terminal window ctl+alt+t
You will see a prompt similar to
username@computername:~$
At this stage you are in your Home directory, Type ls (LS means list) and hit return.
You will see a list of files and directories in your home folder.

List files

Your listing may not look exactly the same, but you get the idea.
You should see a directory or folder called DStarRepeater.
To enter that folder type :
cd DStarRepeater,  hit return. (cd means change directory).
Type ls again and you will see a list of files that are in the Repeater folder.

List files
Type: make and hit return.

The compile will start, you will see lot's of info scroll up the screen.

Time for another tea or coffee.

Compile starts

The compile should finish without any issues, however if you get any errors, go and check that the libraries listed above are installed.

Now you have to install the program.
Still in the terminal window (you didnt close it did you?)
Type:

sudo make install

hit return

You will be prompted for a password, type it in and hit return.
The programs will now be installed.
The usual location for the files to be installed in /usr/local/bin. You can get a listing of the files by typing:

ls /usr/local/bin

You should see something like this.


usrlocalbin listing

OK so that's the DStarrepeater software compiled.

------------------------------------------------------------------

Now you need to compile and install ircDDBGateway.

Open a terminal window: Applications Accessories Terminal. (ctl+alt+t)
You will see a prompt similar to
username@computername:~$
At this stage you are in your Home directory, Type ls (LS means list) and hit return.
You will see a list of files and directories in your home folder.

List files

Your listing may not look exactly the same, but you get the idea.
You should see a directory or folder called ircDDBGateway.
To enter that folder type :
cd ircDDBGateway  hit return. (cd means change directory).
Type ls again and you will see a list of files that are in the ircDDBGateway folder.

ircddbgateway list files


Type: make and hit return.
Time for another tea or coffee.
The compile should finish without any issues, however if you get any errors, go and check that the libraries listed above are installed.

Now you have to install the program.
Still in the terminal window (you didnt close it did you?)
Type:

sudo make install

hit return

You will be prompted for a password, type it in and hit return.
The programs will now be installed.
The usual location for the files to be installed in /usr/local/bin. You can get a listing of the files by typing: ls /usr/local/bin
You should see something like this.

usrlocalbin listing

To run any of the applications open a terminal, and type

sudo <name of the program you want to run>
Set all your preferences, once you have it all working fine you won't need to run as sudo.

Now obviously you dont want to have to run the program from a terminal every time you want to use it.
The following instructions are from Ubuntu 10.10, and should work with any version before that, however Ubuntu 12.04 and derivatives thereof have made this process a lot more difficult.

You can create a launcher on the desktop for the programs.
Right click on the Desktop, and select Create Launcher.
You get a window like this

DStarRepeater launcher

This example is for the ircddbgateway.

The command path is the only part of this that is critical.
ircddbgateway command path is : /usr/local/bin/ircddbgateway
dstarrepeater command path is : /usr/local/bin/dstarrepeater

If you add the GUI update switch at the end of the command like, so it looks like

/usr/local/bin/ircddbgateway -gui

or

/usr/local/bin/dvapnode -gui

You won't have to enable the GUI update everytime you run the software.

The pcrepeatercontroller suite has many different components dependent upon what configuration of repeater/node you are running.

You can create a launcher for any of the programs that you will find in  /usr/local/bin.

You can click on the icon and make the icon any image file you want, try doing that in windows.

For Ubuntu 12.04 and beyond, you can create a desktop launcher like this.

Open a text editor, gedit is fine.

Copy and paste the following into the file

[Desktop Entry]
Version=x.y
Name=ircddbgateway
Comment=launches the ircddbgateway with the GUI enalbled
Exec=ircddbgateway -gui
Icon=/usr/share/icons/gnome/48x48/apps/preferences-system-sharing.png
Terminal=false
Type=Application
Categories=Utility;Application;

The above is just an example, what icon you use is entirely up to you.

Now save the file to your desktop as ircddbgateway.desktop. Close gedit.

right click on the file on the desktop, select the Permissions tab, and select "allow executing file as a program.

Make launcher executable

Note that the launcher now appears on the desktop with the selected icon.
Icon appears on desktop

You can now also create a launcher for DStarRepeater, procedure is the same, but referencing dstarrepeater -gui as the executable.


You only need  to do the following if you intend to use the file logging facility.
You need to change the permissions on the /var/log folder.

Open a terminal window, and type
cd /var
sudo chgrp <yourname> log
sudo chmod 775 log

If you are not comfortable working in the terminal, you can change the group and permissions like this:-

Open a terminal window, and type
sudo nautilus
enter password. Word of warning here, you are now using the Nautilus file browser with super user rights, so dont go deleting anything, because now you have the power to delete anything.

Click on File System, find the var folder and open it, then find the log folder, and do a right click on that. Click on the permissions tab,

Change the Group to your name, then click the Apply Permissions to Enclosed files button at the bottom of the window. Then close.

Some versions of Linux have a group called "dialout", if your version of linus uses this group you will have to add your user account to the group.

Dependent upon the version of linux you may be able to do this through the Users and Groups manager GUI, however if you don't have that you can do this through a terminal session.

sudo usermod -a -G dialout your_user_ID

Thats it you are done.

Have fun and look forward to a QSO.

Links you may find useful.

http://groups.yahoo.com/group/pcrepeatercontroller/
http://groups.yahoo.com/group/ircddbgateway