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
|
From 0a9f945fe49de1653681589711a31f2431522282 Mon Sep 17 00:00:00 2001
From: Nobuhiko Tanibata <NOBUHIKO_TANIBATA@xddp.denso.co.jp>
Date: Wed, 29 Jan 2014 15:53:59 +0900
Subject: [PATCH 01/15] README modifed for ivi-shell
changes for amendament v1:
add ivi-shell/README.
move description of ivi-shell from README to ivi-shell/README
Signed-off-by: Nobuhiko Tanibata <NOBUHIKO_TANIBATA@xddp.denso.co.jp>
--------------------------------------------------------------------
changes for v2:
ivi-shell: Update README more details
Signed-off-by: Nobuhiko Tanibata <NOBUHIKO_TANIBATA@xddp.denso.co.jp>
Signed-off-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
---
ivi-shell/README | 79 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 79 insertions(+)
create mode 100644 ivi-shell/README
diff --git a/ivi-shell/README b/ivi-shell/README
new file mode 100644
index 0000000..7f41291
--- /dev/null
+++ b/ivi-shell/README
@@ -0,0 +1,79 @@
+ In-vehicle infotainment (information and entertainment)
+ graphical environment support modules for Weston
+
+
+IVI-shell is an alternative shell for Weston, a Wayland display server.
+Window management and application interaction with the display server
+are very different to that of a normal desktop, which is why this is
+a separate shell and not an extension to the desktop-shell suite with
+xdg_shell. As such, applications need to be specifically written to use
+IVI-shell.
+
+IVI-shell contains two main features:
+- Common layout library for surface, which allow ivi-shell developer
+ to develop own shell, linking Common layout library.
+ For the time being, the library refers Genivi ilm interface.
+
+ http://projects.genivi.org/wayland-ivi-extension/
+
+- Extension protocal; ivi-application to tie wl_surface and a given ID.
+ With this ID, shell can identify which wl_surface is drawn by which
+ application. In in-vehicle infortainment system, a shell has to update
+ a property of a wl_surface. E.g. there may be a use case when vehicle
+ starts to move, the wl_surface drawn by Car navigation is expected to
+ move top of surfaces.
+
+The actual software components delivered with Weston are:
+
+- ivi-application.xml:
+ Wayland protocol extension for IVI-applications; the public
+ shell protocol (the same concept as xdg_shell).
+ Implemented by ivi-shell.so.
+
+- ivi-shell.so:
+ A Weston shell module that implements ivi-application.xml interfaces.
+ Loads ivi-layout.so.
+
+- ivi-layout.so:
+ Implements the IVI window management concepts: Screen, Layer,
+ Surface, groups of Layers, groups of Surfaces, see:
+ http://projects.genivi.org/ivi-layer-management/node/13
+ Offers a stable API for writing IVI-controller modules like
+ hmi-controller.so against the IVI concepts. In other words,
+ it offers an API to write IVI window manager modules.
+
+- hmi-controller.so:
+ A sample implementation of an IVI-controller module, usually
+ replaced by IVI system vendors.
+ Uses ivi-layout.so to perform essentially window manager tasks.
+ This implementation keeps all window management inside the module,
+ while IVI-systems may use another module that exposes all window
+ management via Wayland or other protocol for an external process
+ to control:
+ http://git.projects.genivi.org/?p=wayland-ivi-extension.git;a=summary
+
+- ivi-hmi-controller.xml:
+ Wayland protocol extension for IVI display control; the private
+ shell protocol for weston-ivi-shell-user-interface client
+ (the same concept as desktop-shell.xml).
+ Implemented by hmi-controller.so, and usually replaced by IVI
+ system vendors.
+
+- weston-ivi-shell-user-interface:
+ A sample implementation of an IVI shell helper client, usually
+ replaced by IVI system vendors.
+ A helper client for basic display content, similar to
+ weston-desktop-shell.
+
+
+How to compile:
+same as weston. To disable, use option: --disable-ivi-shell for configure.
+
+How to configure weston.ini:
+reference ini file will be generated in <build_dir>/ivi-shell.
+
+How to run:
+same as weston. exec weston.
+
+How to use UI:
+http://lists.freedesktop.org/archives/wayland-devel/attachments/20140625/abbfc064/attachment-0001.png
--
1.7.9.5
|
