X-Git-Url: https://gerrit.automotivelinux.org/gerrit/gitweb?a=blobdiff_plain;f=README.md;h=945957fd02660fceb56c7ee01487cf5f812d7936;hb=b9f0e1049e70e9553a752d13de5d4023e85cc662;hp=e02682f636f023b58b7e68e5079484f09d811ae9;hpb=c32114eb2ccbe142d73c06a5992544d6eacb97d0;p=staging%2FHomeScreen.git diff --git a/README.md b/README.md index e02682f..945957f 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,11 @@ -AGL Home Screen reference implementation +This project contains: - -Build with QtCreator 3.0.1 +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 @@ -9,96 +13,96 @@ 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-demo-hmi/HomeScreen/HomeScreen_?.bb -v0.3.1 -10/05/2016 - -#new features -- implemented proximity - -v0.3.0 -09/30/2016 - -#new features -- app launcher improved -- added first popup combobox selection feature --- used for selecting layouts -- implemented 3 layouts --- one app --- top on bottom --- side by side -- first interaction with WindowManager - -v0.2.0 -08/05/2016 - -#new features -- app launcher implemented -- input event manager used for new control bar "nav" button - -v0.1.1 -07/06/2016 - -#changes -- reworked D-Bus day/night mode handling - -#new features -- color schemes implemented --- 3 color schemes as example added - -v0.1.0 -06/24/2016 - -#changes -- reworked status bar -- reviewed D-Bus interfaces, now using signals instead of methods for day/night mode -- created new home screen simulator app -- license changed to Apache 2.0 -- put D-Bus introspections in one central place -- disabled "only one instance allowed" for development - -v0.0.2 -06/13/2016 - -#changes -- created layout 1. Changed home screen app size to 1080x1920 - -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 -- define and implement control bar D-Bus-interface -- many settings have to be read from the system somewhere during app startup. This is not available right now -- interaction with application manager --- done for TIZEN -- interaction with wayland compositor --- first version of WindowManager implemented -- define and implement input device event handler -- replace my HMI design with the official AGL design (graphics/icons...) -- implement example HMI layouts --- three layouts implemented -- 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 + +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 &