X-Git-Url: https://gerrit.automotivelinux.org/gerrit/gitweb?a=blobdiff_plain;f=README.md;h=945957fd02660fceb56c7ee01487cf5f812d7936;hb=b9f0e1049e70e9553a752d13de5d4023e85cc662;hp=b3845aac0ea5b289c3e9b385ca2fcd398c6b38e1;hpb=ff25a2a06428ffb0d6d8aeddb5faaa301b4201fe;p=staging%2FHomeScreen.git diff --git a/README.md b/README.md index b3845aa..945957f 100644 --- a/README.md +++ b/README.md @@ -1,48 +1,108 @@ -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 &