root/tags/2.0-beta1/SConstruct

#! /usr/bin/python
#
# Copyright (C) 2007-2008 Arnold Krille
# Copyright (C) 2007-2008 Pieter Palmers
# Copyright (C) 2008 Jonathan Woithe
#
# This file is part of FFADO
# FFADO = Free Firewire (pro-)audio drivers for linux
#
# FFADO is based upon FreeBoB.
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 2 of the License, or
# (at your option) version 3 of the License.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program.  If not, see <http://www.gnu.org/licenses/>.
#

FFADO_API_VERSION="8"
FFADO_VERSION="1.999.20"

import os
import re
from string import Template
import imp

build_dir = ARGUMENTS.get('BUILDDIR', "")
if build_dir:
        build_base=build_dir+'/'
        if not os.path.isdir( build_base ):
                os.makedirs( build_base )
        print "Building into: " + build_base
else:
        build_base=''

destdir = ARGUMENTS.get( 'DESTDIR', "" )

if not os.path.isdir( "cache" ):
        os.makedirs( "cache" )

opts = Options( "cache/"+build_base+"options.cache" )

#
# If this is just to display a help-text for the variable used via ARGUMENTS, then its wrong...
opts.Add( "BUILDDIR", "Path to place the built files in", "")

opts.AddOptions(
        BoolOption( "DEBUG", """\
Toggle debug-build. DEBUG means \"-g -Wall\" and more, otherwise we will use
  \"-O2\" to optimise.""", True ),
        BoolOption( "PROFILE", "Build with symbols and other profiling info", False ),
        PathOption( "PREFIX", "The prefix where ffado will be installed to.", "/usr/local", PathOption.PathAccept ),
        PathOption( "BINDIR", "Overwrite the directory where apps are installed to.", "$PREFIX/bin", PathOption.PathAccept ),
        PathOption( "LIBDIR", "Overwrite the directory where libs are installed to.", "$PREFIX/lib", PathOption.PathAccept ),
        PathOption( "INCLUDEDIR", "Overwrite the directory where headers are installed to.", "$PREFIX/include", PathOption.PathAccept ),
        PathOption( "SHAREDIR", "Overwrite the directory where misc shared files are installed to.", "$PREFIX/share/libffado", PathOption.PathAccept ),
        BoolOption( "ENABLE_BEBOB", "Enable/Disable the bebob part.", True ),
        BoolOption( "ENABLE_FIREWORKS", "Enable/Disable the ECHO Audio FireWorks avc part.", True ),
        BoolOption( "ENABLE_MOTU", "Enable/Disable the Motu part.", True ),
        BoolOption( "ENABLE_DICE", "Enable/Disable the DICE part.", False ),
        BoolOption( "ENABLE_METRIC_HALO", "Enable/Disable the Metric Halo part.", False ),
        BoolOption( "ENABLE_RME", "Enable/Disable the RME part.", False ),
        BoolOption( "ENABLE_BOUNCE", "Enable/Disable the BOUNCE part.", False ),
        BoolOption( "ENABLE_GENERICAVC", """\
Enable/Disable the the generic avc part (mainly used by apple).
  Note that disabling this option might be overwritten by other devices needing
  this code.""", False ),
        BoolOption( "ENABLE_ALL", "Enable/Disable support for all devices.", False ),
        BoolOption( "BUILD_TESTS", """\
Build the tests in their directory. As some contain quite some functionality,
  this is on by default.
  If you just want to use ffado with jack without the tools, you can disable this.\
""", True ),
    BoolOption( "BUILD_STATIC_TOOLS", "Build a statically linked version of the FFADO tools.", False ),
    EnumOption('DIST_TARGET', 'Build target for cross compiling packagers', 'auto', allowed_values=('auto', 'i386', 'i686', 'x86_64', 'none' ), ignorecase=2),
    BoolOption( "ENABLE_OPTIMIZATIONS", "Enable optimizations and the use of processor specific extentions (MMX/SSE/...).", False ),

        )

