blob: 54bf154d155fa9e3de99d69ea84dd6adf3d93e3a (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
|
------------------------------------------------------------------------
AGL-Advanced-Audio-Agent
------------------------------------------------------------------------
# Cloning Audio-Binding from Git
-------------------------------------------------------
```
# Initial clone with submodules
git clone --recurse-submodules https://github.com/iotbzh/audio-bindings
cd audio-binding
# Do not forget submodules with pulling
git pull --recurse-submodules https://github.com/iotbzh/audio-bindings
```
# AFB-daemon dependencies
-------------------------------------------------------
OpenSuse >=42.2, Fedora>=25, Ubuntu>=16.4 Binary packages from https://en.opensuse.org/LinuxAutomotive
For other distro see # Building AFB-daemon from source on Standard Linux Distribution
# Specific Dependencies
* cmake >= 3.6
* alsa-devel >= 1.1.2 Warning some distro like Fedora-25 still ship version 1.1.1 as default
* lua >= 5.3 Most distribution only ship version 5.2 but binary package should be easy to find
```
OpenSuse
- cmake 3.6 Take the Tumbleweed version https://software.opensuse.org/ymp/openSUSE:Factory/standard/cmake.ymp?base=openSUSE%3AFactory&query=cmake
- LUA-5.3-devel https://software.opensuse.org//download.html?project=devel%3Alanguages%3Alua&package=lua53
- Alsa-devel zypper --install alsa-devel # 42.3 is shipped default with 1.1.4
Fedora 26 (out of the box)
- cmake 3.6
- Lua 5.3
- Alsa-devel 1.1.4
```
# Compile AGL-Advanced-Audio-Agent
--------------------------------------
* Edit your ~/.config/app-templates/cmake.d/00-common-userconf.cmake to reflect your local configuration
```
message(STATUS "*** Fulup Local Config For Native Linux ***")
add_compile_options(-DNATIVE_LINUX)
set (RSYNC_TARGET "10.20.101.198")
set (RSYNC_PREFIX "opt")
set(CMAKE_INSTALL_PREFIX $ENV{HOME}/opt)
set(BINDINGS_INSTALL_PREFIX $ENV{HOME}/opt)
set(CMAKE_PREFIX_PATH ${CMAKE_INSTALL_PREFIX}/lib64/pkgconfig ${CMAKE_INSTALL_PREFIX}/lib/pkgconfig)
set(LD_LIBRARY_PATH ${CMAKE_INSTALL_PREFIX}/lib64 ${CMAKE_INSTALL_PREFIX}/lib)
```
```
mkdir -p build
cd build
cmake -DCMAKE_INSTALL_PREFIX=$INSTALL_PREFIX ..
make
afb-daemon --workdir=. --ldpaths=. --port=1234 --roothttp=../htdocs --token="" --verbose
Warning: See below net on GDB requiring (--workdir=.)
```
# Note: GDB Source Debug limits/features
Warning: technically AGL bindings are shared libraries loaded thought 'dlopen'. GDB supports source debug of dynamically
loaded libraries, but user should be warn that the actual path to sharelib symbols is directly inherited from DLOPEN.
As a result if you change your directory after binder start with --workdir=xxx then GDB will stop working.
Conclusion: double-check that --workdir=. and run debug session from ./build directory. Any IDEs like Netbeans or VisualCode should work out of the box.
```
Examples:
# WORK when running in direct
afb-daemon --workdir=.. --ldpaths=build --port=1234 --roothttp=./htdocs
# FAIL when using GDB with warning: Could not load shared library ....
gdb -args afb-daemon --workdir=.. --ldpaths=build --port=1234 --roothttp=./htdocs
...
warning: Could not load shared library symbols for ./build/ucs2-afb/afb-ucs2.so.
Do you need "set solib-search-path" or "set sysroot"?
...
```
To debug sharelib symbol path: start your binder under GDB. Then break your session after the binder has
loaded its bindings. Finally use "info sharedlibrary" and check 'SymsRead'. If equal to 'No' then either you start GDB
from the wrong relative directory, either you have to use 'set solib-search-path' to force the path.
```
gdb -args afb-daemon --workdir=.. --ldpaths=build --port=1234 --roothttp=./htdocs
run
...
NOTICE: API UNICENS added
NOTICE: Waiting port=1234 rootdir=.
NOTICE: Browser URL= http://localhost:1234
(hit Ctrl-C to break the execution)
info sharedlibrary afb-*
```
# ToBeBone (WorkInProgess: This list is getting longer every day)
-------------------------------------------------------------------
* Support response from LUA with nested table (currently fail miserably)
* Add timer base callback from Lua
* Enable export of LUA commands directly from Plugin
# Running an debugging on a target
-------------------------------------------------------
```
export RSYNC_TARGET=root@xx.xx.xx.xx
export RSYNC_PREFIX=/opt # WARNING: installation directory should exist
mkdir $RSYNC_TARGET
cd $RSYNC_TARGET
cmake -DRSYNC_TARGET=$RSYNC_TARGET -DRSYNC_PREFIX=$RSYNC_PREFIX ..
make remote-target-populate
./build/target/start-${RSYNC_TARGET}.sh
firefox http://localhost:1234 # WARNING: do not forget firewall if any
ssh -tt ${RSYNC_TARGET} speaker-test -twav -D hw:ep01 -c 2
```
Note: remote-target-populate will
- create a script to remotely start the binder on the target in ./build/target/start-on-target-name.sh
- create a gdbinit file to transparently debug remotely in source code with gdb -x ./build/target/gdb-on-target-name.ini
- to run and debug directly from your IDE just configure the run and debug properties with the corresponding filename
- run a generic control and pass virtual channel as a parameter (check remaning PCM in plugin)
Note that Netbeans impose to set debug directory to ./build/pkgout or it won't find binding symbols for source debugging
# Building AFB-daemon from source on Standard Linux Distribution
-------------------------------------------------------
# handle dependencies > (OpenSuse-42.2, Fedora-25, Ubuntu 16.04.2LTS)
gcc > 4.8
systemd-devel (libsystemd-dev>=222)
libuuid-devel
file-devel(OpenSuSe) or libmagic-dev(Ubuntu)
libjson-c-devel
ElectricFence (BUG should not be mandatory)
libopenssl-devel libgcrypt-devel libgnutls-devel (optional but requested by libmicrohttpd for https)
OpenSuse >=42.2
zypper in gcc5 gdb gcc5-c++ git cmake make ElectricFence systemd-devel libopenssl-devel libuuid-devel alsa-devel libgcrypt-devel libgnutls-devel libjson-c-devel file-devel mxml-devel
Ubuntu >= 16.4 libuuid-devel
apt-get install cmake git electric-fence libsystemd-dev libssl-dev uuid-dev libasound2-dev libgcrypt20-dev libgnutls-dev libgnutls-dev libjson-c-dev libmagic-dev libmxml-dev
libmicrohttpd>=0.9.55 (as today OpenSuse-42.2 or Ubuntu-.16.4 ship older versions)
afb-daemon from AGL Gerrit git clone https://gerrit.automotivelinux.org/gerrit/src/app-framework-binder
```
# Might want to add following variables into ~/.bashrc
echo "#---------- AGL options Start ---------" >>~/.bashrc
echo "# Object: AGL cmake option for binder/bindings" >>~/.bashrc
echo "# Date: `date`" >>~/.bashrc
echo 'export CC=gcc-5; export CXX=g++-5' >>~/.bashrc # if using gcc5
echo 'export INSTALL_PREFIX=$HOME/opt' >>~/.bashrc
echo 'export LD_LIBRARY_PATH=$INSTALL_PREFIX/lib64:$INSTALL_PREFIX/lib' >>~/.bashrc
echo 'export LIBRARY_PATH=$INSTALL_PREFIX/lib64:$INSTALL_PREFIX/lib' >>~/.bashrc
echo 'export PKG_CONFIG_PATH=$INSTALL_PREFIX/lib64/pkgconfig:$INSTALL_PREFIX/lib/pkgconfig' >>~/.bashrc
echo 'export PATH=$INSTALL_PREFIX/bin:$PATH' >>~/.bashrc
echo 'export RSYNC_TARGET=MY_TARGET_HOSTNAME' >>~/.bashrc
echo 'export RSYNC_PREFIX=./opt' >>~/.bashrc
echo "#---------- AGL options End ---------" >>~/.bashrc
source ~/.bashrc
# install LibMicroHttpd
LIB_MH_VERSION=0.9.55
wget https://ftp.gnu.org/gnu/libmicrohttpd/libmicrohttpd-${LIB_MH_VERSION}.tar.gz
tar -xzf libmicrohttpd-${LIB_MH_VERSION}.tar.gz
cd libmicrohttpd-${LIB_MH_VERSION}
./configure --prefix=${INSTALL_PREFIX}
make
sudo make install-strip
# retrieve last AFB_daemon from AGL
git clone https://gerrit.automotivelinux.org/gerrit/src/app-framework-binder
# Warning: previous GCC options should be set before initial cmake (clean Build/*)
cd app-framework-binder; mkdir -p build; cd build
cmake -DCMAKE_INSTALL_PREFIX=$INSTALL_PREFIX ..
make
make install
```
|
