summaryrefslogtreecommitdiff
path: root/README
blob: fba779702b1979cf8da0c54f34710ce18ed1fa8c (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
Sections in this file describe:
- How to build
- Example applications
- How to test

How to build on different platforms
====================================

Pre-requisite: 
- Weston
- CMake required (version 2.6 or higher)
- Open GLES and EGL for example applications
- Gtest for the test suite

Build up
1. Pull the current codebase form the git repo
   E.g. git clone https://github.com/GENIVI/wayland-ivi-extension.git

2. Create a build directory
   E.g mkdir build_ivi_extension

3. In <build-dir> Generate build system for your platform using CMake.
   E.g. cd <build-dir>
        cmake -DCMAKE_TOOLCHAIN_FILE=<your setting *.cmake> ../

4. Start the build and install
   
   E.g. sudo make install

Example applications
====================================
  
Pre-requisite:
- Modify weston.ini to use ivi-shell.so
  Example:
    [core]
    shell=ivi-shell.so
    modules=ivi-controller.so

    [ivi-shell]
    ivi-input-module=ivi-input-controller.so

- Set Environmental values
  Example:
    export XDG_RUNTIME_DIR=/var/run/<your user name>/1000
    export LD_LIBRARY_PATH=<your installation path>/lib 

Start-up Weston:
   Syntax:  <your installation path>/bin/weston [wayland_display_to_listen_on]
   Example: /usr/bin/weston -Swayland-1

Start-up HMI helper:
   Syntax:  [wayland_display_to_connect_to] <your installation path>/bin/layer-add-surfaces <layer_id> <surface_count>
   Example: WAYLAND_DISPLAY=wayland-1 $HOME/bin/layer-add-surfaces 1000 1

EGLWLMockNavigation:
   Syntax:  [wayland_display_to_connect_to] <your installation path>/bin/EGLWLMockNavigation
   Example: WAYLAND_DISPLAY=wayland-1 $HOME/bin/EGLWLMockNavigation

How to test
====================================
1. Build the testsuite by setting BUILD_ILM_API_TESTS option.
   Example: cmake -DBUILD_ILM_API_TESTS
2. After starting up Weston run the testsuite.
   Syntax:  [wayland_display_to_connect_to] <your installation path>/bin/ivi-layermanagement-api-test
   Example: WAYLAND_DISPLAY=wayland-1 $HOME/bin/ivi-layermanagement-api-test