mirror of
https://github.com/subsurface/subsurface.git
synced 2024-11-28 13:10:19 +00:00
cbfef6e367
Signed-off-by: Guillaume GARDET <guillaume.gardet@free.fr> Signed-off-by: Dirk Hohndel <dirk@hohndel.org>
1011 lines
46 KiB
Text
1011 lines
46 KiB
Text
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
|
|
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
|
|
<meta name="generator" content="AsciiDoc 8.6.9" />
|
|
<title></title>
|
|
<style type="text/css">
|
|
/*
|
|
* compact_subsurface.css, a special style sheet for Subsurface,
|
|
* modified by Willem Ferguson and derived from:
|
|
* compact.css, version 1.3 by Alex Efros <powerman@powerman.name>
|
|
* Licence: Public Domain
|
|
*
|
|
* Usage: asciidoc -a theme=compact_subsurface ...
|
|
*/
|
|
|
|
* { padding: 0; margin: 0; }
|
|
img { border: 0; }
|
|
|
|
/*** Layout ***/
|
|
|
|
body { margin: 10px 20px; }
|
|
#header br { display: none; }
|
|
#revnumber { display: block; }
|
|
#toc { margin: 1em 0; }
|
|
.toclevel2 { margin-left: 1em; }
|
|
.toclevel3 { margin-left: 2em; }
|
|
#footer { margin-top: 2em; }
|
|
|
|
#preamble .sectionbody,
|
|
h2,
|
|
h3,
|
|
h4,
|
|
h5 { margin: 1em 0 0 0; }
|
|
|
|
.admonitionblock,
|
|
.listingblock,
|
|
.sidebarblock,
|
|
.exampleblock,
|
|
.tableblock,
|
|
.literalblock { margin: 1em 0; }
|
|
.admonitionblock td.icon { padding-right: 0.5em; }
|
|
.admonitionblock td.content { padding-left: 0.5em; }
|
|
.listingblock .content { padding: 0.5em; }
|
|
.sidebarblock > .content { padding: 0.5em; }
|
|
.exampleblock > .content { padding: 0 0.5em; }
|
|
.tableblock caption { padding: 0 0 0.5em 0; }
|
|
.tableblock thead th,
|
|
.tableblock tbody td,
|
|
.tableblock tfoot td { padding: 0 0.5em; }
|
|
.quoteblock { padding: 0 2.0em; }
|
|
|
|
.paragraph { margin: 1em 0 0 0; }
|
|
.sidebarblock .paragraph:first-child,
|
|
.exampleblock .paragraph:first-child,
|
|
.admonitionblock .paragraph:first-child { margin: 0; }
|
|
|
|
.ulist, .olist, .dlist, .hdlist, .qlist { margin: 1em 0; }
|
|
li .ulist, li .olist, li .dlist, li .hdlist, li .qlist,
|
|
dd .ulist, dd .olist, dd .dlist, dd .hdlist, dd .qlist { margin: 0; }
|
|
ul { margin-left: 1.5em; }
|
|
ol { margin-left: 2em; }
|
|
dd { margin-left: 3em; }
|
|
td.hdlist1 { padding-right: 1em; }
|
|
|
|
/*** Fonts ***/
|
|
|
|
body { font-family: Verdana, sans-serif; }
|
|
#header { font-family: Arial, sans-serif; }
|
|
#header h1 { font-family: Arial, sans-serif; }
|
|
#footer { font-family: Georgia, serif; }
|
|
#email { font-size: 0.85em; }
|
|
#revnumber { font-size: 0.75em; }
|
|
#toc { font-size: 0.9em; }
|
|
#toctitle { font-weight: bold; }
|
|
#footer { font-size: 0.8em; }
|
|
|
|
h2, h3, h4, h5, .title { font-family: Arial, sans-serif; }
|
|
h2 { font-size: 1.5em; }
|
|
.sectionbody { font-size: 0.85em; }
|
|
.sectionbody .sectionbody { font-size: inherit; }
|
|
h3 { font-size: 159%; } /* 1.35em */
|
|
h4 { font-size: 141%; } /* 1.2em */
|
|
h5 { font-size: 118%; } /* 1em */
|
|
.title { font-size: 106%; /* 0.9em */
|
|
font-weight: bold;
|
|
}
|
|
|
|
tt, .monospaced { font-family: monospace; font-size: 106%; } /* 0.9em */
|
|
dt, td.hdlist1, .qlist em { font-family: Times New Roman, serif;
|
|
font-size: 118%; /* 1em */
|
|
font-style: italic;
|
|
}
|
|
.tableblock tfoot td { font-weight: bold; }
|
|
|
|
/*** Colors and Backgrounds ***/
|
|
|
|
h1 { color: #527bbd; border-bottom: 2px solid silver; }
|
|
#footer { border-top: 2px solid silver; }
|
|
|
|
h2 { color: #527bbd; border-bottom: 2px solid silver; }
|
|
h3 { color: #5D7EAE; border-bottom: 2px solid silver; }
|
|
h3 { display: inline-block; }
|
|
h4,h5 { color: #5D7EAE; }
|
|
|
|
.admonitionblock td.content { border-left: 2px solid silver; }
|
|
.listingblock .content { background: #f4f4f4; border: 1px solid silver; border-left: 5px solid #e0e0e0; }
|
|
.sidebarblock > .content { background: #ffffee; border: 1px solid silver; border-left: 5px solid #e0e0e0; }
|
|
.exampleblock > .content { border-left: 2px solid silver; }
|
|
.quoteblock { border-left: 5px solid #e0e0e0; }
|
|
.tableblock table {
|
|
border-collapse: collapse;
|
|
border-width: 3px;
|
|
border-color: #527bbd;
|
|
}
|
|
.tableblock table[frame=hsides] { border-style: solid none; }
|
|
.tableblock table[frame=border] { border-style: solid; }
|
|
.tableblock table[frame=void] { border-style: none; }
|
|
.tableblock table[frame=vsides] { border-style: none solid; }
|
|
.tableblock table[rules=all] tbody tr *,
|
|
.tableblock table[rules=rows] tbody tr * {
|
|
border-top: 1px solid #527bbd;
|
|
}
|
|
.tableblock table[rules=all] tr *,
|
|
.tableblock table[rules=cols] tr * {
|
|
border-left: 1px solid #527bbd;
|
|
}
|
|
.tableblock table tbody tr:first-child * {
|
|
border-top: 1px solid white; /* none don't work here... %-[] */
|
|
}
|
|
.tableblock table tr *:first-child {
|
|
border-left: none;
|
|
}
|
|
.tableblock table[frame] thead tr *,
|
|
.tableblock table[frame] thead tr * {
|
|
border-top: 1px solid white;
|
|
border-bottom: 2px solid #527bbd;
|
|
}
|
|
.tableblock table tr td p.table,
|
|
.tableblock table tr td p.table * {
|
|
border: 0px;
|
|
}
|
|
|
|
tt, .monospaced { color: navy; }
|
|
|
|
li { color: #a0a0a0; }
|
|
li > * { color: black; }
|
|
|
|
span.aqua { color: aqua; }
|
|
span.black { color: black; }
|
|
span.blue { color: blue; }
|
|
span.fuchsia { color: fuchsia; }
|
|
span.gray { color: gray; }
|
|
span.green { color: green; }
|
|
span.lime { color: lime; }
|
|
span.maroon { color: maroon; }
|
|
span.navy { color: navy; }
|
|
span.olive { color: olive; }
|
|
span.purple { color: purple; }
|
|
span.red { color: red; }
|
|
span.silver { color: silver; }
|
|
span.teal { color: teal; }
|
|
span.white { color: white; }
|
|
span.yellow { color: yellow; }
|
|
|
|
span.aqua-background { background: aqua; }
|
|
span.black-background { background: black; }
|
|
span.blue-background { background: blue; }
|
|
span.fuchsia-background { background: fuchsia; }
|
|
span.gray-background { background: gray; }
|
|
span.green-background { background: green; }
|
|
span.lime-background { background: lime; }
|
|
span.maroon-background { background: maroon; }
|
|
span.navy-background { background: navy; }
|
|
span.olive-background { background: olive; }
|
|
span.purple-background { background: purple; }
|
|
span.red-background { background: red; }
|
|
span.silver-background { background: silver; }
|
|
span.teal-background { background: teal; }
|
|
span.white-background { background: white; }
|
|
span.yellow-background { background: yellow; }
|
|
|
|
span.big { font-size: 2em; }
|
|
span.small { font-size: 0.6em; }
|
|
|
|
span.underline { text-decoration: underline; }
|
|
span.overline { text-decoration: overline; }
|
|
span.line-through { text-decoration: line-through; }
|
|
|
|
/*** Misc ***/
|
|
|
|
.admonitionblock td.icon { vertical-align: top; }
|
|
.attribution { text-align: right; }
|
|
|
|
ul { list-style-type: disc; }
|
|
ol.arabic { list-style-type: decimal; }
|
|
ol.loweralpha { list-style-type: lower-alpha; }
|
|
ol.upperalpha { list-style-type: upper-alpha; }
|
|
ol.lowerroman { list-style-type: lower-roman; }
|
|
ol.upperroman { list-style-type: upper-roman; }
|
|
.hdlist td { vertical-align: top; }
|
|
|
|
|
|
</style>
|
|
<script type="text/javascript">
|
|
/*<+'])');
|
|
// Function that scans the DOM tree for header elements (the DOM2
|
|
// nodeIterator API would be a better technique but not supported by all
|
|
// browsers).
|
|
var iterate = function (el) {
|
|
for (var i = el.firstChild; i != null; i = i.nextSibling) {
|
|
if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {
|
|
var mo = re.exec(i.tagName);
|
|
if (mo && (i.getAttribute("class") || i.getAttribute("className")) != "float") {
|
|
result[result.length] = new TocEntry(i, getText(i), mo[1]-1);
|
|
}
|
|
iterate(i);
|
|
}
|
|
}
|
|
}
|
|
iterate(el);
|
|
return result;
|
|
}
|
|
|
|
var toc = document.getElementById("toc");
|
|
if (!toc) {
|
|
return;
|
|
}
|
|
|
|
// Delete existing TOC entries in case we're reloading the TOC.
|
|
var tocEntriesToRemove = [];
|
|
var i;
|
|
for (i = 0; i < toc.childNodes.length; i++) {
|
|
var entry = toc.childNodes[i];
|
|
if (entry.nodeName.toLowerCase() == 'div'
|
|
&& entry.getAttribute("class")
|
|
&& entry.getAttribute("class").match(/^toclevel/))
|
|
tocEntriesToRemove.push(entry);
|
|
}
|
|
for (i = 0; i < tocEntriesToRemove.length; i++) {
|
|
toc.removeChild(tocEntriesToRemove[i]);
|
|
}
|
|
|
|
// Rebuild TOC entries.
|
|
var entries = tocEntries(document.getElementById("content"), toclevels);
|
|
for (var i = 0; i < entries.length; ++i) {
|
|
var entry = entries[i];
|
|
if (entry.element.id == "")
|
|
entry.element.id = "_toc_" + i;
|
|
var a = document.createElement("a");
|
|
a.href = "#" + entry.element.id;
|
|
a.appendChild(document.createTextNode(entry.text));
|
|
var div = document.createElement("div");
|
|
div.appendChild(a);
|
|
div.className = "toclevel" + entry.toclevel;
|
|
toc.appendChild(div);
|
|
}
|
|
if (entries.length == 0)
|
|
toc.parentNode.removeChild(toc);
|
|
},
|
|
|
|
|
|
/////////////////////////////////////////////////////////////////////
|
|
// Footnotes generator
|
|
/////////////////////////////////////////////////////////////////////
|
|
|
|
/* Based on footnote generation code from:
|
|
* http://www.brandspankingnew.net/archive/2005/07/format_footnote.html
|
|
*/
|
|
|
|
footnotes: function () {
|
|
// Delete existing footnote entries in case we're reloading the footnodes.
|
|
var i;
|
|
var noteholder = document.getElementById("footnotes");
|
|
if (!noteholder) {
|
|
return;
|
|
}
|
|
var entriesToRemove = [];
|
|
for (i = 0; i < noteholder.childNodes.length; i++) {
|
|
var entry = noteholder.childNodes[i];
|
|
if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") == "footnote")
|
|
entriesToRemove.push(entry);
|
|
}
|
|
for (i = 0; i < entriesToRemove.length; i++) {
|
|
noteholder.removeChild(entriesToRemove[i]);
|
|
}
|
|
|
|
// Rebuild footnote entries.
|
|
var cont = document.getElementById("content");
|
|
var spans = cont.getElementsByTagName("span");
|
|
var refs = {};
|
|
var n = 0;
|
|
for (i=0; i<spans.length; i++) {
|
|
if (spans[i].className == "footnote") {
|
|
n++;
|
|
var note = spans[i].getAttribute("data-note");
|
|
if (!note) {
|
|
// Use [\s\S] in place of . so multi-line matches work.
|
|
// Because JavaScript has no s (dotall) regex flag.
|
|
note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];
|
|
spans[i].innerHTML =
|
|
"[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +
|
|
"' title='View footnote' class='footnote'>" + n + "</a>]";
|
|
spans[i].setAttribute("data-note", note);
|
|
}
|
|
noteholder.innerHTML +=
|
|
"<div class='footnote' id='_footnote_" + n + "'>" +
|
|
"<a href='#_footnoteref_" + n + "' title='Return to text'>" +
|
|
n + "</a>. " + note + "</div>";
|
|
var id =spans[i].getAttribute("id");
|
|
if (id != null) refs["#"+id] = n;
|
|
}
|
|
}
|
|
if (n == 0)
|
|
noteholder.parentNode.removeChild(noteholder);
|
|
else {
|
|
// Process footnoterefs.
|
|
for (i=0; i<spans.length; i++) {
|
|
if (spans[i].className == "footnoteref") {
|
|
var href = spans[i].getElementsByTagName("a")[0].getAttribute("href");
|
|
href = href.match(/#.*/)[0]; // Because IE return full URL.
|
|
n = refs[href];
|
|
spans[i].innerHTML =
|
|
"[<a href='#_footnote_" + n +
|
|
"' title='View footnote' class='footnote'>" + n + "</a>]";
|
|
}
|
|
}
|
|
}
|
|
},
|
|
|
|
install: function(toclevels) {
|
|
var timerId;
|
|
|
|
function reinstall() {
|
|
asciidoc.footnotes();
|
|
if (toclevels) {
|
|
asciidoc.toc(toclevels);
|
|
}
|
|
}
|
|
|
|
function reinstallAndRemoveTimer() {
|
|
clearInterval(timerId);
|
|
reinstall();
|
|
}
|
|
|
|
timerId = setInterval(reinstall, 500);
|
|
if (document.addEventListener)
|
|
document.addEventListener("DOMContentLoaded", reinstallAndRemoveTimer, false);
|
|
else
|
|
window.onload = reinstallAndRemoveTimer;
|
|
}
|
|
|
|
}
|
|
asciidoc.install(3);
|
|
/*]]>*/
|
|
</script>
|
|
</head>
|
|
<body class="article">
|
|
<div id="header">
|
|
</div>
|
|
<div id="content">
|
|
<div class="imageblock" style="text-align:center;">
|
|
<div class="content">
|
|
<img src="mobile-images/Banner.jpg" alt="Banner" />
|
|
</div>
|
|
</div>
|
|
<div class="paragraph"><p><span class="big">MANUEL UTILISATEUR de Subsurface-mobile</span></p></div>
|
|
<div class="paragraph"><p><strong>Auteurs du manuel</strong> : Willem Ferguson, Dirk Hohndel</p></div>
|
|
<div class="paragraph"><p><span class="blue"><em>Version 2, octobre 2017</em></span></p></div>
|
|
<div class="paragraph"><p>Welcome as a user of <em>Subsurface</em> and <em>Subsurface-mobile</em>, advanced dive
|
|
logging software with extensive infrastructure to describe, organize, and
|
|
interpret scuba and free dives. <em>Subsurface</em> offers many advantages over
|
|
other similar software solutions, including compatibility with Windows,
|
|
Mac-OS/X, Linux (many distributions), Android and iOS. In addition,
|
|
<em>Subsurface</em> is open-source software that allows downloading dive
|
|
information from many dive computers.</p></div>
|
|
<div class="sect1">
|
|
<h2 id="_présentation_de_subsurface_mobile">1. Présentation de Subsurface-mobile</h2>
|
|
<div class="sectionbody">
|
|
<div class="paragraph"><p><em>Subsurface-mobile</em> est une version mobile limitée de <em>Subsurface</em> qui vise
|
|
les smartphones Android et iOS et sur les tablettes, qui permet de
|
|
visualiser, entrer, partager et stocker des informations de plongées sur les
|
|
sites de plongées où un ordinateur n’est pas utile. Alors que la version de
|
|
<em>Subsurface</em> pour ordinateur affiche bien plus d’informations détaillées
|
|
pour chaque plongée, la version mobile permet un accès facilité lors sur un
|
|
voyage de plongées, utile pour prouver une experience de plongées aux clubs
|
|
ou pour revoir les plongées précédentes. <em>Subsurface-mobile</em> pour Android
|
|
permet également de collecter des positions GPS où sont effectuées les
|
|
plongées. (Subsurface-mobile pour iOS ne supporte pas toutes les fonctions
|
|
pour le moment).</p></div>
|
|
<div class="paragraph"><p>Les utilisateurs de <em>Subsurface-mobile</em> utilisent habituellement
|
|
l’application mobile en tant que compagnon de la version de <em>Subsurface</em>
|
|
pour ordinateur, partageant les informations de plongées entre les versions
|
|
mobile et de bureau. Cependant, <em>Subsurface-mobile</em> peut également être
|
|
utilisée de façon indépendante de la version de bureau et ne requiert pas
|
|
l’utilisation du stockage cloud.</p></div>
|
|
<div class="paragraph"><p><em>Subsurface-mobile</em> permet de :</p></div>
|
|
<div class="ulist"><ul>
|
|
<li>
|
|
<p>
|
|
Télécharger et stocker les informations de plongées en utilisant le cloud
|
|
<em>Subsurface</em>.
|
|
</p>
|
|
</li>
|
|
<li>
|
|
<p>
|
|
Visualiser ces informations sur un périphérique nomade.
|
|
</p>
|
|
</li>
|
|
<li>
|
|
<p>
|
|
Créer et ajouter manuellement de nouvelles plongées à votre carnet de
|
|
plongées.
|
|
</p>
|
|
</li>
|
|
<li>
|
|
<p>
|
|
Télécharger des données de plongées directement depuis plusieurs ordinateurs
|
|
de plongées.
|
|
</p>
|
|
</li>
|
|
<li>
|
|
<p>
|
|
Modifier de nombreux champs des données de plongées, comme le moniteur, le
|
|
binôme, l'équipement ou les notes relatives à la plongée.
|
|
</p>
|
|
</li>
|
|
<li>
|
|
<p>
|
|
Enregistrer, stocker et appliquer des positions GPS des plongées (Uniquement
|
|
sous Android).
|
|
</p>
|
|
</li>
|
|
<li>
|
|
<p>
|
|
Visualiser les positions des points GPS enregistrés et des plongées sur une
|
|
carte.
|
|
</p>
|
|
</li>
|
|
</ul></div>
|
|
<div class="paragraph"><p>Ces points sont détaillés dans la suite du manuel. <em>Subsurface-mobile</em> ne
|
|
supporte pas encore le téléchargement des données de plongées depuis tous
|
|
les ordinateurs de plongées que supporte la version de bureau. Seule une
|
|
partie des ordinateurs de plongées utilisant une interface USB FTDI ou une
|
|
interface Bluetooth/BTLE sont accessibles depuis <em>Subsurface-mobile</em>.</p></div>
|
|
</div>
|
|
</div>
|
|
<div class="sect1">
|
|
<h2 id="_installer_em_subsurface_mobile_em_sur_votre_périphérique_nomade">2. Installer <em>Subsurface-mobile</em> sur votre périphérique nomade</h2>
|
|
<div class="sectionbody">
|
|
<div class="paragraph"><p>Vous trouverez <em>Subsurface-mobile</em> dans <em>Google Play Store</em> ou sur <em>iTunes
|
|
Store</em> d’où vous pourrez les installer. Veuillez boter que les deux
|
|
contiennent également l’ancienne application <em><em>Subsurface</em> companion</em>
|
|
(utilisée uniquement pour enregistrer les points GPS). Vérifiez que vous
|
|
installez bien <em>Subsurface-mobile</em>.</p></div>
|
|
</div>
|
|
</div>
|
|
<div class="sect1">
|
|
<h2 id="_utiliser_em_subsurface_mobile_em_pour_la_première_fois">3. Utiliser <em>Subsurface-mobile</em> pour la première fois</h2>
|
|
<div class="sectionbody">
|
|
<div class="paragraph"><p>Lorsque vous exécutez <em>Subsurface-mobile</em> pour la première fois, un écran
|
|
d’accueil Subsurface est affiché pendant le chargement. Sur certains
|
|
périphériques, cela peut prendre plusieurs secondes. Après le chargement,
|
|
l'<em>écran d’informations de connexion au cloud</em> apparait (voir l’image
|
|
ci-dessous, à gauche).</p></div>
|
|
<div class="imageblock" style="text-align:center;">
|
|
<div class="content">
|
|
<img src="mobile-images/Credentials.jpg" alt="FIGURE: Mobile credentials screen" />
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_when_not_using_cloud_storage">3.1. When NOT Using Cloud Storage</h3>
|
|
<div class="paragraph"><p>Tap the "No cloud mode" button. The app will not access the <em>Subsurface</em>
|
|
cloud storage server to obtain dive log information. This means that dive
|
|
log information is stored on the mobile device only. If no dives have been
|
|
entered into the dive log yet (the usual case), then a an empty dive log is
|
|
created.</p></div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_using_cloud_storage">3.2. Using Cloud Storage</h3>
|
|
<div class="paragraph"><p>A free Internet cloud storage account can be used for storing dive log
|
|
information. This cloud storage account can be created either from
|
|
<em>Subsurface</em> on the desktop or <em>Subsurface-mobile</em> using a mobile device; in
|
|
fact, you can do full maintenance of a dive log from <em>Subsurface-mobile</em>
|
|
alone. On the other hand, if you share credentials between
|
|
<em>Subsurface-mobile</em> and <em>Subsurface</em> for desktop, through the <em>Subsurface</em>
|
|
cloud storage your dive log can be shared by both devices.</p></div>
|
|
<div class="paragraph"><p>The dive data are cached both on the mobile device as well as on the desktop
|
|
- it is easy to create backups of the data (for example in XML format) on
|
|
the desktop, and both mobile device and desktop keep a local copy of the
|
|
data so that the dive log is always accessible, even without Internet
|
|
connection. The Subsurface team never accesses a user’s dive data without
|
|
explicit permission to do so, the data are not used for any purpose other
|
|
than providing them to the user who created them. There are no ads and no
|
|
harvesting / analysis of the data stored in the Subsurface cloud storage.</p></div>
|
|
<div class="paragraph"><p>Enter an e-mail address and a password in the fields indicated on the
|
|
screen. The e-mail address should be in lower case and the password should
|
|
contain a combination of letters from the alphabet (upper and lower case)
|
|
and/or numbers. Tap the "Sign-in or Register" button. If you have already
|
|
set up an account from the <em>Subsurface</em> desktop application, enter the same
|
|
credentials here. Once the dive list has been downloaded from the cloud,
|
|
<em>Subsurface-mobile</em> usually works only with the the local copy on the mobile
|
|
device. This avoids long delays or even failure of operations if there is a
|
|
bad (or no) internet connection, a situation fairly common at many dive
|
|
sites.</p></div>
|
|
<div class="paragraph"><p>If this is a new account, a PIN screen will open (see image on right,
|
|
above). A PIN is e-mailed to the email address entered in the previous
|
|
step. Enter this PIN into the field indicated and tap the <em>Register</em>
|
|
button. The user information is stored on the cloud server and access to the
|
|
cloud is enabled. In this case the dive list is initially empty. Start
|
|
entering dives in the dive log or download dive information from a supported
|
|
dive computer.</p></div>
|
|
<div class="paragraph"><p>The dive log can be updated automatically. If there is Internet
|
|
connectivity, <em>Subsurface-mobile</em> accesses the cloud-based dive log to
|
|
verify that the local copy of the dive log is still the same as the log in
|
|
the cloud server. If not, the local copy and the copy on the server are
|
|
synchronized.</p></div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_changing_the_existing_login_credentials_on_the_em_subsurface_em_cloud">3.3. Changing the existing login credentials on the <em>Subsurface</em> cloud</h3>
|
|
<div class="paragraph"><p>The login credentials can be changed, for an example in order to work with
|
|
multiple accounts. See the section on <a href="#S_ChangeCloudAccount">Changing to
|
|
a different <em>Subsurface</em> cloud account</a>.</p></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect1">
|
|
<h2 id="_menu_structure_and_user_interface">4. Menu Structure and User Interface</h2>
|
|
<div class="sectionbody">
|
|
<div class="paragraph"><p>At the bottom of many Subsurface-mobile screens is a round button that
|
|
provides for several actions (see image below). The most common choice is
|
|
indicated in a round colored <em>action button</em> (in the case below, edit a
|
|
dive). Alternative actions are indicated in a white <em>action bar</em>. On
|
|
Android devices, use the Android Back button for "cancel", "discard" or
|
|
"back" actions. For example, when editing dive information, tapping the
|
|
action button saves the changes while the Android back button can be used to
|
|
cancel the edit without saving changes.</p></div>
|
|
<div class="paragraph"><p>On iOS devices, on screens where a "back" action is enabled, a back arrow is
|
|
shown in the top left corner of the screen.</p></div>
|
|
<div class="imageblock" style="text-align:center;">
|
|
<div class="content">
|
|
<img src="mobile-images/Actionbutton.jpg" alt="FIGURE: Action Button" />
|
|
</div>
|
|
</div>
|
|
<div class="paragraph"><p>In order to have a consistent experience between iOS and Android,
|
|
<em>Subsurface-mobile</em> on Android does not use the traditional "hamburger" menu
|
|
button in the top left or right corner of the screen to open menus.
|
|
Instead, <em>Subsurface-mobile</em> uses a different user interaction philosophy
|
|
based on the Kirigami framework developed by the Plasma developers. There
|
|
are three ways to open the main menu:</p></div>
|
|
<div class="ulist"><ul>
|
|
<li>
|
|
<p>
|
|
Tap the "hamburger" symbol in the lower left corner of the screen (easy to
|
|
reach for hand held devices)
|
|
</p>
|
|
</li>
|
|
<li>
|
|
<p>
|
|
Swipe towards the right across the left edge of the screen
|
|
</p>
|
|
</li>
|
|
<li>
|
|
<p>
|
|
Drag the action button visible on most screens to the right
|
|
</p>
|
|
</li>
|
|
</ul></div>
|
|
<div class="imageblock" style="text-align:center;">
|
|
<div class="content">
|
|
<img src="mobile-images/Menusystem.jpg" alt="FIGURE: Dive management sub-panel" />
|
|
</div>
|
|
</div>
|
|
<div class="paragraph"><p>The image above indicates some of the important features of the menu
|
|
system. On the left is the main menu, activated as described above. On the
|
|
right of the image are the items of all the submenus accessible.</p></div>
|
|
<div class="paragraph"><p>All screenshots in this user manual are currently from the Android
|
|
version. As indicated earlier, the iOS version currently doesn’t support
|
|
<em>GPS</em> features.</p></div>
|
|
</div>
|
|
</div>
|
|
<div class="sect1">
|
|
<h2 id="_the_dive_list">5. The Dive List</h2>
|
|
<div class="sectionbody">
|
|
<div class="paragraph"><p>Most of the actions of <em>Subsurface-mobile</em> center around the dives on the
|
|
dive list. While the dive list is loading from the cloud, a message appears
|
|
at the bottom of the screen, indicating that the cloud is being accessed,
|
|
after which the dive list is shown. Once the list is loaded you can scroll
|
|
up and down. To upload dives from a dive computer, tap the blue action
|
|
button. If you wish to add a dive manually, tap the + button in the action
|
|
bar (described below). Tapping an existing dive on the list brings up a
|
|
display of <em>Details View</em> for that dive (see image on right below). This
|
|
includes the dive profile as well as additional information and notes.</p></div>
|
|
<div class="imageblock" style="text-align:center;">
|
|
<div class="content">
|
|
<img src="mobile-images/Divelist2.jpg" alt="FIGURE: Dive list screen" />
|
|
</div>
|
|
</div>
|
|
<div class="paragraph"><p>You can view other dives by swiping the <em>Details view</em> to the right (for the
|
|
previous dive) or to the left (following dive). Using the Action Bar, it is
|
|
also possible to delete the dive (tap the dustbin on the Action Bar) or to
|
|
view the dive location on a map viewer (Google Maps on Android, the Google
|
|
Maps web site on iOS; tap the GPS icon on the Action Bar.).</p></div>
|
|
</div>
|
|
</div>
|
|
<div class="sect1">
|
|
<h2 id="S_Edit_Dive">6. Editing dive details</h2>
|
|
<div class="sectionbody">
|
|
<div class="paragraph"><p>At the bottom of the dive details screen the action button is a pencil
|
|
(image on right, above). Tapping the pencil button changes the page and
|
|
enables edit boxes that allow modifying the existing dive information,
|
|
e.g. adding text to the dive notes or changing the names or values of some
|
|
of the information (see image below). It may be necessary to scroll the
|
|
window to access all the information. At the bottom of the edit screen is a
|
|
<em>Save</em> action button. Tap this to save the new information, after which the
|
|
dive list screen is updated and shown. To cancel any edits, tap the Android
|
|
<em>Back</em> Button.</p></div>
|
|
<div class="paragraph"><p>When the virtual keyboard is shown, to avoid screen clutter, the action
|
|
button is hidden. Once you close the keyboard it is drawn again.</p></div>
|
|
<div class="imageblock" style="text-align:center;">
|
|
<div class="content">
|
|
<img src="mobile-images/Editdive.jpg" alt="FIGURE: Dive edit screen" />
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect1">
|
|
<h2 id="S_Add_Dive">7. Manually adding a new dive to the dive list</h2>
|
|
<div class="sectionbody">
|
|
<div class="paragraph"><p>One can manually add a dive to the existing dive list. On the dive list tap
|
|
the "plus" sign in the action bar, or use the main menu and tap <em>Manage
|
|
dives → Add dive manually</em>. This opens a screen that is identical to the
|
|
editing screen discussed above. When a dive is added manually, you cannot
|
|
directly add a dive profile from a dive computer. However, if you do not use
|
|
a dive computer, the duration, depth and several other bits of information
|
|
about the new dive can be entered. The <em>Action button</em> at the bottom of the
|
|
screen contains a disk symbol. Tap this to save the new dive. To cancel any
|
|
edits, tap the Android Back Button. The left-hand image below shows a
|
|
screenshot of a dive being created and the right-hand image shows the same
|
|
dive in <em>Details View</em>.</p></div>
|
|
<div class="imageblock" style="text-align:center;">
|
|
<div class="content">
|
|
<img src="mobile-images/Manualdive.jpg" alt="FIGURE: Manual dive entry screen" />
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect1">
|
|
<h2 id="_deleting_a_dive">8. Deleting a dive</h2>
|
|
<div class="sectionbody">
|
|
<div class="paragraph"><p>The <em>Details View</em> of a dive has an Action Bar, including a dustbin. If this
|
|
is tapped, the dive shown in the <em>Details View</em> is deleted. You have a brief
|
|
opportunity to undo the delete by tapping the grey <em>Undo</em> button in the
|
|
message that appears at the bottom of the screen (see image below).</p></div>
|
|
<div class="imageblock" style="text-align:center;">
|
|
<div class="content">
|
|
<img src="mobile-images/Delete_undo.jpg" alt="FIGURE: Undo delete dive" />
|
|
</div>
|
|
</div>
|
|
<div class="paragraph"><p>You can also delete a dive from the dive list by long-pressing a dive until
|
|
a red dustbin appears on the right-hand side (see image below). Tap the
|
|
dustbin. The dive is deleted without asking any confirmation because
|
|
<em>Subsurface-mobile</em> assumes that the combination of a long tap on the dive
|
|
with another tap on the red dustbin is an unambiguous instruction to delete
|
|
the dive.</p></div>
|
|
<div class="imageblock" style="text-align:center;">
|
|
<div class="content">
|
|
<img src="mobile-images/RedDustbin.jpg" alt="FIGURE: delete dive from list" />
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect1">
|
|
<h2 id="S_Download">9. Download dives from a dive computer</h2>
|
|
<div class="sectionbody">
|
|
<div class="paragraph"><p>Download of dives is possible from dive computers with a FTDI USB interface,
|
|
or with a Bluetooth/BTLE interface.</p></div>
|
|
<div class="paragraph"><p>First, establish a link between the dive computer and the mobile device.</p></div>
|
|
<div class="paragraph"><p>For USB dive computers, USB cables "normally" used for uploading dives to a
|
|
desktop/laptop computer do NOT work: these cables usually have a full-sized
|
|
("Type A") male USB plug on one end which plugs into the USB port of a
|
|
desktop/laptop computer. For downloads to a mobile device one needs a USB
|
|
OTG (USB On-The-Go) cable. In most cases it is required to plug the USB
|
|
cable "normally" used with the dive computer into a USB OTG cable which, in
|
|
turn, plugs into the mini-USB (or sometimes a USB "Type C") receptacle of
|
|
the mobile device. The OTG cable usually has a full-size ("Type A") female
|
|
receptacle at one end which accommodates the full-sized male plug of the USB
|
|
cable "normally" used (see image below). This means that two cables are used
|
|
to connect the dive computer to the mobile device.</p></div>
|
|
<div class="paragraph"><p>Please note that not all Android devices support OTG cables. And even on
|
|
some devices that do support those cables in general, <em>Subsurface-mobile</em>
|
|
still in some cases cannot access a dive computer through a serial port.</p></div>
|
|
<div class="imageblock" style="text-align:center;">
|
|
<div class="content">
|
|
<img src="mobile-images/USB-OTG.jpg" alt="FIGURE: USB-OTG cable" />
|
|
</div>
|
|
</div>
|
|
<div class="paragraph"><p>For Bluetooth-equipped dive computers, establish a Bluetooth connection
|
|
between the dive computer and the mobile device. Use the tools on the mobile
|
|
device to achieve pairing between the Bluetooth dice computer and the mobile
|
|
device. For of Android devices, the Settings → Bluetooth tool is probably
|
|
appropriate. Ensure pairing of the dive computer and mobile device.
|
|
<em>Subsurface-mobile</em> performs communication using both Bluetooth and
|
|
Bluetooth-low-energy (BTLE). The appropriate choice of Bluetooth
|
|
communication is made by the software and the user need not be concerned
|
|
with this.</p></div>
|
|
<div class="paragraph"><p>With pairing between dive computer and <em>Subsurface-mobile</em> having been set
|
|
up, dive download is simple. From the main menu, tap <em>Manage dives →
|
|
Download from DC</em>. A screen is shown requiring that the user specify the
|
|
names of the vendor and model of the dive computer. For instance, when using
|
|
a Shearwater Petrel 2 dive computer, the vendor is <em>Shearwater</em> and the Dive
|
|
computer name is <em>Petrel 2</em>. From the two dropdown lists at the top of the
|
|
screen, select the correct vendor and dive computer names (see image on the
|
|
left, below).</p></div>
|
|
<div class="paragraph"><p>Now tap the button labeled <em>Download</em>. The downloaded dives appear in the
|
|
bottom part of the screen, the most recent dive at the top (see image on
|
|
right, below). Be patient because the download can take a few minutes. As a
|
|
matter of fact, a complete first download from some dive computers has been
|
|
shown to take 45 minutes and longer.</p></div>
|
|
<div class="paragraph"><p>After the download, each dive has a check-box on the left hand side, used
|
|
for selecting which dives you want to be added to the <em>Subsurface-mobile</em>
|
|
dive list: dives that are not checked are ignored. With the appropriate
|
|
downloaded dives having been checked, tap the button at the bottom left
|
|
labeled <em>Accept</em>. All the selected dives appear on the <em>Subsurface-mobile</em>
|
|
dive list. The downloaded dive information can now be edited as described in
|
|
the section above <a href="#S_Edit_Dive">Edit a dive</a>.</p></div>
|
|
<div class="imageblock" style="text-align:center;">
|
|
<div class="content">
|
|
<img src="mobile-images/DC-Download.jpg" alt="FIGURE: DC download screen" />
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect1">
|
|
<h2 id="_viewing_the_dive_location_on_google_maps">10. Viewing the dive location on Google Maps</h2>
|
|
<div class="sectionbody">
|
|
<div class="paragraph"><p>In the <em>Details View</em>, the Action Bar at the bottom has a GPS pin on the
|
|
left hand side. Tap that pin and the dive site is shown in Google
|
|
Maps. Close Google Maps by using the Android <em>Back</em> button.</p></div>
|
|
<div class="paragraph"><p>Alternatively, the <em>Details View</em> has a button at the top right hand marked
|
|
<em>Map it</em>. Tap this button to open Google Maps showing the dive site (image
|
|
below). Afterwards, use the Android <em>Back</em> button to return to
|
|
<em>Subsurface-mobile</em>.</p></div>
|
|
<div class="imageblock" style="text-align:center;">
|
|
<div class="content">
|
|
<img src="mobile-images/Map.jpg" alt="FIGURE: Map of dive site" />
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect1">
|
|
<h2 id="_dive_log_management">11. Dive log management</h2>
|
|
<div class="sectionbody">
|
|
<div class="paragraph"><p>A central part of <em>Subsurface-mobile</em> is the ability to store the dive log
|
|
using the <em>Subsurface</em> cloud storage. This provides security against loss
|
|
or damage to the dive information in a local copy and allows the desktop
|
|
version of <em>Subsurface</em> to access changes made using the mobile device. This
|
|
ability is accessed through the main menu (by dragging the Action Button to
|
|
the right, or by tapping the "Hamburger" icon at the bottom left of the
|
|
screen). Tap the option <em>Dive management</em>, enabling a number of options:</p></div>
|
|
<div class="sect2">
|
|
<h3 id="_add_new_dive_manually">11.1. Add new dive manually</h3>
|
|
<div class="paragraph"><p>This is described above under the section dealing with
|
|
<a href="#S_Add_Dive">Manually adding a new dive to the dive list</a>.</p></div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_download_from_dc">11.2. Download from DC</h3>
|
|
<div class="paragraph"><p>This is described above under the section dealing with
|
|
<a href="#S_Download">Download dives from a dive computer</a>.</p></div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_apply_gps_fixes">11.3. Apply GPS fixes</h3>
|
|
<div class="paragraph"><p>This is described in the following main section, below.</p></div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_manually_sync_the_dive_log_with_the_em_subsurface_em_cloud_storage">11.4. Manually sync the dive log with the <em>Subsurface</em> cloud storage</h3>
|
|
<div class="paragraph"><p>Upload the dives contained on the mobile device to the <em>Subsurface</em> cloud
|
|
storage by tapping the option <em>Manual sync with cloud</em>. This synchronizes
|
|
the local changes to the dive log with the cloud storage. It also downloads
|
|
changes made to the dive log using another device or computer and stored in
|
|
shared cloud storage.</p></div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_enable_cloud_auto_sync">11.5. Enable cloud auto sync</h3>
|
|
<div class="paragraph"><p>By default <em>Subsurface-mobile</em> runs offline and only syncs the dive list
|
|
with cloud storage when explicitly told to do so (see above). You can
|
|
choose to always sync with the cloud servers after every modification of the
|
|
dive list. This is not recommended unless you are in an area with fast and
|
|
reliable internet connection, as otherwise <em>Subsurface-mobile</em> might appear
|
|
to hang between operations as it tries to connect to the cloud
|
|
server. Selecting <em>Enable cloud auto sync</em> causes the local dive log to be
|
|
synchronized with the copy in the cloud every time that <em>Subsurface-mobile</em>
|
|
is closed. This option is a switch that allows auto sync to be either
|
|
activated or to be switched off.</p></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect1">
|
|
<h2 id="_recording_dive_locations_using_gps_android_only">12. Recording dive locations using GPS (Android only).</h2>
|
|
<div class="sectionbody">
|
|
<div class="paragraph"><p>The fact that most smartphones have GPS facilities allows
|
|
<em>Subsurface-mobile</em> on Android to record the locations of dives. If the
|
|
smartphone is taken on the dive boat during a dive, locations will be
|
|
automatically recorded at regular intervals. These locations can then be
|
|
applied to dives in the dive list. Here is how it’s done:</p></div>
|
|
<div class="sect2">
|
|
<h3 id="S_ConfigureGPS">12.1. Configuring the GPS service</h3>
|
|
<div class="paragraph"><p>From the Main menu, select <em>Settings</em>. The Settings screen has a section for
|
|
configuring the GPS service (image below). GPS location data are collected
|
|
at regular intervals, e.g. every 5 minutes, or at regular distances,
|
|
e.g. after the boat has moved more than 200m, or a combination of both of
|
|
these approaches. Provide the appropriate information and tap the Android
|
|
<em>Back</em> button. The program is now ready to collect GPS positions.</p></div>
|
|
<div class="imageblock" style="text-align:center;">
|
|
<div class="content">
|
|
<img src="mobile-images/GPS-config.jpg" alt="FIGURE: GPS configure" />
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_collecting_gps_positions">12.2. Collecting GPS positions</h3>
|
|
<div class="paragraph"><p>Ensure that the GPS on the Android device has been activated. Open the Main
|
|
Menu and select <em>GPS → Run location service</em>. This activates the recording
|
|
of GPS locations.</p></div>
|
|
<div class="imageblock" style="text-align:center;">
|
|
<div class="content">
|
|
<img src="mobile-images/GPSstart.jpg" alt="FIGURE: GPS start" />
|
|
</div>
|
|
</div>
|
|
<div class="paragraph"><p><em>Subsurface-mobile</em> starts to collect GPS locations automatically, following
|
|
the preferences specified as described above. While the GPS location service
|
|
is running, all menus have a GPS symbol at the bottom of the menu,
|
|
indicating that the service is active. After return from the dive trip,
|
|
deactivate the collection of GPS data by tapping the option <em>Disable
|
|
location service</em>. The GPS symbol at the bottom of all manus disappears.</p></div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_storing_the_gps_data_on_the_em_subsurface_em_cloud">12.3. Storing the GPS data on the <em>Subsurface</em> cloud</h3>
|
|
<div class="paragraph"><p>Activate the main menu and select the <em>GPS</em> option that brings up the
|
|
submenu of GPS-related actions. Tap <em>Upload GPS data</em> that saves the GPS
|
|
data on the <em>Subsurface</em> cloud server. These GPS data are saved <strong>separately</strong>
|
|
from the other dive log data. All collected GPS data are kept on the Android
|
|
device, independent of whether they have been uploaded or not.</p></div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_downloading_gps_data_from_the_em_subsurface_em_cloud">12.4. Downloading GPS data from the <em>Subsurface</em> cloud</h3>
|
|
<div class="paragraph"><p>Download the GPS data that have been saved on the cloud (possibly by a
|
|
different device) by selecting <em>Download GPS Data</em> from the GPS sub-panel.</p></div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_viewing_gps_data">12.5. Viewing GPS data</h3>
|
|
<div class="paragraph"><p>From the GPS submenu select <em>Show GPS fixes</em>. This brings up a list of GPS
|
|
positions obtained by the location service (image below). Two actions are
|
|
possible for each of the locations, enabled by dragging the handle (the
|
|
dotted matrix on the right below) to the left. This exposes two
|
|
options. Tapping the dustbin deletes this particular GPS location. Tapping
|
|
the teardrop-shaped icon (actually a Google Maps pin) opens up Google Maps
|
|
with a pin indicating the exact map position of the GPS record being
|
|
viewed. The two above options can be hidden by drawing the GPS record to the
|
|
right, again using the handle.</p></div>
|
|
<div class="imageblock" style="text-align:center;">
|
|
<div class="content">
|
|
<img src="mobile-images/gpsmanagement.jpg" alt="FIGURE: GPS management" />
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_applying_gps_data_to_dives_in_the_dive_log">12.6. Applying GPS data to dives in the dive log</h3>
|
|
<div class="paragraph"><p>Assuming that all the dives have been entered into the dive log or have been
|
|
downloaded from the <em>Subsurface</em> cloud, apply the GPS positions to these
|
|
dives. GPS positions can therefore only be applied to dives in the dive
|
|
list. From the <em>Dive management</em> sub-panel, tap <em>Apply GPS fixes</em>. The dive
|
|
list contains the start and end times of each dive. Now, <em>Subsurface-mobile</em>
|
|
applies the first GPS position that falls within the dive period of each
|
|
dive. This results in a GPS position for each dive that is saved as part of
|
|
the dive log.</p></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect1">
|
|
<h2 id="_utilisation_des_paramètres_pour_em_subsurface_mobile_em">13. Utilisation des paramètres pour <em>Subsurface-mobile</em>.</h2>
|
|
<div class="sectionbody">
|
|
<div class="paragraph"><p>The Settings screen allows the customization of <em>Subsurface-mobile</em>. Many of
|
|
the settings involve dragging a slider switch to activate or deactivate a
|
|
particular setting.</p></div>
|
|
<div class="sect2">
|
|
<h3 id="S_ChangeCloudAccount">13.1. Changing to a different <em>Subsurface</em> cloud account</h3>
|
|
<div class="paragraph"><p>Some users have more than one <em>Subsurface</em> cloud account and with a need to
|
|
switch between accounts. Tap <em>Settings</em> on the Main menu and scroll to the
|
|
section titled <em>Cloud status</em> (see image below). Tap the <em>Change</em>
|
|
button. This opens the <em>Cloud credentials</em> screen. change the credential
|
|
information, then tap the button <em>Sign-in or register</em>. The appropriate dive
|
|
list is shown.</p></div>
|
|
<div class="imageblock" style="text-align:center;">
|
|
<div class="content">
|
|
<img src="mobile-images/SettingsCloudTheme.jpg" alt="FIGURE: Settings: Cloud & Theme" />
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_changing_the_color_theme_of_em_subsurface_mobile_em">13.2. Changing the color theme of <em>Subsurface-mobile</em></h3>
|
|
<div class="paragraph"><p><em>Subsurface-mobile</em> has three color schemes to please users with different
|
|
tastes. This user manual shows the default color scheme, comprising blue
|
|
colors. Change to a pink or a dark color scheme by opening the main menu,
|
|
tap <em>Settings</em>, and scroll to the section with heading <em>Theme</em> (see image
|
|
above). Select the appropriate color theme by dragging the appropriate
|
|
slider on the righthand.</p></div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_configuring_the_gps_webservice">13.3. Configuring the GPS webservice</h3>
|
|
<div class="paragraph"><p>The Settings screen allows one to set up the way in which GPS positions are
|
|
collected during dives. See the section on <a href="#S_ConfigureGPS">Configuring
|
|
the GPS service</a>.</p></div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_saving_a_detailed_dive_computer_dive_log">13.4. Saving a detailed dive computer dive log</h3>
|
|
<div class="paragraph"><p>Under the heading <em>Dive computer</em>, you will find a switch to save a detailed
|
|
log each time dives are downloaded from a dive computer. This is important
|
|
for solving problems in downloading dives from the dive computer. When
|
|
contacting the developers with download problems, you will usually be asked
|
|
to provide the information in this log, which can be found in the root
|
|
folder of your local storage device as <code>libdivecomputer.log</code>. In the same
|
|
location you can also find a <code>subsurfacel.log</code> which is always created and
|
|
which include more information which can be helpful when debugging problems
|
|
with Subsurface-mobile.</p></div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_activating_the_developer_submenu">13.5. Activating the Developer submenu</h3>
|
|
<div class="paragraph"><p>The information in subsurface.log plus some additional information for
|
|
understanding the screen rendering of dive information as well as the way in
|
|
which <em>Subsurface-mobile</em> processed information during a specific occasion
|
|
while running the app (see section below) is available through a <em>Developer</em>
|
|
menu at run time. Activate (or deactivate) this menu item on the Main Menu
|
|
by dragging the slider switch in the Settings screen.</p></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="sect1">
|
|
<h2 id="_developer_submenu">14. Developer submenu</h2>
|
|
<div class="sectionbody">
|
|
<div class="paragraph"><p>If the Developer submenu has been activated in the Settings screen, the Main
|
|
menu has a <em>Developer</em> item. By tapping this one has two options that are
|
|
relevant within the context of program development and debugging.</p></div>
|
|
<div class="sect2">
|
|
<h3 id="_app_log">14.1. App log</h3>
|
|
<div class="paragraph"><p>This option shows the messages that <em>Subsurface-mobile</em> generates while
|
|
running. While most users are not aware of these messages, they are often
|
|
crucial in detecting any abnormal behavior of the app. The App log can be
|
|
found in the root directory of the local storage of the mobile device.</p></div>
|
|
</div>
|
|
<div class="sect2">
|
|
<h3 id="_theme_information">14.2. Theme information</h3>
|
|
<div class="paragraph"><p>This option provides a wealth of information about the screen
|
|
characteristics of the mobile device and the font characteristics used by
|
|
<em>Subsurface-mobile</em>.</p></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div id="footnotes"><hr /></div>
|
|
<div id="footer">
|
|
<div id="footer-text">
|
|
Last updated
|
|
2017-10-20 22:56:41 CEST
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html>
|