## Load the builders in config
buildenv=os.environ
vars_to_check = [
        'PATH',
        'PKG_CONFIG_PATH',
        'LD_LIBRARY_PATH',
        'XDG_CONFIG_DIRS',
        'XDG_DATA_DIRS',
        'HOME',
]
for var in vars_to_check:
        if os.environ.has_key(var):
                buildenv[var]=os.environ[var]
        else:
                buildenv[var]=''

env = Environment( tools=['default','scanreplace','pyuic','dbus','doxygen','pkgconfig'], toolpath=['admin'], ENV = buildenv, options=opts )


Help( """
For building ffado you can set different options as listed below. You have to
specify them only once, scons will save the last value you used and re-use
that.
To really undo your settings and return to the factory defaults, remove the
"cache"-folder and the file ".sconsign.dblite" from this directory.
For example with: "rm -Rf .sconsign.dblite cache"

Note that this is a development version! Don't complain if its not working!
See www.ffado.org for stable releases.
""" )
Help( opts.GenerateHelpText( env ) )

# make sure the necessary dirs exist
if not os.path.isdir( "cache/" + build_base ):
        os.makedirs( "cache/" + build_base )
if not os.path.isdir( 'cache/objects' ):
        os.makedirs( 'cache/objects' )

CacheDir( 'cache/objects' )

opts.Save( 'cache/' + build_base + "options.cache", env )

def ConfigGuess( context ):
        context.Message( "Trying to find the system triple: " )
        ret = os.popen( "admin/config.guess" ).read()[:-1]
        context.Result( ret )
        return ret

def CheckForApp( context, app ):
        context.Message( "Checking wether '" + app + "' executes " )
        ret = context.TryAction( app )
        context.Result( ret[0] )
        return ret[0]

def CheckForPyModule( context, module ):
        context.Message( "Checking for the python module '" + module + "' " )
        ret = True
        try:
                imp.find_module( module )
        except ImportError:
                ret = False
        context.Result( ret )
        return ret

tests = {
        "ConfigGuess" : ConfigGuess,
        "CheckForApp" : CheckForApp,
        "CheckForPyModule": CheckForPyModule,
}
tests.update( env['PKGCONFIG_TESTS'] )
tests.update( env['PYUIC_TESTS'] )

conf = Configure( env,
        custom_tests = tests,
        conf_dir = "cache/" + build_base,
        log_file = "cache/" + build_base + 'config.log' )

if not env.GetOption('clean'):
        #
        # Check if the environment can actually compile c-files by checking for a
        # header shipped with gcc.
        #
        if not conf.CheckHeader( "stdio.h", language="C" ):
                print "It seems as if stdio.h is missing. This probably means that your build environment is broken, please make sure you have a working c-compiler and libstdc installed and usable."
                Exit( 1 )
        #
        # ... and do the same with a c++-header. Because some distributions have
        # distinct packages for gcc and g++.
        #
        if not conf.CheckHeader( "iostream", language="C++" ):
                print "It seems as if iostream is missing. This probably means that your build environment is broken, please make sure you have a working c++-compiler installed and usable."
                Exit( 1 )

        #
        # The following checks are for headers and libs and packages we need.
        #
        allpresent = 1;
        allpresent &= conf.CheckHeader( "expat.h" )
        allpresent &= conf.CheckLib( 'expat', 'XML_ExpatVersion', '#include <expat.h>' )
        
        allpresent &= conf.CheckForPKGConfig();

        pkgs = {
                'libraw1394' : '1.3.0',
                'libavc1394' : '0.5.3',
                'libiec61883' : '1.1.0',
                'alsa' : '1.0.0',
                'libxml++-2.6' : '2.13.0',
                'dbus-1' : '1.0',
                }
        for pkg in pkgs:
                name2 = pkg.replace("+","").replace(".","").replace("-","").upper()
                env['%s_FLAGS' % name2] = conf.GetPKGFlags( pkg, pkgs[pkg] )
                if env['%s_FLAGS'%name2] == 0:
                        allpresent &= 0

        if not allpresent:
                print """
(At least) One of the dependencies is missing. I can't go on without it, please
install the needed packages for each of the lines saying "no".
(Remember to also install the *-devel packages!)

And remember to remove the cache with "rm -Rf .sconsign.dblite cache" so the
results above get rechecked.
"""
                Exit( 1 )

        # Check for C99 lrint() and lrintf() functions used to convert from
        # float to integer more efficiently via float_cast.h.  If not
        # present the standard slower methods will be used instead.  This
        # might not be the best way of testing for these but it's the only
        # way which seems to work properly.  CheckFunc() fails due to
        # argument count problems.
        oldcf = env['CFLAGS']
        oldcf = env.Append(CFLAGS = '-std=c99')
        if conf.CheckLibWithHeader( "m", "math.h", "c", "lrint(3.2);" ):
                HAVE_LRINT = 1
        else:
                HAVE_LRINT = 0
        if conf.CheckLibWithHeader( "m", "math.h", "c", "lrintf(3.2);" ):
                HAVE_LRINTF = 1
        else:
                HAVE_LRINTF = 0
        env['HAVE_LRINT'] = HAVE_LRINT;
        env['HAVE_LRINTF'] = HAVE_LRINTF;
        env.Replace(CFLAGS=oldcf)

        #
        # Optional checks follow:
        #
        env['ALSA_SEQ_OUTPUT'] = conf.CheckLib( 'asound', symbol='snd_seq_event_output_direct', autoadd=0 )

