summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorwang_zhiqiang <wang_zhiqiang@dl.cn.nexty-ele.com>2018-12-03 13:18:47 +0800
committerwang_zhiqiang <wang_zhiqiang@dl.cn.nexty-ele.com>2018-12-03 13:18:47 +0800
commitf42ae47fe425b8ef353ec72ff9edaff451206cb8 (patch)
treeaae3fa9c217624c69fc1a543b062bda50a189067
parent5e11084733c184b0505a4f4816e69b0dd363b653 (diff)
change readme
-rw-r--r--doc/parts/show_hide_onscreen.pngbin76169 -> 0 bytes
-rw-r--r--doc/parts/show_hide_onscreen.pu80
-rw-r--r--doc/parts/startup.pngbin30290 -> 0 bytes
-rw-r--r--doc/parts/startup.pu33
-rw-r--r--doc/readme.md (renamed from sample/readme.md)29
5 files changed, 18 insertions, 124 deletions
diff --git a/doc/parts/show_hide_onscreen.png b/doc/parts/show_hide_onscreen.png
deleted file mode 100644
index 933540e..0000000
--- a/doc/parts/show_hide_onscreen.png
+++ /dev/null
Binary files differ
diff --git a/doc/parts/show_hide_onscreen.pu b/doc/parts/show_hide_onscreen.pu
deleted file mode 100644
index b72ccb1..0000000
--- a/doc/parts/show_hide_onscreen.pu
+++ /dev/null
@@ -1,80 +0,0 @@
-@startuml
-
-title Show/Hide Onscreenapp Sequence
-
-actor User
-entity HomeScreen_Service as HSS
-entity App
-entity Onscreenapp
-entity WindowManagere as WM
-
-== show Onscreenapp ==
-User->App: display Onscreenapp by user operation
-App->HSS: subscribe replyShowWindow event
-App->HSS: call showWindow()
-note right
-{ "application_id": "onscreenapp",
- "parameter": {
- "file": "qml file path",
- "data": {...}
- }
-}
-end note
-HSS->HSS: get app's id
-HSS->Onscreenapp: push showWindow event
-note right
-{ "application_id": "onscreenapp",
- "parameter": {
- "file": "qml file path",
- "data": {...},
- "replyid": "app's id"
- }
-}
-end note
-Onscreenapp->WM: activateWindow("on_screen.app")
-
-alt display able
-WM->Onscreenapp: SyncDraw
-Onscreenapp->Onscreenapp: load app's qml
-Onscreenapp->WM: EndDraw("on_screen.app")
-WM->Onscreenapp: VISIBLE("on_screen.app")
-
-else display disable
-rnote over Onscreenapp
-do nothing
-end rnote
-end
-
-== hide Onscreenapp ==
-alt touch Onscreenapp's button
-User->Onscreenapp: touch Onscreenapp's button
-Onscreenapp->WM: deactivateWindow("on_screen.app")
-Onscreenapp->Onscreenapp: unload qml
-Onscreenapp->HSS: call replyShowWindow()
-note right
-{ "application_id": "app's id",
- "parameter": {
- "method": "Buttons.ButtonPress",
- "buttonName": "pressed button name",
- "buttonPressMode": "Short"
- }
-}
-end note
-WM->Onscreenapp: INVISIBLE("on_screen.app")
-HSS->App: push replyShowWindow event
-App->App: call button function
-
-else hide by App
-
-App->HSS: call hideWindow("onscreenapp")
-note right
-{ "application_id": "onscreenapp"}
-end note
-HSS->Onscreenapp: push hideWindow event
-Onscreenapp->Onscreenapp: unload qml
-Onscreenapp->WM: deactivateWindow("on_screen.app")
-WM->Onscreenapp: INVISIBLE("on_screen.app")
-
-end
-
-@enduml
diff --git a/doc/parts/startup.png b/doc/parts/startup.png
deleted file mode 100644
index b292357..0000000
--- a/doc/parts/startup.png
+++ /dev/null
Binary files differ
diff --git a/doc/parts/startup.pu b/doc/parts/startup.pu
deleted file mode 100644
index 95c9f95..0000000
--- a/doc/parts/startup.pu
+++ /dev/null
@@ -1,33 +0,0 @@
-@startuml
-
-title Onscreenapp Startup Sequence
-
-entity Systemd
-entity HomeScreen_Service
-entity Onscreenapp
-entity WindowManager as WM
-
-== System StartUp ==
-
-Systemd->Onscreenapp: start
-
-group WindowManger Initilize
-Onscreenapp->WM: init(port, token)
-Onscreenapp->WM: requestSurface("on_screen.app")
-rnote over WM
-WM process
-end rnote
-Onscreenapp<--WM: return SurfaceID
-Onscreenapp->WM: subscribe Event_SyncDraw
-Onscreenapp->WM: subscribe Event_Visible
-Onscreenapp->WM: subscribe Event_Invisible
-end
-
-group HomeScreen_Service Initilize
-Onscreenapp->HomeScreen_Service: init(port, token)
-Onscreenapp->HomeScreen_Service: subscribe showWindow Event
-Onscreenapp->HomeScreen_Service: subscribe hideWindow Event
-Onscreenapp->Onscreenapp: qmlLoad()
-end
-
-@enduml \ No newline at end of file
diff --git a/sample/readme.md b/doc/readme.md
index a48f3e0..0b6ba93 100644
--- a/sample/readme.md
+++ b/doc/readme.md
@@ -1,15 +1,7 @@
-A test application for onscreenapp
+usage of onscreenapp
===
-## compile & install
-
-- compile
- - when onscreenapp is compiled, this app's wgt file will exist at "onscreenapp/sample/package" which called onstestapp.wgt.
-
-- install
- `afm-util install onstestapp.wgt;sync`
-
## dependence
Onscreenapp depend on libhomescreen add agl-service-homescreen as below:
@@ -17,7 +9,22 @@ Onscreenapp depend on libhomescreen add agl-service-homescreen as below:
and 'showWindow/hideWindow/replyShowWindow' interface.
- agl-service-homescreen must have 'showWindow/hideWindow/replyShowWindow' verbs.
-## usage
+## sequence
+
+show/hide onscreen sequence.
+- ![showOnscreen.svg](parts/showOnscreen.svg)
+
+## about sample 'onstestapp'
+onstestapp is a sample to use onscreenapp.
+
+### compile & install
+- compile
+ - when onscreenapp is compiled, this app's wgt file will exist at "onscreenapp/sample/package" which called onstestapp.wgt.
+
+- install
+ `afm-util install onstestapp.wgt;sync`
+
+### onstestapp usage
Before start onstestapp you must copy all files in "qml" folder to "$HOME/app-data/OnScreen/onstestapp/" on your board(R-car M3 etc.),
then do as below:
@@ -26,7 +33,7 @@ then do as below:
2. select onscreen type
3. press "Post" button
-## edit parameter with keyboard
+### edit parameter with keyboard
You also can edit the text which will post to onscreen, do as below: