From 95f9ba800b45c72100ad3809e375b662a6c52852 Mon Sep 17 00:00:00 2001 From: Dirk Hohndel Date: Mon, 13 May 2013 17:17:13 -0500 Subject: Documentation: update "Web Service and Companion App" Signed-off-by: Dirk Hohndel --- Documentation/user-manual.txt | 44 +++++++++++++++++++++++++++++-------------- 1 file changed, 30 insertions(+), 14 deletions(-) (limited to 'Documentation') diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt index dac333b2f..943c8aca6 100644 --- a/Documentation/user-manual.txt +++ b/Documentation/user-manual.txt @@ -1180,21 +1180,37 @@ Web Service and Companion App ----------------------------- This part of Subsurface is a bit of 'work in progress'. We are -developing a companion application for Android that will allow you to -track dive sites from your GPS-enabled Android device; at the time of -the Subsurface 3.0 release the app wasn't ready to be submitted to the -Google Play store, but since it is mostly usable when built form -source we left the server side integration in Subsurface. - -Assuming you have used the companion app to name and locate dive sites -you can use this menu item to connect to our back-end server and -download this data. Enter your userid (you got this when registering -with the web service) and click 'Download'. If the data was -successfully downloaded you can click apply and Subsurface will match -the time stamps of the downloaded location and site name information -with the dives in your log and will add the GPS locations and dive -site names to your dives. +developing a companion application for Android that allows you to +track dive sites from your GPS-enabled Android device. + +The Subsurface app is available for free in the Google Play store (and +sources are available from our git server). A server side webservice +is running on our infrastructure to capture and store the data +transmitted by the application. An interested user could also run +their own web service (the sources for the web service are also +available). + +The Android companion app allows you to store the GPS location and +name of specific dive sites as their name is entered into the +application. It can also operate as a background service and record +positions at regular intervals (this is especially useful when on a +dive boat). + +After downloading your dives from your dive computer (or manually +adding them in the Subsurface desktop application) you can then use +this menu item to connect to our back-end server and download the +related location data (and dive site names). Enter your userid (you +got this when registering with the web service) and click +'Download'. If the data was successfully downloaded you can click +apply and Subsurface will match the time stamps of the downloaded +location and site name information with the dives in your log and will +add the GPS locations and dive site names to your dives. +[NOTE] +At this point you can not use the Android Subsurface companion app to +enter dives and then download these dives into the desktop +application. The companion up and webservice can only be used to add +GPS location (and dive site name) to an existing dive in the dive log. [[S_Menu]] The Menu and Sub-Menus -- cgit v1.2.3-70-g09d2