if conf.CheckForApp( "which pyuic" ) and conf.CheckForPyModule( 'dbus' ) and conf.CheckForPyModule( 'qt' ):
        env['PYUIC'] = True

        if conf.CheckForApp( "xdg-desktop-menu --help" ):
                env['XDG_TOOLS'] = True
        else:
                print """
I couldn't find the program 'xdg-desktop-menu'. Together with xdg-icon-resource
this is needed to add the fancy entry to your menu. But the mixer will be installed, you can start it by executing "ffadomixer".
"""

else:
        print """
I couldn't find all the prerequisites ('pyuic' and the python-modules 'dbus' and
'qt', the packages could be named like dbus-python and PyQt) to build the mixer.
Therefor the mixer won't get installed.
"""

config_guess = conf.ConfigGuess()

env = conf.Finish()

if env['DEBUG']:
        print "Doing a DEBUG build"
        # -Werror could be added to, which would force the devs to really remove all the warnings :-)
        env.AppendUnique( CCFLAGS=["-DDEBUG","-Wall","-g"] )
        env.AppendUnique( CFLAGS=["-DDEBUG","-Wall","-g"] )
else:
        env.AppendUnique( CCFLAGS=["-O2","-DNDEBUG"] )
        env.AppendUnique( CFLAGS=["-O2","-DNDEBUG"] )

if env['PROFILE']:
        print "Doing a PROFILE build"
        # -Werror could be added to, which would force the devs to really remove all the warnings :-)
        env.AppendUnique( CCFLAGS=["-Wall","-g"] )
        env.AppendUnique( CFLAGS=["-Wall","-g"] )


# this is required to indicate that the DBUS version we use has support
# for platform dependent threading init functions
# this is true for DBUS >= 0.96 or so. Since we require >= 1.0 it is
# always true
env.AppendUnique( CCFLAGS=["-DDBUS_HAS_THREADS_INIT_DEFAULT"] )

if env['ENABLE_ALL']:
        env['ENABLE_BEBOB'] = True
        env['ENABLE_FIREWORKS'] = True
        env['ENABLE_MOTU'] = True
        env['ENABLE_DICE'] = True
        env['ENABLE_METRIC_HALO'] = True
        env['ENABLE_RME'] = True
        env['ENABLE_BOUNCE'] = True

if env['ENABLE_BEBOB'] or env['ENABLE_DICE'] or env['ENABLE_BOUNCE'] or env['ENABLE_FIREWORKS']:
        env['ENABLE_GENERICAVC'] = True

env['BUILD_STATIC_LIB'] = False
if env['BUILD_STATIC_TOOLS']:
    print "Building static versions of the tools..."
    env['BUILD_STATIC_LIB'] = True

