Config files

DSX configuration is done through dedicated configuration files. The following files are evaluated in order:

• $DSX_DIR/etc/dsx.conf

Default config, system wide.

• ~/.dsx.conf

In your home dir, default config, user wide

• ./dsx.conf

Setup for current directory / project.

Syntax

Config files have an "ini-like" syntax, much like windows ini files.

# Comment
; Another commentaire
[section]
key1 = value1
key2 = value2
key3 = multi-line
   value, subsequent lines to
   concatenate must begin with a
   whitespace character.
   
[another-section]
key = val

Parser has a great feature: it may extend contents of a variable within another with %(variable-name)s syntax:

[calc]
oper = 2x3
result = 6
long = the expression %(oper)s equals %(result)s
short = %(oper)s = %(result)s

DSX' interpretation

Section [defaults] describes sections to look at for project parts:

[defaults]
soclib = soclib-exemple
systemc = systemc-exemple
     
[systemc-exemple]
dir = /users/exemple/systemc-2.1.0
os = linux
     
[soclib-exemple]
dir = /users/exemple/soclib

This makes it easier to switch between different concurent configurations

Sections to fill

DSX config defines paths for your actual system configuration

• Compilation options and paths for SystemC, SystemCASS or any other SystemC implementation
• Path to SoCLIB
• Paths and prefixes to cross compilation software suite

SystemC, SystemCASS

Mandatory configuration items for SystemC implementation are:

• nickname

Type of implementation, possible values are: systemc, systemcass.

• cflags

Additionnal compile-time arguments, typically include paths, -W options, ...

• libdir

Additionnal link-time arguments, typically library paths

• libs

Libraries

• cxx

C++ compiler, default is g++.

Example:

[systemcass-labo]
; Globally substitued variables
dir=/users/outil/systemc/systemcass/systemcass/latest
os=i686-Linux.SLA4x

; Generic declaration
nickname=systemcass
cflags=-I%(dir)s/include -O3 -rdynamic
libdir=%(dir)s/lib-%(os)s
libs=-lsystemc -ldl -rdynamic
cxx=g++

Cross compilers

Options:

• cc-prefix

Prefix for tools' names

• cc-cflags

Additionnal compile time flags

Example:

[mipsel]
cc-prefix=mipsel-unknown-elf-
cc-cflags=-O2 -Wall

[ppc]
cc-prefix=/usr/local/cctools/ppc/bin/ppc-unknown-elf-
cc-cflags=-O2 -Wall