Installing, and building on Mint (OUTDATED)
- Installing the OS
- Build environment
- Build dependencies
- Preparing the home directory to build the fldigi family of applications.
- Getting the source
- Compiling fldigi
- Installing the binaries
- Build Hint
- Building and installing the other programs
- Pulse Audio Volume Control
- Last step
Installing the OS
- Download the current ISO image from http://www.linuxmint.com/. Unless you are ready to rebuild various drivers I would recommend using the 32 bit image even if your computer is capable of 64 bit operation.
- This set of instructions was tested on Mint-13-mate. This is a large ISO image and requires burning to a DVD.
- Create the DVD as a bootable image of the ISO.
- Test drive the DVD by booting from it (do not install yet).
- Reboot the computer to your original OS.
- If you are going to install Mint as a dual boot with Windows on a single hard disk then you should compact the drive using the appropriate Windows program. Note the amount of free space on the hard drive. The Mint installation can get by with a 20 GByte partition.
- Reboot the computer from the Mint DVD and select install. The DVD has installation software which will re-partition your hard drive if this is a single hard drive installation.
- It will also create a new boot sector with a grub2 loader. The installation of the boot sector program should find your current Windows OS and make it selectable when you boot the computer. The new Mint will be the default, but you can change that after the installation is complete. Refer to the Mint / Ubuntu web sites for help on the OS installation.
Mint does not install the GNU compilation tools needed to build the fldigi family of applications.
- Open a command line terminal and enter the following sequence of commands
cd /etc/apt sudo nano sources.listInsert the following at the end of the file
deb-src http://us.archive.ubuntu.com/ubuntu/ precise main deb-src http://us.archive.ubuntu.com/ubuntu/ precise restricted deb-src http://us.archive.ubuntu.com/ubuntu/ precise universe deb-src http://us.archive.ubuntu.com/ubuntu/ precise multiverse deb-src http://us.archive.ubuntu.com/ubuntu/ precise-updates main deb-src http://us.archive.ubuntu.com/ubuntu/ precise-updates restricted deb-src http://us.archive.ubuntu.com/ubuntu/ precise-updates universe deb-src http://us.archive.ubuntu.com/ubuntu/ precise-updates multiverseClose and save with keyboard combinations, ctrl-O ctrl-X
- Enter the following sequence of commands
sudo apt-get update sudo apt-get install build-essential sudo apt-get install geany sudo apt-get install libjpeg-dev libxft-dev
The first command will install the GNU c/c++ compiler-linker. The second will install a very nice programmer's editor named "Geany." You can use Geany to examine various source code files with the code syntax highlighted in color. The last install will insure that "optional" libraries needed by fltk are available. These libraries are essential for fldigi and the other flxxx programs User Interface to employ clear crisp fonts.
Install the build dependencies for the version of fldigi in the Mint repositories:
sudo apt-get build-dep fldigi
The above command will install the packages that are needed to build the repository version of fldigi and all of the other fl_xxx applications you can download from the w1hkj.com web site. Those packages will enable you to build a full-featured binary of the latest version.
Preparing the home directory to build the fldigi family of applications.
I recommend maintaining the following directories in your home directory.
cd mkdir tarballs mkdir app-src
The tarballs directory will be used to contain all of the compressed source code files (tarballs).
The app-src directory will be used to contain the decompressed source code directories.
Getting the source
Download the latest source tarball.
- If you use a browser to obtain the files be sure to save the file to the
- You can obtain the latest source code without leaving the command line terminal:
cd cd tarballs wget http://www.w1hkj.com/downloads/fldigi/fldigi-3.21.83.tar.gz
The current version of fldigi is 3.21.83 You may need to change the version number in the future.
The source tarball contains all the files needed to compile fldigi.
cd ../app-src tar xzf ../tarballs/fldigi-3.21.83.tar.gz
You should now have a source directory for fldigi-3.21.83 in your app-src directory.
At this point you will have a source tree extracted from the tarball containing a configure script. The following command will prepare the source for compilation:
cd ~/app-src/fldigi-3.21.83 ./configure
The configure command generates the Makefiles that make uses to run the compiler and linker. configure has various options to fine-tune the build; you can see a list by running:
For more information about configure, required library versions, etc., refer to the INSTALL file contained in the source tree.
Some often-used configure switches for fldigi are listed below:
- Enables some compiler flags that can increase performance on modern x86 CPUs. If you have a recent gcc, use --enable-optimizations=native. Otherwise, use the highest SSE version supported by your CPU (you can check by running cat /proc/cpuinfo). SSE2 should give a nice speedup on all recent processors.
Check the configuration summary printed by configure to ensure that fldigi will be built with the required features. If a feature that you want is disabled, you are probably just missing a library development package that can be found in your distribution's repositories.
When you are happy with the build configuration run this command to compile the binaries:
Installing the binaries
When the compilation is finished, run this command to install fldigi :
sudo make install
This command will install the fldigi and flarq binaries, manual pages, icons and desktop launchers. If you install to the default /usr/local (or other appropriate directory on your system), you should see icons for fldigi and flarq in your Mint "Internet" menu.
When you are comfortable with the command line process you can chain operations.
./configure && make && sudo make install
where the && separator tells the shell program to execute the next command only if the preceding one(s) were successful.
Do not remove the source tree directory. You will be able to remove all files installed by make install with:
sudo make uninstall
Building and installing the other programs
flrig, flmsg, flwrap and fllog are just as easy to build and install
cd ~/tarballs wget http://www.w1hkj.com/downloads/flrig/flrig-1.3.15.tar.gz wget http://www.w1hkj.com/downloads/flmsg/flmsg-2.0.3.tar.gz wget http://www.w1hkj.com/downloads/flwrap/flwrap-1.3.4.tar.gz wget http://www.w1hkj.com/downloads/fllog/fllog-1.1.8.tar.gz wget http://www.w1hkj.com/downloads/flamp/flamp-2.1.02.tar.gz
Be aware that version #'s may change. Use your browser to look at any one of the downloads directories on the w1hkj.com web site. Simply enter the pathname of the url in your browser url line:
Build and install the application:
cd ~/app-src tar xzf ../tarballs/flrig-1.3.15.tar.gz cd flrig-1.3.15 ./configure make sudo make install
- Note: If you only have a single fldigi or single flrig etc source directory you can simplify moving to the source code top level directory. If you are currently in the app-src directory
pwd cd flrig*will put you in the correct directory. The "pwd" command simply echos the current directory to your terminal.
Repeat the above for flmsg, flamp, flwrap and fllog.
I like to create a little shell helper script in the app-src directory.
cd ~/app-src cat >build ./configure && make && sudo make install ctrl-C chmod a+x build
then from within each of the source directories execute
Or if you are using the bash shell you can create an alias and add it to the end of your ~/.bash.rc file
alias build='./configure --enable-optimizations=native && make && sudo make install'
Note that I've added the optimization flag to the ./configure command.
All of the applications are then available on your system "Internet" menu.
Pulse Audio Volume Control
The Ubuntu derived distributions do not seem to install the Pulse Audio Volume Control by default. You will need the volume control to elegantly complete the interface between the audio stream and fldigi. Pulse Audio Volume Control remembers the mixer settings and the audio codec associated with an application; very important for fldigi.
sudo apt-get install pavucontrol
Desktop Launch Icons
Adding a launch icon to the desktop is sublimely simple. Open the Internet main-menu item and right click on the application you want to put on the desktop. Select "Add to desktop" ... done!
Panel launch icons
Adding one of the fl_xxx application launchers to the panel bar at the bottom of the screen is equally simple.
- Open the Internet main-menu item
- Right click on the application (fldigi) you want to add to the panel. Select "Add to panel" ... done!
- You can now launch fldigi with a single click on the panel icon.
Your last step should be to add yourself to the dialout group Serial Port Setup