if build_base:
        env['build_base']="#/"+build_base
else:
        env['build_base']="#/"

#
# Uppercase variables are for usage in code, lowercase versions for usage in
# scons-files for installing.
#
env['BINDIR'] = Template( env['BINDIR'] ).safe_substitute( env )
env['LIBDIR'] = Template( env['LIBDIR'] ).safe_substitute( env )
env['INCLUDEDIR'] = Template( env['INCLUDEDIR'] ).safe_substitute( env )
env['SHAREDIR'] = Template( env['SHAREDIR'] ).safe_substitute( env )
env['bindir'] = Template( destdir + env['BINDIR'] ).safe_substitute( env )
env['libdir'] = Template( destdir + env['LIBDIR'] ).safe_substitute( env )
env['includedir'] = Template( destdir + env['INCLUDEDIR'] ).safe_substitute( env )
env['sharedir'] = Template( destdir + env['SHAREDIR'] ).safe_substitute( env )

env.Command( target=env['sharedir'], source="", action=Mkdir( env['sharedir'] ) )

env.Alias( "install", env['libdir'] )
env.Alias( "install", env['includedir'] )
env.Alias( "install", env['sharedir'] )
env.Alias( "install", env['bindir'] )

#
# shamelessly copied from the Ardour scons file
#

opt_flags = []
env['USE_SSE'] = 0

# guess at the platform, used to define compiler flags

config_cpu = 0
config_arch = 1
config_kernel = 2
config_os = 3
config = config_guess.split ("-")

# Autodetect
if env['DIST_TARGET'] == 'auto':
    if re.search ("x86_64", config[config_cpu]) != None:
        env['DIST_TARGET'] = 'x86_64'
    elif re.search("i[0-5]86", config[config_cpu]) != None:
        env['DIST_TARGET'] = 'i386'
    else:
        env['DIST_TARGET'] = 'i686'
    print "Detected DIST_TARGET = " + env['DIST_TARGET']

if ((re.search ("i[0-9]86", config[config_cpu]) != None) or (re.search ("x86_64", config[config_cpu]) != None)):
    
    build_host_supports_sse = 0
    build_host_supports_sse2 = 0
    build_host_supports_sse3 = 0

    if config[config_kernel] == 'linux' :
        
        if env['DIST_TARGET'] != 'i386':
            
            flag_line = os.popen ("cat /proc/cpuinfo | grep '^flags'").read()[:-1]
            x86_flags = flag_line.split (": ")[1:][0].split ()
            
            if "mmx" in x86_flags:
                opt_flags.append ("-mmmx")
            if "sse" in x86_flags:
                build_host_supports_sse = 1
            if "sse2" in x86_flags:
                build_host_supports_sse2 = 1
            #if "sse3" in x86_flags:
                #build_host_supports_sse3 = 1
            if "3dnow" in x86_flags:
                opt_flags.append ("-m3dnow")
            
            if config[config_cpu] == "i586":
                opt_flags.append ("-march=i586")
            elif config[config_cpu] == "i686":
                opt_flags.append ("-march=i686")

    if ((env['DIST_TARGET'] == 'i686') or (env['DIST_TARGET'] == 'x86_64')) \
       and build_host_supports_sse and env['ENABLE_OPTIMIZATIONS']:
        opt_flags.extend (["-msse", "-mfpmath=sse"])
        env['USE_SSE'] = 1

    if ((env['DIST_TARGET'] == 'i686') or (env['DIST_TARGET'] == 'x86_64')) \
       and build_host_supports_sse2 and env['ENABLE_OPTIMIZATIONS']:
        opt_flags.extend (["-msse2"])
        env['USE_SSE2'] = 1

    #if ((env['DIST_TARGET'] == 'i686') or (env['DIST_TARGET'] == 'x86_64')) \
       #and build_host_supports_sse2 and env['ENABLE_OPTIMIZATIONS']:
        #opt_flags.extend (["-msse3"])
        #env['USE_SSE3'] = 1

