wiki:Documentation/HOWTO/Mint_installation
Last modified 11 months ago Last modified on 05/17/13 02:09:26

Installing, and building on Mint


  1. Installing the OS
  2. Build environment
  3. Build dependencies
  4. Preparing the home directory to build the fldigi family of applications.
  5. Getting the source
  6. Compiling fldigi
  7. Installing the binaries
  8. Build Hint
  9. Uninstalling
  10. Building and installing the other programs
  11. Pulse Audio Volume Control
    1. Desktop Launch Icons
    2. Panel launch icons
  12. 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 you current Windows OS and make it selectable when your 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.

Build environment

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.list
    
    Insert 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 multiverse
    
    Close 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.

Build dependencies

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

"tarballs" directory.

  • 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.70.tar.gz

The current version of fldigi is 3.21.70 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.70.tar.gz

You should now have a source directory for fldigi-3.21.70 in your app-src directory.

Compiling fldigi

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.70
./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:

./configure --help

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:

--enable-optimizations=type
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:

make

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.

Build Hint

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.

Uninstalling

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.07.tar.gz
wget http://www.w1hkj.com/downloads/flmsg/flmsg-1.1.22.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.4.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:

http://www.w1hkj.com/download.html

Build and install the application:

cd ~/app-src
tar xzf ../tarballs/flrig-1.3.07.tar.gz
cd flrig-1.3.07
./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, flwrap and fllog.

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.

Last step

Your last step should be to add yourself to the dialout group Serial Port Setup