Copyright
Copyright © 2012, GENIVI Alliance, Inc. Copyright © 2012, BMW AG
This file is part of GENIVI Project AudioManager.
Contributions are licensed to the GENIVI Alliance under one or more Contribution License Agreements or MPL 2.0 .
© Copyright This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/.
author Christian Linke = Christian Linke christian.linke@bmw.de BMW 2011-2015
For further information see http://projects.genivi.org/audio-manager/.
Repositories
The main repository is http://git.projects.genivi.org-AudioManager.git
The repository for example plugins can be found here: http://git.projects.genivi.org/AudioManagerPlugins.git
License
The licenses of this project are split into two parts:
1) the AudioManagerDaemon, licensed under MPL 2.0
2) the plugins that serve as example code that can be taken to build up an own project with it - these parts are licensed with the MIT license
Contribution is done under GENIVI CLA or MPL2.0.
Version
The current version can be taken out of the git. The version 1.0.0 is the first GENIVI compliant code,in the compliance statement of discovery (2.0). For every GENIVI release, there is a release of the AudioManager, each of the releases have an own bugfix branch that will get the most important fixes. Development is done on the master branch.
Versioning Scheme
The versioning scheme was decided in the February face2face 2012. The firs number describes the release branch. This is 1 for discovery, 2 for excalibur and 3 for photon. For major features or release, the second number will be increased. Each new GENIVI version (releases are every half year, around april and october) will get the current HEAD (for example 2.0.34 for excalibur) and release with the increase of the second number (2.1). The next commit on the master branch gets then the new first numner (3) and starts from zero.
For the daemon the third number (for example 1.0.X) describes the patch version. The versions are automatically created by git during the build process. The versioning scheme is used for the AudioManager daemon itself and for each of it’s interfaces. The versioning of the Interfaces in EA is defined via the tag "version" and the name of the interfaceversion versionName, for example "CommandReceiveVersion". This information is generated into the interface header files and is used then by cmake to set the interface versions. Whenever changes are done, the minor version of the interface needs to be incremented.
Since 7.0, the AudioManager follows a new versioning scheme. Please check the documentation for that.
Documentation
A very detailed documentation is provided by doxygen. In order to use this, please compile the AudioManager with
cmake -DWITH_DOCUMENTATION=ON make The README is compiled into README.html with asciidoc
COMPILE PROGRAMS
Compile Options
These are the compile options with default values:
AM_MAP_CAPACITY 10 AM_MAX_CONNECTIONS 0x1000 AM_SHARE_FOLDER /usr/local/share/audiomanager BUILD_SHARED_LIBS OFF CMAKE_BUILD_TYPE CMAKE_INSTALL_PREFIX /usr/local COMMON_API_DBUS_LIBRARY /usr/local/lib/libCommonAPI-DBus.so COMMON_API_LIBRARY /usr/local/lib/libCommonAPI.so DBUS_SERVICE_OBJECT_PATH /org/genivi/audiomanager DBUS_SERVICE_PREFIX org.genivi.audiomanager DEFAULT_TELNETPORT 6080 DOC_OUTPUT_PATH XXX/build/doc DYNAMIC_ID_BOUNDARY 100 EXECUTABLE_OUTPUT_PATH XXX/build/bin GLIB_DBUS_TYPES_TOLERANT ON LIB_INSTALL_SUFFIX audiomanager MAX_TELNETCONNECTIONS 3 NSM_BUS_INTERFACE org.genivi.NodeStateManager NSM_INTERFACE org.genivi.NodeStateManager.Consumer NSM_PATH /org/genivi/NodeStateManager PLUGINS_OUTPUT_PATH XXX/build/plugins TEST_EXECUTABLE_INSTALL_PATH ~/tests TEST_EXECUTABLE_OUTPUT_PATH XXX/build/bin/tests USE_BUILD_LIBS ON WITH_DATABASE_STORAGE OFF WITH_DLT ON WITH_DOCUMENTATION OFF WITH_ENABLED_IPC CAPI WITH_NSM OFF WITH_SYSTEMD_WATCHDOG OFF WITH_TELNET ON WITH_TESTS ON gmock_build_tests OFF gtest_build_samples OFF gtest_build_tests OFF gtest_disable_pthreads OFF gtest_force_shared_crt OFF
Passing options to cmake:
Standard CMake can be used to configure these options. Tools like ccmake can be used to visually change the values. For each option, some hints are given.
Build dependencies
Basically, all build dependencies are optional- but you might need to use some if you want to have support for Dbus, for example…
You will need optionally fullfill some dependencies in order to comile the GENIVI AudioManager Daemon, these are:
-
dbus (only when DBUS_WRAPPER==ON) [tested on version 1.2.16]
-
sqlite3 [tested on version 3.6.22] (only when WITH_DATABASE_STORAGE==ON)
-
automotive-dlt [greater 2.5.0] (only when WITH_DLT==ON)
-
doxygen [tested on version 1.6.3] (only when WITH_DOCUMENTATION==ON)
-
commonAPI [version > 2.1] (only with WITH_ENABLED_IPC CAPI), more information here http://projects.genivi.org/commonapi/
To install them in a build environment like Ubuntu you can use:
sudo apt-get install libdbus-1-dev libsqlite3-dev doxygen git cmake build-essential
AudioManagerUtilities
In the AudioManagerUtilites you can find hany helper functions that can be reused by other projects as well.
The NodeStateManager
The nodestatemanager headers are needed to compile the audiomanager. If the nodestatemanagerincludes are not found, the headers shipped with the audiomanager are used. The nodestatemanager can be retrieved from projects.genivi.org .
Please note that the NSM interface must be compatible with Dbus properties. This requires for CommonAPI to use the commonAPI fdepl. It used to work, but currently with CommmonAPI 2.6.1 the generation does not work anymore.
CommonAPI File generation
The audiomanager will search in /usr/share or /usr/local/share for a generator. He will generate all neccessary files with this generator into the build tree.
The adresses used for commonAPI are fixed. If you need to change them, you can use a central or local configure file. More information on CommonAPI documentation: http://projects.genivi.org/commonapi/
Tests
For building the tests, you will need the following packages:
-
python [tested on version 2.6, should work on higher versions as well]
GoogleMock and GoogleTest are as source code integrated in the sourcetree To install them in a build environment like Ubuntu you can use:
sudo apt-get install python2.6-dev
For compiling, you will need a compiler, linker etc. On most linux systems you will get this via
sudo apt-get install build-essential
More details in the CMake Files CmakeList.txt in the projects.
Compiling
To compile open a shell, browse to the AudioManager folder and
mkdir /build cd build cmake .. make
The AudioManager executable will be placed in the bin folder of your build folder, tests in a subfolder below.-
In order to install the AudioManager, you can do
sudo make install
this installs everything.
Build targets
Several install targets exists:
just install the audiomanager
sudo make bin-install
just install the dev package with all headers and cmake file, needed to compile plugins out of source
sudo make dev-install
just install the tests
sudo make test-install
just install the plugins (only available if plugins are compiled)
sudo make plugins-install
just install the test for the plugins (only available if plugins are compiled)
sudo make plugin-test-install
If you want to compile the Audiomanager together with the plugins, simply clone the plugins into a folder Plugins on the mainlevel. The Plugins will be then compiled together with the AudioManager.
If the plugins are compiled seperatly, the AudioManager needs to be installed on the system. The plugins will find and read the important CMake variables and use them.
Adding own plugins
To keep the own sources away from the GENIVI code the project specific elements can be reconfigured with own type definitions. You can copy paste the CMake scripts from the example plugins for example.
/** * This type gives the information about reason for Source/Sink change */ typedef uint16_t am_CustomAvailabilityReason_t; static const am_CustomAvailabilityReason_t AR_UNKNOWN = 0; /** new media was entered */ static const am_CustomAvailabilityReason_t AR_GENIVI_NEWMEDIA = 1; /** same media was entered */ static const am_CustomAvailabilityReason_t AR_GENIVI_SAMEMEDIA = 2; /** there is no media or media is removed */ static const am_CustomAvailabilityReason_t AR_GENIVI_NOMEDIA = 3; /** there was a temperature event */ static const am_CustomAvailabilityReason_t AR_GENIVI_TEMPERATURE = 4; /** there was a voltage event */ static const am_CustomAvailabilityReason_t AR_GENIVI_VOLTAGE = 5; /** fatal errors on reading or accessing media */ static const am_CustomAvailabilityReason_t AR_GENIVI_ERRORMEDIA = 6; /** * This is a custom specific identifier of property. It can be used to * differentiate between interrupt source/sink, main source/sink, etc. */ typedef uint16_t am_CustomClassProperty_t; static const am_CustomClassProperty_t CP_UNKNOWN = 0; static const am_CustomClassProperty_t CP_GENIVI_SOURCE_TYPE = 1; static const am_CustomClassProperty_t CP_GENIVI_SINK_TYPE = 2; /** * This type classifies the format in which data is exchanged within a connection. * The type itself is project specific although there are some standard formats * defined. */ typedef uint16_t am_CustomConnectionFormat_t; static const am_CustomConnectionFormat_t CF_UNKNOWN = 0; /** plain mono */ static const am_CustomConnectionFormat_t CF_GENIVI_MONO = 1; /** stereo connection */ static const am_CustomConnectionFormat_t CF_GENIVI_STEREO = 2; /** analog connection */ static const am_CustomConnectionFormat_t CF_GENIVI_ANALOG = 3; /** automatic connection. */ static const am_CustomConnectionFormat_t CF_GENIVI_AUTO = 4; /** * Here are all SoundProperties that can be set via the CommandInterface. * This type is product specific and can be changed or extended. */ typedef uint16_t am_CustomMainSoundPropertyType_t; static const am_CustomMainSoundPropertyType_t MSP_UNKNOWN = 0; /** example value between -10 and +10 */ static const am_CustomMainSoundPropertyType_t MSP_GENIVI_TREBLE = 1; /** example value between -10 and +10 */ static const am_CustomMainSoundPropertyType_t MSP_GENIVI_MID = 2; /** example value between -10 and +10 */ static const am_CustomMainSoundPropertyType_t MSP_GENIVI_BASS = 3; /** * The notification types are project specific. */ typedef uint16_t am_CustomNotificationType_t; static const am_CustomNotificationType_t NT_UNKNOWN = 0; /** * The given ramp types here are just examples. For products, different ramp types * can be defined here. It is in the responsibility of the product to make sure * that the routing plugins are aware of the ramp types used. */ typedef uint16_t am_CustomRampType_t; static const am_CustomRampType_t RAMP_UNKNOWN = 0; /** sets directly the value without a ramp */ static const am_CustomRampType_t RAMP_GENIVI_DIRECT = 1; /** Sets the volume as fast as possible */ static const am_CustomRampType_t RAMP_GENIVI_NO_PLOP = 2; static const am_CustomRampType_t RAMP_GENIVI_EXP_INV = 3; static const am_CustomRampType_t RAMP_GENIVI_LINEAR = 4; static const am_CustomRampType_t RAMP_GENIVI_EXP = 5; /** * Within genivi only the some example properties are defined. * For products these should be changed or extended. */ typedef uint16_t am_CustomSoundPropertyType_t; static const am_CustomSoundPropertyType_t SP_UNKNOWN = 0; /** example treble value min =-10 max =10 */ static const am_CustomSoundPropertyType_t SP_GENIVI_TREBLE = 1; /** example mid value min =-10 max =10 */ static const am_CustomSoundPropertyType_t SP_GENIVI_MID = 2; /** example bass value min =-10 max =10 */ static const am_CustomSoundPropertyType_t SP_GENIVI_BASS = 3; /** * Describes the different system properties which are project specific. */ typedef uint16_t am_CustomSystemPropertyType_t; static const am_CustomSystemPropertyType_t SYP_UNKNOWN = 0;
CommandLine options
The commandline options of the AudioManager:
USAGE: ./AudioManager [-K <string>] [-m <int>] [-t <int>] [-i] [-r <string>] [-R <string>] [-l <string>] [-L <string>] [-c <string>] [--] [--version] [-h] Where: -K <string>, --controllerPluginArg <string> a test argument for the controller -m <int>, --maxConnections <int> Maximal number of connections for telnet -t <int>, --telnetport <int> The port that is used for telnet -i, --currentSettings print current settings and exit -r <string>, --RoutingPluginDir <string> path for looking for routing plugins -R <string>, --additionalRoutingPluginDirs <string> additional path for looking for routing plugins, can be used after -r option -l <string>, --CommandPluginDir <string> path for looking for command plugins -L <string>, --additionalCommandPluginDirs <string> additional path for looking for command plugins, can be used after -l option -c <string>, --controllerPlugin <string> use controllerPlugin full path with .so ending --, --ignore_rest Ignores the rest of the labeled arguments following this flag. --version Displays version information and exits. -h, --help Displays usage information and exits. The team of the AudioManager wishes you a nice day!
To learn more about the commandline options, check the doxygen documentation.
Telnet Server
The audiomanager has a build- in telnetserver that serves for debuggin purposes. If you compile your AudioManager with TelnetServer support (cmake -DWITH_TELNET=ON), you will be able to set with commandline argument -t the port number and with -m the maximum supported connections. The default telnet port is 6060.
telnet localhost 6060
#>Welcome to GENIVI AudioManager ver-0.0.1-37-ga004215 #>
#>help #################################################### ####### The following commands are supported: ###### #################################################### # #exit - quit telnet session #get - Go into 'get'-submenu #help - show all possible commands #info - Go into 'info'-submenu #list - Go into 'list'-submenu #set - Go into 'set'-submenu # #\>
#\>get # #\Get>help #################################################### ####### The following commands are supported: ###### #################################################### # #.. - one step back in menu tree (back to root folder) #exit - close telnet session #help - show all possible commands #recv - show receiverversion #routing - show current routing #sendv - show senderversion # #\Get>
#\Get>recv sendv .. help exit # Receiver versions: # Ctrl: 1 | Cmd: 1 | Routing: 1 # Sender versions: # Ctrl: 1 | Cmd: 1 | Routing: 1 #################################################### ######## The following commands are supported: ###### #################################################### # #exit - quit telnet session #get - Go into 'get'-submenu #help - show all possible commands #info - Go into 'info'-submenu #list - Go into 'list'-submenu #set - Go into 'set'-submenu # #Your wish is my command ... bye! #Connection closed by foreign host.
Code Formatting
The source code if formatted with eclipse, the style sheet used can be found in the Foo folder:
cmake/AudioManager_Codestyle.xml
Working on the code & contribution
git clone
git branch
git checkout <your branch> git branch
git branch working_branch
Start working, best practice is to commit smaller, compilable peaced during the work that makes it easier to handle later on.
git format-patch working_branch <your branch>
This creates a set of patches that are published via the mailing list.The patches will be discussed and then merged & uploaded on the git by the maintainer.
Patches can be accepted either under GENIVI Cla or MPL 2.0 (see section License). Please be sure that the signed-off-by is set correctly. For more, check out http://gerrit.googlecode.com/svn/documentation/2.0/user-signedoffby.html
_ _ _ __ __ / \ _ _ __| (_) ___ | \/ | __ _ _ __ __ _ __ _ ___ _ __ / _ \| | | |/ _` | |/ _ \| |\/| |/ _` | '_ \ / _` |/ _` |/ _ \ '__| / ___ \ |_| | (_| | | (_) | | | | (_| | | | | (_| | (_| | __/ | /_/ \_\__,_|\__,_|_|\___/|_| |_|\__,_|_| |_|\__,_|\__, |\___|_| |___/ QQ QQ[ qaap )4W? ayQap 4QQQ[ .awQap == $WWQF aaaa, ` QWQWQQ _aaap= J?QQP'| qQQWQQ6 - qyQQQgp )4QQQQ^ .yQQQQ, QQQQQQQ aa 4QQQW' )?QQQP' gmQQma ]QQQQp . WQQQQW ???? aQQQ6p _aQQQQa "??"+ qaaa, ]QQQQQQ jQQQQQQf -aaaap jQQWWQ )????' )4QQQQP' mQWQWQf ]WQQQQ jaaa QQQQQQf )WQQQQ yQQWWQp ayQQQap QQQQQQf )QQQQQ QQQQQQf ]QQQQQQQ, QQQQQQf ]QQQQD QQQQQQf ]QQQQQQQ[ QQQQQQf ??': QQQQQQf ]QQQQQQQ[ 4QQQQQf QQQQQQf ]QQQQQQQ[ =????'I QQQQQQf ]QQQQQQQ[ .4QQQQQ' ]QQQQQQQ[ ]??"- ]QQQQQQQ( ]4QQQQQ? : qaayQQQQQQQQQwaa ]mmmmmmmmmmmmmm ]mmmmmmg, ]mmm[ ]mmmm 4mmmg ymmm' ]mmmm pwLq jQQQQD???????QWWQf ]QQQP?????????? ]QQQWQQQQp ]QQQf ]QQQQ 4QQQ6. _yQQQ' ]QQQQ \!'a' ]QQQf )???' ]QQQ6aaaaaaaaap ]QQQf)4QQQ6, ]QQQf ]QQQQ |4QQQ6 jmQQQ'v ]QQQQ ]QQQ[ ]QQQQWWQQf ]QQQQQQQWQWQWQf ]QQQf ?QQQQa ]QQQf ]QQQQ i4QQQ6 qQQQQ' ]QQQQ ]QQQ6, . qQQQf ]QQQf ]QQQf ]4QQQ6jQQQf ]QQQQ 4QQQ6gQWQQ' ]QQQQ 4QQQQQQQQQQQQQQW' ]QQQQQQWQWQWQWQ ]QQQf i?QQQQQQQf ]QQQQ ]QQQQQQQ' ]QQQQ ++"??????????` ]""!"""""""""""S ]""!' ]"""!""' -""!" """!""' ]""!"