# end of processor-specific section
if env['ENABLE_OPTIMIZATIONS']:
    opt_flags.extend (["-fomit-frame-pointer","-ffast-math","-funroll-loops"])
    env.AppendUnique( CCFLAGS=opt_flags )
    env.AppendUnique( CFLAGS=opt_flags )
    print "Doing an optimized build..."

env['REVISION'] = os.popen('svnversion .').read()[:-1]
# This may be as simple as '89' or as complex as '4123:4184M'.
# We'll just use the last bit.
env['REVISION'] = env['REVISION'].split(':')[-1]

if env['REVISION'] == 'exported':
        env['REVISION'] = ''

env['FFADO_API_VERSION']=FFADO_API_VERSION

env['PACKAGE'] = "libffado"
env['VERSION'] = FFADO_VERSION
env['LIBVERSION'] = "1.0.0"

#
# To have the top_srcdir as the doxygen-script is used from auto*
#
env['top_srcdir'] = env.Dir( "." ).abspath

#
# Start building
#
env.ScanReplace( "config.h.in" )
# ensure that the config.h is updated with the version
env.Depends( "config.h", "SConstruct" )
env.Depends( "config.h", 'cache/' + build_base + "options.cache" )

env.Depends( "libffado.pc", "SConstruct" )
pkgconfig = env.ScanReplace( "libffado.pc.in" )
env.Install( env['libdir'] + '/pkgconfig', pkgconfig )

subdirs=['external','src','libffado','tests','support','doc']
if build_base:
        env.SConscript( dirs=subdirs, exports="env", build_dir=build_base+subdir )
else:
        env.SConscript( dirs=subdirs, exports="env" )

if 'debian' in COMMAND_LINE_TARGETS:
        env.SConscript("deb/SConscript", exports="env")

# By default only src is built but all is cleaned
if not env.GetOption('clean'):
    Default( 'src' )
    Default( 'support' )
    if env['BUILD_TESTS']:
        Default( 'tests' )

#
# Deal with the DESTDIR vs. xdg-tools conflict (which is basicely that the
# xdg-tools can't deal with DESTDIR, so the packagers have to deal with this
# their own :-/
#
if len(destdir) > 0:
        if not len( ARGUMENTS.get( "WILL_DEAL_WITH_XDG_MYSELF", "" ) ) > 0:
                print """
WARNING!
You are using the (packagers) option DESTDIR to install this package to a
different place than the real prefix. As the xdg-tools can't cope with
that, the .desktop-files are not installed by this build, you have to
deal with them your own.
(And you have to look into the SConstruct to learn how to disable this
message.)
"""
else:

        def CleanAction( action ):
                if env.GetOption( "clean" ):
                        env.Execute( action )

        if env.has_key( 'XDG_TOOLS' ) and env.has_key( 'PYUIC' ):
                if not env.GetOption("clean"):
                        action = "install"
                else:
                        action = "uninstall"
                mixerdesktopaction = env.Action( "xdg-desktop-menu %s support/xdg/ffado.org-ffadomixer.desktop" % action )
                mixericonaction = env.Action( "xdg-icon-resource %s --size 64 --context apps support/xdg/hi64-apps-ffado.png" % action )
                env.Command( "__xdgstuff1", None, mixerdesktopaction )
                env.Command( "__xdgstuff2", None, mixericonaction )
                env.Alias( "install", ["__xdgstuff1", "__xdgstuff2" ] )
                CleanAction( mixerdesktopaction )
                CleanAction( mixericonaction )

#
# Create a tags-file for easier emacs/vim-source-browsing
#  I don't know if the dependency is right...
#
findcommand = "find . \( -path \"*.h\" -o -path \"*.cpp\" -o -path \"*.c\" \) \! -path \"*.svn*\" \! -path \"./doc*\" \! -path \"./cache*\""
env.Command( "tags", "", findcommand + " |xargs ctags" )
env.Command( "TAGS", "", findcommand + " |xargs etags" )
env.AlwaysBuild( "tags", "TAGS" )
env.NoCache( "tags", "TAGS" )