Remove unnecessary file
[staging/HomeScreen.git] / README.md
index b3845aa..945957f 100644 (file)
--- a/README.md
+++ b/README.md
-AGL Home Screen reference implementation
+This project contains:
 
+HomeScreen: AGL Home Screen reference implementation
+HomeScreenSimulator: AGL Home Screen Simulator for development
+InputEventManager: AGL Input event manager
+interfaces: library with the D-Bus interfaces
+SampleAppTimeDate: AGL Sample Application for Home Screen Statusbar
+HomeScreenAppFrameworkBinderTizen: Binder for the TIZEN application framework
 
 AGL repo for source code:
 https://gerrit.automotivelinux.org/gerrit/#/admin/projects/staging/HomeScreen
+
 AGL repo for bitbake recipe:
-https://gerrit.automotivelinux.org/gerrit/#/admin/projects/AGL/meta-agl-demo
-[...]/recipes-hmi/homescreen
-
-
-
-v0.0.1
-06/01/2016
-
-#new features
-- initial version
-- first implementation of home screen
-- fix HMI layout (will be configurable in the future)
-- dBus as IPC (may change in the future)
-- no interaction with application manager so far
-- multi-lanuage support
-- day/night mode support
-- initial status bar implementation (interface will be enhanced in the future)
-- initial control bar implementation
-- MPLv2.0 license
-- input device simulator for developer build (not functional right now)
-- system settings simulator for developer build (day/night mode switch functional right now)
-- using QSettings for local app setting storage (may change in the future)
-- first popup implementation (single popup support for now; multiple popup not defined; interface will change)
-- only one instance of the app allowed
-
-#TODOs
-- many settings have to be read from the system somewhere during app startup. This is not available right now
-- interaction with application manager
-- interaction with wayland compositor
-- define and implement input device event handler
-- replace my HMI design with the official AGL design (graphics/icons...)
-- implement example HMI layouts
-- rename dBus objects (internal/external)
-- fix font issues on target
-- more documentation ;)
-- add animations
-- much more...
-
-Thanks to Umar Irshad for his free iconset available here:
-https://dribbble.com/shots/1569128-Freebie-48-Bubbles-Iconset
+https://gerrit.automotivelinux.org/gerrit/#/admin/projects/AGL/meta-agl-demo/recipes-demo-hmi/HomeScreen/HomeScreen_?.bb
+
+
+Instructions for running on porter board
+----------------------------------------
+
+Add "HomeScreen" to your image recipe.
+Right now, HomeScreen depends on the TIZEN application manager, because the HomeScreenAppFrameworkBinderTizen makes use of it.
+So also add this to your image recipe:
+"
+    tizen-platform-wrapper \
+    tizen-platform-config \
+    xdgmime \
+    libdlog \
+    dlogutil \
+    libiri \
+    \
+    smack \
+    libprivilege-control \
+    libslp-db-util \
+    \
+    vconf \
+    capi-base-common \
+    ail \
+    \
+    sensor \
+    libsf-common \
+    \
+    iniparser \
+    app-svc \
+    heynoti \
+    notification \
+    app-core-efl \
+    app-core-common \
+    capi-system-info \
+    \
+    pkgmgr-info \
+    librua \
+    bundle \
+    app-checker \
+    \
+    libcom-core \
+    privacy-manager-server \
+    pkgmgr \
+    pkgmgr-info \
+    pkgmgr-info-parser \
+    aul \
+    aul-test \
+    \
+    dlt-daemon \
+    dlt-daemon-systemd \
+    \
+    amhelloworld \
+    pkgmgr-first-setup-service \
+"
+
+
+All "HomeScreen" applications can be found in /opt/AGL/HomeScreen.
+
+Make sure, weston is using the IVI shell extension:
+
+/etc/xdg/weston/weston.ini:
+
+[core]
+shell=ivi-shell.so
+
+[ivi-shell]
+ivi-module=ivi-controller.so
+ivi-shell-user-interface=/usr/lib/weston/weston-ivi-shell-user-interface
+
+[output]
+name=HDMI-A-1
+transform=270
+
+
+
+If you want to use the TIZEN application manager to launch apps, you need to execute HomeScreen app with the user "aglglobalapp":
+
+Therefore you need to change the owner of the weston socket:
+
+chown aglglobalapp:aglglobalapp /tmp/wayland-0
+
+P.S.: the path may also something likle /run/user/0, depending on the XDG_RUNTIME_DIR.
+
+If not already stared, launch D-Bus:
+export `dbus-launch`
+
+Now you can start the HomeScreen apps:
+cd /opt/AGL/HomeScreen
+./WindowManager &
+./InputEventManager &
+./HomeScreenAppFrameworkBinderTizen &
+./HomeScreen &